soloforge 1.1.45 → 1.1.47

package/templates/shared//347/237/245/350/257/206/344/270/273/346/235/203.md

@@ -1,66 +0,0 @@
----
-id: ka-pattern-authority
-kind: knowledge
-title: 知识主权
-sync_policy: internal
-status: active
-extra:
-  name: authority
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- knowledge/patterns/core/ 为人工维护只读区，AI 严禁修改
-- AI 进化产物只能写入 knowledge/patterns/temp/
-- 自进化机制（evolve）生成的知识条目经 KnowledgeWriter 写入 temp/
-- KnowledgeWriter.promoteToActive() 路由所有 pattern 类型到 patterns/temp/
-- updateKnowledge() 检测 core/ 路径时直接拒绝，返回知识隔离错误
-- drift_ratio >= 0.3 时触发漂移检测，根因分析判定:
-  - code_degradation: 安全规则违反，禁止更新知识库
-  - business_evolution: 多文件普遍违反，允许更新知识库（仅 temp/）
-  - unknown: 人工审核后决定
-- drift_ratio >= 0.5 且 code_degradation 时触发逻辑奇点警告
-
-## 验收项
-
-- [AC-01] core/ 目录下任何文件无法通过 AI 工具修改
-- [AC-02] evolve() 写入的条目路径包含 temp/
-- [AC-03] updateKnowledge() 对 core/ 条目返回"知识隔离"错误
-- [AC-04] KnowledgeWriter.isCorePath() 正确识别 core/ 路径
-- [AC-05] 自进化知识条目 status 从 staged → active 的路径仅经过 temp/
-
-## 逆向退化防护
-
-- 连续 3 次 drift 检测均为 code_degradation 时，暂停自动自愈
-- 暂停后需人工审查代码库状态，确认不是 AI 连续敷衍导致的退化
-
-## 何时使用
-
-advisory: 知识治理是建议性的，尚未接入强制门禁
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- 知识模版格式验证测试通过
-- 中文语义化路径测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//347/237/245/350/257/206/346/262/273/347/220/206.md

@@ -1,31 +0,0 @@
----
-id: ka-hard-rule-知识治理规则
-kind: guidance
-title: 知识治理
-owner_mechanism: mc-knowledge-governance
-sync_policy: internal
-status: active
-extra:
-  name: knowledge-governance
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
----
-
-# 知识治理规则
-
-知识资产从草稿、演进、同步到注入必须有统一治理入口。
-
-## 硬规则
-
-- 知识晋级必须有证据，不能由 AI 推理直接变成核心事实。
-- 中文优先项目的用户可见语义不得被英文默认模版污染。
-- 设计文档只能承载已验证事实，不能承载施工日志或未验证假设。
-- 多语言策略必须显式声明，不能用日志或 stderr 替代用户反馈。

package/templates/shared//347/237/245/350/257/206/346/263/250/345/205/245/350/276/271/347/225/214.md

@@ -1,47 +0,0 @@
----
-id: ka-hard-rule-知识注入边界规则
-kind: guidance
-title: 知识注入边界
-sync_policy: copy_to_project
-status: retired
-triggers:
-  - 知识注入边界规则
-extra:
-  name: knowledge-injection-boundary
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
----
-
-# 知识注入边界规则
-
-## 核心原则
-
-知识注入必须经过三道门过滤: 状态门、路由门、预算门。未经审核的知识不可进入 prompt。
-
-## 三道门
-
-1. **状态门**: draft/quarantine/deprecated 知识被过滤，不进入 prompt
-2. **路由门**: 知识类型必须匹配当前路由，防止错误注入
-3. **预算门**: budget 不足时优先保留 required，supporting 可被裁剪
-
-## 规则
-
-1. consumption_mode=required 资产缺失时必须报错，不可静默降级
-2. pending_review 知识只能进入 advisory_only，不可进入 injected
-3. 所有注入结果必须生成 KnowledgeInjectionReport
-4. route 不匹配时跳过模版注入，不可强行注入
-
-## 验收标准
-
-- [ ] draft/quarantine 知识不出现在 injected 列表中
-- [ ] required 资产缺失时产生 missing_required_knowledge finding
-- [ ] KnowledgeInjectionReport 包含完整字段
-- [ ] budget 不足时 required 优先于 supporting

package/templates/shared//347/273/206/350/212/202/347/272/252/345/276/213.md

@@ -1,54 +0,0 @@
----
-id: ka-hard-rule-细节纪律规则
-kind: guidance
-title: 细节纪律
-owner_mechanism: mc-detail-discipline
-sync_policy: copy_to_project
-status: active
-extra:
-  name: detail-discipline
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
-triggers:
-  - 方案细节
-  - 实施细节
-  - 验收细节
-  - 边界约束
-  - 失败路径
-  - 降级路径
-  - 备份回滚
----
-
-# 细节纪律规则
-
-## hard_rules
-
-- 方案细节、实施细节、验收细节、边界例外、反回归检查五个维度必须逐一检查，不得遗漏。
-- 细节必须包含可验证字段或清单（verification checklist），不得只有口号式描述。
-- 阻塞性检查（blocking check）必须接入交付 gate，不得游离在交付流程之外。
-- 设计有方向无边界 → hard fail，必须补齐边界约束。
-- 实施只有快乐路径 → hard fail，必须覆盖失败路径和降级路径。
-- 覆盖/迁移操作无备份回滚 → hard fail。
-
-## not_done_if_missing
-
-- 设计有方向无边界 → hard fail。
-- 实施只有快乐路径 → hard fail。
-- 覆盖/迁移无备份回滚 → hard fail。
-- blocking 检查未接入交付 gate → hard fail。
-- 细节维度缺失（5 个维度任缺 1 个）→ hard fail。
-
-## verification_evidence
-
-- `DetailDisciplineCheck` 包含 dimensions 覆盖报告（方案细节/实施细节/验收细节/边界例外/反回归）。
-- `performDetailCheck()` 返回各维度 pass/fail 状态。
-- `checkDetailGateIntegration()` 验证 blocking 检查已接入交付 gate。
-- `diagnostic_codes`: missing-dimension, gate-not-integrated, no-verification-field。

package/templates/shared//350/204/221/346/232/264/344/270/216/346/226/271/346/241/210/346/216/242/347/264/242.md

@@ -1,51 +0,0 @@
----
-id: ka-hard-rule-脑暴与方案探索规则
-kind: guidance
-title: 脑暴与方案探索
-owner_mechanism: mc-brainstorm-contract
-sync_policy: copy_to_project
-status: active
-extra:
-  name: brainstorm-exploration
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
-triggers:
-  - 脑暴
-  - 方案探索
-  - 候选方案
-  - 方案对比
-  - 不确定
-  - 多方案
----
-
-# 脑暴与方案探索规则
-
-## hard_rules
-
-- 不确定项不能只报告，必须给出至少 2 个候选方案并附推荐理由后进入用户确认闭环。
-- 脑暴阶段必须区分四种状态：brainstorm（探索中）→ proposal（有候选）→ decision（选定方案）→ confirmed_decision（用户确认）。
-- 高影响变更不得只有单一无解释路径，必须经过多选项探索。
-- 脑暴推荐不得绕过决策主权机制（mc-decision-sovereignty），推荐结果必须进入 decision 状态确认。
-- 脑暴阶段不得自动执行任何方案，必须等 confirmed_decision 状态。
-
-## not_done_if_missing
-
-- 高影响变更只有单一无解释路径 → hard fail。
-- 脑暴无候选方案直接跳过 → hard fail。
-- 脑暴推荐绕过人工门禁 → hard fail。
-- 不确定项只报告不收敛 → hard fail。
-
-## verification_evidence
-
-- `BrainstormSession` 包含 options 数组（至少 2 项）、recommendation、reasoning 字段。
-- `validateBrainstormSession()` 检查候选数量和收敛状态。
-- `canBrainstormAutoExecute()` 始终返回 false（脑暴不可自动执行）。
-- `diagnostic_codes`: empty-session, auto-execute-blocked, single-option-no-explanation。

package/templates/shared//350/256/241/345/210/222/345/211/215/347/275/256/351/227/250.md

@@ -1,47 +0,0 @@
----
-id: ka-hard-rule-plan-proposal-gate
-kind: guidance
-title: 计划前置门
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 代码修改
-  - 文件编辑
-  - 架构设计
-  - 迁移
-  - 删除
-  - 高风险操作
-  - code_change
-  - file_edit
-  - migration
-  - delete
-extra:
-  name: plan-proposal-first-gate
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-plan-proposal-gate
----
-
-## 计划前置门规则
-
-### 核心原则
-先说明计划，再执行动作。任务越复杂、风险越高，计划越完整。
-
-### 执行前必须
-1. 给出与任务风险匹配的计划或方案
-2. 高风险动作必须用户确认
-3. 计划必须记录验证方式和风险
-
-### 禁止
-- 无计划直接写文件、改代码、构建、Docker、迁移、发布
-- none_with_reason 用于写入或高风险任务
-- 执行动作超出已确认计划 scope
-- review 上下文擅自修复

package/templates/shared//350/256/276/350/256/241/344/272/247/347/211/251/345/214/205.md

@@ -1,58 +0,0 @@
----
-id: ka-rule-design-artifact-pack
-kind: guidance
-title: 设计产物包
-owner_mechanism: mc-design-artifact-pack
-sync_policy: copy_to_project
-status: active
-extra:
-  name: design-artifact-pack
-  lifecycle_status: active
-  scope:
-    - '*'
-  products:
-    - '*'
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
----
-
-# 设计产物包规则
-
-## 权威资产
-
-- 决策和确认以 `00-架构决策记录.md` 为准。
-- 总体架构以 `01-架构设计文档.md` 为准。
-- 详细设计的必需承载是 `design/01-数据库设计文档.md` 和 `design/02-API接口规格文档.md`；`design/03-详细设计文档.md` 仅在模块逻辑复杂度高、需要补充流程图或状态机描述时使用，不得被门禁强制要求。
-- 数据库物理结构以真实 SQL/migration 为准，`design/01-数据库设计文档.md` 解释和追踪。
-- API 路径和字段 schema 以 `docs/api/openapi.yaml` 为准，`design/02-API接口规格文档.md` 补充业务语义。
-- 开发切片以 `architecture/02-开发切片计划.md` 为准，作为全项目切片索引承载 `PHASE-*`、`SLICE-*`、状态、依赖和验收顺序；旧 `architecture/04-第一阶段开发切片计划.md` 只能作为迁移提示，不得作为新项目标准输出，也不得单独作为设计产物包通过依据。
-- 需求、原型、架构、详细设计、切片、实现和验收之间的身份关系以各产物正文中的 ID 互相引用为准（REQ-*、PROTO-*、ARCH-*、DD-*、SLICE-*、AC-* 在对应产物中声明并交叉引用）。
-- `audits/01-设计一致性验收报告.md` 只记录真实验证结果。
-
-## 生命周期输入输出
-
-| 节点 | 必需输入 | 必需输出 | 进入下一节点的硬门禁 |
-| --- | --- | --- | --- |
-| 需求输入 | 用户需求材料 | `REQ-*` 与需求文档 | 需求已分配 REQ-* 编号 |
-| 原型提取 | 原型材料 | `PROTO-*` 与原型说明 | 原型已分配 PROTO-* 编号 |
-| 架构设计 | `REQ-*`、`PROTO-*` | `00-架构决策记录.md`、`01-架构设计文档.md`、`ARCH-*` | 架构引用需求或原型，决策已确认 |
-| 详细设计 | `ARCH-*` | `design/01-数据库设计文档.md`、`design/02-API接口规格文档.md`、`DD-T*`、`DD-A*`、OpenAPI、SQL/migration | DB/API 设计引用架构，OpenAPI 和 SQL 权威资产存在 |
-| 切片规划 | `DD-*` 或 `ARCH-*` | `architecture/02-开发切片计划.md`、`PHASE-*`、`SLICE-*`、`AC-*` | 切片绑定阶段、设计来源和验收 ID |
-| 实现 | 切片计划 | 真实 `changed_files` | 任务绑定 `SLICE-*`、`DD-*`、`AC-*` |
-| 测试 | 真实 `changed_files` 与验收 ID | 真实命令执行结果 | 不能把验证计划当验证结果，验证必须覆盖变更 |
-| 验收/交付 | 测试结果和设计产物包 | `audits/01-设计一致性验收报告.md` 与交付摘要 | hard_fail 清零并保留消费 trace |
-
-## 硬底线
-
-- 每个 endpoint 必须具备请求和响应字段级说明，JSON 示例不能替代字段表。
-- SQL、OpenAPI、架构、数据库和 API 文档出现关键漂移时必须阻断。
-- 旧文档在新标准下必须先审计；未经确认和复验不得继续作为编码依据。
-- 升级必须默认 dry-run，确认写入时归档原文件和 hash。
-- DAP-01: 条件产物（数据库变更方案/接口对接方案）须明确标注"有"/"无"
-- DAP-02: 每个产物独立验证通过后才能进入下一个，禁止全量生成后统一验证
-- DAP-03: 子产物引用必须在主产物中有对应章节
-- DAP-04: 每个产物 frontmatter 须有 version 字段，主产物更新时子产物检查是否需要同步
-- DAP-05: "无"的条件产物须在主产物中记录判断依据

package/templates/shared//350/257/255/344/271/211/350/257/201/346/215/256.md

@@ -1,55 +0,0 @@
----
-id: ka-pattern-semantic_evidence
-kind: knowledge
-title: 语义证据
-sync_policy: internal
-status: active
-extra:
-  name: semantic_evidence
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 需求点（requirement_points）必须与代码变更关联，形成可追踪的证据链
-- computeSemanticEvidence 计算每个需求点的覆盖状态：covered / partial / uncovered
-- buildDeliveryEvidenceChain 构建交付证据链，包含需求覆盖 + 变更摘要 + 验证结果
-- 证据链使用 SHA256 hash chain 保证不可篡改
-- 未覆盖需求点生成 advisory 警告，不阻断交付
-
-## 验收项
-
-- [AC-01] 所有需求点都有覆盖状态
-- [AC-02] 证据链 hash 校验通过
-- [AC-03] uncovered 需求点产生 advisory
-- [AC-04] 证据链可验证完整性
-
-## 何时使用
-
-advisory: 需求覆盖是质量建议，uncovered 不阻断交付
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- 语义证据计算测试通过
-- 证据链完整性测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//350/267/250/345/271/263/345/217/260/350/267/257/345/276/204/345/256/211/345/205/250.md

@@ -1,41 +0,0 @@
----
-id: ka-hard-rule-跨平台路径安全规则
-kind: guidance
-title: 跨平台路径安全
-owner_mechanism: mc-platform-compatibility
-sync_policy: copy_to_project
-status: active
-extra:
-  name: cross-platform-path-safety
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
-triggers:
-  - 跨平台
-  - 路径安全
-  - 文件路径
-  - 路径处理
-  - 符号链接
-  - 文件系统
----
-
-# 跨平台路径安全规则
-
-## 硬规则
-
-1. **路径必须规范化** — 使用 normalizePathRef 消除平台差异
-2. **路径逃逸必须检测** — 符号链接、../ 等不可逃出 scope 边界
-3. **大小写冲突必须处理** — macOS 不敏感文件系统需特殊处理
-
-## 检查项
-
-- [ ] 路径经过规范化处理
-- [ ] scope 边界未突破
-- [ ] 符号链接指向合法

package/templates/shared//350/276/223/345/205/245/346/235/220/346/226/231/345/245/221/347/272/246.md

@@ -1,50 +0,0 @@
----
-id: ka-hard-rule-输入材料契约规则
-kind: guidance
-title: 输入材料契约
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 输入材料契约规则
-extra:
-  name: input-material-contract
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-input-material-contract
----
-
-# 输入材料契约规则
-
-## 核心约束
-
-1. **外部材料边界**: 所有外部输入（文件引用、URL、粘贴内容）必须经过 Input Material Contract 校验
-   - 每个外部材料必须有明确的来源标记（local_file | url | clipboard | user_provided）
-   - 来源标记影响后续的权限和隐私检查
-
-2. **路径安全**: 外部文件引用必须满足
-   - 路径必须在项目根目录内（除非显式白名单）
-   - 符号链接解析后仍需通过安全检查
-   - 不允许读取 .env、credentials、.ssh 等敏感目录
-
-3. **摄取边界**: 材料进入 SoloForge 管道时
-   - 必须记录摄取证据（ingestion_evidence）
-   - 必须通过隐私门禁（privacy_gate）
-   - 拒绝的材料必须给出明确原因
-
-4. **权限传播**: 输入材料的权限标签决定后续操作的 mutation_allowed
-   - read-only 材料不得产生 write 操作
-   - untrusted 材料标记为 advisory，不阻断但记录
-
-## 验证要点
-
-- 所有 input_materials 有 source_type 标记
-- 外部路径不超出项目根目录
-- 敏感文件被隐私门禁拦截

package/templates/shared//350/277/220/350/241/214/345/256/211/345/205/250/345/214/205.md

@@ -1,58 +0,0 @@
----
-id: ka-pattern-runtime_safety
-kind: knowledge
-title: 运行安全包
-sync_policy: internal
-status: active
-extra:
-  name: runtime_safety
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 证据 hash chain: SHA256 链式连接，每块包含 prev_hash + chain_hash + data_hash
-- verifyEvidenceChain 从 payload 重算 data_hash，再重算 chain_hash
-- 命令副作用分级: read_only / mutating / destructive
-- destructive 命令（rm -rf、git push --force、DROP TABLE）需人工确认
-- 供应链治理: 验证依赖有 lockfile 和完整性 hash
-- 迁移回滚契约: schema 变更必须有回滚路径
-
-## 验收项
-
-- [AC-01] 证据链构建和验证一致
-- [AC-02] payload 篡改被检测
-- [AC-03] destructive 命令标记需人工确认
-- [AC-04] 无 lockfile 依赖产生 advisory
-- [AC-05] 迁移无回滚命令产生 advisory
-
-## 何时使用
-
-advisory: 只有 destructive 命令需人工确认，其余为 advisory 警告
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- 证据链构建/验证测试通过
-- 命令分级测试通过
-- 供应链检查测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//351/200/232/347/224/250/345/206/263/347/255/226/347/240/224/350/256/250.md

@@ -1,62 +0,0 @@
----
-id: ka-hard-rule-通用决策研讨规则
-kind: guidance
-title: 通用决策研讨
-owner_mechanism: mc-decision-workshop
-sync_policy: internal
-status: active
-extra:
-  name: general-decision-workshop
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
-triggers:
-  - 架构设计
-  - 技术选型
-  - 数据迁移
-  - 安全策略
-  - 部署方案
-  - 重构方案
-  - 迁移方案
-  - 第三方集成
-  - 决策研讨
-  - 方案评审
----
-
-# 通用决策研讨规则
-
-## 触发条件
-
-以下任务类型必须在执行前完成决策研讨与用户确认：
-
-- 架构设计（六域决策子包）
-- 技术选型
-- 数据迁移
-- 安全策略变更
-- 部署基础设施变更
-- 产品范围变更
-- 重构/迁移方案
-- 第三方集成
-
-## 决策域记录要求
-
-每个决策域必须包含：
-
-1. **事实与约束** — 客观现状、技术限制、业务约束
-2. **候选方案** — 至少两个可行方案，含收益与风险
-3. **推荐方案** — 附推荐理由
-4. **用户确认引用** — 必须有明确的用户确认记录
-
-## 门禁规则
-
-- 所有必须域未确认时，阻断正式生成/执行
-- 现有系统变更必须提供现状分析和差距分析证据
-- 标记 `not_applicable` 的域必须提供不适用理由
-- 标记 `deferred` 的域必须列出延期影响

package/templates/shared//351/200/232/347/224/250/346/234/272/346/242/260/346/235/241/346/254/276.md

@@ -1,47 +0,0 @@
----
-id: ka-domain_knowledge-mechanical-clauses
-kind: knowledge
-title: 通用机械条款
-sync_policy: copy_to_project
-status: active
-extra:
-  name: mechanical-clauses
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-domain-knowledge
----
-
-## 业务规则
-1. 幂等：同一请求多次执行结果必须一致，适用于 PUT/DELETE 接口、支付回调、消息消费等场景
-2. 乐观锁：基于版本号（version 字段）的并发控制，更新时必须校验版本号，冲突时抛出业务异常而非静默覆盖
-3. 软删除：标记删除（is_deleted / deleted_at）而非物理删除，适用于有审计要求或可恢复需求的数据
-4. 硬删除：物理移除数据，仅适用于临时数据、可重建数据、日志明细等无审计要求的场景
-5. 级联：主记录变更自动传递到子记录（如主表状态变更联动子表），必须明确级联范围，禁止无限制级联
-6. 可恢复删除：删除后可在一定窗口内恢复（如回收站机制），窗口期到期后自动物理删除或归档
-7. 补偿：正向操作失败时执行反向操作，用于分布式事务 saga 模式，补偿操作本身也必须幂等
-
-## 约束条件
-- 需求中出现上述条款时必须明确其在本项目中的具体实现语义，不得假设"大家都懂"
-- 机械条款的选择属于裁决（团队决策），不属于需求事实，必须在需求澄清阶段确认
-- 幂等字段必须建立唯一索引（如支付流水号、消息 ID），依赖数据库约束保证幂等性
-- 乐观锁 version 字段禁止在 DTO 中暴露给前端，仅服务端内部使用
-- 软删除的查询必须全局过滤已删除记录（MyBatis 拦截器或全局 scope），禁止每条 SQL 手动加条件
-- 级联删除必须在 Entity 层配置（如 @OneToMany(cascade = CascadeType.REMOVE)），禁止在 Service 层手动循环删除
-
-## 例外情况
-- 日志明细、临时文件等可重建数据允许硬删除
-- 数据迁移期间可临时绕过乐观锁，但必须记录变更并事后审计
-- 性能敏感的批量操作（如定时任务清理）可绕过软删除全局过滤，但须显式声明
-
-## 关联模式
-- [[concurrency-control]] 并发控制实现模式
-- [[transaction-pattern]] 事务与补偿模式
-- crud-operation