soloforge 1.1.42 → 1.1.44

package/templates/rules/new-system//350/201/224/350/260/203/350/256/276/350/256/241/347/274/272/351/231/267/345/210/244/345/256/232/350/247/204/345/210/231.md

@@ -1,58 +0,0 @@
----
-name: integration-design-defect
-type: review_rule
-scope: ['*']
-system_scope: ['new-system']
-id: ka-review-rule-联调设计缺陷判定规则
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-new-system-review
-priority: P0
-version: 1.2.0
-last_reviewed: '2026-06-04'
-stages: ["联调验证"]
-triggers: ["设计缺陷","缺陷判定","回退判定","联调缺陷"]
----
-
-# 联调阶段严重设计缺陷判定规则
-
-## DEF-01: 核心接口联通性失败
-- id: DEF-01
-- name: 核心接口联通性失败
-- severity: error
-- check_type: semantic
-- trigger_rollback: true
-- evidence_required: 接口错误日志 + 根因分析（排除代码 bug 后确认为设计问题）
-- rule: 接口返回 500/超时且原因不是代码 bug 而是接口设计本身有问题；或两个模块间接口参数不匹配且无法通过简单调整解决
-
-## DEF-02: 数据模型冲突
-- id: DEF-02
-- name: 数据模型冲突
-- severity: error
-- check_type: semantic
-- trigger_rollback: true
-- evidence_required: 数据库实际数据流截图 + 设计文档对比 + 冲突点标注
-- rule: 实际数据流与数据库设计文档描述严重不符；或多个切片的数据模型之间存在不可调和的矛盾
-
-## DEF-03: 安全机制缺失
-- id: DEF-03
-- name: 安全机制缺失
-- severity: error
-- check_type: semantic
-- trigger_rollback: true
-- evidence_required: 缺失认证/鉴权的接口列表 + 架构设计文档安全层规划对照
-- rule: 接口缺少认证/鉴权，且架构设计文档未规划安全层
-
-## DEF-04: 业务逻辑矛盾
-- id: DEF-04
-- name: 业务逻辑矛盾
-- severity: error
-- check_type: semantic
-- trigger_rollback: true
-- evidence_required: 实现逻辑与需求文档/原型对比 + 矛盾点标注
-- rule: 实现的核心业务逻辑与需求文档/原型说明存在根本性矛盾；或发现需求/原型本身有重大遗漏或自相矛盾
-
-## 不触发回退的情况
-- 代码 bug → 在编码阶段修复
-- 小幅接口参数调整 → 在编码阶段修改
-- 测试数据问题 → 修正测试数据

package/templates/rules/shared/SOLID/344/273/243/347/240/201/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,67 +0,0 @@
----
-name: solid-code-review
-type: review_rule
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-review-rule-SOLID代码审查规则
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-ood-solid-contract
-priority: P1
-consumes:
-  - mc-ood-solid-contract
-version: 1.2.0
-last_reviewed: '2026-06-04'
-stages: ["代码审查"]
-triggers: ["代码审查","SOLID","面向对象设计","controller","service"]
----
-
-# SOLID 代码审查规则
-
-## SOLID-SRP: 单一职责 — Controller 职责边界
-- id: SOLID-SRP
-- name: 单一职责 — Controller 职责边界
-- severity: error
-- check_type: semantic
-- evidence_required: 代码审查发现中标注 Controller 违规行号与下沉建议
-- pattern: Controller 承担事务、持久化或业务计算
-- description: Controller 层只保留协议映射（HTTP 参数解析、响应封装）。事务管理、持久化操作、业务计算必须下沉到 Service 层。违反即标记为 error。
-
-## SOLID-LSP: 里氏替换 — 子类型契约遵守
-- id: SOLID-LSP
-- name: 里氏替换 — 子类型契约遵守
-- severity: error
-- check_type: semantic
-- evidence_required: 代码审查发现中标注子类型违反父契约的方法签名
-- pattern: 子类型对父契约操作抛出 unsupported
-- description: 子类型不得对父类型声明的操作抛出 UnsupportedOperationException 或返回空实现。违反时应修正抽象层级或拆分契约接口。
-
-## SOLID-ISP: 接口隔离 — 宽接口拆分
-- id: SOLID-ISP
-- name: 接口隔离 — 宽接口拆分
-- severity: warning
-- check_type: semantic
-- evidence_required: 代码审查发现中标注宽接口方法数及空实现/异常列表
-- pattern: 宽接口迫使实现提供空方法/异常
-- description: 接口方法数过多导致实现类被迫提供空方法或抛异常时，应拆分为客户端特定的细粒度接口。
-
-## SOLID-DIP: 依赖倒置 — 禁止直接构造依赖
-- id: SOLID-DIP
-- name: 依赖倒置 — 禁止直接构造依赖
-- severity: error
-- check_type: deterministic
-- evidence_required: 代码审查发现中标注 new 语句行号与建议的注入方式
-- pattern: "new\\s+\\w*(Service|Repository|Dao)\\s*\\("
-- description: 业务服务不得直接构造外部 SDK 或仓储实现（new XxxService()/new XxxRepository()）。必须引入端口（接口）并通过依赖注入装配。
-
-## SOLID-OCP: 开闭原则 — 多分支扩展风险
-- id: SOLID-OCP
-- name: 开闭原则 — 多分支扩展风险
-- severity: warning
-- check_type: semantic
-- evidence_required: 代码审查发现中标注 if-else/switch 分支数与建议的重构模式
-- pattern: 多分支 if-else/switch 随需求增长持续扩展
-- description: 当 if-else/switch 分支随需求持续增长时，应评估是否需要引入策略模式/工厂模式。当前标记为 warning，但必须记录变化维度和后续扩展方案。

package/templates/rules/shared//344/270/200/350/207/264/346/200/247/346/240/241/351/252/214/350/247/204/345/210/231.md

@@ -1,96 +0,0 @@
----
-name: consistency-check
-type: review_rule
-scope: ['*']
-products: ['*']
-lifecycle_status: active
-owner_mechanism_id: mc-generic-review
-stages: ["详细设计", "任务规划", "编码与单元测试"]
-triggers: ["一致性","校验","设计产物"]
-version: 1.3.0
-last_reviewed: '2026-06-04'
----
-
-# 设计产物一致性校验规则
-
-## 详细设计阶段校验（本阶段执行）
-
-### CON-DD-01: 实体覆盖完整性
-- pattern: 数据库设计中每张表必须对应架构设计中的实体，且无遗漏实体
-- severity: error
-- description: 架构文档所有 ARCH-* 实体必须在数据库设计中有对应表。遗漏实体必须补充或标注"本次迭代不涉及"。
-- check_focus: 覆盖完整性——提取架构文档所有 ARCH-* 实体，逐一在 DD-T* 中查找
-
-### CON-DD-02: API 模块覆盖完整性
-- pattern: API 接口规格中每个模块的所有 CRUD 操作必须完整定义
-- severity: error
-- description: 架构文档所有 ARCH-* 模块必须在 API 规格中有对应接口。遗漏操作必须补充或标注"本次迭代不涉及"。
-
-### CON-DD-03: DB-API 字段映射
-- pattern: API 接口规格中每个字段必须在数据库设计中有对应字段
-- severity: error
-- description: API 请求/响应字段必须精确追溯到数据库表.字段。例外：计算字段/缓存字段/外部服务字段需标注来源。
-
-### CON-DD-04: 约束一致性
-- pattern: API 字段约束必须与数据库字段约束一致
-- severity: warning
-- description: API 层约束不得弱于数据库层。允许 API 层更严格。不一致处须在设计文档中明确标注。
-
-## 任务规划阶段校验（本文件定义规范，任务规划阶段执行）
-
-### CON-TP-01: 任务-接口关联
-- pattern: 每个任务必须关联到详细设计中的 DD-* 编号
-- severity: error
-
-### CON-TP-02: 文件路径一致性
-- pattern: 任务涉及的文件路径必须在详细设计文档中有对应模块描述
-- severity: error
-
-### CON-TP-03: 接口调用一致性
-- pattern: 任务中的接口调用必须与 API 接口规格文档完全一致
-- severity: error
-
-### CON-TP-04: 数据操作覆盖
-- pattern: 数据库设计中每张表必须在切片任务中有对应操作覆盖
-- severity: warning
-
-## 跨阶段验证（任务规划门禁触发）
-
-### CON-CROSS-01: 切片-设计路径一致
-- pattern: 切片计划的涉及文件与详细设计描述的模块路径必须一致
-- severity: error
-
-## 编码阶段校验（编码与单元测试阶段执行）
-
-### CON-TS-01: 切片任务关联设计接口
-- pattern: 每个切片任务必须关联到 API 接口规格中定义的接口端点
-- severity: error
-- check_type: deterministic
-- description: 切片计划中每个 SLC 的上游引用必须包含 API 接口规格中的接口编号。未关联接口的切片不得进入编码。
-
-### CON-TS-02: 切片覆盖设计全部模块
-- pattern: 所有设计文档中定义的模块必须被切片任务覆盖
-- severity: error
-- check_type: semantic
-- description: 详细设计中定义的所有模块（DD-*）必须在切片计划中有对应的 SLC 覆盖。遗漏模块须补充切片或标注"本次迭代不涉及"。
-
-### CON-TS-03: 接口规格与切片一致
-- pattern: 切片涉及的接口签名必须与 API 接口规格完全一致
-- severity: error
-- check_type: deterministic
-- description: 编码时实现的接口签名（HTTP 方法、路径、参数、响应）必须与 API 接口规格文档精确匹配。偏差须更新设计文档并重新评审。
-
-### CON-TS-04: 数据库操作覆盖
-- pattern: 切片涉及的数据库操作必须在数据库设计文档中有定义
-- severity: error
-- check_type: deterministic
-- description: 切片中涉及的表操作（INSERT/UPDATE/DELETE/SELECT）必须在数据库设计文档中有对应的表定义和约束。未定义的操作须补充设计。
-
-## 校验时机
-1. 详细设计完成后、任务规划前：执行 CON-DD-01~04
-2. 任务规划完成后、编码前：执行 CON-TP-01~04 + CON-CROSS-01
-3. 编码阶段：执行 CON-TS-01~04
-
-## COMP-* 本阶段执行范围（兼容性检查规则在架构阶段定义）
-- **详细设计阶段执行**：COMP-01（字段删除过渡期）、COMP-03（新增必填字段默认值）、COMP-04（枚举值向后兼容）、COMP-05（外键数据完整性）、COMP-07（API 调用方不受影响）
-- **后续阶段执行**：COMP-02（API 版本化→编码阶段）、COMP-06（行为不变量→编码阶段）、COMP-08（配置迁移→部署阶段）、COMP-09（定时任务→部署阶段）、COMP-10（数据迁移语义→联调阶段）、COMP-11（跨阶段一致性→持续）

package/templates/rules/shared//344/270/212/346/270/270/344/272/244/345/217/211/351/252/214/350/257/201/350/247/204/345/210/231.md

@@ -1,56 +0,0 @@
----
-name: upstream-cross-validation
-type: governance_rule
-stages: ["编码与单元测试", "任务规划"]
-lifecycle_status: active
-owner_mechanism_id: mc-command-router
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-priority: P1
-triggers: ['交叉验证', '一致性校验', 'cross validation', '上游验证', '设计产物一致性']
----
-
-# 上游交叉验证规则
-
-## UCV-01: 实施前变更范围对照设计
-- id: UCV-01
-- name: 实施前变更范围对照设计
-- severity: error
-- check_type: deterministic
-- pattern: 任务规划阶段，每个切片的变更范围必须对照详细设计文档逐项确认
-- description: 任务规划阶段，每个切片的变更范围（涉及文件列表）必须对照详细设计文档逐项确认。涉及的文件列表必须与设计文档描述的模块一致。
-
-## UCV-02: 未覆盖场景回退补充
-- id: UCV-02
-- name: 未覆盖场景回退补充
-- severity: error
-- check_type: semantic
-- pattern: 发现设计文档未覆盖的场景必须回退补充设计，不得跳过
-- description: 扫描过程中发现设计文档未覆盖的业务场景，必须回退到详细设计阶段补充，不得跳过设计直接编码。
-
-## UCV-03: 实施中接口签名匹配
-- id: UCV-03
-- name: 实施中接口签名匹配
-- severity: error
-- check_type: deterministic
-- pattern: 编码阶段实现的接口签名必须与设计规格严格匹配
-- description: 编码阶段，每个切片完成后对照设计文档确认实现与设计一致。接口签名（HTTP 方法、路径、参数类型、响应结构）、数据结构、错误处理必须与设计规格严格匹配。
-
-## UCV-04: 实施中设计偏离须更新
-- id: UCV-04
-- name: 实施中设计偏离须更新
-- severity: warning
-- check_type: semantic
-- pattern: 编码中发现需要偏离设计时，必须先更新设计文档并获取确认
-- description: 编码过程中发现需要偏离设计（接口签名变更、数据结构调整、错误处理方式变更等），必须先更新设计文档并获取用户确认后才能继续。
-
-## UCV-05: 实施后设计要求全覆盖
-- id: UCV-05
-- name: 实施后设计要求全覆盖
-- severity: error
-- check_type: deterministic
-- pattern: 所有设计要求必须有对应的实现证据
-- description: 所有切片完成后，最终审查必须以设计文档为基准。每个设计要求必须有对应的实现证据。未覆盖的设计要求必须标注为待实现或已变更。

package/templates/rules/shared//344/270/212/346/270/270/350/256/276/350/256/241/344/272/244/345/217/211/351/252/214/350/257/201/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,67 +0,0 @@
----
-name: upstream-design-cross-validation-review
-type: review_rule
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-review-rule-上游设计交叉验证审查规则
-lifecycle_status: active
-authority: supporting
-priority: P1
-version: 1.2.0
-last_reviewed: '2026-06-04'
-owner_mechanism_id: mc-command-router
-stages: ["代码审查"]
-triggers: ["代码审查","交叉验证","设计对照","upstream validation"]
----
-
-# 上游设计交叉验证审查规则
-
-## UCV-REV-01: 代码接口与详细设计一致
-- id: UCV-REV-01
-- name: 代码接口与详细设计一致
-- severity: error
-- check_type: deterministic
-- pattern: 代码中的每个接口实现必须与详细设计中的接口规格一致（HTTP 方法、路径、参数、响应）
-- description: 代码中实现的接口签名、参数类型、响应结构必须与详细设计文档中的接口规格完全一致。偏差须更新设计文档并重新评审。
-- evidence_required:
-  - "代码接口签名列表"
-  - "详细设计接口规格列表"
-  - "逐项对比结果"
-
-## UCV-REV-02: 数据库操作与数据库设计一致
-- id: UCV-REV-02
-- name: 数据库操作与数据库设计一致
-- severity: error
-- check_type: deterministic
-- pattern: 代码中的数据库操作必须与数据库设计文档中的表结构一致
-- description: 代码中涉及的表操作（字段名、类型、约束）必须与数据库设计文档精确匹配。未定义的操作须补充设计。
-- evidence_required:
-  - "代码数据库操作列表"
-  - "数据库设计表结构列表"
-  - "逐项对比结果"
-
-## UCV-REV-03: 架构决策全部落地
-- id: UCV-REV-03
-- name: 架构决策全部落地
-- severity: error
-- check_type: semantic
-- pattern: 架构设计文档中的每个决策必须落实到代码实现
-- description: 架构设计文档中的每个 ARCH-* 决策必须有对应的代码实现证据。模块间调用关系须与架构图一致。技术选型的使用方式须符合架构文档约定。不得有决策无实现。
-- evidence_required:
-  - "架构决策列表（ARCH-*）"
-  - "代码实现证据映射表"
-
-## UCV-REV-04: 页面交互与原型一致
-- id: UCV-REV-04
-- name: 页面交互与原型一致
-- severity: warning
-- check_type: semantic
-- pattern: 页面交互实现必须与原型说明一致
-- description: 前端组件结构须与原型中的页面区域对应。交互反馈（提示、跳转、状态变更）须与原型说明一致。
-- evidence_required:
-  - "原型说明路径"
-  - "前端实现页面路径"
-  - "逐项对比结果"

package/templates/rules/shared//344/272/244/344/273/230/345/256/214/345/244/207/346/200/247/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,106 +0,0 @@
----
-name: delivery-completeness
-type: review_rule
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-review-rule-交付完备性审查规则
-lifecycle_status: active
-owner_mechanism_id: mc-generic-review
-authority: supporting
-priority: P1
-version: 1.2.0
-last_reviewed: '2026-06-04'
-stages: ["代码审查"]
-triggers: ["代码审查","review","交付检查","上线前检查","提交检查","终局宣言"]
----
-
-## DEL-01: 交付物缺少终局宣言签名
-pattern: /SoloForge Audit: PASS/
-severity: error
-check_type: deterministic
-scope: [backend, frontend]
-description: 所有交付物末尾必须包含 [SoloForge Audit: PASS - 已通过三重深度推演，确认无潜在隐患]。缺少此签名的交付视为无效
-evidence_required:
-  - "交付物文件路径"
-  - "终局宣言签名存在确认"
-
-## DEL-02: 验收项缺少边界值覆盖
-pattern: //
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 验收项应覆盖空值(null/undefined)、极端值(MAX_VALUE/空字符串)、异常输入场景，而非仅 happy path
-evidence_required:
-  - "验收项列表"
-  - "边界值覆盖统计"
-
-## DEL-03: 涉及外部调用但无异常处理验收
-pattern: /(?:feign|http|restTemplate|webClient|fetch|axios)\s*\(/i
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 涉及外部 HTTP 调用的代码必须有超时、异常格式、降级场景的验收覆盖
-evidence_required:
-  - "外部调用点列表"
-  - "异常处理验收覆盖确认"
-
-## DEL-04: 涉及状态变更但无事务/幂等验收
-pattern: /(?:@Transactional|save\(|insert\(|update\(|delete\()/i
-severity: warning
-check_type: deterministic
-scope: backend
-description: 涉及数据库状态变更的代码必须有事务一致性、幂等性验收覆盖
-evidence_required:
-  - "状态变更操作列表"
-  - "事务/幂等验收确认"
-
-## DEL-05: 测试断言精度不足（疑似自己证明自己）
-pattern: /(?:toBeTruthy|toBeFalsy|toBeDefined|toBeUndefined|toBeDefined)\s*\(/
-severity: info
-check_type: deterministic
-scope: [backend, frontend]
-description: 大量使用模糊断言(toBeTruthy等)视为测试有效性风险，必须补充精确断言(toBe/toEqual/toThrow)
-evidence_required:
-  - "模糊断言使用统计"
-
-## SEL-01: 技术选型无行业基准支撑
-pattern: //
-severity: error
-check_type: deterministic
-scope: [backend, frontend]
-description: 技术选型必须通过 sf_explore 检索至少 3 个行业标准方案。禁止凭空推荐方案
-evidence_required:
-  - "技术选型记录路径"
-  - "sf_explore 检索结果路径"
-  - "对比方案数（须≥3）"
-
-## SEL-02: 推荐方案未说明致命缺点规避策略
-pattern: //
-severity: warning
-check_type: semantic
-scope: [backend, frontend]
-description: 最优解宣誓必须明确说明如何规避其他方案的致命缺点。无规避说明视为不完整选型
-evidence_required:
-  - "推荐方案致命缺点列表"
-  - "规避策略说明"
-
-## TRA-01: 审查发现未按信任分级路由
-pattern: //
-severity: info
-check_type: semantic
-scope: [backend, frontend]
-description: sf_review 结果应按白盒(可跳过)/灰盒(建议审查)/黑盒(强制审查)三级分类展示，禁止平铺所有发现
-evidence_required:
-  - "信任分级统计（白盒/灰盒/黑盒项数）"
-
-## TRA-02: 审查报告缺少认知透明度标注
-pattern: //
-severity: info
-check_type: semantic
-scope: [backend, frontend]
-description: 审查结果应标注熔断触发状态、变异检测结果、漂移检测结果，确保人类能看到系统内部决策
-evidence_required:
-  - "认知透明度标注内容"

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

@@ -1,84 +0,0 @@
----
-name: code-maintainability-observability-review
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-review-rule-代码可维护性与可观测性审查
-type: review_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-code-maintainability-observability-contract
-priority: P1
-consumes:
-  - mc-code-maintainability-observability-contract
-version: 1.2.0
-last_reviewed: '2026-06-04'
-stages: ["代码审查"]
-triggers: ["代码审查","可维护性","可观测性","日志审查","注释审查"]
----
-
-# 代码可维护性与可观测性审查规则
-
-## MNT-01: 关键操作缺结构化日志
-- id: MNT-01
-- name: 关键操作缺结构化日志
-- severity: error
-- check_type: semantic
-- evidence_required: 代码审查发现中标注缺失结构化日志的操作类型与建议日志字段
-- pattern: 支付/金额/退款操作无含对象 ID 和前后值的日志；权限拒绝无含操作人和拒绝原因的日志；外部调用无含目标、响应码和重试信息的失败日志；状态变更无含前后状态和触发原因的流转日志
-- description: changed files 中关键操作必须有结构化日志：支付/金额操作须含对象 ID+前后值、权限拒绝须含操作人+拒绝原因、外部调用须含目标+响应码+重试信息、状态变更须含前后状态+触发原因、数据修复须含修复前值+影响行数。
-
-## MNT-02: 日志泄漏敏感信息
-- id: MNT-02
-- name: 日志泄漏敏感信息
-- severity: error
-- check_type: deterministic
-- evidence_required: 代码审查发现中标注泄漏敏感信息的日志行号与日志内容
-- pattern: "log\\.\\w+\\(.*(?:password|token|secret)"
-- description: 所有日志输出不得包含 token、password、cookie 全量、身份证、手机号、银行卡全量、健康隐私信息。发现泄漏须立即修复。
-
-## MNT-03: 复杂业务规则缺设计意图注释
-- id: MNT-03
-- name: 复杂业务规则缺设计意图注释
-- severity: error
-- check_type: semantic
-- evidence_required: 代码审查发现中标注缺注释的业务规则位置与建议注释内容
-- pattern: 复杂业务规则/金额计算/状态机缺说明"为什么"的中文注释
-- description: changed files 中复杂业务规则必须有说明"为什么"的中文注释（不检查纯复述代码的废话注释）。金额计算须有中文设计意图注释、状态机须有中文状态流转注释。所有注释必须使用中文，禁止全英文业务注释。
-
-## 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。
-
-## 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"）。至少需要记录日志，含异常上下文信息。
-
-## MNT-06: 业务注释未使用中文
-- id: MNT-06
-- name: 业务注释未使用中文
-- severity: error
-- check_type: semantic
-- evidence_required: 代码审查发现中标注全英文注释的文件、行号与建议中文注释内容
-- pattern: 后端类/方法缺中文 Javadoc；关键业务行（状态流转、金额、权限、外部调用）缺中文行注释；DTO/VO/Entity 字段缺中文说明
-- description: 所有业务注释必须使用中文：后端类/接口/枚举须有中文文档注释说明职责和业务边界；业务方法须有中文文档注释说明作用、参数语义和返回值含义；关键业务行须有中文行注释；DTO/VO/Entity/Request/Response 字段须有中文含义说明或注解。允许保留英文代码标识符，但业务说明必须中文表达。纯样式、getter/setter、简单类型定义可豁免。
-
-## MNT-07: 业务日志未使用中文
-- id: MNT-07
-- name: 业务日志未使用中文
-- severity: error
-- check_type: semantic
-- evidence_required: 代码审查发现中标注全英文日志的文件、行号与建议中文事件名
-- pattern: 业务日志首字符串不含中文；日志事件名全英文；catch 块日志无中文上下文
-- description: 所有业务日志必须使用中文事件名或中文动作说明：用户登录/登出、权限拒绝、状态变更、金额变更、外部调用、异步任务、异常处理等日志的事件名或首字符串必须包含中文。日志中必须包含业务对象 ID、操作人、关键状态变化前后值等上下文。禁止只打印英文 "error"/"failed"/"success" 的不可定位日志。

package/templates/rules/shared//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -1,122 +0,0 @@
----
-name: code-comment-log-contract
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-代码注释与日志契约规则
-type: governance_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-code-maintainability-observability-contract
-priority: P0
-consumes:
-  - mc-coding-readiness
-hard_blocks:
-  - code_observability_work_package_missing
-  - sensitive_log_leak
-  - catch_swallow
-  - missing_log_critical
-  - missing_comment_complex_unresolved
-  - missing_class_doc
-  - missing_method_doc
-  - missing_important_line_comment
-  - non_chinese_log
-  - non_chinese_comment
-fallback: manual_required
-required_evidence:
-  - code_observability_work_package
-  - review_findings
-  - verification_result
-version: 1.1.0
-last_reviewed: '2026-06-01'
-stages: ["*"]
----
-
-## 注释契约
-
-### 中文 Javadoc 必须具备
-- Java/Kotlin 后端类、接口、枚举、记录必须有中文文档注释，说明类型职责、业务边界和使用场景。
-- 后端每个业务方法必须有中文文档注释，说明方法作用；有入参时说明参数语义；有返回值时说明返回对象或结果含义。
-- Controller、Service、UseCase、DomainService、Repository、Mapper、DTO、VO、Request、Response、Entity 等均适用。
-- 关键业务行必须有中文行注释，尤其是事务双写、状态流转、级联删除、账号联动、外部调用、审计写入、补偿和回滚边界。
-- 允许保留英文代码标识符，但业务说明、风险说明、参数说明、返回说明必须中文表达。
-
-### 必须有注释
-- 业务规则不直观时
-- 领域不变量（如"一个用户同一时间只能有一个有效业务办理"）
-- 金额、账单、折扣、支付、退款、核验逻辑
-- 状态流转逻辑（如 pending → paid → refunded）
-- 幂等、分布式锁、事务、并发控制
-- 权限、安全、审计判断
-- 外部系统兼容、历史包袱、第三方接口限制
-- 复杂 SQL、复杂查询条件、非显而易见算法
-- 前端复杂交互规则：权限控制、状态流转、表单联动、乐观更新/回滚、支付与敏感操作
-
-### 必须禁止
-- 每行废话注释
-- 复述代码字面含义的注释
-- 注释与代码行为不一致
-- 注释承诺了代码没有做到的安全性、幂等性或事务性
-- 用户项目业务注释全英文
-- 只写 `{@inheritDoc}` 但没有说明本实现的业务边界、入参和出参
-
-## 日志契约
-
-### 日志中必须有
-- 用户登录、登出、认证失败
-- 权限拒绝、越权访问
-- 创建、修改、删除关键业务对象
-- 状态变更、金额变更、支付、退款、折扣、核验
-- 合同、业务办理、账单、证照、人员角色变更
-- 外部 API 调用失败、超时、重试
-- 异步任务开始、成功、失败、重试、跳过
-- 数据修复、批处理、迁移脚本
-- 捕获异常后继续执行
-- 降级、兜底、补偿逻辑
-- 前端关键交互：表单提交、状态变更、权限动作、支付/敏感操作、上传导入、API 调用失败
-
-### 日志必须具备的要素
-- 中文事件名或中文动作说明
-- 事件名或动作名
-- 业务对象 ID
-- 操作人或系统来源
-- traceId / correlationId（如果项目已有）
-- 失败原因
-- 关键状态变化前后值
-- 合理日志级别
-
-### 日志中必须禁止
-- 裸 console.log（生产代码）
-- 生产代码遗留调试日志
-- catch 后无日志直接吞异常
-- 只打印 "error"、"failed" 这类不可定位日志
-- 用户项目业务日志全英文
-- 打印 password、token、secret、cookie、身份证全量、手机号全量、银行卡全量、健康隐私
-- 高频循环里刷屏日志
-- 日志拼接大对象导致性能或隐私问题
-
-## 项目 logger 识别
-- Java/Spring: Slf4j + LoggerFactory
-- Node/Express/NestJS: pino, winston, NestJS Logger, 项目封装 logger
-- Python/FastAPI、Go handler、.NET、Ruby 等后端: 使用项目现有 logger 或先建立 logger 包装
-- NestJS: Logger
-- React/Vue/Svelte 等前端: 项目封装 logger、埋点或错误上报，生产环境禁止裸 console
-- 如果项目没有 logger，要求先建立项目 logger 包装
-
-## 跨技术栈适用范围
-- 后端不限定 Spring：Controller、Service、UseCase、Handler、Router、Resolver、ViewSet、Repository、Mapper 等写操作都适用。
-- 前端不限定框架：React、Vue、Svelte、移动端页面和状态 store 的业务提交、状态变更、权限动作和 API 失败都适用。
-- Entity、Request、Response、VO、DTO、Schema、Serializer、Model 等用户项目契约类的业务字段需要中文含义说明或 Schema 注解。
-- Java Entity 使用 Getter/Setter 分层访问策略；DTO、VO、Request、Response 使用 Data 风格承载边界数据，不得混用导致领域模型语义被抹平。
-
-## 严重度
-- P0 阻断: 敏感信息泄漏、catch 吞异常、支付/金额/权限变更无日志
-- P1 阻断: 状态流转无日志、复杂规则无注释、后端类/方法中文 Javadoc 缺失、关键行中文注释缺失、中文日志缺失、外部调用无日志、裸 console.log
-- P2 警告: 日志级别不合理、上下文字段不足
-- P3 建议: 普通可读性优化
-
-## 低风险跳过
-- 纯样式、文案、简单 getter/setter、简单类型定义、测试 fixture
-- 低风险只读查询且已有统一 access log
-- 简单配置修改、一次性本地实验代码