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

41 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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+ 提交