feat: sync lijiaoqiao implementation and staging validation artifacts

docs/supply_traceability_matrix_generation_rules_v1_2026-03-27.md

@@ -0,0 +1,37 @@
+# 供应侧追踪矩阵生成规则（v1.0）
+
+- 日期：2026-03-27
+- 适用文件：`reports/supply_traceability_matrix_2026-03-25.csv`
+- 目标：保证 Requirement -> API -> Test -> Metric -> Gate 的自动化可追踪与口径一致。
+
+## 1. 字段规范
+
+1. `requirement_id`：唯一且稳定，不得复用。
+2. `api`：必须使用 OpenAPI 主路径与精确参数名（如 `{accountId}`、`{packageId}`、`{settlementId}`）。
+3. `api_alias`：仅记录历史兼容路径；无兼容值填写 `-`。
+4. `test_case`：使用 `|` 连接多个用例 ID，顺序按主路径优先。
+5. `metric`：使用 SSOT 中的统一指标名，禁止自造同义词。
+6. `gate`：映射 SUP/SEC/XR 门禁，多个值用 `|` 分隔。
+7. `status`：`PLANNED/RUNNING/PASS/FAIL/BLOCKED` 五态。
+
+## 2. 生成流程
+
+1. 从按钮级 PRD 抽取需求项并形成 `requirement_id`。
+2. 从 OpenAPI 提取接口主路径，填入 `api`。
+3. 对历史路径或迁移路径填入 `api_alias`。
+4. 绑定测试用例、指标、门禁并指定 owner。
+5. 由 QA 执行完整性检查后发布 CSV。
+
+## 3. 校验规则
+
+1. `api` 必须可在 OpenAPI 中检索命中。
+2. `api_alias` 不得与 `api` 完全相同。
+3. `gate` 必须在任务单中存在对应条目。
+4. 每条记录必须有 `evidence_path`。
+5. 任一校验失败，`M-019` 计为不通过。
+
+## 4. 变更治理
+
+1. 修改 `api` 视为高风险变更，必须同步更新用例与门禁映射。
+2. 新增 alias 必须附迁移原因和下线计划。
+3. 每次变更后需执行一次路径一致性检查并留痕。