## moonsbe 项目提交说明书

**基本信息**

- 项目名称：moonsbe：SBE 标准消息编解码与 MoonBit 代码生成库
- 参赛者：马昀昀
- 联系方式：1498657823@qq.com
- GitHub 仓库链接：[liyun6666/moonsbe](https://github.com/liyun6666/moonsbe)
- Mooncakes 包：[liyun6666/moonsbe](https://mooncakes.io/docs/liyun6666/moonsbe)
- 项目方向：MoonBit 标准协议基础库 / 跨语言消息互操作
- 是否为移植项目：否，按公开 SBE 规范原创实现

**项目简介**

moonsbe 让 MoonBit 应用读取已有 SBE XML Schema，生成 MoonBit 类型和编解码接口，与采用同一协议的系统交换二进制消息。定长视图可按固定偏移读取根块数值字段。

**使用场景**

1. **跨语言服务接入**。网关收到 Java 服务发出的 SBE 报文后，先读取序号和状态，再按需解码其余字段并编码响应。
2. **二进制记录排查**。开发者把有明确消息边界的文件或日志记录解码为 JSON，核对模板和字段值并定位截断。
3. **协议升级验收**。团队比较新旧 Schema，在 CI 中运行 Java 与 MoonBit 双向编解码，检查报文一致性。

**核心功能范围**

- 最终交付目标为**完整支持 FIX SBE 1.0 Final（2020 年 11 月勘误版）**的 XML Schema、标准字段与报文编码及版本演进。[验收目标](compatibility.md)
- 本轮用 FIX 官方原始三份 Schema 复现订单请求、固定字段演进和变长数据。62、66、88 字节报文均与 Java 完全一致，旧版读取新版固定区通过。
- 支持规范 §4.7.5 的 UTF-16 `SecurityDesc`。同一份 XML 通过官方 XSD 校验，文本和空文本报文经过 Java 双向字节对照。执行 `moon run --deny-warn tools/conformance.mbtx` 复现。[详细结果](interoperability.md)
- JavaScript 和 Wasm GC 各通过 49 项测试，手写 MoonBit 实现 4,182 行。GitHub 提交超过 10 次。

**移植或参考说明**

- 参考规范：[FIX SBE 1.0（2020 年 11 月勘误版）](https://www.fixtrading.org/wp-content/uploads/download-manager-files/Simple_Binary_Encoding_V1.0_with_Errata_November_2020.pdf)
- 参考项目：[aeron-io/simple-binary-encoding 1.35.0](https://github.com/aeron-io/simple-binary-encoding/tree/1.35.0)
- 参考项目许可证：Apache License 2.0，引用的 Schema 和 Java 示例保留原版权声明。
- 本项目许可证：Apache License 2.0。

FIX 一致性套件为 Apache-2.0。原始 Schema、测试计划与标准 XSD 按固定版本下载，用于验证。[上游来源](../interop/UPSTREAM.md)
