2026-05-08-M0-roadmap-and-openspec.md 3.0 KB

阶段总结:M0 路线图与 OpenSpec 对齐(M0)

1. 本阶段目标(Goal)

  • 将 plan/计划需求.md 转化为可执行的多阶段路线图与 OpenSpec 变更制品(proposal / design / specs / tasks),并通过 openspec validate。
  • 建立旧项目归档清单与迁移风险清单,明确 BX 不在本期范围、pl_ 命名与文档目录约束。

2. 非目标(Non-goals)

  • 未实现计划/CRM/地磅业务代码与数据库迁移执行。
  • 未补齐 plan/sx.sql(已识别为待办,见任务 1.1)。

3. 背景与约束(Context & Constraints)

  • Monorepo 内 CRM、地磅、BX、mobile-frontend 并存;需求要求文档归 docs/系统文档/。
  • SQL 尽量少改历史表;新增计划表 pl_ 前缀。
  • 工作流需 Python 生态,具体引擎 M1 PoC 决定。

4. 本阶段范围(Scope)

  • 新增:openspec/changes/plan-management-platform/**;docs/系统文档/** 下本阶段所列文档。
  • 修改:无业务代码修改。
  • 删除:无。

5. 关键设计决策(Design Decisions)

  • 采用 Complex Mode 与八个 capability 拆分 spec,便于测试映射与评审。
  • 待入/待出库公司名规则配置化,避免硬编码扩散(设计见 design.md)。
  • 编号规则与并发策略在 M1 以测试固化。

6. 实施清单完成情况(Tasks)

  • OpenSpec 全制品创建并通过校验(对应 tasks.md 1.3 及制品编写)。
  • docs/系统文档/legacy/* 与路线图、本阶段总结落盘(对应 1.2、1.4)。
  • 1.1 补齐 plan/sx.sql(未完成:仓库内仍无该文件,需从数据库导出)。

7. 验证计划与执行结果(Verification)

7.1 验证计划

  • OpenSpec CLI 校验;文档完整性自检。

7.2 验证结果(证据)

  • 命令:openspec validate plan-management-platform
  • 结果:退出码 0,输出 Change 'plan-management-platform' is valid。

8. 变更影响分析(Impact)

  • 仅文档与 OpenSpec;无运行时 API 或 schema 变更。

9. 已知问题与风险(Known Issues & Risks)

  • plan/sx.sql 缺失:阻塞与财务/CRM 模型严格对齐;缓解见 legacy/迁移风险与兼容性清单.md。

10. 产物与链接(Artifacts)

  • OpenSpec:openspec/changes/plan-management-platform/
  • 路线图:docs/系统文档/路线图-多阶段实施计划.md
  • 归档:docs/系统文档/legacy/旧项目归档清单.md、docs/系统文档/legacy/迁移风险与兼容性清单.md
  • 图谱:graphify update . 已执行(已提交 graphify-out/GRAPH_REPORT.md;graph.json 与 cache/ 体积大未纳入版本库,可本地再生成)。
  • 分支与提交:stage/M0-plan-roadmap / 9b90311c(已推送 origin;首包 OpenSpec 文档为 ee24bd76)。

11. 下一阶段计划(Next)

  • 执行 tasks.md M1 条目:DDL、SXDDH/SXYS、最小 API、工作流 PoC。
  • 完成 1.1 导出 plan/sx.sql 后更新本清单与迁移风险表。