Files
eip4-platform/docs/P1/P3阶段简报.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 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>
2026-06-17 14:53:29 +08:00

3.7 KiB
Raw Blame History

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

二、关键发现

  1. scriptTask 担忧消除:5 个 scriptTask 全部是 Activiti Explorer 演示/报表流程(org/activiti/explorer/demo/...),非客户业务流,休眠且零库写——P3 计划的核对项以"无需迁移"结案。
  2. 候选人解析类型真实分布(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(量级最大),已登记。
  3. 升级窗口实测:21 秒(数据量=运行时全量+bytearray 引用过滤 9.1 万行口径);生产全量 bytearray 1.2GB 的差额外推见 Runbook——Flowable 升级停机窗口远小于 PG 升级,分窗执行无压力。
  4. 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+ 提交