P2_WP07_UNIFIED_WORK_CENTER.md 4.8 KB
P2-WP07 统一审批、任务与通知工程说明
1. 完成范围
P2-WP07 已完成本地工程实现和定向验证。平台新增一个薄的统一工作中心，用同一任务 契约承载质量问题、术语标准、数据产品和 Agent 审批，并保持各源模块的业务状态机不变。
本工作包完成：
- 通用流程草稿、不可变修订和发布，支持结构化条件路由；
- 单人审批、或签、会签、双人复核、最小同意数和审批人转签；
- 四类事项统一待办、用户参与范围过滤、乐观版本和活动源事项幂等；
- 治理工单评论、附件证据索引、处理时间线、关闭和重开；
- 站内消息、邮件模板、用户渠道/事件偏好、送达状态、指数退避重试和死信；
- 待办数、逾期数、关闭数、闭环率、业务类型分布和 30 天趋势；
- 首页“待处理审核”组件接入真实待办统计，数据审核菜单新增统一工作中心。
2. 边界与源模块接入
统一工作中心不是新的通用流程引擎。质量问题、语义资产、数据产品/订单和治理 Agent
仍由各自模块决定业务状态。四类事项通过 subject_type + subject_uid + source_type +
source_uid 接入同一个任务创建契约；同一个未关闭源事项只能存在一条活动任务。
审批、关闭、重开和超时处理只更新统一任务并追加时间线，同时写出
governance.task.evidence.recorded outbox 事件。源模块可在自己的权限、责任和状态门禁内
消费该回执；工作中心显式保存 source_state_unchanged=true，不会直接把统一任务结果
写成源对象状态。该约束避免质量、术语、产品和 Agent 各自再复制一套审批状态机。
3. 流程、并发与审计
迁移 20260802_430 新增流程、任务、协作、通知和送达尝试共 12 张表。流程路由只接受
业务域、风险、敏感等级、环境和金额五类结构化条件以及 eq/in/gte/lte 运算，不执行
脚本。任务在创建时固定流程版本和路由快照，后续流程修订不改写历史任务。
任务状态更新要求 If-Match 当前版本；审批、转签、关闭、重开、超时升级和超时关闭
均追加带前后快照的审计事件。双人复核至少需要两名独立审批人，创建人不能自审。评论、
附件和任务详情只对创建人、当前处理人、参与人或管理员可见，普通用户不能通过任务编号
旁路读取或操作其他人的事项。
4. 通知与运营视图
站内消息在事务内直接形成已送达记录；邮件进入待投递队列。投递批次使用跳过锁定领取，
失败错误先脱敏，再按指数退避重试；达到最大次数后进入死信。邮件模板支持任务编号、标题
和描述占位符。用户可以关闭渠道或限定订阅事件，被过滤的消息保存为 suppressed，而不是
静默丢弃。
SMTP 只在 DATAOPS_SMTP_HOST、DATAOPS_SMTP_FROM、端口和可选登录信息完成绑定后发送。
当前用户目录没有独立邮件字段，测试绑定使用符合邮件格式的用户名；企业实施必须改为正式
身份目录邮件属性并完成送达 UAT。平台未接入企业微信、飞书、钉钉或 ITSM。
统一工作台展示我的待办、消息、流程和模板，以及任务总数、待办、逾期和闭环率。统计来自 持久化任务，不以页面缓存或模拟数据代替。
5. 权限与接口
governance:work-center:read：查看本人相关待办、消息、流程摘要和运营统计；governance:work-center:operate：创建事项、审批、转签、评论、附件、关闭/重开和偏好；governance:work-center:manage：流程/模板管理、全局任务视图、超时批次和邮件投递。
OpenAPI 已由当前源码重新生成，共 334 个操作，其中统一工作中心提供 16 个路由路径，覆盖 流程、任务、协作、通知、模板、偏好、超时和看板。
6. 定向验证与剩余门禁
本工作包按约束只运行本次变动相关验证：
- 核心、API、权限、迁移和前端契约；
- 本次 Python 文件 Ruff 和前端改动文件 ESLint；
- 本地 PostgreSQL 从
20260731_400实际升级到20260802_430； - PostgreSQL 中创建并发布流程，生成四类统一任务，完成审批、关闭、审计、outbox、模板、 用户偏好、抑制和邮件失败重试验证；
- OpenAPI 可重复生成和发布目录源码同步后的一致性检查。
正式生产就绪仍需：绑定企业身份目录邮件属性和 SMTP；配置正式流程、参与人、期限与定时 调度；由质量、语义、产品和 Agent 各源模块消费任务回执；完成四类真实事项端到端 UAT、 容量与告警验证。以上完成前，本地工程完成不等同于企业验收或生产就绪。