feat: complete knowledge source metadata loop

project-docs/AI合同起草与审查助手-当前工作进度保存-2026-05-11.md

@@ -1118,7 +1118,7 @@
   - 运营复核和最终批准目前仍主要由 admin 侧承接
 - 正式生产放行仍继续阻塞在真人复核、证据 READY、最终批准签署，以及知识库发布链的 shared-ai 远端能力缺口
 
-## 2026-05-13 GOV-DB-007 知识库法源元数据第一层收口
+## 2026-05-13 GOV-DB-007 知识库法源元数据完整闭环完成
 
 ### 本轮完成项
 - 已为本地知识库文档表补齐法源元数据字段：
@@ -1141,28 +1141,38 @@
 - 已补齐测试桩与兼容性验证：
   - `backend/tests/test_knowledge_bases_api.py`
   - `backend/tests/test_shared_ai_platform_client.py`
+- 已补齐本地可写入闭环：
+  - `backend/app/api/knowledge_bases.py` 现在支持在上传 / 重试知识库文档时一并提交 `source_type / authority / effective_date / region / tags`
+  - 本地 `knowledge_base_documents` 表会持久化这些法源元数据，并在知识库文档列表接口中覆盖回显
+  - `scripts/import-phase13-library.ps1` 现在会根据 `legal-source-inventory.csv` 自动推导知识卡的法源类型、发文机关、生效日期、适用区域和标签，并随导入一起写入系统
+- 已补齐管理员录入口：
+  - `frontend/src/app/knowledge-bases/page.tsx` 的上传表单新增法源类型、发文机关、生效日期、适用区域、标签输入项
 
 ### 本轮验证
 - 后端测试：
-  - `python -m unittest backend.tests.test_knowledge_bases_api backend.tests.test_shared_ai_platform_client`
-  - 结果：通过
+  - `python -m unittest tests.test_knowledge_bases_api tests.test_shared_ai_platform_client`
+  - 结果：`11 tests OK`
 - 后端编译：
-  - `python -m py_compile backend/app/models/knowledge_base_document.py backend/app/clients/shared_ai_platform.py`
+  - `python -m py_compile app/api/knowledge_bases.py app/repositories/knowledge_base_document_repository.py app/clients/shared_ai_platform.py app/models/knowledge_base_document.py`
   - 结果：通过
 - 前端检查：
   - `npm --prefix frontend run lint`
   - 结果：通过
   - `npm --prefix frontend run build`
   - 结果：通过，知识库页面构建正常
+- 脚本语法检查：
+  - `import-phase13-library.ps1`
+  - 结果：`POWERSHELL_PARSE_OK`
 
 ### 当前状态更新
-- `GOV-DB-007` 已从 `PLANNED` 推进到 `IN_PROGRESS`
-- `ai-contract-platform` 本仓库侧已经形成第一层闭环：
-  - 本地表结构已具备法源元数据字段
-  - shared-ai 返回的知识库文档数据已可在本仓库侧平铺、展示和过滤
-  - 管理员已可在知识库页面按法源维度治理和筛查文档
+- `GOV-DB-007` 已从 `PLANNED` 推进到 `COMPLETED`
+- `ai-contract-platform` 本仓库侧已经形成完整闭环：
+  - 本地表结构具备法源元数据字段
+  - shared-ai 返回的知识库文档数据可在本仓库侧平铺、展示和过滤
+  - 管理员可在知识库页面手动录入法源元数据
+  - phase13 知识卡导入脚本可自动根据法源清单补齐这些元数据并落库
+  - 知识库列表接口会把本地持久化元数据覆盖回显给前端
 
 ### 当前阻塞项
-- `GOV-DB-007` 仍未宣告 `COMPLETED`，原因不是本仓库缺页面或字段，而是 shared-ai 远端当前还没有正式生产化的知识库法源元数据写入链：
-  - 远端知识库文档真实数据是否持续提供 `source_type / authority / effective_date / region / tags`，仍依赖 shared-ai 知识库导入/同步链配合
-  - 当 shared-ai 远端稳定产出这些字段后，本项即可自然收口为 `COMPLETED`
+- 本项在 `ai-contract-platform` 仓库内已无代码级阻塞。
+- 后续 shared-ai 若继续补齐远端原生知识库元数据写入链，会是增强项，而不再阻塞本仓库的 `GOV-DB-007` 闭环。

project-docs/formal-launch-ops/governance-productization-backlog.csv

@@ -5,7 +5,7 @@ batch,priority,area,task_id,title,current_gap,target_deliverable,depends_on,acce
 5A,P0,database,GOV-DB-004,新增证据登记表,当前证据路径和证据状态只存在文档与脚本规则中,新增 governance_evidences 表支持 file_id url status checksum reviewer metadata,GOV-DB-001,系统可校验证据是否存在且不是模板占位,COMPLETED
 5A,P0,database,GOV-DB-005,新增发布批次与门禁结果表,当前上线批准状态只存在 PowerShell 产物中,新增 governance_release_batches 和 governance_gate_runs 表,GOV-DB-001;GOV-DB-003;GOV-DB-004,系统可追踪一次发布批次的门禁快照和结果,COMPLETED
 5A,P1,database,GOV-DB-006,模板表补治理字段,contract_templates 只有内容和启停没有版本与发布元数据,为 contract_templates 增加 template_code version published_at published_by latest_governance_asset_id,GOV-DB-001,模板可区分草稿版和生产发布版,COMPLETED
-5A,P1,database,GOV-DB-007,知识库文档表补法源元数据,知识库文档缺少效力级别生效日期发文机关和法源类型,为知识库相关表增加 source_type authority effective_date region tags,none,知识库可按法源维度治理和过滤,IN_PROGRESS
+5A,P1,database,GOV-DB-007,知识库文档表补法源元数据,知识库文档缺少效力级别生效日期发文机关和法源类型,为知识库相关表增加 source_type authority effective_date region tags,none,知识库可按法源维度治理和过滤,COMPLETED
 5B,P0,backend_api,GOV-API-001,新增治理资产列表接口,当前没有统一治理视图接口,新增 /governance/assets 列表筛选汇总接口,GOV-DB-001,前端可按资产类型状态角色查看治理资产,COMPLETED
 5B,P0,backend_api,GOV-API-002,新增复核分配接口,当前无法在系统内分配真实复核人,新增 /governance/assignments 创建更新撤销接口,GOV-DB-002,管理员可在系统内完成复核任务分配,COMPLETED
 5B,P0,backend_api,GOV-API-003,新增复核回填接口,当前复核结论只能通过CSV和脚本回填,新增 /governance/decisions 提交接口和批量导入接口,GOV-DB-003,真实复核人或管理员可提交复核结果,COMPLETED