Agent-System/.doc/archive/ops/2026-09-17-docgov-optional-duty-null-fk.md

title, status, created, updated, owner, branch, worktree, mutex

title	status	created	updated	owner	branch	worktree	mutex
修复 CreateOrGetDocument 可选职责 0→NULL FK	done	2026-09-17	2026-09-17	Cursor	fix/docgov-optional-duty-null-fk	-	docgov

修复 CreateOrGetDocument 可选职责 0→NULL FK

目标

无 reviewer/approver 职责时创建文档账本成功，不再因 reviewer_id=0 FK 失败并被标成 INTERNAL_ERROR。

范围

• internal/docgov/engine.go：nullIfZero 写入 author/reviewer/approver
• internal/stream/classify.go：DOC_LEDGER_ERROR 分型
• 回归测试 + audit/test-report

非目标

• 不强制项目配置 reviewer
• 不改前端 flushSync / 虚拟列表
• 不改项目 6417 存量数据（代码修好后重试即可）

步骤

1. CreateOrGetDocument 0→NULL
2. ClassifyError DOC_LEDGER_ERROR
3. 单元/回归测试（-short 已绿）
4. 占集成槽位 rebuild + 6417 复测（run_1789625396102207018，doc_proj6417_intake NULL FK）
5. test-report 归档；合入 dev

验收标准

• go test -short ./internal/docgov/... ./internal/stream/... PASS
• 仅-author 项目 CreateOrGetDocument / 任务发起不再 INTERNAL_ERROR；reviewer_id IS NULL
• 项目 6417 账本创建成功（full 职责路径未被本修复改动）

相关链接

• Audit: ../../audit/2026-09-17-docgov-optional-duty-null-fk.md
• Test report: ../../test-reports/2026-09-17-docgov-optional-duty-null-fk-test-report.md

证据 / 备注

• 失败 run：run_1789622069585300787
• 验证 run：run_1789625396102207018 / doc_proj6417_intake author=9 reviewer/approver NULL
• merge：e488d10 merge: fix/docgov-optional-duty-null-fk