feat: add review rule publish workflow

2026-05-13 22:49:25 +08:00
parent 2fb0fcc650
commit c7ca3301de
13 changed files with 836 additions and 4 deletions
@@ -1018,3 +1018,50 @@
  - 文件中心里的“版本视角”仍较基础，后续还可继续增强生产资料版本链可见性
  - 真实 reviewer 仍需把这些生产资料证据从 `TEMPLATE` 改成 `READY`
 - 正式生产放行继续阻塞在真人复核和最终批准签署
+
+## 2026-05-13 GOV-API-007 review_rules 分支完成，knowledge_bases 分支识别为 shared-ai 侧阻塞
+
+### 本轮完成项
+- 已为 `review_rules` 完成正式发布工作流：
+  - `review_rules` 增加 `rule_code`、`current_version_label`、`latest_change_summary`、`latest_version_created_at`、`version_count`、`published_at`、`published_by`、`latest_governance_asset_id`
+  - 新增 `review_rule_versions` 版本快照表与迁移：`backend/migrations/versions/20260513_0019_add_review_rule_publish_fields.py`
+  - 新增规则发布接口：
+    - `POST /api/v1/review-rules/{rule_id}/publish`
+    - `POST /api/v1/review-rules/{rule_id}/unpublish`
+    - `POST /api/v1/review-rules/{rule_id}/rollback`
+  - 规则发布前会校验 `rule_code` 对应的 `review_risk_rule` 治理资产是否已进入可发布状态
+  - 规则回滚会生成新的规则版本，而不是覆盖历史内容
+- 已补齐规则页的基础治理动作：
+  - 列表显示 `rule_code` 和发布状态
+  - 管理员可在规则页直接执行“发布 / 下线”
+  - 规则存在多个版本时，支持直接执行“回滚”
+- 已完成 knowledge_bases 分支的边界确认：
+  - 当前 `ai-contract-platform` 侧的 `SharedAIPlatformClient` / SDK 只暴露 `list/create/documents/retry/sync-content`
+  - shared-ai Java 的 `PlatformKnowledgeController` 当前没有 publish / unpublish / rollback 端点
+  - 因此 knowledge_bases 发布链当前不是本仓库单边能收口的问题，而是 shared-ai 远端接口能力缺口
+
+### 本轮验证
+- 后端测试：
+  - `python -m unittest tests.test_review_rule_service tests.test_review_rules_api`
+  - 结果：`19 tests OK`
+- 后端编译：
+  - `python -m py_compile backend/app/services/review_rule_service.py backend/app/api/review_rules.py`
+  - 结果：通过
+- 前端检查：
+  - `npm --prefix frontend run lint`
+  - 结果：通过
+  - `npm --prefix frontend run build`
+  - 结果：通过，规则页构建正常
+
+### 当前状态更新
+- `GOV-API-007` 仍保持 `IN_PROGRESS`，但范围已经更清楚：
+  - 模板发布链：已完成
+  - 审查规则发布链：已完成
+  - 知识库发布链：未完成，当前阻塞在 shared-ai 远端缺 publish / unpublish / rollback 端点
+- 从正式生产放行角度看，规则这条线已经具备“治理资产批准 -> 规则发布/下线/回滚”的能力
+
+### 当前阻塞项
+- `knowledge_bases` 分支仍缺 shared-ai 远端配合：
+  - 需要在 shared-ai 平台补知识库状态更新 / 发布 / 下线 / 回滚端点
+  - `ai-contract-platform` 侧才能把 knowledge_bases 发布链真正收口
+- 正式生产放行继续阻塞在真人复核、证据 READY 和最终批准签署