saas-mbr/abacus-static-framework/.project.agents/docs/context/ROADMAP.md

abacus-static-framework — 实施路线图（ROADMAP）

由 PRD.md + ARCHITECTURE.md 推导。按依赖图拓扑顺序排开发节奏。每完成一个复选框，在同一个 commit里打勾；每完成一个 milestone，按 .project.agents/log/ 模板写日志。

0. 排序原则

• 先底层（framework 只读，不轻易动）后业务（subsystem）。
• 本仓库为底座模板：里程碑以"验证模板可复制性 + 治理可持续性"为主线，而非业务功能交付。

1. 里程碑总览

Milestone	目标	验收（能演示什么）
M0	治理落地（本次）：git 单一仓库、docs/ 文档中心、.project.agents 全套、共享规范	克隆仓库 → npm install → npm run dev 可起；治理文档无残留 token
M1	模板可复制性验证：按 docs/coding-standards.md §7 用第一个业务子系统（界面→代码）跑通全流程	新业务子系统页面可访问、接口联调通
M2	沉淀与回写：业务中发现的共性需求回写 framework/standard 或 docs/	标准件/规范有增量，框架评审入库

2. 里程碑详细

M0 — 治理与规范落地（已完成）

• 版本控制 + ignore + 骨架提交（工作区单一仓库 D:\workBuddySpace\member）
• docs/ 文档中心（README / architecture / coding-standards / agent-guide）
• 本仓库 .project.agents 治理文件（CLAUDE / AGENTS / SELF_CONSTRAINTS / VIBECODING_GUIDE / settings / context 五文档）
• 完成门禁（治理文档无残留模板 token / FILL 标记）
• 验收：克隆仓库 → npm install → npm run dev 可起；治理文档无残留 token。

M1 — 模板可复制性验证（首个业务子系统）

• 依赖：M0
• 选定/新建业务子系统（复制 subsystem sms 示例改写）
• 按 docs/coding-standards.md §7：界面 → views + api → dynamicRouter → 后端接口 → SQL → APP_NAME 四联检 → 联调冒烟
• 后端菜单数据注册（sql/data/），前端菜单可见
• 验收：新子系统在 dev 环境跑通列表/查询/新增/编辑/导出全链路。

M2 — 沉淀与回写

• 依赖：M1
• 收集业务开发中的共性需求（组件/工具/规范盲点）
• 泛用组件走框架评审纳入 framework/components/standard（或 standard utils）
• 规范盲点回写 docs/coding-standards.md（先改 docs/ 再同步各仓库指针）
• 验收：标准件与规范有可见增量，且新业务直接复用。

3. 并行轨道（与代码 milestone 解耦）

• 无（CI/资产生成等暂不纳入；如团队需要可补充构建门禁脚本到 .project.agents/scripts/）。

4. 完成定义（DoD）

• 构建通过（npm run build:prod 无错）；涉及后端联动场景需后端启动联调。
• 触及的架构变更已回写 ARCHITECTURE.md；共享约束变更先改 docs/coding-standards.md。
• 已写执行日志（.project.agents/log/YYYY-MM-DD-<slug>.md）。

5. 跨 milestone 不变量

• I1~I3（ARCHITECTURE §1.3）：framework 只读、请求走 request.ts、别名已注册。
• 任何新模块/目录先登记 ARCHITECTURE.md 再写代码。