soloforge 1.1.45 → 1.1.47

package/templates/design/enforced.md

@@ -2,100 +2,70 @@
 id: design-enforced
 kind: enforced
 gate: design-gate
-title: design阶段强制检查清单
+title: design 阶段强制检查清单
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
-  - id: ARC-01
-    executor: regex_pattern_scan
-    rule: "Controller 禁止包含业务逻辑（计算/校验等应下沉 Service）"
-    severity: error
-    check_type: deterministic
-    pattern: '/\bclass\s+\w*Controller\b[\s\S]{0,500}\b(if|for|while|calculate|compute)\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无 Controller 含业务逻辑命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-02
-    executor: regex_pattern_scan
-    rule: "禁止 Entity 直接暴露给外部接口，必须用 DTO"
-    severity: error
-    check_type: deterministic
-    pattern: '/\bpublic\s+\w*Entity\b\s+\w+\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无 Entity 直接暴露命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-03
-    executor: regex_pattern_scan
-    rule: "写操作（save/create/update/delete）必须有 @Transactional"
-    severity: error
-    check_type: deterministic
-    pattern: '/\.(save|insert|update|delete|remove|create)\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无写操作缺事务命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-04
-    executor: regex_pattern_scan
-    rule: "禁止直接 new Service/Repository/Mapper/Manager，必须依赖注入"
-    severity: error
+  # —— 产物结构完整性（document_structure，逼产物质量）——
+  - id: REQ-STRUCT
+    executor: document_structure
     check_type: deterministic
-    pattern: '/\bnew\s+\w*(Service|Repository|Repo|Dao|Mapper|Manager)\s*\(/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无直接 new 服务对象命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-06
-    executor: regex_pattern_scan
-    rule: "前端 API 调用必须封装到 service 层，禁止组件内直接 fetch/axios"
     severity: error
+    gate: design-gate
+    required_artifact: 需求分析模版
+    rule: "需求分析文档须含「根本目标（fundamental_need）」「功能点清单」「非功能需求」章节"
+    evidence_required:
+      - "docs/context/需求分析.md"
+    target: self
+  - id: ARCH-STRUCT
+    executor: document_structure
     check_type: deterministic
-    pattern: '/\b(fetch|axios)\s*\(/'
-    languages: [ts]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无组件直接 API 调用命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-07
-    executor: regex_pattern_scan
-    rule: "禁止 @Autowired + @Lazy 循环依赖"
     severity: error
+    gate: design-gate
+    required_artifact: 架构设计模版
+    rule: "架构设计文档须含「约束条件」「安全架构」「风险与回滚」章节"
+    evidence_required:
+      - "docs/architecture/01-架构设计文档.md"
+    target: self
+  - id: DB-STRUCT
+    executor: document_structure
     check_type: deterministic
-    pattern: '/@Autowired[\s\S]{0,50}@Lazy|@Lazy[\s\S]{0,50}@Autowired/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无循环依赖命中）"]
-    gate: verify-gate
-    target: "self"
-  - id: ARC-08
-    executor: regex_pattern_scan
-    rule: "Service 层禁止直接操作 HttpServletRequest/Response"
     severity: error
+    gate: design-gate
+    required_artifact: 数据库设计文档模版
+    rule: "数据库设计文档须含「实体与关系」「表字段与敏感级别」章节"
+    evidence_required:
+      - "docs/design/01-数据库设计文档.md"
+    target: self
+  - id: API-STRUCT
+    executor: document_structure
     check_type: deterministic
-    pattern: '/\bHttpServletRequest\b|\bHttpServletResponse\b/'
-    languages: [java]
-    evidence_required: ["regex_pattern_scan 扫描结果（git diff 变更文件无 Service 操作 HttpServlet 命中）"]
-    gate: verify-gate
-    target: "self"
+    severity: warning
+    gate: design-gate
+    required_artifact: API接口规格文档模版
+    rule: "API 接口规格文档须含「响应体字段」「错误与副作用」「验收场景」核心 section"
+    evidence_required:
+      - "docs/design/02-API接口规格文档.md"
+    target: self
+  # —— 设计主观规则（semantic，advisory 不阻断，随 Reflexion 反馈供 AI 评判）——
   - id: DES-C-REVIEW
     executor: semantic
-    rule: "客户端 AI 评判设计主观规则（流程约束类，不可代码确定性判定）：① 每条架构决策须有对应 ADR，禁止口头决策不留记录（ADR-HARD-01）② ADR 状态变更须经用户确认，Agent 不得自动变更（ADR-HARD-02）③ 跳过决策研讨须用户明确声明，Agent 不得自行跳过（ADR-HARD-04）④ 技术选型须有 NFR 量化对比而非仅凭业界主流（ARCH-MOD-04）"
+    rule: "客户端 AI 评判设计主观规则：① 每条架构决策须有对应 ADR，禁止口头决策不留记录 ② ADR/重大选型状态变更须经用户确认，Agent 不得自动变更 ③ 技术选型须有依据（性能/成本/熟悉度）而非仅凭业界主流 ④ 改老系统须有兼容性分析与回滚方案"
     severity: info
     check_type: semantic
-    evidence_required: ["LLM 语义评估结论（pending 标记，advisory 不阻断，随 Reflexion 反馈供客户端 AI 评判/重试）"]
+    evidence_required:
+      - "LLM 语义评估结论（pending 标记，advisory 不阻断，随 Reflexion 反馈供客户端 AI 评判/重试）"
     gate: design-gate
-    target: "self"
+    target: self
 ---
 
 # design-gate 强制检查清单
 
-8 条确定性检查。bridge 从此文件聚合。
+design 阶段产物结构与决策质量检查。bridge 从此文件聚合。
+
+- **REQ-STRUCT / ARCH-STRUCT / DB-STRUCT / API-STRUCT**：产物必含章节（document_structure，确定性）
+- **DES-C-REVIEW**：决策有 ADR / 选型有依据 / 改老系统有回滚（semantic，advisory）
 
-对应工程经验：
-- ARC-01
-- ARC-02
-- ARC-03
-- ARC-04
-- ARC-06
-- ARC-07
-- ARC-08
-- DES-C-REVIEW
+> 代码层正则检查（Controller 不含业务逻辑、写操作须事务等 ARC-*）已迁至 build-gate，那里才是代码实现阶段的归属。

package/templates/design//345/205/250/347/224/237/345/221/275/345/221/250/346/234/237/345/267/245/344/275/234/346/265/201/345/257/274/350/210/252.md

@@ -21,6 +21,7 @@ extra:
   products:
     - '*'
   lifecycle_status: active
+  priority: P0
   version: 1.1.0
   last_reviewed: '2026-06-01'
   domain:

package/templates/design//345/205/274/345/256/271/346/200/247/344/270/216/350/277/201/347/247/273/350/257/204/344/274/260.md

@@ -0,0 +1,71 @@
+---
+id: ka-guidance-兼容性与迁移评估
+kind: guidance
+title: 兼容性与迁移评估
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 迁移
+  - 兼容
+  - 老系统
+  - 重构
+  - brownfield
+  - 改造
+  - 遗留
+  - 升级
+  - 数据迁移
+  - 兼容性
+extra:
+  name: compatibility-migration-assessment
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: design
+  domain: design
+  owner_mechanism: mc-existing-system-analysis
+---
+
+# 兼容性与迁移评估：改老系统怎么不翻车
+
+> 吸收旧的「兼容性检查」「迁移评估」「改造影响范围评估」「历史遗留雷区清单」。
+> **何时用**：改造现有系统、数据迁移、schema 变更、技术栈升级时。
+
+## 第一步：摸清现状（证据先行）
+
+- 现有系统行为：靠真实运行/日志/数据证明，不靠记忆猜测（[[证据驱动与反幻觉]]）
+- 历史遗留雷区：标出脆弱点、无人敢动的代码、隐式契约
+
+## 第二步：迁移范围与影响面
+
+| 变更项 | 影响模块 | 影响数据 | 调用方 | 兼容性风险 |
+|--------|---------|---------|--------|-----------|
+
+## 第三步：兼容性分析
+
+- **向后兼容**：老接口/数据/调用方是否还能用？破坏点在哪？
+- **数据兼容**：老数据能否被新代码正确读取？是否需要迁移脚本？
+- **灰度能力**：能否新老并存、按流量/租户灰度切换？
+
+## 第四步：回滚方案（必填）
+
+- 每个变更能否独立回滚？
+- 数据迁移是否可逆？回滚后数据一致性如何保证？
+- 回滚触发条件 + 验证 SQL
+
+## 第五步：风险与验证
+
+- 新老逻辑比对：关键路径行为是否一致（比对日志/双写比对）
+- 爆炸半径控制：小切片推进（[[切片规划]]），每片可独立回滚
+
+## 禁止
+
+- 不摸现状就改老代码（凭记忆，违规）
+- 破坏向后兼容却不标注影响面（违规）
+- 数据迁移没有回滚脚本（违规）
+- 大爆炸式改造（无灰度，违规）

package/templates/design//345/206/263/347/255/226/344/270/216/351/200/211/345/236/213.md

@@ -0,0 +1,70 @@
+---
+id: ka-guidance-决策与选型
+kind: guidance
+title: 决策与选型
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 选型
+  - 技术决策
+  - ADR
+  - 头脑风暴
+  - 方案对比
+  - 第一性原理
+  - 架构决策
+  - 候选方案
+  - 技术栈
+  - 权衡
+extra:
+  name: decision-and-selection
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: design
+  domain: design
+  owner_mechanism: mc-decision-workshop
+---
+
+# 决策与选型：怎么拍技术方案
+
+> 吸收旧的「技术选型」「自主选型」「架构决策记录」「不确定时头脑风暴」「第一性原理推理」。
+> **核心**：重大决策须经用户确认（[[开发者宪法]]），选型须有依据而非凭主流（[[证据驱动与反幻觉]]）。
+
+## 选型流程
+
+1. **明确要解决什么问题**（第一性原理，不跟风）
+2. **检索基准**：通用知识 + 项目沉淀（sf_knowledge）+ 业界实践
+3. **列候选方案**：至少 2 个（含"不做/保持现状"选项）
+4. **多维对比**：性能 / 成本 / 团队熟悉度 / 生态 / 运维 / 风险
+5. **证伪循环**：主动找每个候选的失败场景，不是只找优点
+6. **给推荐 + 风险**：列冲突点、给推荐、请求用户确认
+7. **落 ADR**：决策必须有记录（标题/背景/选项/结论/原因）
+
+## ADR 格式（MADR）
+
+```markdown
+# 决策标题：<一句话>
+## 背景：为什么要做这个决策
+## 选项：列出候选及各自权衡
+## 结论：选了什么
+## 原因：为什么选它、放弃了什么
+```
+
+## 何时头脑风暴（不确定时）
+
+- 需求/方案有多种合理解读，且影响重大
+- 列出多个方向，标注各自前提和风险
+- 不要假装确定（[[工程执行总纲]] 思考先行）
+
+## 禁止
+
+- "业界主流所以选它"（无依据，违规）
+- 只列一个候选（没有比较，违规）
+- 决策不留 ADR（口头决策，违规）
+- 未经用户确认就定重大架构选型（越权，违规）

package/templates/design//345/210/207/347/211/207/350/247/204/345/210/222.md

@@ -1,76 +1,70 @@
 ---
-id: 切片规划
+id: ka-guidance-切片规划
 kind: guidance
 title: 切片规划
 sync_policy: copy_to_project
 status: active
 triggers:
-  - 切片规划
-  - 切片计划
-  - slice planning
-  - 任务拆分
-  - 功能拆分
+  - 大任务
+  - 拆分
+  - 切片
+  - slice
+  - 任务拆解
+  - 并行开发
+  - 迭代
+  - 里程碑
+  - 增量
+  - 排期
 extra:
   name: slice-planning
-  type: constraint
-  domain: design
-  lifecycle_status: active
   scope:
-    - backend
-    - frontend
+    - '*'
   products:
     - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: design
-  owner_mechanism: mc-command-router
+  domain: design
+  owner_mechanism: mc-design-artifact-pack
 ---
 
-# 切片规划规则
+# 切片规划：大任务怎么拆
+
+> 吸收旧的「切片规划」「切片计划」「任务拆解」「老系统切片规划」。
+> **何时用**：任务超出单次交付、需多人/多轮并行、或改老系统需控制爆炸半径时。小任务不用拆。
+
+## 切片原则
+
+1. **垂直切片优先**：每个切片端到端打通一个可验价值（前端→后端→DB），不按技术层横切
+2. **独立可验证**：每个切片能单独跑、单独测、单独验收
+3. **主链路接入**：每个切片必须接入主链路，不留孤岛（[[证据驱动与反幻觉]] 第 7 条）
+4. **依赖有序**：被依赖的切片先做；循环依赖必须打破
+5. **爆炸半径可控**（改老系统）：每个切片可独立回滚，不牵连全局
+
+## 切片清单格式
+
+| 切片ID | 目标 | 涉及模块 | 上游依赖 | 主链路入口 | 验收标准 | 预估 |
+|--------|------|---------|---------|-----------|---------|------|
+| S-01 | <!-- 可验价值 --> | | | | | |
 
-## SLP-01: 最小闭环
-  id: SLP-01
-  name: 最小闭环
-  severity: error
-  check_type: semantic
-  check_hint: 切片 AC 不得引用其他切片的输出作为前置条件
-  description: 每个切片必须能独立完成并验证，不依赖后续切片的产出。AC 中引用的输入必须是上游设计产物（DD-*/ARCH-*），而非同层级其他切片的输出。
+## 每个切片必须回答
 
-## SLP-02: 可独立测试
-  id: SLP-02
-  name: 可独立测试
-  severity: error
-  check_type: semantic
-  check_hint: 每个切片的测试文件可独立执行，不需要等待其他切片完成
-  description: 切片完成后必须能独立运行测试验证。若需其他切片的数据，须通过 fixture/mock 提供，不得依赖真实执行顺序。
+- 这个切片交付什么可验证价值？
+- 接入哪个主链路入口？（不接入=孤岛）
+- 验收标准是什么（可执行验证，非"功能正常"）？
+- 失败怎么回滚？
 
-## SLP-03: 单一职责
-  id: SLP-03
-  name: 单一职责
-  severity: warning
-  check_type: semantic
-  check_hint: 切片描述≤2 个功能点
-  description: 每个切片只聚焦一个功能点或一个变更维度。描述超过 2 个功能点的切片应拆分。复合切片须用前置依赖字段关联。
+## 老系统切片额外要求
 
-## SLP-04: 上游引用完备
-  id: SLP-04
-  name: 上游引用完备
-  severity: error
-  check_type: deterministic
-  check_hint: 每个切片的上游引用字段包含 DD-* 和 ARCH-* 编号
-  description: 每个切片必须引用详细设计文档中的 DD-* 编号（接口/模块）和架构设计文档中的 ARCH-* 编号（架构决策）。无上游设计引用的切片不得进入执行阶段。
+- 先标出历史遗留雷区（[[兼容性与迁移评估]]）
+- 优先隔离适配器方案，不改老代码内部
+- 每切片新老逻辑比对（行为一致才算通过）
 
-## SLP-05: 验收标准三路径
-  id: SLP-05
-  name: 验收标准三路径
-  severity: error
-  check_type: deterministic
-  check_hint: 每个切片≥3 条 AC，覆盖功能/质量/边界三路径
-  description: 每个切片必须有 AC-* 验收标准，至少包含：功能验收（核心功能点的预期行为）、质量验收（测试覆盖率、无 lint 错误）、边界验收（边界条件和错误处理）。
+## 反规避
 
-## SLP-06: ID 命名规范
-  id: SLP-06
-  name: ID 命名规范
-  severity: error
-  check_type: deterministic
-  check_hint: 切片 ID 格式 SLC-{模块简称}-{序号}，AC ID 格式 AC-SLC-{模块}-{序号}-{N}
-  description: 任务 ID 格式：`SLC-{模块简称}-{序号}`（如 SLC-Auth-01）。验收标准 ID 格式：`AC-{任务ID}-{序号}`（如 AC-SLC-Auth-01-01）。依赖声明使用任务 ID，不允许使用描述性文字。ID 不得重复或缺失。
+- 拆成技术层（前端一切、后端一切）= 横切，违规
+- 切片不接入主链路 = 孤岛，违规
+- 切片没有验收标准 = 无法验证，违规

package/templates/design//346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/346/226/207/346/241/243.md

@@ -11,8 +11,8 @@ extra:
     - backend
   products:
     - '*'
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   type: artifact
   domain: design
   stage: design
@@ -21,9 +21,13 @@ extra:
 
 # 数据库设计文档
 
-> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
+> **产物定位**：涉及数据模型/建表时产出（按需）。把表结构、关系、敏感级别、迁移回滚定清楚。
+> **核心纪律**：字段映射精确到 表.字段；migration 成对（up+down）可回滚（[[兼容性与迁移评估]]）。
+> **完成判定**：见文末。
 
-## 1. 目标数据库与权威 SQL [Always — 必填]
+> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。
+
+## 1. 目标数据库与权威 SQL [Always]
 
 | 项目 | 内容 |
 |------|------|
@@ -35,119 +39,101 @@ extra:
 | 上游架构文档路径 | |
 | 上游需求文档路径 | |
 
-## 2. 实体与关系 [Always — 必填，P0 最关键章节]
+## 2. 实体与关系 [Always — P0 最关键]
 
 ### 2.1 实体列表
-> 每个表须分配唯一表编号 `DD-T01`/`DD-T02`...（供切片计划/代码审查引用，cross_validation 据此校验一致性+覆盖）
-> 「来源需求/架构章节」列须填 `REQ-*`（需求编号）/`ARCH-*`（架构决策）真实编号（供 cross_validation 校验与需求分析一致），禁止仅写自然语言描述
+> 每个表分配唯一编号 `DD-T01`/`DD-T02`...（供切片/审查引用）
+> 「来源需求/架构章节」填 `REQ-*`/`ARCH-*` 真实编号
 
 | 表编号 | 实体名 | 中文名 | 业务含义 | 来源需求/架构章节 | 估计记录量级 |
 |--------|--------|--------|----------|-------------------|-------------|
-| DD-T01 | <!-- 实体名 --> | <!-- 中文名 --> | <!-- 业务含义 --> | <!-- REQ-001/ARCH-01 --> | <!-- 量级 --> |
 
 ### 2.2 关系定义
 | 关系编号 | 父实体 | 子实体 | 关系类型 | 基数 | 外键字段 | 级联行为 | 说明 |
 |----------|--------|--------|----------|------|----------|----------|------|
-<!-- 按实际填写 -->
-关系类型枚举：关联 / 组合 / 聚合
-基数枚举：1:1 / 1:N / M:N
+
+关系类型：关联 / 组合 / 聚合；基数：1:1 / 1:N / M:N
 
 ### 2.3 ER 图
-> 推荐 Mermaid erDiagram 语法
+> 推荐 Mermaid erDiagram
 
 ## 3. 表字段与敏感级别
 
 | 表 | 字段 | 类型 | 可空 | 默认值 | 业务含义 | 敏感级别 | 生命周期 |
 |----|------|------|------|--------|----------|----------|----------|
 
-## 4. 约束、索引与查询场景 [Always — 必填]
+## 4. 约束、索引与查询场景 [Always]
 
 ### 4.1 约束定义
 | 表名 | 约束名 | 约束类型 | 约束字段 | 约束条件 | 错误提示 |
 |------|--------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
-约束类型枚举：PRIMARY KEY / UNIQUE / FOREIGN KEY / CHECK / NOT NULL / DEFAULT
+
+约束类型：PRIMARY KEY / UNIQUE / FOREIGN KEY / CHECK / NOT NULL / DEFAULT
 
 ### 4.2 索引定义
 | 表名 | 索引名 | 索引类型 | 字段列表 | 查询场景 | 创建理由 | 预估基数 |
 |------|--------|----------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
-索引类型枚举：PRIMARY / UNIQUE / BTREE / HASH / GIN / GIST / COMPOSITE / PARTIAL
 
 ### 4.3 高频查询场景
 | 查询编号 | 查询场景 | 涉及表 | 查询条件 | 排序/分页 | 优化策略 |
 |----------|----------|--------|----------|-----------|----------|
-<!-- 按实际填写 -->
 
-## 5. 租户、安全、审计与数据生命周期 [Ask first — 多租户/敏感数据场景必填]
+## 5. 租户、安全、审计与数据生命周期 [多租户/敏感数据时必填]
 
 ### 5.1 租户隔离策略
 | 表名 | 隔离方式 | 租户字段 | 隔离级别 | 说明 |
 |------|----------|----------|----------|------|
-<!-- 按实际填写 -->
 
 ### 5.2 敏感数据保护
 | 字段路径 | 敏感级别 | 加密方式 | 脱敏规则 | 访问控制 | 合规要求 |
 |----------|----------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
 
 ### 5.3 审计字段
 | 表名 | 创建时间字段 | 更新时间字段 | 创建人字段 | 更新人字段 | 软删除字段 |
 |------|-------------|-------------|-----------|-----------|-----------|
-<!-- 按实际填写 -->
 
 ### 5.4 数据生命周期
 | 数据类型 | 保留期限 | 归档策略 | 清理策略 | 合规依据 |
 |----------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
 
-## 6. Migration、回滚、备份恢复 [Always — 必填]
+## 6. Migration、回滚、备份恢复 [Always]
 
 ### 6.1 Migration 脚本清单
 | 序号 | Migration 文件名 | 变更类型 | 涉及表 | 前置依赖 | 回滚脚本 |
 |------|-----------------|----------|--------|----------|----------|
-<!-- 按实际填写 -->
-变更类型枚举：CREATE_TABLE / ALTER_TABLE / ADD_COLUMN / DROP_COLUMN / ADD_INDEX / DATA_MIGRATION
+
+变更类型：CREATE_TABLE / ALTER_TABLE / ADD_COLUMN / DROP_COLUMN / ADD_INDEX / DATA_MIGRATION
 
 ### 6.2 回滚验证
 | Migration | 回滚命令 | 回滚验证 SQL | 预期结果 |
 |-----------|----------|-------------|----------|
-<!-- 按实际填写 -->
 
 ### 6.3 数据备份策略
 | 场景 | 备份方式 | 备份频率 | 恢复 RTO | 恢复 RPO |
 |------|----------|----------|----------|----------|
-<!-- 按实际填写 -->
 
-## 7. API/DTO 至字段映射表 [Always — 必填]
+## 7. API/DTO 至字段映射表 [Always]
 
 | API Endpoint | HTTP Method | 请求字段 | 映射表.字段 | 响应字段 | 映射表.字段 | DTO 类名 |
 |--------------|-------------|----------|------------|----------|------------|----------|
-<!-- 按实际填写 -->
 
-> 每个 API 字段必须精确追踪到数据库表.字段，无映射的字段标注"计算字段"/"外部服务"/"缓存"。
+> 每个 API 字段必须追踪到 表.字段，无映射的标注"计算字段"/"外部服务"/"缓存"。
 
-## 8. 真实验证证据与未决项 [Always — 必填]
+## 8. 真实验证证据 [Always]
 
 ### 8.1 SQL 执行证据
 | 验证项 | 执行 SQL | 预期结果 | 实际结果 | 状态 |
 |--------|----------|----------|----------|------|
-<!-- 按实际填写 -->
 
 ### 8.2 范式自检
 | 表名 | 函数依赖 | 当前范式 | 是否满足 3NF | 修正建议 |
 |------|----------|----------|-------------|----------|
-<!-- 按实际填写 -->
-
-### 8.3 字段映射覆盖自检
-| 检查项 | 覆盖状态 | 缺失说明 |
-|--------|----------|----------|
-| 所有 API 字段已追踪到数据库字段 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-| 所有数据库字段已被至少一个 API 引用 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-| 所有外键关系已在 Ch2 定义 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-| 所有索引已在 Ch4 定义且覆盖高频查询 | <!-- 是/否 --> | <!-- 按实际填写 --> |
-
-### 8.4 未决项
-| 编号 | 未决项 | 不确定分级 | 候选方案 | 状态 |
-|------|--------|-----------|----------|------|
-<!-- 按实际填写 -->
+
+## 完成判定
+
+- [ ] 所有 API 字段已追踪到 表.字段
+- [ ] 所有外键关系已在 §2 定义
+- [ ] 所有索引已定义且覆盖高频查询
+- [ ] migration 成对（up + down），回滚脚本已验证
+- [ ] 敏感字段标注敏感级别 + 保护方式
+- [ ] SQL 执行证据为真实运行结果（非静态分析）