## moonsbe 项目申报书

**基本信息**

- 项目名称：moonsbe：SBE 标准消息编解码与 MoonBit 代码生成库
- 参赛者：马昀昀
- 联系方式：1498657823@qq.com
- GitHub 仓库链接：[https://github.com/liyun6666/moonsbe](https://github.com/liyun6666/moonsbe)
- 项目方向：MoonBit 标准协议基础库 / 跨语言消息互操作 / 开发者工具
- 是否为移植项目：否，原创 MoonBit 实现，引用上游标准示例进行独立验证

**项目简介**

moonsbe 让 MoonBit 应用通过已有 SBE XML Schema 接入 Java 等消息系统。库读取同一份协议定义，生成 MoonBit 类型并按约定的字节布局读写报文，适用于交易消息、二进制日志和协议升级验证。

**使用场景**

1. **跨语言服务接入**。MoonBit 网关可用生成的定长视图直接读序号和状态，按需解析完整消息，并向 Java 服务发送同一 Schema 定义的响应。
2. **二进制记录检查**。开发者将有明确消息边界的记录按 Schema 解码为 JSON，核对字段并定位模板不匹配或截断问题。
3. **消息定义升级验收**。团队比较新旧 Schema，在 CI 中验证 Java 与 MoonBit 双向编解码及完整字节一致性。

**核心功能范围**

- 最终交付目标为**完整支持 FIX SBE 1.0 Final（2020 年 11 月勘误版）**的标准 XML Schema、字段编码、消息结构与版本演进。以官方 XSD、规范第 4–7 章及参考报文逐项验收。[兼容范围与验收目标](compatibility.md)
- 提供原样 XML 导入、类型化代码生成、二进制编解码与版本检查，覆盖消息头、常量和缺失值、两种字节序、重复组、变长数据。
- 0.2.1 已用 FIX 原始三份 Schema 逐字节核对 62、66、88 字节订单请求，并验证旧版读取新版固定区。规范 UTF-16 文本与空文本也通过 Java 双向核对。运行 `moon run --deny-warn tools/conformance.mbtx` 复现。[实测案例](interoperability.md)
- 生成 MoonBit 结构体、枚举与定长数值视图，提供 CLI 和 JSON 转换。JS 与 Wasm GC 各通过 49 个测试，手写 MoonBit 实现 4,182 行。

**移植或参考说明**

- 参考规范：FIX Trading Community SBE 1.0 with Errata November 2020。
- 参考项目：[aeron-io/simple-binary-encoding](https://github.com/aeron-io/simple-binary-encoding)，固定参考工具版本 1.35.0。
- 上游许可证：Apache License 2.0，引用的 Schema 与示例 Java 源码保留版权声明。
- 本项目许可证：Apache License 2.0，手写 MoonBit 实现、测试与生成产物分别统计。

三份 FIX Schema 来自 Apache-2.0 的[官方一致性套件](https://github.com/FIXTradingCommunity/fix-sbe-conformance)，按原样下载验证。
