docs: record phase13 production absorption

2026-05-16 16:49:51 +08:00
parent 6b509d8c0b
commit f5fbc44206
1 changed files with 54 additions and 0 deletions
@@ -1962,3 +1962,57 @@
 - 生产服务、发布门禁、生产看护、业务质量、交付验收已经形成上线后闭环。
 - 当前没有 required 阻塞项。
 - 唯一保留项是外部告警 Webhook 未配置；在当前无人审批 / Codex 代理模式下，它不阻塞交付验收，但如果要接入企业微信、飞书或其他真实告警接收端，需要补 `AI_CONTRACT_WATCHDOG_WEBHOOK_URL` 后再复跑 scheduler 与 delivery acceptance。
+## 2026-05-16 Phase13 资料包正式吸收入库闭环
+### 本轮完成项
+- 已把 Phase13 资料包从“治理资产层 approved/ready”同步到正式业务运行层：
+  - 20 条法源进入生产知识库并完成索引
+  - 10 张知识卡进入生产知识库并完成索引
+  - 8 条标准条款进入生产知识库并完成索引
+  - 8 条正式审核规则进入 `review_rules`，并完成发布
+  - 10 个合同模板进入 `contract_templates`，并完成发布
+- 新增正式吸收入库脚本：`scripts/import-phase13-production-assets.ps1`
+- 入库准入不再看本地 CSV 的 `LEGAL_REVIEW / production_ready=false`，而是以生产 API 中 `governance_assets` 的 `review_status=approved`、`production_status=ready/approved` 作为真相源。
+- 模板和规则 API 已补齐显式治理编号入参：模板支持 `template_code`，审核规则支持 `rule_code`。
+- 修复生产入库中发现的真实字段边界：`knowledge_base_documents.effective_date` 从 32 字符拓宽到 128 字符。
+- 新增迁移：`backend/migrations/versions/20260516_0021_widen_knowledge_document_effective_date.py`。
+- 清理了本轮导入试跑造成的 3 条重复模板旧记录，保留同 `template_code` 下最新已发布记录。
+
+### 本轮验证
+- 后端定向测试：
+  - `backend\.venv\Scripts\python.exe -m unittest tests.test_template_service tests.test_templates_api`，结果：`22 tests OK`
+  - `backend\.venv\Scripts\python.exe -m unittest tests.test_review_rule_service tests.test_review_rules_api`，结果：`20 tests OK`
+  - `backend\.venv\Scripts\python.exe -m unittest tests.test_knowledge_bases_api`，结果：`9 tests OK`
+- 后端编译：
+  - `backend\.venv\Scripts\python.exe -m py_compile app\services\template_service.py app\api\templates.py app\services\review_rule_service.py app\api\review_rules.py`
+  - `backend\.venv\Scripts\python.exe -m py_compile app\models\knowledge_base_document.py migrations\versions\20260516_0021_widen_knowledge_document_effective_date.py`
+  - 结果：通过
+- 后端生产部署：
+  - 第一次部署产物：`project-docs/qa-artifacts/phase7-backend-docker-deploy/2026-05-16T16-26-21/backend-docker-deploy-summary.md`
+  - 第二次部署产物：`project-docs/qa-artifacts/phase7-backend-docker-deploy/2026-05-16T16-35-58/backend-docker-deploy-summary.md`
+  - 结果：均为 `PHASE7_BACKEND_DOCKER_DEPLOY_PASS`
+- Phase13 正式吸收入库：
+  - 最终产物：`project-docs/qa-artifacts/phase13-production-absorption/2026-05-16T16-45-46-792/phase13-production-absorption-summary.md`
+  - 结果：`PHASE13_PRODUCTION_ABSORPTION_PASS`
+  - 关键验证：`target_documents=38`、`metadata_complete=38`、`indexed=38`、`failed=0`、`templates=10 published=10`、`rules=8 published=8`
+- 导入后业务质量门禁：
+  - 产物：`project-docs/qa-artifacts/phase9-business-quality-gate/2026-05-16T16-46-29-098/business-quality-gate-summary.md`
+  - 结果：`PHASE9_BUSINESS_QUALITY_GATE_PASS_WITH_WEBHOOK_BLOCKED`
+
+### 当前状态
+- 现在可以明确说：Phase13 第一批法律法规来源、知识卡、标准条款、正式审核规则和合同模板已经被正式系统吸收。
+- “吸收”的系统口径是：
+  - 治理资产层有 approved/ready 真相源
+  - 知识库运行层有 indexed 文档、法源元数据、标签和发布版本
+  - 模板运行层有 `template_code`、发布状态、发布人、发布时间和治理资产绑定
+  - 审核规则运行层有 `rule_code`、发布状态、发布人、发布时间和治理资产绑定
+
+### 未完成项
+- 当前没有 Phase13 正式吸收入库 required 阻塞项。
+- 后续增强项：
+  - 清理 shared-ai 平台中历史自动化产生的大量测试知识库
+  - 为 `template_code` / `rule_code` 增加数据库唯一约束和重复保护
+  - 扩展法源全文条款级采集；本轮已吸收法源清单、检索入口、元数据和关联知识卡，不等同于已经抓取所有法律全文条款
+
+### 阻塞项
+- 本轮无 required 阻塞项。
+- 仍保留旧的非 required 项：外部告警 Webhook 未配置。