Appearance
文档 ↔ 功能对齐索引
最后核对：2026-06-22（对照 frontend/、miniapp/、backend/ 源码）。
清单符号
| 符号 | 含义 |
|---|---|
| ✅ | 代码已落地（可 grep / 单测 / E2E 验证） |
| ⬜ | 待办（运维签字、可选架构、或尚未实现） |
| 人工 | 须业务/运维手工表，CI 无法代签 |
旧版 Markdown
- [x]在部分 VitePress 主题显示为 ×，语义是「已勾选完成」，不是报错。规划类文档已逐步改为 ✅ / ⬜。
读哪份文档
| 目的 | 文档 |
|---|---|
| 四线战略 + Track 清单 | roadmap-four-tracks.md |
| 发版顺序（阶段 0→3） | release-phase-plan.md |
| P0 签字 + C/B/技术债汇总 | program-full-execution.md |
| 三线并进（经理现场 / C 留存 / 发版稳） | program-three-goals-execution.md |
| 各 Track Phase 2 明细 | track1-b-acc-phase2.md · track2-tech-phase2.md · track3-bookkeeping-phase2.md |
| 本文 | 文档声称 vs 代码现状的一页对照 |
关系：路线图与 track 文档描述 开发完成度；release-phase-plan 描述 发版门禁顺序——阶段 1–3 功能代码大多 ✅，但 阶段 0（P0 签字）未完成前不建议对外发版。
仍待人工 / 运维（⬜）
| 项 | 文档 | 说明 |
|---|---|---|
| 预发 §4.2 STRICT 签字存档 | strict-signoff-ops-runbook.md | 合并 env、重启、填表存档 |
| M3 / M4 / P2 库存 S1/S2 手工表 | release-signoff-bundle.md | E2E 可辅助，仍须业务签字 |
| M4 结算用例 1–7 | m4-settlement-manual-checklist.md | API 参数已对齐 ✅ |
GitHub E2E_* Secrets 配齐 | env-pack-strict-and-e2e.md | 减少 CI skip |
personal 微服务迁移 | microservice-split-decision.md | 可选单独立项 |
Track 1 — 站点 Acc
| 文档项 | 状态 | 代码入口 |
|---|---|---|
| 库存 export + 只读 E2E | ✅ | POST /acc/stock-ledger/export-csv · e2e/acc-stock-ledger-export-readonly.spec.ts |
| 小程序大页拆分（wip-op/close、stock-ledger、labor 等） | ✅ | miniapp-large-page-split.md |
| M4 列表筛选对齐 | ✅ | m4-settlement-api-parity.md |
| 经理报表钻取 / 阈值 / 导出 | ✅ | track1-b-acc-phase2.md · manager-report-alerts.ts |
| 预发 M3/M4/P2 库存签字 | ⬜ 人工 | acc-stock-staging-checklist.md |
Track 2 — 发版门禁
| 文档项 | 状态 | 代码入口 |
|---|---|---|
| 只读 API / 路由 E2E | ✅ | e2e/acc-permission-denied-api.spec.ts 等 |
prerelease / CI gates | ✅ | 根 package.json · .github/workflows/ci.yml |
| 时区约定 | ✅ | datetime-conventions.md |
| Acc 链路集成测 | 部分 | settlement-flow.integration.spec.ts · acc-business-chain-flow.integration.spec.ts |
| §4.2 签字存档 | ⬜ 人工 | — |
Track 3 — 个人 C 端
| 文档项 | 状态 | 代码入口 |
|---|---|---|
| 记账筛选 / 导出 / 统计 | ✅ | POST /sys/bookkeeping/* · miniapp/src/pages/bookkeeping/ |
| 预算 / 周期账 / 分享图 | ✅ | track3-bookkeeping-phase2.md |
| 日常打卡 P0/P1 | ✅ | backend/.../daily-check-in/ · miniapp/src/pages/daily-check-in/ |
| 发放撤销 → 个人记账回滚 | ✅ | POST /acc/settlement/unmark-paid · bookkeeping-settlement-sync-revert.md |
| personal 微服务 | ⬜ | 仍走 Sys 模块 |
Track 4 — Web 管理端
| 文档项 | 状态 | 代码入口 |
|---|---|---|
| 报工弹窗 / AccHome composable | ✅ | roadmap-four-tracks.md Track 4「代码对照」 |
| 大弹窗拆分 | ✅ | useGoodsSaveDialog · useProductionWipAddDialog · useUserEditDialog |
| 报表指标同口径 | ✅ | acc-home-metrics-parity.md |
常见路径纠正（文档引用时）
| 文档旧写法 | 实际路径 |
|---|---|
miniapp/src/api/acc-home.ts | miniapp/src/pages/manager/api/acc-home.ts |
miniapp/src/api/acc-settlement.ts | miniapp/src/pages/manager/api/acc-settlement.ts（工人端另有 pages/worker/api/） |
miniapp/src/api/acc-production.ts | miniapp/src/pages/recorder/api/acc-production.ts（工人端 pages/worker/api/） |
POST /bookkeeping/stats/summary | POST /sys/bookkeeping/stats/summary |
acc_stock_ledger（SQL） | acc_stock_ledgers |
acc_production / acc_production_output | acc_productions / acc_production_outputs |
改代码后如何同步文档
- 功能完成 → 在对应 Track / track*-phase2 标 ✅，并更新本文对照表。
- 新 API / 表名 → 同步 database-tables.md（表级变更）与 parity 文档。
- 仅运维项 → 保持 ⬜ 人工，勿标 ✅。
- 提交前：
pnpm run check:docs。