soloforge 1.1.45 → 1.1.47

package/templates/build//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245/351/252/214/350/257/201.md

@@ -1,56 +0,0 @@
----
-id: ka-procedure-主链路接入验证流程
-kind: guidance
-title: 主链路接入验证
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 主链路
-  - 集成验证
-  - 链路接入
-  - 端到端集成
-extra:
-  name: mainline-integration-verification
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  type: procedure
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-main-path-integration
----
-
-# 主链路接入验证流程
-
-## 步骤
-
-1. 识别新增模块 (changed_files 中 src/ 下的文件)
-2. 扫描谁导入了该模块 (scanModuleImporters)
-3. 从入口点追踪可达性 (traceModuleReachability)
-4. 收集可观测证据 (collectModuleObservability)
-   evidence_required:
-     - "模块导入者列表（scanModuleImporters 输出）"
-     - "入口点可达性追踪日志（traceModuleReachability 输出）"
-     - "集成测试文件路径（findIntegrationTests 输出）"
-5. 查找集成测试 (findIntegrationTests)
-6. 判断接入状态 (integrated / implemented_not_integrated / ...)
-7. 运行 orphanGate 和 validateMainPathIntegration
-
-## 接入标准
-
-- **integrated**: 有生产调用 + 有入口链路
-- **implemented_not_integrated**: 无生产调用或无入口链路
-- **experimental_isolated**: 明确标注为实验性
-
-## 注意事项
-
-- barrel export 不算生产调用
-- registry 声明不算接入
-- type reference 不算接入

package/templates/build//344/273/243/347/240/201/351/227/250/347/246/201.md

@@ -1,58 +0,0 @@
----
-id: ka-procedure-代码门禁流程
-kind: guidance
-title: 代码门禁
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 代码门禁
-  - 代码审查门禁
-  - gate review
-  - 发布门禁
-  - 上线检查
-  - 代码评审
-  - 发布审查
-extra:
-  name: code-gate
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-guard-evaluation
----
-
-## 适用场景
-代码变更的最终门禁审查，确保每行变更可追溯、有真实运行证据、符合项目约束和架构红线。
-
-## 步骤
-1. 确认存在真实 diff 和真实测试证据，无证据不启动审查
-2. 先运行预检查和快照链验证，识别缺口后再下结论
-3. 逐行审查 diff：每行必须追溯到任务卡、交付蓝图、实现映射或阻塞性缺陷
-4. 无关变更、顺手重构、主动抽象、无任务依据的删除默认为阻断
-5. 验证集成证据：部署结果、服务就绪、API 动态验证、DDL 迁移、运行时证据
-6. 拒绝以下类型作为通过证据：dry-run、skipped、not_run、静态分析、AI 摘要、生成截图
-7. 产出三级结论之一：通过 / 有条件通过（附改进清单）/ 不通过（附返回阶段路由）
-8. 审查方与实现方分歧时记录 DISPUTE，按角色层级仲裁
-
-## 检查点
-- [ ] 每个 diff 行追溯到任务卡或缺陷
-- [ ] 无 dry-run/静态分析/AI 摘要冒充运行时证据
-- [ ] 部署、就绪、API、DDL、运行时、流程覆盖均有证据
-- [ ] 每个发现项有唯一返回路由和修复权限
-- [ ] 无关变更和顺手重构已被阻断
-
-## 注意事项
-- 禁止接受 dry-run/静态分析/AI 摘要/生成截图作为运行时证据
-- 禁止在缺少运行时证据时通过
-- 禁止先下结论再找理由（先查缺口再判断）
-- draft 状态的桥接/快照/边车文件为阻断项

package/templates/build//345/205/250/346/240/210/346/265/201/347/250/213/344/277/256/345/244/215.md

@@ -1,48 +0,0 @@
----
-id: ka-pattern-fullstack-flowheal
-kind: knowledge
-title: 全栈流程修复
-sync_policy: copy_to_project
-status: active
-extra:
-  name: fullstack-flowheal
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-general-pattern
----
-
-## 决策规则
-- 必须严格遵循 5 步顺序：定义用例 → 收集证据 → 诊断 → 补丁计划 → 验证，禁止跳步
-- 证据优先、流程优先、浏览器证据优先、最小补丁、分层验证
-- 禁止将不稳定测试视为业务失败，先稳定复现再判断
-- 禁止删除断言、增加 sleep、降低覆盖率、增加 mock 来制造通过
-- 禁止用 SQL 直接写业务测试数据
-- 禁止自动修改事务/权限/金额/库存/安全策略
-- 一次只修一个问题，禁止跨层大重构同时进行
-- 高风险/低置信度/跨多服务的复杂变更上报人工决策
-- 端到端测试必须从浏览器页面出发，禁止绕过前端
-- 前后端联调必须基于接口文档（OpenAPI），禁止口头约定字段
-- 前后端字段命名不一致时以后端为准，前端通过映射层适配
-- 接口变更必须同步更新文档和前端调用，禁止只改一侧
-- 联调问题必须在缺陷系统记录根因（文档不完整/需求不明确/理解偏差），持续改进
-
-## 验收项
-- [AC-01] 遵循 5 步顺序（用例→证据→诊断→补丁→验证）
-- [AC-02] 证据包含 UI 追踪/API 调用/后端 traceId/数据状态
-- [AC-03] 修复后重新构建再验证
-- [AC-04] 最终状态显式声明（ready_to_commit/escalated/reverted）
-- [AC-05] 联调基于接口文档
-- [AC-06] 接口变更同步更新文档和前端
-- [AC-07] 联调问题记录根因

package/templates/build//345/210/207/347/211/207/346/211/247/350/241/214/347/272/252/345/276/213.md

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

package/templates/build//345/210/207/347/211/207/347/253/257/345/210/260/347/253/257/351/252/214/350/257/201.md

@@ -1,221 +0,0 @@
----
-id: ka-rule-切片端到端验证规则
-kind: guidance
-title: 切片端到端验证
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 切片端到端验证
-  - 切片验证
-  - E2E验证
-  - slice e2e
-extra:
-  name: slice-e2e-verification
-  type: constraint
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  domain: build
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-generic-review
----
-
-# 切片端到端验证规则（Docker 部署 + 浏览器多维交叉验证）
-
-> 本规则适用阶段：编码与单元测试
-> 触发时机：每个切片编码完成后、标记切片通过前
-
-## 总则
-
-每个切片完成后，**必须**将后端服务和 Web 服务部署到本地 Docker，
-然后通过浏览器（Playwright）打开运行中的系统，对**原型、需求、设计**三个维度
-进行交叉验证。
-
-验证未通过的切片不得标记为完成。
-
-## 对抗性审查协议（强制）
-
-你正在执行切片端到端验证。你是严格的质量审查员，你的职责是发现问题，不是放行。
-
-### 审查原则（违反任何一条等同验证失败）
-
-1. **默认立场**：每一条检查项都是 ❌，除非你能提供浏览器实际截图或页面内容作为证据
-2. **无证据的 ✅ 等同于 ❌** — 你必须通过 Playwright 打开页面、截图、提取元素，不接受自述"页面正常"
-3. **禁止批量标记 ✅** — 每条检查项必须独立操作浏览器并附证据
-4. **禁止跳过任何检查项**
-
-### 执行流程
-
-**阶段 A: 部署 + 三维交叉验证**
-
-> **⚠️ 绝对不允许只检查"Docker 可用"就跳过部署！**
-> 你必须**实际执行** `docker compose up -d --build` 并在输出中包含 `docker ps` 结果。
-
-1. **实际执行部署命令**：运行 `docker compose up -d --build`，等待容器启动完成
-2. **输出部署证据**：运行 `docker ps` 并将输出（包含容器名、状态、端口映射）完整展示给用户
-3. **确认 Docker Desktop 可见**：用户必须在本地 Docker Desktop 中看到运行中的容器
-4. 构建 Web 服务 Docker 镜像并启动
-5. 通过 Playwright 打开浏览器，访问 Web 服务
-6. 逐维度验证：
-
-#### 维度 1: 原型交叉验证（UI / 交互一致性）
-
-将浏览器中实际页面与原型说明文档逐页对比：
-- 页面布局是否与原型一致（导航结构、区域划分、组件位置）
-- 交互行为是否与原型描述一致（按钮点击、表单提交、状态切换）
-- 文案是否与原型一致（标题、标签、提示文本、错误消息）
-
-**证据要求**：Playwright 截图 + 原型说明文档中的对应描述引用
-
-#### 维度 2: 需求交叉验证（功能点覆盖）
-
-将浏览器中实际操作与需求文档逐条对比：
-- 需求文档中的每个功能点是否可在浏览器中操作验证
-- 正常流程是否可走通
-- 边界条件是否已处理（空数据、超长输入、异常状态）
-
-**证据要求**：Playwright 操作步骤 + 实际结果 + 需求文档中的对应条目引用
-
-#### 维度 3: 设计交叉验证（接口 / 数据一致性）
-
-将浏览器中实际数据流与设计文档对比：
-- API 接口签名是否与 API 接口规格文档一致（路径、参数、响应格式）
-- 数据展示是否与数据库设计文档中的字段定义一致
-- 前后端数据流转是否与详细设计文档描述一致
-
-**证据要求**：浏览器 Network 请求/响应截图 + 设计文档中的对应定义引用
-
-→ 产出完整三维验证报告（每条 ❌ + 问题描述 或 ✅ + 截图/引用证据）
-
-**阶段 B: 强制修复**
-
-对验证报告中的每一个 ❌ 和 ⚠️ 项：
-1. 修复代码或配置
-2. 重新构建 Docker 镜像
-3. 重新部署并重新通过浏览器验证
-4. 不允许只报告不修复
-
-**阶段 C: 独立重审（强制）**
-
-修复完成后，你必须再次调用 `审查 切片` 工具进行独立重审。
-这不是可选的——这是强制性的质量保证步骤。
-如果重审发现问题 → 回到阶段 B 继续修复（最多 5 轮）。
-
-**阶段 D: 人工验证（强制）**
-
-AI 验证通过后，Docker 服务**必须保持运行**，然后**必须输出以下格式的地址**供人工验证：
-
-```text
-═══ 人工验证地址 ═══
-后端服务: <http://localhost:{实际端口}>
-Web 服务:  <http://localhost:{实际端口}>
-════════════════════
-```
-
-- `{实际端口}` 必须替换为 `docker ps` 输出中映射的真实端口号
-- 不允许输出 `{PORT}` 占位符 — 必须是用户可直接点击的具体地址
-- 同时输出 `docker ps` 结果，让用户确认 Docker Desktop 中可见
-
-人工在浏览器中确认系统功能和界面无误后，**必须把人工确认证据放入证据目录**：
-
-- 目录：`.soloforge/evidence/{sliceId}/SLICE-E2E-13/`
-- 证据形式：确认截图 `.png` 或确认记录 `.txt`
-- `SLICE-E2E-13` 门禁（`file_evidence`）据此校验**证据文件存在**
-- ⚠️ 门禁只证「证据文件存在」，**不替代人工判断**（人是否真看了由人负责，gate 不假装能判）
-- 证据就位后，切片方可标记为完成
-
-Docker 服务在人工确认前不得停止或删除。
-
-### 终止条件
-
-1. 三维验证报告全部 ✅ + 每条附浏览器截图或页面内容证据
-2. Docker 服务保持运行，访问地址已输出
-3. 人工确认通过 → 切片完成
-4. 达到最大 5 轮 AI 修复仍不通过 → 停止，报告剩余未通过项
-
-### 禁止事项
-
-- ⚠️ 绝对不允许以"本地环境不支持 Docker"为由跳过验证
-- ⚠️ 绝对不允许只说"Docker 可用"而不实际执行 `docker compose up -d --build` 部署
-- ⚠️ 绝对不允许部署后不输出 `docker ps` 结果 — 用户必须能在 Docker Desktop 中看到容器
-- ⚠️ 绝对不允许仅输出验证报告就停下来 — 验证失败必须修复
-- ⚠️ 绝对不允许用"我检查过了"代替浏览器实际截图
-- ⚠️ 绝对不允许只看首页就标记全部通过 — 必须覆盖切片涉及的全部页面和功能
-- ⚠️ 绝对不允许跳过独立重审步骤
-- ⚠️ 绝对不允许 AI 验证通过后就停止 Docker 服务 — 必须保持运行供人工确认
-- ⚠️ 绝对不允许跳过人工验证就标记切片完成
-- ⚠️ 绝对不允许不输出人工验证地址 — 必须明确输出后端和前端的 `localhost:{实际端口}` 地址
-
-## SLICE-E2E 规则条目
-
-> 以下 13 条与 `slice-gate.yaml` 的 13 个 check **一一对应、编号一致**。
-> 规则（本文件）管「怎么做」，门禁（yaml）管「够不够」——两层编号必须对齐，不可分裂。
-
-**SLICE-E2E-01** Docker 服务部署成功：后端 + Web 均部署到本地 Docker，容器 Running
-- 强制：是（error）
-- 执行器：`docker_deployment`（真跑 `docker compose up -d --build`）
-- 证据：`docker ps` 输出（须显示容器 Running）
-
-**SLICE-E2E-02** 服务 HTTP 可访问：真发请求校验 2xx/3xx（截图存在 ≠ 服务可访问）
-- 强制：是（error）
-- 执行器：`local_http_acceptance`（真 fetch，防造假截图）
-- 证据：HTTP 状态码 2xx/3xx + 响应 body 片段
-
-**SLICE-E2E-03** 原型维度 — 页面布局与原型一致（导航/区域/组件逐页对比）
-- 强制：是（error）
-- 执行器：`file_evidence`
-- 证据：Playwright 页面截图 + 原型说明文档章节引用
-
-**SLICE-E2E-04** 原型维度 — 交互行为与原型一致（点击/提交/状态切换）
-- 强制：是（error）
-- 执行器：`file_evidence`
-- 证据：Playwright 操作前后截图 + 原型交互描述引用
-
-**SLICE-E2E-05** 需求维度 — 功能点可操作验证（需求文档每个功能点可操作）
-- 强制：是（error）
-- 执行器：`file_evidence`
-- 证据：Playwright 操作步骤 + 结果截图 + 需求条目引用
-
-**SLICE-E2E-06** 需求维度 — 正常流程可走通（核心业务端到端）
-- 强制：是（error）
-- 执行器：`file_evidence`
-- 证据：Playwright 端到端操作截图序列 + 最终结果页
-
-**SLICE-E2E-07** 需求维度 — 边界条件已处理（空数据/超长/异常）
-- 强制：否（warning，不阻断但记录）
-- 执行器：`file_evidence`
-- 证据：边界场景 Playwright 截图 + 错误提示内容
-
-**SLICE-E2E-08** 设计维度 — 接口签名与 API 规格一致（路径/参数/响应）
-- 强制：是（error）
-- 执行器：`file_evidence`
-- 证据：浏览器 Network 请求/响应截图 + API 接口规格引用
-
-**SLICE-E2E-09** 设计维度 — 数据展示与数据库设计一致（字段/类型/格式）
-- 强制：是（error）
-- 执行器：`file_evidence`
-- 证据：页面数据展示截图 + 数据库设计字段定义引用
-
-**SLICE-E2E-10** 验证报告附浏览器实际截图（不接受 AI 自述「已验证」）
-- 强制：是（error）
-- 执行器：`file_evidence`
-- 证据：验证报告每条检查项对应的 Playwright 截图引用
-
-**SLICE-E2E-11** 失败项已全部修复并通过重验（对比修复前后截图）
-- 强制：是（error）
-- 执行器：`tool_trace_review`
-- 证据：修复前后 Playwright 截图 + 修复说明
-
-**SLICE-E2E-12** Docker 服务保持运行，访问地址已输出（供人工确认）
-- 强制：是（error）
-- 执行器：`docker_deployment`
-- 证据：后端地址 + Web 地址（`<http://localhost:{实际端口}>`）
-
-**SLICE-E2E-13** 人工确认通过（证据放 `.soloforge/evidence/{sliceId}/SLICE-E2E-13/`）
-- 强制：是（error）
-- 执行器：`file_evidence`（只证文件存在，不替代人工判断）
-- 证据：确认截图 `.png` 或确认记录 `.txt`

package/templates/build//345/212/237/350/203/275/345/274/200/345/217/221.md

@@ -1,66 +0,0 @@
----
-id: ka-procedure-功能开发流程
-kind: guidance
-title: 功能开发
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 新功能开发
-  - 需求实现
-  - feature
-  - 新增功能
-  - 需求开发
-  - 功能实现
-  - 新建功能
-extra:
-  name: feature-development
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-task-context-lifecycle
----
-
-## 适用场景
-从需求到上线的完整功能开发流程。适用于需要前后端协作的中等及以上复杂度功能。
-
-## 步骤
-1. 需求澄清：确认功能边界、验收标准、影响范围
-2. 技术方案设计：确定接口契约（API 定义）、数据模型、技术选型
-3. 自主技术选型（若涉及架构级选型）：检索行业基准（结合通用知识 + sf_knowledge 项目沉淀） → 四维矩阵 → 证伪循环 → A/B 决策诱导 → 等待人类选择
-4. 前后端对齐：API 文档/接口契约评审，确认字段和状态流转
-5. 后端开发：按 crud-operation / api-pagination 等模式实现，先写接口再写逻辑
-6. 前端开发：按 react-component / react-api-integration 等模式实现页面和接口对接
-7. **切片验证**：运行当前切片的单元测试 → 检查覆盖率（≥9 场景）→ 确认变更在涉及文件范围内 → 更新切片测试状态（pending→red→green→refactored）
-8. 联调测试：前后端联调，验证完整流程
-9. 代码审查：使用 sf_work action=verify 检查质量/安全/性能
-10. 提测：部署到测试环境，执行验收标准
-11. 修复反馈问题后准备发布
-
-## 检查点
-- [ ] API 接口契约已对齐并文档化
-- [ ] 后端接口有 Swagger/OpenAPI 文档
-- [ ] 核心逻辑有单元测试覆盖
-- [ ] 前后端联调通过
-- [ ] 涉及技术选型时已完成行业基准对齐
-- [ ] 交付物末尾已签署终局宣言
-- [ ] 切片验证点已执行（步骤 7）
-
-## 注意事项
-- 接口契约先于实现（避免前端等后端）
-- 复杂功能拆分为多个子任务并行开发
-- 每个子任务完成后及时联调，不要全部完成后才联调
-- 编码前确认交付蓝图状态，敏感领域（金额算法/状态流转/审批规则/跨系统同步）需用户确认
-- 通过交付蓝图的必须读/可选读/默认不读列表控制上下文，禁止默认读取全部上游文档
-- 修复限于同一限界上下文可继续；跨越无关模块必须返回任务拆解
-- 变更映射必须覆盖所有改动，unmapped_changes 不允许非零

package/templates/build//345/220/216/347/253/257/345/256/236/347/216/260.md

@@ -1,39 +0,0 @@
----
-id: ka-artifact_template-后端实现验收清单
-kind: artifact
-title: 后端实现
-sync_policy: copy_to_project
-status: active
-extra:
-  name: backend-implementation-acceptance
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  type: artifact
-  domain: build
-  stage: build
-  owner_mechanism: mc-backend-implementation-contract
----
-
-# 后端实现验收清单
-
-| 检查项 | 结论 | 权威证据 | 失败修复 |
-|---|---|---|---|
-| 请求 DTO 与字段校验 | | | |
-| 响应 DTO、分页与错误码 | | | |
-| 事务和状态流转 | | | |
-| 幂等与并发冲突 | | | |
-| 权限、租户和审计 | | | |
-| OpenAPI 与 migration 对齐 | | | |
-| 自动化测试和负向案例 | | | |
-
-## 字段级追踪（按 API Endpoint）
-| Endpoint | 字段路径 | DTO 映射 | 校验规则 | 测试用例 | 状态 |
-|----------|---------|---------|---------|---------|------|
-| POST /api/v1/xxx | request.field1 | CreateXxxDTO | @NotNull | T-02, T-04 | ✅/❌ |
-| GET /api/v1/xxx/{id} | response.data.field | XxxVO | @NotBlank | T-01, T-03 | ✅/❌ |
-| PUT /api/v1/xxx/{id} | request.field2 | UpdateXxxDTO | @Size(max=100) | T-05 | ✅/❌ |

package/templates/build//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213.md

@@ -1,33 +0,0 @@
----
-id: ka-pattern-backend-implementation-engineering
-kind: knowledge
-title: 后端实现工程
-sync_policy: copy_to_project
-status: active
-extra:
-  name: backend-implementation-engineering
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-backend-implementation-contract
----
-
-## 工程规则
-
-- Controller 入参与出参按接口语义使用 DTO/VO，不暴露数据库实体。
-- 参数必须验证必填、长度、枚举、金额、日期区间和关联对象存在性。
-- 列表接口限制 page size 并对白名单排序；响应使用统一分页对象。
-- 写操作在 Service 定义清晰事务边界；外部调用不放在长事务内。
-- 支付、回调、创建与状态流转具备幂等键、并发控制和重复提交测试。
-- 敏感操作必须校验权限和租户，并产出可追踪审计记录。
-- OpenAPI、字段表、错误码和 migration 必须与实现同步复验。