Some checks failed
ci / build-test-parity (push) Has been cancelled
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.7 KiB
3.7 KiB
P3 阶段简报(Flowable 独立服务)
2026-06-11 | 计划排期「月 3.5–5,1.5–2.5 人月」| 四项全部交付,证据可复跑 交付形态确认:flowable-service.jar 成为四进程之二(nginx / eip4-platform.jar / flowable-service.jar / postgres)
一、完成项与证据
| # | 项 | 结果 | 证据 |
|---|---|---|---|
| P3-1 | flowable-service 独立服务 | 新可执行模块:Flowable 6.8.1 引擎(databaseSchemaUpdate=false 硬纪律)+ 双数据源(ACT_ 本地/业务组织客户库只读,生产单库分 schema 配置示意已附)+ 待办/已办/发起/办理/挂起/委托 REST;1,509 个真实流程定义加载无错;挂起拒办(409)/委托语义实证,数据净零变更 |
flowable-service/P3流程服务实测报告.md |
| P3-2 | 3 个表达式 handler 移植 | 原包名移植 + 依赖闭包裁剪(OSGi 间接→WfBeanRegistry;组织服务闭包→OrgDirectoryJdbc 窄接口直查 SQL,避免把保真层引擎拖进独立进程);真实表达式解析与客户库组织数据对照一致;待办口径对账 4=4/12=12 | 同上 |
| P3-3 | 升级工具链产品化 | 一键链(前置校验→版本串规范化→5.23→6.8.1→对账)幂等参数化;新鲜 5.13 副本完整重演:升级链 21 秒/含拉数 84 秒,对账全绿(含 109.7 万行历史);rehearsal 安全闸拒指 eip4flow | tools/flowable-upgrade/;docs/P3-Flowable升级/Flowable升级Runbook-v1.md |
| P3-4 | 网关聚合 + 事件回写 | FlowableClient(重试/熔断,引擎不可达 503 不崩单体);待办聚合拼业务摘要(无映射优雅降级);SYS_DATASTATUS 回写逐条对齐老系统 ProcessCoreServiceImpl(1 未提交/2 处理中/3 通过/4 未通过/5 重提交/6 作废;结束→3、未结束→2、oldstatus 单调守卫);聚合数与引擎直查一致、熔断实测、回写 1→3 实证 | platform-flow-gateway/P3网关实测报告.md |
二、关键发现
- scriptTask 担忧消除:5 个 scriptTask 全部是 Activiti Explorer 演示/报表流程(
org/activiti/explorer/demo/...),非客户业务流,休眠且零库写——P3 计划的核对项以"无需迁移"结案。 - 候选人解析类型真实分布(4,761 处表达式普查):position 1,949 / user 1,683 / formSpecifiedDimension 601 / projectRoleType 528 / 其余 70。SQL 可解析类型覆盖 ~91%;降级带 WARN 的缺口:projectRoleType 528 处(项目角色维度,建筑行业定制)+ scriptUser 26 / initiatorDepartManager 24 / fixedDimension 12 / sameToTask 5——P4/切流前必须闭环 projectRoleType(量级最大),已登记。
- 升级窗口实测:21 秒(数据量=运行时全量+bytearray 引用过滤 9.1 万行口径);生产全量 bytearray 1.2GB 的差额外推见 Runbook——Flowable 升级停机窗口远小于 PG 升级,分窗执行无压力。
- Flowable 6.8.1
TaskInfo无getBusinessKey()(§6.8)等 6 个新坑入手册(§6.4–6.9)。
三、数据变更登记(本地迁移副本 eip4flow)
- 挂起/激活、委托:净零(已恢复)
- 1 条真实 complete(实例 20334081,P3-4 回写验证需流程真实结束)——本地副本,客户库全程零写入
四、遗留与去向
| 事项 | 去向 |
|---|---|
| projectRoleType 候选解析(528 处) | P4 前专项:侦察项目角色维度数据模型后补 OrgDirectoryJdbc 实现 |
| scriptUser(26)/sameToTask(5) 等长尾类型 | 切流前按实际使用频率逐个补 |
| 待办聚合性能(businessKey 逐条 loadPOJO) | 上量后批量化(C3 口径复测) |
| Flowable 升级生产执行 | 切流期专用窗口,与 PG 升级分窗 |
五、累计口径(M0+P1+P2+P3)
- 模块:8 → 10(新增 flowable-service、platform-flow-gateway 实装)
- 单测:190+ → 240+ 全绿;ArchUnit 全程未破
- 迁移手册:§6.9(P3 新增 6 坑);git 累计 35+ 提交