Commit 4a3b7270b9f2c9a67e8742e31409097e87b974d5
1 parent
5adbe9db
templates: dedupe standard-column convention, drop coding.mjs prose from docs-02…
…, single-source error-codes
Showing
5 changed files
with
5 additions
and
22 deletions
skills/plan/db-design-gen/templates/docs-03-header-template.md
| ... | ... | @@ -6,11 +6,12 @@ |
| 6 | 6 | |
| 7 | 7 | ## 项目标准列约定 |
| 8 | 8 | |
| 9 | -本项目的数据库约定（主键 / 租户隔离列 / 列命名前缀）由 A3 `db-design-gen` 在设计起始时一次性确认，确认值见 `docs/04-技术规范.md § 四、数据库 schema 约定`。下文每张业务表的字段清单都自动包含以下标准列，渲染时由 `docs-03-table-template.md` 模板按确认值展开。 | |
| 9 | +本项目数据库约定确认值见 `docs/04-技术规范.md § 四、数据库 schema 约定`。下列四项展开见每张业务表的字段清单： | |
| 10 | 10 | |
| 11 | 11 | - **列命名前缀规则**：{{COL_PREFIX_RULE}} |
| 12 | 12 | - **主键约定**：{{PK_CONVENTION}} |
| 13 | 13 | - **租户隔离列**：{{TENANT_COLS}} |
| 14 | +- **创建时间列**：`tCreateDate` (datetime, 默认当前时间) | |
| 14 | 15 | |
| 15 | 16 | 字典 / 辅助表如有豁免，在该表业务注记里注明豁免原因。 |
| 16 | 17 | ... | ... |
skills/plan/downstream-gen/templates/docs-02-template.md
| ... | ... | @@ -10,9 +10,7 @@ |
| 10 | 10 | |
| 11 | 11 | ## 二、开发顺序清单（CC 分发权威） |
| 12 | 12 | |
| 13 | -> 本清单由 A5 `downstream-gen` 一次性生成。**每行是一个 REQ**，不是模块。Coding 阶段（`coding.mjs` 的 Router）按表格行序确定模块顺序，对每个 REQ 所属模块查 `docs/08 § 二` 的 `里程碑:` 字段 + 本地 `git tag -l 'milestone/<id>'`：tag 存在则跳过，否则（`—` / tag 不存在）选为待跑模块；顶层循环对每个待跑后端模块依次跑功能链（spec→plan→tdd→verify→review）+ 测试闸 + 里程碑，把该模块的所有 REQ 一次做完。 | |
| 14 | -> | |
| 15 | -> **约束**：同一模块的所有 REQ 必须**连续排列**。允许打破依赖拓扑（如环依赖、业务必须先做），但必须在「备注」列写明原因。 | |
| 13 | +> Coding 阶段按本表行序分发；约束：同一模块所有 REQ 必须连续排列。 | |
| 16 | 14 | |
| 17 | 15 | | # | REQ | 所属模块 | 选中理由 | 备注 | |
| 18 | 16 | |---|-----|---------|---------|------| |
| ... | ... | @@ -20,7 +18,5 @@ |
| 20 | 18 | | {{index}} | **{{req_id}}** | {{module_id}} | {{rationale}} | {{note}} | |
| 21 | 19 | {{/each}} |
| 22 | 20 | |
| 23 | -> **后端模块全部打里程碑后**：`coding.mjs` 的 Router 把全部未完成前端 FE 聚合为**唯一一个** `frontend-phase` 阶段，排在所有后端模块之后由顶层循环跑（prototype/ 门禁已在 Plan 期 A6 `frontend-scope-lock` 前移完成）。前端阶段以业务功能（不是 HTML 文件数）为粒度拆分 FE（FE-NN，路径限 `frontend/`），每个 FE 跑一次功能链，整个阶段打 **1 个**里程碑 tag（分支 `frontend-phase`，`milestone/frontend-phase`，记录在 `docs/08 § 三 整体里程碑`）。 | |
| 24 | - | |
| 25 | 21 | ## 三、关键说明 |
| 26 | 22 | {{notes}} | ... | ... |
skills/plan/downstream-gen/templates/docs-05-header-template.md
| ... | ... | @@ -11,14 +11,7 @@ BasePath: `{{base_path}}` |
| 11 | 11 | ``` |
| 12 | 12 | |
| 13 | 13 | ### 错误码 |
| 14 | -| 范围 | 含义 | | |
| 15 | -|---|---| | |
| 16 | -| 200 | 成功 | | |
| 17 | -| 400xx | 客户端参数错误 | | |
| 18 | -| 401xx | 认证/授权错误 | | |
| 19 | -| 403xx | 权限不足 | | |
| 20 | -| 404xx | 资源不存在 | | |
| 21 | -| 500xx | 服务端内部错误 | | |
| 14 | +See docs/04 § 1.4 错误码段位. | |
| 22 | 15 | |
| 23 | 16 | ### 鉴权 |
| 24 | 17 | {{auth_note}} | ... | ... |
skills/plan/downstream-gen/templates/docs-10-header-template.md
| ... | ... | @@ -9,8 +9,3 @@ |
| 9 | 9 | - [ ] 统一响应格式 `{code, message, data, timestamp}` |
| 10 | 10 | - [ ] 异常走全局处理器，不暴露堆栈到前端 |
| 11 | 11 | - [ ] 前端不存敏感信息到 localStorage |
| 12 | - | |
| 13 | -> 本文档仅维护项目级验收 SOP。粒度更细的验收信息分散在： | |
| 14 | -> - **每 REQ 的业务验收点**：`docs/01-需求清单/<module>/<req_id>.md § 验收` | |
| 15 | -> - **每模块的实测验收（数据 / UI / 自动化用例位置）**：由 B 阶段 coding.mjs 的 module-report stage 在该模块完成时填入模块完成报告 | |
| 16 | -> - **REQ 开发进度（review stage approve 状态）**：`docs/08 § 二` | ... | ... |
skills/plan/project-init/templates/docs-01-index-template.md