soloforge 1.1.37 → 1.1.40

package/templates/rules/shared//344/273/243/347/240/201/345/217/257/347/273/264/346/212/244/346/200/247/344/270/216/345/217/257/350/247/202/346/265/213/346/200/247/345/256/241/346/237/245.md

@@ -6,76 +6,61 @@ products:
   - '*'
 id: ka-review-rule-代码可维护性与可观测性审查
 type: review_rule
-asset_kind: review_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-code-maintainability-observability-contract
-routes:
-  - code_change
-  - review
-primary_triggers:
-  - 代码审查
-  - review
-  - 验证
-secondary_triggers:
-  - 业务代码
-  - 接口实现
-negative_triggers:
-  - 纯文档
-  - 纯样式
 priority: P1
-specificity: 4
 consumes:
-version: 1.1.0
-last_reviewed: '2026-06-01'
+  - mc-code-maintainability-observability-contract
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
+triggers: ["代码审查","可维护性","可观测性","日志审查","注释审查"]
 ---
 
-## 审查维度
+# 代码可维护性与可观测性审查规则
 
-### 1. 日志完整性
-检查 changed files 中:
-- 支付/金额/退款操作是否有含对象 ID 和前后值的日志
-- 权限拒绝是否有含操作人和拒绝原因的日志
-- 外部调用是否有含目标、响应码和重试信息的失败日志
-- 状态变更是否有含前后状态和触发原因的流转日志
-- 数据修复/迁移是否有含修复前值和影响行数的审计日志
+## MNT-01: 关键操作缺结构化日志
+- id: MNT-01
+- name: 关键操作缺结构化日志
+- severity: error
+- check_type: semantic
+- evidence_required: 代码审查发现中标注缺失结构化日志的操作类型与建议日志字段
+- pattern: 支付/金额/退款操作无含对象 ID 和前后值的日志；权限拒绝无含操作人和拒绝原因的日志；外部调用无含目标、响应码和重试信息的失败日志；状态变更无含前后状态和触发原因的流转日志
+- description: changed files 中关键操作必须有结构化日志：支付/金额操作须含对象 ID+前后值、权限拒绝须含操作人+拒绝原因、外部调用须含目标+响应码+重试信息、状态变更须含前后状态+触发原因、数据修复须含修复前值+影响行数。
 
-### 2. 敏感信息泄漏
-检查所有日志输出是否:
-- 不包含 token、password、cookie 全量
-- 不包含身份证、手机号、银行卡全量
-- 不包含健康隐私信息
+## MNT-02: 日志泄漏敏感信息
+- id: MNT-02
+- name: 日志泄漏敏感信息
+- severity: error
+- check_type: deterministic
+- evidence_required: 代码审查发现中标注泄漏敏感信息的日志行号与日志内容
+- pattern: "log\\.\\w+\\(.*(?:password|token|secret)"
+- description: 所有日志输出不得包含 token、password、cookie 全量、身份证、手机号、银行卡全量、健康隐私信息。发现泄漏须立即修复。
 
-### 3. 注释质量
-检查 changed files 中:
-- 复杂业务规则是否有说明"为什么"的注释
-- 金额计算是否有设计意图注释
-- 状态机是否有状态流转注释
-- 不检查纯复述代码的废话注释
+## MNT-03: 复杂业务规则缺设计意图注释
+- id: MNT-03
+- name: 复杂业务规则缺设计意图注释
+- severity: warning
+- check_type: semantic
+- evidence_required: 代码审查发现中标注缺注释的业务规则位置与建议注释内容
+- pattern: 复杂业务规则/金额计算/状态机缺说明"为什么"的注释
+- description: changed files 中复杂业务规则必须有说明"为什么"的注释（不检查纯复述代码的废话注释）。金额计算须有设计意图注释、状态机须有状态流转注释。
 
-### 4. Logger 使用
-检查是否使用了项目已有 logger:
-- Java/Spring 项目是否使用 Slf4j
-- Node 项目是否使用 pino/winston
-- NestJS 项目是否使用 NestJS Logger
-- 前端项目是否避免裸 console
+## MNT-04: 未使用项目标准 Logger
+- id: MNT-04
+- name: 未使用项目标准 Logger
+- severity: warning
+- check_type: deterministic
+- evidence_required: 代码审查发现中标注非标准 Logger 调用行号与项目标准 Logger 名称
+- pattern: "(?:console\\.log|System\\.out\\.print)"
+- description: Java/Spring 项目使用 Slf4j、Node 项目使用 pino/winston、NestJS 项目使用 NestJS Logger、前端项目避免裸 console.log。
 
-### 5. 异常处理
-检查 catch 块是否:
-- 不吞异常（至少记录日志）
-- 不只输出 "error" / "failed" 这类不可定位信息
-
-## 审查输出格式
-每条 finding 包含:
-- 类别 (category)
-- 严重度 (P0/P1/P2/P3)
-- 文件路径
-- 证据位置
-- 中文修复建议
-
-## 低风险跳过规则
-- 纯样式、文案修改不触发审查
-- 简单 getter/setter 不触发审查
-- 测试 fixture 不触发审查
-- 低风险只读查询（且已有统一 access log）不触发审查
+## MNT-05: catch 块吞异常
+- id: MNT-05
+- name: catch 块吞异常
+- severity: error
+- check_type: deterministic
+- evidence_required: 代码审查发现中标注空 catch 块行号与建议的异常处理方式
+- pattern: "catch\\s*\\([^)]*\\)\\s*\\{\\s*\\}"
+- description: catch 块不得为空或仅输出不可定位信息（如 "error"/"failed"）。至少需要记录日志，含异常上下文信息。

package/templates/rules/shared//345/206/263/347/255/226/345/256/214/346/225/264/346/200/247/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,29 +1,20 @@
 ---
 name: decision-completeness-review
 type: review_rule
-when: '决策研讨, 架构决策, decision review'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-决策完整性审查规则
-asset_kind: review_rule
 lifecycle_status: active
 authority: supporting
-routes: ['code_change', 'planning']
-primary_triggers:
-  - 决策完整性审查规则
-secondary_triggers:
-  - 决策审查
-  - 架构决策
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
 owner_mechanism_id: mc-architecture-decision-workshop
+triggers: ["决策研讨","架构决策","decision review"]
 ---
 
 # 决策完整性审查规则
@@ -32,26 +23,41 @@ owner_mechanism_id: mc-architecture-decision-workshop
 
 pattern: 业务流程、数据、安全、后端、前端、基础设施六域必须有决策记录
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 每个域至少有一个明确的决策点；与当前需求无关的域可以标注"不适用"但不得留空
+evidence_required:
+  - "六域决策覆盖列表"
+  - "每域决策记录路径或不适标注"
 
 ## DEC-02: 每个决策有量化依据
 
 pattern: 决策记录必须包含选型理由、对比方案和量化指标
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 决策不得仅写"选择 X"，必须包含：为什么选 X、对比了哪些方案、用什么指标衡量的
+evidence_required:
+  - "决策记录路径"
+  - "选型理由+对比方案+量化指标确认"
 
 ## DEC-03: 用户确认证据存在
 
 pattern: 每个关键决策必须有用户确认记录
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 涉及架构、技术栈、数据结构、API 设计的关键决策，必须有用户确认的证据（确认文本或审批记录）
+evidence_required:
+  - "用户确认记录路径"
+  - "确认时间+确认内容"
 
 ## DEC-04: 决策可追溯
 
 pattern: 每个决策必须关联到具体的需求点
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 决策不能凭空产生，必须能追溯到触发它的需求或问题；无需求对应的决策标注为"技术优化"
+evidence_required:
+  - "决策-需求追溯映射表"

package/templates/rules/shared//345/210/207/347/211/207/346/211/247/350/241/214/347/272/252/345/276/213/350/247/204/345/210/231.md

@@ -0,0 +1,96 @@
+---
+name: slice-execution-discipline
+type: governance_rule
+stages: ["编码与单元测试"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+priority: P1
+triggers: ['切片执行', '编码执行', 'slice execution', '开始编码', '实现切片']
+---
+
+# 切片执行纪律规则
+
+## SED-01: 扫描先行
+- id: SED-01
+- name: 扫描先行
+- severity: error
+- check_type: deterministic
+- pattern: 编码前必须扫描所有涉及文件，记录文件/行号/变更类型；扫描时间戳 < 编码开始时间
+- description: 编码前必须扫描所有涉及文件，记录文件/行号/变更类型。扫描结果必须写入执行记录。未完成扫描不得开始编码。
+
+## SED-02: 测试前置≥9 场景
+- id: SED-02
+- name: 测试前置≥9 场景
+- severity: error
+- check_type: deterministic
+- pattern: 每个切片必须有 ≥9 个新测试场景（正常×2 + 边界×3 + 错误×2 + 集成×2）
+- description: 每个切片必须有≥9 个新测试场景覆盖核心逻辑。测试场景必须覆盖：正常路径×2、边界条件×3、错误路径×2、集成场景×2。测试文件必须在编码开始前创建。已有测试的修改也必须增加新场景。
+
+## SED-03: 逐条对账
+- id: SED-03
+- name: 逐条对账
+- severity: error
+- check_type: deterministic
+- pattern: AC × 测试用例映射表完整，每条 AC 有≥1 个测试用例
+- description: 编码完成后，逐条对照验收标准确认完成。每条验收标准必须对应至少一个测试用例。未通过的验收标准必须标注原因和修复计划。
+
+## SED-04: 禁止跨任务修改
+- id: SED-04
+- name: 禁止跨任务修改
+- severity: error
+- check_type: deterministic
+- pattern: git diff --name-only 与涉及文件列表对比，偏差≤2 文件
+- description: 当前切片只能修改涉及文件列表中的文件。偏差超过 2 个文件须触发重规划评估。
+
+## SED-05: 禁止跳过扫描
+- id: SED-05
+- name: 禁止跳过扫描
+- severity: error
+- check_type: deterministic
+- pattern: 扫描记录文件存在且时间戳 < 编码开始时间
+- description: 未完成文件扫描直接编码视为违规。扫描记录必须包含文件路径、行号、变更类型。
+
+## SED-06: 禁止空函数体
+- id: SED-06
+- name: 禁止空函数体
+- severity: error
+- check_type: deterministic
+- pattern: grep -E 'TODO|placeholder|pass;$' 新增函数扫描结果为 0
+- description: 所有新增函数必须有实现，不允许 TODO/placeholder/pass 占位。
+
+## SED-07: 反模式——试错式编码
+- id: SED-07
+- name: 反模式——试错式编码
+- severity: warning
+- check_type: semantic
+- pattern: 未定位根因就修改代码，同一位置修改≥3 次
+- description: 编码时未定位根因就修改代码。发现异常应先分析日志和堆栈，定位根因后再修改。
+
+## SED-08: 反模式——顺手重构
+- id: SED-08
+- name: 反模式——顺手重构
+- severity: warning
+- check_type: semantic
+- pattern: 编码过程中偏离目标进行非计划内的重构
+- description: 编码过程中发现"可以优化"而偏离目标。重构必须单独规划，不得在功能切片中混入。
+
+## SED-09: 反模式——隐式依赖
+- id: SED-09
+- name: 反模式——隐式依赖
+- severity: warning
+- check_type: semantic
+- pattern: 新增未在计划中声明的文件依赖
+- description: 新增的 import/require 必须在切片计划的涉及文件列表中声明。未声明的依赖须触发重规划。
+
+## SED-10: 反模式——吞异常
+- id: SED-10
+- name: 反模式——吞异常
+- severity: error
+- check_type: deterministic
+- pattern: 空 catch 块扫描结果为 0（grep -E 'catch\s*\([^)]*\)\s*\{\s*\}' 匹配 0）
+- description: catch 块中不处理也不上报。空 catch 扫描必须为 0，至少需要记录日志或明确注释忽略原因。

package/templates/rules/shared//345/210/207/347/211/207/350/247/204/345/210/222/350/247/204/345/210/231.md

@@ -0,0 +1,64 @@
+---
+name: slice-planning
+type: governance_rule
+stages: ["任务规划"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+priority: P1
+triggers: ['切片规划', '切片计划', 'slice planning', '任务拆分', '功能拆分']
+---
+
+# 切片规划规则
+
+## SLP-01: 最小闭环
+- id: SLP-01
+- name: 最小闭环
+- severity: error
+- check_type: semantic
+- pattern: 切片 AC 不得引用其他切片的输出作为前置条件
+- description: 每个切片必须能独立完成并验证，不依赖后续切片的产出。AC 中引用的输入必须是上游设计产物（DD-*/ARCH-*），而非同层级其他切片的输出。
+
+## SLP-02: 可独立测试
+- id: SLP-02
+- name: 可独立测试
+- severity: error
+- check_type: semantic
+- pattern: 每个切片的测试文件可独立执行，不需要等待其他切片完成
+- description: 切片完成后必须能独立运行测试验证。若需其他切片的数据，须通过 fixture/mock 提供，不得依赖真实执行顺序。
+
+## SLP-03: 单一职责
+- id: SLP-03
+- name: 单一职责
+- severity: warning
+- check_type: semantic
+- pattern: 切片描述≤2 个功能点
+- description: 每个切片只聚焦一个功能点或一个变更维度。描述超过 2 个功能点的切片应拆分。复合切片须用前置依赖字段关联。
+
+## SLP-04: 上游引用完备
+- id: SLP-04
+- name: 上游引用完备
+- severity: error
+- check_type: deterministic
+- pattern: 每个切片的上游引用字段包含 DD-* 和 ARCH-* 编号
+- description: 每个切片必须引用详细设计文档中的 DD-* 编号（接口/模块）和架构设计文档中的 ARCH-* 编号（架构决策）。无上游设计引用的切片不得进入执行阶段。
+
+## SLP-05: 验收标准三路径
+- id: SLP-05
+- name: 验收标准三路径
+- severity: error
+- check_type: deterministic
+- pattern: 每个切片≥3 条 AC，覆盖功能/质量/边界三路径
+- description: 每个切片必须有 AC-* 验收标准，至少包含：功能验收（核心功能点的预期行为）、质量验收（测试覆盖率、无 lint 错误）、边界验收（边界条件和错误处理）。
+
+## SLP-06: ID 命名规范
+- id: SLP-06
+- name: ID 命名规范
+- severity: error
+- check_type: deterministic
+- pattern: 切片 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/rules/shared//345/216/237/345/236/213/346/272/220/347/240/201/346/217/220/345/217/226/350/247/204/345/210/231.md

@@ -0,0 +1,67 @@
+---
+name: prototype-source-extraction
+type: governance_rule
+stages: ["需求分析"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+priority: P0
+triggers: ["原型提取","源码分析","source extraction","prototype source"]
+---
+
+# 原型源码提取规则
+
+## 必须读取的源码材料
+
+需求分析阶段，必须从以下路径模式读取源码材料：
+
+1. `src/**/*Controller.ts` — 控制器层，提取路由定义和请求处理逻辑
+2. `src/**/*Service.ts` — 服务层，提取业务规则和流程编排
+3. `src/**/*Repository.ts` / `src/**/*Dao.ts` — 数据访问层，提取数据模型和查询逻辑
+4. `src/**/*Model.ts` / `src/**/*Entity.ts` — 实体定义，提取字段和约束
+5. `src/**/*Config.ts` / `config/**/*` — 配置文件，提取环境依赖和参数
+6. `src/**/*Middleware.ts` — 中间件，提取横切关注点（认证、日志等）
+7. `src/pages/**/*` / `src/views/**/*` / `app/**/page.tsx` — 页面组件，提取路由和页面结构
+8. `src/components/**/*` — UI 组件，提取组件树和 props
+9. `src/stores/**/*` / `src/state/**/*` — 状态管理，提取数据流和状态转换
+10. `src/styles/**/*` / `src/tokens.*` / `tailwind.config.*` — 设计令牌，提取色彩/间距/字体
+11. `src/api/**/*` / `src/services/**/*` — API 客户端，提取接口调用和数据绑定
+12. `src/i18n/**/*` / `src/locales/**/*` — 国际化文件，提取文案和术语
+
+### 可选设计资源路径
+
+> SoloForge 核心场景是从源码提取。以下路径为可选，但一旦存在必须标注引用。
+
+13. `design/**/*` / `figma-export/**/*` / `prototype-export/**/*` — 设计稿导出文件
+14. `*.figma` / `*.sketch` — 原始设计文件路径（仅标注，不直接读取）
+15. `docs/design/**/*` / `docs/prototype/**/*` — 设计文档
+
+### 接口与数据规格路径
+
+16. `openapi.*` / `swagger.*` / `api-docs/**/*` — API 规格文件
+17. `prisma/schema.prisma` / `drizzle/schema.ts` / `knexfile.*` — ORM schema
+18. `migrations/**/*` / `db/migrate/**/*` — 数据库迁移文件
+
+## 禁止来源
+
+以下来源不得作为需求分析的源码材料依据：
+
+1. 禁止仅凭口头描述编写需求，必须有源码证据支撑
+2. 禁止从 `node_modules/` 或第三方库源码推断需求
+3. 禁止使用 `dist/` 或编译产物代替源码
+4. 禁止从测试文件反推需求规格（测试用于验证，不用于定义）
+
+## 证据标记规范
+
+每个提取的需求点必须标注来源证据：
+
+- `[SRC:文件路径:行号]` — 直接从源码提取
+- `[LOG:日志片段]` — 从运行日志推导（需标注日志来源）
+- `[CFG:配置项]` — 从配置文件提取
+- `[REF:引用链路]` — 从调用链路推导（需标注链路起点和终点）
+- `[DES:设计资源路径]` — 设计稿提取（需人工确认）
+- `[INF:推理结论]` — AI 推理（低置信，必须标注推理依据，须人工确认才可进入基线）

package/templates/rules/shared//345/216/237/345/236/213/350/257/264/346/230/216/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,73 @@
+---
+name: prototype-specification-review
+type: review_rule
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-review-rule-原型说明审查规则
+lifecycle_status: active
+authority: supporting
+priority: P1
+stages: ["需求分析"]
+owner_mechanism_id: mc-generic-artifact
+triggers: ["原型审查","原型说明审查","prototype review"]
+---
+
+# 原型说明审查规则
+
+## PROT-01: 完整性
+
+pattern: 原型说明模版 10 个章节无空洞
+severity: error
+scope: [frontend]
+description: 原型说明必须完整覆盖 10 个章节（含第 9 章边界异常和第 10 章无障碍），不得有空章节、TODO 占位或 `-` 单独占位。
+
+## PROT-02: 证据标记
+
+pattern: 所有章节内容标注来源标记
+severity: warning
+scope: [frontend]
+description: 所有内容必须使用统一证据标记体系 [SRC]/[LOG]/[CFG]/[REF]/[DES]/[INF]，不得有无标记的断言。
+
+## PROT-03: 交互闭环
+
+pattern: 状态机无死端，所有异常分支有处理
+severity: error
+scope: [frontend]
+description: 第 5 章交互流转的状态机图必须所有路径有终止状态，第 9 章异常分支每个子节至少 1 条场景。
+
+## PROT-04: 术语一致
+
+pattern: 使用与项目术语表一致的命名
+severity: warning
+scope: [frontend]
+description: 原型说明中的术语必须与需求分析第 3 章术语表一致，不得使用未定义的同义词。
+
+## PROT-05: 令牌引用
+
+pattern: 色彩/间距/字体引用设计令牌而非硬编码色值
+severity: warning
+scope: [frontend]
+description: 第 2 章设计令牌中定义的令牌名必须在第 6 章视觉状态中引用，禁止出现硬编码色值（如 #FF0000）。
+
+## PROT-06: 无障碍完备
+
+pattern: 第 10 章 5 个子节无空洞
+severity: warning
+scope: [frontend]
+description: 第 10 章无障碍的 5 个子节（键盘导航/ARIA/焦点管理/色彩对比度/屏幕阅读器）必须全部填写，不得有空子节。
+
+## PROT-07: 响应式覆盖
+
+pattern: 至少覆盖 Desktop / Mobile 两个断点
+severity: warning
+scope: [frontend]
+description: 第 7 章响应式断点必须至少包含 Desktop 和 Mobile 两个断点定义。
+
+## PROT-08: 异常覆盖
+
+pattern: 第 9 章 4 个子节每节至少 1 条场景
+severity: error
+scope: [frontend]
+description: 第 9 章边界与异常分支的 4 个子节（数据边界/网络权限异常/并发竞态/加载态）每节至少 1 条场景记录。

package/templates/rules/shared//345/217/221/345/270/203/345/220/216/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,30 +1,20 @@
 ---
 name: post-release-review
 type: review_rule
-when: '发布后, 上线观察, post-release review'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-发布后审查规则
-asset_kind: review_rule
 lifecycle_status: active
 owner_mechanism_id: mc-delivery-gate
 authority: supporting
-routes:
-  - code_change
-primary_triggers:
-  - 发布后审查规则
-secondary_triggers:
-  - 发布后审查
-  - 上线观察
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
+triggers: ["发布后","上线观察","post-release review"]
 ---
 
 # 发布后审查规则
@@ -32,27 +22,44 @@ stages: ["代码审查"]
 ## REL-01: 监控指标在阈值内
 
 pattern: 发布后关键监控指标必须在正常范围内
-severity: warning
+severity: error
+check_type: deterministic
 scope: [backend, frontend]
-description: 错误率、响应时间、吞吐量等关键指标在发布后 30 分钟内必须在历史基线 ±20% 范围内
+description: 错误率、响应时间、吞吐量等关键指标在发布后 30 分钟内必须在历史基线 ±20% 范围内。监控指标必须通过，不得为建议项。
+evidence_required:
+  - "监控指标报告路径"
+  - "错误率/响应时间/吞吐量数值"
+  - "与基线对比结果（须在 ±20% 范围内）"
 
 ## REL-02: 无新增告警
 
 pattern: 发布后不得产生新的异常告警
 severity: warning
+check_type: deterministic
 scope: [backend, frontend]
 description: 发布后检查告警系统，不得有因本次发布新增的错误日志或异常告警
+evidence_required:
+  - "告警系统检查结果"
+  - "新增告警列表（须为空）"
 
 ## REL-03: 回滚预案已验证
 
 pattern: 回滚操作必须在发布前验证过
 severity: warning
+check_type: deterministic
 scope: [backend, frontend]
 description: 回滚预案必须经过实际演练或自动化验证，确认回滚操作可在 5 分钟内完成
+evidence_required:
+  - "回滚预案文档路径"
+  - "演练/验证记录"
 
 ## REL-04: 数据一致性确认
 
 pattern: 发布后必须验证数据一致性
 severity: warning
+check_type: deterministic
 scope: backend
 description: 涉及数据库变更的发布，发布后必须验证新老数据的一致性（数据校验脚本通过）
+evidence_required:
+  - "数据一致性校验脚本路径"
+  - "校验结果（须通过）"

package/templates/rules/shared//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,40 +1,63 @@
 ---
 name: backend-implementation-review
 type: review_rule
-when: '后端审查, Controller, DTO, 事务, 幂等, 权限'
 scope:
   - backend
 products:
   - '*'
 id: ka-review-rule-后端实现工程审查规则
-asset_kind: review_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-backend-implementation-contract
-routes:
-  - code_change
-primary_triggers:
-  - 后端实现工程审查规则
-secondary_triggers:
-  - 接口审查
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-ood-solid-contract
 required_evidence:
   - code_review_findings
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["后端审查","Controller","DTO","事务","幂等","权限"]
 ---
 
-## 硬失败检查
+# 后端实现工程审查规则
 
-| 分类 | 失败表现 | 修复要求 |
-|---|---|---|
-| Controller 边界 | 入参/出参使用数据库实体 | 改为 DTO/VO 并显式映射 |
-| 参数校验 | POST/PUT/PATCH 未校验 | 补校验注解或验证器与失败测试 |
-| 事务 | 事务中调用 HTTP/MQ/外部 SDK | 拆分边界或采用 outbox/补偿 |
-| 幂等 | 支付、回调或写入无幂等证据 | 补请求键/唯一约束/重复提交测试 |
-| 安全审计 | 敏感接口无权限、租户或审计 | 补安全校验和审计证据 |
+## BIE-01: Controller 边界
+- id: BIE-01
+- name: Controller 边界
+- severity: error
+- check_type: deterministic
+- pattern: Controller 入参/出参使用数据库实体 → 改为 DTO/VO 并显式映射
+- description: Controller 层不得直接暴露数据库实体。入参使用 RequestDTO，出参使用 ResponseVO/ResponseDTO，通过 Mapper 显式转换。
+
+## BIE-02: 参数校验
+- id: BIE-02
+- name: 参数校验
+- severity: error
+- check_type: deterministic
+- pattern: POST/PUT/PATCH 端点必须有参数校验注解或验证器，且校验失败有测试覆盖
+- description: 所有 POST/PUT/PATCH 端点必须使用 @Valid/@Validated 或自定义 Validator。校验失败的路径必须有测试用例覆盖。
+
+## BIE-03: 事务
+- id: BIE-03
+- name: 事务
+- severity: error
+- check_type: deterministic
+- pattern: 事务中不得调用 HTTP/MQ/外部 SDK；违反须拆分边界或采用 outbox/补偿模式
+- description: 事务范围内禁止包含 HTTP 调用、消息队列发送、外部 SDK 调用。需要跨系统一致性时使用 outbox 模式或补偿事务。
+
+## BIE-04: 幂等
+- id: BIE-04
+- name: 幂等
+- severity: error
+- check_type: deterministic
+- pattern: 支付、回调或写入操作必须有幂等证据（请求键/唯一约束/重复提交测试）
+- description: 涉及支付、回调、写入的接口必须有幂等保护。通过请求键（idempotency key）、数据库唯一约束或分布式锁实现，并提供重复提交测试用例。
+
+## BIE-05: 安全审计
+- id: BIE-05
+- name: 安全审计
+- severity: error
+- check_type: deterministic
+- pattern: 敏感接口必须有权限校验、租户隔离和审计日志
+- description: 涉及敏感数据的接口必须实现权限校验（RBAC/ABAC）、多租户数据隔离、操作审计日志。缺少任一项视为 hard_fail。