soloforge 1.1.46 → 1.1.48

package/templates/design//346/216/245/345/217/243/345/257/271/346/216/245/346/226/271/346/241/210.md

@@ -1,97 +0,0 @@
----
-id: ka-artifact_template-接口对接方案模版
-kind: artifact
-title: 接口对接方案
-sync_policy: copy_to_project
-status: active
-extra:
-  name: api-integration-plan
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.3.0
-  last_reviewed: '2026-06-04'
-  type: artifact
-  domain: design
-  stage: design
-  owner_mechanism: mc-generic-artifact
----
-
-# 接口对接方案
-
-## 1. 第三方服务概况
-- 服务名称：
-- 服务类型（支付/通知/数据/认证）：
-- SLA 可用性：
-- 环境地址：
-  - 沙箱：
-  - 预发：
-  - 生产：
-
-## 2. 认证方式
-- 认证类型（API Key / OAuth / Token / 签名）：
-- 密钥管理方案（加密存储/环境变量/密钥轮换）：
-- 密钥轮换周期：
-
-## 3. 接口清单
-| 接口 | 方法 | 路径 | 用途 | 调用频率 |
-|------|------|------|------|---------|
-| | | | | |
-
-## 4. 数据映射
-| 我方字段 | 我方类型 | 对方字段 | 对方类型 | 转换规则 |
-|---------|---------|---------|---------|---------|
-| | | | | |
-
-## 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/design//346/224/271/351/200/240/345/275/261/345/223/215/350/214/203/345/233/264/350/257/204/344/274/260.md

@@ -1,56 +0,0 @@
----
-id: 改造影响范围评估
-kind: artifact
-title: 改造影响范围评估
-sync_policy: copy_to_project
-status: active
-extra:
-  name: refactoring-impact-assessment
-  type: artifact
-  scope:
-    - '*'
-  domain: design
-  lifecycle_status: active
-  stage: design
-  owner_mechanism: mc-existing-system-artifact
----
-
-# 改造影响范围评估
-
-## 1. 影响范围
-
-### 1.1 代码影响
-| 模块 | 变更类型 | 影响评估 |
-|---|---|---|
-| <!-- 模块 --> | 新增/修改 | 高/中/低 |
-
-### 1.2 数据库影响
-| 表 | 变更类型 | 数据迁移需求 |
-|---|---|---|
-| <!-- 表 --> | 新增/修改 | 是/否 |
-
-### 1.3 接口影响
-| 接口 | 变更类型 | 向后兼容 |
-|---|---|---|
-| <!-- 接口 --> | 新增/修改/废弃 | 是/否 |
-
-## 2. 风险评估
-- 整体风险等级：高/中/低
-- 关键风险点：
-  - <!-- 风险描述 -->
-
-### 2.5 隐式不变量
-> 老系统中的"不可见约定"：未文档化的不变量、生产事件 workaround、伙伴系统假设。
-| # | 不变量描述 | 影响模块 | 破坏风险 | 验证方式 |
-|---|-----------|---------|---------|---------|
-
-## 3. 约束条件
-<!-- 影响评估作为详细设计的约束条件 -->
-
-### 3.5 分阶段验证计划（高风险项必须）
-| 风险项 | 验证阶段 | 验证方式 | 通过标准 | 回退策略 |
-|--------|---------|---------|---------|---------|
-| | 架构设计 | 依赖图分析 | 无未预期依赖 | 调整架构方案 |
-| | 详细设计 | 兼容性检查 | 向后兼容 | 修改接口设计 |
-| | 编码 | 新老逻辑比对 | 一致率 100% | 修复代码 |
-| | 联调 | 试运行熔断 | 错误率 <5% | 一键回滚 |

package/templates/design//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/346/226/271/346/241/210.md

@@ -1,75 +0,0 @@
----
-id: ka-artifact_template-数据库变更方案模版
-kind: artifact
-title: 数据库变更方案
-sync_policy: copy_to_project
-status: active
-extra:
-  name: database-change-plan
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  type: artifact
-  domain: design
-  stage: design
-  owner_mechanism: mc-generic-artifact
----
-
-# 数据库变更方案
-
-## 1. 变更概述
-- 变更类型：加列 / 改列 / 删列 / 加索引 / 新建表 / 数据迁移
-- 涉及表：
-- 变更原因：
-- 变更风险等级：
-- 零停机策略：expand-contract / dual-write / shadow table / 直接变更
-- 大表迁移工具（>50万行时）：
-
-## 2. 变更详情
-
-### 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. 执行计划
-
-### 5.1 时间线
-| 阶段 | 时间点 | 操作 |
-|------|-------|------|
-
-### 5.2 回滚触发条件
-| 指标 | 阈值 | 动作 |
-|------|------|------|
-
-### 5.3 监控指标
-| 指标 | 告警阈值 |
-|------|---------|

package/templates/design//346/225/260/346/215/256/350/241/200/347/274/230/345/233/276.md

@@ -1,49 +0,0 @@
----
-id: 数据血缘图
-kind: artifact
-title: 数据血缘图
-sync_policy: copy_to_project
-status: active
-extra:
-  name: data-lineage-diagram
-  type: artifact
-  scope:
-    - '*'
-  domain: design
-  lifecycle_status: active
-  stage: design
-  owner_mechanism: mc-existing-system-artifact
----
-
-# 全链路数据血缘图
-
-## 1. 概述
-<!-- 数据血缘图的整体说明 -->
-
-## 2. 接口入口
-<!-- 从外部调用的接口入口列表 -->
-
-## 3. 服务调用链
-
-### 3.1 <!-- 接口名称 -->
-<!-- 接口 → 服务A → 服务B → 数据库的完整映射 -->
-
-**调用链：**
-接口入口 → <!-- 服务 --> → <!-- 服务 --> → <!-- 数据库表 -->
-
-## 4. 数据库读写映射
-
-### 4.1 <!-- 表名 -->
-
-| 字段 | 读/写 | 来源接口 | 来源服务 |
-|---|---|---|---|
-| <!-- 字段名 --> | R/W | <!-- 接口 --> | <!-- 服务 --> |
-
-## 5. 覆盖验证
-
-- [ ] 所有受影响接口已在 §2 中列出
-- [ ] 所有服务调用链已追踪到数据库读写
-- [ ] 数据库读写映射覆盖所有受影响表
-- Evidence: 接口覆盖率 = 已覆盖接口数 / 受影响接口总数
-
-> 接口覆盖率须为 100%。受影响接口列表来源：阶段 1 产出增量边界界定文档 §3 受影响接口。

package/templates/design//346/227/240/351/232/234/347/242/215.md

@@ -1,49 +0,0 @@
----
-id: ka-pattern-accessibility
-kind: knowledge
-title: 无障碍
-sync_policy: copy_to_project
-status: active
-extra:
-  name: accessibility
-  scope:
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain:
-    - build
-    - design
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-frontend-pattern
----
-
-## 决策规则
-- 表单 input 必须关联 label（htmlFor/id 或 aria-labelledby），禁止无标签输入框
-- 按钮和链接必须有可识别文本或 aria-label，禁止纯图标按钮无文字说明
-- 页面必须支持键盘导航（Tab 序列、Enter/Space 触发），焦点顺序符合视觉逻辑
-- 动态内容更新必须使用 aria-live 区域通知屏幕阅读器
-- 颜色对比度必须满足 WCAG AA 标准（文本 4.5:1，大文本 3:1）
-- 图标按钮必须提供 aria-label 或 tooltip，图标作为装饰时使用 aria-hidden="true"
-- 错误提示必须通过 aria-describedby 关联到对应表单字段
-- 所有交互元素必须有可访问的名称（aria-label 或关联 label），屏幕阅读器可识别
-- 颜色对比度必须满足 WCAG 2.1 AA 标准（正文 ≥ 4.5:1，大文本 ≥ 3:1）
-- 所有功能必须支持键盘操作（Tab 导航 + Enter/Space 触发），不能仅依赖鼠标
-- 表单必须有明确的错误提示和关联（aria-describedby），不能只用颜色标识错误
-- 图片/图标必须有替代文本（alt 属性），装饰性图片使用 alt=""
-- 页面标题（title）和标题层级（h1-h6）必须语义正确，便于辅助导航
-
-## 验收项
-- [AC-01] 表单字段有关联 label
-- [AC-02] 按钮和链接有可识别文本
-- [AC-03] 页面支持键盘导航
-- [AC-04] 颜色对比度满足 WCAG AA
-- [AC-05] 交互元素有 aria-label
-- [AC-06] 颜色对比度符合 WCAG AA
-- [AC-07] 功能支持键盘操作
-- [AC-08] 表单错误有关联提示
-- [AC-09] 图片有替代文本

package/templates/design//346/236/266/346/236/204/345/206/263/347/255/226/350/256/260/345/275/225.md

@@ -1,53 +0,0 @@
----
-id: ka-artifact_template-adr
-kind: artifact
-title: 架构决策记录
-sync_policy: copy_to_project
-status: active
-extra:
-  name: adr-template
-  type: artifact
-  domain: design
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  stage: design
-  owner_mechanism: mc-generic-artifact
----
-
-# ADR（架构决策记录）
-
-> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
-
-## 决策标题
-<!-- 简短描述本次架构决策 -->
-
-## 背景
-<!-- 为什么需要做这个决策？当前的架构约束、业务需求、技术债务是什么？ -->
-
-## 选项
-
-### 选项 A: <!-- 选项名称 -->
-- **描述：** <!-- 简述方案 -->
-- **优点：**
-  -
-- **缺点：**
-  -
-
-### 选项 B: <!-- 选项名称 -->
-- **描述：** <!-- 简述方案 -->
-- **优点：**
-  -
-- **缺点：**
-  -
-
-## 结论
-<!-- 最终选择哪个选项 -->
-
-## 原因
-<!-- 为什么选择这个选项？权衡了哪些因素？ -->

package/templates/design//346/236/266/346/236/204/345/256/241/346/237/245.md

@@ -1,256 +0,0 @@
----
-id: ka-review-rule-架构审查规则
-kind: guidance
-title: 架构审查
-triggers:
-  - 架构
-  - 分层
-  - Controller
-  - Service
-  - Entity
-  - 事务
-sync_policy: copy_to_project
-status: active
-extra:
-  name: architecture-rules
-  type: constraint
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.3.0
-  last_reviewed: '2026-06-13'
-  domain:
-    - design
-    - verify
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-generic-review
----
-
-# 架构审查规则
-
-> 合并自：架构审查.md（代码扫描 ARC-01~09）+ 架构设计审查.md（文档审查 ARCH-R01~14）。统一为「代码扫描 + 文档审查」双区 review_rule。
->
-> **两个执行区**：
-> - **代码扫描区（ARC-0X）**：verify-gate 通过 regex_pattern_scan 扫 git diff 变更文件，命中=违规。单行匹配。
-> - **文档审查区（ARCH-R0X）**：design-gate 通过 document_structure 检查架构设计文档章节完整性；semantic 项 LLM 评判。
->
-> **档位**：A 档=regex_pattern_scan 单行可判｜B 档=external_command 成熟工具｜C 档=semantic LLM 评判。
-
-## 代码扫描区（ARC-01~09，verify-gate regex_pattern_scan 读取）
-
-## ARC-01: Controller 包含业务逻辑
-pattern: /@(?:RestController|Controller)[\s\S]*?public\s+\w+\s+\w+\s*\([^)]*\)\s*\{[\s\S]*?(?:if\s*\(.*[><=!]|for\s*\(|while\s*\().*(?:calculate|compute|validate)/
-severity: warning
-check_type: deterministic
-executor: regex_pattern_scan
-scope: backend
-description: Controller 层禁止包含业务逻辑（if/else 分支、计算、校验），必须下沉到 Service 层。
-  ⚠️ 已知局限：本 pattern 含跨行 [\s\S]*?，但 regex_pattern_scan 单行匹配，要求一行内同时出现注解+方法+业务逻辑几乎不可能 → 实际命中极低。深度检查须迁 B 档（checkstyle/ArchUnit 检测 Controller 方法复杂度）。
-evidence_required:
-  - "扫描结果：含业务逻辑的 Controller 文件路径+行号"
-
-## ARC-02: Entity 直接暴露给外部
-pattern: /(?:ResponseEntity|ResponseBody).*<.*Entity>/
-severity: warning
-check_type: deterministic
-executor: regex_pattern_scan
-scope: backend
-description: Controller 返回类型禁止使用 Entity，必须通过 DTO/VO 转换，防止结构耦合和敏感字段泄漏
-evidence_required:
-  - "扫描结果：直接暴露 Entity 的文件路径+行号"
-
-## ARC-03: 缺少 @Transactional 注解的写操作
-pattern: /public\s+\w+\s+(?:save|create|update|delete|insert|remove)\w*\s*\(/
-severity: error
-check_type: deterministic
-executor: regex_pattern_scan
-scope: backend
-description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)。
-  ⚠️ 已知局限：本 pattern 仅命中"写操作方法存在"，单行看不到上一行的 @Transactional 注解 → 无法真正判定"缺事务"，存在误报。深度检查须迁 B 档（checkstyle 检测写方法注解）。
-evidence_required:
-  - "扫描结果：缺少 @Transactional 的写操作文件路径+行号"
-
-## ARC-04: 未使用依赖注入直接 new 服务对象
-pattern: /new\s+\w*(?:Service|Repository|Mapper|Dao|Manager)\s*\(/
-severity: warning
-check_type: deterministic
-executor: regex_pattern_scan
-scope: backend
-description: 禁止手动 new Service/Repository 实例，必须通过构造器注入或 @Autowired
-evidence_required:
-  - "扫描结果：含 new 服务对象的文件路径+行号"
-
-## ARC-05: 前端组件文件超过 300 行应拆分
-severity: warning
-check_type: external_tool
-executor: external_command
-check_hint: 单个组件文件超过 300 行时应拆分为子组件，保持单一职责。单行 regex 无法统计文件行数，委托 eslint rule max-lines
-command_hint: npx eslint --rule '{"max-lines":["error",{"max":300,"skipBlankLines":true,"skipComments":true}]}'
-scope: frontend
-description: 单个组件文件超过 300 行时应拆分为子组件，保持单一职责。
-  ⚠️ 原 pattern 为空正则 //，编译为 new RegExp("","") 匹配任意行 → 挂载会全文件误命中。已移除 pattern，迁 B 档 external_command（eslint max-lines），由 verify-gate Phase 4 挂载。
-evidence_required:
-  - "eslint max-lines 报告（超 300 行的组件文件路径+行数）"
-
-## ARC-06: API 调用未封装到 service 层
-pattern: /(?:fetch|axios)\s*\.\s*(?:get|post|put|delete)\s*\(/
-severity: warning
-check_type: deterministic
-executor: regex_pattern_scan
-scope: frontend
-description: HTTP 调用禁止直接写在组件中，必须封装到独立的 service/API 层
-evidence_required:
-  - "扫描结果：含组件内 HTTP 调用的文件路径+行号"
-
-## ARC-07: 循环依赖导致启动失败
-pattern: /@Autowired.*@Lazy|@Lazy\s+@Autowired/
-severity: warning
-check_type: deterministic
-executor: regex_pattern_scan
-scope: backend
-description: 使用 @Lazy 解决循环依赖是临时方案，应重构消除循环依赖。
-  ⚠️ 已知局限：@Autowired 与 @Lazy 通常分行写，单行难同时命中。深度检查迁 B 档（ArchUnit beFreeOfCycles，与 ARCH-DEP-02 同源）。
-evidence_required:
-  - "扫描结果：含 @Lazy 循环依赖的文件路径+行号"
-
-## ARC-08: Service 层直接操作 HttpServletRequest/Response
-pattern: /(?:HttpServletRequest|HttpServletResponse)\s/
-severity: warning
-check_type: deterministic
-executor: regex_pattern_scan
-scope: backend
-description: Service 层禁止依赖 Servlet API，应通过参数 DTO 传递数据（与架构设计规则 ARCH-RED-03 同源 pattern，双重覆盖）
-evidence_required:
-  - "扫描结果：Service 层引用 Servlet API 的文件路径+行号"
-
-## ARC-09: 未配置全局异常处理器
-severity: warning
-check_type: external_tool
-executor: external_command
-command_hint: grep -rl -e @RestControllerAdvice -e @ControllerAdvice --include=*.java .
-scope: backend
-description: 项目必须有全局异常处理器（@RestControllerAdvice），统一错误响应格式。
-  已迁 B 档 external_command：verify-gate 挂 external_command 跑 grep 项目级存在性检测，
-  exitCode 反转（找到 @RestControllerAdvice = exitCode 0 通过，缺失 = exitCode 1 失败），
-  修正原 regex_pattern_scan 语义反转（命中=违规 vs 此处命中=有处理器=好事）+ git diff 静默失效（项目级配置不在变更文件内）问题。
-  原空 pattern 已移除（regex_pattern_scan 单行匹配无法做项目级存在性检测）。
-evidence_required:
-  - "全局异常处理器存在确认（external_command grep 项目级 exitCode 0）"
-
-## 文档审查区（ARCH-R01~14，design-gate document_structure / semantic 读取）
-
-## ARCH-R01: 架构目标与需求对齐
-severity: error
-check_type: deterministic
-executor: document_structure
-check_hint: Ch2 架构目标中引用的 REQ-ID 覆盖率 ≥ 100%
-evidence_required: "Ch2 架构目标表 + Ch3.2 功能需求引用表"
-failure_message: "架构目标未覆盖 REQ-{ID}，或引用了不存在的 REQ-ID"
-档位: A 档
-
-## ARCH-R02: ADR 完整性
-severity: error
-check_type: deterministic
-executor: document_structure
-check_hint: MADR 必填字段完整（标题/状态/上下文/决策/候选方案/理由/后果）
-evidence_required: "ADR 文件"
-failure_message: "ADR 缺少必填字段"
-档位: A 档
-
-## ARCH-R03: 约束条件覆盖
-severity: warning
-check_type: deterministic
-executor: document_structure
-check_hint: Ch3a 技术约束/组织约束/法规约束/预算约束各 ≥1 条
-evidence_required: "架构设计文档 Ch3a"
-failure_message: "约束条件未覆盖全部 4 类"
-档位: A 档
-
-## ARCH-R04: 模块边界清晰性
-severity: warning
-check_type: semantic
-check_hint: 模块单一职责，无过度耦合
-evidence_required: "架构设计文档 Ch5"
-档位: C 档
-
-## ARCH-R05: 接口契约完备性
-severity: warning
-check_type: deterministic
-executor: document_structure
-check_hint: 请求/响应/错误码完整
-evidence_required: "架构设计文档 Ch8"
-档位: A 档
-
-## ARCH-R06: 数据模型一致性
-severity: warning
-check_type: deterministic
-executor: document_structure
-check_hint: 实体关系完整/字段类型明确
-evidence_required: "架构设计文档 Ch7"
-档位: A 档
-
-## ARCH-R07: NFR 量化可行性
-severity: info
-check_type: semantic
-check_hint: 目标值可测量
-evidence_required: "架构设计文档 Ch10.1"
-档位: C 档
-
-## ARCH-R08: 安全架构覆盖
-severity: warning
-check_type: deterministic
-executor: document_structure
-check_hint: Ch6.4 包含认证方案 + 授权方案 + 数据加密策略
-evidence_required: "架构设计文档 Ch6.4"
-档位: A 档
-
-## ARCH-R09: 部署方案可行性
-severity: info
-check_type: semantic
-check_hint: 环境规划/CI/CD 方案完整
-evidence_required: "架构设计文档 Ch6.5"
-档位: C 档
-
-## ARCH-R10: 风险应对充分性
-severity: warning
-check_type: semantic
-check_hint: Ch10.2 风险登记覆盖度充分
-evidence_required: "架构设计文档 Ch10.2"
-档位: C 档
-
-## ARCH-R11: 跨横切关注点覆盖
-severity: info
-check_type: deterministic
-executor: document_structure
-check_hint: Ch13 日志/错误/缓存/配置 4 项至少各 1 条
-evidence_required: "架构设计文档 Ch13"
-档位: A 档
-
-## ARCH-R12: 子产物一致性
-severity: warning
-check_type: deterministic
-executor: document_structure
-check_hint: 数据库/接口文档引用在主产物中存在
-evidence_required: "全产物交叉检查"
-档位: A 档
-
-## ARCH-R13: 改造影响范围完整性（老系统）
-severity: warning
-check_type: deterministic
-executor: document_structure
-check_hint: 改造影响评估中每个受影响模块都有验证方式
-evidence_required: "改造影响范围评估 §2 + §3"
-system_scope: existing-system
-档位: A 档
-
-## ARCH-R14: 隔离适配器向后兼容（老系统）
-severity: error
-check_type: deterministic
-executor: document_structure
-check_hint: 隔离适配器方案中 API 语义差异行均有兼容策略
-evidence_required: "隔离适配器方案 §2.4"
-system_scope: existing-system
-档位: A 档