# MoonBitemporal 十月项目申报书（申请人核实并人工定稿）
- 项目名称：MoonBitemporal：MoonBit 双时间轴事实修订库
- 参赛者：
- 联系方式：
- GitHub 仓库：https://github.com/oyjh0381/MoonBitemporal （公开默认分支须在申报前核验）
- 方向与来源：新生态项目建设；原创 MoonBit 库，Apache-2.0，非移植。
## 项目定位与通用性
业务事实有“何时生效”和“何时获知”两条时间轴。覆盖旧值会丢失原决策依据，普通单时间戳不能重现迟到勘误。本库对任意键值事实保存追加式修订，提供两轴查询、差异及有界归档，不绑定数据库、业务日历或 Web 框架。公开检索中的区间树解决重叠搜索、RRULE 解决周期展开，均不提供此修订语义；正式申报前复查 mooncakes.io。
## 预期使用场景
1. **账单勘误**：第 20 天收到适用于第 10–15 天的价格修订，账单系统仍可按第 12 天和当时知识时间重现旧发票，再按当前认知计算调整金额与影响区间。
2. **授权追溯**：人事撤销一段已过任职期的权限，审计端分别查询事件发生时已知状态与现今修订后的状态，并从来源修订链说明差异。
3. **设备校准**：传感器五天内的系数事后改正，数据管道只选取受影响键和有效期重算；小范围报表可按键集生成快照，无需扫描所有业务字段。
4. **配置同步**：发布系统按知识时间读取一个原子提交批次，连同版本化归档尾部传至边缘节点；共享历史分叉时拒绝自动合并。
## 核心功能与实现路径
- 半开有效期、严格递增知识时间、批次区间冲突校验、删除标记、点查询、时间线、差异与影响分析；按键索引和知识时间二分界定候选修订。
- 十月新增：`snapshot_selected` 为小字段集生成有界两轴快照；`batch_at` 通过二分定位指定知识时间的完整原子批次，保留全局序号，便于同步和审计。
- 有界 JSON 归档保留 Int64 精度，拒绝重复键与历史分叉；交付四后端测试、可执行场景、README、CI 与 Apache-2.0 许可。
- 不负责数据库落盘、鉴权、日历时区或跨进程写入协调。算法与实现为项目原创，没有移植其他仓库源码；申请人需核实来源、仓库、测试及文字后人工定稿。
