feat: add reviewer assignment matrix gate

2026-05-13 12:10:52 +08:00
parent 22fa40d879
commit 61cb3daf68
3 changed files with 427 additions and 7 deletions
@@ -715,3 +715,39 @@
  - 真实 reviewer 完成审查、签收、证据留存。
  - 最终上线批准人签署 `FINAL_APPROVER/final-launch-approval-checklist.md`。
 - 本轮只导入正式治理台账和修正统计口径，没有伪造任何批准结论。
+
+## 2026-05-13 真实 reviewer 分配矩阵入口补强
+
+### 本轮完成项
+- 新增 `scripts/apply-formal-launch-reviewer-assignment-matrix.ps1`：
+  - 默认只校验 `reviewer-assignment-matrix.csv`，不修改台账。
+  - 真实法务、业务、运营、最终批准人四组仍为 `TBD`、`PENDING`、`待复核` 等占位时输出 `BLOCKED`。
+  - 四组均填写真实姓名后输出 `PASS`。
+  - 只有显式加 `-Apply` 时，才会把真实分配写回复核任务包、生产签收台账和法务/业务/运营协作包回填表。
+  - 脚本不会批准任何复核结果，不会签收证据，也不会自动签署最终上线批准清单。
+- 已更新协作包说明，把真实 reviewer 分配矩阵作为真实复核之前的第一步。
+
+### 本轮验证
+- gstack 预检：`GSTACK_OK`。
+- PowerShell Parser 检查：
+  - `scripts/apply-formal-launch-reviewer-assignment-matrix.ps1` 通过。
+- 当前正式矩阵校验：
+  - `FORMAL_LAUNCH_REVIEWER_ASSIGNMENT_MATRIX_BLOCKED`
+  - 产物：`project-docs/qa-artifacts/formal-launch-reviewer-assignment-matrix/2026-05-13T12-08-45-433/formal-launch-reviewer-assignment-matrix-summary.md`
+  - 结果：`missing_groups=4`，包括 `LEGAL_CORE`、`BUSINESS_TEMPLATE`、`OPS_MATERIAL`、`FINAL_APPROVER`。
+- 临时真实姓名矩阵烟测：
+  - `FORMAL_LAUNCH_REVIEWER_ASSIGNMENT_MATRIX_PASS`
+  - 产物：`project-docs/qa-artifacts/formal-launch-reviewer-assignment-matrix/2026-05-13T12-09-07-434/formal-launch-reviewer-assignment-matrix-summary.md`
+  - 说明：该烟测未使用 `-Apply`，没有修改正式台账。
+
+### 当前状态更新
+- 真实 reviewer 分配已经有可执行入口：填矩阵、先校验、再显式 Apply。
+- 当前正式矩阵仍未填写真实人员，因此门禁继续停在真实分配/签收/证据阶段。
+
+### 当前阻塞项
+- 需要真实业务输入：
+  - `LEGAL_CORE.reviewer_name`
+  - `BUSINESS_TEMPLATE.reviewer_name`
+  - `OPS_MATERIAL.reviewer_name`
+  - `FINAL_APPROVER.reviewer_name`
+- 填完后再运行分配矩阵脚本 `-Apply`、远程 PostgreSQL 台账导入、数据库真相源批准门禁复跑。
@@ -13,13 +13,16 @@

 ## 使用方式

-1. 真实复核人打开自己目录下的 `return-bundle.csv`。
-2. 填写真实姓名、复核日期、复核状态、批准结论和修改意见。
-3. 打开对应 `evidence/` 目录下的证据文件。
-4. 完成复核后，将 `EVIDENCE_STATUS: TEMPLATE` 改为 `EVIDENCE_STATUS: READY`，并删除所有 `TODO_REAL_REVIEWER`。
-5. 法务、业务、运营包使用 `scripts/import-formal-launch-review-return-bundle.ps1` 校验回填包。
-6. 校验通过后，才可以加 `-Apply` 写回主台账。
-7. `FINAL_APPROVER/` 不使用 CSV 导入脚本；最终批准人填写 `final-launch-approval-checklist.md` 后，通过 `scripts/run-formal-launch-approval-gate.ps1` 统一验证。
+1. 管理员先在 `project-docs/formal-launch-ops/reviewers/reviewer-assignment-matrix.csv` 填写真实法务、业务、运营和最终批准人。
+2. 运行 `scripts/apply-formal-launch-reviewer-assignment-matrix.ps1` 校验分配矩阵；仍有 `TBD`、`PENDING`、`待复核` 等占位时会保持 `BLOCKED`。
+3. 分配矩阵校验通过后，才可以加 `-Apply` 写回复核任务包、签收台账和协作包回填表。
+4. 真实复核人打开自己目录下的 `return-bundle.csv`。
+5. 填写真实姓名、复核日期、复核状态、批准结论和修改意见。
+6. 打开对应 `evidence/` 目录下的证据文件。
+7. 完成复核后，将 `EVIDENCE_STATUS: TEMPLATE` 改为 `EVIDENCE_STATUS: READY`，并删除所有 `TODO_REAL_REVIEWER`。
+8. 法务、业务、运营包使用 `scripts/import-formal-launch-review-return-bundle.ps1` 校验回填包。
+9. 校验通过后，才可以加 `-Apply` 写回主台账。
+10. `FINAL_APPROVER/` 不使用 CSV 导入脚本；最终批准人填写 `final-launch-approval-checklist.md` 后，通过 `scripts/run-formal-launch-approval-gate.ps1` 统一验证。

 ## 安全规则