# 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 — 治理与规范落地（已完成）
- [x] 版本控制 + ignore + 骨架提交（工作区单一仓库 `D:\workBuddySpace\member`）
- [x] docs/ 文档中心（README / architecture / coding-standards / agent-guide）
- [x] 本仓库 .project.agents 治理文件（CLAUDE / AGENTS / SELF_CONSTRAINTS / VIBECODING_GUIDE / settings / context 五文档）
- [x] 完成门禁（治理文档无残留模板 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` 再写代码。