docs: sync null-fk promote closeout onto test

2026-09-17 06:20:40 +00:00
parent d73d2e8633 173a512c28
commit 15881cd0e6
2 changed files with 56 additions and 5 deletions
@@ -5,15 +5,15 @@

 ## 焦点

-1. **promote null-fk → test**：`rc-v1.0.0-beta.4`（docgov optional-duty FK 修复）
-2. **partial/deferred 全量收口**：W1–W4 **done**；W5a **done**（矩阵自举行仍 partial）；W6 **shadow done**（矩阵 FAV 仍 partial）；W7 **盘点 done**（矩阵 D7 仍 deferred）。已晋升：`rc-v1.0.0-beta.3` → 本轮 `beta.4`
+1. **partial/deferred 全量收口**：W1–W4 **done**；W5a **done**；W6 **shadow done**；W7 **盘点 done**。test 已至 `rc-v1.0.0-beta.4`（含 optional-duty null FK）
+2. **运维**：nightly `DATA_DIR=dev` 已对齐；KB 宿主机分层加载 / fail-closed **done**
 3. **红线**：禁止整支 merge FAV；不默认升 `MULTI_INTENT_PLAN_TIER=full`（升 `confirm` 须 W4 闭环后独立授权）；`SEMANTIC_SUMMARY_REPLACE` 不随 W2 开启；FAV live 顺序 staging→artifact→publication、每级观察窗证据驱动（下限 ≥7 天）、`FAV_DEGRADED_READ=false`；flag 默认 off；项目 143 只读

 ## 并行认领

 | owner | task | branch | worktree | mutex | status |
 |-------|------|--------|----------|-------|--------|
-| Cursor | 2026-09-17-promote-null-fk-to-test | feature/promote-null-fk-to-test | - | infra | in_progress |
+| Cursor | 2026-09-17-promote-null-fk-to-test | feature/promote-null-fk-to-test | - | infra | done |
 | Cursor | 2026-09-17-docgov-optional-duty-null-fk | fix/docgov-optional-duty-null-fk | - | docgov | done |
 | Cursor | 2026-09-17-leftover-hygiene | chore/leftover-hygiene-2026-09-17 | - | ops | done |
 | Cursor | 2026-09-17-w2-semantic-summary-shadow | feature/w2-semantic-summary-shadow-live | - | chat | done |
@@ -121,7 +121,7 @@

 | holder | phase | since | scope | queue |
 |--------|-------|-------|-------|-------|
-| Cursor | merging | 2026-09-17 | promote null-fk → test (rc-v1.0.0-beta.4) | - |
+| - | idle | - | - | - |

 **phase**: `idle` | `merging` | `smoke` | `e2e`

@@ -132,7 +132,7 @@
 | 环境 | 端口 | schema | 状态 |
 |------|------|--------|------|
 | dev | 8080 | **48** | healthy（`pi-agent` typed-result-v1；events worker `:8088`；notify/advance/projection live、fav off；health+ready PASS；demo 6001–6010 retired） |
-| test | 8081 | **48** | healthy（`rc-v1.0.0-beta.3`；pi-agent `:18866`；events `:8089`；notify/advance/projection live、fav off；health+ready PASS；goose 00048 已迁移） |
+| test | 8081 | **48** | healthy（`rc-v1.0.0-beta.4`；pi-agent `:18866`；events `:8089`；notify/advance/projection live、fav off；health+ready PASS；goose 00048 已迁移） |
 | main | 8000 | **47** | healthy（app + events + runner + DB；与 dev/test 对齐） |

 ## SSOT
@@ -0,0 +1,51 @@
+# 晋升 optional-duty null FK → test（rc-v1.0.0-beta.4）
+
+## 一、 测试背景 (Background)
+
+dev 已验证 `CreateOrGetDocument` 可选职责 `reviewer_id=0` FK 修复。同一缺陷会波及 test；需合入 `test` 并重建服务。
+
+## 二、 测试目标 (Test Objectives)
+
+- 本地 `test` 合入含修复的 `dev`，tag `rc-v1.0.0-beta.4`
+- `./scripts/env-service.sh test rebuild` 后 `:8081` 健康，二进制含 `DOC_LEDGER_ERROR`
+
+## 三、 测试方案与环境 (Test Plan & Environment)
+
+| 项 | 值 |
+|---|---|
+| 合入 | `git checkout test && git merge --no-ff dev`（手工；跳过缺 receipt 的 `promote-to-test.sh`） |
+| Tag | `rc-v1.0.0-beta.4` |
+| HEAD | `d73d2e8` |
+
+## 四、 预期结果 (Expected Results)
+
+- health/ready：`env=test`、`schema_version=48`
+- `/app/server` 含 `DOC_LEDGER_ERROR` / 「文档职责账本写入失败」
+
+## 五、 实际测试结果与判定 (Actual Results & Evaluation)
+
+### 合入与 tag
+
+- **输入**: merge `dev` → `test`；annotated tag
+- **输出**: `test@d73d2e8`；`rc-v1.0.0-beta.4`
+- **判定**: PASS
+
+### rebuild + 冒烟
+
+- **输入**: `./scripts/env-service.sh test rebuild`；`curl :8081/health` `/ready`；`:8089/health`
+- **输出**:
+
+```json
+{"status":"ok","env":"test","schema_version":48,"schema_ready":true,"task_store_ready":true}
+```
+
+`FIX_PRESENT=yes`（`grep -a DOC_LEDGER_ERROR /app/server`）。events：`{"env":"test","status":"ok"}`。
+- **判定**: PASS
+
+## 六、 自动化测试套件汇总 (Test Suite Execution)
+
+本波为环境晋升冒烟；根因修复证据见 [2026-09-17-docgov-optional-duty-null-fk-test-report.md](./2026-09-17-docgov-optional-duty-null-fk-test-report.md)。
+
+## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
+
+test 已更新至 `rc-v1.0.0-beta.4` 并 rebuild。未推远端、未合 `main`。