docs: add governance productization backlog

2026-05-02 21:34:11 +08:00
parent 36ae650621
commit 23a27b9482
3 changed files with 199 additions and 0 deletions
@@ -0,0 +1,24 @@
+batch,priority,area,task_id,title,current_gap,target_deliverable,depends_on,acceptance,status
+5A,P0,database,GOV-DB-001,新增治理资产总表,模板规则知识卡条款资料等分散在不同表和CSV中没有统一治理主键,新增 governance_assets 表并支持 asset_type + asset_id + tenant_id 统一索引,none,系统可查询一条资产当前治理状态和来源,PLANNED
+5A,P0,database,GOV-DB-002,新增复核分配表,当前没有系统内真实法务业务运营最终批准人的任务分配,新增 governance_review_assignments 表支持角色分配截止日期和状态,GOV-DB-001,系统可按角色和状态查询待复核任务,PLANNED
+5A,P0,database,GOV-DB-003,新增复核决议表,当前复核结论只存在CSV回填模板中,新增 governance_review_decisions 表支持 approved rejected changes_required 等结果,GOV-DB-001;GOV-DB-002,系统可记录多次复核历史和最新有效结论,PLANNED
+5A,P0,database,GOV-DB-004,新增证据登记表,当前证据路径和证据状态只存在文档与脚本规则中,新增 governance_evidences 表支持 file_id url status checksum reviewer metadata,GOV-DB-001,系统可校验证据是否存在且不是模板占位,PLANNED
+5A,P0,database,GOV-DB-005,新增发布批次与门禁结果表,当前上线批准状态只存在 PowerShell 产物中,新增 governance_release_batches 和 governance_gate_runs 表,GOV-DB-001;GOV-DB-003;GOV-DB-004,系统可追踪一次发布批次的门禁快照和结果,PLANNED
+5A,P1,database,GOV-DB-006,模板表补治理字段,contract_templates 只有内容和启停没有版本与发布元数据,为 contract_templates 增加 template_code version published_at published_by latest_governance_asset_id,GOV-DB-001,模板可区分草稿版和生产发布版,PLANNED
+5A,P1,database,GOV-DB-007,知识库文档表补法源元数据,知识库文档缺少效力级别生效日期发文机关和法源类型,为知识库相关表增加 source_type authority effective_date region tags,none,知识库可按法源维度治理和过滤,PLANNED
+5B,P0,backend_api,GOV-API-001,新增治理资产列表接口,当前没有统一治理视图接口,新增 /governance/assets 列表筛选汇总接口,GOV-DB-001,前端可按资产类型状态角色查看治理资产,PLANNED
+5B,P0,backend_api,GOV-API-002,新增复核分配接口,当前无法在系统内分配真实复核人,新增 /governance/assignments 创建更新撤销接口,GOV-DB-002,管理员可在系统内完成复核任务分配,PLANNED
+5B,P0,backend_api,GOV-API-003,新增复核回填接口,当前复核结论只能通过CSV和脚本回填,新增 /governance/decisions 提交接口和批量导入接口,GOV-DB-003,真实复核人或管理员可提交复核结果,PLANNED
+5B,P0,backend_api,GOV-API-004,新增证据上传绑定接口,当前系统没有专门的治理证据绑定接口,新增 /governance/evidences 上传绑定替换校验接口,GOV-DB-004,系统可阻止模板证据进入已批准状态,PLANNED
+5B,P0,backend_api,GOV-API-005,新增上线批准汇总接口,当前没有系统内 release approval summary,新增 /governance/releases/summary 和 /governance/releases/{id} 接口,GOV-DB-005,前端可直接展示当前上线阻断项与通过项,PLANNED
+5B,P0,backend_api,GOV-API-006,新增CSV台账导入接口,当前正式上线台账只靠仓库脚本导入,新增 /governance/imports/formal-launch 接口读取既有 CSV 映射到治理表,GOV-DB-001;GOV-DB-002;GOV-DB-003;GOV-DB-004,旧台账可一次性导入数据库且保留来源信息,PLANNED
+5B,P1,backend_api,GOV-API-007,模板规则知识库发布接口,当前内容模块没有生产发布动作,为 templates review-rules knowledge-bases 增加 publish/unpublish/rollback 接口,GOV-DB-005;GOV-DB-006,已批准资产才能被发布到生产可用集合,PLANNED
+5C,P0,frontend,GOV-WEB-001,新增复核总控中心页面,当前没有统一治理控制台,新增 /governance 页面展示资产统计阻断项角色视图和发布批次,GOV-API-001;GOV-API-005,管理员可在单页看到当前正式上线治理全貌,PLANNED
+5C,P0,frontend,GOV-WEB-002,新增复核人工作台页面,当前真实法务业务运营没有系统内待办页,新增 /governance/workbench 页面支持按角色查看待处理任务,GOV-API-001;GOV-API-002;GOV-API-003,复核人可只看到与自己相关的任务包,PLANNED
+5C,P0,frontend,GOV-WEB-003,新增资产详情与证据页,当前无法在系统内查看单资产的签署链和证据链,新增治理资产详情页和证据面板,GOV-API-001;GOV-API-003;GOV-API-004,可在页面内查看每个资产的复核记录和证据状态,PLANNED
+5C,P0,frontend,GOV-WEB-004,新增上线批准页,当前没有正式上线批准人的系统内操作页,新增 /governance/releases 页面展示 gate summary 和 final approval checklist,GOV-API-005,上线批准人可在系统内完成最终批准或驳回,PLANNED
+5C,P1,frontend,GOV-WEB-005,新增台账导入与同步页,当前 CSV 导入完全依赖脚本,新增导入中心页面支持预览导入差异和执行导入,GOV-API-006,管理员可在Web端完成台账同步,PLANNED
+5D,P0,integration,GOV-INT-001,实现现有 formal-launch 台账到数据库的首轮回填,当前历史台账和协作包仍是仓库真相源,编写一次性 backfill 脚本和映射规则,GOV-API-006,数据库中出现与当前 CSV 对齐的治理资产和复核任务,PLANNED
+5D,P0,integration,GOV-INT-002,门禁脚本增加数据库读模式,当前上线门禁只读 project-docs CSV 和 md,为 run-formal-launch-approval-gate.ps1 增加优先读数据库的模式,GOV-DB-005;GOV-API-005;GOV-INT-001,门禁可同时校验系统内治理状态和历史兼容输入,PLANNED
+5D,P1,integration,GOV-INT-003,正式上线资料包与文件中心打通,当前用户协议隐私政策免责声明等资料只存在 docs,将生产资料包纳入系统文件中心并绑定治理资产,GOV-DB-001;GOV-API-004,资料包可在系统内查看版本和签署状态,PLANNED
+5D,P1,integration,GOV-INT-004,权限与审计补齐,当前治理动作权限模型不完整,为治理域增加权限点和审计事件定义,GOV-API-002;GOV-API-003;GOV-API-004;GOV-API-005,所有治理关键动作都可审计可追责,PLANNED
@@ -0,0 +1,74 @@
+# 正式上线运营准备阶段第五批执行记录（2026-05-02）
+
+## 本批目标
+
+本批执行“治理能力产品化改造清单”。
+
+目标是把前四批形成的仓库级正式上线治理闭环，拆解成后续真正要改代码的数据库、接口、页面和迁移任务。
+
+## 结论
+
+当前系统与现有流程方案是兼容的，但兼容方式仍然是“系统主流程正常运行，治理流程由仓库文档与脚本承接”。
+
+也就是说：
+
+- 现在不会因为这些文档和门禁而把系统跑坏。
+- 但如果要让系统自己承接复核、签署、证据、上线批准，就必须继续改代码。
+
+## 当前发现的核心缺口
+
+### 数据模型缺口
+
+- 审查任务表没有真实复核人、签署结论、证据路径、上线批准等字段。
+- 模板表没有法务批准、业务批准、生产发布版本等治理字段。
+- 知识库表没有正式生产治理状态、证据和签署链。
+
+### 接口缺口
+
+- 模板、规则、知识库接口以 CRUD 为主，没有治理接口。
+- 没有复核分配、复核回填、证据绑定、上线批准汇总接口。
+
+### 页面缺口
+
+- 没有复核总控中心。
+- 没有复核人工作台。
+- 没有证据页。
+- 没有上线批准页。
+
+## 新增交付物
+
+新增清单：
+
+`project-docs/formal-launch-ops/governance-productization-backlog.csv`
+
+该清单按四个域拆解任务：
+
+1. 数据库。
+2. 后端接口。
+3. 前端页面。
+4. 迁移与门禁集成。
+
+每条任务都包含：
+
+- 任务编号。
+- 优先级。
+- 当前缺口。
+- 目标交付物。
+- 依赖关系。
+- 验收标准。
+
+## 当前建议的开发顺序
+
+建议按以下顺序进入实现，而不是同时铺开：
+
+1. P0 数据库治理域。
+2. P0 后端治理接口。
+3. P0 前端复核总控中心。
+4. CSV 到数据库的导入与回填。
+5. 上线批准门禁切换到数据库读模型。
+
+## 当前结论
+
+第五批没有修改系统业务代码，而是把“必须改哪些代码”梳理成了清晰的实施清单。
+
+这样做的好处是，后续每一轮开发都能直接对着 backlog 落地，不会再出现“流程写在文档里，系统却不知道这些流程存在”的割裂状态。
@@ -0,0 +1,101 @@
+# AI合同平台 正式上线运营准备阶段第五批方案（2026-05-02）
+
+## 阶段定位
+
+第五批命名为“治理能力产品化改造清单”。
+
+前四批已经把正式上线前的真实复核、签署、证据和发布门禁做成了仓库级闭环，但这些能力目前主要存在于 `project-docs/` 和 `scripts/` 中，还没有完全沉淀为系统内的产品能力。
+
+第五批的目标不是继续扩展文档，而是把“哪些地方必须改代码”一次性梳理清楚，形成后续可直接进入开发的数据库、接口、页面任务清单。
+
+## 当前系统现状
+
+系统已经具备以下业务模块：
+
+- 合同审查任务与报告。
+- 知识库管理。
+- 审查规则管理。
+- 模板管理。
+
+但当前系统内的这些模块更偏“内容维护”和“业务处理”，还不是“正式上线治理中心”。例如：
+
+- 审查任务模型只描述合同审查过程，不描述法务签署、业务签署、证据留存和上线批准。
+- 模板、规则、知识库模型可以维护内容，但没有正式生产发布生命周期。
+- 前端页面能管理模板、规则、知识库和审查记录，但没有“复核总控中心”“证据中心”“上线批准中心”。
+- 当前真实复核、签署、协作包和门禁主要依赖 CSV、Markdown 和 PowerShell 脚本。
+
+## 改造原则
+
+1. 不把现有合同审查主流程打碎。
+2. 不把“正式上线治理”硬塞进 `review_tasks` 这类运行态表中。
+3. 用独立治理域承接复核、签署、证据和放行。
+4. 保留现有仓库脚本作为迁移期工具，但把数据库逐步变成系统内真相源。
+5. 先做 P0 最小闭环，再做 P1 增强和 P2 优化。
+
+## 产品化目标
+
+治理能力产品化后的系统应当回答四个问题：
+
+1. 当前有哪些资产可以被治理。
+2. 每个资产现在在哪个复核状态。
+3. 真实法务、业务、运营、最终批准人分别是谁，是否已经给出结论。
+4. 当前版本是否允许正式上线。
+
+## 必须改造的能力域
+
+### 1. 数据库域
+
+需要新增独立治理表，而不是直接复用现有审查任务表：
+
+- 治理资产总表：统一表示模板、规则、知识卡、条款、资料、生成样本等。
+- 复核分配表：表示法务、业务、运营、最终批准人的任务分配。
+- 复核决议表：记录每次真实复核结论、意见、日期和责任人。
+- 证据登记表：记录证据文件、证据链接、证据状态。
+- 发布批次与门禁结果表：记录一次正式上线批准的批次快照。
+
+### 2. 后端接口域
+
+需要补齐：
+
+- 治理资产查询与筛选接口。
+- 复核任务分配接口。
+- 复核结论提交接口。
+- 证据上传与绑定接口。
+- 发布批准汇总接口。
+- CSV/文档台账导入接口。
+
+### 3. 前端页面域
+
+需要新增：
+
+- 复核总控中心页面。
+- 复核人工作台页面。
+- 资产详情与证据页。
+- 上线批准页。
+- 台账导入与同步页。
+
+### 4. 迁移与兼容域
+
+需要保证：
+
+- 现有 `project-docs/formal-launch-ops/` 台账可以导入数据库。
+- 现有门禁脚本在过渡期可以继续使用。
+- 系统前后端上线后，脚本门禁可以逐步从“只读 CSV”切换为“优先读数据库”。
+
+## 交付物
+
+本批生成：
+
+- `project-docs/formal-launch-ops/governance-productization-backlog.csv`
+- `project-docs/正式上线运营准备阶段第五批执行记录-2026-05-02.md`
+
+该清单会把数据库、接口、页面、迁移和集成任务拆成一批可开发任务，直接承接下一轮实施。
+
+## 下一步建议
+
+第五批完成后，最自然的实现顺序是：
+
+1. 先做数据库治理域建模与迁移。
+2. 再做后端治理接口和 CSV 回填导入。
+3. 然后做前端复核总控中心与复核人工作台。
+4. 最后把门禁脚本切到数据库驱动模式。