soloforge 1.1.38 → 1.1.40

package/templates/artifacts/shared//346/212/200/346/234/257/351/200/211/345/236/213/351/252/214/346/224/266/346/270/205/345/215/225.md

@@ -1,35 +1,24 @@
 ---
 name: tech-selection
-when: '技术选型, 选型, 方案选择, 架构选型, 技术方案, 方案对比, sf_explore'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-artifact_template-tech-selection
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-decision-workshop
 authority: supporting
-primary_triggers:
-  - 技术选型
-  - 选型
-  - 方案选择
-  - 架构选型
-  - 技术方案
-  - 方案对比
-  - sf_explore
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
 stages: ["架构设计"]
+triggers: ["技术选型","选型","方案选择","架构选型","技术方案","方案对比","sf_explore"]
+requires_context: []
 ---
 
 ## 验收项

package/templates/artifacts/shared//346/216/245/345/217/243/345/257/271/346/216/245/346/226/271/346/241/210/346/250/241/347/211/210.md

@@ -1,31 +1,27 @@
 ---
 name: api-integration-plan
-when: '接口对接方案, 第三方对接, API集成方案'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-artifact_template-接口对接方案模版
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-generic-artifact
 authority: supporting
-primary_triggers:
-  - 接口对接方案
-  - 第三方对接
-  - API集成方案
 priority: P2
-specificity: 3
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
+version: 1.3.0
+last_reviewed: '2026-06-04'
+consumes:
+  - docs/architecture/01-架构设计文档.md
+  - docs/architecture/03-API接口规格文档.md
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
-stages: ["架构设计", "详细设计"]
+stages: ["架构设计", "详细设计", "联调验证"]
+triggers: ["接口对接方案","第三方对接","API集成方案"]
+requires_context: []
+companion_gates: ["gate-架构设计.yaml"]
 ---
 
 # 接口对接方案
@@ -34,11 +30,15 @@ stages: ["架构设计", "详细设计"]
 - 服务名称：
 - 服务类型（支付/通知/数据/认证）：
 - SLA 可用性：
-- 沙箱环境地址：
+- 环境地址：
+  - 沙箱：
+  - 预发：
+  - 生产：
 
 ## 2. 认证方式
 - 认证类型（API Key / OAuth / Token / 签名）：
 - 密钥管理方案（加密存储/环境变量/密钥轮换）：
+- 密钥轮换周期：
 
 ## 3. 接口清单
 | 接口 | 方法 | 路径 | 用途 | 调用频率 |
@@ -51,17 +51,51 @@ stages: ["架构设计", "详细设计"]
 | | | | | |
 
 ## 5. 错误码映射
-| 对方错误码 | 含义 | 我方错误码 | 用户提示 | 处理策略 |
-|-----------|------|-----------|---------|---------|
-| | | | | |
+| 对方错误码 | 含义 | 错误分类 | 我方错误码 | 用户提示 | 处理策略 |
+|-----------|------|---------|-----------|---------|---------|
+
+> 错误分类：transient（可重试：429/502/503/504/网络超时）/ permanent（不可重试：400/401/403/404/业务错误）
 
 ## 6. 容错策略
-- 超时时间：
-- 重试次数 + 退避策略：
-- 熔断阈值：
+
+### 6.1 超时与重试
+| 参数 | 值 | 说明 |
+|------|---|------|
+| 连接超时 | | |
+| 请求超时 | | |
+| 最大重试次数 | | |
+| 退避策略 | | |
+| 重试抖动 | | |
+
+### 6.2 熔断
+| 参数 | 值 | 说明 |
+|------|---|------|
+| 失败率阈值 | | |
+| 熔断等待时间 | | |
+| 半开探测次数 | | |
+
+### 6.3 降级与限流
 - 降级方案：
 - 限流/配额：
 
 ## 7. Mock 方案
 - 本地 Mock 方式：
 - 沙箱对接计划：
+
+## 8. 监控与告警
+| 监控指标 | 告警阈值 | 通知方式 |
+|---------|---------|---------|
+| 请求成功率 | | |
+| 响应延迟 p99 | | |
+| 熔断状态变化 | | |
+| 配额使用率 | | |
+
+## 9. 沙箱验证证据（联调阶段填写）
+
+| 接口 | 沙箱环境 | 验证结果 | 响应示例（脱敏） | 差异记录 |
+|------|---------|---------|----------------|---------|
+| | | 通过/失败 | | 与文档的差异 |
+
+## 10. Webhook/回调（如适用）
+| 事件 | 回调 URL | 验签方式 | 重试策略 |
+|------|---------|---------|---------|

package/templates/artifacts/shared//346/225/205/351/232/234/345/244/215/347/233/230/346/250/241/347/211/210.md

@@ -1,33 +1,24 @@
 ---
 name: incident-postmortem
-when: '故障复盘, 事故复盘, postmortem, P0复盘, 线上事故复盘'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-artifact_template-故障复盘模版
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-generic-artifact
 authority: supporting
-primary_triggers:
-  - 故障复盘
-  - 事故复盘
-  - postmortem
-  - P0复盘
-  - 线上事故复盘
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
 stages: ["联调验证"]
+triggers: ["故障复盘","事故复盘","postmortem","P0复盘","线上事故复盘"]
+requires_context: []
 ---
 
 # 故障复盘报告

package/templates/artifacts/shared//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/346/226/271/346/241/210/346/250/241/347/211/210.md

@@ -1,31 +1,26 @@
 ---
 name: database-change-plan
-when: '数据库变更方案, DDL变更, 表结构变更方案, migration方案'
 scope:
   - backend
 products:
   - '*'
 id: ka-artifact_template-数据库变更方案模版
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-generic-artifact
 authority: supporting
-primary_triggers:
-  - 数据库变更方案
-  - DDL变更
-  - 表结构变更方案
-  - migration方案
 priority: P2
-specificity: 3
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
+version: 1.2.0
+last_reviewed: '2026-06-04'
+consumes:
+  - docs/architecture/01-架构设计文档.md
+  - docs/architecture/02-数据库设计文档.md
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
 stages: ["架构设计", "详细设计"]
+triggers: ["数据库变更方案","DDL变更","表结构变更方案","migration方案"]
+requires_context: []
+companion_gates: ["gate-架构设计.yaml"]
 ---
 
 # 数据库变更方案
@@ -34,34 +29,51 @@ stages: ["架构设计", "详细设计"]
 - 变更类型：加列 / 改列 / 删列 / 加索引 / 新建表 / 数据迁移
 - 涉及表：
 - 变更原因：
+- 变更风险等级：
+- 零停机策略：expand-contract / dual-write / shadow table / 直接变更
+- 大表迁移工具（>50万行时）：
 
 ## 2. 变更详情
-### 正向 DDL
-```sql
--- 正向 migration
-```
 
-### 回滚 DDL
-```sql
--- 回滚 migration
-```
+### 2.1 正向 DDL
+> 引用路径：`db/migrations/YYYYMMDDHHMMSS-描述.sql`
+
+### 2.2 回滚 DDL
+> 引用路径：`db/migrations/YYYYMMDDHHMMSS-描述-rollback.sql`
+
+### 2.3 数据映射（列重命名/类型变更/表拆分时）
+| 源表.源列 | 源类型 | 目标表.目标列 | 目标类型 | 转换规则 |
+|-----------|--------|-------------|---------|---------|
 
 ## 3. 兼容性分析
-| 层级 | 影响 | 兼容策略 |
-|------|------|---------|
+| 层级 | 影响说明 | 兼容策略 |
+|------|---------|---------|
 | 数据库 | | |
-| 接口契约 | | |
+| ORM/查询层 | | |
+| API 契约 | | |
 | 前端展示 | | |
-| 导出逻辑 | | |
+| 导出/报表 | | |
+| ETL/CDC 管道 | | |
+| 定时任务/批处理 | | |
+| 向后兼容性 | | |
 
 ## 4. 数据迁移方案（如需要）
 - 数据量评估：
-- 分批策略（每批条数/间隔）：
+- 分批策略：
 - 预计耗时：
-- 数据校验方式：
+- 数据校验方式：行数 / 聚合 / 校验和 / 抽样
+- PII 敏感字段处理：
 
 ## 5. 执行计划
-- 大表评估（>100万行）：
-- 执行时间窗口（低峰期）：
-- 备份方案：
-- 监控告警：
+
+### 5.1 时间线
+| 阶段 | 时间点 | 操作 |
+|------|-------|------|
+
+### 5.2 回滚触发条件
+| 指标 | 阈值 | 动作 |
+|------|------|------|
+
+### 5.3 监控指标
+| 指标 | 告警阈值 |
+|------|---------|

package/templates/artifacts/shared//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/351/252/214/346/224/266/346/270/205/345/215/225.md

@@ -1,36 +1,23 @@
 ---
 name: database-change
-when: '数据库变更, 表结构修改, migration, DDL, 加字段, 建表, 索引, 数据迁移, 表结构变更'
 scope:
   - backend
 products:
   - '*'
 id: ka-artifact_template-database-change
-asset_kind: acceptance_template
 lifecycle_status: active
 owner_mechanism_id: mc-artifact-contract
 authority: supporting
-primary_triggers:
-  - 数据库变更
-  - 表结构修改
-  - migration
-  - DDL
-  - 加字段
-  - 建表
-  - 索引
-  - 数据迁移
-  - 表结构变更
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits:
   - acceptance_report
-secondary_triggers: []
-negative_triggers: []
 type: acceptance_template
 stages: ["联调验证"]
+triggers: ["数据库变更","表结构修改","migration","DDL","加字段","建表","索引","数据迁移","表结构变更"]
+requires_context: []
 ---
 
 ## 验收项

package/templates/artifacts/shared//346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/346/226/207/346/241/243/346/250/241/347/211/210.md

@@ -1,19 +1,15 @@
 ---
 name: database-design
 id: ka-artifact_template-database-design
-asset_kind: acceptance_template
 lifecycle_status: active
 authority: supporting
 scope:
   - backend
 products:
   - '*'
-primary_triggers:
-  - 数据库设计文档
 priority: P1
-specificity: 4
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 owner_mechanism_id: mc-design-artifact-pack
 consumes:
   - docs/architecture/00-架构决策记录.md
@@ -26,60 +22,143 @@ required_evidence:
   - executable_sql_or_migration
   - api_database_traceability
 type: acceptance_template
-artifact_schema:
-  kind: design_doc
-  required_sections:
-    - 目标数据库与权威SQL
-    - 实体与关系
-    - 表字段与敏感级别
-    - 约束索引与查询场景
-    - 租户安全审计与数据生命周期
-    - Migration回滚备份恢复
-    - API/DTO至字段追踪矩阵
-    - 真实验证证据与未决项
-  required_tables:
-    - 目标数据库表
-    - 表字段与敏感级别表
-  required_fields:
-    表字段与敏感级别表:
-      - 表
-      - 字段
-      - 类型
-      - 可空
-      - 默认值
-      - 业务含义
-      - 敏感级别
-      - 生命周期
-  required_artifacts:
-    - SQL/migration 文件
-  forbidden_gaps:
-    - 缺少字段表的表定义
-stages: ["联调验证"]
+stages: ["详细设计"]
+requires_context: [file_impact, reference_trace]
+companion_gates:
+  - gate-详细设计.yaml
+companion_rules:
+  - 详细设计审查规则.md:review
+  - 一致性校验规则.md:check
+  - 第一性原理推理规则.md:review
+triggers: ['数据库', 'DB设计', '表结构', '数据模型', 'Schema', 'DDL']
 ---
 
 # 数据库设计文档
 
-## 1. 目标数据库与权威 SQL
+> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
+
+## 1. 目标数据库与权威 SQL [Always — 必填]
 
 | 项目 | 内容 |
 |------|------|
 | 数据库及版本 | |
 | SQL/migration 权威路径 | |
 | 执行验证命令及结果 | |
+| ORM/框架（如有） | |
+| 字符集与排序规则 | |
+| 上游架构文档路径 | |
+| 上游需求文档路径 | |
+
+## 2. 实体与关系 [Always — 必填，P0 最关键章节]
+
+### 2.1 实体列表
+| 实体名 | 中文名 | 业务含义 | 来源需求/架构章节 | 估计记录量级 |
+|--------|--------|----------|-------------------|-------------|
+<!-- 按实际填写 -->
 
-## 2. 实体与关系
+### 2.2 关系定义
+| 关系编号 | 父实体 | 子实体 | 关系类型 | 基数 | 外键字段 | 级联行为 | 说明 |
+|----------|--------|--------|----------|------|----------|----------|------|
+<!-- 按实际填写 -->
+关系类型枚举：关联 / 组合 / 聚合
+基数枚举：1:1 / 1:N / M:N
+
+### 2.3 ER 图
+> 推荐 Mermaid erDiagram 语法
 
 ## 3. 表字段与敏感级别
 
 | 表 | 字段 | 类型 | 可空 | 默认值 | 业务含义 | 敏感级别 | 生命周期 |
 |----|------|------|------|--------|----------|----------|----------|
 
-## 4. 约束、索引与查询场景
+## 4. 约束、索引与查询场景 [Always — 必填]
+
+### 4.1 约束定义
+| 表名 | 约束名 | 约束类型 | 约束字段 | 约束条件 | 错误提示 |
+|------|--------|----------|----------|----------|----------|
+<!-- 按实际填写 -->
+约束类型枚举：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.1 租户隔离策略
+| 表名 | 隔离方式 | 租户字段 | 隔离级别 | 说明 |
+|------|----------|----------|----------|------|
+<!-- 按实际填写 -->
+
+### 5.2 敏感数据保护
+| 字段路径 | 敏感级别 | 加密方式 | 脱敏规则 | 访问控制 | 合规要求 |
+|----------|----------|----------|----------|----------|----------|
+<!-- 按实际填写 -->
+
+### 5.3 审计字段
+| 表名 | 创建时间字段 | 更新时间字段 | 创建人字段 | 更新人字段 | 软删除字段 |
+|------|-------------|-------------|-----------|-----------|-----------|
+<!-- 按实际填写 -->
+
+### 5.4 数据生命周期
+| 数据类型 | 保留期限 | 归档策略 | 清理策略 | 合规依据 |
+|----------|----------|----------|----------|----------|
+<!-- 按实际填写 -->
+
+## 6. Migration、回滚、备份恢复 [Always — 必填]
+
+### 6.1 Migration 脚本清单
+| 序号 | 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 — 必填]
+
+| API Endpoint | HTTP Method | 请求字段 | 映射表.字段 | 响应字段 | 映射表.字段 | DTO 类名 |
+|--------------|-------------|----------|------------|----------|------------|----------|
+<!-- 按实际填写 -->
+
+> 每个 API 字段必须精确追踪到数据库表.字段，无映射的字段标注"计算字段"/"外部服务"/"缓存"。
+
+## 8. 真实验证证据与未决项 [Always — 必填]
 
-## 5. 租户、安全、审计与数据生命周期
+### 8.1 SQL 执行证据
+| 验证项 | 执行 SQL | 预期结果 | 实际结果 | 状态 |
+|--------|----------|----------|----------|------|
+<!-- 按实际填写 -->
 
-## 6. Migration、回滚、备份恢复
+### 8.2 范式自检
+| 表名 | 函数依赖 | 当前范式 | 是否满足 3NF | 修正建议 |
+|------|----------|----------|-------------|----------|
+<!-- 按实际填写 -->
 
-## 7. API/DTO 至字段追踪矩阵
+### 8.3 追踪矩阵覆盖自检
+| 检查项 | 覆盖状态 | 缺失说明 |
+|--------|----------|----------|
+| 所有 API 字段已追踪到数据库字段 | <!-- 是/否 --> | <!-- 按实际填写 --> |
+| 所有数据库字段已被至少一个 API 引用 | <!-- 是/否 --> | <!-- 按实际填写 --> |
+| 所有外键关系已在 Ch2 定义 | <!-- 是/否 --> | <!-- 按实际填写 --> |
+| 所有索引已在 Ch4 定义且覆盖高频查询 | <!-- 是/否 --> | <!-- 按实际填写 --> |
 
-## 8. 真实验证证据与未决项
+### 8.4 未决项
+| 编号 | 未决项 | 不确定分级 | 候选方案 | 状态 |
+|------|--------|-----------|----------|------|
+<!-- 按实际填写 -->