Commit Graph

29 Commits

Author SHA1 Message Date
f0d704d1b9 feat(flow+gateway): 草稿删除端点 DELETE /models/{id}(超管门)
补前端 T2.5 已按占位契约做好测试的草稿删除两层端点:

flowable-service ProcessModelController:DELETE /api/flow/models/{id}——先 getModel 判 null→404
{status:1,msg};存在则 deleteModel(id)(连带 editorSource/metaInfo 一并删)→{status:0}。

网关:FlowableClient +deleteModel(id)(id 走 uri 变量严格编码,DELETE 无既有封装→照 put 补私有
delete() 助手,无请求体,幂等重试安全);ProcessModelerController +DELETE /api/workflow/models/{id}
过 requireSuperAdmin 门后透传,{status:0} 原样回(对齐前端 deleteDraft 只判成功),下游 404 经既有
FlowGatewayExceptionHandler 透传。

测试(严格 TDD,均先红后绿):
- flowable ProcessModelControllerTest 14→16(删存在的 verify deleteModel 调 1 次/删不存在 404 verify 零删)
- gateway FlowableClientTest 18→20(DELETE 按 id 透传/下游 404 透传 FlowRemote 不重试)
- gateway ProcessModelerControllerTest 21→23(超管 200 透传+非超管 403 门拦下游恰调 1 次/404 胶水经 handler 出 FLOW_REMOTE_ERROR)
两模块 mvn -pl flowable-service,platform-flow-gateway -am test 全绿,BUILD SUCCESS,既有测试零改动。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:21:05 +08:00
653866c852 fix(gateway): T2.2 评审小项——幂等注释/降级标记/PUT胶水测试
M-1(javadoc):FlowableClient put()/post() 点破幂等性差别——PUT 覆盖写幂等,execute 连接级重试安全;
POST 非幂等,重试存在重复创建窗口,接受理由=草稿廉价可覆盖(非不可逆副作用)+本地同机链路瞬时故障概率极低,
语义级 4xx/5xx 绝不重试故无此窗口。
M-2(一行):wftemplates 读库异常降级分支返回 {templates:[],degraded:true},正常路径不带 degraded 键;
测试两分支各断言(正常 doesNotContainKey degraded / 降级 containsEntry degraded=true)。
M-3(胶水):照 glueMvc 补 PUT /api/workflow/models/{id} MockMvc 路由层测试(PUT 谓词匹配+@PathVariable
绑定 id=m1+200 透传)。

测试:ProcessModelerControllerTest 20→21(+PUT 胶水),FlowableClientTest 18(M-1 纯注释不加测试)。
platform-flow-gateway 全模块绿,BUILD SUCCESS,既有测试零改动。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:01:18 +08:00
b489f3d834 feat(gateway): models 五端点转发(requireSuperAdmin 统一门)+wftemplates picker 数据源
阶段 2 网关侧(对齐 flowable-service T2.1 ProcessModelController 契约):

FlowableClient +5 方法:listModels/getModel/createModel/updateModel/modelFromProcDef,
全 uri 模板变量严格编码(禁字符串拼接);RestClient 无 PUT 封装 → 照 post 补私有 put()
(uriTemplate+uriVars 严格编码);连接级重试 + 4xx/5xx 透传语义复用既有 execute。

ProcessModelerController:抽 requireSuperAdmin(principal) 私有方法(超管返 null,非超管/无身份
返 403 {status:1,msg:"仅系统管理员可用"}),既有两个 source 端点改用它(行为零变,既有 10 测试零改动);
新增五端点 GET /models、GET /models/{id}、POST /models、PUT /models/{id}、POST /models/from-procdef
全部先过门再转发 FlowableClient,返回体原样透传。

GET /api/workflow/wftemplates(同门):formKey 选择器数据源。
**information_schema 实证**:view_wftemplate 无独立名称列(仅 view_wftemplate_id CHAR + xml +
isactive + 审计列),<form> 根标签也无 title/name 属性(0/1016);唯一人类可读名来自 XML 的
entityid → sys_entity.name(378/1016 带 entityid,339 解析出中文名如「通知管理」)。故
name = entityid 解析出的实体名(LEFT JOIN + substring 正则抽 entityid),空则回退 id;
view_wftemplate_id 是 CHAR 补白 → RowMapper trim;isactive=1 过滤;读库异常降级空列表不 500。

测试:FlowableClientTest 12→18(+list/get/create/update/from-procdef body 透传+4xx 透传);
ProcessModelerControllerTest 10→20(五端点各 admin 200 透传+非超管 403 门拦下游 恰调 1 次证明门生效、
无身份 403、422 胶水经 FlowGatewayExceptionHandler 出 FLOW_REMOTE_ERROR、wftemplates 超管 trim 补白+
无名回退 id、非超管 403 零读库、读库异常降级空列表)。platform-flow-gateway 全模块 98 测试绿、
上游 493 测试绿,BUILD SUCCESS,既有测试零改动。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:48:30 +08:00
ddaf536419 test(gateway+auth): T1.6 评审收口(I-1 胶水测试/M-2 空 userId/M-1 时效性注释)
- I-1(合 main 前必须):ProcessModelerControllerTest 补 4 个 MockMvc 胶水测试
  (standaloneSetup + setControllerAdvice(FlowGatewayExceptionHandler) + 自定义超管参数解析器)——
  by-id/by-key 各:①引擎不可达经既有 handler 出 503 通用信封(FlowGatewayExceptionHandler 全仓首测)
  ②正常路径 200 透传 ③MVC 层把 percent 编码中文 path variable(含冒号 procDefId)正确解码回原串交控制器。
- M-2:EngineContextBinderAdminTest 补「userId 空串/空白/null 且 account 非 admin → false」用例。
- M-1:EngineContextBinder.isSystemAdmin javadoc 补时效性说明(userId/account 取自 JWT claim 签发快照,
  非实时查库;token 有效期内 admin 改名/停用/降权不即时生效,由 TTL/吊销兜底)。

测试(mvn -pl platform-flow-gateway,platform-auth -am test 全绿,既有零修改):
ProcessModelerControllerTest 6→10 / EngineContextBinderAdminTest 8→9 / FlowableClientTest 12 不变。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:03:59 +08:00
9cfef7e931 feat(flow+gateway): by-key 取最新版源 XML(修 process-select options=model 语义缺口)
live 验收发现:/api/process-select/options 在本库 143 项全部 source='model',
option.id=act_re_model id(非 procDefId)→ by-id source 端点永远 found:false;
option.key 才是真流程 key。补 by-key 姊妹端点,打开器改用 key 载入。

- flowable-service ProcessDiagramController:
  + GET /api/flow/process-definitions/by-key/{key}/source
    (processDefinitionKey(key).latestVersion().singleResult(),null→found:false)。
  by-id 与 by-key 逻辑抽共享私有 sourceResponse(procDefId, def),不复制粘贴;
  by-id 行为不变(仍以入参 procDefId 读部署 BPMN,既有 7 测试零修改)。
- 网关:FlowableClient.procDefSourceByKey(key)(uri 变量严格编码,禁拼接)
  + ProcessModelerController GET /api/workflow/process-definitions/by-key/{key}/source
    (同超管门,非超管 403)。by-id/by-key 段数不同无路由歧义。

测试(mvn -pl flowable-service,platform-flow-gateway,platform-auth -am test 全绿,既有零修改):
- ProcessDiagramControllerTest 7→9(+2:by-key 命中取最新版 v2 净化XML+idMap / key 不存在 found:false)
- FlowableClientTest 11→12(+1:纯中文 key「总包合同交底」uri 变量严格编码,断言 %E6%80%BB 且无裸中文)
- ProcessModelerControllerTest 4→6(+2:by-key 超管 200 透传 / 非超管 403 不触发下游)
- 三模块 Reactor 均 SUCCESS。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:59:04 +08:00
6d16206a08 feat(gateway): Modeler source 转发+超管门(中文 procDefId 编码硬验收)
阶段1 T1.6 代码部分:流程 Modeler 存量源 XML 经网关超管门载入。

- FlowableClient.procDefSource(procDefId):转发 GET /api/flow/process-definitions/{id}/source,
  procDefId 作为 uri 变量由 RestClient 严格编码(中文 percent、冒号→%3A),绝不字符串拼 URL(M-2)。
  走既有 execute() 重试/降级封装(连接级重试→503,4xx/5xx 透传)。
- ProcessModelerController GET /api/workflow/process-definitions/{procDefId}/source:
  超管门(EngineContextBinder.isSystemAdmin,非超管 403 {status:1,msg:"仅系统管理员可用"}),
  过门后透传下游返回体。flowable-service 裸 8089 无安全栈,超管门唯一落点在网关。
- EngineContextBinder.isSystemAdmin 由 private 提升为 public static + null 安全,供网关复用;
  判定口径不变(ADMIN 大小写不敏感去补白 / account 大小写敏感=admin / 含 admin 字样不误判)。

测试(mvn -pl platform-flow-gateway,platform-auth -am test 全绿,既有测试零修改):
- FlowableClientTest +2:中文 procDefId「总包合同交底:3:abc123」uri 变量严格编码(断言 %3A 且无裸中文)
  / 下游 4xx 透传 FlowRemoteException 不重试。共 11。
- ProcessModelerControllerTest 4:超管 200 透传 / 非超管 403 不触发下游 / 无身份 403 / 引擎不可达上抛。
- EngineContextBinderAdminTest 8:ADMIN 大小写·补白 / account=admin / Admin 变体不提权 / 含 admin 普通用户 / null。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:47:00 +08:00
0d952acc00 fix(approval): approve 默认记「同意」审批意见,供报表审批段显示
approve 原只在审批人手填意见时才写 act_hi_comment,且无默认前缀。报表审批段按 message LIKE '同意%' 匹配,故不填意见的审批在报表不显示。新增 agreeComment():空→"同意",有意见→"同意:意见",已带「同意」→原样,保证恒以「同意」开头。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:42 +08:00
aae418653e fix(approval): WfTemplate XML 解析钉到 JDK 解析器,绕开 report 带入的上古 xerces
platform-report(jatools)依赖 com.dsasp.thirdparty:xerces:eip3(2004),被打进 platform-app
fat jar 后,classpath 发现机制让 DocumentBuilderFactory.newInstance() 选中它;该古董不实现
JAXP 1.4 的 setFeature → AbstractMethodError,击穿 gateway 全部 WfTemplate XML 解析
(approval-meta 对任何带 formKey 的审批任务 500,影响 approve/reject 按钮解析+会签进度)。

修法:WfTemplateService.parseXml 显式指定 JDK 内置实现
com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl(总在,实现 setFeature),
不删/不动 report 的 xerces。极端兜底回退默认发现。

live:修复后 gateway approval-meta 正常返回 buttonsSource=wftemplate;会签进度 0/3→1/3 实时更新。
(另记:platform-metadata DataImportExcelParser 同样 newInstance(),数据导入路径同病,另案。)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:21:41 +08:00
5c4894d40a feat(approval): 会签进度("已会签 N/M") — approval-context 多实例计数
- ApprovalContextDto(flowable + gateway)加 cosign/cosignTotal/cosignCompleted
- FlowController.approvalContext: fillCosign 沿执行树向上找带 nrOfInstances 的
  多实例根执行,读 nrOfInstances/nrOfCompletedInstances 回填
- gateway ApprovalController.approvalMeta 透传 cosign 字段
- 单测 FlowControllerTest 会签进度回填(22 绿);live(8089)实证 cosign:true 0/2

注:gateway 端 cosign 展示当前被 platform-report 引入的上古 xerces-eip3.jar(2004)
击穿 WfTemplate XML 解析所阻(AbstractMethodError on DocumentBuilderFactory.setFeature,
影响全部 approve/reject 按钮解析,非本改动引入,需在 report 模块侧隔离/排除该 xerces)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:19:09 +08:00
4f9e4abfc2 feat(approval): 审批闭环 P0/流程图/会签 — 协办转阅+BPMN图+scriptUser会签
承接 WfTemplate 数据驱动审批主链路(approve/reject/reback/agent 已 live),补齐缺口:

P0 协办(assist)/转阅(circulated):
- flowable-service 新增 POST /tasks/{id}/assist、/circulate(对齐老 ProcessCoreServiceImpl
  createSubTask/createNewTask:每人建独立任务,父任务记意见,不阻断主流程)
- gateway FlowableClient.assist/circulate + ApprovalController 把 assist/circulated 从 400 改真实分派
- 前端 ApprovalDrawer 多选人弹窗 MultiUserForm
- 对抗审查修复:独立任务沿 parentTaskId 回溯父任务取 businessKey/formKey(否则协办/转阅人
  看不到业务单据,且 processInstanceId(null) 崩 500);assist 父任务 404 守卫;MAX_FANOUT=50;
  @Transactional;转阅改 setFormKey 而非 description

P1 BPMN 流程图查看:
- flowable-service 新 ProcessDiagramController GET /process/{pi}/diagram
  (bpmnXml + 当前/历史活动节点,运行/历史双路取 procDefId,只读)
- gateway FlowableClient.diagram + TodoController 转发
- 前端 bpmn-js 渲染(中文走浏览器字体,当前节点绿/已走过灰),ApprovalDrawer 按需展开

P3 会签(BPMN 多实例):移植 CandidateUsersHandler 的 scriptUser(JUEL)候选人解析分支
(原"精简边界"WARN 降级,致招投标/总包合同/施工技术交底等用 ${APPLYUSERS} 的会签节点被跳过):
单变量直读流程变量 + 复杂表达式回退 flowable 表达式管理器 + 结果归一为去重 userId 列表

测试:flowable-service 56 + gateway 全模块 全绿;前端 tsc 干净 + vitest 83/83 + build。
live e2e(真 eip4flow):协办/转阅各 count:1 且子任务回溯出 businessKey/进目标用户待办;
流程图真 DI 实例渲染;会签起 3 并行任务/全票聚合推进。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:09:12 +08:00
fa3c92b698 chore(A10 W1): 收敛重复 bootstrap,db/migration 成平台表 DDL 单一真相
W1 引入 db/migration/V1-V3 后,平台表 DDL 在迁移与各模块 bootstrap-*.sql 重复
(评审揪出的"易漂移")。本次收敛,db/migration 成唯一真相:

- 删 3 份重复 bootstrap:bootstrap-page-schema(=V1)/bootstrap-datastatus(=V2)/
  bootstrap-ai-agent(=V3)。三者无运行态 classpath 消费者(已全仓核实)。
- AiAgentDdlTest(platform-ai,原读 bootstrap-ai-agent.sql)删除,等价覆盖迁入
  platform-app 新增 PlatformMigrationDdlGuardTest:① 守 V3 声明全部 AI 平台表/索引;
  ② 守 SchemaImportCli.CREATE_DDL ≡ V1(独立 CLI 兜底 DDL 防漂移)。
- SchemaImportCli.CREATE_DDL 由包私有改 public 供上述 guard 比对;两处过时注释改指 V1。
- ci.sh 平台表预灌改指 db/migration/V1(注:app 启动 Flyway 已幂等建表,此预灌仅冗余兜底)。
- docs 对齐:AI_AGENT_AUTO_DEVELOPMENT(spring.sql.init→Flyway)、docs/sql/SYS_PAGE_SCHEMA
  /SYS_AI_AGENT 头注释(待办→已落地)、A10 design 残留收敛标完成、deploy/README 残留项标完成。

边界:platform-parity 的 bootstrap-{sys,privilege,auth,xservice,multidim,flow}.sql 是
eip3 schema 对拍测试 fixture,非平台表副本,原样保留。

验证:全 reactor mvn clean install 绿;PlatformMigrationDdlGuardTest 2/2;独立 code-reviewer
评审 GO(零 CRITICAL/HIGH/MEDIUM,含 guard substring 逻辑对真实 V1 仿真核实)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 15:16:35 +08:00
bc9ae8cf44 security(P0③ followup): 关 TodoController advanced-script 生产 RCE
/api/workflow/process/{id}/advanced-script 执行请求体 Groovy,原无 @Profile/无角色门=任意认证用户 prod RCE(独立安全评审揪出的 ScriptExecuteController 孪生)。注入 Environment + SecurityProfiles.isBypassActive 守卫:严格 profile 直接 amisFail 不执行脚本。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 11:41:21 +08:00
b6e6964913 fix framework p2 custom views 2026-06-18 15:35:17 +08:00
3523007f16 feat: add framework script editor actions
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 09:39:07 +08:00
a019af8e3a feat: wire process monitor actions 2026-06-18 09:02:54 +08:00
1d8a4fec60 feat: wire process form removal actions 2026-06-18 08:55:17 +08:00
61f31527bc feat: wire my started workflow tasks 2026-06-18 08:12:15 +08:00
21e3865dcf fix(platform): restore approval history drawer 2026-06-18 02:12:27 +08:00
57c3412aff fix(flow): restore workflow task converted pages 2026-06-17 20:44:52 +08:00
33fda4541d feat(approval): WfTemplate 数据驱动审批界面 + ApprovalDrawer + load/action 保真层执行
审批按钮/业务表单由 WfTemplate(view_wftemplate) 数据驱动取代写死。flowable-service 加 ApprovalContextDto + FormKeyResolver/StartFormKeyResolver(form_key 历史回补:运行任务经 (procDefId,taskDefKey) 查 act_hi_taskinst 回补)。flow-gateway 加 ApprovalController(审批上下文聚合)+WfTemplateService(模板按 buttonId 解析 servicename)+BusinessRecordLoader(直调 flowExcuteService 加载业务记录,4s 超时守护防挂死→loadPOJO 退化);action 按 buttonId 重解析 servicename 全字段执行。FlowController/FlowableClient/GatewayRequests/TodoController 接审批上下文与 reject/reback。WfTemplateServiceTest 覆盖。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 14:08:32 +08:00
8165b01874 修审批界面无法审批:候选人式审批任务在待办全不可见(dogfooding)
根因二连:
1) TodoAggregator candidateUser 传 null → 客户 BPMN 用 candidateUsers(候选人解析把当前用户
   设为候选用户、assignee 空)的任务全部漏查。改传 userId(我的待办=指派∪组候选∪用户候选)。
2) 保真层从 CHAR(36) 列取的短 user id(如 ADMIN)带空格补白,flowable taskCandidateUser 精确
   匹配不到 → 候选任务不可见。com.eip4 包装 TrimmingCandidateUsersHandler trim 候选 id(不改保真层)。
附:flowable-service start 命名流程未部署→回退默认审批(dev 无客户 BPMN 仍走通审批闭环)。
实证:真实通知提交审批→公司通知任务自动现身 admin 待办(UI 4 条,办理→同意可用)。TodoAggregatorTest 5 测。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 11:35:06 +08:00
93d86a0fb0 提交审批 dogfooding 修复:桥接清洗 joda 时间变量避免 Flowable 序列化崩
P4 写路径巡检(HR_HOLIDAYAPPLY_SUBMIT)揪到:业务变量含 org.joda.time.DateTime(BEGINTIME),
FlowableClient POST 时 Jackson 无 joda 模块→InvalidDefinitionException 起审批崩+泄露类名。
桥接 jsonSafeValue 反射检测 joda 时间类→epoch 毫秒(不引 joda 编译依赖)。集成重跑 status 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 10:24:06 +08:00
bc72f4724b 测试卫生:FlowableClientTest 待办断言对齐 F2-6 POST-body 契约
2 用例原断言 F2-6 前 GET-query(candidateGroup 逐个),现行 todo() 已 POST body→修正 mock 期望

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 02:03:51 +08:00
71c069289a 提交审批端到端:ProcessCoreServiceBridge 桥接 bean(零改保真层)
@Component(processCoreService) 引擎反射调,桥到 FlowableClient.start+StatusWriteback
运行时实证:OA_NOTICEMANAGE_SUBMIT→起真实 flowable 实例+SYS_DATASTATUS=PROCESSING(2)
唯缺客户审批 BPMN 部署(prerequisite①,属部署非代码)。4 单测含反射可解析性

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 02:03:51 +08:00
2dcc0c61bf F2-6: candidateGroup URL 膨胀修复 + 角色缓存失效钩子
- flowable-service: 新增 POST /api/flow/tasks/todo 端点(TodoRequest body),
  避免 ceshi 236 角色 × 36 字符拼 GET URL 超 8KB 限制
- FlowableClient.todo() 改用 POST body 传 candidateGroups,
  新增 post() ParameterizedTypeReference 重载支持 List 返回类型
- AdminWriteController: 注入 RoleResolver,用户组成员增减调 evict(userId),
  用户组角色增减/删除调 evictAll(),确保权限变更后缓存及时失效
- platform-metadata/pom.xml 加 platform-auth 依赖
- AdminWriteControllerTest 适配 RoleResolver mock 参数
2026-06-12 03:09:36 +08:00
6dbb205e94 F2-7: 审批办理 UI 后端——trace/delegate 端点增补
- flowable-service:新增 GET /api/flow/process/{id}/trace(历史任务节点+
  审批意见+结果,biz 库不可达时用户名 1s 超时降级),TraceNodeDto;
  biz 数据源加 connectionTimeout/socketTimeout 快速失败
- platform-flow-gateway:FlowableClient 增加 trace/delegate 方法;
  TodoController 增加 /api/flow/process/{id}/trace 和 /api/task/{id}/delegate
  网关透传端点;GatewayRequests.DelegateRequest;TraceNodeDto 镜像
- 单测:TraceAndDelegateTest 3 个(MockRestServiceServer),全套 34/34 通过
- application-dev.yml:eip4.flow.read-timeout-ms=60000 适配慢查询

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 23:09:11 +08:00
ba6e7559fa P4-6: platform-flow-gateway 待办→业务页映射(tablename→templateId→pageUrl)
- 侦察口径:sys_entity+view_templateentity+view_template 两步映射;
  多模板优先级 type=7(表单)>1(列表)>其余升序,同 type 按 templateid 字典序取首个
- 新建 PageTemplateService:findTemplateId() 查只读客户库,
  @Cacheable("pageTemplateByTable") Caffeine TTL=10min/maxSize=2000
- FlowGatewayConfig 启用 @EnableCaching + flowGatewayCacheManager(Caffeine)
- TodoItem 增加 pageTemplateId/pageUrl/pageUrlReason;
  查不到映射时 pageUrl=null+reason,前端据此禁用跳转(优雅降级)
- TodoAggregator 注入 PageTemplateService,aggregate 逐条 fillPageTemplate
- PageTemplateMappingTest 10 单测;TodoAggregatorTest 补 @Mock PageTemplateService
- 验证:真实用户(829cdcca)3 条待办带出 templateId=7042cb37(PM_SAFE_CLARIFICATION/安全技术交底),
  与客户库直查一致;全反应堆 31+ArchUnit 绿

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 16:52:50 +08:00
ac9812e0a1 P3-4: platform-flow-gateway 单体侧流程网关(Flowable REST 客户端 + 待办聚合 + 事件回写)
- FlowableClient:RestClient 调 flowable-service(eip4.flow.base-url,默认 8089);
  超时/重试(仅连接级)/熔断降级——引擎不可达 → 503 语义(非 500 堆栈),业务错 4xx/5xx 透传。
- 待办聚合(经 platform-app 暴露):GET /api/todo(JWT userId+roles 候选组)、GET /api/done、
  POST /api/task/{id}/complete、POST /api/process/start;聚合层把 Flowable 任务与业务摘要连接
  (businessKey → SYS_DATASTATUS.tablename → loadPOJO 只读标题字段;业务摘要数据源客户库只读,
  拼不到优雅降级为仅流程字段)。
- 事件回写:complete 后按老系统 ProcessCoreServiceImpl.passProcess + WfChangeStatus 语义更新
  SYS_DATASTATUS(结束→STATUS_PASS=3,未结束→STATUS_PROCESSING=2,守卫 oldstatus<status 单调递增;
  upsert UPDATE 命中或 0 行 INSERT);本地库验证,客户库只读。
- flowable-service 契约增强:Flowable 6.8.1 TaskInfo 无 getBusinessKey(),todo/done 出参由查询侧
  从实例补全 businessKey;新增 GET /api/flow/process/{id} 查实例(供办理后判定流程是否结束)。

验证(8089 连本地 eip4flow+客户库只读,8090 连本地 eip4m0,8084 未动):
- 待办聚合数=直查一致:真实用户 829cdcca /api/todo=4 == 8089 直查 count=4。
- 业务摘要拼接正确 + 优雅降级共存:命中条目拼到 SYS_USERGROUP 标题字段,同列表 3 条无映射降级为仅流程字段。
- 熔断:kill 8089 后 /api/todo 返回 503 干净 JSON,platform-app 进程存活不崩。
- 事件回写:本地构造 datastatus=1,经 8090 complete(流程结束)回写为 3;引擎侧实例确结束。
- 21 单测(客户端重试/降级、聚合拼接、回写守卫)+ 全模块 mvn test + ArchUnit 绿。

坑入手册 §6.8(TaskInfo 无 businessKey)/§6.9(503 熔断 + 回写守卫 + SYS_DATASTATUS 无主键)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 15:12:03 +08:00
a9219c5c77 chore: 落地 eip4-platform 多模块骨架基线(PoC→工程化)
从 eip4-poc 迁入双层制模块化单体:保真层 platform-legacy-core
(com.dsasp 引擎原样)+ 现代层 platform-metadata/auth/flow-gateway/
converter/ai + platform-app 启动器。ArchUnit 纪律固化(保真层禁依赖现代层)。
此为 C1 对拍工作的编译通过基线。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-10 23:40:51 +08:00