Compare commits

...

258 Commits

Author SHA1 Message Date
d97e69d124 Merge feat/process-modeler T4.3收尾: 安全Critical修复+文档回写(B3完工)
Some checks failed
ci / build-test-parity (push) Has been cancelled
parity-nightly / nightly-parity (push) Has been cancelled
- 安全对抗评审Critical#1修复:nginx关闭/flowable/公网直通(无鉴权引擎不对外)
- 文档回写:总览B3行🔴→🟢+一句话进度+README+计划完成横幅
- 双对抗评审处置:发布链I-1语料dry-run证伪(803formKey全命中)/A10加固backlog

B3 在线流程Modeler v1 全17任务完成。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:33:54 +08:00
74b30adb6e docs(B3): 收尾——总览B3行🔴→🟢+一句话进度+README+计划完成横幅+双对抗评审处置
B3 在线流程Modeler v1 全17任务完成合main。评审处置:安全Critical#1(nginx)已修+A10加固backlog;
发布链I-1(formKey门误拒)语料dry-run证伪(803全命中miss=0)/I-2空content已知限制v2/M-1~3低优先。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:33:03 +08:00
36aa94db7d fix(deploy): nginx 关闭 /flowable/ 公网直通(安全评审 Critical#1)+A10加固backlog
flowable-service:8089 无鉴权,裸 proxy_pass 对外会绕过网关超管门匿名部署/覆盖生产BPMN。
前端只经 /api/workflow/ 网关访问流程能力,/flowable/ 改 return 404。
High#2/Medium#3-4 等 A10 生产加固项记入计划 backlog(超管信任模型内可接受)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:26:12 +08:00
49d056be09 Merge feat/process-modeler 阶段4: 计划文档回写(e2e发现/已知限制)
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:16:14 +08:00
a5e2540c8f docs(plan): 阶段4 e2e 发现——会签空content语义缺口/e2e非幂等/403降级(已知限制)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:14:03 +08:00
93f3823a06 Merge feat/process-modeler 阶段3: 发布门(deploy+校验+审计+同人确认)
Some checks failed
ci / build-test-parity (push) Has been cancelled
- deploy-from-model(incoming/outgoing剥除+id还原中文key+ProcessValidator校验门+
  disableSchemaValidation+metaInfo不可读fail-fast防坏key)+impact影响摘要
- 网关语义校验门 ModelSemanticValidator(办理人JSON items非空+type白名单对齐WfTypes16种防误拒/
  formKey存在性/完成条件三预设∪自定义不阻断)+FlowDeployAuditService+Flyway V4 sys_flow_deploy_audit
- 下游ProcessValidator结构化errors透传前端(不再吞成通用FLOW_REMOTE_ERROR)
- live 验收:改总包合同交底→存草稿→发布 v9,中文key保住+审计行(op=ADMIN)+起实例生成真userTask+
  旧6实例不受影响+非admin 403;全reactor mvn clean install绿+ArchUnit 6/6
- live 揪修CRITICAL:activiti.json缺tagAlias致Modeler输出PascalCase元素名(Flowable大小写敏感断部署)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 15:30:32 +08:00
4af6776164 docs(plan): 回写阶段3 live CRITICAL——activiti.json致bpmn-js Modeler输出PascalCase元素名(部署断)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 15:02:37 +08:00
732655e776 fix(gateway): 语义门收口——type白名单对齐WfTypes(防误拒存量)+透传下游结构化errors+TOCTOU文档
评审 T3.2 收口(2 Important + 2 Minor):
- I-1(功能回归):ModelSemanticValidator.TYPE_WHITELIST 10 种→16 种,对齐 flowable-service WfTypes
  配置类型 + OrgDirectoryJdbc 运行期分派(权威源,非 BasePropertiesConverter,注释已改)。
  psql 窄查询实证:缺失 6 种里 initiatorDepartManager(24 文档)/fixedDimension(12 文档)在真实
  candidateUsers 有非零命中,旧白名单会 422 误拒这些存量流程(载入→编辑无关节点→发布)。
  网关不依赖 flowable-service 故复刻常量并注同步提醒。
- I-2(UX):FlowRemoteException 加 responseBody;FlowableClient.execute 携带下游原始体;
  FlowGatewayExceptionHandler.onRemote 解析并把下游 errors 数组并入网关响应顶层——发布下游 422
  的引擎结构校验 errors[{activityId,problem,defaultDescription}] 现能到前端,与网关语义 422 顶层
  errors 契约统一(前端 T3.3 同一渲染)。非发布路径纯文本体照旧不加 errors 键(无回归)。
- I-3(TOCTOU):deploy 端点加「已接受风险」javadoc(超管低频+窄窗+非安全洞,v1 不做 content-hash 409)。
- 补测 M-1(flowable: 前缀 candidateUsers 按本地名匹配同校验)+ M-2(新增 4 种 type 放行,锁 I-1)+
  I-2 客户端携带体/handler 并入顶层 errors 两用例。

测试:语义 19(+2)、审计 3、客户端 24(+1)、控制器 30(+1)。全 reactor mvn clean install 退出码 0,
零 <<< FAILURE,ArchitectureRulesTest 6/6。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 14:52:03 +08:00
5eed5f0b26 feat(gateway): 发布语义校验门(ModelSemanticValidator)+部署审计(V4/FlowDeployAuditService)
网关发布门收口(T3.2):
- ModelSemanticValidator(@Service):钉 JDK 解析器解析 bpmn XML,校验办理人/会签内嵌
  JSON(全角【】→半角)items 非空+type 白名单、formKey 存在于 view_wftemplate(读库降级放行)、
  会签 completionCondition 预设∪自定义非空(自定义不阻断,保留 T2.4 自定义态);返 List<String> 错误清单。
- Flyway V4 建 sys_flow_deploy_audit(平台表);FlowDeployAuditService(@Service)收口 INSERT,
  写失败不反噬已成功的部署。SQL 全收口 @Service,@RestController 不直用 JdbcTemplate(ArchUnit 棘轮)。
- ProcessModelerController 加 POST /models/{id}/deploy(超管门→语义校验 fail 则 422 零转发→
  转发 deploy→审计 INSERT operator=userId)+ GET /models/{id}/impact(超管门转发)。
- FlowableClient 加 deployModel(id)/modelImpact(id)(uri 变量转发)。

测试:语义校验 17(各错误类型+通过+items 空 error+自定义完成条件不阻断+读库降级+XXE)、
审计 3、客户端转发 +3、控制器 deploy/impact +7。全 reactor mvn clean install 绿,
ArchitectureRulesTest 6/6(@RestController 未新增直用 JdbcTemplate)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 14:12:21 +08:00
529f73f8f5 fix(flow): 发布门坏key地雷收口——metaInfo不可读fail-fast(防部署净化key)+危险分支补测
评审 I1(高后果):readIdMap 把三种情况塌成「空 idMap→跳过还原」——(a)真新建 (b)JSON 解析失败
(c)解析成功但缺 eip4IdMap 键。对 from-procdef 存量草稿(editorSource 的 <process id> 是净化 nXXX),
(b)/(c) 会跳过还原 → 静默部署 key=nXXX 而非中文原 key(HTTP 200,违 D7,且与 restore 非双射 fail-fast 自相矛盾)。

修:readIdMap→resolveIdMap,据 from-procdef 写的 sourceProcDefId/originalKey 标记分流——
metaInfo 非空且(解析失败 或 带标记但缺/非-Map eip4IdMap)→ IllegalStateException fail-fast,
deploy catch→422「草稿 id 映射不可用,无法还原原 key」,不部署。eip4IdMap 存在(含空 {})即可用
(空=全 ASCII 存量流程无需还原);真·新建(metaInfo {}/null、无标记)仍空 map 正常放行。impact 只读
最终回退 model.key(from-procdef 的 model.key 即中文原 key),不 500。

补测(评审 I2):非双射 idMap→IllegalArgumentException→422;存量草稿缺 eip4IdMap→422;metaInfo 坏 JSON→422;
存量空 eip4IdMap 全 ASCII 不误拒正常部署;deploy 路径字节级 DOCTYPE 守卫→422。Minor:M1 注释钉边界
(EIP4 语义校验在网关 ModelSemanticValidator/T3.2,此处仅引擎结构校验);M3 impact 注释说明为何不需独立 DOCTYPE 守卫。

ProcessModelControllerTest 30/30(19 既有零改动 + 11 T3.1:6 首轮 + 5 本轮);全 reactor clean install 绿
(ArchitectureRulesTest 6/6)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:48:36 +08:00
6f180522f3 feat(flow): 草稿发布(incoming/outgoing剥除+id还原中文key+ProcessValidator校验门+disableSchemaValidation)+影响摘要
POST /models/{id}/deploy:剥除 bpmn-js 补的 incoming/outgoing 文本引用元素
(Flowable 从 sequenceFlow 自行推导,不剥则 restore 只还原属性位→落库脏 XML,T1.3 I-2)
→ BpmnIdSanitizer.restore 依 eip4IdMap 还原中文原 key(存量 D7 硬需求,新建流程无 idMap 跳过)
→ ProcessValidator 语义校验门(仅 ERROR 级阻断,返 422 {errors:[{activityId,problem,defaultDescription}]}
不部署;WARNING 放行)→ createDeployment().disableSchemaValidation()(只跳 XSD:bpmn-js 默认命名空间
与严格 XSD 已知不兼容,语义已在上一步)部署 → {status,deploymentId,processKey,newVersion}。

GET /models/{id}/impact:还原后解析 processKey → {processKey,currentVersion(最新已部署版本),
runningInstances(运行中实例数)},供同人确认弹窗展示。

控制器加 @Autowired(RepositoryService,RuntimeService) 构造(保留单参构造零改动既有 CRUD 单测)+
全参构造注入 mock ProcessValidator。发布/影响端点 8 单测(还原中文key+剥除无残留净化id+disableSchemaValidation
验证/ERROR 422 不部署/WARNING 放行/404/impact 计数),既有 17 单测零改动;全 reactor clean install 绿
(ArchitectureRulesTest 6/6)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:32:31 +08:00
84be9c658a Merge feat/process-modeler: 修 ArchUnit 棘轮(wftemplates SQL 收口 WfTemplatePickerService)+计划红线
Some checks failed
ci / build-test-parity (push) Has been cancelled
修复 7524e5f 阶段2 merge 引入的 platform-app ArchitectureRulesTest 失败:
ProcessModelerController 直注 JdbcTemplate 违反棘轮,SQL 收口新建 WfTemplatePickerService;
全 reactor mvn clean install 独立验证真绿(ArchitectureRulesTest 6/6)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:17:18 +08:00
647f06836f fix(gateway): wftemplates SQL 收口 WfTemplatePickerService(修 ArchUnit 控制器JdbcTemplate棘轮)
T2.2 给 ProcessModelerController(@RestController)直注 JdbcTemplate 触发 platform-app
ArchitectureRulesTest 棘轮「控制器不得新增直用 JdbcTemplate」(该测试在 platform-app 扫全模块,
模块级 mvn -pl 跑不到故 T2.2 时未暴露,main 全 reactor 失败)。按规则本意收口(不加白名单):

- 新建 platform-flow-gateway aggregate/WfTemplatePickerService(@Service):wftemplates 的 JdbcTemplate
  查询(view_wftemplate_id + entityid→sys_entity.name LEFT JOIN + trim CHAR 补白 + isactive=1 +
  读库异常降级)整体搬入,暴露 listTemplates() 返 {templates} / 降级 {templates:[],degraded:true}。
  Service 用 JdbcTemplate 不违规,规则只禁 @RestController。
- ProcessModelerController 去掉 JdbcTemplate 字段/构造参 + SQL/RowMapper 常量,改注入 WfTemplatePickerService,
  wftemplates 端点只保留超管门 + 透传。

测试:新建 WfTemplatePickerServiceTest(2:trim补白+回退id+正常不带degraded / 读库异常降级带degraded);
ProcessModelerControllerTest 的 wftemplates 三例(直查 JdbcTemplate)收敛为两例(超管透传 service 结果 /
非超管 403 不调 service),jdbcTemplate mock 换 WfTemplatePickerService mock。

验证(全 reactor,ArchitectureRulesTest 真跑):JAVA_HOME=...openjdk@21 mvn clean install -q → 退出码 0;
ArchitectureRulesTest 6/6 绿(JdbcTemplate 棘轮通过)、WfTemplatePickerServiceTest 2、ProcessModelerControllerTest 22、
FlowableClientTest 20,全 reactor 零失败报告。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:13:32 +08:00
26532a64c3 docs(plan): 红线补——合main前全reactor真绿(ArchUnit在platform-app)+控制器SQL收口Service
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:04:58 +08:00
7524e5f7bf Merge feat/process-modeler 阶段2: EIP4 控件+草稿闭环
Some checks failed
ci / build-test-parity (push) Has been cancelled
- 流程草稿 ProcessModelController(act_re_model,Model API 首启;metaInfo 存 eip4IdMap 供发布还原;
  category=eip4 隔离 143 存量;草稿保存 validateSchema=false+字节级DOCTYPE守卫;DELETE 端点)
- 网关 models 五端点+DELETE 转发(requireSuperAdmin 统一门)+wftemplates picker(entityid→sys_entity.name)
- EIP4 侧板五控件(办理人 codec meta 透传/会签保真读回 isSequential/elementVariable/自定义完成条件/
  formKey 过滤/扩展属性/监听器);表达式 codec 与 BasePropertiesConverter 逐字对齐+引号映射防截断JUEL
- 存草稿闭环(三路径保 eip4IdMap+首存回填 modelId 防刷新重复+草稿列表/删除)
- live 验收:总包合同交底 中文key 打开→会签保真→saveXML(bpmn-js默认命名空间,后端XSD修复接受)→
  act_re_model 含完整 eip4IdMap→重开侧板忠实回显;全 reactor mvn clean install 绿
- live 揪修3真bug:options source=model语义/属性面板ref未绑/bpmn-js输出被严格XSD拒
- 评审含金量:codec全库4794表达式往返/反编译Flowable抓XXE参数/28会签流对账保真

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:02:45 +08:00
789cb90af3 fix(flow): 草稿保存关严格XSD校验(bpmn-js默认命名空间输出)+字节级DOCTYPE守卫保XXE
阶段2 live 验收阻断 bug:UI 保存草稿恒 422。根因=T2.1 评审 I-1 我把 enableSafeBpmnXml 从
false 改 true 时,convertToBpmnModel(source, validateSchema=true, ...) 的 validateSchema=true
开启严格 XSD 校验;bpmn-js saveXML 用默认命名空间(无前缀 definitions/process)重序列化,Flowable
严格 Xerces XSD 校验拒之(cvc-complex-type.2.4.a: element {MODEL}process ... expected)——bpmn-js
面向 BPMN 模型非字节级 XSD 合规,这是已知固有不兼容;原始 source(带前缀)故能过。

架构:草稿是可视化工具编辑的半成品,不该做完整 XSD 校验(完整校验属部署门 T3.1 ProcessValidator,
在解析后模型上跑,非 XSD)。修法:
1. parseGuard 的 convertToBpmnModel(..., true, true) → (..., false, true)(validateSchema=false)。
   仍解析(非良构 XML 抛→422),不做严格 XSD。
2. XXE 不只靠此:解析前加字节级 DOCTYPE 拒绝守卫(移植 platform-report ReportXmlGuard
   hasDoctypeInBytes/hasDoctype 模式,含 BOM/UTF-16 编码识别,就地复刻不引 platform-* 依赖),
   与 enableSafeBpmnXml=true 双保险防外部实体注入。

测试(TDD 先红后绿):ProcessModelControllerTest 16→19——①bpmn-js 默认命名空间输出(BPMNDiagram
先于 process,触发同族 cvc-complex-type.2.4.a)改前 422 改后 200 落库(回归锚点,改前实测必红);
②含 <!DOCTYPE 声明的 XML → 422(XXE 守卫);③非良构 XML(标签不匹配)→ 关 XSD 后仍 422。
flowable-service 全模块 92 测试绿,BUILD SUCCESS,既有 16 测试零改动。

附带排查(T3.1 deploy 路径同问题,不在本 task 范围):Flowable 6.8.1 BpmnParse 构造器
validateSchema 默认 iconst_1=true,BpmnDeployer 把它传给 convertToBpmnModel → createDeployment()
.addString(bpmnJsXml).deploy() 会被同一 cvc-complex-type.2.4.a 咬。escape hatch:DeploymentBuilder
有 disableSchemaValidation()(仅跳 XSD)。T3.1 应:parse(validateSchema=false)→跑 ProcessValidator
(语义校验,计划已设计)→ createDeployment().disableSchemaValidation().addString().deploy()。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:52:51 +08:00
a9d21ec46c docs(plan): 回写阶段2 live 实证——bpmn-js默认命名空间输出被严格XSD拒(草稿已修+警示T3.1部署路径)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:42:56 +08:00
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
e19bac805e docs(plan): 回写 T2.2 评审——草稿删除端点挂 T2.5/T4.1
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:57:45 +08:00
a25e7ce4b7 docs(plan): 回写 T2.2 实证——wftemplate 无名称列,formKey 下拉须过滤输入
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:49:45 +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
4abe9f8ce6 docs(plan): 回写 T2.4 评审——T3.2 语义校验加 items 非空与自定义完成条件口径
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:48:29 +08:00
b89447556f fix(flow): 草稿控制器评审收口——safeBpmnXml+category过滤存量+metaInfo保持回归测试等
评审跟进 7 项(评审者反编译 Flowable 6.8.1 实证):
- I-1(安全):parseGuard convertToBpmnModel 第三参 enableSafeBpmnXml false→true,
  启用 flowable 加固解析器(禁外部 DTD/参数实体/DOCTYPE)关 XXE/SSRF 面;javadoc 写明两布尔参语义。
- I-2(列表污染):库里 143 条存量 act_re_model(老 shape+悬空 editorSource)会进草稿列表打不开。
  create/from-procdef 建 model 时 setCategory("eip4");list() 改 modelCategory("eip4") 只查本分类。
- I-3(回归契约):加「PUT 只带 name 不带 metaInfo→verify never setMetaInfo」用例,钉住 eip4IdMap
  不被普通保存抹掉(T3.1 发布逆向还原原 key 的命根)。
- M-1:class javadoc 补「裸 8089 无鉴权,写端点必须经网关超管门访问(T2.2),生产 8089 不对外」。
- M-2:parseGuard 422 msg 改通用文案「BPMN 解析失败」,原始 e.getMessage 只进 log.warn(防内部细节回显)。
- M-3:POST create 对空白 name/key 返 422(key 是 T3.1 部署资源名/还原依赖),在解析守卫前拦;加测试。
- M-4:补 from-procdef「BPMN 读取为空(getProcessModel null)→found:false 不落库」分支测试。

测试:ProcessModelControllerTest 11→14 例(新增 空白 name/key 422 不落库、只带 name 不改 metaInfo、
BPMN 读空 found:false;既有列表用例补 modelCategory 断言、建草稿/from-procdef 补 setCategory 断言)。
flowable-service 全模块 87 测试绿(新增 3,既有其他模块测试零改动)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:32:26 +08:00
93b5433f1e docs(plan): 回写 T2.3 实证——表达式 meta 5 字段透传为 T2.4 正确性硬要求
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:18:53 +08:00
57812f0edc feat(flow): 流程草稿 ProcessModelController(act_re_model,Model API 首次启用)
在线 Modeler 草稿仓:flowable 原生 Model API 存草稿于 act_re_model(全仓首次启用
Model API,表已有 143 行存量,databaseSchemaUpdate=false 不涉 DDL)。5 端点(@RequestMapping
"/api/flow"):GET /models 列表(orderByLastUpdateTime desc,时间转 ISO)、GET /models/{id}
取草稿(getModel+getModelEditorSource,不存在/源空→found:false)、POST /models 建草稿
(XML 过 BpmnXMLConverter 解析守卫,坏 XML→422 不落库)、PUT /models/{id} 更新
(不存在→404;name/metaInfo 仅当请求提供才更新,避免抹掉 eip4IdMap)、
POST /models/from-procdef 从流程定义建草稿(BpmnIdSanitizer 净化中文 id,
metaInfo={eip4IdMap,sourceProcDefId,originalKey} 供发布逆向还原)。

解析守卫就地 catch 转 422,不逸出到 FlowExceptionHandler(那里 FlowableException→400
语义不符)。from-procdef 复用本控制器自带 readProcessModel 小方法,零改动 ProcessDiagramController。

测试:ProcessModelControllerTest 11 例(列表 ISO 降序/取草稿含 metaInfo/model 不存在或
源空 found:false/建草稿合法 XML 落库/坏 XML 422 且 verify 零 saveModel/PUT 404/PUT 合法
更新 status:0/PUT 坏 XML 422/from-procdef 净化 XML 与 idMap 落 metaInfo(捕获 setMetaInfo
断言 JSON 含 eip4IdMap+中文 originalKey、捕获 editorSource 断言净化无中文 id)/procDef
不存在 found:false 不落库)。flowable-service 全模块 84 测试绿(新增 11,既有 73 零改动)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:15:54 +08:00
546a8228b0 Merge feat/process-modeler 阶段1: Modeler 只读载入存量(可逆净化+source端点+网关超管门)
Some checks failed
ci / build-test-parity (push) Has been cancelled
- BpmnIdSanitizer 可逆化(碰撞消解+前缀安全+双射契约测试,BpmnIdSanitizerTest 10)
- by-id/by-key 取净化源XML端点(共享 sourceResponse,ProcessDiagramControllerTest 9)
- 网关转发+超管门(isSystemAdmin public化+9契约测试,中文procDefId uri变量编码硬验收,
  FlowGatewayExceptionHandler 全仓首测,ProcessModelerControllerTest 10)
- live 验收:中文key「总包合同交底」全链打开,画布/palette/标准面板(Multi-instance组)全渲染,
  无身份403;全 reactor mvn clean install 绿
- live 揪修2真bug:options source=model 语义缺口(by-key修法)/属性面板 ref 未绑
- 计划文件随评审实证持续回写(7次 docs 提交)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:08:05 +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
88ab0b8f0e docs(plan): 回写 T1.6 评审 M-3——T2.2 抽 requireSuperAdmin 统一过门 + 红线补「生产 8089 不对外」
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:55:38 +08:00
fdb97def4d docs(plan): 回写阶段1 live 发现——options source=model 语义缺口与 by-key 修法
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:54:10 +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
14a825d0a0 docs(plan): 回写 T1.5 评审——T2.4 顺带补红线回归测试+canvas分支错误提示
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:43:12 +08:00
3ca082408c docs(plan): 回写 T1.4 评审 M-2——T1.6 中文 procDefId 编码为硬验收点(禁拼URL,测试+live 均须中文用例)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:34:25 +08:00
e5781ddd02 test(flow): source 端点补 ref 重写断言(评审 M-1)
中文 fixture 测试追加断言:sequenceFlow 的 sourceRef 引用须随 process id
一致重写,净化后 XML 不含 sourceRef="总包合同交底",让 ref 重写不白放。
ProcessDiagramControllerTest 7/7 绿(JDK21)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:34:22 +08:00
3927146f08 feat(flow): 按 procDefId 取净化源 XML 端点(含 idMap,D7 载入侧)
新增 GET /api/flow/process-definitions/{procDefId}/source:
createProcessDefinitionQuery 取 key/version + readProcessModel 取 BPMN
+ BpmnIdSanitizer.sanitize 净化中文 id → {found,bpmnXml,idMap,procDefKey,version}。
定义不存在 / XML 为空或读取异常 → {found:false}(HTTP 200,WARN log,防御性同 diagram 端点)。
idMap 透出原→净化映射,供发布时逆向还原原 key(D7)。

TDD:ProcessDiagramControllerTest +3 用例(净化XML+idMap+key版本 / 定义不存在
found:false / 读取异常 found:false),既有 4 用例零修改仍绿。
类 7/7、模块全量 71/71 绿(JDK21)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:27:46 +08:00
e361d3a9ad fix(flow): BpmnIdSanitizer 评审收口——safe占位契约测试+空白原样+inverse fail-fast
- I-1:补「生成净化 id 不与文档既有合法字面 id 冲突」契约测试。fixture 含合法字面
  id nb7af8 + 中文 id 审批(其 hashCode&0x7fffffff 的 hex 恰为 b7af8)→ 断言 审批 让位
  映射为 nb7af8-2、既有 nb7af8 不动、restore 逐字节还原。
- M-1:rewrite 未改值的属性原样回写(append group(0)),不再重构 → 不归一 id = "x" 这类
  等号周围空白,保逐字节契约。补测:带等号空白的合法属性 + 非空 map,round-trip 后原文不变。
- M-2:restore 反转 idMap 时检测净化 id 重复(非双射,损坏 metaInfo)抛 IllegalArgumentException,
  不再静默覆盖还原错。补 fail-fast 测试。

测试:BpmnIdSanitizerTest 7→10 例;ProcessDiagramControllerTest 4 例仍零修改;
flowable-service 全模块 mvn -pl flowable-service -am test = 68 测试 0 失败 0 错误。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:24:14 +08:00
33fccb6541 docs(plan): 回写 T1.3 评审 I-2——T3.1 部署前须处理 incoming/outgoing 文本引用(剥除或纳入 restore)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:22:57 +08:00
3cf58fe72c refactor(flow): id 净化抽 BpmnIdSanitizer,补可逆 restore+碰撞消解(D7 地基)
ProcessDiagramController.sanitizeBpmnIds 的中文 id→安全 ASCII 净化逻辑抽成
BpmnIdSanitizer(sanitize 返 Result{xml,idMap} / restore 逆向还原),为 D7「发布存量
流程 key 不变」打地基。

- 双射保证:同文档两个不同中文 id hash 碰撞时基名追加 -2/-3 序号,生成 id 亦不与既有
  合法 id 冲突;非碰撞场景净化输出与旧实现逐字节一致(查看器零回归)。
- restore 前缀安全:复用 ID_ATTR 正则逐属性值精确匹配,不裸 String.replace 子串替换
  (n1 不误伤 n1x);映射外 ASCII id(设计器新增节点)原样保留。
- ProcessDiagramController.sanitizeBpmnIds 改为委托,原包级签名/行为不变。

测试:新增 BpmnIdSanitizerTest 7 例(中文全引用面 restore 逐字节还原/撞哈希 中Aa~中BB
双射/restore n1~n1x 前缀安全/合法 NCName 不改写/混合只映射中文/空 XML 防御);
既有 ProcessDiagramControllerTest 4 例零修改仍绿;flowable-service 全模块 65 测试通过。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:10:47 +08:00
7a97b712b4 docs(plan): 回写 T1.2 实证——T1.3 净化 hash 有碰撞风险,可逆 restore 须双射消解
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:03:06 +08:00
90a6f97040 docs(plan): T1.1 评审 M-3 回写——T1.5 严禁引 Camunda provider(双包冲突变体)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:45:06 +08:00
f7d96489d0 docs(plan): 回写 T1.1 实证——双包冲突/嵌套全角【】/formKey裸UUID/moddle拒中文id
T1.1(eip4-web 8fdfe68)三发现防漂移回写:T1.5 只载 activiti 描述符(双载丢 userTask)+resolveJsonModule 提示;
T2.3 表达式 fixture 改嵌套全角形态(items 内层对象也是【】,content 尾部补白不可 trim);
§0 补 formKey=裸UUID + moddle 拒中文id 实证

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:38:19 +08:00
be9767cbe3 Merge docs/process-modeler-plan: B3 流程Modeler 实施计划
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:13:02 +08:00
6f5b1f7117 docs(plan): 在线流程Modeler(B3)实施计划——4阶段TDD任务
基于 06-26 design(D1-D9)+三路事实勘探(语料/后端/前端)合成:
- §0 事实基线:1512真实BPMN扩展面实测(11属性/5元素/中文key会签流)+后端(deploy无审计/sanitize单向/Model API零使用/网关超管判定现成)+前端(bpmn-js17已装/属性面板缺/admin门与测试范本)
- §0.5 计划级决策P1-P6:moddle自建vendored+语料双门/影响摘要节点级diff/3模板/草稿admin共见/EIP4控件走React侧板非preact/全量保真扫描做工具不进CI
- 阶段1 moddle保真+只读载入/阶段2 三控件+草稿/阶段3 发布门(校验+超管+同人确认+审计V4+id还原)/阶段4 新建+live e2e
- 验收清单8项+红线提醒(databaseSchemaUpdate=false/保真层不改/JDK解析器/部署门只落网关)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:13:02 +08:00
adae344323 docs: 核实修正——EIP-3.0 业务源码已在本地,P1③ 仅剩 S1 拍板一重阻塞
Some checks failed
ci / build-test-parity (push) Has been cancelled
用户指出 eip3 源码在当前目录:核实 ../EIP-3.0/(3.1G,pm/hr/oa/dm+framework)确已存在,
总览三处「源码未克隆/在远仓」表述过时修正;并核实当前 eip4 库(5433)=1512 真实 BPMN bytearray+1503 部署+143 act_re_model

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:58:18 +08:00
8091aaf7fa Merge docs/scrub-private-host-0702: 文档清除私有托管地址
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:29:30 +08:00
dd3b048899 docs: 清除私有托管地址,改中性表述(取码地址向负责人索取)
- 新人上手 §1:托管地址/clone 命令改 <GIT_HOST>:<OWNER> 占位,SSH 端口细节改「向负责人索取」
- 路线图/用户管理Delta/总览 三处历史记录行、.gitea/ci.yml 注释:host 名改「私有 Gitea/私有远程」
- 全仓 grep 验证零残留

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:29:30 +08:00
f01b7abda0 Merge docs/hosting-note-0702: 托管现状标注(私人库非团队库)
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:23:54 +08:00
0f153d658e docs: 标注托管现状——git.latent.chat 为私人 Gitea 非团队库
- 新人上手 §1 加警示:团队接手前需迁移团队代码托管或开通协作者账号,CI runner 应部署团队侧
- CONTRIBUTING CI 段补托管注记:workflow 为 Gitea Actions(GHA 兼容)语法,迁 GitHub 近乎原样复用,迁 GitLab/Jenkins 需转换

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:23:54 +08:00
cc5cb83500 Merge docs/team-onboarding-0702: 新人上手 + CONTRIBUTING
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:15:57 +08:00
2f97124ba1 docs: 新人上手一页纸 + CONTRIBUTING 协作约定(团队接手准备)
- docs/新人上手.md:第一天路径(前置软件/取码/构建/eip4dev/起服务/前端/必读序/高频坑/红线)
- CONTRIBUTING.md:分支命名/--no-ff 合并/提交格式/质量门(TDD+全 reactor 绿+作者评审分离+转换器重转重导)/CI 现状/文档归档纪律(两仓通用)
- docs/README.md §2 登记两份新文档

配套(仓外):工作区根 README 刷新至 07-02(原停 06-11);eip4-web README 联调指引修正另仓提交;两仓本地已合并分支清理(platform 40/web 7,含 ai-agent worktree)+远端 8 个已合并分支删除

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:15:57 +08:00
c6bfcebcad Merge docs/doc-alignment-0702: 文档-代码对抗核查对齐 + 归档整理 + 架构图入库
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:45 +08:00
1b02036153 docs+javadoc: 文档-代码对抗核查对齐 + 归档候选物理归档
5 路并行核对总览 §9/§10/§11 + A/B 矩阵声明 vs 两仓代码(48 条 46 条完全一致,无虚报),修正不一致处:
- A10 行 🔴→🟡:W1 Flyway(V1-V3)+W2-W4 容器化/nginx/compose 骨架 06-25 已合 main,文档此前低报;§10.2 Flyway/compose 两条标 ✅
- §9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)改齐
- §10.2 render-plan 行号迁 AiDraftGateValidator.java:246(SRP 拆分后位置)
- §11 报表单测 73→79;§2「五步编排壳」改四步向导
- CandidateUsersHandler 类级 javadoc:scriptUser 已于 06-26 接入(resolveScriptUsers),删「WARN 降级未接入」陈旧表述(纯注释零行为变更)

归档整理(总览 §8 归档候选落地):
- 10 份已完成/被取代文档 git mv 入 docs/归档/(06-14×3/06-15/06-16/06-20 plans、CRUD-QA、C3/C5、总览-06-17)
- 引用同步改路径:README 索引、M0剩余项登记、通用模板收口计划、架构方向-design、新闻管理plan
- README 刷新至 07-02:补 06-22→06-26 增量一节、审批/报表行状态、§2 补登 06-25/06-26 四份 design/计划、§4 过时「未 push」表述修正

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:23 +08:00
b4baca5d94 docs: 架构图快照(2026-06-26)入库 + 生成式OS驾驶舱迁出指针存根
- 架构设计.md 头部挂当前架构图 assets/eip4-architecture-2026-06-26.png(此前改动遗留未提交)
- plans/2026-06-24-生成式OS数据驾驶舱-design.md 为指针存根,权威文档在独立仓 genos-cockpit

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:23 +08:00
1dd65b0142 Merge: 报表公司名改取系统配置 sys_application_config
Some checks failed
ci / build-test-parity (push) Has been cancelled
parity-nightly / nightly-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 13:01:10 +08:00
e63b3a3373 fix(report): 公司名改取系统配置 sys_application_config,不用静态 Spring 值
用户指正:报表抬头公司名应取系统配置的值。新增 ReportTemplateRepository.loadCompanyName() 读 sys_application_config[com.dsasp.server.organize.COMPANY](客户系统参数里维护的公司名,如「苏州第五建筑集团有限公司」);ReportController 优先用它,缺失才回退 eip4.report.company。部署无需额外配置,直接复用客户已维护的系统参数。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 13:01:10 +08:00
d87d0e2185 Merge: 办公用品采购报表修复(打印空白/审批意见/公司名占位) + dev 合库
Some checks failed
ci / build-test-parity (push) Has been cancelled
- 套打打印按选中行主键直接渲染(修195页单据打印空白)
- approve 默认记「同意」审批意见(供报表审批段显示)
- 注入配置公司名覆盖模板占位「XXXXXX公司」
- dev 数据源合并为单库 eip4(业务+流程同库,对齐生产单库拓扑;env 可覆盖)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:36:29 +08:00
3e642a8aae chore(dev): 本地 dev 数据源指向合并库 eip4(业务+流程同库)
把 eip4dev(业务)/eip4flow(流程)合并为单库 eip4,对齐生产单库拓扑,跨库报表(审批意见 act_hi_comment 等)可单连接直接 join。原分库保留作回滚。均经 SPRING_DATASOURCE_URL/FLOWABLE_JDBC_URL/BIZ_JDBC_URL 可覆盖。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:42 +08:00
3afc55817e fix(report): 注入配置公司名覆盖模板占位「XXXXXX公司」
报表抬头绑自定义参数 COMPANY(经 jatools =COMPANY 表达式,非 ${}宏),默认值是占位「XXXXXX公司」,EIP4 从不注入 → 显占位。新增 ReportParamGuard.applyConfiguredCompany():模板声明 COMPANY 时注入 eip4.report.company 配置值。部署设客户公司名即全报表生效。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:42 +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
5a5aedcbb7 fix(report): 套打打印按选中行主键直接渲染,修单据打印空白
navigation+reportnosearch 打印按钮原嵌报表查看器,报表唯一的主键选择字段被 F3-1 剔除,选中行主键到不了 /api/report/render → SQL 用设计期默认 ID(库内不存在) → 空白。改为读目标报表 <search> 真实参数名,弹窗直接 iframe 渲染并注入选中行同名列(${selectedItems[0].P})。覆盖 195 个打印页(参数 PK/ID/PROJECTID 各异)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:41 +08:00
d3ec7581fd Merge origin/main (报表进度文档更新) into Modeler 设计文档
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-26 09:42:45 +08:00
0cf6536a59 Merge docs/process-modeler-design: 在线流程 Modeler 设计文档 2026-06-26 09:42:06 +08:00
e0e92a88b4 docs: 在线流程 Modeler 设计(brainstorming 拍定 D1-D9)
在已有 bpmn-js 流程图查看器 + 现成 /api/flow/deploy 之上扩成可编辑 BPMN 流程设计器:
老流程可编辑改、新流程可创建、全 BPMN/flowable 流程属性 + EIP4 办理人/会签/formKey 定制叠加。
决策:改存量+新建 / 草稿+同人确认部署(超管+校验+审计) / 草稿存 act_re_model /
标准全属性面板+EIP4控件 / 完整 activiti moddle 保真零丢失 / id 可逆净化保流程key /
flowable 原生版本隔离 / v1 不含 DMN/CMMN/表单设计器。4 阶段交付。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 09:42:06 +08:00
ccb179d84a docs: 进度总览更新报表保真层 JOR 重宿主 + 安全/OOM 收口(§11 + A3 升 🟢)
Some checks failed
ci / build-test-parity (push) Has been cancelled
A3 报表系统由 🟠 升 🟢:套打 JOR 重宿主已完成 + 保真层安全/OOM 收口已完成;
新增 §11 记三批合入(e6c73a4/dccca17/d697885)的 SQLi门/IDOR/XXE/并发·字节·超时·
结果集封顶/CVE替换/只读数据源,含关键验证与仍开口项;§0 一句话进度补一行。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:54:01 +08:00
0ee919b89e Merge feat/approval-diagram-cjk-fix: BPMN 流程图净化中文 id(bpmn-js 渲染修复)+ 进度总览对齐
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-26 08:45:34 +08:00
9be0a39c0f docs: 进度总览 A2 流程审批优化 → 🟢(审批闭环批+xerces修复),B3/路线图对齐
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:45:25 +08:00
1be949cc04 fix(approval): BPMN 流程图净化中文 id,修 bpmn-js「no diagram to display」
UI 走查实证:迁移的 BPMN 常用中文做 process/diagram id(如「招投标工程评审流程」),
bpmn-js/moddle 的 NCName 校验拒非 ASCII id → 整图不渲染(illegal ID)。
ProcessDiagramController.sanitizeBpmnIds 把非法(非 ASCII NCName)id 及其所有引用
(id/bpmnElement/sourceRef/targetRef/...)一致重写为安全 ASCII id(稳定哈希),
只动 id/引用类属性、不碰 name(保中文节点名),并同步重映射当前/历史节点 id。
单测 ProcessDiagramControllerTest 4 绿;浏览器 live:25 形状渲染+当前节点绿高亮+中文标签正常。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:45:25 +08:00
c95eaee0a5 Merge feat/approval-closure: 审批闭环 P0(协办/转阅)+BPMN流程图+scriptUser会签+会签进度+xerces击穿修复(WfTemplate/Excel解析钉JDK)
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-26 08:29:29 +08:00
d697885df6 Merge: 报表 CVE 依赖替换(reload4j/cc3.2.2)+只读数据源(残留1/CVE),73单测+依赖树+live全绿
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:27:47 +08:00
98ce37c11b 报表保真层:CVE 依赖替换 + 报表只读数据源(残留1凭据/CVE 收口)
CVE(引擎 jar 不可改,但依赖可替换;已核实引擎 API 面):
- commons-collections 3.0 → 3.2.2:关 InvokerTransformer 反序列化 gadget(CVE-2015-7501)。
  引擎源码不直接引用,3.2.x 向后兼容,3.2.2 本地仓已有。
- log4j 1.2.8 → reload4j 1.2.25:drop-in,关 SocketServer/JMSAppender 等 RCE CVE。
  引擎仅用 org.apache.log4j.Logger / PropertyConfigurator,reload4j 同包同 API。
- 依赖树实证:仅 reload4j-1.2.25 + commons-collections-3.2.2 在 classpath,旧 log4j-eip3/
  commons-collections-eip3 已不再被解析(无传递回流)。

残留1(凭据外泄)收口(实测当前模板 0 处泄露,纵深防御):
- JatoolsConfig 报表连接改读 eip4.report.db.url/username/password,未配置回落 spring.datasource.*
  (向后兼容,默认零行为变化)。供配置独立的只读最小权账号 → 收口 SQLi/凭据外泄爆炸半径。
- docs/security/report-readonly-db-account.sql:只读账号 GRANT 脚本(default_transaction_read_only
  + statement_timeout + 仅 SELECT)。
- docs/security/credential-leak-scan.sql:巡检 type=200 模板把 property("DB...") 用在 <Connection>
  之外的可疑项(本库扫描 0 命中)。

验证:73单测全绿;依赖树+runtime classpath 实证替换生效;live(新 jar 8097)HTML/PDF 渲染=200、
无 ClassNotFound/log4j 错误;报表数据源 override(eip4.report.db.username)与 fallback 两条腿均实证。
注:bsh(jatools fork 不可换)/itext(只生成不解析 PDF,XXE 不可达)/xerces 2.6.2(XXE 已被前置
DOCTYPE 拒绝兜住)三项记录在案,不替换。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:27:47 +08:00
e8af5b0a74 fix(dataimport): Excel XML 解析钉到 JDK 解析器,绕开 report 带入的上古 xerces
与 WfTemplateService 同病:运行时 platform-app fat jar 含 platform-report 的
xerces-eip3.jar(2004),DataImportExcelParser.parseSpreadsheetXml 的
DocumentBuilderFactory.newInstance() 会选中它 → setFeature AbstractMethodError
击穿数据导入 Excel 解析。同法显式钉 JDK 内置 DocumentBuilderFactoryImpl。

DataImportExcelParserTest + 导入控制器测试 4 绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:25:29 +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
dccca17314 Merge: 报表保真层残留2(maxResultBuffer结果集封顶)+残留4(逗号IN列表),73单测+JDBC探针+live全绿
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:08:29 +08:00
b15acfa2f3 报表保真层:收口残留2(结果集OOM)+残留4(多值IN列表),续 feat/report-fidelity-security-hardening
- 残留2(结果集全量物化OOM):JatoolsConfig 给报表DB URL追加 pgjdbc maxResultBuffer(默认60p=最大堆60%,
  可配)。引擎用TYPE_SCROLL_INSENSITIVE整集物化,无此上限时海量结果集可在产出前OOM;设此值则驱动层超限
  抛PSQLException而非OOM。JDBC实证:同款scroll-insensitive查询over view_template(1516行/14.5MB),
  cap=null读全表;cap=100/10k/1m分别在对应字节数抛"Result set exceeded maxResultBuffer limit"。
- 残留4(多值IN列表被误拒):isSafeValue允许逗号——真实模板有 in (${WELFARECATEGORYID})/in (${SCHEMEITEM})
  多值列表。逗号安全:UNION/子查询/注释/堆叠仍需空格/括号/引号/分号(均被拒),逗号单独无法构成注入。
  live:?WELFARECATEGORYID=1,2,3 渲染200(不再400)。

验证:73单测全绿(TDD,+4);live(8095默认60p正常render=200;8096 cap注入URL实证;逗号IN列表=200);
maxResultBuffer机制经独立JDBC探针在同一scroll-insensitive代码路径上证实超限即抛。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:08:20 +08:00
e6c73a4f88 Merge: 报表保真层安全/OOM收口(SQLi门/IDOR授权/XXE/并发字节超时,69单测+live e2e全绿)
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 07:52:03 +08:00
ffb2f042d0 报表保真层安全/OOM收口(platform-report):SQLi门/IDOR授权/XXE/并发字节超时
审计揪出真问题(jatools引擎预编译不可改,全在包装层收口):
- SQL注入(Critical):${PARAM}经evalTemplate字符串拼接进SQL后prepareStatement执行(无占位符绑定)
- IDOR:render/frame对templateId无对象级授权,任意已认证用户可渲染任意报表
- XXE:报表XML经裸DocumentBuilderFactory解析(外部实体/SSRF/OOB)
- ?tpl任意本地文件读+路径穿越;RBAC旁路(固定DB账号);OOM链(结果集全量物化+无并发闸+无超时+产物多副本)

实现:
- ReportParamGuard:模板${name}引用白名单 + isSafeValue字符白名单(拒空格挡无引号注入/拒--/::) +
  身份数据域保留集{CURRENTUSER,CURRENTDEPART,CURRENTORG,USERID,DEPARTID,ORGID}剥客户端+服务端注入可信值
- ReportXmlGuard.hasDoctypeInBytes:字节级拒DOCTYPE(防BOM/UTF-16编码绕过)
- ReportTplGuard + profile守卫:?tpl限定templates-dir内、仅.xml、仅旁路profile
- ReportController.enforceReportAccess:菜单授权对象级鉴权(超管bypass/匿名跳过/认证态无身份fail-closed)
- RenderConcurrencyLimiter(429)/LimitedByteArrayOutputStream(413)/JatoolsConfig注入statement_timeout+socketTimeout
- 错误响应改通用文案(细节仅落日志)

验证:69单测全绿(TDD);真库live e2e全绿(数值注入=400/IDOR=403/合法render+PDF=200/forged USERID剥离);
对象授权SQL逐对实证;独立security-reviewer对抗复审揪修2真漏(无引号数值注入绕黑名单、身份注入护错变量名)。

残留(非本层可修):凭据外泄(模板${property("DBPassword")}同解析路径,需模板创作授权+DB只读账号);
结果集全量物化OOM根因在引擎;预编译jar高危CVE(log4j1.2.8/commons-collections3.0/bsh)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 07:51:54 +08:00
6512a706fa Merge feat/report-drill-link-rewrite: 报表钻取链接改 EIP4 渲染路由
Some checks failed
ci / build-test-parity (push) Has been cancelled
parity-nightly / nightly-parity (push) Has been cancelled
JOR <Url>reportviewer.jsp?xmluuid=X 钻取链接(HtmlExport 渲为 <a href')经 ReportService.rewriteDrillLinks
改写为 /api/report/render/X?format=html(仅 HTML 通道,短路+字面量替换)。6 单测+jar 发射证实+全语料 xmluuid 首参实证
+live round-trip 无损;点击直通待完整客户库。code review APPROVE。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:24:59 +08:00
61b8658f44 feat(report): 钻取链接 reportviewer.jsp → EIP4 渲染路由
JOR 报表 <Hyperlink><Url>reportviewer.jsp?xmluuid=<目标报表ID>&PARAM=${PARAM}…</Url> 经 jatools
HtmlExport 渲成 <a href='reportviewer.jsp?xmluuid=…' target='_blank'>(jar 内确认 <a href' 发射);
EIP4 下老 jsp 已失效,点击钻取 404。ReportService.rewriteDrillLinks(仅 HTML 通道,渲染后处理)正则
reportviewer\.jsp\?xmluuid=([^&'"\s<>]+) → /api/report/render/$1?format=html,其余查询参原样保留
→ 点击钻取在新标签渲出目标报表(目标自身钻取链接亦被同一步递归改写,因每次 render 都过此步)。

- 短路:无 "reportviewer.jsp" 子串原样返回(302/339 报表跳过正则);Pattern 静态编译一次。
- replaceAll(Function) 字面量拼接,即便目标 id 含 $/\ 也不破坏替换(评审 MINOR-1 收口)。
- 6 单测:真发射锚格式(单引号 href+&amp;+target=_blank)/裸&分隔/多处/无链接短路同实例/null。

验证边界:钻取行在报表明细行,eip4dev 缺源数据 → dev 渲不出 drill 链接,点击直通须完整客户库;
本批=改写逻辑单测 + jar 发射证实(HtmlExport <a href')+ 评审实证全 37 张 xmluuid 恒首参 +
live 正常报表(5558497f CJK)HTML round-trip 无损、drill 报表渲染 200 不报错。code review APPROVE。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:24:59 +08:00
d78de96530 Merge docs/report-bclass-chart-backlog: B 类图表 backlog + 报表收尾纪要
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:08:37 +08:00
3a04b869fe docs(report): B 类图表验证结论=暂缓为独立 ECharts 小特性 + 收尾纪要
design §7 记录 B 类图表验证:ischart=true 仅 4 张且 reportfile 全空——不是 JOR/jfreechart,
是老客户端从图表数据流(POST 写流,GET 被拒)画的 ECharts,当前降级成加载不出数据的破表。
faithful 迁移=独立特性(POST 图表端点 + 流结果→amis chart option,但图表类型/系列映射在老客户端、
每张形状不同难通用、出图保真须完整客户库),仅 4 张低优先,待产品定夺口径。用户拍板暂缓。
§6 遗留同步:中文字体保真 + PDF/Excel 下载入口已收尾(均真镜像/真验)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:08:37 +08:00
fda9e20fe5 Merge feat/report-export-buttons: 报表查看器 PDF/Excel 导出下载入口
Some checks failed
ci / build-test-parity (push) Has been cancelled
查看器 filter.actions(有查询条件)/headerToolbar(无)加导出 PDF/Excel 按钮,指向 /api/report/render
携当前查询参;端点对 pdf/xls 回 Content-Disposition: attachment + RFC5987 中文文件名(view_template.name),
html 仍 inline。code review 通过(注入中和+RFC5987 收口)。浏览器+curl 真验下载保真。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:01:56 +08:00
1b4dab9701 feat(converter): 报表查看器加导出 PDF/Excel 按钮
convertReportViewer 产导出按钮(actionType:url,blank,指向 /api/report/render 端点 + format=pdf|xls)。
有查询条件 → 落 crud.filter.actions(与 查询[submit]/重置[reset] 同排,读 filter 实时值,
URL 带各字段 ${name} 占位,amis 点击时插值为当前选择);无查询条件 → 落 headerToolbar(无参,导全量)。
field name 为校验过的元数据标识符(UiTypeMapper IDENT),裸拼安全;${name} 须保字面量供 amis 插值。

- buildReportExportParams(filter):filter 各字段 → &NAME=${NAME}。
- reportExportButton(label,url):url 动作按钮。
- 2 单测:filter.actions 含 查询/重置/导出PDF/导出Excel + URL 带 ${字段};无 filter → headerToolbar 无参。

真验(浏览器):选工程→查询(重载 iframe,不触发下载);导出PDF→下载「在建项目收付款信息表.pdf」(有效 PDF/中文正确);
导出Excel→下载 .xls。339 报表页已重转重导 eip3.sys_page_schema(329 更新)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:01:45 +08:00
a6eced0761 feat(report): pdf/xls 导出加 Content-Disposition attachment + 中文文件名
报表查看器 iframe 用 format=html(inline 内嵌);导出按钮用 format=pdf|xls,端点须触发
下载而非内嵌渲染。render() 对 pdf/xls 设 Content-Disposition: attachment;文件名取报表名
(view_template.name,经 RFC5987 filename*=UTF-8'' 编码中文,ASCII 回退 filename="<templateId>.<ext>"
供老客户端);html 不设此头(查看器内嵌不变)。

- ReportTemplateRepository.loadReportName(templateId):取 view_template.name 作文件名,最佳努力
  (找不到/异常返 null → 回退 templateId,绝不因取名失败影响渲染)。
- contentDisposition(fmt,name,templateId)/sanitizeFilename:纯函数。sanitizeFilename 剔除
  CR/LF/引号/反斜杠/正斜杠/控制符,杜绝响应头注入(CRLF 拆头)与 filename 属性逃逸。
  filename* 修正为 RFC5987 attr-char 口径(空格→%20、*→%2A)。
- ReportDownloadTest:5 单测(html 无头/pdf RFC5987 中文名/xls 扩展/注入中和/空名回退 templateId)。

真验(curl):pdf/xls 回 attachment + filename*=UTF-8''在建项目收付款信息表.{pdf,xls};html 无 Content-Disposition。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:01:45 +08:00
e9357e2eef Merge fix/report-pdf-cjk-font: 生产镜像 CJK 字体,报表 PDF 中文保真
Some checks failed
ci / build-test-parity (push) Has been cancelled
platform-app 镜像装 fontconfig + fonts-wqy-zenhei + fonts-dejavu-core;docker 真镜像内
渲染验证 PDF 中文零豆腐块、字体嵌入子集可移植、套打版式全保真(圈码/全角¥/CJK标点全覆盖)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:30:48 +08:00
f8ef09ebdc fix(deploy): 生产镜像装 CJK 字体 + fontconfig,报表 PDF 中文保真
platform-app 生产镜像(eclipse-temurin slim JRE)原仅装 curl,无任何字体——headless
AWT/Graphics2D + iText 渲染报表 PDF 时无 CJK 字形,套打报表中文渲成豆腐块(□)甚至报错。
装 fontconfig + fonts-wqy-zenhei(/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc,= JatoolsConfig
兜底候选 + font.dirs 覆盖)+ fonts-dejavu-core(拉丁/数字),fc-cache -f 刷新缓存。

验证(docker 真镜像 + 真库 + 真渲染,非推断):
- fc-list :lang=zh 命中 wqy-zenhei;字形覆盖探测(fonttools)报表全字符集 100% 覆盖
  (汉字/CJK 标点 、()。/圈码 ①-⑩/全角¥/数字拉丁,无缺字)。
- Linux 容器内 /api/report/render?format=pdf 渲出「在建项目收付款信息表」:嵌入子集字体
  VXMDCT+WenQuanYiZenHei(emb/sub/uni 全 yes,可移植+可抽取文本),pdftotext 中文正确,
  pdftoppm 渲图零豆腐块——多级合并表头/公式列①②③④=①+③/签字栏版式全保真,与 macOS 渲染等价。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:30:48 +08:00
53f3c258a9 Merge feat/report-viewer-converter: 报表查看器转换器化(Phase 2/3) + 工程 picker 认证根因修
Some checks failed
ci / build-test-parity (push) Has been cancelled
转换器对 type=200(JOR 套打)产报表查看器(crud.filter 查询条件 + /api/report/frame → iframe 渲 JOR 保真版式),
铺到全部 339 报表页;并修认证 admin 未被引擎识别为超管(CHAR(36) 补白 ADMIN 常量 exact-equals 不匹配)
致工程 picker「暂无该数据源的查询权限」的根因。code+security 双评审已收口。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:45 +08:00
9a99754f72 fix(auth): admin 引擎上下文归一为规范 ADMIN 常量(修工程 picker「暂无权限」)
工程 picker「选不到」的真因不是转换器/页面结构,而是认证 admin 的引擎身份未被识别成超管:
JWT 注入 CURRENTUSER="ADMIN"(5 字符),而引擎跳过行级数据过滤的判定是 exact
ctx.get(CURRENTUSER).equals(LoggedInUser.ADMIN)——该常量是 CHAR(36) 补白的 "ADMIN"+31 空格。
5 字符 ≠ 36 字符 → admin 被当普通用户走数据权限 → PM_PROJECT 无规则 → PrivilegeException
→ picker/列表「暂无该数据源的查询权限」。(无 token 的 curl 走 ADMIN 默认上下文,故易误判后端正常。)

修:EngineContextBinder.bind() 对系统管理员把 CURRENTUSER 归一为引擎规范 36 字符 LoggedInUser.ADMIN,
引擎识别超管→跳过行级过滤(恢复引擎本就设计的 ADMIN 豁免)。isSystemAdmin 与全站 requireAdmin
逐口径对齐:userId trim 后 equalsIgnoreCase "ADMIN";account trim 后精确小写 ='admin'
(不放宽大小写——SYS_USER.ACCOUNT 无唯一约束、建号去重又区分大小写,防 'Admin' 变体账号静默提权,
安全评审 M-1)。各 requireAdmin 门控均 trim().equalsIgnoreCase,对补白形式同样判真,不破鉴权门。
非 admin 行为逐字节不变。

测试:4 个新用例(admin→36字符归一/USER_ADMINISTRATOR 不误判/account='Admin' 变体不提权/
account='admin' 精确小写识别);全 platform-auth 46 测试绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:34 +08:00
8e5e2410d1 feat(converter): convertReport 对含 JOR 套打的 type=200 产报表查看器
EIP3 真报表(jatools JOR 套打)此前被转换器降级成 amis 表格。现 convertReport 分流:
含 <reportfile>(JOR 套打版式,328/339)→ convertReportViewer 产 page→crud:
- api=/api/report/frame/{templateId}(currentTemplateId,缺则回落 entityId);
- filter=buildSearchFilter(查询条件,F3-1 过滤主键列)——picker 落 crud.filter 工作上下文;
- 单 html 列把 ${__url} 渲成 <iframe>(JOR HTML 独立加载、CSS 隔离保真);
- 有查询条件时 initFetch:false(等用户「查询」再加载,避免必填工程为空时空参渲染报错);
- header/footer toolbar 置空(报表查看器无新增/批量/分页)。
无 reportfile(9/339,纯数据报表)→ 保留原数据表降级行为不变。

测试:替换旧 JOR 降级用例为 4 个查看器用例(api/单 html iframe 列/picker 落 crud.filter+initFetch/
templateId 入 api/无 reportfile 保留表格);全 platform-converter 186 测试绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:18 +08:00
3090906f9e feat(report): /api/report/frame 端点 + Phase 2/3 报表查看器设计
报表查看器数据源端点 GET /api/report/frame/{templateId}:回显 amis CRUD 单行信封
{status:0,data:{items:[{__url}],total:1}},__url=/api/report/render/{id}?format=html&<查询参数>。
报表页是 amis crud——查询条件落 crud.filter(实测唯一能让 picker 正常加载选项的上下文;
独立 form 里 picker 弹窗恒空),单 html 列把 __url 渲成 <iframe>,JOR HTML 独立加载、CSS 隔离保真。
「选条件→查询」时 crud 携 filter 参数请求 frame→拿到带新参数的 __url→iframe 重载→按工程过滤刷新。

- reportParamsFrom:frame 专用,剥 format/tpl/page/perPage(crud 自动追加分页位),多值取首、跳空。
- buildFrameUrl:templateId 路径段 + 参数键值全 UTF-8 URL 编码,防注入(__url 注入 iframe src,
  编码确保 " & # / < > 不破坏 query 结构或逃逸属性);templateId 实为 view_template_id(UUID)编码无副作用。
- frameResult:单行信封。collectReportParams(/render)保持原有 format/tpl-only 行为不变(与 frame 分流)。
- ReportFrameTest:5 个纯逻辑单测(剥参/编码/信封/注入中和)。

design(含 Phase 2/3 实现纪要 + 认证根因)见 docs/plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md §6。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:02 +08:00
b1c818fb2d Merge feat/report-jor-rehost: JOR 报表引擎重宿主(Phase 1 后端 + /api/report)
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-25 17:56:50 +08:00
702b5e9229 feat(report): JOR(jatools)报表引擎重宿主 — platform-report 后端 + /api/report 端点
EIP3 真报表=jatools JOR 套打模板(非 amis 表格)。本批次把报表引擎重宿主进 EIP4
(复用客户已持有的预编译引擎 jar,非移植 900 源文件;非重建引擎)。Phase 1 后端完成+真验。

- platform-report 模块:18 个预编译 jar(jatools 引擎 + 改造版 BeanShell + itext/jxl/
  jsqlparser/jfreechart/barcode4j/zxing/…)经项目内 local-repo(install-libs.sh)正常依赖,
  打进 fat jar(BOOT-INF/lib 已确认,非 system scope)。
- ReportService:走 jatools.engine.ReportJob(查询参数 setParameter→declareExternalVariables
  →SQL ${PARAM});headless(java.awt.headless)。三格式 HTML/PDF/XLS。
- JatoolsConfig:把 EIP4 spring.datasource 注入引擎 System2.properties(无 CWD 文件依赖)+
  注册 CJK 字体供 PDF。
- ReportController:GET /api/report/render/{templateId}?format=html|pdf|xls&<查询参数>;
  按 templateId 从 view_template(type=200)的 <reportfile> CDATA 取 JOR 渲染;?tpl= dev 覆盖。
- SecurityConfig:X-Frame-Options DENY→SAMEORIGIN(报表查看器同源 iframe 内嵌;生产 nginx 单源)。

真验:全 reactor mvn clean install 绿(0 失败);8093 端点 GET /api/report/render/{id} 三格式
HTTP 200(HTML 48K/PDF 106K/XLS 21K);查询参数 PROJECTID 流进 SQL 48×;浏览器内 amis 菜单页
(查询表单+iframe 查看器)渲染出 JOR 套打报表(在建工程项目收付款信息表,公式列/分组小计/签字栏)。

边界:Phase 2 前端「报表页 body 换查看器」当前以单页 sys_page_schema 运行态改动演示(非本提交代码);
铺到全部 339 张 type=200 报表页 = Phase 3(转换器侧生成查看器 body)。数据保真须对完整客户库验证
(eip4dev 为部分 dev 库,部分报表源表缺)。design 见 docs/plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 17:56:50 +08:00
2ff826505f Merge chore/a10-w1-converge-bootstrap-single-source: db/migration 平台表单一真相
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-25 15:16:35 +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
b7fbae4cae Merge deploy/a10-w4-compose-demo-fix: W4 内置演示库自洽 + W1 真验文档对齐
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-25 15:01:02 +08:00
2db44a6231 fix(A10 W4): 内置演示库自洽起栈 + 文档对齐 W1 真验
整栈 docker compose up 对内置空 postgres 真起验证(本地 daemon + PG 15.15),
揪修并文档化两处:

- postgres-init/01-create-schemas.sql(新):首次初始化预建 eip3+flowable schema。
  原空库起 flowable-service 报 "no schema has been selected to create in"——
  platform-app 的 Flyway 会自建 eip3,但 flowable 的 Liquibase 不自建 schema。
- docker-compose.yml:postgres 挂载 postgres-init/;刷新过时头注释
  (W1 Flyway 已含,不再"假定 DB 已置备"自举平台表)。
- README:验证状态改为 2026-06-25 本地真验记录——
  platform-app 在 prod profile + W1 Flyway 启动自建 eip3 落 9 张 sys_* 表、
  readiness UP、nginx 单源反代 /api→401(prod 严格认证链生效);
  flowable-service 空演示库 by-design 无法起(databaseSchemaUpdate=false 红线,
  需预置 Flowable 6.8.1 引擎 DDL),已显式文档化边界。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 15:01:02 +08:00
f7675c9c2f Merge feat/a10-w1-flyway: A10 W1 Flyway 平台表迁移(本地 PG 真验)
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:44:26 +08:00
7b01e918e4 feat(A10 W1): Flyway 平台表迁移单一真相(本地 PG 真验)
platform-app 加 flyway-core+flyway-database-postgresql(10.10.0,Boot BOM 管版本);db/migration/V1__sys_page_schema/V2__sys_datastatus/V3__sys_ai_agent(DDL 从既有幂等 bootstrap 迁入,V2 去测试种子行);application.yml 启 Flyway(baseline-on-migrate + baseline-version=0,只管 EIP4 新增 SYS_* 平台表,不碰客户业务表);dev/local 的 spring.sql.init 收敛移除→app 运行态 provisioning 单一走 Flyway。FlywayMigrationLocalIT 对真实 PostgreSQL 15.18 验:①全新 schema→V1-V3 建全表+幂等;②既有非空 schema(已有 sys_page_schema+数据)→baseline V0→V1-V3 幂等应用、既有行不破坏(=客户库接管)。docker build 两镜像真验过(daemon 已起)。全 reactor mvn clean install 绿(无 surefire @SpringBootTest 受 Flyway 影响)。残留 follow-up:bootstrap-*.sql(ci.sh/AiAgentDdlTest/parity fixture 用)与 db/migration 文档级重复,全收敛(删 bootstrap/ci.sh repoint)后续。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:44:26 +08:00
f5f4754e5f Merge docs/a10-w1-spec: A10 W1 Flyway 规格 + ai-agent 单一真相注释
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:17:42 +08:00
2507d6c435 docs(A10 W1)+bootstrap: Flyway 执行规格 + ai-agent 单一真相注释
承接 afee2d5 去重:A10 design 补 §3.1 W1 Flyway ready-to-run 规格(迁移清单/baseline-on-migrate=0/跨模块 ai-agent/spring.sql.init 收敛/dev-PG 验证门);platform-ai bootstrap-ai-agent.sql 头注释标注为唯一 classpath 源(platform-app 经依赖传递消费)。纯文档/注释,全 reactor 已绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:17:42 +08:00
11e668a455 Merge fix/dedup-ai-agent-bootstrap: 去重 bootstrap-ai-agent + A10 W1 Flyway 规格
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:16:08 +08:00
afee2d5083 fix(bootstrap)+docs(A10 W1): 去重 bootstrap-ai-agent + Flyway 执行规格
去重(§10.2 两份易漂移实锤):platform-app 与 platform-ai 各有 bootstrap/bootstrap-ai-agent.sql 且同 classpath 路径(platform-app→platform-ai 依赖传递)→spring.sql.init 解析歧义。删 platform-app 副本,单一真相归 platform-ai;dev/local 配置经依赖传递解析到该文件不变;AiAgentDdlTest 仍读自身副本。全 reactor mvn clean install 绿。A10 design 补 §3.1 W1 Flyway ready-to-run 规格(迁移清单 page-schema/datastatus/ai-agent + baseline-on-migrate=0 + 跨模块 ai-agent 处理 + spring.sql.init 收敛 + dev-PG 验证门);W1 代码未发=动客户库启动路径且 headless 无法验 migrate(PG 专有 SQL/无 PG/daemon 未起无 testcontainers),接 PG 即可执行。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:16:08 +08:00
97a0eb12ae Merge feat/a10-mvp-containerization: A10 MVP W2-W4 部署骨架
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:05:56 +08:00
ade4c928bb feat(deploy): A10 MVP W2-W4 容器化+nginx 单源+compose 编排骨架
platform-app/flowable-service Dockerfile(JRE21+非root+COPY 预构建 jar+健康探针);deploy/nginx.conf(单源:serve dist+反代 /api、/flowable);deploy/docker-compose.yml(4服务 postgres+platform-app+flowable-service+nginx,healthcheck/depends_on);deploy/.env.example(prod 密钥/DB env,fail-fast);deploy/systemd/*(D3 禁Docker客户兜底);deploy/README.md。验证:docker compose config 通过(4服务+插值);docker build 待 daemon(本机未起,已诚实标注)。验证揪修 flowable-service 双数据源 FLOWABLE_JDBC_*/BIZ_JDBC_* env 漏传。.gitignore 加 deploy/.env。W1 Flyway 下一批次:当前 compose 假定 DB 已置备,尚不能从零自举。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:05:56 +08:00
997d51c5a4 Merge docs/a10-prod-eng-design: A10 生产上线工程化 design
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:53:12 +08:00
191c2baf60 docs(A10): 生产上线工程化 design(待拍板 D1-D6 + W1-W6)
钉在现状的工程化设计:现状底数(2 SB 进程 platform-app/flowable-service + PG + 前端;散落 bootstrap SQL 含 bootstrap-ai-agent 两份;无 docker/nginx;PG/Flowable runbook 备而未执行)+ 目标四服务拓扑 + W1-W6 分解(Flyway 收敛/容器化/nginx 单源/compose/runbook 执行/性能灰度)+ D1-D6 待拍板(单源形态/Flyway 范围/是否容器化/密钥/灰度/生产 PG)。关键边界:保真层跑客户既有 eip3 库,EIP4 只新增平台表,Flyway 仅管新增表 baseline-on-migrate。MVP=W1-W4 不卡环境可 headless 做。§3 A10 + §7 nav 已挂。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:53:12 +08:00
6e144447ee Merge feat/parity-nightly: 夜间对拍 job(§10.2 对拍解冻)
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:47:03 +08:00
9dbba1b272 ci(P1 §10.2): 接夜间对拍 job 解冻对拍框架
新增 .gitea/workflows/parity-nightly.yml(cron 每日 02:00 CST + workflow_dispatch,跑 scripts/ci.sh 全量 seed+all+privilege 对拍 + 归档报告)。ParityCli 本就直连 JDBC 基线 vs 引擎 REST 逐行 diff、不一致退出码 2=「非0即阻断」内建;此前只 push 时跑,无提交的日子不跑→隐性漂移逃逸。夜间 job 补上。RowDiffTest 30/30 框架健康。§10.2 标 🟡:真正重拍刷新基线需 dev/CI 起引擎+真 DB 实跑(headless 跑不了),激活需 Gitea runner;--discover/--realprivilege 纳硬门前需真跑核实退出语义。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:47:03 +08:00
bbdeee3af7 Merge docs/scriptcommands-noop: §10.2 scriptCommands 有界修标记
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:40:35 +08:00
bcfb8f7102 docs(总览): §10.2 scriptCommands 哑火标记有界安全修完成(2026-06-25)
6 哑火动词改显式跳过+告警(eip4-web 68d797e);完整动态必填/选项/过滤需转换器侧数据绑定属 L 留排期。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:40:35 +08:00
afc1a8ca62 Merge docs/ai-agent-srp-done: §10.2 AiAgentService SRP 完成标记
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:20:00 +08:00
fa63d1c654 docs(总览): §10.2 AiAgentService SRP 收窄标记完成(2026-06-25)
AiAgentService 1846→1329(-28%):SQL 簇→AiDeploymentSqlBuilder、门禁簇→AiDraftGateValidator,行为零变更 platform-ai 79 全绿;AiRunStore 丢弃(持久化已在 AiAgentStore)。反映 origin/main 285d601。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:20:00 +08:00
285d601c3d Merge feat/ai-agent-service-split: AiAgentService SRP 收窄(§10.2,抽 SQL/门禁两簇)
Some checks failed
ci / build-test-parity (push) Has been cancelled
1846→1329 行(-28%):部署/回滚 SQL 簇→AiDeploymentSqlBuilder、草稿门禁电池→AiDraftGateValidator,各带黄金/直测;行为零变更(platform-ai 79 全绿),全 reactor mvn clean install 绿。AiRunStore 丢弃(持久化已在 AiAgentStore)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:18:53 +08:00
b409f9757f refactor(ai): 抽 AiDraftGateValidator 收窄 AiAgentService(§10.2 SRP slice 2)
把按 artifact 类型分发的门禁电池(validateDraft + 必填/amis-schema/typed-page-schema/page-recipe/实体/服务流XML/菜单/smoke-plan/render-plan 各 gate + SchemaGate 懒加载状态 + 4 个正则常量 + XML/数组校验 helper)逐方法移入新 AiDraftGateValidator;判定逻辑零变更(D3 红线焊在门禁里,搬迁不动阈值/正则/分支)。AiAgentService 1677→1329 行(累计自 1846 -28%),委托 validateDraft/validateSchemaGate/validateTypedPageSchema/typedMessages。新增 AiDraftGateValidatorTest 7 用例直测各类 pass/fail;AiAgentServiceTest 22/22 + AiAgentControllerTest 11/11 + pipeline 行为不变,platform-ai 79 全绿,全 reactor 绿。slice 3(AiRunStore)经评估丢弃:持久化已由现有 AiAgentStore 承担,另抽会重复。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:18:53 +08:00
1a57000458 refactor(ai): 抽 AiDeploymentSqlBuilder 收窄 AiAgentService(§10.2 SRP slice 1)
把 AiAgentService 内联的部署/回滚 SQL 生成簇(deploymentSql/serviceFlowSql/pageSchemaSql/menuSql/rollbackSql/serviceFlowRollbackSql/entityDeploymentNote + json/sqlString/sha256)逐字移入新 AiDeploymentSqlBuilder(构造取 ObjectMapper,终构造器内 new,不改对外构造签名);AiAgentService 1846→1677 行,SQL 文本字节零变更(红线逐字节对拍)。新增 AiDeploymentSqlBuilderTest 8 用例钉死关键 token(表名/AI_AGENT 审计字面量/ON CONFLICT/version+1/::xml·::jsonb/单引号转义/占位符回退/entityId 替换);AiAgentServiceTest 22/22 行为不变,全 reactor 绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 13:00:32 +08:00
1102601424 Merge docs/p0-security-closeout: 进度总览 §10.1 安全 P0 收口
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 12:43:47 +08:00
add67353b0 docs(总览): §10.1 四项 P0 安全 + 评审 2 孪生 + Groovy 沙箱标记收口(2026-06-25)
§10.1 表 4 项 🔴critical→✅已修(06-25)+补安全基线批次落地块(逐项 commit/手法/验证/运维 checklist/DEFER);§0 加安全基线收口行。反映 eip4-platform eba9ce1 / eip4-web 2a37251。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 12:43:47 +08:00
eba9ce1fc1 Merge feat/groovy-sandbox-hardening: 强化 Groovy 沙箱拦 RCE 原语
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-25 安全评审 DEFER 的 MEDIUM:硬化 SecureASTCustomizer/MethodCallExpressionChecker(反射/进程执行/元编程/动态求值全拒),收口所有 Groovy sink(ScriptReplay/EditGrid/服务流)的残余沙箱弱点。TDD+1428 脚本语料零回归,全 reactor 绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 12:18:16 +08:00
9526e43a15 security(P0 followup): 强化 Groovy 沙箱拦 RCE 原语(2026-06-25 安全评审 MEDIUM)
SecureASTCustomizer import 白名单挡不住内联全限定名/反射/元编程/GDK 进程执行;旧 checker 仅禁 System.exit。强化 MethodCallExpressionChecker:按危险接收类(Runtime/ProcessBuilder/Process/ClassLoader/Thread/GroovyShell/GroovyClassLoader/Eval/javax.script.*/java.lang.reflect.*)+ 通用危险方法名(exec/execute/forName/newInstance/loadClass/getClassLoader/invoke/getDeclared*/get|setMetaClass)拒;System 仅拒危险方法(exit/getenv/getProperty/setProperty/load…)保留 out;metaClass 属性拒;覆盖 MethodCall/StaticMethodCall/ConstructorCall/Property。覆盖两条运行时 Groovy 路径(服务流 + onEvent/editgrid 重放,均经 SecureGroovyScriptEngineFactory)。纯 AST 零 com.eip4 依赖。TDD 8/8;1428 改写脚本语料编译零加固回归(103 失败全为 test classpath 缺 Vaadin/app 类,与加固无关)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 12:18:16 +08:00
0e0311abbd Merge feat/p0-security-hardening: P0 安全洞收口(2026-06-24 架构评审)
Some checks failed
ci / build-test-parity (push) Has been cancelled
①permitAll fail-open→fail-safe profile+prod配置+JWT弱密钥守卫 ②asUser/roles 越权 JWT 身份权威(EntityController+PickerController) ③脚本RCE/任意DROP拆控制器隔离+路径穿越守卫+Poc门禁+TodoController advanced-script 守卫 ④CI孤儿迁Gitea+JDK21。含独立 security-reviewer 对抗评审揪出的 2 个孪生漏洞(TodoController RCE/PickerController IDOR)。全 reactor mvn clean install 绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 11:41:37 +08:00
1a0985ffa5 ci(P0④): CI 孤儿迁 Gitea Actions + JDK21 + ci 旁路 profile
.github/workflows/ci.yml(GHA 语法在 Gitea 上孤儿+JDK17 写死)迁至 .gitea/workflows/ci.yml(JDK21)。ci.sh 起服务加 --spring.profiles.active=ci(配合 P0① fail-safe,否则健康检查 401/对拍免令牌失效)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 11:41:21 +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
980d83ed15 security(P0③): 脚本端点拆分隔离 RCE + 路径穿越守卫 + Poc 控制器门禁
拆 ScriptExecuteController(执行请求体任意 Groovy=RCE)为 @Profile(BYPASS) 仅非生产装配;生产改写脚本重放迁至新 ScriptReplayController(只取脚本库内已审产物)。RewrittenScriptStore.load 加 templateId 路径包含校验(resolve+normalize+startsWith,+NUL 字节兜底)防穿越读库外脚本。三个 Poc*Controller(含裸拼 DROP TABLE)全 @Profile(BYPASS)。抽 ScriptFacadeRunner 共享。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 11:41:21 +08:00
1f2365fa26 security(P0②): buildCtx JWT 身份权威,关 asUser/roles 冒充提权(IDOR)
EntityController 与孪生 PickerController 的 buildCtx 调换优先级:JWT 已绑定的认证身份恒优先,客户端 asUser/roles 仅在无 JWT 身份时(非生产旁路)生效。杜绝已认证用户传 asUser=他人/roles=ADMIN 冒充提权读越权数据。PickerController 实例由独立安全评审揪出(原架构评审 under-scope)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 11:41:21 +08:00
24160db684 security(P0①): 安全链改 fail-safe 默认 + prod 配置 + JWT 弱密钥守卫
宽松 permitAll 链由 @Profile("!prod") 改为显式 opt-in @Profile(dev|local|ci|parity);严格认证链覆盖默认(含裸 java -jar)与 prod。新增 SecurityProfiles 作旁路名单唯一真相、JwtSecretSafetyCheck(严格 profile 下拒开发默认密钥启动)、application-prod.yml(密钥/DB 无默认强制环境变量)。修 2026-06-24 架构评审 P0:未设 profile 即全放行的 fail-open 默认。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 11:41:21 +08:00
a132e67a20 Merge feat/arch-review-followup: 架构评审改进批次(A4 ArchUnit/稳定性三件套/A5 AiReleaseWriter/可观测性/D5 LocalHostPolicy)
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-24 11:31:21 +08:00
03a514e57f docs(总览): 标记 B2(删 overlay 死代码)完成
B2 代码在 eip4-web 分支;本提交同步总览 §10 B2 状态。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:22:47 +08:00
8df60e810c docs(总览): 标记 B4(isAdminProfile 收口)完成
B4 代码在 eip4-web 分支 feat/arch-review-followup(commit 768ffa8);本提交仅同步总览 §10 B4 状态为已完成。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:20:24 +08:00
c4ef673b0a refactor(ai): 三处本机判定统一到 LocalHostPolicy(D5)
AiToolRegistry/AiSmokeRunner/AiLocalReleaseExecutor 原各写一份本机白名单且互异(一处认 0:0:0:0:0:0:0:1 漏 [::1],另两处反之)。
新增 LocalHostPolicy.isLocalHost:去 IPv6 方括号归一 + 精确比对回环集 {localhost,127.0.0.1,::1,0:0:0:0:0:0:0:1},杜绝 127.0.0.1.evil.com 伪本地绕过;三处删副本统一委托。
验证:新增 LocalHostPolicyTest(全回环形态接受 + 伪本地/非本机拒绝)3/3 + 三处既有测试无回归,platform-ai 69/69 绿。见总览 §10 D5。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:12:22 +08:00
21a181f44b feat(observability): Actuator 健康端点 + 滚动日志 + base 日志降噪
总览 §10.2 可观测性:
- platform-app 加 spring-boot-starter-actuator,management 只暴露 health(开 liveness/readiness 探针,show-details when-authorized 不泄露 db 等组件细节);不上 Prometheus 全家桶
- SecurityConfig.PUBLIC_PATHS 加 /actuator/health(/**),prod 链探针免认证可达
- 新增 logback-spring.xml(控制台 + 50MB×14 天滚动文件,文件 appender 仅 dev/local/prod 启用,不污染单测)
- base application.yml 日志 com.dsasp/jdbc.core DEBUG→INFO(prod 继承 INFO,dev 仍 DEBUG);.gitignore 忽略 logs/
验证:真启动 dev profile(1.7s)curl /actuator/health=200 {UP,groups:[liveness,readiness]} + readiness/liveness 均 200 UP;SecurityProfileTest 3/3 + ArchitectureRulesTest 6/6 无回归。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:05:33 +08:00
378fd74682 refactor(ai): AI 本地发布裸写下沉到 AiReleaseWriter + 补值断言测试
A5 安全半步:把 AiLocalReleaseExecutor 里所有 sys_serviceflow/sys_menu 裸 JDBC(含 ensureAiMenuParent/tableExists/实体复用查询)收拢到新类 AiReleaseWriter,执行器只剩编排;SQL 逐字保留=零行为变更。
新增 AiReleaseWriterTest 4 值断言(serviceflow 审计/?::xml/bool→int、菜单 INSERT 全列值、UPDATE 全字段、自动建「AI Agent」目录),补上原黄金测试只查表名的宽松缺口。
platform-ai 30/30 绿(黄金测试经搬迁仍绿=行为未变)。与人走五环 MenuRegistrar 的完整统一(两者已分叉)留作专项,见总览 §10 A5。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 10:52:25 +08:00
49e745912d docs(总览): 新增 §10 架构改进待办,合并外部评审并纠偏严重度
8 维度架构评审 + 逐条核实其他 agent《架构分析与改进建议》(已删除,内容并入):
- 真 P0:script-execute RCE / permitAll fail-open / asUser 越权 / CI 孤儿
- 可采纳工程项:A4 ArchUnit / A5 写收口 / D1 render runner / D5 LocalHostPolicy / 前端去重
- 严重度纠偏:ColumnSQL 不可达降 low、deleteByType 已缓解、A2 归因更正
标记 A4 与稳定性三件套已完成(含验证证据)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 10:36:41 +08:00
0106088084 feat(stability): perPage 封顶 + statement_timeout + 连接池 5→20
防 perPage=999999 一次物化全表致 OOM/连接耗尽:
- Pagination.clampPerPage(上限 5000,安全护栏非产品限),接入 FlowController/PickerController 两 REST 入口(page 不封)
- application.yml 加 hikari.connection-init-sql=SET statement_timeout='${EIP4_DB_STATEMENT_TIMEOUT:120s}'(dev/local/prod 继承 base,可覆盖/设0关闭)
- maximum-pool-size 5→20(prod 无 profile 继承 base 受益)
验证:68/68 绿(PaginationTest+经真实 executeGet 集成+无回归);statement_timeout 经真实 PG SHOW=2min。见总览 §10.2。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 10:36:41 +08:00
ffe89e62bf test(arch): ArchUnit 规则 1→6 条(强制+棘轮),锁住控制器分层债务
强制:库模块(converter/parity)不得依赖应用编排层 + 模块切片无环。
棘轮(基线化存量、只挡新增):控制器不得新增直用 JdbcTemplate(26)/互相注入(4)/Poc 调试控制器(3)。
架构允许 com.eip4→com.dsasp,故不拦控制器调引擎,只拦直拼原始 SQL。
验证:6/6 绿,临时探针走完整 RED→GREEN 确认棘轮非空绿。见总览 §10 A4。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 10:36:41 +08:00
850c6501b2 Merge fix/cli-frontmatter-yaml: SKILL.md frontmatter YAML 引号加固
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 09:57:05 +08:00
e26d5d5bfb fix(cli): SKILL.md frontmatter 用 YAML 引号标量,防 description 破坏解析
runInit 此前裸拼 `description: <raw>`,含 ASCII 冒号或前导 */#/& 等的
description 会破坏 Claude 读取 SKILL.md frontmatter。改为 yamlScalar 双引号
+ 转义 \ 与 "(name 同处理)。当前 7 个 description 用全角冒号本无碍,此为加固。
测试 +1(tricky description 含冒号/星号仍输出合法引号标量)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 09:57:05 +08:00
32d12440e0 Merge feat/agent-onboarding-followup: agent 接入补全 + amis-pitfalls skill
修 page-recipe recipe-id 400 bug、补 token/MCP/REST 分流接入说明、
新增 eip4-amis-pitfalls skill,并加 bundled skills 防漂移测试。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 09:50:36 +08:00
1eb690124b feat(cli): 新增 eip4-amis-pitfalls skill
把散落的 amis 实战坑收敛成「写 amis schema 的 agent」可直接用的规则 + 必实测铁律:
单选 selectedItems 是 Option 对象非数组、树 >100 节点虚拟列表破坏选中、
空列表兜底 items:[]、quickEdit.needConfirm 须显式 false、
行级按钮 dialog 按 name 自动回填同名字段、onEvent 需按钮 id 等。

manifest 登记为第 7 个 skill,由 initInstallsAllBundledSkillsWithoutDrift 守护端到端可装。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 09:50:23 +08:00
0e457d9945 feat(cli): agent 接入补全(token/MCP/REST 分流)+ 修 page-recipe recipe-id
- fix: page-recipe 的 maintenance-crud 漏 `-v1`,而 compile 端点精确匹配
  maintenance-crud-v1,agent 照抄示例会 400;统一为 -v1,并引导以
  GET /api/ai/page-recipes 为权威列表,避免硬写字面量漂移。
- env-manage 新增「鉴权/Token」段:非 prod profile permitAll 免 token,
  prod/JWT 环境需 POST /api/auth/login 取顶层 `token` + `Authorization: Bearer`
  (核实 AuthController/JwtAuthFilter)。
- AGENTS.md(writeAgentsMd):把「优先 platform-cli」误导修为按类分流
  (env/ai/release 用 CLI,建模/页面/授权用 REST 或 platform-mcp),
  并点名 platform-mcp 注册方式 + token 获取指引。
- data-modeling/page-recipe/acl-manage 各加调用方式与 token 交叉引用。
- 测试 +3:page-recipe recipe-id 回归、AGENTS.md MCP/auth、bundled skills 防漂移。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 09:50:23 +08:00
daad6ea196 Merge docs/readme-skills-cli: README 补 skills list/check
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-22 14:57:07 +08:00
a573d8fa2c docs(readme): 平台 README 命令段补 eip4 skills list/check(G3 收尾)
G3 当时只更新了 docs/skills/README,平台主 README 的 EIP4 Agent CLI 段漏了 skills 命令。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 14:57:07 +08:00
d1cdcc70b4 Merge feat/agent-onboarding: AI agent 接入补齐 (G1+G2+G3)
Some checks failed
ci / build-test-parity (push) Has been cancelled
对照 NocoBase 的外部 coding-agent 接入差距,补齐三格:
- G1 (5b06aec) eip4 init 一键接入 Claude Code/Codex/OpenCode
- G2 (4a2080a) platform-mcp MCP server(7 工具,stdio)
- G3 (8a6c94e) skills 补全(data-modeling/page-recipe/acl-manage)+ eip4 skills list/check

platform-cli 22 单测 + platform-mcp 9 单测全绿,真实 e2e 验证通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 14:54:30 +08:00
8a6c94ebde feat(cli): eip4 skills list/check + 3 个新 agent skill (G3)
- 新增 skill(均基于源码核实过的端点):
  - eip4-data-modeling — /api/meta/entity 建实体/加字段/引用列/主子表
  - eip4-page-recipe   — /api/design/recipe/compile 生成默认页(维护/树/主子表)
  - eip4-acl-manage    — /api/admin/* 菜单/角色/用户组授权
  manifest.json + jar 打包同步,docs/skills 现共 6 个
- CLI 新增 eip4 skills list(列内置 skills)+ skills check --dir(缺失退出非 0)
- TDD 2 个新测试,platform-cli 共 22 单测全绿
- 真实验证:skills list 列 6 个 / init 装 6 个 / skills check 全 installed(exit 0)/ 端口渲染零占位符残留
- serviceflow-diagnose 暂缓:平台无「查看/诊断服务流定义」的 agent 可操作端点(需先补端点)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 14:47:31 +08:00
4a2080a4f6 feat(mcp): platform-mcp —— EIP4 MCP server 标准接入 Claude Code/Codex/OpenCode (G2)
- 新增 platform-mcp 模块(stdio MCP server,MCP Java SDK 1.1.0 / jackson2 路线)
- 注册 7 个 MCP 工具:eip4_auto_develop / list_page_recipes / validate_page_schema
  / list_components / access_check / list_entities / entity_attributes
  忠实转发 EIP4 REST,复用人审红线(产物恒 READY_FOR_HUMAN_REVIEW),不另开权限面
- 工具逻辑 TDD(Eip4McpTools 9 单测,注入 mock REST client)
- 真实 stdio JSON-RPC e2e:initialize 协商 + tools/list 返回 7 工具(schema 正确)
  + tools/call 链路(死端口优雅 isError)
- 坑:父 pom 为 amis 校验钉死 networknt 1.5.2,与 MCP 需要的 2.0.0(含 dialect.Dialects)
  冲突 → platform-mcp 显式覆盖 2.0.0(仅本模块)
- 文档:GAP 标记 G2 完成、平台 README + skills/README 加 MCP 接入说明

接入:claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url <env>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 14:37:02 +08:00
5b06aeceff feat(cli): eip4 init 一键接入 Claude Code/Codex/OpenCode (G1)
- 新增 eip4 init:把 agent skills 装到目标项目
  - Claude Code → .claude/skills/<name>/SKILL.md(代码生成 frontmatter)
  - Codex/OpenCode → 根 AGENTS.md(EIP4-SKILLS 标记块,内嵌 skill 全文,块外保留,幂等)
  - base URL 按 --base-url/--env/current env 渲染
- docs/skills/*.md 的 base URL 改为 {{EIP4_BASE_URL}} 占位符
- 新增 eip4-skills/manifest.json + pom 用 maven-resources-plugin 把 docs/skills 打进 jar(init 默认从 classpath 读,无需仓库在场)
- 文档:AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN(NocoBase 对照 + G1-G3 计划)、skills/README、平台 README
- TDD 5 个新测试,platform-cli 共 20 单测全绿;真实 jar 端到端验证通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 14:14:26 +08:00
2fc093f25e Merge branch 'feat/ui-empty-list-fix' into main
Some checks failed
ci / build-test-parity (push) Has been cancelled
生成页 5 个 UI/UE 缺陷(dogfooding 实测):①空列表红横幅 ②子表<空>占位 ④主子表编辑
子行不回显 ⑤主子表LIST列泄漏成JSON ⑥树加子预填父名。481单测+逐个浏览器复验。
2026-06-22 12:22:37 +08:00
0400d92a15 Merge branch 'feat/p0-ddl-guard' into main
P0② net-new 裸 JDBC 旁路收口:CREATE/DROP DDL 守卫白名单(CreateTableSqlGuard/
DropTableSqlGuard),对标已有 AlterTableSqlGuard。TDD+对抗审查(MERGE-ABLE)+478单测+
真库e2e+5浏览器e2e全绿。
2026-06-22 12:22:36 +08:00
f90e11686e fix(ui): 树页「加子」表单预填父节点名(dogfooding 实测)
树页点行级「加子」时,新增子节点表单的「名称」被预填成父节点的名字
(要先清空才能输入)。根因:加子对话框从行级按钮打开会继承父行数据作用域,
业务字段按 name 自动从父行回填。修:PageBlueprintCompiler.addChildAction —
① 表单 data 只播 PARENTID=父主键(从父行求值);② canAccessSuperData:false
关掉按 name 自动取父作用域值。对话框标题仍用外层作用域显「在<父名>下新增」。

验证:481 单测(PageBlueprintCompilerTest 加子表单 data.PARENTID + canAccessSuperData
断言);重启 8094+重生成树页+浏览器实测:加子表单名称空白、标题「在华东区下新增」、
保存后 PARENTID 正确指向父节点(上海分部→华东区,psql 核实)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 11:48:56 +08:00
ea69edf18b fix(ui): 主子表编辑态两个 dogfooding 真 bug(子行不回显 + LIST 列泄漏成 JSON 文本框)
实际走完 CRUD 闭环(新增→保存→编辑)揪出,纯功能 e2e 测不到:

1. 编辑态子表子行全空(若保存会丢子行):编辑表单 initApi=_LOAD 返
   {data:{result:{TITLE,DETAILS:[子行]}}},但表单字段期望顶层名 → 子表
   input-table(name=DETAILS)绑不上 result 内子行数组。主字段"看似"回显仅因选中行
   铺进了对话框作用域(非 _LOAD 生效)。修:PageBlueprintCompiler 编辑表单 initApi 加
   responseData {"&":"${result}"} 把 result 拆到表单数据顶层。

2. 主子表发布后再 compile,主表单冒出一个显原始 JSON 数组的"明细"文本框 + 列表列 +
   查询条件:主子表链接给主实体加了 DETAILS(LIST)列,而 refToApiType("LIST") 因
   长度<32 落 default→"string",被当普通字段渲染。修:EntityAttributesService 排除
   引擎内部列 LIST/BLOB/STATUS(非可建模标量列,与 appendColumnDdl 跳过集一致),
   从源头不进属性表→表单/列表/查询/建模器字段表都干净。

验证:platform-metadata 481 单测 0 失败(PageBlueprintCompilerTest 编辑表单 responseData
断言 + EntityAttributesServiceTest LIST/BLOB/STATUS 不可建模 3 测);重启 8094+重生成页+
浏览器编辑实测:子行 钢筋/3/10/30 正确回显、无 JSON 文本框、列表/查询只剩 标题。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 11:20:20 +08:00
5e55f7f37f fix(ui): 净新生成页空态两个 UI/UE 缺陷(空列表红报错 + 子表「<空>」占位)
走查主子表生成页发现并修:

1. 空列表弹红横幅「data.items 必须是数组」(每个 0 行列表页都中):
   FlowController.unwrapCrudResult 对空搜索 {result:{}}(空 map,引擎零行
   省略 listresult/pagecount)兜底拍平为 {items:[],total:0}。此前 normalize
   的空列表特判只认 LIST_RESULT/PAGE_COUNT,{result:{}} 漏网 → amis crud 找不到
   items 数组。仅当内层为空 map 才兜,单记录 _LOAD(result 含字段)不受影响。

2. 空子表渲染字面量「<空>」(像占位符泄漏):
   PageBlueprintCompiler.childInputTable 给 input-table 加友好 placeholder
   「暂无明细,点下方「新增」添加」。

验证:platform-metadata 478 单测 0 失败(新增 FlowControllerTest 5d 空 {result:{}}
→{items:[],total:0}、5e 非空单记录不被误伤);重启 8094 浏览器实测:空列表只显
「暂无数据」无红横幅(console 0 error,原 1)、空子表显友好占位。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 10:57:19 +08:00
2da1a0ef29 feat(P0②): net-new 裸 JDBC 旁路收口 —— CREATE/DROP DDL 守卫白名单
补齐 DDL 三件套(原仅 ALTER 有 AlterTableSqlGuard):

- CreateTableSqlGuard(legacy-core,纯静态)+ 接入 executeCreateSql:
  原 startsWith("CREATE ") 漏过 CREATE TRIGGER/FUNCTION/INDEX/EXTENSION
  及单语句 CTAS(CREATE TABLE X AS SELECT...)。守卫收窄为引擎仅有的两条
  生成路径:CREATE TABLE(<列>) [+ devDB 的 INSERT INTO order_entity 第二句],
  其余(注释/子查询/AS/USING/跨表 DML/LIKE/INHERITS/PARTITION/多语句)一律拒。

- DropTableSqlGuard + DataDicService.executeDropSql,dropEntity 改走它:
  原裸拼 "DROP TABLE IF EXISTS "+t 仅 startsWith("EIP4"),对 PathVariable
  EIP4X;DROP TABLE SYS_USER 是真实分号注入面。守卫只接表名,整串白名单
  matches(EIP4[A-Z0-9_]{0,37}) → 拼安全 DROP,从根上关闭注入。

对抗审查(security-reviewer,40+ payload)收口 3 项:
- PocWriteTestController 检查 executeCreateSql 返回值(原吞掉守卫拒因)
- appendColumnDdl 数值列 DEFAULT 只许数值字面量(防 raw-append 注入)
- LIKE/INHERITS/PARTITION 补入 DENY,与「其余一律拒」契约一致

验证:legacy-core+metadata 478 单测 0 失败(新增 Guard 14+7、生成器 +2);
真库 e2e scripts/p0-createdrop-acceptance.sh 全绿(建表/删表/非EIP4负控),
p0-alter-acceptance.sh 无回归。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 10:15:41 +08:00
1d1ae9c717 Merge branch 'feat/p0p1-impl' into main
Some checks failed
ci / build-test-parity (push) Has been cancelled
P0②引擎ALTER安全通道+安全门enforced+审计 / P1⑥运行时DELETE+菜单授权 / 对抗审查收口4major / 06-21文档对齐

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 15:31:52 +08:00
2d1e9d143b docs: §9/README 回写——已提交分支 + 对抗审查修复 + P1③双重阻塞
- §9 实施记录:代码已提交 feat/p0p1-impl(改"未commit");补对抗审查4major修复
  + overlay审计实跑发现 + 部署包下沉调查结论(两生成器现等价无bug)
- §9/README:P1③ framework业务106 标双重阻塞(待S1拍板 + EIP-3.0源码本地未克隆)
- README §4:P0②/P1④/P1⑥/P1⑤ 标✅已实施(指向总览§9)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 15:29:00 +08:00
46ff5c5779 fix(P0②/P1⑥): 对抗审查收口 4 major + minor
对抗审查 workflow(3 lens)揪出并修复:
- [major] AlterTableSqlGuard 移除 ALTER COLUMN TYPE:静态守卫拿不到旧尺寸,无法
  保证扩长(varchar(1)/numeric(1,0) 缩短会截断/溢出存量数据),一律拒;扩长须由
  MetaController 比对旧列长度后再生成
- [major] addAttributes 校验-写分离 + @Transactional + ALTER 失败抛异常:
  杜绝「元数据写了但物理表没加」孤儿(PG 事务性 DDL 一起回滚)
- [major] createEntity 检查 executeCreateSql 返回值 + @Transactional:引擎拒建表
  不再静默成功
- [major] AiToolRegistry isLocalEnv/isProductionEnv 改 URI host 精确解析:防
  http://127.0.0.1.evil.com / localhost.evil.com 伪本地前缀绕过安全门
- [minor] deleteStandard templateId trim + 菜单查询限 isactive=1(两表口径一致,
  不连带删历史同 templateId 菜单/授权)
- [minor] publish roleIds 只接 String 元素(滤 null/非串);warning 改依据
  roleIds.isEmpty()(重复发布不误报)
- [minor] menuauth grantToRoles 改 INSERT...WHERE NOT EXISTS(sys_role_menu 无
  唯一约束,ON CONFLICT 不去重,重复发布会插重复行)+ columnSqlType 空 refTable 抛错

全单测绿(Failures=0)、p0-alter/p1-6 真库验收绿(含幂等+负控)、浏览器 e2e 6/6 绿

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 14:15:29 +08:00
ccbed82498 feat(P0②b/P1⑥): overlay审计+strict分流 + 运行时DELETE + publish菜单授权
- PageSchemaController: ?strict分流(白名单外组件可选400,默认warn不破存量)
  + GET /api/page/schema/overlay/audit 白名单对账(只读advisory)
- 运行时DELETE: PageSchemaWriter.deleteStandard + DELETE /api/page/schema/{tpl}/standard
  (@Transactional对称撤销:删schema+overlay+软删菜单+清sys_role_menu)
- 菜单授权: MenuRegistrar.grantToRoles(复用sys_role_menu ON CONFLICT范式)
  + PublishOrchestrator.grantMenuRoles + DesignFeatureController.publish透传roleIds(缺省warning)
- 单测 PageSchemaWriter6/MenuRegistrar4/PageSchemaController28/DeploymentPackageBuilder1无回归
  scripts/p1-6-acceptance.sh 真库验收(授权落库+负控+DELETE级联+GET404)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 13:56:14 +08:00
8b28595f9e feat(P0②): 引擎ALTER安全通道 + AI安全门enforced
- AlterTableSqlGuard(legacy-core,纯静态白名单):只允许 加列/同族扩长/改可空,
  拒 DROP COLUMN/RENAME/SET NOT NULL/多语句/跨族/小写绕过;放legacy-core避免反向依赖
- DataDicService.executeAlterSql 受控通道(过Guard再execute,defense-in-depth)
- MetaController POST /api/meta/entity/{table}/attributes 加列端点
  (saveAttr元数据+alterAddColumnDdl镜像appendColumnDdl类型映射+evictByTable+补索引,恒可空)
- AiAgentService.applyLocalRelease 织入 AiToolRegistry.check:安全门 advisory→enforced
  (local.apply工具身份,非本机/越权写路径403)
- 单测 Guard15/alter2/gate22(112基线无回归);scripts/p0-alter-acceptance.sh 真库验收

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 13:56:14 +08:00
624ffe8a15 docs: 06-21 进度文档对齐 + P0/P1 实施记录
- 新建 项目进度与路线-总览-2026-06-21(取代06-17版),刷新A/B矩阵+增量交付+下一步+§9实施记录
- README 索引刷新到06-21;旧总览+14份过时/已完成文档加状态横幅;落地路线图回写里程碑

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 13:56:14 +08:00
75f942bca0 Merge branch 'feat/human-five-ring' into main
Some checks failed
ci / build-test-parity (push) Has been cancelled
人走五环建新功能(设计中心新建入口) + 主子表 v1 完整四件:基础 master-detail、
派生字段(金额=数量×单价)、父级汇总(总额=之和)、引用驱动联动(选物料→带出单价/规格)。
platform-metadata 468 单测 + Playwright 真事件 e2e 全绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 22:34:52 +08:00
63e6522f3b feat(主子表): 引用驱动联动(选物料→带出单价/规格) onEvent setValue
子表引用列渲染 picker select,选中后 onEvent.change → setValue 按映射把所选引用行的列
自动带出到同行其它子列。隔离 Playwright 钉死正确形态:单选 select 的 selectedItems 是
被选 Option 对象本身(非数组),value=${event.data.selectedItems.<src>} 绝不可加 [0]
(上一会话 fill 失败真因);目标列 id=<col>_${index} 挂列上,needConfirm:false 下仍被命中。

- PageBlueprintChild: Linkage(refColumn,List<Fill>) / Fill(target,source) 模型 + 兼容构造
- PageBlueprintCompiler: 引用子列→select(source=/api/picker/{ref}/list, options=${items},
  _label/_id)+onEvent setValue;目标列挂 id;effectiveFills 剔除派生目标/同目标去重/
  仅合法引用 refColumn 渲 select(对抗评审加固,防 setValue 落空与串台)
- TypedPageSchemaValidator: 仅 onEvent.<event>.actions[] 锚定放行 setValue 白名单(D3 门收窄)
- DesignFeatureController: childLinkage Object 容错解析 + COLUMN_IDENT 标识符白名单防注入
- 测试: 编译/校验/控制器联动 + 派生冲突/去重/非引用 健壮性 + 防注入 400

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 22:28:24 +08:00
3e4264d9e0 fix(recipe): 表单/列表/查询/子表排除标准审计列,生成页真正可用
recipe 编译器此前把标准审计列(主键/VERSION/CREATETIME/UPDATETIME/CREATEBY/UPDATEBY/
ISACTIVE)也渲成可编辑必填表单字段、列表列、查询条件、子表 EditGrid 单元格——致新建出的
页 11 列过宽、表单杂乱不可用(此前 e2e 都走 API 未经表单 UI 故未暴露,影响所有主子表功能)。

PageBlueprintCompiler 在 maintenanceColumns/treeColumns/searchFilter/formControlsExcluding/
masterDetailFormControls/childInputTable 统一排除系统列(SYSTEM_COLUMNS + 主键)。编辑表单仍保留
hidden 主键(_UPDATE 定位)。子表按子表 PK 排除。

+2 单测(维护页 forms/list/查询排除+编辑表单 hidden 主键;主子表主表单/子表排除),
全量测试绿,live 验证维护页+主子表页 schema 系统列全清(仅留编辑表单 hidden 主键)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 21:15:53 +08:00
ba8177e9d4 feat(主子表): 父级汇总(总额=子表金额之和) compute-on-save + SUM 实时预览
主表列 = SUM/COUNT/AVG/MIN/MAX(子表某列)。服务端权威:行级派生(__derive)之后再聚合
(?__rollup=主列=AGG:LIST:子列),把子表列聚合写回主 map → 引擎落库;主表单该列只读
static + ${SUM(ARRAYMAP(DETAILS, item => <派生公式或子列>))} 实时预览。

- RecipeDerivedFieldComputer.enrichRollup: 子表列聚合(空集 SUM/COUNT=0,MIN/MAX/AVG 跳过)
- PageBlueprintChild.RollupColumn + 编译器 masterDetailFormControls(汇总列→static SUM 预览,
  被聚合子列若派生则用其公式 item 前缀)+ masterDetailFormApi 拼 __derive&__rollup
- RecipePageComposer/DesignFeatureController 贯通 childRollup(Object 容错;主列须主表真实列、
  子列须子表真实列、agg 白名单 SUM/COUNT/AVG/MIN/MAX)
- FlowController.executePost 接 __rollup(在 __derive 之后,使派生列已算好)

+5 单测,curl live e2e(TOTAL=SUM(明细金额)=55,服务端先逐行派生再聚合)PASS,Playwright 3/3。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 17:55:49 +08:00
ce544fa65e feat(主子表): 派生字段(金额=数量×单价) compute-on-save + tpl 实时预览
零引擎改动:UI 派生列只读 tpl ${公式} 实时预览(quickEdit:false),服务端权威
经写流 ?__derive= 用安全算术求值器逐行 compute-on-save 落库(复用 ?__egtpl=
同款轨道,绕开 amis input-table 前端竞态)。

- RecipeArithmeticEvaluator: 纯算术递归下降/BigDecimal,无任意代码执行;含递归
  深度(64)+表达式长度(512)护栏,防深嵌套 StackOverflowError(Error 逃兜底)DoS
- RecipeDerivedFieldComputer: 子表数组逐行求值写回,逐格错误隔离不阻断保存
- PageBlueprintChild.derived + 编译器派生列(tpl + quickEdit:false + 表单 api
  URL 编码 __derive);RecipePageComposer/DesignFeatureController 贯通 childDerived
  (Object 容错避免 Jackson 400;公式字符白名单拒 |/=/; 防静默写错值)
- FlowController.executePost 接 __derive(9 参 @Autowired + 反射回归测试)

对抗评审(36 agent)揪修 3 真 bug:amis needConfirm:false 强注 quickEdit 需显式
false 才保留 tpl 预览;求值器深嵌套 Error 逃逐行兜底;公式 | 破坏 spec 切分。
+9 单测,curl live e2e 含负控 PASS,Playwright 3/3。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 17:32:13 +08:00
f18d998337 feat(metadata): createEntity 支持 masterTable(子表自动加 MASTERID 引用列回链主表)
主子表向导一步建子表:传 masterTable 时自动加 MASTERID 引用列(=子表回链主表外键),
linkColumn 固定 MASTERID,再由 MasterDetailLinker 接线。已由主子表 Playwright e2e 端到端证明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 15:37:04 +08:00
6e096dce1d fix(metadata): MasterDetailLinker 主 LIST 属性 INSERT 补 createtime/updatetime/createby/updateby
live e2e 揪出:SYS_ENTITYATTRIBUTE 这4列 NOT NULL 无默认值,原 INSERT 漏列 → 接线失败。
补齐后 master-detail compile→ensureLink→级联保存 端到端通(子行外键自动回填)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 15:29:40 +08:00
c9be9bc125 feat(design): /recipe/compile 支持 master-detail-v1(先接线再编译)
DesignFeatureController 注入 MasterDetailLinker(生产+包测构造同步);
CompileRequest 加 childTable/linkColumn/listColumn(默认 DETAILS)/listLabel;
recipe 门禁放行 master-detail-v1。compile() master-detail 分支:先
masterDetailLinker.ensureLink(主表,子表,外键,listColumn,listLabel) 接线
元数据,再 attributeReader.read(子表) 读子列(剔除指回主表的外键列),
装配带 child 的 Spec→compose→严格 typed 校验→upsertStandard 落标准层。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 15:20:17 +08:00
25494efadf feat(blueprint): master-detail recipe 接入 registry/composer + YAML
PageRecipeRegistry.defaults+compile switch 加 master-detail-v1。
RecipePageComposer.Spec 携带 childTable/listColumn/childAttributes
(7-arg 兼容构造保留),toBlueprint 装配 PageBlueprintChild。
新增 page-recipes/master-detail-v1.yaml(镜像 maintenance/tree,
gates 含 typed-page-schema/amis-schema)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 15:18:22 +08:00
8fe377b0c8 feat(blueprint): master-detail-v1 编译器分支 + PageBlueprintChild
PageBlueprint 加 RECIPE_MASTER_DETAIL 常量与可空 child 组件(14-arg,
保留 13-arg 兼容构造);新增 PageBlueprintChild record。
PageBlueprintCompiler.masterDetail 复用 maintenance 列表骨架,
新增/编辑表单内联 house-style input-table 子表(name=listColumn,
quickEdit 控件),编辑表单 initApi 走 _LOAD 回显主+子行。
validate 接受 master-detail 并要求 child 非空/childTable/listColumn
非空/fields 非空。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 15:16:30 +08:00
d71ad6f461 feat(metadata): MasterDetailLinker 主子表元数据接线(幂等)
ensureLink(主表,子表,外键列,列表列,标签,ctx) 把已存在子实体接成主表内联子表:
INSERT 一行 SYS_REFERENCEVALUE(entityid=子实体,entityattributeid=子表外键列属性)
+ INSERT 主表一条 LIST 属性(referenceid=LIST,referencevalue=新 RV id)。
接线后 evictByTable(主表),默认流即自动级联(实测无需主子表专属流节点)。
幂等:主表已有同名 LIST 属性 → 返回既有 referencevalue,不重复 INSERT。
TDD: MasterDetailLinkerTest 两测(INSERT 两条 + 失效缓存 / 幂等无 INSERT)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 15:13:06 +08:00
b0daaaab0f feat(metadata): createEntity 透传 tabletype(子表建模支持)
createEntity 接受可选 req.tabletype(Integer),非空时覆盖克隆源的 TABLETYPE。
子表(tabletype=1)+ 指向主表的引用列 = 主子表级联接线前提。
TDD: MetaControllerReferenceTest.createEntityPassesTableTypeThrough 捕获
保存的实体 map 断言 TABLETYPE=1。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 15:10:54 +08:00
f281de1c5a feat(meta): 建实体支持「所属分类」entitytype + GET /api/meta/entity-types 分类目录
用户反馈建模器缺「实体所属分类」。根因:createEntity 克隆 SYS_USERGROUP → 新实体继承其
entitytype(错分类)。修:createEntity 接 entitytype(SYS_ENTITYTYPE.id)覆盖克隆值;
新增 GET /api/meta/entity-types 列 221 个分类供建模器选择器。live 验:建实体 entitytype 正确落库。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 14:45:43 +08:00
4400eabc66 test(e2e): 人走五环端到端验收脚本 + live 验收实证(Section 6 / Task 24)
8094+真实DB验收通过:五环①②③④(含引用列 OWNER→SYS_USER)+ AI ①面(READY_FOR_HUMAN_REVIEW)
+ 部署包(requiresHumanApproval) + 红线全守;实证写入脚本头注。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 10:27:03 +08:00
303b4d0240 fix(design): @Autowired DesignFeatureController 生产构造器 — 修 Spring 多构造器回退无参导致启动崩
live e2e 揪出:DesignFeatureController 有「生产构造+包级测试构造」两个构造器,
生产构造未标 @Autowired → Spring 回退找无参构造 → NoSuchMethodException 启动失败。
纯单元测试全 new 对象故漏检;真实 boot 才暴露。补 @Autowired + 回归测试守护此装配模式。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 10:25:12 +08:00
b5a6388024 feat(design): publish 生成 production 人审部署包(DECISION-2,manifest+rollback)(建物3-Task13)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 10:10:22 +08:00
c339efcdcb feat(design): publish 菜单注册 MenuRegistrar(dedup+新功能目录)(建物3-Task12)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 10:08:41 +08:00
74478f030e feat(design): POST /api/design/publish 确保默认流落库(幂等)(建物3-Task11)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 10:07:13 +08:00
9765872382 feat(design): GET /api/design/flows 列出实体默认流预览(建物3-Task10)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 10:05:30 +08:00
05181d75bf test(design): 端到端·composer 透传 reference 列→编译显名 <COL>_DISPLAY__
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:55:10 +08:00
869790d04f feat(design): 编译器引用列渲染显名·list 列 name 指向 <COL>_DISPLAY__(运行时 _SEARCH 注入,白名单安全)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:54:33 +08:00
eabebae361 feat(design): POST /api/design/recipe/compile 单步端点(建物2)·服务端生成 templateId+严格 typed 闸+唯一真相落标准层
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:53:49 +08:00
687ade7513 feat(design): RecipePageComposer 共享蓝图装配器 + PageBlueprintField 引用字段扩展(向后兼容)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:52:13 +08:00
3e24f135ad chore(meta): 实体描述取请求 description, 默认中性'设计中心创建'(去硬编码 AI 标记)
DESCRIPTION 行与 resolveDescription 在 Task 3 即就地实现(§B.9-7 收口),本提交补
resolveDescription 纯函数单测。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:37:10 +08:00
6f34be15eb fix(meta): 引用列 DDL 外键指向目标表而非自表(DECISION-1)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:36:43 +08:00
8c3f3944be feat(meta): POST /api/meta/entity 支持 reference 列(find-or-create SYS_REFERENCE 指向目标实体)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:35:14 +08:00
61e51abeb6 feat(meta): GET /api/meta/entity/{table}/attributes 列清单+displayColumn+引用列反解
抽出可复用 @Component EntityAttributesService(records Result/Column,读真实表
SYS_ENTITYATTRIBUTE⋈SYS_ENTITY,引用目标经 DataDicService.getReferenceEntityTableName
反解),MetaController.attributes() 委托它(供 Section 2 同源消费)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:33:25 +08:00
4319178b66 feat(meta): GET /api/meta/entities 实体目录端点(引用列选择器数据源)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:31:34 +08:00
418b0b6458 docs(plan): land human five-ring build-new-feature implementation plan (24 TDD tasks, adversarially reviewed)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:27:51 +08:00
22d481e1cb docs(plan): land human five-ring build-new-feature design (NocoBase-style modeler + live designer)
Brainstorm output. Locks: NocoBase-style modeler+live-designer (no linear wizard);
v1 builds NEW features only (CREATE proven, ALTER=M4 deferred); recipe auto-generates
wired default page then edit in DesignerPage; AI-assist via external agent+Skills
(no in-platform LLM); single metadata truth SYS_ENTITY/SYS_ENTITYATTRIBUTE.
Companion to 2026-06-19 direction+roadmap. Ready for writing-plans.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 00:16:31 +08:00
6c6038350a feat(ai-recipe): typed list columns to match converter house-style
AI 生成页的列直接显原始值(布尔列显「true/false」),与转换器 house-style 的
「是/否」「日期格式化」不一致——live 验收时 boolean 列肉眼可见 true。本次按
blueprint field type 纯导出列渲染类型(不依赖 colMeta 枚举/引用元数据):

- boolean → type:mapping, map:{true/1:"是", false/0:"否"}
- date     → type:date,     format:YYYY-MM-DD
- datetime → type:datetime, format:YYYY-MM-DD HH:mm:ss
- string/integer/number 保持纯文本(默认渲染即正确)

同时在 PageComponentRegistry 注册 mapping/date/datetime 三个标准 amis 列渲染器
(display 类,转换页本就用,否则 typed-page-schema 门会拒含 type 的列 → 409)。
maintenance 与 tree 列均应用。

验证:platform-metadata 397 + platform-ai 61 测试绿;8093 live 重生成
EIP4AI_HSDEMO,served schema ENABLED 列=mapping,浏览器实证「启用」列显
「是」(原 true),0 console error;已清测试数据。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 19:29:02 +08:00
5f320503ee feat(ai-recipe): bind tree-crud-v1 writes to backend service flows
tree-crud 与 maintenance 同病:AI 已生成 _ADD/_UPDATE/_DELETE 流但树页的增改删
仍绑自创 /api/entity/{表}/save|delete(「页不绑」)。本次把写入对齐保真层服务流:

- 新增顶级 / 加子 表单 → post:/api/flow/<TABLE>_ADD
- 节点编辑 表单 → post:/api/flow/<TABLE>_UPDATE
- 节点删除 → /api/flow/<TABLE>_DELETE,data={ids:"${<PK>}"}(基线 ids 口径)

数据读保留 /api/entity/<TABLE>/tree(层级构建器,无 flow 树端点,非写旁路);
per-node 操作列对树是恰当 house-style(节点操作天生 per-node),不套用 flat
CRUD 的「无操作列」规则。证据:2727 转换页 0 用 crud+childrenColumnName,
基线树走 input-tree/tree 组件,故树 recipe 的对齐核心=写口径而非组件重构。

验证:platform-metadata 397 + platform-ai 61 测试绿;8093 live 经 AI pipeline
生成 tree 页 + 浏览器实证渲染(工具栏/节点加子-编辑-删除/entity-tree 取数)
+ served schema 确认写绑定全走 _ADD/_UPDATE/_DELETE,0 console error。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 19:13:48 +08:00
1ff0d334d0 feat(ai-recipe): align maintenance-crud-v1 to converter house-style
AI 生成的单表维护页与转换器基线产出存在「陌生感」:缺查询区、走自创
/api/entity REST 而非保真层服务流、动作放 per-row 操作列。本次对齐:

- crud.api → /api/flow/<TABLE>_SEARCH(amis 自动追 page/perPage,无 adaptor)
  + selectable/checkOnItemClick/primaryField
- 补 filter 查询区(string 列 → input-text 文本搜索)
- 新增/编辑/删除挂 headerToolbar 操作 selectedItems(带 id + disabledOn 守卫,
  删掉 per-row 操作列);增改 inline 表单绑 _ADD/_UPDATE + reload,编辑用
  dialog data:{"&":"${selectedItems[0]}"} 预填 + hidden 主键;删除
  data={ids:"${selectedItems|pick:<PK>|join:','}"}(照搬基线,键为 ids)
- 连带:AiFeatureDraftGenerator.expectedPageApi + AiAgentService 的
  render-plan 门禁改 recipe-aware(原硬编码 /api/entity + /list? 会让整条
  pipeline 409)

证据:2727 转换页聚合 0 用 per-row operation 列 / 1976 headerToolbar /
1211 filter / 1277 _SEARCH。DefaultFlowHelper 流名吻合,AI pipeline 仅生成
list 页无独立表单页 → recipe 保持 inline 自包含。

验证:platform-metadata 397 + platform-ai 61 测试绿;8093 live 经 AI pipeline
重生成页 + 浏览器实证查询区/工具栏/选中守卫/flow 取数/编辑预填全绿,0 console error。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 19:07:39 +08:00
d3b88467e0 feat(page-schema): converge net-new standard writes to single PageSchemaWriter (M3a)
sys_page_schema standard layer had two runtime writers: the converter import CLI and AiLocalReleaseExecutor's raw JDBC INSERT (the critic-flagged net-new bypass). Introduce PageSchemaWriter as the single runtime write function (typed-recipe validation warn-not-block + etag + UPSERT), and route both a new admin-gated PUT /api/page/schema/{id}/standard endpoint (net-new producer for the design-center 'new feature' path) and AiLocalReleaseExecutor.applyPageSchema through it. No remaining raw INSERT into sys_page_schema in the AI runtime write path.

Scope: page_schema runtime write only. The deployment-package SQL-text generator (AiAgentService.pageSchemaSql, offline human-apply artifact) and SchemaImportCli (batch converter import) are separate legitimate paths. AiLocalReleaseExecutor sys_serviceflow/sys_menu raw writes remain (follow-on). Completion = code-complete, integration-pending (end-to-end render proof env-gated).

Tests: PageSchemaWriterTest (4) + PageSchemaControllerTest putStandard success/403/split (27 total) + AiLocalReleaseExecutorTest/AiAgentApiPipelineTest unchanged-green. TDD.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 17:21:06 +08:00
da3ad35821 docs(plan): land EIP4 dev-platform direction + reconciled execution roadmap
Commit the architecture-direction design doc (D1-D7 locked decisions) and add a companion living execution roadmap reconciling the design with the already-merged AI agent module (main 9aea6c1): phase-by-phase delivery account + ordered milestones (M0 component L1 -> render-smoke gate -> 先宽度 M1/M3a/M2/M3b -> 再深度 M4/M5/M7/M8), split autonomous-build vs env-verification.

Roadmap revised after adversarial review: restored the D2-locked P0 prerequisite (component L1), moved the render-smoke correctness gate ahead of real-DB dogfood, split net-new write-path convergence ahead of the new endpoint, marked code-complete vs integration-pending.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 16:59:16 +08:00
9aea6c1cd0 docs(ai): converge external wording to AI-assisted + human review, not full-auto
Per the architecture-review redline (EIP3 决策会纪要: AI claims limited to 'AI-assisted, human-reviewed'; never promise 'AI full-auto development'), soften endpoint @Operation summaries, the default task objective, and AI docs that read as committed full-automation. Endpoint paths/method names unchanged (API contract). Added a capability-boundary disclaimer at the top of AI_AGENT_AUTO_DEVELOPMENT.md. 33 platform-ai tests green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 16:39:45 +08:00
c379f5b1ea feat(ai): require admin for AI agent mutation/action endpoints
AiAgentController's endpoints relied only on the SecurityFilterChain (prod: /api/** authenticated; dev: permitAll), so any authenticated user could trigger AI writes/actions (auto-develop, local-apply, change-sets, deployment packages) - a lower bar than the comparable overlay/standard-page write endpoints which require admin.

Gate the 14 mutating/action POST endpoints with requireAdmin() (UserSession CURRENTUSER == ADMIN), aligned with PageSchemaController.requireAdmin / AdminWriteController. Read GETs and the pure validate-schema/access-check endpoints stay open. Actual three-truth writes are now admin + localhost double-gated.

Tests: AiAgentControllerTest + AiAgentApiPipelineTest run under an ADMIN session (+ AfterEach clear); added a 403 test for non-admin. 61 platform-ai tests green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 16:22:17 +08:00
bac69d85a7 fix(page-schema): scope typed-recipe gate to AI drafts, not designer overlay saves
putOverlay hard-rejected (400) any overlay using components/actions outside the ~35-component AI recipe whitelist. Existing converted pages use 13 unregistered component types (search-box/dialog/mapping/tabs/each/tree-select/input-date-range/…) plus 6 onEvent action types that are structurally actionType-without-type (ACTION_WITHOUT_COMPONENT), so editing+saving virtually any existing list page in the designer returned 400.

Split path: putOverlay (designer write path) now validates-and-warns instead of blocking; the strict typed gate stays on POST /api/page/schema/validate and the AI draft pipeline. Clears the only existing-page regression blocking the ai-agent merge to main. TDD: PageSchemaControllerTest#20 rewritten RED->GREEN; 37 schema tests green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 15:49:26 +08:00
bd4c642766 merge ai agent module 2026-06-19 14:01:09 +08:00
a51f35317f test edit form page resolution
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 17:17:48 +08:00
dbf5b6c86a fix edit form page resolution
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 17:16:45 +08:00
ccd74710fa fix schedule job notify editor
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 17:15:10 +08:00
62188a557f docs: verify treegrid entity filtering
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 16:44:21 +08:00
d218c2ba6f fix framework treegrid search and formeditgrid editors 2026-06-18 16:35:51 +08:00
b6e6964913 fix framework p2 custom views 2026-06-18 15:35:17 +08:00
55b9c201d6 docs: mark framework P2 gate complete
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 13:25:30 +08:00
ffd8c31e7e fix: gate function template downloads 2026-06-18 13:24:43 +08:00
22211b2557 feat(附件): 双态组件 + 新建/编辑保存落库打通
- 转换器 buildAttachmentField: 附件字段收敛为单个 input-file 双态组件
  (staticOn ${__readonly} 查看只读可下载/编辑可增删; joinValues:false,extractValue:false
  提交附件对象数组), 删除 each+service 容器, 查看/编辑同位置同布局
- FlowController 读路径 resolveAttachmentFields: 把保真层大写 DOCUMENT
  ({SYS_DOC_ID,FILENAME,FILESIZE}) 归一为 amis 小写契约 {id,name,value,url,sizeKb},
  修掉"查看附件空白图标"
- FlowController 写路径 normalizeAttachmentFieldsForWrite(按 url=/api/file/ 签名识别):
  修改流 → [{SYS_DOC_ID}] 交保真层 updateAttachments 对账(留/软删/不重复插);
  新建流 → 捕获 docId+剥离 DOCUMENT, 保存后用返回主键 relinkInsertedAttachments
  UPDATE sys_doc.businesskey 改挂(直接改挂、非复制 → 无 UNKNOWN 孤儿)
- FileController.upload: businesskey 右补白 36 位对齐保真层 getDoc(CHAR(36) 主键),
  否则 loadDoc 读不到新附件; 响应补 value
- 测试: converter 154 + metadata 368 全绿
  (新增 4c 读契约归一 / 4d 修改归一 / 4e 新建改挂 / FileController 补白)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 13:09:36 +08:00
75885f9d7d docs: mark framework P2 complete
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 11:19:22 +08:00
5636b37220 feat: complete framework P2 deltas 2026-06-18 11:18:40 +08:00
be9d1c8e71 docs: record work calendar status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 10:27:08 +08:00
eafd872271 feat: restore work calendar view 2026-06-18 10:26:07 +08:00
03bf036d87 docs: record treegrid entity filtering status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 10:10:28 +08:00
1ef3de1cc2 fix: restore entity type filtering for treegrid views
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 10:09:41 +08:00
9cdd043af3 docs: record schedule and data import status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 10:01:15 +08:00
c9e4d35ca1 feat: wire schedule notifications and data import downloads
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 09:59:55 +08:00
46dfa9c5a2 docs: record script editor status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 09:40:36 +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
0b8a9c4ce4 docs: record process monitor status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 09:03:45 +08:00
a019af8e3a feat: wire process monitor actions 2026-06-18 09:02:54 +08:00
7192c2aaa6 docs: record process form removal status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 08:56:10 +08:00
1d8a4fec60 feat: wire process form removal actions 2026-06-18 08:55:17 +08:00
d82ef94da8 docs: record workflow task commit hash
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 08:12:54 +08:00
61f31527bc feat: wire my started workflow tasks 2026-06-18 08:12:15 +08:00
f736d33a20 docs(platform): record approval history completion
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 02:13:09 +08:00
21e3865dcf fix(platform): restore approval history drawer 2026-06-18 02:12:27 +08:00
278b0da422 fix(platform): resolve picker load defaults
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 01:51:59 +08:00
cfb7451e62 docs: update framework todo for short message
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 01:19:58 +08:00
723443ea1e fix(platform): implement short message send 2026-06-18 01:19:15 +08:00
f690f30552 fix(platform): repair message detail views
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 00:49:03 +08:00
bf7bb2515b fix(platform): complete picker parity and message detail
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 00:30:01 +08:00
c380659ef0 docs: update picker todo status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 23:56:20 +08:00
0d6fab4a5e fix(converter): map user selectors to amis picker
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 23:48:39 +08:00
2c1ec5f54e fix(converter): avoid amis mode collision for user picker
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 23:15:43 +08:00
57f011e801 feat(metadata): restore legacy user transfer picker flow
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 22:36:33 +08:00
78d27847dd fix(metadata): make user picker searchable and show selections
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 22:04:26 +08:00
88ff6f6bfb feat(metadata): wire legacy process selector
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 21:45:12 +08:00
1581a99d75 feat(metadata): wire legacy user select picker
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 21:31:11 +08:00
380d1f17ca docs: update framework todo verification status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 21:06:50 +08:00
5ea4607817 docs: correct framework todo completion status
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-17 20:58:12 +08:00
7fd11fe6a4 docs: add framework todo tracker 2026-06-17 20:50:32 +08:00
57c3412aff fix(flow): restore workflow task converted pages 2026-06-17 20:44:52 +08:00
5946afa6e6 docs: 同步本会话进展到状态总览(real-first/树编辑布局/时间段过滤+Wave A两项)
Some checks failed
ci / build-test-parity (push) Has been cancelled
README §0/§1.1/§1.3 更新:
- §1.3 横向能力新增 3 个全站通用保真修复(树编辑 <layout> 布局保真、搜索时间段
  过滤 date-range→DateTime[]、real-first 流解析)+ 机制①扩出整页改写器。
- §1.1 功能模板下载/枚举组 → ✅,日志组 → 🟡(删除按钮接+real-first修通+时间段通)。
- §0 加本会话进展提要(6 提交已 push origin/main)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 18:02:20 +08:00
4b2cedfd1d feat: add AI page preview URL 2026-06-17 14:17:53 +08:00
d91da77038 feat: add AI render plan gate 2026-06-17 13:28:49 +08:00
718c5a5b9b feat: add AI tree CRUD recipe 2026-06-17 13:03:38 +08:00
2b0b673ce9 feat: expose AI page recipes 2026-06-17 12:38:26 +08:00
fcc5719bc6 feat: enforce AI page recipe gate 2026-06-17 12:33:09 +08:00
e55072598e feat: add AI page blueprint compiler 2026-06-17 12:14:57 +08:00
c1ff0db96b feat: enforce typed page schema in AI drafts 2026-06-17 09:15:10 +08:00
c5b7b68210 fix: harden AI tool access check 2026-06-17 08:57:59 +08:00
8bdde45e89 feat: add AI tool access registry 2026-06-17 08:45:56 +08:00
5eb95a4ef4 feat: add typed page schema registry 2026-06-17 08:39:51 +08:00
b05f0e89b5 feat: add release diff rollback plan 2026-06-17 08:33:47 +08:00
ade5e91ac1 feat: add feature package export preview 2026-06-17 08:30:20 +08:00
5f7e226fa0 feat: add CLI env registry and release verification 2026-06-17 08:21:40 +08:00
c5bfbd3ca3 feat: add AI feature package revisions 2026-06-17 07:56:45 +08:00
5bf641838a feat: add EIP4 agent CLI and skills plan 2026-06-17 07:47:22 +08:00
3b4d3dbd24 feat: add AI agent auto-development pipeline 2026-06-17 07:32:54 +08:00
3133 changed files with 601620 additions and 3165 deletions

View File

@@ -1,4 +1,11 @@
# eip4-platform CI:编译+单测+ArchUnit+对拍冒烟(公司自建 Git 服务可换 Jenkins,步骤同 scripts/ci.sh) # eip4-platform CI(Gitea Actions)。
#
# P0 修复(2026-06-24 架构评审):原 .github/workflows/ci.yml 在私有 Gitea 上是孤儿
# (GitHub Actions 不会跑),且 java-version 写死 17(项目 JDK21)。本文件迁到 Gitea 规范位置
# .gitea/workflows/,JDK 升 21。
#
# 前置条件:Gitea 实例需已启用 Actions 且注册了带 `ubuntu-latest` 标签的 act_runner;
# 否则本工作流不会被调度(纯文件存在不等于会跑)。详见仓库 Actions 设置。
name: ci name: ci
on: on:
push: push:
@@ -23,9 +30,9 @@ jobs:
- uses: actions/setup-java@v4 - uses: actions/setup-java@v4
with: with:
distribution: temurin distribution: temurin
java-version: "17" java-version: "21"
cache: maven cache: maven
- name: 编译+单测+对拍冒烟 - name: 编译+单测(含 ArchUnit)+对拍冒烟
env: env:
CI_PG_HOST: localhost CI_PG_HOST: localhost
CI_PG_PORT: "5433" CI_PG_PORT: "5433"

View File

@@ -0,0 +1,53 @@
# eip4-platform 夜间对拍(Gitea Actions)。
#
# P1 修复(§10.2「逐行对拍框架已冻结」):push CI(ci.yml)只在有提交时跑对拍,无提交的日子不跑;
# 本工作流按 cron 每夜跑一次全量对拍——直连 JDBC(基线)vs 引擎 REST(被测)逐行逐列 diff,
# ParityCli 任一实体不一致即退出码 2 → 本 job 红(「本次 vs 基线 diff 非 0 即阻断」由 ParityCli 退出码内建)。
# 即便没人提交代码,也能捕获引擎/转换器/运行库的隐性漂移。
#
# 触发:每日 18:00 UTC(02:00 CST)+ 手动 workflow_dispatch。
# 前置条件:Gitea 实例需启用 Actions 且注册带 `ubuntu-latest` 标签的 act_runner;否则不会被调度。
#
# 注:--seed --all + --privilege 为硬门(本 job 跑这两项)。更广的 --discover(发现式抽样)/
# --realprivilege(客户库真实规则)退出语义偏探索性,暂未纳入硬门 job,见 §10.2 follow-up。
name: parity-nightly
on:
schedule:
- cron: "0 18 * * *"
workflow_dispatch:
jobs:
nightly-parity:
runs-on: ubuntu-latest
services:
postgres:
image: postgres:15
env:
POSTGRES_USER: ci
POSTGRES_HOST_AUTH_METHOD: trust
ports: ["5433:5432"]
options: >-
--health-cmd "pg_isready -U ci" --health-interval 5s
--health-timeout 5s --health-retries 20
steps:
- uses: actions/checkout@v4
- uses: actions/setup-java@v4
with:
distribution: temurin
java-version: "21"
cache: maven
- name: 全量对拍(种子 21 实体 + C2 权限,逐行 diff,不一致即红)
env:
CI_PG_HOST: localhost
CI_PG_PORT: "5433"
CI_PG_USER: ci
CI_DB: eip4parity
CI_PORT: "8090"
run: bash scripts/ci.sh
- name: 归档对拍报告
if: always()
uses: actions/upload-artifact@v4
with:
name: parity-reports-${{ github.run_id }}
path: parity-reports/parity-*.json
if-no-files-found: ignore

5
.gitignore vendored
View File

@@ -8,6 +8,8 @@ parity-reports/
.DS_Store .DS_Store
# C3 卫生:可再生噪声(2026-06-13) # C3 卫生:可再生噪声(2026-06-13)
# 运行时日志(logback 滚动文件;§10.2 可观测性)
logs/
__pycache__/ __pycache__/
*.pyc *.pyc
/data/ /data/
@@ -26,3 +28,6 @@ tools/s3_rewriter/output/分级清单.csv
# Office 临时锁文件 / 系统垃圾 # Office 临时锁文件 / 系统垃圾
~$* ~$*
.DS_Store .DS_Store
# A10 部署本地密钥(只提交 .env.example)
deploy/.env

39
CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,39 @@
# 贡献约定(eip4-platform / eip4-web 通用)
> 新人先读 `docs/新人上手.md`(环境)与 `docs/架构设计.md`(红线)。本文只讲协作流程。
## 分支与合并
- **main 不直接提交功能代码**;从 main 拉分支,前缀语义:`feat/`、`fix/`、`docs/`、`chore/`、`deploy/` + 短横线主题(如 `feat/approval-closure`)。
- 完成后 **`--no-ff` 合回 main 并 push**(保留合并节点,按批次可回溯),或走 Gitea Web UI 发 PR。合并后**删除本地/远端特性分支**。
- 一个分支一个主题;跨仓联动改动(platform+web)用同名分支便于对照。
## 提交信息
- 格式:`type(scope): 中文摘要`(如 `fix(report): 套打打印按选中行主键直接渲染`)。
- 正文写清:做了什么 / 为什么 / **验证证据**(单测数、live e2e 结论)。没验证的事不写「已完成」。
## 质量门(合并前自查清单)
1. **TDD**:新功能/修 bug 先写测试看它红,再实现变绿;禁止事后补「恒绿」测试。
2. **后端**:改动模块 `mvn -pl <模块> -am test` 绿;合并前全 reactor `mvn clean install` 绿(含 ArchUnit 边界规则)。
3. **前端**:`tsc -b` 干净 + `npx vitest run` 绿 + `npm run build` 成功。
4. **作者/评审分离**:合并前过一遍独立 code review(他人或 agent 对抗评审);涉及鉴权/SQL/脚本执行/DDL 的改动**必须加安全评审**。
5. **转换器改动**:重转重导后在运行库 live 验证(浏览器真渲染,不止单测),再合并。
6. **保真层改动**:默认禁止重写;确需改(如安全修)须登记 `docs/迁移手册.md` 并跑对拍回归。
## CI
- `.gitea/workflows/ci.yml`(构建+测试)与 `parity-nightly.yml`(夜间对拍)已就位,**待注册 runner 后生效**。
- runner 生效前,合并到 main 前请手跑 `bash scripts/ci.sh` 等价把关。
- **托管注记**:当前远端为私人 Gitea(见 `docs/新人上手.md` §1 警示)。workflow 是 Gitea Actions(GHA 兼容)语法——若迁 GitHub 可近乎原样复用(挪到 `.github/workflows/`),迁 GitLab/Jenkins 需转换;团队化后 runner 应部署在团队基础设施。
## 文档纪律
- 进度只回写 `docs/项目进度与路线-总览-*.md`(唯一权威);README 索引随之更新。
- 一次性 plan/报告完成后 `git mv` 入 `docs/归档/`,并同步改所有引用路径(grep 验证零断链)。
- 文档声明「已完成」必须附 git 证据(commit/merge 哈希)。
## 红线速查(详见 docs/架构设计.md 与 docs/新人上手.md §6)
JDK 21(严禁 26)|保真层不重写不改包名|DDL 走守卫单点|Flowable 不自动改表|AI 恒人审、对外严禁承诺全自动开发|amis 锁 6.13.0 本地 SDK。

View File

@@ -12,7 +12,9 @@ EIP4 平台正式工程(路线 A'):双层制模块化单体——**保真层供
| platform-auth | 数据权限真实现(C2 已替换桩)+ P2 组织/权限 | | | platform-auth | 数据权限真实现(C2 已替换桩)+ P2 组织/权限 | |
| platform-converter | 模板转换器(P4) | 可独立 CLI 跑批 | | platform-converter | 模板转换器(P4) | 可独立 CLI 跑批 |
| platform-flow-gateway | P3 占位:Flowable 网关 | | | platform-flow-gateway | P3 占位:Flowable 网关 | |
| platform-ai | P5 占位:MCP Server | | | platform-ai | P5 AI Agent 开发底座:草稿/变更包/本地门禁/自动修复/人工部署包 | Agent 不直连线上执行生产变更 |
| platform-cli | EIP4 Agent 受控命令入口:`init` 一键接入(Claude Code/Codex/OpenCode)、环境探测、AI 自动开发、发布编排 | Agent 优先通过 CLI/API 操作 |
| platform-mcp | EIP4 MCP server(stdio):把 AI/元数据 REST 端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 经标准协议接入 | 忠实转发 REST,复用人审红线,不另开权限面 |
| platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 | | platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 |
| platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 | | platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 |
@@ -75,6 +77,46 @@ java -cp "$CP" com.eip4.platform.parity.selfcheck.ParityCli --privilege # C
# 指向 eip4dev 自对拍: # 指向 eip4dev 自对拍:
mvn -pl platform-parity exec:java -Dexec.mainClass="com.eip4.platform.parity.selfcheck.ParityCli" \ mvn -pl platform-parity exec:java -Dexec.mainClass="com.eip4.platform.parity.selfcheck.ParityCli" \
"-Dexec.args=--discover --jdbc=jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3 --engine=http://localhost:8093 --out=parity-reports/eip4dev" "-Dexec.args=--discover --jdbc=jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3 --engine=http://localhost:8093 --out=parity-reports/eip4dev"
# EIP4 Agent CLI
mvn -pl platform-cli package
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add --name local --base-url http://localhost:8084 --use
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084
# 一键把 agent skills 装到目标项目,让 Claude Code / Codex / OpenCode 都能驱动平台开发
# Claude Code → .claude/skills/<name>/SKILL.md(原生 skill);Codex/OpenCode → 根 AGENTS.md(内嵌全文)
# base URL 按 current env(或 --base-url/--env)渲染;skills 已随 jar 打包,无需仓库在场
# 详见 docs/skills/README.md
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar init --dir <你的项目>
# 查看内置 agent skills / 校验目标项目是否已安装(缺失退出码非 0,便于 CI 把关)
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills list
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills check --dir <你的项目>
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package --task-id ait-xxx --change-set-id aics-xxx --output target/ai-runs/package.json
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release verify --package-file target/ai-runs/package.json
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release export --package-file target/ai-runs/package.json --output target/ai-runs/package.eip4pkg.json
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-preview --package-file target/ai-runs/package.eip4pkg.json
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release diff --left target/ai-runs/package-old.json --right target/ai-runs/package.json
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release rollback-plan --package-file target/ai-runs/package.eip4pkg.json --output target/ai-runs/rollback-plan.json
# EIP4 MCP server(stdio):把下面这些 AI/元数据端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 用标准协议调用
mvn -pl platform-mcp package
claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url http://localhost:8093
# 或设 EIP4_BASE_URL;默认 http://localhost:8084。手动启动:java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar
# Typed page schema
curl http://localhost:8084/api/page/schema/components
curl -X POST http://localhost:8084/api/page/schema/validate \
-H "Content-Type: application/json" \
--data-binary @target/ai-runs/page-schema.json
# AI tools / employees / ACL
curl http://localhost:8084/api/ai/tools
curl http://localhost:8084/api/ai/employees
curl -X POST http://localhost:8084/api/ai/tools/access-check \
-H "Content-Type: application/json" \
-d '{"employeeId":"agent-developer","toolName":"local.apply","grantedScopes":["ai:local:apply"],"targetEnv":"local","productionWrite":false}'
``` ```
## tools/ ## tools/

34
deploy/.env.example Normal file
View File

@@ -0,0 +1,34 @@
# EIP4 生产编排环境变量样例(A10 W4)。复制为 deploy/.env 并改成真值;.env 切勿入库。
#
# cp deploy/.env.example deploy/.env
# ── 安全(必填,application-prod.yml 无默认,缺失即 fail-fast)──────────────────
# JWT 签名密钥:强随机 ≥32 字节。生成: openssl rand -base64 48
EIP4_AUTH_JWT_SECRET=CHANGE_ME_strong_random_at_least_32_bytes_0123456789abcdef
# ── 数据库 ───────────────────────────────────────────────────────────────────
# 生产:指向【客户既有 eip3 库】(保真层在其上运行,EIP4 只新增平台表)。
# 自测/演示:用内置 postgres 服务 → jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
EIP4_DB_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
EIP4_DB_USERNAME=eip4
EIP4_DB_PASSWORD=eip4
# 内置 postgres 服务凭据(仅自测演示用;生产用客户 PG 时可删 postgres 服务并忽略这三项)
POSTGRES_USER=eip4
POSTGRES_PASSWORD=eip4
POSTGRES_DB=eip4
# ── flowable-service 双数据源(env 驱动)────────────────────────────────────────
# ACT_ 工作流引擎库(Flowable 运行时表);生产指客户 PG 的 flowable schema
FLOWABLE_JDBC_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=flowable
FLOWABLE_JDBC_USER=eip4
FLOWABLE_JDBC_PASS=eip4
# biz 客户业务库(只读,候选人/组织解析直查 SYS_* 组织表);生产指客户 eip3 库
BIZ_JDBC_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
BIZ_JDBC_USER=eip4
BIZ_JDBC_PASS=eip4
# ── 单源托管 ─────────────────────────────────────────────────────────────────
HTTP_PORT=80
# 前端构建产物路径(相对 deploy/docker-compose.yml);先 `cd eip4-web && npm run build` 生成
WEB_DIST=../../eip4-web/dist

52
deploy/README.md Normal file
View File

@@ -0,0 +1,52 @@
# EIP4 生产部署(A10 MVP:W1 Flyway + W2 容器化 + W3 nginx 单源 + W4 compose)
> 对应设计 `docs/plans/2026-06-25-A10-生产上线工程化-design.md`。本目录是 **MVP 编排骨架**。
> ✅ **平台表(sys_*)由 W1 Flyway 在 platform-app 启动时自建**(含自建 `eip3` schema)——内置演示 postgres 从零即可起平台层,无需先跑 bootstrap。
> ℹ️ **flowable-service 例外**:引擎 `databaseSchemaUpdate=false` 是任务红线(严禁引擎自动改表),故其 `flowable` schema 必须【预置备】Flowable 6.8.1 DDL(生产=客户既有 flowable schema)。空演示库无法起 flowable-service,详见下「验证状态」。
## 拓扑
`nginx`(单源:serve 前端 dist + 反代 `/api`→platform-app、`/flowable`→flowable-service)→ `platform-app:8084` + `flowable-service:8089` → PostgreSQL。
## 一、Docker Compose(推荐)
```bash
# 1) 产后端 jar
mvn -pl platform-app,flowable-service -am package -DskipTests
# 2) 产前端 dist
( cd ../../eip4-web && npm ci && npm run build )
# 3) 配置(强随机密钥 + DB 指向;生产指客户 PG)
cp deploy/.env.example deploy/.env && $EDITOR deploy/.env
# 4) 起栈
docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build
# 健康/日志
docker compose -f deploy/docker-compose.yml ps
docker compose -f deploy/docker-compose.yml logs -f platform-app
```
**生产数据库(D2/D6)**:保真层跑在**客户既有 eip3 库**上,EIP4 只新增平台表。生产请把 `.env` 的 `EIP4_DB_URL` 指向客户 PG,并可删除 compose 内置 `postgres` 服务(仅自测演示用空库)。
**内置演示库 schema(W4)**:`.env.example` 用 `currentSchema=eip3` / `currentSchema=flowable`。platform-app 的 Flyway 会自建 `eip3` 并落平台表;但 flowable 的 Liquibase 不自建 schema,故内置 postgres 经 `deploy/postgres-init/01-create-schemas.sql` 在首次初始化预建 `eip3`+`flowable` 两 schema。生产指客户库时这些 schema 已存在,无需 init 脚本。
**flowable-service 引擎库**:`databaseSchemaUpdate=false`(任务红线)→ 引擎不自建 ACT_/FLW_ 表。空 `flowable` schema 启动会报 `relation "flw_channel_definition" does not exist`。要起 flowable-service 需先把 Flowable 6.8.1 引擎 DDL 灌入 `flowable` schema(生产=客户既有引擎库;演示如需自洽可把对应 create SQL 追加到 `postgres-init/`)。
**密钥(D4)**:`EIP4_AUTH_JWT_SECRET` 等敏感项 `application-prod.yml` 无默认值,缺失即启动失败(fail-safe)。用 `openssl rand -base64 48` 生成。
## 二、systemd 裸 jar(D3 兜底:客户禁 Docker 时)
见 `deploy/systemd/*.service` 头部安装说明:jar→`/opt/eip4/`,env→`/etc/eip4/*.env`(chmod 600),`systemctl enable --now`。前端 dist 用宿主 nginx serve(参考 `deploy/nginx.conf`,upstream 改为 `127.0.0.1:8084/8089`)。
## 三、待办(后续批次,见 A10 design)
- **W5**:PG/Flowable 迁移 runbook 在准生产真跑 + 回退验证(含 flowable 引擎库 DDL 置备)。
- **W6**:性能/并发基线 + nginx upstream 权重灰度切流(eip3↔eip4)。
> ✅ **残留收敛已完成(2026-06-25)**:与 `db/migration` 重复的 3 份 `bootstrap-*.sql`(page-schema/datastatus/ai-agent)已删;`ci.sh` 改指 `db/migration/V1`;`AiAgentDdlTest` 迁入 platform-app 守 V3;`SchemaImportCli` 内联 DDL 经 `PlatformMigrationDdlGuardTest` 钉死 ≡ V1。db/migration 为平台表 DDL 唯一真相。
## 验证状态(诚实记录,2026-06-25 本地真验)
- ✅ `docker build` 两镜像通过:`platform-app` 727MB / `flowable` 641MB(JRE21 + 非 root + COPY 预构建 jar)。
- ✅ **整栈 `docker compose up` 对内置空 postgres 真起**(本地 Docker daemon + PG 15.15):
- platform-app 在 **prod profile** 下启动,**W1 Flyway 在 Spring Boot 启动时自建 `eip3` schema 并应用 V1-V3**(9 张 sys_* 表,`flyway_schema_history` v1/v2/v3 全 success);`/actuator/health/readiness` = `{"status":"UP"}`。
- nginx 单源验证:`GET /` → 200 SPA;`/api/meta/entities` 经反代到 platform-app → **401**(prod 严格认证链生效,印证 P0 fail-safe 修复在运行态成立)。
- postgres-init 预建 schema 生效:`no schema has been selected` 报错消除。
- ⚠️ **flowable-service 在空演示库无法起**(by design):引擎 `databaseSchemaUpdate=false` 红线 → 不自建表,空 `flowable` schema 报 `flw_channel_definition does not exist`。生产用客户既有引擎库即正常;演示自洽需向 `postgres-init/` 追加 Flowable 6.8.1 DDL。
- ℹ️ 登录 `/api/auth/login` 在空演示库返 401 属预期(无客户 SYS_USER 数据);保真层业务端点同理需客户数据。
- 提示:`docker build` 前需先产 jar(步骤 1);`compose --build` 会自动 build。`.env` 已 gitignore(含密钥,勿入库)。

83
deploy/docker-compose.yml Normal file
View File

@@ -0,0 +1,83 @@
# EIP4 生产编排骨架(A10 W4)。四服务:nginx 单源 + platform-app + flowable-service + postgres。
#
# 用法(见 deploy/README.md):
# 1) 先产 jar: mvn -pl platform-app,flowable-service -am package -DskipTests
# 2) 先产前端: (cd ../../eip4-web && npm ci && npm run build) # 生成 eip4-web/dist
# 3) 配 .env: cp deploy/.env.example deploy/.env && 改强随机密钥/DB
# 4) 起栈: docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build
#
# 边界(见 A10 design D2/D6):保真层跑【客户既有 eip3 库】,生产请把 EIP4_DB_URL 指向客户 PG;
# 下面的 postgres 服务仅自测/演示用(空库)。平台表(sys_*)由 platform-app 的 W1 Flyway
# 在启动时自建(含自建 eip3 schema);flowable 的 Liquibase 不自建 schema,故演示库经
# postgres-init/ 预建 eip3+flowable 两 schema(见该脚本注释)。生产指客户库时无需这些。
services:
postgres: # D6:仅自测演示;生产用客户 PG,把 EIP4_DB_URL 指过去并删本服务
image: postgres:15
environment:
POSTGRES_USER: ${POSTGRES_USER:-eip4}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-eip4}
POSTGRES_DB: ${POSTGRES_DB:-eip4}
volumes:
- pgdata:/var/lib/postgresql/data
- ./postgres-init:/docker-entrypoint-initdb.d:ro # 首次初始化预建 eip3+flowable schema
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-eip4}"]
interval: 10s
timeout: 5s
retries: 12
networks: [eip4]
platform-app:
build:
context: ../platform-app
environment:
SPRING_PROFILES_ACTIVE: prod
SERVER_PORT: 8084
EIP4_AUTH_JWT_SECRET: ${EIP4_AUTH_JWT_SECRET} # 强制(application-prod.yml 无默认,缺失 fail-fast)
EIP4_DB_URL: ${EIP4_DB_URL}
EIP4_DB_USERNAME: ${EIP4_DB_USERNAME}
EIP4_DB_PASSWORD: ${EIP4_DB_PASSWORD}
EIP4_FILE_ROOT: /data/files
volumes:
- filedata:/data/files
depends_on:
postgres:
condition: service_healthy
networks: [eip4]
restart: unless-stopped
flowable-service:
build:
context: ../flowable-service
environment:
SERVER_PORT: 8089
# flowable-service 双数据源(env 驱动):ACT_ 引擎库 + biz 客户库(候选人解析直查组织表)
FLOWABLE_JDBC_URL: ${FLOWABLE_JDBC_URL}
FLOWABLE_JDBC_USER: ${FLOWABLE_JDBC_USER}
FLOWABLE_JDBC_PASS: ${FLOWABLE_JDBC_PASS}
BIZ_JDBC_URL: ${BIZ_JDBC_URL}
BIZ_JDBC_USER: ${BIZ_JDBC_USER}
BIZ_JDBC_PASS: ${BIZ_JDBC_PASS}
depends_on:
postgres:
condition: service_healthy
networks: [eip4]
restart: unless-stopped
nginx: # 单源:serve 前端 dist + 反代 /api、/flowable
image: nginx:alpine
ports:
- "${HTTP_PORT:-80}:80"
volumes:
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
- ${WEB_DIST:-../../eip4-web/dist}:/usr/share/nginx/html:ro
depends_on: [platform-app, flowable-service]
networks: [eip4]
restart: unless-stopped
volumes:
pgdata:
filedata:
networks:
eip4:

48
deploy/nginx.conf Normal file
View File

@@ -0,0 +1,48 @@
# EIP4 单源托管(A10 W3)。挂载为 nginx:alpine 的 /etc/nginx/conf.d/default.conf。
# 一个源:静态 SPA(eip4-web/dist)+ 反代 /api→platform-app(唯一后端入口)。
# flowable-service:8089 无鉴权,绝不经 nginx 对外(见下 /flowable/ 说明)。
# 消除 dev 的 vite proxy 依赖;切流灰度(W6)可在此用 upstream 权重双跑(eip3↔eip4)。
server {
listen 80;
server_name _;
# 附件上传/导出:放宽请求体上限(与保真层附件大小对齐,按需调)
client_max_body_size 50m;
gzip on;
gzip_types text/css application/javascript application/json image/svg+xml;
gzip_min_length 1024;
# 后端 REST(现代层 + 保真层引擎)
location /api/ {
proxy_pass http://platform-app:8084;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 130s; # 略大于 statement_timeout(120s),避免反代先于 DB 超时切断
}
# 🔴 工作流引擎(flowable-service:8089)绝不对外暴露。
# flowable-service 进程无 Spring Security,鉴权唯一落点=platform-app 网关的超管门
# (ProcessModelerController.requireSuperAdmin);裸直达 8089 会绕过所有鉴权,
# 匿名即可部署/覆盖生产 BPMN、办结/终止任意任务(安全评审 Critical#1)。
# 前端只经 /api/workflow/*(网关)访问流程能力,不需要 /flowable/ 直达。
# 若确需内网调试直达,改为 `internal;` 仅供内部子请求,严禁对公网 proxy_pass。
location /flowable/ {
return 404;
}
# 静态资源:带 hash 的构建产物可长缓存
location /assets/ {
root /usr/share/nginx/html;
expires 7d;
add_header Cache-Control "public, immutable";
}
# SPA:其余路由回退 index.html(amis 前端 history 路由)
location / {
root /usr/share/nginx/html;
try_files $uri $uri/ /index.html;
}
}

View File

@@ -0,0 +1,12 @@
-- 内置 postgres 演示服务初始化(A10 W4)。仅在数据卷首次初始化时由
-- postgres 镜像的 /docker-entrypoint-initdb.d 自动执行一次。
--
-- 为何需要:.env.example 把 EIP4_DB_URL / FLOWABLE_JDBC_URL / BIZ_JDBC_URL 指向
-- currentSchema=eip3 与 currentSchema=flowable。platform-app 的 Flyway 会自建 eip3
-- 并落平台表;但 flowable-service 的 Liquibase 架构管理器【不会自建 schema】,
-- 缺失即报 "no schema has been selected to create in" 启动崩溃。故演示库在此预建两 schema。
--
-- 生产边界(见 A10 design D2/D6):生产把这些 URL 指向【客户既有 PG】,
-- 其 eip3/flowable schema 已存在,无需本脚本;本脚本仅服务内置演示 postgres。
CREATE SCHEMA IF NOT EXISTS eip3;
CREATE SCHEMA IF NOT EXISTS flowable;

View File

@@ -0,0 +1,19 @@
# EIP4 flowable-service systemd 单元(A10 W4·D3 兜底)。
# 安装同 eip4-platform.service:jar→/opt/eip4/flowable-service.jar,env→/etc/eip4/flowable.env。
[Unit]
Description=EIP4 flowable-service
After=network-online.target
Wants=network-online.target
[Service]
User=eip4
Group=eip4
EnvironmentFile=/etc/eip4/flowable.env
Environment=SPRING_PROFILES_ACTIVE=prod
ExecStart=/usr/bin/java -jar /opt/eip4/flowable-service.jar
SuccessExitStatus=143
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target

View File

@@ -0,0 +1,27 @@
# EIP4 platform-app systemd 单元(A10 W4·D3 兜底:禁 Docker 的客户用裸 jar + systemd)。
# 安装:
# sudo cp platform-app/target/platform-app-*.jar /opt/eip4/platform-app.jar
# sudo install -d -o eip4 -g eip4 /opt/eip4 /var/lib/eip4/files
# sudo cp deploy/.env.example /etc/eip4/platform.env # 改成真值,chmod 600
# sudo cp deploy/systemd/eip4-platform.service /etc/systemd/system/
# sudo systemctl daemon-reload && sudo systemctl enable --now eip4-platform
[Unit]
Description=EIP4 platform-app
After=network-online.target
Wants=network-online.target
[Service]
User=eip4
Group=eip4
# /etc/eip4/platform.env 提供 EIP4_AUTH_JWT_SECRET / EIP4_DB_* / SERVER_PORT 等(chmod 600)
EnvironmentFile=/etc/eip4/platform.env
Environment=SPRING_PROFILES_ACTIVE=prod
Environment=EIP4_FILE_ROOT=/var/lib/eip4/files
# JDK21 路径按宿主调整
ExecStart=/usr/bin/java -jar /opt/eip4/platform-app.jar
SuccessExitStatus=143
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target

View File

@@ -0,0 +1,178 @@
> 📌 **现状以总览为准(2026-06-21)**:正文若称「只覆盖最简单 CRUD recipe」已过时——现已有 maintenance-crud / tree-crud / master-detail-v1 多类 recipe。**对外口径红线仍有效**(AI 辅助 + 人审、非全自动开发)。进度见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B2。
# AI Agent 辅助开发运行说明(生成草稿 + 本地验证 + 人工复核发布)
> **能力边界(对外口径,红线)**:本能力是「**AI 辅助生成草稿 + 人工复核发布**」,**不是** AI 全自动开发。当前只覆盖最简单的 CRUD recipe,存量复杂场景未取得数据;按《EIP3架构决策会纪要》红线,**严禁在报价/合同中承诺「AI 全自动开发 / 人力大幅下降」**。线上变更一律输出人工部署包、由人工复核后发布。
`platform-ai` 的辅助开发入口是 `POST /api/ai/features/auto-develop`。它只在本地环境执行草稿生成、本地落库、smoke 和自动修复;线上变更只输出人工部署包,不连接线上环境执行,须人工复核后发布。
## 本地运行配置
`local` 和 `dev` profile 已开启 JDBC 持久化:
```yaml
eip4:
ai:
store: jdbc
```
平台表(`sys_ai_task`、`sys_ai_draft`、`sys_ai_change_set`、`sys_ai_run`、`sys_ai_feature_package`、`sys_ai_revision`、`sys_ai_audit_log`)由 **W1 Flyway 在启动时幂等建表**——单一真相 `platform-app/src/main/resources/db/migration/V3__sys_ai_agent.sql`(A10 W1 收敛后取代原 `spring.sql.init` + 已删的 `bootstrap-ai-agent.sql`)。因此本地启动即用 JDBC 持久化开发证据;默认 profile 不强制写远端验证库,避免误把开发证据写到共享环境。
建议使用独立 worktree 做 Agent 功能开发,避免占用当前任务目录:
```bash
git worktree add ../eip4-platform-ai-agent -b ai/agent-dev
cd ../eip4-platform-ai-agent
```
运行态验证要先构建依赖模块并启动重新打包后的 jar,避免 `spring-boot:run -pl platform-app` 读取本地 Maven 仓库里的旧 `platform-ai`:
```bash
JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests
/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local
```
## 请求示例
推荐优先使用 `platform-cli`,让 Agent 通过稳定命令入口操作自动开发链路:
```bash
mvn -pl platform-cli package
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
--base-url http://localhost:8093 \
--objective "新增客户等级维护功能" \
--feature-name "客户等级维护" \
--table-name EIP4AI_CUSTOMER_LEVEL \
--entity-name "客户等级" \
--template-id eip4ai-customer-level \
--menu-name "客户等级维护" \
--field NAME:名称:string:100:true \
--field CODE:编码:string:64:true \
--field ENABLED:启用:boolean::false \
--page-recipe maintenance-crud-v1 \
--max-repair-attempts 2 \
--output target/ai-runs/customer-level.json
```
树形维护页使用 `tree-crud-v1`。如果字段列表没有显式提供 `PARENTID`,生成器会自动补一个父级字段,
页面使用 `/api/entity/{table}/tree?parentKey=PARENTID&idKey={table}_ID&perPage=2000`
作为树数据接口,并把 `PARENTID` 从树列表列中隐藏:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
--base-url http://localhost:8093 \
--objective "新增组织分类树形维护功能" \
--feature-name "组织分类维护" \
--table-name EIP4AI_ORG_CATEGORY \
--entity-name "组织分类" \
--template-id eip4ai-org-category \
--menu-name "组织分类维护" \
--field NAME:名称:string:100:true \
--field CODE:编码:string:64:true \
--page-recipe tree-crud-v1 \
--max-repair-attempts 2 \
--output target/ai-runs/org-category-tree.json
```
本地门禁通过后,可以把最终变更包封装成功能包快照,并保存一个里程碑 revision:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package \
--base-url http://localhost:8093 \
--task-id ait-xxx \
--change-set-id aics-xxx \
--output target/ai-runs/customer-level-package.json
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai revision \
--base-url http://localhost:8093 \
--task-id ait-xxx \
--package-id aipkg-xxx \
--note "本地门禁通过,待人工部署" \
--output target/ai-runs/customer-level-revision.json
```
底层 REST API 仍可直接调用:
```bash
curl -X POST http://localhost:8093/api/ai/features/auto-develop \
-H 'Content-Type: application/json' \
-d '{
"baseUrl": "http://localhost:8093",
"generateDeploymentPackage": true,
"maxRepairAttempts": 2,
"feature": {
"objective": "新增客户等级维护功能",
"featureName": "客户等级维护",
"tableName": "EIP4AI_CUSTOMER_LEVEL",
"entityName": "客户等级",
"templateId": "eip4ai-customer-level",
"menuName": "客户等级维护",
"pageRecipe": "maintenance-crud-v1",
"fields": [
{"column": "NAME", "label": "名称", "type": "string", "length": 100, "required": true},
{"column": "CODE", "label": "编码", "type": "string", "length": 64, "required": true},
{"column": "ENABLED", "label": "启用", "type": "boolean", "required": false}
]
}
}'
```
`maxRepairAttempts` 可省略,默认 2;设为 0 时只跑首轮开发和本地门禁,失败后由调用方手动调用 repair 接口。
## 自动链路
1. 创建 `AiTask`。
2. 读取 `/api/ai/page-recipes` 中的 EIP4 页面 recipe,确认当前页面类型的 UI/UE 约束。
3. 生成 `ENTITY`、`PAGE_SCHEMA`、`SERVICEFLOW`、`MENU`、`TEST` 草稿。`PAGE_SCHEMA`
先生成 EIP4 PageBlueprint,再由平台编译器输出 amis schema;草稿 metadata 保留 blueprint 证据。
未指定 `feature.pageRecipe` 时默认使用 `maintenance-crud-v1`;树形维护页应指定 `tree-crud-v1`。
4. 对草稿执行基础门禁,包括 page-recipe、amis schema、typed page schema、服务流 XML、实体字段、smoke 计划和 render plan。
5. 生成待人审 `AiChangeSet`。
6. 生成 release plan。
7. 本地 apply:实体走本机 `/api/meta/entity`,页面/服务流写本地库;如果本地最小库缺少 `sys_menu`,菜单发布标记为 `SKIPPED`,不阻断本地 gate,部署包仍保留菜单 SQL 供线上人审。
8. 本地 smoke:只允许 `localhost`、`127.0.0.1`、`::1` baseUrl;HTTP 状态必须匹配,且 JSON 响应体存在 `status` 时必须为 0。
`TEST` 草稿同时包含 `renderTests`,给 Playwright 渲染验收提供 recipe、schemaUrl、previewUrl、预期组件、CRUD 名、数据 API、列、动作和关键文本。
9. 若失败,自动生成 repair plan 并执行修复重试。
10. 生成线上人工部署包,包含 manifest、SQL 草案、回滚 SQL 和本地执行证据。
11. 可选:生成功能包快照并保存 revision,用于后续导出、差异比较和回滚扩展。
返回体中的关键字段:
- `originalChangeSetId`: 首轮自动生成的变更包。
- `changeSetId`: 最终用于部署包的变更包;如果修复生成了替代草稿,可能不同于 `originalChangeSetId`。
- `repairExecutions`: 每轮自动修复证据。
- `deploymentPackage.requiresHumanApproval`: 固定为 `true`,线上发布必须人工审批。
## 功能包和 revision
P2 第一版新增功能包快照和里程碑版本:
- `POST /api/ai/tasks/{taskId}/change-sets/{changeSetId}/feature-package`
- `GET /api/ai/tasks/{taskId}/feature-packages`
- `POST /api/ai/tasks/{taskId}/feature-packages/{packageId}/revisions`
- `GET /api/ai/tasks/{taskId}/revisions`
功能包封装部署包、manifest、本地 evidence、SQL 草案和回滚 SQL。revision 当前保存功能包 JSON 快照,作为后续差异比较和回滚执行的基础。生产执行仍不自动化,必须人审。
## LLM 修复
默认使用确定性修复规则。需要外部 LLM 参与时设置:
```properties
EIP4_AI_LLM_REPAIR_ENABLED=true
EIP4_AI_LLM_REPAIR_ENDPOINT=http://127.0.0.1:18081/ai-agent/repair
EIP4_AI_LLM_REPAIR_API_KEY=...
EIP4_AI_LLM_REPAIR_MODEL=...
```
外部服务契约见 `docs/AI_AGENT_REPAIR_CONTRACT.md`。LLM 只能返回草稿补丁,不能要求平台执行生产命令。
## 线上边界
可靠路径是:本地 `auto-develop` 通过后,人工检查部署包,再由现有发布流程上线。功能上线后如果发现 bug,Agent 可以基于线上错误日志、导出的 run evidence 或人工复现结果生成新的本地任务并修复,但仍应先在本地验证,再输出人工部署包。
## 当前验证结论与遗留项
已在 `local` profile 验证完整自动开发链路:实体创建、默认服务流发布、页面 schema 发布、实体列表/树列表、默认搜索流和新增数据 smoke 均通过,最终状态为 `READY_FOR_HUMAN_REVIEW`。`local` 最小库没有菜单表,因此菜单 apply 为 `SKIPPED`,这是预期的本地边界。
遗留项是全局 metadata 辅助读路径仍有部分 SQL 写死 `eip3.` schema;在 `local/eip4m0` 下会出现非阻断 warning。AI 主链路已规避/修正必要路径,后续如果要让所有后台辅助解析在 `local` 最小库完全无噪声,需要单独做一次 schema 兼容清理。

View File

@@ -0,0 +1,215 @@
# AI Agent 借鉴 NocoBase 的落地路线
日期:2026-06-17
本文记录 EIP4 对 NocoBase AI + no-code 体系的可借鉴点和落地顺序。目标不是照搬 NocoBase 的 TypeScript 插件运行时,而是吸收它的工程边界:核心平台稳定、业务能力包化、AI 通过受控 CLI/API 操作、所有变更可审计、可验证、可回滚。
参考:
- NocoBase README: https://github.com/nocobase/nocobase
- NocoBase Plugin Development: https://docs.nocobase.com/plugin-development/
- NocoBase Project Structure: https://docs.nocobase.com/plugin-development/project-structure
- NocoBase AI Builder: https://docs.nocobase.com/ai-builder/
- NocoBase AI Plugin Development: https://docs.nocobase.com/ai-dev/
- NocoBase CLI: https://docs.nocobase.com/api/cli/
- NocoBase Skills: https://github.com/nocobase/skills
## 一、判断
NocoBase 最核心的启发是:AI 不应该默认直接写一堆业务代码,而是基于平台已有的可配置能力工作。AI 负责把自然语言需求转换为数据模型、页面配置、工作流、权限和发布包,人负责审核关键边界。
EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署包这些受控对象,因此更适合走“AI 操作元数据和发布包”的路线,而不是引入一套新的插件运行时。
## 二、可借鉴点
| NocoBase 做法 | EIP4 对应落点 | 处理方式 |
|---|---|---|
| AI 基于 no-code 基础设施工作 | `platform-ai` 生成实体/页面/服务流/菜单草稿 | 已落地,继续收敛到受控接口 |
| CLI 作为 Agent 操作入口 | `platform-cli` | P1 建立,后续扩展环境/发布/回滚 |
| Skills 让 Agent 理解平台 | `docs/skills/` | P1 建立规范骨架 |
| 插件生命周期 | EIP4 `FeaturePackage` 生命周期 | P2 设计和持久化 |
| 版本控制/里程碑回滚 | `SYS_AI_REVISION` / release evidence | P2-P3 |
| FlowEngine 的可配置模型 | EIP4 typed page schema + component registry | P4 借鉴思想,不照搬实现 |
## 三、落地顺序
### P0:AI 辅助开发主链路(人工复核发布)
状态:已完成。
完成内容:
- `POST /api/ai/features/auto-develop`
- 草稿生成、变更包、release plan、本地 apply、smoke、自动修复、人工部署包
- JDBC 审计和运行证据
- 本地 jar 验证通过
验收标准:
- 本地可从一段功能需求生成可审核部署包
- 线上执行仍停在人审边界
### P1:受控入口和 Agent 知识包
状态:第一版完成。
目标:
- 建立 `platform-cli`,让 Agent 通过命令调用 EIP4,而不是直接猜 HTTP 接口或直连数据库。
- 建立 `docs/skills/`,把 EIP4 的环境管理、自动开发、发布管理写成 Agent 可复用的操作规程。
本阶段交付:
- `eip4 env status`
- `eip4 ai auto-develop`
- `docs/skills/eip4-env-manage.md`
- `docs/skills/eip4-ai-feature-development.md`
- `docs/skills/eip4-release-manage.md`
验收标准:
- CLI 单测覆盖命令解析和请求组装
- README 和自动开发文档给出 CLI 用法
- Agent 后续操作优先引用 Skills 和 CLI
### P2:FeaturePackage 和里程碑版本
状态:第一版完成。
目标:
- 把 AI 生成结果从松散的 draft/change-set 升级为稳定的 `FeaturePackage`。
- 保存里程碑版本,支持本地回滚和线上部署前差异确认。
建议对象:
- `FeaturePackage`: manifest、entity、serviceflow、page schema、menu、acl、sql、rollback、smoke、evidence
- `SYS_AI_FEATURE_PACKAGE`
- `SYS_AI_REVISION`
验收标准:
- 一个功能包可以导出、导入、重复校验
- 每个通过 smoke 的里程碑都能追溯输入、输出、测试证据和回滚脚本
第一版已落地:
- `POST /api/ai/tasks/{taskId}/change-sets/{changeSetId}/feature-package`
- `GET /api/ai/tasks/{taskId}/feature-packages`
- `POST /api/ai/tasks/{taskId}/feature-packages/{packageId}/revisions`
- `GET /api/ai/tasks/{taskId}/revisions`
- `eip4 ai feature-package`
- `eip4 ai revision`
- `sys_ai_feature_package`
- `sys_ai_revision`
未完成项:
- 功能包导出/导入文件格式
- revision 差异比较
- 回滚执行编排
### P3:发布、回滚和环境治理
状态:进行中。
目标:
- CLI 扩展为环境管理和发布编排入口。
- 建立本地、测试、生产环境的只读探测、部署前检查和人工批准边界。
建议命令:
- `eip4 env list/use/status`
- `eip4 release package`
- `eip4 release verify`
- `eip4 release apply --require-approval`
- `eip4 release rollback-plan --package-file FILE --output FILE`
验收标准:
- 默认不能连接线上执行写操作
- 生产写操作必须有显式环境、审批标记和部署包
- 发布失败能用结构化 evidence 回到本地修复链路
源码级修订:
- 参考 NocoBase `env/status.ts` 和 `env-guard.ts`,`platform-cli` 新增本地 env registry/current env。
- 参考 NocoBase revision 创建前检查版本控制插件的思路,EIP4 后续 revision restore/diff 不能只依赖 JSON 快照,必须有发布系统能力检查。
- 新增 `eip4 release verify --package-file FILE`,先做离线发布前门禁,阻断未替换占位符和缺失本地 evidence 的功能包。
- 新增 `eip4 release export/import-preview`,形成 `.eip4pkg.json` 文件格式和 checksum 门禁;导入预览不写环境、不启用功能。
- 新增 `eip4 release diff/rollback-plan`,先落地离线差异检查和计划型回滚;回滚计划不执行生产 SQL。
- 详细源码对照见 `docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md`。
### P4:Typed Page Schema 和组件注册表
状态:第一版完成。
目标:
- 借鉴 NocoBase FlowEngine 的“可配置模型”思想,把页面 block、field、action、linkage 抽象为 typed schema。
- 让 AI 和人工设计器操作同一份 schema。
验收标准:
- 页面 schema 有版本、类型、组件能力表和校验器
- AI 只能选择注册过的组件和动作
- 设计器变更和 AI 变更能互相接续
第一版已落地:
- `GET /api/page/schema/components` 下发组件能力表。
- `POST /api/page/schema/validate` 做 typed page schema 离线校验。
- `PUT /api/page/schema/{templateId}/overlay` 保存 overlay 前强制校验组件和 actionType。
- 当前仍是第一版 registry;后续要继续补 linkage/event/resource 和组件属性级 schema。
### P5:多 Agent 协作和 AI 员工
状态:第一版完成。
目标:
- 在平台内提供面向业务用户的 AI 助手能力,而不只是在开发侧使用 Agent。
建议方向:
- 数据分析 Agent
- 表单配置 Agent
- 服务流诊断 Agent
- 权限风险审查 Agent
- 发布审计 Agent
验收标准:
- 每个 Agent 有独立权限、审计、工具白名单
- 业务侧操作和开发侧操作共用平台审计模型
第一版已落地:
- `GET /api/ai/tools` 下发工具注册表和 scope 要求。
- `GET /api/ai/employees` 下发 AI employee 定义。
- `POST /api/ai/tools/access-check` 统一检查 employee/tool/scope/targetEnv/productionWrite。
- 生产写默认阻断;当前只开放本地开发、校验、smoke、功能包和发布准备工具。
## 四、不照搬的部分
NocoBase 是 TypeScript/Yarn workspace/插件包体系。EIP4 是 Java/Spring/Maven,并且必须兼容 EIP3 的实体、服务流和 XML 模板迁移路径。直接照搬 NocoBase 插件运行时会引入过高迁移成本。
EIP4 应该借鉴的是边界和流程:
1. 稳定核心能力。
2. 业务功能包化。
3. Agent 通过 CLI/API 操作。
4. 人审控制生产变更。
5. 每一步有 evidence、版本和回滚。
## 五、当前推进状态
| 阶段 | 状态 | 说明 |
|---|---|---|
| P0 | 完成 | `platform-ai` 主链路已提交 |
| P1 | 第一版完成 | 已新增 `platform-cli` 和 Skills 规范骨架 |
| P2 | 第一版完成 | 已新增功能包快照、里程碑 revision、CLI 命令和持久化表 |
| P3 | 进行中 | 已完成 env registry/current env/cross-env guard/release verify/export/import-preview/diff/rollback-plan 第一版 |
| P4 | 第一版完成 | 已新增组件 registry、typed schema validator、校验 API 和 overlay 保存前门禁 |
| P5 | 第一版完成 | 已新增 AI tool registry、AI employee registry 和 access-check 门禁 |

View File

@@ -0,0 +1,152 @@
# EIP4 对照 NocoBase 的 AI Agent 接入差距与补齐计划
日期:2026-06-22
本文回答一个具体问题:**外部 coding agent(Claude Code / Codex / Cursor / OpenCode)接入平台做开发这件事,EIP4 和 NocoBase 现在差在哪、要补什么。**
口径限定:只谈「外部 agent 驱动确定性开发」这条线(EIP4 称 ①面)。平台内置生成式 LLM(②面)受对外承诺红线约束,单列在「四、不做的部分」,本文不展开。
前序文档:
- `AI_AGENT_Nocobase_ADOPTION_PLAN.md`(2026-06-17 借鉴路线,P0–P5)
- `AI_AGENT_Nocobase_SOURCE_REVIEW.md`(2026-06-17 源码级对照)
- 本文是上述两份在「接入体验」维度的增量,已对齐 NocoBase 2026 现状(AI employees 加 Skills、新增 MCP server plugin)。
NocoBase 参考:
- AI Builder:https://docs.nocobase.com/ai-builder/
- Skills 仓库:https://github.com/nocobase/skills
- AI Employees / MCP:https://docs.nocobase.com/ai-employees/ ,https://docs.nocobase.com/ai-employees/features/mcp
- LLM Service:https://v2.docs.nocobase.com/ai-employees/features/llm-service
---
## 一、一句话结论
EIP4 和 NocoBase 的**核心判断一致**:AI 不从零生成代码,而是在已过生产验证的 no-code 底座上操作元数据/页面/流程,人审控制生产变更。EIP4 ①面 v1 已交付、骨架完整;**差距全在「接入体验」而非「架构方向」**:NocoBase 把接入做成了一键安装 + 标准 MCP 协议,EIP4 还停在「手动喂 md + agent 死记 CLI」。补齐这层,EIP4 的外部 agent 接入即可达到 NocoBase 同等顺滑度。
---
## 二、现状对照(带证据)
### EIP4 已有的接入资产(基线)
| 资产 | 证据 | 状态 |
|---|---|---|
| 确定性生成主链路 | `platform-ai/.../service/AiFeatureDraftGenerator.java`、`AiAgentService.java`、`AiLocalReleaseExecutor.java` | ✅ 已合 main |
| CLI(可运行 jar) | `platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar`;命令族 `env` / `ai` / `release` | ✅ |
| Skills 规程 | `docs/skills/`:`README.md` + `eip4-env-manage` + `eip4-ai-feature-development` + `eip4-release-manage` | ⚠️ 仅 4 个,且只是仓库文档 |
| REST API | `/api/ai/*`、`/api/design/*`、`/api/meta/*`、`/api/page/schema/{components,validate,overlay}` | ✅ |
| Typed schema 门禁 | `POST /api/page/schema/validate`、overlay 保存前强制校验 | ✅ |
| AI 工具/权限注册表 | `GET /api/ai/tools`、`/api/ai/employees`、`POST /api/ai/tools/access-check` | ✅(注册表层,非运行时调度)|
| 人审红线 | `AiDeploymentPackage.requiresHumanApproval=true`、状态恒 `READY_FOR_HUMAN_REVIEW` | ✅ |
| 版本/回滚 | `eip4 ai revision`、`eip4 release rollback-plan`(只生成计划不执行)| ✅ |
### EIP4 CLI 命令清单(核实自 `Eip4Cli.java`)
```
eip4 env add | list | use | current | status
eip4 ai auto-develop | feature-package | revision
eip4 release diff | export | import-preview | rollback-plan | verify
```
**注意:没有 `init`,也没有 `skills install/check/update`。** 这是和 NocoBase 的关键体验差。
### 逐项对照
| 维度 | NocoBase(2026 现状) | EIP4(现状) | 差距 |
|---|---|---|---|
| 核心理念:AI 在 no-code 底座工作、不从零生成 | ✅ | ✅ | 无(同源)|
| 外部 agent 接入门槛 | `nb init --ui` **自动安装 ~13 个 Skills**,`cd && claude` 直连 | 需人工把 `docs/skills/*.md` 复制/引用给 agent | **大** → G1 |
| Skills 覆盖面 | ~13:env / data-modeling / ui-builder / workflow / acl / plugin-manage / publish / revision / plugin-dev / data-analysis … | 4:env / ai-feature / release | **中** → G3 |
| Skills 安装与校验 | CLI 安装/检查/更新(`skills install`)| 无,纯仓库文档 | 中 → G3 |
| MCP server(外部 AI 用标准协议操作平台)| ✅ 已有 MCP server plugin(2026 新增)| ❌ 仅 `AiArtifactType.java:6` 一行注释 | **大** → G2 |
| CLI 命令族 | `nb` env/pm/revision/publish | `eip4` env/ai/release | 小(基本对齐)|
| 人审确认 | Skill Permission(Ask / Allow)| `READY_FOR_HUMAN_REVIEW` + `requiresHumanApproval` | 无(机制等价)|
| 版本/回滚 | `nb revision` | `eip4 ai revision` / `release rollback-plan` | 无 |
| 端口/连接配置一致性 | `nb init` 引导写入 | skills 文档写 `8084`,实际环境跑 `8093/8094` | **小但扎手** → G1 |
| 内置 LLM / AI employees(②面)| ✅ 接 OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama | ❌ 刻意不做(repair 钩子默认关)| 受红线约束 → 见「四」|
---
## 三、补齐计划(按对外接入体验优先级)
### G1 — 一键接入体验(P0,最快见效)✅ 已完成(2026-06-22)
**问题**:接入要人工搬运 md + agent 不知道端口,第一步就劝退。
**做什么**:
1. 新增 `eip4 init`(或独立脚本 `scripts/install-skills.sh`),把 `docs/skills/*.md` 安装到各 agent 能自动读取的位置:
- Claude Code:`.claude/skills/`(或写入项目 `CLAUDE.md` 引用块)
- Codex:项目根 `AGENTS.md`
- OpenCode:其 agent 规则/上下文目录
2. 安装时把 skills 里的 `--base-url` 占位符**用当前 env registry 的 current env 渲染**(解决 `8084` vs `8093/8094` 不一致)。
3. 安装完打印「下一步:`cd <dir> && claude`」引导,对齐 NocoBase 体验。
**验收**:
- 一条命令后,新开 Claude Code 会话能识别 `eip4-ai-feature-development` skill,并据此跑通 `eip4 ai auto-develop` 产出 `READY_FOR_HUMAN_REVIEW` 包。
- skills 文档内端口与实际启动端口一致,agent 不再连错。
**成本**:小(1 个 CLI 子命令 + 文本渲染 + 端口统一)。
**落地(2026-06-22)**:`eip4 init` 已实现于 `platform-cli`(`Eip4Cli.runInit`),TDD 4 个新测试 + 原有共 19 单测全绿。配套:`docs/skills/*.md` 的 base URL 改为 `{{EIP4_BASE_URL}}` 占位符;新增 `platform-cli/src/main/resources/eip4-skills/manifest.json`(skill 清单 + name/description);`pom.xml` 用 maven-resources-plugin 把 `docs/skills` 打进 jar。真实 jar 端到端验证通过:`init` 产出 `.claude/skills/<name>/SKILL.md`(带 frontmatter)+ 根 `AGENTS.md`(`EIP4-SKILLS` 标记块,块外内容保留、可重复执行,且**内嵌每个 skill 渲染后全文**——Claude Code 用 `.claude/skills/` 原生 skill,Codex/OpenCode 读 `AGENTS.md` 即得完整规程,三工具全覆盖),base URL 按 `--base-url`/`--env`/current env 渲染,零占位符残留。skills 随 jar 打包,`init` 默认从 classpath 读取,无需仓库在场。
### G2 — MCP server(P1,接入面标准化)✅ 已完成(2026-06-22)
**问题**:现在 agent 要靠 skill 文档「死记」CLI/REST 用法;NocoBase 已用 MCP 把能力做成可发现、可调用的标准工具。
**做什么**:起一个 **EIP4 MCP server** 最小骨架,把已有端点包成 MCP tools(stdio + streamable HTTP 两种 transport,对齐 NocoBase):
- `eip4.auto_develop` → `POST /api/ai/features/auto-develop`
- `eip4.list_page_recipes` → `GET /api/ai/page-recipes`
- `eip4.validate_page_schema` → `POST /api/page/schema/validate`
- `eip4.list_components` → `GET /api/page/schema/components`
- `eip4.access_check` → `POST /api/ai/tools/access-check`
- (只读)`eip4.list_entities` / `eip4.entity_attributes` → `/api/meta/*`
红线沿用:所有写工具走本地 env;生产写默认阻断;产物恒 `READY_FOR_HUMAN_REVIEW`。MCP 工具粒度 1:1 复用现有 `AiToolRegistry` 的 scope 与 `access-check`,不新开权限面。
**验收**:
- Claude Code / Codex 通过 MCP 连上后 `list tools` 能看到上述 eip4 工具。
- 通过 MCP 调 `eip4.auto_develop` 能产出待人审部署包,证据与 CLI 路径一致。
**成本**:中(一个独立 server 进程;建议先 stdio + 复用 REST,不重写业务)。
**落地(2026-06-22)**:新增 `platform-mcp` 模块(stdio MCP server,MCP Java SDK 1.1.0 / jackson2 路线)。`McpServer.sync(StdioServerTransportProvider).tools(...).build()`,注册 7 个工具:`eip4_auto_develop / list_page_recipes / validate_page_schema / list_components / access_check / list_entities / entity_attributes`,忠实转发 EIP4 REST,复用人审红线、不另开权限面。工具逻辑 TDD(`Eip4McpTools` 9 单测,注入 mock REST client);真实 stdio JSON-RPC e2e 通过:`initialize` 协商 + `tools/list` 返回 7 工具(inputSchema 正确解析)+ `tools/call` 链路(死端口优雅 isError)。坑:父 pom 为 amis 校验钉死 `networknt:json-schema-validator:1.5.2`,与 MCP 需要的 `2.0.0`(含 `dialect.Dialects`)冲突 → 在 platform-mcp 显式覆盖 2.0.0(仅本模块)。接入:`claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url <env>`。
### G3 — Skills 覆盖面 + 安装/检查(P1)✅ 基本完成(2026-06-22,serviceflow 诊断暂缓)
**问题**:4 个 skill 覆盖不到「建模/选 recipe/权限/服务流诊断」等高频动作,agent 仍要猜。
**做什么**:
1. 补 skills(对标 NocoBase 但只覆盖 EIP4 真实能力,不照搬不存在的功能):
- `eip4-data-modeling`(建实体/字段/引用列,映射 `/api/meta/entity`)
- `eip4-page-recipe`(三种 recipe:maintenance-crud-v1 / tree-crud-v1 / master-detail-v1 的选用与字段约束)
- `eip4-acl-manage`(菜单授权/角色,映射 `/api/admin/*`)
- `eip4-serviceflow-diagnose`(默认流生成与排错)
2. 给 CLI 加 `eip4 skills list/check`,校验本地已安装 skill 版本与仓库是否一致。
**验收**:agent 不再询问「表怎么建 / recipe 怎么选 / 权限怎么配」即可独立完成一个新功能。
**成本**:中(主要是文档 + 一个 CLI 校验命令)。
**落地(2026-06-22)**:新增 3 个 skill(`eip4-data-modeling` / `eip4-page-recipe` / `eip4-acl-manage`,全部基于核实过的 `/api/meta/entity`、`/api/design/recipe/compile`、`/api/admin/*` 端点写就),manifest + jar 打包同步,`docs/skills` 现共 6 个。CLI 新增 `eip4 skills list`(列内置 skills)+ `eip4 skills check --dir`(检测目标项目已装/缺失,缺失退出非 0),TDD 2 新测试、platform-cli 共 22 单测全绿。真实验证:`skills list` 列 6 个、`init` 装 6 个、`skills check` 全 installed(exit 0)、新 skill 端口正确渲染零占位符残留。**`serviceflow-diagnose` 暂缓**:经源码核实平台没有「查看/诊断服务流定义」的 agent 可操作端点(仅能 `POST/GET /api/flow/{id}` 执行 + 看 FlowController 日志),需先补「查看流定义」端点才值得做,否则只能写出无法落地的规程。
---
## 四、不做的部分(红线)
- **平台不内置生成式 LLM(②面)**:NocoBase 做了内置 AI employees + LLM Service(OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama)。EIP4 进程内唯一 LLM 是 `HttpAiLlmRepairClient`,`@ConditionalOnProperty(...repair.enabled,"true")` **默认关,且只修不生成**。是否立②面 = v1 之后的产品决策,本文不推进。
- **终点恒人审**:任何接入路径产物都停在 `READY_FOR_HUMAN_REVIEW`,生产写默认阻断。G1–G3 不得绕过该门禁。
- **对外口径**:限「AI 辅助、人工复核」;严禁承诺「AI 全自动开发 / 人力大幅下降」(决策会纪要商务条款③)。
---
## 五、建议执行顺序
1. **G1 一键接入**(P0,半天级):投入最小、最快让 claude code/codex 真正能用上 EIP4。
2. **G2 MCP server 最小骨架**(P1):把接入面标准化,去掉「agent 死记用法」。
3. **G3 Skills 补全**(P1,可与 G2 并行):提升 agent 自主完成度。
4. ②面(内置 LLM)维持观望,待产品对红线拍板。
---
## 六、与既有路线图的关系
本文 G1–G3 落在 `AI_AGENT_Nocobase_ADOPTION_PLAN.md` 的 P1(受控入口/Skills)与 P5(MCP 白名单)之间,是把当时「第一版完成」的接入层提升到 NocoBase 2026 的体验基线。`SOURCE_REVIEW.md` P5 未完成项明确列了「MCP 工具白名单」「Skills CLI check/update」——本文 G2/G3 即其落地化。进度以 `项目进度与路线-总览-2026-06-21.md` 为准,落地后回写该总览。

View File

@@ -0,0 +1,138 @@
> 📌 **现状以总览为准(2026-06-21)**:本文系修订前快照,P3 等进度表述前后不一致(P3-1「进行中」vs P3-2/P4/P5「第一版完成」);AI 确定性五环生产线已合 main。以 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B2 + `AI_AGENT_Nocobase_ADOPTION_PLAN.md` 为准。
# NocoBase 源码级对照和 EIP4 修订
日期:2026-06-17
本文件补充 `docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md` 的源码级依据。结论:EIP4 不照搬 NocoBase 的 TypeScript 插件运行时,但 P3 之后必须参考它的 CLI/env/revision/skills/tool-registry 边界,否则容易只做出“HTTP wrapper”,做不到可持续的 Agent 开发体系。
## 一、已抽样源码
| 主题 | NocoBase 源码 | 对 EIP4 的影响 |
|---|---|---|
| CLI env status | `packages/core/cli/src/commands/env/status.ts` | CLI 要有 env registry/current env/status,不应只靠 `--base-url` |
| 跨 env 确认 | `packages/core/cli/src/lib/env-guard.ts` | 显式选择非当前 env 时需要确认边界 |
| API client | `packages/core/cli/src/lib/api-client.ts` | CLI 请求应带结构化 env/token/role/header,后续不能散落在命令里 |
| runtime command registry | `packages/core/cli/src/generated/command-registry.ts` | 可根据运行时 API 生成命令,EIP4 后续可用 OpenAPI 生成安全 CLI |
| generic resource command | `packages/core/cli/src/lib/resource-command.ts` | CRUD 类命令应统一处理 JSON body、分页、过滤、错误输出 |
| plugin import/enable | `packages/core/cli/src/commands/plugin/import.ts`, `packages/core/cli/src/commands/plugin/enable.ts` | EIP4 的 FeaturePackage 后续也要区分导入、启用、发布和重启/刷新 |
| revision create | `packages/core/cli/src/commands/revision/create.ts` | revision 不能只是保存 JSON,发布前要检查版本控制能力是否可用 |
| skills install | `packages/core/cli/src/commands/skills/install.ts` | Skills 应由 CLI 安装/检查/更新,而不是只放仓库文档 |
| AI plugin server | `packages/plugins/@nocobase/plugin-ai/src/server/plugin.ts` | AI 功能要注册 tools、skills、MCP、AI employees、ACL snippet |
| FlowEngine | `packages/core/flow-engine/src/flowEngine.ts`, `packages/core/flow-engine/src/models/flowModel.tsx` | 页面 schema 需要演进到 typed model/action/event/resource registry |
## 二、对当前实现的校正
### P0-P2 是否做实
已做实:
- `platform-ai` 主链路有 Java 实现、JDBC/内存 store、DDL、Web API 和测试。
- `platform-cli` 是可运行 jar,不是伪命令。
- `FeaturePackage` 和 `Revision` 已有最小持久化模型。
但它还不是 NocoBase 级完整度:
- CLI 之前缺少 env registry/current env。
- revision 只是功能包快照,不是完整版本控制。
- Skills 只是仓库文档,没有 CLI 安装/检查/更新。
- AI tools/permissions/MCP/AI employee 还没有平台级注册。
- 页面配置还没有 typed FlowModel registry。
### 已按源码对照修订的 P3 第一批
- `platform-cli` 新增本地 env registry,默认保存到 `~/.eip4/eip4-cli.json`。
- 新增 `eip4 env add/list/use/current/status`。
- AI 命令支持 `--env`。
- 显式选择非当前 env 时必须加 `--yes`,避免误操作共享环境。
- 新增 `eip4 release verify --package-file FILE`,离线检查功能包是否具备本地门禁 evidence、人审标记、SQL/rollback,并阻断 `${...}` 占位符。
- 新增 `eip4 release export --package-file FILE --output FILE`,将功能包封装为 `.eip4pkg.json`,包含格式版本和 SHA-256 checksum。
- 新增 `eip4 release import-preview --package-file FILE`,离线验证 `.eip4pkg.json` checksum 和发布门禁,不写任何环境。
- 新增 `eip4 release diff --left FILE --right FILE`,离线比较两个功能包或 `.eip4pkg.json` 的标识、SQL、rollback SQL 和 manifest 差异。
- 新增 `eip4 release rollback-plan --package-file FILE --output FILE`,只生成结构化回滚计划,不执行生产写入。
## 三、后续实现顺序
### P3-1:CLI env 和发布前治理
状态:进行中。
目标:
- env registry/current env
- `release verify`
- package/revision 差异检查
- 生产环境默认只读
### P3-2:FeaturePackage 导出/导入
状态:第一版完成。
目标:
- `.eip4pkg.json` 文件格式
- checksum
- import preview
- import 后不自动启用
第一版已落地:
- export: 普通 feature package JSON -> `.eip4pkg.json` 信封。
- import-preview: 校验 format/version/checksum/payload 和 release gate。
- import-preview 只读,不落库、不启用、不发布。
### P3-3:Revision diff/restore
状态:第一版完成。
目标:
- revision diff
- rollback plan
- rollback 只生成计划和 SQL,不默认执行生产写入
第一版已落地:
- diff: 比较两个普通 feature package JSON 或 `.eip4pkg.json`,支持 checksum 校验和 JSON 输出。
- rollback-plan: 生成 `EIP4_ROLLBACK_PLAN` JSON,包含 package/task/changeSet、rollback SQL、source evidence 和人审要求。
- rollback-plan 会阻断 rollback SQL 中的 `${...}` 占位符;命令不连接环境、不落库、不执行 SQL。
### P4:Typed UI Registry
状态:第一版完成。
目标:
- typed page schema
- component/action/event registry
- AI 只能选择 registry 中允许的组件和动作
第一版已落地:
- `PageComponentRegistry` 提供页面组件能力表,当前覆盖 page/crud/form/operation/button、常用 layout/display 和字段组件。
- `TypedPageSchemaValidator` 校验根节点、已注册组件和 actionType 能力。
- `GET /api/page/schema/components` 返回组件能力表。
- `POST /api/page/schema/validate` 离线校验页面 schema,不写库。
- `PUT /api/page/schema/{templateId}/overlay` 保存前会先跑 typed schema 校验,未注册组件或不支持 action 会被 400 阻断。
### P5:AI tools/skills/employee/ACL
状态:第一版完成。
目标:
- AI tool registry
- AI employee registry
- ACL/scope check
- 生产写默认阻断
第一版已落地:
- `AiToolRegistry` 注册工具、操作入口、所需 scope、本地限定和生产写边界。
- `GET /api/ai/tools` 返回 AI 工具注册表。
- `GET /api/ai/employees` 返回 AI employee 定义。
- `POST /api/ai/tools/access-check` 只做权限判定,不执行工具;`local.apply` 等本地工具在 prod target 会被阻断。
- 当前所有工具都不允许生产写;线上部署仍由人工拿发布包执行。
- Skills CLI check/update
- AI Agent 权限和审计
- MCP 工具白名单

View File

@@ -0,0 +1,129 @@
> 📌 **现状以总览为准(2026-06-21)**:正文若将 master-detail 列为「未来 TODO / 未覆盖」已过时——`master-detail-v1.yaml` recipe 已存在并交付(含派生/聚合/引用联动)。进度见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) §2。
# AI Agent Page Blueprint Contract
日期:2026-06-17
## 目标
EIP4 的 AI Agent 不直接自由生成 amis JSON。Agent 应先生成 EIP4 PageBlueprint,再由平台编译器输出 amis schema,并继续通过 typed page schema、amis schema 和真实浏览器 E2E。
这条路径借鉴 NocoBase 的做法:AI 操作受控配置模型,平台负责规范化、校验、模板复用和版本证据。
## 当前已落地对象
代码位置:
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprint.java`
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintField.java`
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintCompiler.java`
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageRecipeRegistry.java`
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageRecipeValidator.java`
- `platform-ai/src/main/resources/ai/page-recipes/maintenance-crud-v1.yaml`
- `platform-ai/src/main/resources/ai/page-recipes/tree-crud-v1.yaml`
AI 可查询入口:
- `GET /api/ai/page-recipes`
- `GET /api/ai/page-recipes/{recipe}`
工具注册表中对应工具为 `page-recipe.read`,所需 scope 为 `ai:page-recipe:read`。Agent 生成
PageBlueprint 前应先读取 recipe 定义,再生成草稿。
AI 辅助开发链路中的 `PAGE_SCHEMA` 草稿仍然保存编译后的 amis schema,保持现有落库和前端渲染契约不变;草稿 metadata 额外保存:
- `pageRecipe`
- `pageBlueprintVersion`
- `pageBlueprint`
声明了 `pageRecipe` 的草稿必须通过 `page-recipe` 门禁。该门禁会重新解析 metadata 中的
`pageBlueprint`,用平台注册的 recipe/compiler 重新编译,并要求草稿 payload 与编译结果一致。
因此 Agent 不能一边声明使用标准 recipe,一边绕过 compiler 私改 amis JSON。没有声明 recipe 的
历史/手工 `PAGE_SCHEMA` 草稿暂按自由 schema 处理,只走 amis schema 和 typed page schema。
## Recipe: maintenance-crud-v1
适用范围:
- 普通实体维护页
- 单主表列表
- 新增、编辑、删除
- 本地 smoke 可覆盖列表、新增、服务流搜索
标准输出结构:
- 顶层 `type=page`
- `body` 为 `crud`
- `crud.name` 固定为 `{lowerCamel(tableName)}Crud`
- `crud.syncLocation=false`
- 列表 API 固定为 `/api/entity/{table}/list?page=${page}&perPage=${perPage}`
- 新增按钮位于 `headerToolbar[0]`
- 新增按钮使用 `level=primary`、`icon=fa fa-plus`、`actionType=dialog`
- 新增和编辑表单提交到 `post:/api/entity/{table}/save`
- 编辑按钮位于操作列第一位
- 删除按钮位于操作列第二位
- 删除按钮使用 `className=text-danger`、`actionType=ajax`、`confirmText`
- 删除 API 固定为 `/api/entity/{table}/delete`
- 页大小默认 `20`
- `footerToolbar` 固定包含 `statistics` 和 `pagination`
## Recipe: tree-crud-v1
适用范围:
- 自引用层级实体维护页
- 实体必须包含 `PARENTID` 字段
- 覆盖树形列表、新增顶级节点、加子节点、编辑、删除
标准输出结构:
- 顶层 `type=page`
- `body` 为 `crud`
- `crud.name` 固定为 `{lowerCamel(tableName)}TreeCrud`
- `crud.childrenColumnName=children`
- 列表 API 固定为 `/api/entity/{table}/tree?parentKey=PARENTID&idKey={primaryKey}&perPage=2000`
- 新增顶级按钮位于 `headerToolbar[0]`
- 新增顶级按钮使用 `level=primary`、`icon=fa fa-plus`、`actionType=dialog`
- 操作列按钮顺序固定为:加子项、编辑、删除
- 加子项表单必须隐藏写入 `PARENTID=${primaryKey}`
- 编辑表单必须保留隐藏主键和 `PARENTID`
- 删除按钮使用 `className=text-danger`、`actionType=ajax`、`confirmText`
- 树数据端点返回 `data.items` 层级数组,每个节点的子节点字段为 `children`
字段映射:
- `string` -> `input-text`
- `integer` / `number` -> `input-number`
- `date` -> `input-date`
- `datetime` -> `input-datetime`
- `boolean` -> `switch`
- 主键不出现在新增表单,编辑表单最后追加 `hidden`
## 当前边界
本阶段只解决“AI 生成维护类 CRUD 页时走受控 recipe”。还未覆盖:
- 主子表页面
- 审批办理页面
- 看板、日历、图表、报表页
- 复杂字段分组
- 条件联动
- 引用选择器策略
- 权限按钮策略
这些类型必须作为新的 recipe 增量加入,不能让 Agent 直接绕过 blueprint 生成最终 amis JSON。
## 已落地门禁
- `page-recipe`:校验 recipe 已注册、metadata 证据完整、payload 等于 blueprint 编译结果。
- `typed-page-schema`:校验组件和 actionType 来自 EIP4 注册表。
- `amis-schema`:校验最终 schema 符合 amis schema。
- `local-smoke`:本地发布后访问页面、实体、服务流和新增接口。
- `render-plan`:`TEST` 草稿必须提供 Playwright 可消费的 `renderTests`,包含 recipe、schemaUrl、previewUrl、预期根组件、CRUD 名、数据 API、列表列、页面动作和关键文本。
## 后续演进
1. 增加 `master-detail-v1`、`approval-task-v1` recipe。
2. 让设计器 overlay 保存也能记录对应 blueprint 或 template 来源。
3. 在功能包中导出 blueprint,线上部署包继续导出编译后的 amis schema。
4. Playwright E2E 消费 `renderTests`,执行真实浏览器渲染并回写运行证据。

View File

@@ -0,0 +1,155 @@
# AI Agent Repair LLM 接入契约
本文档定义 `platform-ai` 调用外部 LLM 修复服务的最小契约。该服务只负责根据失败证据生成安全草稿补丁,不直接写库、不发布线上、不访问生产环境。
## 启用配置
默认不启用外部 LLM 修复。需要显式配置:
```properties
eip4.ai.llm.repair.enabled=true
eip4.ai.llm.repair.endpoint=http://127.0.0.1:18081/ai-agent/repair
eip4.ai.llm.repair.api-key=${AI_REPAIR_API_KEY}
eip4.ai.llm.repair.model=${AI_REPAIR_MODEL}
```
`api-key` 为空时不发送 `Authorization` 头;非空时使用 `Authorization: Bearer <api-key>`。接口超时为 60 秒。服务返回非 2xx、响应格式非法或调用异常时,平台会忽略外部结果并回退到内置确定性修复规则。
## 请求格式
`HttpAiLlmRepairClient` 向配置的 endpoint 发送 `POST application/json`:
```json
{
"model": "repair-model-name",
"taskId": "ait-1",
"changeSetId": "aics-1",
"repairPlan": {
"taskId": "ait-1",
"changeSetId": "aics-1",
"sourceRunId": "run-1",
"status": "READY",
"generatedAt": 1710000000000,
"actions": [],
"messages": []
},
"drafts": [],
"contract": {
"responseField": "draftPatches",
"patchShape": "artifactType,targetId,payload,metadata",
"rule": "Return only safe draft patches; do not execute production changes"
}
}
```
字段说明:
- `repairPlan`: 平台根据最近失败的 `AUTO_DEVELOP` / `LOCAL_APPLY` / `SMOKE` 证据生成的修复计划。
- `drafts`: 当前任务的草稿快照,LLM 只能基于这些草稿生成替代草稿。
- `contract`: 平台要求的响应约束,外部服务必须遵守。
## 响应格式
外部服务必须返回 JSON 对象,且补丁数组放在 `draftPatches` 字段:
```json
{
"draftPatches": [
{
"artifactType": "ENTITY",
"targetId": "CUSTOMER",
"payload": {
"publishTarget": "/api/meta/entity",
"tableName": "SYS_CUSTOMER",
"entityName": "Customer",
"fields": []
},
"metadata": {
"source": "llm-repair",
"reason": "补齐实体发布目标"
}
}
]
}
```
`artifactType` 只允许:
- `ENTITY`
- `PAGE_SCHEMA`
- `SERVICEFLOW`
- `MENU`
- `TEST`
- `CODE`
平台当前主要自动修复 `ENTITY`、`PAGE_SCHEMA`、`SERVICEFLOW`、`MENU`、`TEST`。`CODE` 补丁即使返回,也仍然必须经过后续门禁、人审和部署包流程。
## 安全边界
外部 LLM 服务不得执行以下操作:
- 连接或修改线上数据库。
- 触发线上发布、重启、脚本执行或远程 shell。
- 绕过平台的草稿、变更包、本地 apply、smoke、部署包和人工审批流程。
- 返回除 `draftPatches` 之外需要平台立即执行的命令。
平台接收补丁后的流程是:
1. 将补丁写成新的 `AiDraft`,保留 `metadata.source` 和原因。
2. 基于同一 `artifactType + targetId` 取最新草稿重新生成 change set。
3. 执行本地 apply 和 smoke。
4. 生成线上人工部署包。
5. 线上部署仍由人工审批和发布系统执行。
## 示例:修复 TEST 契约
请求中的 `repairPlan.actions` 指出 smoke 期望状态码与实际接口不一致时,外部服务可以返回:
```json
{
"draftPatches": [
{
"artifactType": "TEST",
"targetId": "customer-smoke",
"payload": {
"smokes": [
{
"name": "打开客户列表",
"method": "GET",
"path": "/api/customer/list",
"expectedStatus": 200
}
]
},
"metadata": {
"source": "llm-repair",
"reason": "同步 smoke 期望状态码"
}
}
]
}
```
## 示例:修复 PAGE_SCHEMA
页面 schema 缺少 `type`、`title` 或 `body` 时,外部服务可以返回:
```json
{
"draftPatches": [
{
"artifactType": "PAGE_SCHEMA",
"targetId": "customer-page",
"payload": {
"type": "page",
"title": "客户管理",
"body": []
},
"metadata": {
"source": "llm-repair",
"reason": "补齐 amis 页面必填结构"
}
}
]
}
```

View File

@@ -159,9 +159,9 @@ ls -la /opt/eip3/reports/ 2>/dev/null || echo "路径待确认"
|---|------|------|---------|---------|---------|--------| |---|------|------|---------|---------|---------|--------|
| C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff | 后端架构(老员工)| ≥20 个代表性实体逐行一致率 100% | 🟢 **完成(客户库口径,2026-06-11)**:框架四件套落地 platform-parity;本地自举 21 实体/1,108 行 100% 后,客户库真实数据 **24/24 实体通过(23 全量 442,529 行 + PM_PAYMENTAPPLY 抽样 2,000 行),零未解释差异**;首轮 6/24 经四类归因迭代修 harness 达成(计算列/复合键/null 省略/布尔域/COLUMNSQL,均元数据感知、可见不判负);单测 23/23 | `eip4-platform/platform-parity/C1实测报告.md`(含客户库口径节+归因台账);`parity-reports/` | 「新 vs 旧系统」录制重放对拍待旧系统环境(切面交付物已就绪);PM_PAYMENTAPPLY 全量(约 78 分钟)列夜间批跑待办 | | C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff | 后端架构(老员工)| ≥20 个代表性实体逐行一致率 100% | 🟢 **完成(客户库口径,2026-06-11)**:框架四件套落地 platform-parity;本地自举 21 实体/1,108 行 100% 后,客户库真实数据 **24/24 实体通过(23 全量 442,529 行 + PM_PAYMENTAPPLY 抽样 2,000 行),零未解释差异**;首轮 6/24 经四类归因迭代修 harness 达成(计算列/复合键/null 省略/布尔域/COLUMNSQL,均元数据感知、可见不判负);单测 23/23 | `eip4-platform/platform-parity/C1实测报告.md`(含客户库口径节+归因台账);`parity-reports/` | 「新 vs 旧系统」录制重放对拍待旧系统环境(切面交付物已就绪);PM_PAYMENTAPPLY 全量(约 78 分钟)列夜间批跑待办 |
| C2 | 数据权限最小真实现替换桩,纳入对拍样本 | 后端 | ≥3 个行级过滤实体对拍通过 | 🟢 **完成**:framework 原版 DataPrivilegeServiceImpl/DataFilterHelper 原样移植(Jackson 1.x 共存),删桩;3 受控实体×3 用户 **9/9 正例 150 行 100% 一致 + 3/3 负例 PrivilegeException 拒绝**,全量回归 21/21;单测 9/9(独立复跑确认);ROLES 多值=LIST+中间表机制已查明并入手册 §5.8 | `eip4-platform/platform-auth/C2实测报告.md`;`platform-parity/parity-reports/privilege-parity-*.{json,md}` | P2 在 platform-auth 做组织/权限整体真实现(本实现即原版语义底座) | | C2 | 数据权限最小真实现替换桩,纳入对拍样本 | 后端 | ≥3 个行级过滤实体对拍通过 | 🟢 **完成**:framework 原版 DataPrivilegeServiceImpl/DataFilterHelper 原样移植(Jackson 1.x 共存),删桩;3 受控实体×3 用户 **9/9 正例 150 行 100% 一致 + 3/3 负例 PrivilegeException 拒绝**,全量回归 21/21;单测 9/9(独立复跑确认);ROLES 多值=LIST+中间表机制已查明并入手册 §5.8 | `eip4-platform/platform-auth/C2实测报告.md`;`platform-parity/parity-reports/privilege-parity-*.{json,md}` | P2 在 platform-auth 做组织/权限整体真实现(本实现即原版语义底座) |
| C3 | Top 10 高频实体基础压测 + 慢查询采样 | 后端 + 架构 | 输出 P95 延迟基线文档 | 🟢 **完成(双口径,2026-06-11)**:本地自举基线 + 客户库真实数据基线(9 实体含 34k 行大表与复杂视图,0 错误)。**关键发现:首页延迟与表行数强相关(22ms→1.18s→4.6s)**,定位 DDL 索引/参数化/流式三个改造点的优先验证实体;为风险 R2 提供真实锚点 | `eip4-platform/docs/C3压测基线.md`(双口径+归因);JSON 在 `eip4-platform/tools/loadtest/` | 真实 Top10 待生产访问日志;正式 SLA 锚点待隔离准生产环境复测 | | C3 | Top 10 高频实体基础压测 + 慢查询采样 | 后端 + 架构 | 输出 P95 延迟基线文档 | 🟢 **完成(双口径,2026-06-11)**:本地自举基线 + 客户库真实数据基线(9 实体含 34k 行大表与复杂视图,0 错误)。**关键发现:首页延迟与表行数强相关(22ms→1.18s→4.6s)**,定位 DDL 索引/参数化/流式三个改造点的优先验证实体;为风险 R2 提供真实锚点 | `eip4-platform/docs/归档/C3压测基线.md`(双口径+归因);JSON 在 `eip4-platform/tools/loadtest/` | 真实 Top10 待生产访问日志;正式 SLA 锚点待隔离准生产环境复测 |
| C4 | S3 脚本正则改写器原型在真实脚本上实测自动化率 | 后端 | 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 | 🟢 **完成(真实库口径,2026-06-11)**:全量 1,427 条实测,S3=612,自动化率 **81.2%(497/612)≥80% 预算线锁定**;31 条规则、单测 105/105、0 误改、硬 S3 85 条判定未放松(独立复跑确认)。教训:合成语料首测仅 7.1%,经 5 轮真实语料模式挖掘迭代达标——「文档模式 ≠ 真实写法」已记入报告附录 A | `eip4-platform/tools/s3_rewriter/C4实测报告.md`;`eval-real-20260611-final.json` | 剩余 115 条(PARTIAL 30+HARD 85)人工处理预算 0.5–1 人月(盘点口径内,上界 2.8 人月) | | C4 | S3 脚本正则改写器原型在真实脚本上实测自动化率 | 后端 | 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 | 🟢 **完成(真实库口径,2026-06-11)**:全量 1,427 条实测,S3=612,自动化率 **81.2%(497/612)≥80% 预算线锁定**;31 条规则、单测 105/105、0 误改、硬 S3 85 条判定未放松(独立复跑确认)。教训:合成语料首测仅 7.1%,经 5 轮真实语料模式挖掘迭代达标——「文档模式 ≠ 真实写法」已记入报告附录 A | `eip4-platform/tools/s3_rewriter/C4实测报告.md`;`eval-real-20260611-final.json` | 剩余 115 条(PARTIAL 30+HARD 85)人工处理预算 0.5–1 人月(盘点口径内,上界 2.8 人月) |
| C5 | amis 6.13.0 fork 可行性预演(独立构建通过)| 前端 | 构建产物可替换 CDN 版本运行 | 🟢 **完成**:Node 22 全量构建成功(按拓扑序逐包构建),sdk.js 2.0MB 含 amisRequire,本地冒烟通过;**止损 S2 不触发** | `eip4-platform/docs/C5构建预演报告.md`;产物 `static/sdk-local/` + `amis-local.html` | — | | C5 | amis 6.13.0 fork 可行性预演(独立构建通过)| 前端 | 构建产物可替换 CDN 版本运行 | 🟢 **完成**:Node 22 全量构建成功(按拓扑序逐包构建),sdk.js 2.0MB 含 amisRequire,本地冒烟通过;**止损 S2 不触发** | `eip4-platform/docs/归档/C5构建预演报告.md`;产物 `static/sdk-local/` + `amis-local.html` | — |
| — | **老员工知识转移**:PoC 坑位记录整编为《迁移手册》v1 | 老员工 + 架构 | 手册过评审,backup 人选确定 | 🟡 **进行中** | `eip4-platform/docs/迁移手册.md`(本批交付)| backup 人选待确定(项目负责人决策)| | — | **老员工知识转移**:PoC 坑位记录整编为《迁移手册》v1 | 老员工 + 架构 | 手册过评审,backup 人选确定 | 🟡 **进行中** | `eip4-platform/docs/迁移手册.md`(本批交付)| backup 人选待确定(项目负责人决策)|
| — | **153 定制视图处置清单**(重写/降级/留旧三分)| 项目负责人 | 决策会开放项,2 周限期 | 🟡 **进行中** | `153定制视图处置清单v1.md`(本批交付,初判底稿)| 需客户库 SQL 拉取完整列表 + 老员工终判 | | — | **153 定制视图处置清单**(重写/降级/留旧三分)| 项目负责人 | 决策会开放项,2 周限期 | 🟡 **进行中** | `153定制视图处置清单v1.md`(本批交付,初判底稿)| 需客户库 SQL 拉取完整列表 + 老员工终判 |
| — | **JOR 报表布局客户环境清点** | 交付团队 | 报表 C 类预算锁定 | 🔴 **未开始**(需客户环境访问)| — | 客户环境网络访问权限;执行方案见本文档第一节 | | — | **JOR 报表布局客户环境清点** | 交付团队 | 报表 C 类预算锁定 | 🔴 **未开始**(需客户环境访问)| — | 客户环境网络访问权限;执行方案见本文档第一节 |

View File

@@ -1,49 +1,65 @@
# EIP4 迁移项目 — 文档索引与状态总览 # EIP4 迁移项目 — 文档索引与状态总览
> 维护日期:2026-06-17 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。 > 维护日期:2026-07-02 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
> >
> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → **engineclass Java delta**)产出了多份「framework 视图状态/parity」文档,结论互相冲突——尤其 `归档/framework系统管理视图-实现交付报告`(宣称「16 视图已交付」)是「以为做了很多」错觉的来源,实为 demo 级、未逐功能验收。**以本文 + 下方两份现行权威为准,其余归档勿再据以判断进度。** > **进度权威看这份**:`项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。
>
> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → engineclass Java delta → **人走五环低代码平台 / AI 确定性生产线**)产出了多份状态文档,结论可能互相冲突。**以本文 + 总览-2026-06-21 + 下方现行权威为准,归档/历史目录勿再据以判断进度。**
--- ---
## 0. 一句话现状 ## 0. 一句话现状(2026-07-02)
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成**。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §1。 **横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**A 兼容线**纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、**业务 106 视图是最大未动块**;**B 新能力线本期破局**——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev;**A10 MVP 骨架(Flyway + 容器化/nginx/compose)已合 main(06-25),切流未执行**。
> **06-17→06-21 增量**(详见总览 §2):人走五环后端全链 + 前端编排壳/建模器、DesignerPage 闭环(解除 P1 头号阻塞)、主子表四件套、AI 五环生产线合 main + 写路径对齐、附件双态、framework P2 移植一批。两仓 origin/main 已 push(platform `75f942b` / web `d1fd6ed`)。
> **06-22→06-26 增量**(详见总览 §10/§11 与 A2/A3 行):安全基线 P0 全收口(RCE/fail-open/asUser 越权/CI 孤儿 + 2 孪生 + Groovy 沙箱,platform `eba9ce1` / web `2a37251`);报表 A3 JOR 重宿主 + 安全/OOM 收口 🟢(总览 §11);审批闭环补齐(协办/转阅/BPMN 流程图/会签/会签进度,`c95eaee`);A10 W1-W4 骨架(Flyway `f7675c9` + deploy `97a0eb1`);稳定性三件套 + actuator + ArchUnit 6 条 + AiAgentService SRP 拆分;G1-G3 外部 agent 接入(`eip4 init`/platform-mcp/7 skills);在线流程 Modeler design 拍定 D1-D9(`d3ec758`)。06-26 后至 07-02 无代码增量(本次为文档对齐与归档)。
--- ---
## 1. 模块完成度(诚实口径) ## 1. 模块完成度(诚实口径)
档位说明:✅ parity 完成(逐功能验收过) | 🟡 demo 级(有页/端点但未 parity 验收) | 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力(跨模块共用,非单模块) 档位:✅ parity 完成(逐功能验收过)| 🟡 demo 级(有页/端点未 parity 验收)| 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力 | 🆕 本期新能力
### 1.1 纵向(系统模块 / framework 定制视图) ### 1.1 纵向(系统模块 / framework 定制视图)
| 模块组 | 代表视图 | 档位 | 备注 | | 模块组 | 代表视图 | 档位 | 备注 |
|---|---|---|---| |---|---|---|---|
| **用户管理** | 用户管理 629463ae | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收。剩:编辑页 org picker 查询条件、导出 Excel | | **用户管理** | 用户管理 | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收(`bf7bb25/0d6fab4/17c449c`)。剩:编辑页 org picker 查询条件、导出 Excel |
| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | 2026-06-14 搭了 CRUD 端点 + amis 后台页,但 demo 级、未对照旧版逐功能验收 | | RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | CRUD 端点 + amis 后台页已建,demo 级未对照旧版逐功能验收 |
| RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 | | RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 |
| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/枚举组/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 | | 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器重度 delta 未移植 |
| 流程/审批 | 待办/已办/我的发起任务 | 🟠 | 通用列表页在但工具栏空;「查看详细/处理」按钮未接(审批基础设施 🔵 已就绪,缺列表入口接线) | | 元数据/平台工具 | 数据导入配置 / 定时任务「设置提醒人」 | 🟡 | `DataImportConfigController` / `ScheduleJobNotifyController` 已落(c9e4d35);调度运行时未起步 |
| 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 | | 元数据/平台工具 | 脚本编辑器 / 工作日历 | 🟡 | framework P2 批次已移植(57c3412…d218c2b) |
| 消息/邮件 | 收到/已发送消息、短消息 | 🟠 | 列表页在(有删除);查看弹窗/发送/已读联动未接 | | 元数据/平台工具 | 功能模板下载 / 实体分类-枚举组 | ✅ | 已核对验收 |
| 消息/邮件 | 电子邮件全家桶(收件箱/发件箱/配置) | ❌ | 等同独立 webmail 子系统,另案立项 | | 流程/审批 | 待办/已办/我发起的任务 | 🟡→✅ | 列表/查看/处理抽屉/审批历史抽屉已验收;列表入口接线已 live(228 页 openApprovalDrawer);协办/转阅/会签/会签进度/approve 默认「同意」意见 06-26 补齐。剩客户 BPMN 真实流转(外部前置①) |
| picker 控件 | 用户选择框×4 / 流程选择框 | ❌ | bespoke 穿梭框(机制④自定义组件),审批/表单/短消息全链路依赖,**keystone** | | 流程/审批 | 查看审批/流程监控/流程定义/BPMN 图 | 🟡 | 监控(撤回/结束/高级)已 live;BPMN 流程图**查看**已做(ProcessDiagramController + bpmn-js,中文 id 净化);流程定义**编辑**=Modeler 另案(B3,design 已拍定 D1-D9);客户 BPMN 部署=前置① |
| 日志/历史 | 系统日志/登录历史/登录操作 | 🟠 | 通用页在;删除按钮(systemLogManager)未接 | | 消息/邮件 | 收到/已发送消息、短消息 | 🟠→🟡 | 短消息发送 + 消息详情已移植(16393c1 等);已读联动未接 |
| 其它 bespoke | 个人设置/工作日历/报表 | ❌ | 无 XML,逐个从零 | | 消息/邮件 | 电子邮件全家桶(webmail) | ❌ | 独立子系统,另案立项(A5) |
| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 已切回标准 amis `picker`(单/多选靠 `multiple`),数据源 `/api/picker/<dialogid>/list`;流程选择框接 `transfer-picker`。已烟测,待真实业务保存/权限验收 |
| 日志/历史 | 系统日志/登录历史 | 🟡 | 删除按钮组 + real-first 列表 + 时间段过滤已通;剩登录操作列表此库缺视图 |
| 其它 bespoke | 个人设置/工作日历/报表 | 🟠→🟢 | 工作日历已移植;**报表 A3 已完成**(JOR 重宿主 + 安全/OOM 收口,总览 §11);个人设置未起步 |
> framework 定制视图共 46 个,逐视图清单与移植项见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog)。 > framework 定制视图共 46 个,逐视图清单见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog),当前执行队列见 **`framework定制视图-TODO-2026-06-17.md`**(活清单·三态)。
### 1.2 业务模块(pm/hr/oa/dm 的 153 个定制视图) ### 1.2 业务模块(pm/hr/oa/dm 的 106 个定制视图)
另一条线,多数走 bespoke 重写或通用模板,绝大部分未做。处置口径见 `M0交付/153定制视图处置清单v1.md`(历史)。 另一条线,源码在 `EIP-3.0` 仓(3.1G),**基本未动 = A 兼容线最大块**。处置口径卡 S1 止损评审(见总览 §6 待拍板①)。
### 1.3 🔵 横向能力(已就绪,跨模块共用) ### 1.3 🆕 本期新能力(人走五环 / AI / 设计器)
- **转换器通用能力**:navigation 按钮、type=101 树形选择框、picker 引用列显名、filterscript 级联(组织→部门→岗位,已收口静态可达部分)、title 修正、colspan 栅格、A0 控件(密码/附件/日期)、EditGrid 子表递归。 - **人走五环建新功能 v1**:NocoBase 式建模器 + 实时设计器,五环(元数据→表→设计→实现→发布)+ AI①面入口 + 主子表四件套,全链交付合 main(platform `75f942b` / web `d1fd6ed`)。v1 限简单 CRUD/树 recipe + 只建新不改表。设计权威:`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`。
- **机制①** `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表(移植 new-button 的复用骨架)。 - **B1 设计器**:amis-editor 选型拍板(D1);DesignerPage 全闭环上线(`2278cbc` 等),原 P1 头号阻塞解除。
- **审批基础设施**:后端 `ApprovalController`(approval-meta/business-data/action)+ `TodoController`(trace)+ BusinessRecordLoader/WfTemplateService/StatusWriteback;前端 `ApprovalDrawer.tsx`(业务表单+轨迹+动态按钮+提交)。**已建成,缺的是 amis 列表页的入口按钮接线。** - **B2 AI 模块**:确定性(非 LLM)五环增量生产线合 main,终点恒人审、平台不内置生成 LLM;契约见 `AI_AGENT_*.md` + `skills/`。
- **保真层/写路径**:JUEL(jakarta.el JSR-223)跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、PG 升级、Flowable 升级。
### 1.4 🔵 横向能力(已就绪,跨模块共用)
- 转换器通用能力:navigation 按钮、type=101 树选、picker 显名、filterscript 级联、colspan 栅格、A0 控件、EditGrid 子表递归、树编辑 layout 保真、搜索时间段过滤、`_SEARCH` real-first 流解析。
- 机制① `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表 + 整页改写器。
- 审批基础设施:`ApprovalController` / `TodoController` / `ApprovalDrawer.tsx` / WfTemplate 驱动审批(缺列表入口接线)。
- 保真层/写路径:JUEL 跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、`PageSchemaWriter` 单一写真相(M3a `d3b8846`)、PG/Flowable 升级。
- AI 门禁五件套:page-recipe / typed-page-schema / amis-schema / local-smoke / render-plan(已接 putOverlay,只严格约束 AI 草稿)。
--- ---
@@ -51,46 +67,74 @@
| 文档 | 用途 | | 文档 | 用途 |
|---|---| |---|---|
| **`项目进度与路线-总览-2026-06-17.md`** | **全项目进度盘点 + 剩余工作路线**(A 兼容 / B 新功能 + 关键路径 + 待拍板决策) | | **`项目进度与路线-总览-2026-06-21.md`** | **全项目进度权威**:A/B 矩阵 + 增量交付 + 下一步 + 待拍板决策 |
| **`framework定制视图-engineclass移植backlog-2026-06-17.md`** | 46 个 framework 定制视图迁移**主 backlog**(verdict/移植项/优先级 P1-P3) | | `新人上手.md` | 新成员第一天路径(环境→起服务→验证→必读序→高频坑→红线) |
| **`用户管理-Delta移植-实现过程与踩坑-2026-06-17.md`** | 方法论 + 机制① + 踩坑 + filterscript 级联收口(首个端到端案例 + 会话交接) | | `../CONTRIBUTING.md` | 分支/合并/提交/质量门/文档纪律约定(两仓通用) |
| `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(已设计、未实现) | | `架构设计.md` | 双层制架构 / 工程结构 / 选型 / 红线(架构基线) |
| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(非定制,~1363 个)覆盖与收口(与定制视图是两条线) | | `迁移手册.md` | 双层制纪律 + 踩坑四栏制(知识转移手册) |
| `plans/2026-06-19-EIP4开发平台-架构方向-design.md` | 开发平台方向级 design(锁定 D1-D7) |
| `plans/2026-06-20-人走五环建新功能-NocoBase式-design.md` | 主特性「人走五环」设计定型 |
| `plans/2026-06-19-EIP4开发平台-落地执行路线图.md` | 活路线图(M0-M8,状态随里程碑回写) |
| `plans/2026-06-25-A10-生产上线工程化-design.md` | A10 生产化 design(D1-D6 待拍板;W1-W4 骨架已合 main) |
| `plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md` | 报表 A3 设计(Phase1-3 已完成 + 安全收口,总览 §11) |
| `plans/2026-06-25-审批闭环-实施计划.md` | 审批闭环 P0-P3(已实施合 main `c95eaee`,剩外部前置) |
| `plans/2026-06-26-在线流程Modeler-design.md` | B3 流程 Modeler 设计(D1-D9 拍定) |
| `plans/2026-07-02-在线流程Modeler-实施计划.md` | B3 实施计划(4 阶段 17 任务 **全完成合 main 2026-07-02**;含语料/代码勘探基线 + 计划级决策 + 每阶段 live 验收发现 + 双对抗评审处置) |
| `AI_AGENT_AUTO_DEVELOPMENT.md` + `AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md` / `AI_AGENT_REPAIR_CONTRACT.md` / `AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` | AI Agent 对外口径红线 + 编译/修复/采纳契约 + Skills 目录 |
| `framework定制视图-TODO-2026-06-17.md` | A 兼容线**活清单**(Done/In-Progress/待验三态),每次修完回写 |
| `framework定制视图-engineclass移植backlog-2026-06-17.md` | 46 framework 视图迁移**主 backlog**(verdict/移植项/优先级) |
| `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | engineclass Delta 移植方法论 + 机制① + 踩坑(首个端到端案例 + 交接) |
| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(~1363)覆盖与收口(与定制视图两条线) |
| `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(落地状态以总览 B4 为准) |
| `客户沟通清单v1.md` | 商务/客户侧依赖卡点 | | `客户沟通清单v1.md` | 商务/客户侧依赖卡点 |
| `plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md` | 审批界面实现方案(对应基础设施 🔵 已建) | | `决策与盘点/EIP3架构决策{报告,会纪要}.md` | 奠基性决策 + 对外口径红线来源 |
| `决策与盘点/` | 架构决策报告/会纪要/客户库盘点(历史参考,奠基性) | | `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook(生产切流执行依据) |
| `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook |
| `研究/` | 服务流分派、通知保存老vs新机制 trace(专题研究) | | `研究/` | 服务流分派、通知保存老vs新机制 trace(专题研究) |
--- ---
## 3. 全文档索引(含归档) ## 3. 全文档索引(含状态分级)
| 文档 | 状态 | 取代它的 / 备注 | 状态:现行·权威 | 现行 | 活清单 | **已完成·归档候选**(一次性 plan/报告,已落地,可后续 `git mv` 入 `归档/`)| 已归档 | 历史
| 文档 | 状态 | 备注 |
|---|---|---| |---|---|---|
| README.md(本文) | 现行 | 唯一状态入口 | | `项目进度与路线-总览-2026-06-21` | 现行·权威 | 进度唯一入口 |
| framework定制视图-engineclass移植backlog-2026-06-17 | 现行·权威 | framework 视图主 backlog | | `归档/项目进度与路线-总览-2026-06-17` | 已归档(07-02) | 被 06-21 总览取代 |
| 用户管理-Delta移植-…-2026-06-17 | 现行·权威 | 方法论+交接 | | `README.md`(本文) | 现行·权威 | 文档地图 + 模块完成度 |
| 组件设计体系-design-2026-06-15 | 现行 | — | | `架构设计`、`迁移手册` | 现行·权威 | 架构基线 |
| 通用模板全类型可用性-…-2026-06-16 | 现行 | 通用模板线 | | `plans/2026-06-19-EIP4开发平台-架构方向-design` | 现行·权威 | 方向 D1-D7 |
| 客户沟通清单v1 | 现行 | 商务线 | | `plans/2026-06-20-人走五环建新功能-NocoBase式-design` | 现行·权威 | 主特性设计 |
| `归档/framework系统管理视图-功能点Parity对照与实现计划-2026-06-16`(84K) | 已归档 | 被 engineclass backlog 取代 | | `plans/2026-06-19-EIP4开发平台-落地执行路线图` | 现行·活路线图 | 里程碑状态已回写本期进展 |
| `归档/framework系统管理视图-实现交付报告-2026-06-17` | 已归档 | ⚠️「16 视图已交付」=demo 级,被数据驱动重审纠正;勿据此判进度 | | `归档/2026-06-20-人走五环建新功能-实施计划` | 已归档(07-02) | 24 TDD 任务全完成 + 合 main |
| `归档/framework系统管理视图-数据驱动Parity重审与修复队列-2026-06-17` | 已归档 | 被 engineclass backlog 取代 | | `AI_AGENT_AUTO_DEVELOPMENT` / `PAGE_BLUEPRINT_CONTRACT` / `REPAIR_CONTRACT` / `Nocobase_ADOPTION_PLAN` / `Nocobase_SOURCE_REVIEW` | 现行·权威 | AI 契约族;前 4 份正文个别过时点已加横幅 |
| `归档/framework定制视图-转换页审计-2026-06-17` | 已归档 | XML 审计(自评不可靠),被 engineclass backlog 取代 | | `skills/`(7 份:ai-feature-development / data-modeling / page-recipe / acl-manage / amis-pitfalls / env-manage / release-manage) | 现行·权威 | AI Agent Skills 目录(`eip4 init` 渲染分发,G1/G3) |
| `归档/EIP4-架构与缺口现状-2026-06-13`(34K) | 已归档 | 06-13 快照,早于 engineclass 重定性 + 06-14~17 全部工作 | | `framework定制视图-TODO-2026-06-17` | 现行·活清单 | 执行队列 |
| `归档/转换器覆盖度审计-2026-06-13` | 已归档 | 06-13 缺口快照 | | `framework定制视图-engineclass移植backlog-2026-06-17` | 现行·权威 | framework 主 backlog(开头有 agent 思考噪声待清) |
| `归档/F2-17-审计基线-2026-06-13-升级` | 已归档 | 自动审计快照(历史) | | `用户管理-Delta移植-…-2026-06-17` | 现行·权威 | 方法论 + 交接 |
| `归档/F2-17-组件真实性审计-修复后复测`(06-12) | 已归档 | 自动审计快照(历史) | | `组件设计体系-design-2026-06-15` | 现行(落地状态见总览 B4) | 顶部已加横幅 |
| `归档/F2-17-组件真实性审计基线`(06-12) | 已归档 | 自动审计快照(历史) | | `通用模板全类型可用性-…-2026-06-16` | 现行 | 通用模板线(§七运行库现状需复核) |
| `归档/F2-12-UI走查清单`(06-11/12) | 已归档 | UI 走查(历史) | | `客户沟通清单v1` | 现行 | 商务线(部分卡点随本期交付已消解) |
| `归档/未完成工作清单`(06-12) | 已归档 | 早期清单,已被多轮取代 | | `决策与盘点/`(架构决策报告/会纪要/客户库盘点/源码预核查/报表迁移方案/EIP4前端实施计划) | 现行·权威 + 历史盘点混放 | 决策报告/会纪要 = 现行权威红线来源;06-10 一次性盘点报告(源码预核查/客户库盘点/报表迁移方案)= 历史 |
| M0交付/、P1/、PoC证据/ 子目录 | 历史 | 阶段交付/简报/证据(保留备查,不反映当前进度) | | `plans/2026-06-24-生成式OS数据驾驶舱-design` | 指针存根 | 方案已迁独立仓 `genos-cockpit`(权威在彼仓 docs/design/) |
| `归档/`(06-14 onEvent修复/提交审批桥接/新闻管理、06-15 菜单维护、06-16 WfTemplate方案、CRUD-QA-06-14、C3压测基线、C5构建预演) | 已归档(07-02) | 一次性 plan/报告,均已落地;引用处已同步改路径 |
| `归档/`(framework parity/交付报告/数据驱动重审/转换页审计/EIP4-架构与缺口现状-06-13/转换器覆盖度审计-06-13/F2-12/F2-17 三件套/未完成工作清单) | 已归档 | 历史快照,**勿据以判进度** |
| `M0交付/`(153 处置清单 v1 / 153 终判证据包 / M0 剩余项登记) | 历史 | M0 阶段交付,已被 engineclass backlog + 终判取代 |
| `P1/`(F1/F2-x/F3/F4/P1-P4 简报 共 ~22 份) | 历史 | 阶段交付简报(部分已被后续重做取代,如审批 UI/选择窗),保留备查 |
| `决策与盘点/EIP3工程化实施计划` / `EIP3路线A-PoC执行方案` | 历史 | 早期工程化/PoC 方案 |
> eip4-web 仓另有 `docs/F1-4扫描报告.md`、`docs/P4脚手架报告.md`(06-11 一次性早期快照,建议 web 仓建 `docs/归档/` 归入)。
--- ---
## 4. 下一步指引 ## 4. 下一步指引
- framework 定制视图优先级见 backlog §5:P1 = picker 全家(机制④)/ 岗位·主岗位·查看菜单按钮组 / 查看审批 / 任务按钮 / 消息查看。 > 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5;P0②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证,**已合 main 并 push**(总览 §9);安全基线 P0(§10.1)、报表 A3(§11)、审批闭环(A2)、A10 骨架均已收口/落地。
- **主攻方向待拍板**(候选:RBAC/组织模块组做到 parity | 全模块完成度审计 | 广度优先铺基线 | 任务/审批簇接线)。
- **P0**:① 文档对齐 ✅;② AI 门禁余项 —— 引擎 ALTER 安全通道 ✅ / 安全门 enforced ✅ / overlay 审计端点 ✅;存量 overlay 白名单 strict 化推进 待续。
- **P1**:③ framework 业务 106 视图 —— **双重阻塞:卡 S1 止损评审 + EIP-3.0 源码本地未克隆,无法分析迁移**;④ 人走五环 v2 改表加列 ✅(recipe 扩面 M7 待续);⑤ 流程审批列表入口 e2e ✅(真实流转依赖客户 BPMN、BPMN 图另案);⑥ 运行时 DELETE ✅ + publish 菜单授权 ✅(部署包下沉统一待续,已查两生成器现逻辑等价无 bug)。
- **P2**:~~报表 A3 立项~~(✅ 已完成,总览 §11)/ 附件 A4 补完 / 生产上线 A10 落地执行(骨架已建,剩切流/性能/灰度 + Gitea act_runner 注册)/ 生产级 UI B4 补完。
- **进行中方向**:B3 流程 Modeler(design 已拍定,待 plan→实现);报表作者化 WEB 设计器 + Agent 设计报表(目标已立,待 brainstorm→design)。
- **待拍板**(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。
- 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。 - 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

View File

@@ -0,0 +1,88 @@
# Framework 定制视图 TODO(活清单)
> 维护日期:2026-06-18
> 口径:以 `framework定制视图-engineclass移植backlog-2026-06-17.md` 为总 backlog;本文只记录当前可执行队列、已改清单、提交与验证。
> 使用规则:每次修功能后,把条目从 Pending/In Progress 移到 Done,并补 `commit`、`tests`、`deploy/import`。没有逐功能验收的页面不能标 Done;代码已提交但页面闭环未验的项只能放在 Needs Verification。
## 当前状态
| 口径 | 数量 | 说明 |
|---|---:|---|
| framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 |
| 已逐功能验收 / 可算 Done | 约 16 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息、查看审批、我的发起任务、流程监控、通用脚本/XML 编辑器第一批、treeGrid 主键列隐藏、treeGrid 查询字段提交、treeGrid 实体分类级联、服务页实体显名、服务/实体配置下拉与子表加载、设置定时任务提醒人。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 |
| 代码已提交但待最终副作用验收 | 约 9 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;审批表单删除已补查看/删除端点和按钮注入;数据导入下载/执行入口、功能/视图设计器入口、报表宿主、工作日历已接线。上述项未覆盖所有真实业务保存、权限差异或页面副作用验收。 |
| 仍需修或逐功能验收 | 约 33 | 含上面的待验组;大多是通用页已产出,但 engineclass Java delta 未迁移或仍需真实业务副作用验收。 |
| 剩余工程单元 | 约 28+ | 多视图可复用同一套组件/端点,如脚本编辑器、消息详情、工作流按钮。 |
## Done(已完成 / 已验收)
| 日期 | 范围 | 状态 | commit | 验证 |
|---|---|---|---|---|
| 2026-06-17 | 假菜单入口移除,只走后端 `/api/menu` 真菜单 | Done | `eip4-web f7ac4cd` | `npm run build` |
| 2026-06-17 | ApprovalDrawer 全局动作:converted amis `openApprovalDrawer` -> React 抽屉 | Done | `eip4-web f7ac4cd` | `registerApprovalAction.test.ts`; `npm run build` |
| 2026-06-17 | 抽屉遮罩层级修复,避免列表工具按钮盖住抽屉 | Done | `eip4-web f7ac4cd` | `npm run build`; 手工截图问题复现点 |
| 2026-06-17 | 流程发起者展示名:`INITUSERID_DISPLAY__` 批量解析 `VIEW_SYS_USER` | Done | `eip4-platform 57c3412` | live: `会议通知` 返回 `沈波恩[000026]` |
| 2026-06-17 | 待办/已办时间范围查询:兼容 AMIS datetime-range 秒/毫秒时间戳 | Done | `eip4-platform 57c3412` | live: `2026-06-15 20:37 - 2026-06-17 20:37` 返回 `total=0` |
| 2026-06-17 | `/api/flow` 老脚本临时绑定 `UserSession`,避免无 JWT 上下文直接崩 | Done | `eip4-platform 57c3412` | `FlowControllerTest` |
| 2026-06-17 | 已办任务 `FinishTaskComponentNew`:两个模板只读「查看详细」 | Done | `eip4-platform 57c3412`, `eip4-web f7ac4cd` | 浏览器验收:`efa62458`、`c6eb659c` 均有数据、无「处理」、只读详情抽屉含业务单据和轨迹 |
| 2026-06-17/18 | 功能模板下载模板管理/设置:去右表单添加按钮、标题改「编辑模板附件」;补 `VIEW_TEMPLATEID` 门控,未关联模板节点不显示附件编辑和保存 | Done | `b5fe995`, `3276774`, `ffd8c31` | `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`;临时目录全量重转 2757 项,`SchemaImportCli` 扫描 2685 项/更新 789 项;HTTP schema 确认两页含 `funcDownloadNoTemplateTip` 与 `${VIEW_TEMPLATEID}`;内置浏览器 smoke:`待我承办` 有模板时显示附件/保存,`新闻管理` 无模板父节点隐藏附件/保存并显示提示 |
| 2026-06-17 | 实体分类-枚举组:确认 EIP4 树端点 PK 唯一 + 去重,全量建树覆盖老 UUID 防重逻辑 | Done | 文档/核验项 | 无需移植 |
| 2026-06-17 | 用户管理 Delta 端到端案例 | Done | 见 `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | 已逐字段 dogfood |
| 2026-06-18 | 消息查看/已读:收到的消息查看弹窗、打开即已读、已发送消息只读详情 | Done | `eip4-platform f690f30` | `NoticeControllerTest`; 浏览器验收 `83971d1a`:本地记录 `94d3645c-2487-47f6-bbf5-ebdff3434f6e` 置未读后列表显示“否”,打开详情后 DB 与列表均回“是”;浏览器验收 `b7635622`:已发送消息只读详情正常,无“消息详情加载失败” |
| 2026-06-18 | 短消息 `MessageManageView`:发送消息弹窗、标准用户多选 picker、写 `sys_message/sys_messageuser`、发送后刷新已发列表 | Done | `eip4-platform 723443e` | `NoticeControllerTest`; `TemplateToAmisConverterTest#engineclass_MessageSendView_注入查看按钮,#engineclass_MessageManageView_注入发送消息弹窗`; live 浏览器验收 `ae79a47b`:打开「发送消息」→ 接收人标准 amis 表格 picker(搜索/分页/checkbox)→ 发送成功 → 不点搜索即在已发列表第一行出现 `codex短消息live刷新-*` |
| 2026-06-18 | 查看审批 `WorkFlowHistoryDetailPanel`:通用审批业务列表「查看审批」从轨迹表弹窗升级为只读 `ApprovalDrawer`,支持 businessKey/processInstanceId 双路历史查看,展示业务单据 + 流程轨迹 | Done | `eip4-platform 21e3865`, `eip4-web d03c2ba` | `TemplateToAmisConverterTest#buildToolbar_审批列表补查看审批按钮`; `ApprovalControllerHistoryTest`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl platform-app -am package -DskipTests`; 全量重转 2757 项,导入更新 636 项;浏览器验收 `18fb15c9`:选中第一行 →「查看审批」打开“审批详情”抽屉,含“业务单据(总包合同评审)/流程轨迹”,无旧“审批记录”弹窗 |
| 2026-06-18 | 我的发起任务 `MySendTaskComponent`:列表改走 Flowable startedBy 聚合端点;查看详细打开只读 ApprovalDrawer;撤回桥接 Flowable changeActivityState + 挂起实例;起流写入 authenticated user,保证 startedBy 有数据 | Done | `61f3152` | `FlowControllerTest`; `FlowableClientTest`; `TodoControllerAmisTest`; `TemplateToAmisConverterTest#engineclass_MySendTaskComponent_注入查看详细和撤回按钮`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl flowable-service,platform-app -am clean package -DskipTests`; 全量重转 2757 项、导入更新 641 项;接口 E2E:`20424028` 以 `ADMIN` 发起后 `/api/workflow/process/started-amis` 返回 `E2E-MYSEND-BROWSER-20260618-0250`;浏览器验收 `0db4af06`:列表出现测试行,选中后“查看详细/撤回”启用,“查看详细”打开业务单据+流程轨迹;撤回后实例 `suspended=true` |
| 2026-06-18 | 流程监控 `ProcessMonitorComponentNew`:列表改走 Flowable 全量实例聚合;「处理」打开只读审批详情;「结束流程」桥接 Flowable terminate 并回写 `SYS_DATASTATUS=6`;「高级处理」执行 Groovy 脚本 | Done | 本次提交 | `TodoControllerAmisTest`; `TemplateToAmisConverterTest#engineclass_ProcessMonitorComponentNew_注入处理高级处理和结束流程按钮`; 接口 E2E:`/api/workflow/process/monitor-amis` 返回运行中/已撤回数据和发起人显示名,`/terminate` 已结束流程 409、运行中流程 200 且状态回写作废,`/advanced-script` 成功/失败脚本均按预期返回;全量重转 2757 项、导入扫描 2685 项/更新 677 项;内置浏览器验收 `9f3b5a8b`:列表有数据,选中后「处理/高级处理/结束流程」启用,「处理」打开业务单据 + 流程轨迹 |
| 2026-06-18 | 通用脚本/XML 编辑器(P2 第一批):定时任务脚本、数据导入转换/保存脚本、功能/视图 XML 高级配置统一走 `/api/field-editor/load|save` | Done | 本次提交 | `FieldEditorControllerTest`; `TemplateToAmisConverterTest`; live 可逆保存:`RUNSCRIPT`、`CONVERTSCRIPT`、`SAVESCRIPT`、`VIEW_TEMPLATE.XML`、`VIEW_PAGE.XML` 均完成保存-回读-恢复;非法 XML 返回业务失败不再 500;内置浏览器验收:`d99b5760` 打开「编辑任务脚本」并加载脚本,`8b89fd29` 打开「高级配置」并加载 XML,`7821ef3b` 打开「编辑转换脚本」并加载脚本,弹窗层级 `z-index=1400` |
| 2026-06-18 | 引用式 treeGrid 右表主键列隐藏:`hidden=true` 或 `iskeycolumn=true` 的 display 列统一默认隐藏,修复功能/视图/定时任务等 treeGrid 列表露出 UUID 主键 | Done | 本次提交 | `TemplateToAmisConverterTest#tree_treeGrid右表引用模板主键列默认隐藏`; `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`; 全量重转 2757 项、导入扫描 2685 项/更新 800 项;HTTP schema 确认 `8b89fd29 VIEW_TEMPLATE_ID`、`d7e12a83 VIEW_PAGE_ID`、`d99b5760 SYS_SCHEDULEJOB_ID` 均为 `toggled=false`;内置浏览器刷新 `8b89fd29` 后表头只剩「功能名称/模板类型/可作为菜单/模板解析类」,行内不再显示 UUID |
| 2026-06-18 | 服务页 `76ff564a` 实体列显名:转换器按 `SYS_REFERENCE → SYS_ENTITY` 识别旧式引用标识,把 `SYS_SERVICEFLOW.ENTITYID` 列改绑 `ENTITYID_DISPLAY__` | Done | 本次提交 | `TemplateToAmisConverterTest#引用列绑定到displayField字段`; 全量重转 2757 项、导入扫描 2685 项/更新 613 项;HTTP schema 确认服务页「实体」列 name=`ENTITYID_DISPLAY__`;接口 `/api/template/treegrid?...gridTable=SYS_SERVICEFLOW&rcol=ENTITYID` 返回 `ENTITYID_DISPLAY__=项目报销申请表`;内置浏览器刷新服务页后行显示「项目报销申请表」而非 UUID |
| 2026-06-18 | 服务/实体配置下拉与子表加载:枚举 ComboBox 在查询和编辑表单内联 `options`,避免远程字典下拉加载时序问题;`FormEditGrid` 支持旧 XML 的 `formeditgridtemplate/display/field` 列解析,并按 `pageid` 子页面字段定义恢复子表单元格组件(ComboBox/SelectDialog/NumberField 等),修复实体配置编辑/查看弹窗子表列为空或全部退化为文本框;服务页左树按排序字段/fallback 排序 | Done | 本次提交 | `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest#form_formEditGrid从display解析子表列,TemplateToAmisConverterTest#form_formEditGrid按pageid子页面字段定义生成quickEdit控件,TemplateToAmisConverterTest#crud_search枚举下拉优先内联options,TemplateToAmisConverterTest#form_editform枚举下拉优先内联options test`; `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`; 全量重转 2757 项、导入扫描 2727 项/更新 815 项;本轮补充重转导入扫描 2685 项/更新 155 项;HTTP schema 确认实体编辑 `8de37a6d` 的 `ATTRIBUTES` 子表 13 列,`ISMANDATORY/ISREADONLY` 为 `select false/true`、`REFERENCEID` 为 `picker`、`FIELDLENGTH` 为 `input-number`;接口确认项目报销申请表 `ATTRIBUTES=29`;内置浏览器验收:服务配置查询/弹窗下拉可展开,服务新增内容为 XML editor,实体配置查询下拉可展开,实体编辑弹窗「实体属性」子表表头正常显示,子表 DOM 出现 `cxd-Select`、`cxd-Picker`、`cxd-NumberControl` |
| 2026-06-18 | TreeGrid 右表查询通用修复:转换器把 gridtemplate `<search>` 字段显式拼入 `/api/template/treegrid` CRUD api,修复 treegrid 页面点击搜索不提交查询字段;BOOLEAN 查询值按列元数据 coerce,编辑兜底表单 BOOLEAN 下拉 options 与 load 返回值统一为 `false/true` | Done | 本次提交 | `TemplateToAmisConverterTest#tree_treeGrid右表查询字段拼入api`; `TemplateToAmisConverterTest#crud_search布尔枚举下拉内联为booleanOptions`; `FlowInputCoercerTest#coerceSearchValuesByTableBoolean`; 全量重转 2757 项、导入扫描 2685 项/更新 638 项;HTTP schema 确认服务页 `76ff564a` 的 treegrid api 含 `SYS_SERVICEFLOW_ID/DISPLAYNAME/ISCONTROL/ISUPDATEABLE`;接口确认 `DISPLAYNAME=项目` 返回 642 条、`ISCONTROL=false/true` 分别返回 1946/3052 条;内置浏览器验收:服务页「服务流名称=签到」从 500 页缩为 10 行且项目报销行消失,「是否受权限控制=否」后剩余行该列全为“否” |
| 2026-06-18 | TreeGrid 实体分类级联:`/api/template/treegrid` 对伪 `rcol=ENTITYTYPE` 按关联表转换为右表主键 IN,恢复功能管理/视图管理/定义定时任务左树实体分类过滤右表 | Done | 本次提交 | `TemplateTreeControllerTest`; HTTP smoke:功能管理 `VIEW_TEMPLATE`、视图管理 `VIEW_PAGE`、定义定时任务 `SYS_SCHEDULEJOB` 分类过滤均 200;内置浏览器验收:`8b89fd29` 点击「数据字典/表单管理/用户组织管理」右表分别出现自动编号/视图管理/部门选择等模板;`d7e12a83-904d-42ed-ae05-39a83bee8c76` 点击同三类后右表分别出现自动编号添加页面/视图编辑页面/部门编辑页面;`d99b5760-ce63-4e15-aa5d-05430cc25d10` 默认有定时任务,点击「数据字典/表单管理/用户组织管理」变为暂无数据,点击有数据的「人员证书管理」出现「证书借用到期提醒/十大员证到期提醒」等任务 |
| 2026-06-18 | 设置定时任务 `70f85b21`:`ScheduleJobSettingComponent` 的「设置提醒人」按旧 `SYS_SCHEDULEJOB.SENDINFO` 结构化编辑,提醒对象收敛到单列 group,避免 input-table 列级 visibleOn 导致用户/部门/岗位 picker 不显示;维度下拉兼容无 `SEQ` 字段的 `SYS_DIMENSION` | Done | 本次提交 | `ScheduleJobNotifyControllerTest`; `TemplateToAmisConverterTest#engineclass_ScheduleJobSettingComponent_注入设置提醒人规则编辑器`; `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`; 全量重转 2757 项且 onEvent 挂载 502 个模板,导入扫描 2727 项/更新 955 项;HTTP smoke:`/api/schedulejob/dimensions/options` 返回 status 0;接口闭环:对任务 `0b85a1ec-3a0b-4862-b2eb-05dd68d20481` 写入用户/部门/固定维度岗位类别/项目角色 4 类规则,DB JSON 与 GET 回显一致,验后恢复 `SENDINFO=NULL`;内置浏览器验收 `70f85b21`:选中 `test` 行打开「设置提醒人」,表头为「基于/提醒对象/短消息/邮件/手机/操作」,用户行显示标准 picker |
## In Progress / Needs Verification
| 范围 | 状态 | 缺口 | 下一步 |
|---|---|---|---|
| 流程/审批:待办任务 `TaskComponentNew` | Needs side-effect verification | 浏览器已验 `4ebfc9ee`、`0f7531e2`:列表有数据、发起人显名、查看详细抽屉、处理抽屉、遮罩层级均正常;未点最终同意/拒绝,未验处理后刷新 | 准备专门测试流程实例,或经用户确认可消耗真实待办后,再验“同意/拒绝/退回后列表刷新” |
| 用户选择框全家 | Implemented / Needs business verification | 最新口径:用户单选 `SelectDialog`、多选 `MultiSelectDialog` 均使用标准 amis `picker`(单选不加 `multiple`;多选 `multiple:true` + `overflowConfig.maxTagCount=1`;数据源 `/api/picker/<dialogid>/list`),`eip4-web` 兼容过滤器继续把存量 `user-transfer-picker` 归一成标准 picker。本轮补丁补齐运行时默认值契约:转换器给编辑/查看弹窗 load 服务追加 `?__egtpl=<editFormViewPageId>`,`FlowController` 按该编辑表单 XML 将 load 返回的 `SelectDialog/MultiSelectDialog` 裸 id 解析为 `{_id,_label}`(多选为对象数组),避免默认值显示 UUID 或撑开布局。部署:`BatchConvertCli` 全量重转 2757 项(view_page 编辑表单 1241 个产物),`SchemaImportCli` 扫描 2727 个产物、入库/更新 1054 个,8093 已重启。自动化:`mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest#read按钮接load服务_dialog用api加载本体数据,TemplateToAmisConverterTest#crud_用户单选框受控转标准Picker,TemplateToAmisConverterTest#crud_用户选择框组织与考勤模式接线,TemplateToAmisConverterTest#crud_multiSelectDialog转picker多选弹窗 test`、`mvn -q -pl platform-metadata -Dtest=FlowControllerTest#postLoadWithEditTemplateResolvesPickerDefaults test`、`npm test -- --run src/amis/registerUserTransferPicker.test.ts`。浏览器烟测:`5078945c`「用户组-分配用户」为标准多选 picker,默认值显示 `施继栋002[222222]`、无裸 UUID、控件 32px、二级弹窗含搜索/分页/checkbox;`919477da`「流程代理授权」代理人为标准单选 picker,控件与 label 对齐且二级弹窗实际 input 类型为 radio;短消息 `ae79a47b` 已覆盖多选 picker 选人并保存。 | 继续在设置定时任务、岗位设置等真实引用页验保存值、ALL 互斥、受控/全部权限差异和考勤排除挂靠 |
| 流程选择框 | Implemented / Needs business verification | `ProcessSelectController` 已提供 `/api/process-select/options|search`;转换器已把 `b3070157` 接到 amis `transfer-picker`;`919477da` 流程代理授权已重转重导并从 PARTIAL 转 SUCCESS;浏览器 smoke 可打开弹窗,显示「流程名称/已选流程」和流程名 | 继续验流程代理授权保存闭环:代理类型=指定流程时必填、保存后 `wf_agent_process` 写入/读取一致 |
| 审批表单删除 `91ccbba3` | Implemented / Needs page verification | `eip4-platform 1d8a4fe` 已补 `flowable-service` 历史流程删除端点 `/api/flow/process/{processInstanceId}/delete-history`(运行中流程 409)、网关 AMIS 端点 `/api/workflow/process/{processInstanceId}/delete-history`、`ProcessFormRemoveComponent` 查看/删除按钮注入与 CRUD reload 锚点。自动化已过:`FlowControllerTest`、`TodoControllerAmisTest,FlowableClientTest`、`TemplateToAmisConverterTest#engineclass_ProcessFormRemoveComponent_注入查看和删除历史流程按钮`;打包已过:`mvn -q -pl flowable-service package -DskipTests`、`mvn -q -pl platform-app -am package -DskipTests`。 | 重转/导入 `91ccbba3` 后浏览器验收:列表选中已结束流程 → 查看打开只读 ApprovalDrawer;删除成功后列表刷新;运行中流程删除返回 409 且不误删 |
| 功能/视图管理设计入口 `8b89fd29/d7e12a83/117374e1/de403e76` | Implemented / Browser smoke verified | `eip4-platform 5636b37`:转换器给 `UserFunDesignComponent/UserPageDesignComponent` 注入「编辑模板/编辑页面」并打开现有 `/editor.html?templateId=${selectedItems[0].<pk>}`;给自定义列表 `UserFunDesignCustomComponent/UserPageDesignCustomComponent` 按底层 `TEMPLATEID/PAGEID` 打开设计器,避免用自定义行主键。自动化:`TemplateToAmisConverterTest#engineclass_功能和视图管理注入设计器入口`、`#engineclass_功能和视图自定义列表设计器入口使用底层模板和页面Id`。部署:全量重转 2757 项、导入扫描 2727 项/更新 644 项;HTTP schema 已确认四页入口均存在;内置浏览器 smoke:`8b89fd29` 可见「编辑模板/高级配置」。 | 页面副作用验收:选中真实功能/视图行后打开设计器,编辑保存后 overlay/schema 变化可回读;自定义列表确认打开的是底层 `TEMPLATEID/PAGEID` 对应设计器 |
| 数据导入配置/文件管理 `7821ef3b/1d132d4a` | Implemented / Browser smoke verified | `eip4-platform c9e4d35` 新增 `/api/dataimport/template?configId=...` 和 `/api/dataimport/basedata`,用 SpreadsheetML 2003 输出 Excel/WPS 可打开的 `.xls`;`eip4-platform 5636b37` 新增 `DataImportExecuteController`、`DataImportExecutionService`、`DataImportExcelParser`、`DataImportScriptHelper`,支持 SpreadsheetML/Excel 解析、zip 内首个 Excel、旧 `CONVERTSCRIPT/SAVESCRIPT` Groovy、`findUser/findCompany/findDepart/findProject/findUnitProject/findProjectCompany/findUserOrg/findUserDepart/findUserPosition/savePo/saveDoc/saveWf/execSql`,`saveWf` 同步写旧 `wf_hi_*`、Flowable `act_hi_*` 和 `sys_datastatus`。转换器给 `DataImportConfigView` 注入「下载模板/下载基础数据」,给 `DataExcelImportView` 注入「执行」。自动化:`DataImportConfigControllerTest`、`DataImportExcelParserTest`、`DataImportExecuteControllerTest`、`TemplateToAmisConverterTest#engineclass_DataExcelImportView_注入执行按钮`;HTTP smoke:`7821ef3b` schema 含下载端点,`1d132d4a` schema 含「执行」和 `/api/dataimport/execute`,`POST /api/dataimport/execute?fileId=NO_SUCH_FILE` 返回业务 422;内置浏览器 smoke:`1d132d4a` 可见「执行」。 | 业务验收:选中配置后下载模板文件可打开且列符合实体;基础数据文件可打开且含公司/用户/部门/工程 sheet;准备一份非生产导入文件,点击「执行」后确认目标业务表、附件、流程历史与 `sys_datastatus` 写入一致 |
| 报表 `e81454af-0e0e-4c0d-add8-db434f198936` | Implemented / Browser smoke verified | `eip4-platform 5636b37` 新增 `ReportMenuController` `/api/report/menu-tree`,按旧 `ReportComponent` 的 DOCUMENT 菜单树口径从 `VIEW_SYS_MENU` 构建父菜单/类型/报表三级树,并只返回 `sys_page_schema` 已有的可路由叶子;`PageSchemaController` 对报表 templateId 提供内置宿主 schema,左侧树选择叶子后右侧用 `/api/page/schema/${reportTemplateId}?format=amis` 复用已转换页。自动化:`ReportMenuControllerTest`、`PageSchemaControllerTest#reportHostBuiltinSchemaFallback`;HTTP smoke:`/api/report/menu-tree` 返回 110 个叶子,宿主 schema 200 且含 `/api/report/menu-tree`、`report-schema-host`;内置浏览器 smoke:报表页显示 DOCUMENT 菜单树和「请选择左侧报表」。 | 页面副作用验收:逐类选择 3-5 个真实报表叶子,确认右侧报表页 schema 加载、查询条件、分页和导出/打印等报表专属动作是否需要继续迁移 |
| 工作日历 `a13fa07f` | Implemented / Browser smoke verified | `eip4-platform eafd872` 新增 `workCalendarService`(bean 名与旧脚本函数一致),复用旧表 `SYS_CALENDAREXCEPTDAY`,实现周末默认休息、例外日双语义(周末调班/工作日放假)、`getNextWorkDay/isWorkDay`;新增 `/api/work-calendar/year` 和 `/api/work-calendar/toggle`;`PageSchemaController` 对 XML 为空的工作日历 templateId 提供内置标准 amis schema,避免菜单 404。自动化已过:`WorkCalendarServiceImplTest`、`WorkCalendarControllerTest`、`PageSchemaControllerTest`;打包:`mvn -q -pl platform-app -am package -DskipTests`;8093 已重启。HTTP smoke:schema 200/X-Schema-Layer=standard,年度 2026 返回 365 行,`2099-01-03` 周末例外日 toggle 写入后回滚;内置浏览器验证 `a13fa07f` 页面显示工作日历、年度查询、日期列表、周休日和切换例外日。 | 用户验收:确认当前 amis 列表式年历是否接受;如必须完全复刻旧 3x4 月历网格,再补视觉布局层;再抽一个真实年份例外日做页面按钮 toggle 后 DB/回显闭环 |
| 菜单真入口 | Needs verification | 前端已去硬编码假入口;需确认所有需要的真菜单在 `sys_menu` 中可达 | 用 `/api/menu` 和页面侧栏核对 |
## P0 / P1(下一批建议先做)
| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 |
|---|---|---|---|---|
| P1 | - | - | 2026-06-18 已清零;流程监控已移入 Done | - |
## P2(中等 delta,可批量复用)
> 2026-06-18:P2 实现项和代表性浏览器烟测已完成;下表只保留不阻塞 P2 完成的真实业务副作用/产品形态确认。
| 范围 | 视图 | 要补什么 | 复用点 |
|---|---|---|---|
| 功能管理 / 视图管理 | `8b89fd29`, `d7e12a83` | 高级配置 XML、左树到右 grid 实体分类级联、编辑模板/可视化设计器入口均已接线;实体分类级联已逐页验收,仍需真实设计器 overlay 保存副作用验收 | 机制① mutator + 设计中心/overlay |
| 功能编辑列表-自定义 / 视图编辑列表-自定义 | `117374e1`, `de403e76` | 高级配置 XML、按底层 `TEMPLATEID/PAGEID` 打开设计器均已接线;仍需真实设计器 overlay 保存副作用验收 | 同设计器/编辑器能力 |
| 数据导入配置/文件管理 | `7821ef3b`, `1d132d4a` | 编辑转换/保存脚本、下载模板、下载基础数据、执行导入端点和文件页「执行」按钮已接线;待真实文件导入和下载文件打开验收 | code-editor + 导入端点 |
| 工作日历 | `a13fa07f` | 已接线:例外日服务、年度列表、toggle、3 态状态;待用户确认是否必须复刻旧 3x4 月历网格 | 新 bespoke 页 + 旧表 `SYS_CALENDAREXCEPTDAY` |
| 报表 | `e81454af-0e0e-4c0d-add8-db434f198936` | DOCUMENT 菜单树和右区按 `VIEW_TEMPLATEID` 路由复用已转换页已接线;待真实报表叶子页面副作用验收 | 路由宿主 |
## P3 / 另案
| 范围 | 视图 | 处置 |
|---|---|---|
| 电子邮件全家桶 | `27e3d27b`, `827e5a96`, `80ba2bef`, `8b30b940` | 等同 webmail 子系统,需单独立项:IMAP/SMTP、写信、收发件箱、配置、默认邮箱。 |
| 流程定义 | `5628f2e9` | Flowable Modeler 在线建模/部署/导入导出,独立子系统,需客户确认是否需要在线建模。 |
| 个人设置内联子组件 | `db87828a` | 改密已覆盖;其余手机、上级、主岗位等按用户管理/个人中心需求拆做。 |
## 待校正口径
- `docs/README.md` 和 backlog 摘要写 framework 定制视图 46 个,但 backlog 表格当前只有 45 行。后续需要从原始分析 JSON 或 `view_template` 查询补齐缺失的 1 个,避免统计漂移。
- 历史「16 视图已交付」报告已归档,不能作为完成口径;只能看本文、README 和 engineclass backlog。
- 统计必须区分 templateId、视图/engineclass 组、功能点。比如待办/已办覆盖 4 个 templateId,但按 engineclass 只算 2 组;功能模板下载覆盖 2 个 templateId,但按 engineclass 只算 1 组。
- 每次全库重转重导后,需要把影响范围写回本文,特别是 `EngineclassDelta` 的新增 mutator/registry 项。

View File

@@ -19,7 +19,7 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
**关键结论(回答提问):** **关键结论(回答提问):**
- **"默认引擎即够、零移植"= 0 个。** 这批 46 个全是被挑出来的 engineclass 视图,每个都有 Java delta。但其中 **14 个轻量delta** 实质是"默认页 + 极少量接线",接近零成本。 - **"默认引擎即够、零移植"= 0 个。** 这批 46 个全是被挑出来的 engineclass 视图,每个都有 Java delta。但其中 **14 个轻量delta** 实质是"默认页 + 极少量接线",接近零成本。
- **"有 Java delta 要移植"(轻+中+重)= 36 个。** - **"有 Java delta 要移植"(轻+中+重)= 36 个。**
- **"纯 bespoke 另案"= 10 个**(个人设置/工作日历/报表/查看审批/流程定义/流程选择框/用户选择框-org/-全部/-批量/-受控),其中用户选择框 4 个 + 流程选择框 1 个是 **picker 控件类**,价值最高、最该优先做。 - **"纯 bespoke 另案"当前剩 4 个**(个人设置/工作日历/报表/流程定义);原 10 个中的用户选择框 4 个已切标准 amis picker、流程选择框 1 个已接线,查看审批已复用只读 ApprovalDrawer 完成。
**去重提醒:**`PositionManageView` 出现 2 次(分公司岗位管理 bad92259 中等 / 岗位管理 81266f2b 轻量),同一 Java 类、同一「设置」按钮逻辑,**做 1 套复用到 2 个 templateId**。`FuncDownloadComponent` 出现 2 次(0246d4bd / 13accf09)、`FinishTaskComponentNew` 2 次(c6eb659c / efa62458)、`TaskComponentNew` 2 次(4ebfc9ee 待办 / 0f7531e2 五建)、`UserSelectWindow` 类被 3 个 picker 视图共享/继承——**按 Java 类去重后实际待写代码单元约 38 个**。 **去重提醒:**`PositionManageView` 出现 2 次(分公司岗位管理 bad92259 中等 / 岗位管理 81266f2b 轻量),同一 Java 类、同一「设置」按钮逻辑,**做 1 套复用到 2 个 templateId**。`FuncDownloadComponent` 出现 2 次(0246d4bd / 13accf09)、`FinishTaskComponentNew` 2 次(c6eb659c / efa62458)、`TaskComponentNew` 2 次(4ebfc9ee 待办 / 0f7531e2 五建)、`UserSelectWindow` 类被 3 个 picker 视图共享/继承——**按 Java 类去重后实际待写代码单元约 38 个**。
@@ -41,13 +41,13 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
| 个人设置 (db87828a) | CustomComponent | 纯bespoke | 7 | 聚合设置页 + 改密卡片(MD5 比对/更新)+ 6 个内联子组件需单独分析 | | 个人设置 (db87828a) | CustomComponent | 纯bespoke | 7 | 聚合设置页 + 改密卡片(MD5 比对/更新)+ 6 个内联子组件需单独分析 |
| 工作日历 (a13fa07f) | TemplateComponent | 纯bespoke | 5 | 年历网格 + 单击 toggle 例外日 + 3 态着色 + workCalendarService 端点(服务已存在) | | 工作日历 (a13fa07f) | TemplateComponent | 纯bespoke | 5 | 年历网格 + 单击 toggle 例外日 + 3 态着色 + workCalendarService 端点(服务已存在) |
| 报表 (e81454af) | TreeGridTemplate | 纯bespoke | 5 | DOCUMENT 菜单树 + 右区按 VIEW_TEMPLATEID 路由复用已转换页(宿主/路由器) | | 报表 (e81454af) | TreeGridTemplate | 纯bespoke | 5 | DOCUMENT 菜单树 + 右区按 VIEW_TEMPLATEID 路由复用已转换页(宿主/路由器) |
| 查看审批 (b4d00f1a) | WorkFlowHistory | 纯bespoke | 3 | businessKey→processInstanceId 双路解析 + 接 ProcessInstanceDetailPanel(P1 缺口) | | 查看审批 (b4d00f1a) | WorkFlowHistory | 已完成 | 3 | 通用审批列表「查看审批」已复用只读 ApprovalDrawer,支持 businessKey/processInstanceId 双路历史查看 + 业务单据 + 轨迹 |
| 流程定义 (5628f2e9) | CustomComponent | 纯bespoke | 11 | Flowable Modeler 整页 + 新建/导入/编辑/部署/导出(含 VIEW_WFTEMPLATE 迁移 SQL) | | 流程定义 (5628f2e9) | CustomComponent | 纯bespoke | 11 | Flowable Modeler 整页 + 新建/导入/编辑/部署/导出(含 VIEW_WFTEMPLATE 迁移 SQL) |
| 流程选择框 (b3070157) | Window | 纯bespoke | 3 | 流程多选穿梭框 picker + Flowable RepositoryService 列流程端点 | | 流程选择框 (b3070157) | Window | 已接线待验 | 1 | 已接 amis transfer-picker + `/api/process-select`,Flowable Model/ProcDef 优先、本地 dev 回退历史流程名;剩流程代理授权保存闭环验收 |
| 用户选择框-org (1b3bad0b) | UserSelectWindow | 纯bespoke | 6 | picker + 公司/部门/岗位类别 3 tab + 部门级联 + 全体人员 ALL 互斥 | | 用户选择框-org (1b3bad0b) | UserSelectWindow | 已接线待验 | 2 | 最新已切标准 amis `picker`,数据源 `/api/picker/1b3bad0b-a24b-4347-9466-db78f7432756/list`;多选仅通过 `multiple: true`,弹窗为表格+checkbox+搜索分页;剩真实业务保存、ALL 互斥、权限差异验收 |
| 用户选择框-全部 (090981ba) | UserSelectWindow | 轻量* | 3 | 同受控 picker,唯一差异=admin 上下文查询(绕数据权限);4 tab 复用受控版 | | 用户选择框-全部 (090981ba) | UserSelectWindow | 已接线待验 | 1 | 最新已切标准 amis `picker`,数据源 `/api/picker/090981ba-0c10-4d84-92dc-80e226594480/list`;剩 admin 上下文/权限差异验收 |
| 用户选择框-受控 (76d2f950) | CustomComponent | 纯bespoke | 8 | 受控用户 picker 主体(单/多选穿梭框 + 4 来源 tab + 部门树)— picker 之母 | | 用户选择框-受控 (76d2f950) | CustomComponent | 已接线待验 | 2 | 最新已切标准 amis `picker`,数据源 `/api/picker/76d2f950-ef40-4eff-89ec-98ad9a4976b9/list`;单选/多选由转换器按原控件类型生成;剩真实引用页保存验收 |
| 用户选择框-批量 (e31ce405) | CustomComponent | 纯bespoke | 6 | 考勤范围穿梭框 picker(硬过滤 iscollected=1)— 复用受控壳 | | 用户选择框-批量 (e31ce405) | CustomComponent | 已接线待验 | 1 | 最新已切标准 amis `picker`,数据源 `/api/picker/e31ce405-21c4-4892-94bb-e87e07b7f8e7/list`;剩考勤排除挂靠业务验收 |
| 功能编辑列表-自定义 (117374e1) | GridTemplate | 中等 | 5 | 编辑模板(按 type 1/100/200 设计器)+ 高级配置 + TemplateCustomService | | 功能编辑列表-自定义 (117374e1) | GridTemplate | 中等 | 5 | 编辑模板(按 type 1/100/200 设计器)+ 高级配置 + TemplateCustomService |
| 视图编辑列表-自定义 (de403e76) | GridTemplate | 中等 | 5 | 编辑模板(FormPageTemplateCustomDesign)+ 高级配置 XML + PageCustomService | | 视图编辑列表-自定义 (de403e76) | GridTemplate | 中等 | 5 | 编辑模板(FormPageTemplateCustomDesign)+ 高级配置 XML + PageCustomService |
| 实体 (b4154b1f) | GridTemplate | 中等 | 7 | 实体规则/脚本工具/编辑默认服务流 3 按钮 + flowService/dataDicService 端点 | | 实体 (b4154b1f) | GridTemplate | 中等 | 7 | 实体规则/脚本工具/编辑默认服务流 3 按钮 + flowService/dataDicService 端点 |
@@ -57,7 +57,7 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
| 审批表单删除 (91ccbba3) | GridTemplate | 中等 | 6 | 查看(复用 WfTemplate 只读表单)+ 删除(dleteCompleteProcessInstance 物理删) | | 审批表单删除 (91ccbba3) | GridTemplate | 中等 | 6 | 查看(复用 WfTemplate 只读表单)+ 删除(dleteCompleteProcessInstance 物理删) |
| 设置定时任务 (70f85b21) | GridTemplate | 中等 | 6 | 「设置提醒人」按钮 + UserTable 6 类级联编辑器 + SENDINFO JSON 双向序列化 | | 设置定时任务 (70f85b21) | GridTemplate | 中等 | 6 | 「设置提醒人」按钮 + UserTable 6 类级联编辑器 + SENDINFO JSON 双向序列化 |
| 收到的消息 (83971d1a) | GridTemplate | 中等 | 5 | 查看 + 打开即已读联动 + MessageService 4 端点 + 深链接 process 入口 | | 收到的消息 (83971d1a) | GridTemplate | 中等 | 5 | 查看 + 打开即已读联动 + MessageService 4 端点 + 深链接 process 入口 |
| 我的发起任务 (0db4af06) | GridTemplate | 中等 | 5 | 查看详细 + 撤回(activebackProcess + 已流转校验,flowable 桥+表映射) | | 我的发起任务 (0db4af06) | GridTemplate | 已完成 | 5 | 列表改走 Flowable startedBy 聚合端点;查看详细复用只读 ApprovalDrawer;撤回桥接 Flowable changeActivityState + 挂起实例;起流写 authenticated user |
| 流程监控 (9f3b5a8b) | GridTemplate | 中等 | 5 | 处理/高级处理(groovy 脚本运行时)/结束流程(endProcess 作废) | | 流程监控 (9f3b5a8b) | GridTemplate | 中等 | 5 | 处理/高级处理(groovy 脚本运行时)/结束流程(endProcess 作废) |
| 数据导入配置管理 (7821ef3b) | GridTemplate | 中等 | 6 | 编辑转换/保存脚本 + 下载模板(POI)+ 下载基础数据 + DataImportService | | 数据导入配置管理 (7821ef3b) | GridTemplate | 中等 | 6 | 编辑转换/保存脚本 + 下载模板(POI)+ 下载基础数据 + DataImportService |
| 短消息 (ae79a47b) | GroupTemplate | 中等 | 4 | 发送消息按钮 + MessageSendForm(用户多选 picker)+ SYS_MESSAGE_ADD(TYPE=2) | | 短消息 (ae79a47b) | GroupTemplate | 中等 | 4 | 发送消息按钮 + MessageSendForm(用户多选 picker)+ SYS_MESSAGE_ADD(TYPE=2) |
@@ -75,7 +75,7 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
| 待办任务 (4ebfc9ee) | GridTemplate | 轻量 | 6 | 查看详细 + 处理(对接 ApprovalDrawer)+ 处理完刷新闭环 | | 待办任务 (4ebfc9ee) | GridTemplate | 轻量 | 6 | 查看详细 + 处理(对接 ApprovalDrawer)+ 处理完刷新闭环 |
| 待办任务(五建) (0f7531e2) | GridTemplate | 轻量 | 4 | 同 4ebfc9ee | | 待办任务(五建) (0f7531e2) | GridTemplate | 轻量 | 4 | 同 4ebfc9ee |
\* 「用户选择框-全部」JSON 判轻量,但其实质依赖「用户选择框-受控」整套 bespoke UI 先就位,故工程上随受控 picker 一起做。 \* 「用户选择框-全部」JSON 判轻量,但其实质依赖「用户选择框-受控」整套 UI;当前已随受控 picker 一起接线,剩权限差异验收。
--- ---
@@ -100,14 +100,14 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
**聚合同类:** **聚合同类:**
- **「岗位↔用户 设置」按钮** = 2 视图(分公司岗位/岗位管理)同 Java 类,**做 1 套**。 - **「岗位↔用户 设置」按钮** = 2 视图(分公司岗位/岗位管理)同 Java 类,**做 1 套**。
- **「查看XX菜单」下钻** = 用户管理 + 用户组管理,**结构完全同构**,1 套参数化。 - **「查看XX菜单」下钻** = 用户管理 + 用户组管理,**结构完全同构**,1 套参数化。
- **「查看详细/处理」任务跳转** = 待办/已办/已办(测试)/五建定制/我的发起任务,**共用选行→taskId→打开详情页**逻辑,跳转目标复用 ApprovalDrawer/轨迹引擎。 - **「查看详细/处理」任务跳转** = 待办/已办/已办(测试)/五建定制/我的发起任务,**共用选行→taskId/processInstanceId→打开详情页**逻辑,跳转目标复用 ApprovalDrawer/轨迹引擎;我的发起任务已按 processInstanceId 验收。
- **systemLogManager 删除按钮** = 系统日志查询(全部删/按类型删)+ 用户登录历史(按条件删),**同 bean、3 个端点一起暴露**。 - **systemLogManager 删除按钮** = 系统日志查询(全部删/按类型删)+ 用户登录历史(按条件删),**同 bean、3 个端点一起暴露**。
**B. 依赖工作流引擎(activiti→flowable 桥,需新端点 + 表映射,中高成本):** **B. 依赖工作流引擎(activiti→flowable 桥,需新端点 + 表映射,中高成本):**
| 按钮 | 视图 | 依赖 | 状态 | | 按钮 | 视图 | 依赖 | 状态 |
|---|---|---|---| |---|---|---|---|
| 撤回 | 我的发起任务 | `activebackProcess` + VIEW_ACT_TASK 已流转校验 | 需 flowable 桥端点 + act_hi_* 表映射 | | 撤回 | 我的发起任务 | `activebackProcess` + VIEW_ACT_TASK 已流转校验 | 已完成:`/api/flow/process/{id}/withdraw` + `/api/workflow/process/{id}/withdraw`,含 DATASTATUS 守卫、已流转评论校验、回起始节点并挂起 |
| 结束流程 | 流程监控 | `endProcess` 逐个作废 active 任务 | 需端点 | | 结束流程 | 流程监控 | `endProcess` 逐个作废 active 任务 | 需端点 |
| 高级处理 | 流程监控 | `evaluateGroovy` 运行时脚本 | 需端点(高危,加权限/审计) | | 高级处理 | 流程监控 | `evaluateGroovy` 运行时脚本 | 需端点(高危,加权限/审计) |
| 编辑默认服务流 | 实体 | `flowService.addDefaultFlowService` 返回 boolean 分支 | 需端点 | | 编辑默认服务流 | 实体 | `flowService.addDefaultFlowService` 返回 boolean 分支 | 需端点 |
@@ -164,12 +164,12 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
| 视图 | 建议 | 理由 | | 视图 | 建议 | 理由 |
|---|---|---| |---|---|---|
| 用户选择框-受控 (76d2f950) | **必做 P1** | picker 之母,审批/表单处理人选择的关键组件;无它一批表单不可用 | | 用户选择框-受控 (76d2f950) | 已接线待验 | 已切标准 amis `picker`;web 兼容历史 schema,platform 转换器已按单选/多选输出 picker;剩真实引用页保存验收 |
| 用户选择框-org (1b3bad0b) | **必做 P1** | 组织维度多源选择,复用受控壳 + 3 tab | | 用户选择框-org (1b3bad0b) | 已接线待验 | 已切标准 amis `picker`;弹窗表格支持搜索/分页/checkbox 多选;剩 ALL 互斥/权限差异/业务保存验收 |
| 用户选择框-全部 (090981ba) | **必做 P1** | admin 上下文变体,随受控壳一起;短消息收件人直接引用此模板 | | 用户选择框-全部 (090981ba) | 已接线待验 | 已切标准 amis `picker`;剩权限差异验收 |
| 用户选择框-批量 (e31ce405) | 做 P2 | 考勤专用,复用受控壳 + 1 个硬过滤端点 | | 用户选择框-批量 (e31ce405) | 已接线待验 | 已切标准 amis `picker`;剩排除挂靠业务验收 |
| 流程选择框 (b3070157) | 做 P2 | 流程多选,Flowable 列流程端点 | | 流程选择框 (b3070157) | 已接线待验 | 流程多选 picker 已接;剩流程代理授权保存闭环验收 |
| 查看审批 (b4d00f1a) | **必做 P1** | 正中 memory 记录的 P1 缺口(查看审批未接业务页);双路解析已有基础 | | 查看审批 (b4d00f1a) | 已完成 | 通用审批列表「查看审批」已接只读 ApprovalDrawer;见活清单 2026-06-18 记录 |
| 工作日历 (a13fa07f) | 做 P2 | 后端 workCalendarService 已在,只缺前端年历 + REST,性价比高 | | 工作日历 (a13fa07f) | 做 P2 | 后端 workCalendarService 已在,只缺前端年历 + REST,性价比高 |
| 报表 (e81454af) | 做 P2 | 路由/宿主,右区复用已转换页,逻辑不重但需 DOCUMENT 菜单端点 | | 报表 (e81454af) | 做 P2 | 路由/宿主,右区复用已转换页,逻辑不重但需 DOCUMENT 菜单端点 |
| 个人设置 (db87828a) | 拆做 P2/P3 | 改密卡片 P2(改密接口),6 个内联子组件需先各自分析源文件(暂缓) | | 个人设置 (db87828a) | 拆做 P2/P3 | 改密卡片 P2(改密接口),6 个内联子组件需先各自分析源文件(暂缓) |
@@ -178,8 +178,8 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
**被 EIP4 别的机制覆盖 / 可降级的:** **被 EIP4 别的机制覆盖 / 可降级的:**
- 实体分类-枚举组:树 key 唯一若 EIP4 按父路径生成则**已覆盖**(只需核对)。 - 实体分类-枚举组:树 key 唯一若 EIP4 按父路径生成则**已覆盖**(只需核对)。
- 待办/已办/我的发起任务的"详情/办理页":**已被 EIP4 ApprovalDrawer + WfTemplate 驱动 + 轨迹引擎覆盖**,只补列表入口按钮,不从零搭。 - 待办/已办/我的发起任务的"详情/办理页":**已被 EIP4 ApprovalDrawer + WfTemplate 驱动 + 轨迹引擎覆盖**,不从零搭;我的发起任务列表入口、查看详细、撤回已验收。
- 查看审批的 ProcessInstanceDetailPanel:复用轨迹引擎,只缺 businessKey→processInstanceId 解析接线。 - 查看审批的 ProcessInstanceDetailPanel:已复用 ApprovalDrawer/轨迹引擎完成;businessKey 与 processInstanceId 双路只读历史入口已接线。
--- ---
@@ -200,23 +200,22 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
所有 override-service 的非标 bean(3.2 端点清单)在保真层暴露为 `/api/flow/{servicename}` 或专用 REST;转换器对工作流类按钮(撤回/结束/查看审批)通用识别 act 表语义。 所有 override-service 的非标 bean(3.2 端点清单)在保真层暴露为 `/api/flow/{servicename}` 或专用 REST;转换器对工作流类按钮(撤回/结束/查看审批)通用识别 act 表语义。
- 适用:**override-service 全部、工作流引擎按钮、工作日历/导入/日志服务**。 - 适用:**override-service 全部、工作流引擎按钮、工作日历/导入/日志服务**。
**④ 前端 amis 自定义组件** — **picker 类 + 代码编辑器 + 设计器**。 **④ 前端 amis 扩展组件 / 标准 picker 配置** — **picker 类 + 代码编辑器 + 设计器**。
- picker(用户/岗位/流程多选穿梭框):做 EIP4 自定义 amis 组件(transfer/tabs-transfer + 部门级联 + ALL 互斥),复用 picker 加载显名修复;**1 个组件参数化覆盖受控/org/全部/批量/流程 5 个**。 - 用户 picker 最新按标准 amis `picker` 接线:单选默认、多选仅加 `multiple: true`,统一 `/api/picker/<dialogid>/list`,避免自定义穿梭框破坏查询/表单布局;历史 `user-transfer-picker` schema 由 web 兼容层归一。流程 picker 继续走 amis transfer-picker/专用流程源。后续只在标准 picker 无法覆盖时再考虑自定义组件。
- 代码编辑器:amis `input-editor`(xml/groovy 模式)做通用脚本弹窗。 - 代码编辑器:amis `input-editor`(xml/groovy 模式)做通用脚本弹窗。
- 可视化设计器:对接 amis-editor 或自有低代码设计器(最重,流程定义对接 Flowable Modeler)。 - 可视化设计器:对接 amis-editor 或自有低代码设计器(最重,流程定义对接 Flowable Modeler)。
**推荐组合:** 轻/中量 delta → 机制①+③;重度 bespoke 编辑器 → 机制②+④+③;picker → 机制④(自定义组件)+③(查询端点)。 **推荐组合:** 轻/中量 delta → 机制①+③;重度 bespoke 编辑器 → 机制②+④+③;用户 picker → 机制④(标准 amis `picker` 配置)+③(查询端点),不再把旧双栏 `user-transfer-picker` 作为常规渲染路径。
--- ---
## 5. 推荐移植序列 ## 5. 推荐移植序列
**P1(先做:高频/高价值/服务多已就绪,直接产出客户可感知能力)** **P1(先做:高频/高价值/服务多已就绪,直接产出客户可感知能力)**
1. **用户/流程 picker 全家(机制④,1 个参数化组件)** — 受控(76d2f950)+org(1b3bad0b)+全部(090981ba)+批量(e31ce405)+流程(b3070157)。**审批/表单/短消息全链路依赖,做完一大批表单立即可用。** 1. **picker 业务验收** — 用户选择框受控(76d2f950)+org(1b3bad0b)+全部(090981ba)+批量(e31ce405)最新均为标准 amis picker,流程选择框(b3070157)已接线待验;继续验真实保存、权限差异、ALL 互斥、流程代理授权写入。**审批/表单/短消息全链路依赖。**
2. **岗位↔用户 / 主岗位 / 查看菜单 一组按钮** — 分公司岗位+岗位管理(复用 1 套)+用户管理+用户组管理。SYS_* 服务疑似已在,接线即得。 2. **岗位↔用户 / 主岗位 / 查看菜单 一组按钮** — 分公司岗位+岗位管理(复用 1 套)+用户管理+用户组管理。SYS_* 服务疑似已在,接线即得。
3. **查看审批 (b4d00f1a)** — 正中 memory P1 缺口,双路解析 + 复用轨迹引擎。 3. **待办/已办/五建/我的发起 任务按钮(共用跳转逻辑)** — 对接已上线 ApprovalDrawer,补列表入口即闭环。
4. **待办/已办/五建/我的发起 任务按钮(共用跳转逻辑)** — 对接已上线 ApprovalDrawer,补列表入口即闭环。 4. **消息查看一组** — 已发送/收到的消息(查看弹窗 + MessageService + 打开即已读)。
5. **消息查看一组** — 已发送/收到的消息(查看弹窗 + MessageService + 打开即已读)。
**P2(后做:中等 delta,服务需补但范围清晰)** **P2(后做:中等 delta,服务需补但范围清晰)**
6. 通用脚本/XML 编辑器弹窗(机制④)→ 一次性解锁:定义定时任务、数据导入配置脚本、流程监控高级处理、功能/视图编辑列表-自定义 高级配置。 6. 通用脚本/XML 编辑器弹窗(机制④)→ 一次性解锁:定义定时任务、数据导入配置脚本、流程监控高级处理、功能/视图编辑列表-自定义 高级配置。
@@ -233,6 +232,6 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
--- ---
**相关绝对路径(待移植/待伴生分析的源文件):** **相关绝对路径(待移植/待伴生分析的源文件):**
- `/Users/zhengwr/workspace/eip3/eip4-platform`(EIP4 后端/转换器,机制①③ 落点)、`/Users/zhengwr/workspace/eip3/eip4-web`(机制④ amis 自定义组件落点) - `/Users/zhengwr/workspace/eip3/eip4-platform`(EIP4 后端/转换器,机制①③ 落点)、`/Users/zhengwr/workspace/eip3/eip4-web`(机制④ 标准 amis 配置兼容层与少量前端扩展落点)
- picker 之母:`framework/com.dsasp.client.organize/src/com/dsasp/clinet/organize/view/UserSelectWindow.java`(及子类 UserOrgSelectWindow/AllUserSelectWindow) - picker 之母:`framework/com.dsasp.client.organize/src/com/dsasp/clinet/organize/view/UserSelectWindow.java`(及子类 UserOrgSelectWindow/AllUserSelectWindow)
- 待伴生分析(JSON 中标注需另读):`SqlScriptToolWindow.java`、`RuleMainView.java`、`MailSettingWindow.java`、个人设置 6 子组件(ChangeuserphoneView/LeaderSettingComponent/MainPoisitionSettingComponent/DefPageSizeComponent/CustomMenuSettingComponent/DefProSettingComponent)、`FlowServiceEditor.java`/`ServiceFlowAdvance.java`、`UserTable.java`(设置定时任务)、`EditorProcessDefinitionDetailPanel.java`(流程定义) - 待伴生分析(JSON 中标注需另读):`SqlScriptToolWindow.java`、`RuleMainView.java`、`MailSettingWindow.java`、个人设置 6 子组件(ChangeuserphoneView/LeaderSettingComponent/MainPoisitionSettingComponent/DefPageSizeComponent/CustomMenuSettingComponent/DefProSettingComponent)、`FlowServiceEditor.java`/`ServiceFlowAdvance.java`、`UserTable.java`(设置定时任务)、`EditorProcessDefinitionDetailPanel.java`(流程定义)

View File

@@ -0,0 +1,133 @@
# EIP4 开发平台 · 架构方向(与最初设计对齐版)
> 日期:2026-06-19 | 性质:方向级 design(brainstorm 收敛 + 最初设计考古 + 引擎代码核实 + 对抗审查产出)
> 配套权威:`项目进度与路线-总览-2026-06-21.md`(A 兼容 / B 新能力全景,取代 06-17 版)、`架构设计.md`(双层制/选型/红线)、`决策与盘点/EIP4前端与收尾实施计划.md`(F4 低代码工具链原始定义)
> 方法:9-agent workflow(7 路考古/代码核实 → 综合 → 对抗审查),逐行核实引擎实况。
---
## 0. 一句话结论
**「153 收尾后做可视化开发平台」不是另起炉灶,是项目最初路线图里 F4「低代码工具链 L1→L3」的兑现。** 方向成立(对抗审查判决 `sound-with-fixes`),但最初设计逼出三根硬约束(一根是「触发重新决策」级),需带 6 条修正落地。
## 1. 背景与驱动(用户拍板)
- **先 B 提效、再 A 卖点**:先用新能力填「建页/建模/交付太慢太贵」的钱坑,再讲 AI/现代化差异化。
- **递进**:存量 153 定制视图用现有兼容方式(转换器 mutator)啃完(已完成几十个);真正重点是 153 后,面向「**未来功能维护 + 新功能开发**」要有一套现代可视化开发平台,覆盖【**元数据 → 表结构 → 设计 → 实现功能 → 发布**】五环。
- **AI 独立轨**:已在另一分支做,定位=给 AI coding 工具(Claude Code/Cursor)供 **MCP + CLI**,不是应用内 AI 生成 schema。
- **定位**:内部交付提效工具(**非**对客户售卖的低代码/自助配置平台——见 §5 红线)。
## 2. 与最初设计「一脉相承」的依据(5 处文档锚点)
| 本方向 | 最初设计原文锚点 |
|---|---|
| 五环【元数据→表→设计→实现→发布】 | 《EIP4前端与收尾实施计划》F4 总览:**「低代码工具链 L1→L3,门控:无(架构已拍板)」**;§七:L1 页面设计器=amis-editor 二开 / L2 实体建模器=可视化维护 SYS_ENTITY / L3 流程设计器=bpmn.js + Flowable。末环=§6.3 在线导入发布 |
| 现代层 authoring 长在引擎上 | 架构设计 §一「**保真层供奉、现代层生长**」+ ArchUnit 单向纪律(`com.eip4.*` 可调 `com.dsasp.*`,反向禁止) |
| 一个 schema 世界 | §6.2「SYS_PAGE_SCHEMA 标准层 + overlay 层,升级时标准层整体替换、overlay 保留提示 diff」 |
| AI 独立轨给 MCP+CLI | 最初 **P5「MCP/AI 工具层」** 逐字吻合 |
**引擎实况(已读码核实)**:四环里**三环引擎已在保真层活着**——`Entity.java`/`POInfo.java`/`POJOCRUDServiceImpl`(元数据 CRUD)、`Entity.createTableSql`→`DataDicServiceImpl`(动态建表)、`FlowExcuteServiceImpl`(534 行,含 `insertNodeAfter/removeNode` 图编辑原语 + `saveOrUpdate` 写回 `SYS_SERVICEFLOW`)、Groovy/JUEL 脚本引擎。
## 3. 最初设计强加的三根硬约束(对抗审查核实)
### ① 最大矛盾 · 焊死退路(go/no-go 级)—— 决策:**签字下注 amis**
最初把 amis-editor/自研设计器钉为「amis fork 失败时的防御性 **Plan B**」(止损 S2,换渲染器损失仅 1–2 人月)。架构决策报告 §四「触发重新决策条件#1」:*若决策层不接受永久 fork + 终身自维护前端渲染器的预算 → 须重评其他 Apache 渲染层*。把 amis-editor 升为战略主线 = 主动焊死退路 = 踩中该触发条件。
**已知天花板(写进立项)**:amis-fork 6.13.0 冻结于 2025-08、近 3 月零上游提交、bus factor≈1、需 **0.5–1 人/年自维护**。
**用户拍板**:✅ 签字下注 amis。**但附带关键现实**:**DesignerPage 当前还无法真正使用**(见 §7)——下注成立的前提是先把它弄到能用。
### ② 「补 UI 非造引擎」被系统性低估 —— 真实=「一环就位 + 两环要补引擎」
- **设计环**:✅ 就位,但**仅 edit-only on 存量页**(e2e 68/68 验的是 overlay 存取往返,**不等于设计器可用**)。
- **建模环**:🔴 引擎层**不能 ALTER**(`executeCreateSql` 只接受 CREATE,`DataDicServiceImpl:193-200`);`MetaController` 是克隆 SYS_USERGROUP、限 `EIP4AI_` 前缀的 **AI 雏形**,非面向人。新建实体后改字段**零迁移路径**。
- **编排环**:🔴 `FlowController` **只执行不编辑**,flow 仍是老 XML,EIP4 侧 **0 个 authoring REST**。
### ③ overlay 是 edit-only —— 「一个 schema 世界」附条件成立(一次性数据建模门)
`SYS_PAGE_SCHEMA_OVERLAY` 以 `template_id` 为主键、`base_etag` 挂靠**转换器产出的标准层**。「一个 schema 世界 + 可升级」的优雅**只在「先有标准底版、overlay 是其差量」时成立**。**从零新建的页没有标准底版**,其生命周期/升级/diff 在最初设计里是**空白**。「改存量页已上线」≠「新建页平台就绪」。
## 4. 逻辑编排器(唯一硬骨头)—— 决策:**b 主干 + 人工 20% + c 增量,否决 a**
- **否决 a(节点图编辑器)**:最初零根基;`Flow.java:422/454` 对非线性流主动抛「请用高级配置进行编辑」——证明**连老 EIP3 自己的可视化也只覆盖线性流**。节点图是最重前端投资、对冻结栈纯新增,ROI 最差。
- **b 主干**:80% 常规联动/线性服务流走声明式配置面(32 个 facade 动词 onEvent 面板,复用已有),不写代码即提效。
- **诚实修正(对抗审查)**:b 只覆盖**老系统已能可视化的线性流**;那 20% 复杂逻辑(非线性流/有副作用 Groovy/跨流条件=最初 S3 留下的 **115 份人工作业单**)**b 接不住**。
- **故**:那 20% **默认保留「人工作业单」兜底**(人写 Groovy/JUEL,复用 `field-editor`);**c(AI 生成)仅「加速人工 + 人工复核入库」增量**,platform-ai 空壳未落地前**不算进对外交付能力**。对外能力边界=「**b 声明式 80% + 人工 20%**」。
## 5. 落地形态(与最初设计对齐)
不立「新平台」为独立大项目,而是把 F4 三件套 + §6.2 overlay + §6.3 发布 + P5 MCP 正式化为一套「**现代层 authoring 模块集合**」,落在 `platform-metadata` 等现有模块内(不新进程),守三红线:
> **4 进程私有化单体 / 无新中间件 / 无多租户**;authoring 必须走既有引擎接口签名(POInfo/Entity/DataPrivilege/FlowExcuteService)**不旁路**。
- **存储层零新增**:authoring 全部读写 `SYS_ENTITY`/`SYS_ENTITYATTRIBUTE`(元数据真相)、`SYS_SERVICEFLOW.CONTENTXML`(服务流真相)、`SYS_PAGE_SCHEMA`+overlay(页面真相)。「元数据即白名单」运行期/开发期同源。
- **定位红线**:架构决策报告 §2.1a 已把「交付带动态建表的低代码平台能力给客户继续配置」定性为合同敏感地带(曾用于否决路线 B)。新平台守在**内部提效工具**,不对外做 SaaS/多租户配置平台。
## 6. 分期路线(每期标复用什么 / 补什么引擎欠账)
| 期 | 目标 | 关键交付 | 真实前置 / 复用 |
|---|---|---|---|
| **P0** | 立底座 + 门禁 | 组件设计体系 **L1 主题 token 做到生产级**(决策2「先 B 提效」的 UI 前提);为新 authoring 产物补**正确性门禁**(新建页无对拍基准!→ 元数据变更 CRUD 烟测 + 编排执行对拍 + overlay 版本可审计回滚 + schema 双闸复用);amis 战略取舍立项书签字 | **真实前置=组件 L1,非 153**;复用 overlay 双层、schema 双闸 |
| **P1** | 设计环正式化 + **先修 DesignerPage 可用性** | 诊断并修复 DesignerPage「无法使用」(见 §7);从「改存量」升级到能用;**补 net-new 页数据模型/生命周期**(闭合 §3③门);收敛独立设计中心(评估 `DesignCenterPage.tsx` 雏形);facade onEvent 声明式面板第一块 | 复用 DesignerPage/overlayApi、PageSchemaController、facade 动词表 |
| **P2** | 建模环 | **先补引擎安全 `alterTableSql`**(加法在线/改删走升级窗口,守 §6.3 红线)再做 L2 建模器 UI;MetaController 从 AI 雏形重写为面向人 | 复用 Entity.createTableSql + 缓存失效免重启 |
| **P3** | 编排环(硬骨头·打法 b) | 服务流 authoring REST 出口(暴露 `FlowServiceImpl.saveOrUpdate` + 图编辑原语)+ 声明式线性流配置面 + Groovy 代码编辑器兜底;BPMN 审批流走 L3 bpmn.js | 复用 FlowExcuteService + Flow 图编辑原语 + DefaultFlowHelper |
| **P4** | 发布环 + 链条贯通 | §6.3 元数据资产包另存/导入;「建实体→合成默认流→生成默认页→设计器微调→发布」串通 | 复用 §6.3 资产包 + 缓存失效 + DefaultFlowHelper |
| **P5** | AI 工具面(决策3 独立轨·c 兜底) | Meta/Flow 端点升级为正式 MCP,接通 platform-ai 空壳,消除两套 authoring 入口 | 复用已建端点 + schema 校验 |
> 启动次序:**与 153 收尾并行**(用户拍板)。解除「153 收尾后才做」硬前置——153 进度由商务 S1 拍板、不由技术,挂其后会被无限期阻塞。**但据实承认**:新平台真实前置是组件 L1,不是把「等 153」换成「等组件 L1」的隐藏依赖游戏。
## 7. DesignerPage 现状(状态标记,非当前动手任务)
> 定性:这是一个**已知状态**(用户实测不可用),作为 D1 amis 下注的前置验证项纳入 P1,**不在架构方向讨论里展开 debug**。诊断已查实环境层根因嫌疑(见下),最终复现/修复留到 P1 执行期。
**入口模型(D5 已定)**:单一「设计中心」菜单入口(运行态/设计态分离),废弃每页注入按钮。`DesignCenterPage.tsx`(fetchMenu→collectLeaves 列页 + 「设计」入口)是正确雏形方向,需补「新建页」与 net-new 生命周期(§3③)。
**「打开没有内容」环境层查实(curl/lsof 实测,2026-06-19)**:
- **8093 是纯 API 后端,完全不托管前端**(`/`、`/index.html`、`/assets/*`、`/editor.html` 全 404);
- 前端只活在 **4 个 stale 重复 vite dev server**(5174-5177);`.env` 有重复 `VITE_BACKEND_TARGET`(8084→8093)——**stale 实例代理到死端口 8084 → schema 拉不到 → 画布空** 是头号嫌疑;
- editor.html 入口页本身没坏(vite 上 200 + CSS 直链 200,dist 构建也正确);
- 这同时暴露 **A10:整个前端(设计器在内)没有被托管的家,只跑临时 dev 进程** —— 设计器「无法使用」一半是部署/托管缺失。
**旧线索(仍待 P1 复现确认)**:
- e2e 只验 overlay 存取往返,**未验设计器作为 authoring 工具可用**;
- 报告自承「**facade onEvent 可视化面板未做**」——能拖布局、配不了行为;
- `editor.html` CSS 走 `/node_modules/...` 直链(dev-only hack),**生产构建可能裂**;
- **edit-only on 存量页**,不能新建/绑新实体(§3③门);
- `DesignerPage.handleRestore` 注释自承:amis-editor 整体替换 value 会「白屏」,故还原后整页 reload(提示 amis-editor 二开的脆性)。
**下一步**:钉准「无法使用」的真实症状(开不了 / 白屏 / 只能改存量 / 能改但太糙/配不了逻辑 / 生产构建裂),再定 P1 第一锤。
## 8. 6 条必须吞下的修正(对抗审查 fixes)
1. 「放弃渲染层可换退路」升为立项**硬 go/no-go**,立项书签字接受 amis-fork 冻结天花板。(✅ 用户已签)
2. 为 net-new 页补数据模型与生命周期,再谈「一个 schema 世界」;闭合前不把「设计中心」当「新平台就绪」对外宣称。
3. 拆 b/c 真空:20% 复杂逻辑默认「人工作业单」兜底,c 仅「加速人工 + 人工复核」,platform-ai 落地前不算进交付。
4. 引擎层**先补安全 `alterTableSql` 并冻结边界**再做 L2 UI;MetaController 重写为面向人,别在 AI 雏形上长 UI。
5. 解除「153 后才做」硬前置,但 P0 据实命名「L1 底座 + authoring 门禁」,不用隐藏前置替换显式前置。
6. 为新 authoring 产物新设正确性门禁(新建页无对拍基准)——提为 **P0 交付物**,是绕过最初数据事故控制机制的唯一补偿。
## 9. 顶层风险
- 逻辑编排环是最初真空地带、无对拍基准、最高不确定(S3 自动化率 <80% 即触发工期重估)。
- amis-fork 冻结天花板被加码(押更多二开在 bus factor≈1 的栈上)。
- 建表 ALTER 缺口 × §6.3「DDL 只允许加法在线」红线夹击——「改表」体验天然受限,不能做成自由在线 DDL。
- 「元数据即白名单」在线 authoring 下可能反转为约束:白名单变活动目标,并发 authoring 的一致性/缓存时序是新攻击面。
- 组件体系未达生产级即做设计中心=重蹈「功能对但观感差」覆辙。
## 10. 决策记录(本次锁定)
| # | 决策 | 选择 |
|---|---|---|
| D1 | amis-editor 战略下注 | ✅ 签字下注(接受冻结天花板);前提=先修 DesignerPage 可用性 |
| D2 | 新平台启动次序 | ✅ 与 153 并行(真实前置=组件 L1) |
| D3 | 逻辑编排打法 | ✅ b 主干 + 人工 20% + c 增量,否决 a |
| D4 | 对外定位 | 内部提效工具(守 §5 合同红线)|
| D5 | **设计入口模型** | ✅ **单一「设计中心」菜单入口**(运行态/设计态分离);**废弃每页注入的设计按钮**(转换器 `EngineclassDelta:898` + PageRenderPage「设计」按钮,用户已移除)。开发/设计是独立工作区,不混进业务页工具栏 |
| D6 | **AI 轨形态** | ✅ AI = **独立 NocoBase 式 CLI 编程轨**(`feature-package` 为单元的 scaffold→dev→verify→release 生命周期,供 Claude Code/Cursor 等 AI coding 工具操作),**不并入设计中心**。EIP4 的「插件」等价物 = 元数据 feature-package(非代码插件) |
| D7 | **设计中心定位** | ✅ 设计中心 = **给实施人员的纯人工 no-code**(b 轨),不挂 AI 入口;AI 走 D6 独立 CLI 轨 |
---
## 11. 落地状态(2026-06-19 续)
- **AI agent 分支已合入 main(`9aea6c1`)**:交付了五环+横向的后端地基一大半(schema 门禁/三真相 authoring 端点/recipe-blueprint/元数据建实体/CLI 种子),并由 3 个收口提交保障合 main 安全(分流 `bac69d8` / admin 门 `c379f5b` / 对外口径 `9aea6c1`)。逐项对账 + 有序里程碑见 **`2026-06-19-EIP4开发平台-落地执行路线图.md`**(活计划)。
- **仍为 P0 锁定前置且未起步**:组件设计体系 **L1 主题 token 生产级**(D2)——路线图 M0。
- 本方向级 design 为权威决策记录;可执行里程碑/状态以路线图为准。
*本文为方向级 design;细化实施计划见配套《落地执行路线图》。*

View File

@@ -0,0 +1,80 @@
> 🔄 **里程碑状态回写(2026-06-21)**:正文部分表述已被本期进展推进,以此处与 [总览-2026-06-21](../项目进度与路线-总览-2026-06-21.md) 为准。
> - ✅ **M0**(L1 主题 token)已上线;✅ **M-Gate**(渲染冒烟 `4b564c6`)已做;✅ **M3a**(单一写真相 `PageSchemaWriter` `d3b8846`)已做;✅ **DesignerPage 全闭环**(`2278cbc` 等,原 §1/§2「DesignerPage 打不开」已解除);✅ **人走五环 v1** 全链交付合 main;✅ **两仓已 push origin/main**(`75f942b`/`d1fd6ed`,§5「push = 用户决策」已完成);🟡 **M7** recipe 扩面部分(master-detail-v1 已做,余待 v2)。
> - 🔴 仍未起步:**M4**(引擎 ALTER 安全通道)、**M5**(onEvent 声明式面板)、**M8**(CLI NocoBase 化 + 安全 Part2)、**M1 生产单源托管**(dev 反代已通,生产托管 = A10)。
# EIP4 开发平台 · 落地执行路线图
> 日期 2026-06-19 | 活计划,配套《2026-06-19-EIP4开发平台-架构方向-design.md》(方向+锁定决策 D1-D7)。本文是该 design doc 承诺的「另立 plan 文档」。每里程碑落地后回写状态。
> **经对抗审查修订**:补回 D2 锁定的 P0 前置(组件 L1);把正确性门禁(渲染冒烟)置于真库 dogfood 之前;net-new 旁路先收口为单一写真相再立新端点;区分「build 完成 vs env 终验」。
## 0. 修订要点(为什么不照搬初稿)
- design §6 的 P0 = **组件 L1 主题 token 生产级**,是 D2 锁定的「真实前置」;初稿漏了,本版补为 **M0**,且设计中心-facing 里程碑(M3b 新建入口 / M5 面板)必须 gated 在 M0 之后(否则重蹈 design §9「功能对观感差」覆辙)。
- design fix#6:新 authoring 产物无对拍基准,**渲染冒烟闸是绕过原数据事故控制的唯一补偿**——必须先于任何真库 dogfood。
- net-new 标准层现由 `AiLocalReleaseExecutor:158` 裸 JDBC 旁路直写;新端点必须**先把旁路收口为单一写函数**,否则两套写法并存(语义/审计/etag 漂移)。
## 1. AI 合并交付对账(设计五环+横向 → 已交付 → 状态 → 剩余)
> 图例:🟢=主体已交付且无 P0 级剩余 | 🟡=部分交付/有 P0 级剩余(见右列)| 🔴=未起步。main 现位于 `9aea6c1`(fast-forward 纳入 AI 合并 `bd4c642` + 3 收口 `bac69d8`/`c379f5b`/`9aea6c1`,全 reactor 10 模块绿)。
| 环/横向 | 已交付 | 状态 | 剩余(含 P0 标注) |
|---|---|---|---|
| 横向·正确性门禁 | TypedPageSchemaValidator + recipe 逐字节对拍 + 官方 draft-07,已接 putOverlay(分流后只对 AI 草稿严格) | 🟡 | **[P0] 渲染冒烟闸未做**(`AiSmokeRunner` 仅 HTTP 探针,playwright-render 无执行代码)= design fix#6 唯一补偿控制 |
| ①元数据 | `MetaController.createEntity` + 动态 CREATE + 缓存失效 | 🟡 | 引擎不能 ALTER;L2 建模器 UI 无;仍克隆 `SYS_USERGROUP` 做载体 |
| ②表结构 | `createTableDdl`(控制器内联) | 🟡 | ALTER 缺口;DDL 类型映射双份真相(与引擎漂移险) |
| ③设计 | recipe/blueprint 编译器(2 recipe)生成 amis 页;DesignerPage 改存量(分流后存量页可存 overlay) | 🟡 | DesignerPage 打不开(serving/env);net-new 正规写端点缺(走 AI 旁路);onEvent 声明式面板未做;recipe 仅 2 |
| ④实现功能 | `AiFeatureDraftGenerator` 用保真层 `DefaultFlowHelper` 生成默认 5 服务流 | 🟡 | 无人工编排 UI;只默认流;无服务流语义级 gate |
| ⑤发布 | deployment-package + CLI release ops + feature-package/revision 快照 | 🟡 | online apply 断档(人工跑 SQL);菜单注册未串端到端;**净新标准行无删除/回滚路径** |
| 横向·CLI | `Eip4Cli`(env/ai/release ops) | 🟡 | feature-package 为单元的 scaffold→dev→verify→release 生命周期未成型 |
| 横向·安全 | admin 门 + localhost 门 | 🟡 | `check()` 身份/scope 未织入写路径(等 CLI 身份模型) |
| 横向·UI 底座(组件 L1) | — | 🔴 | **[P0] L1 主题 token 未起步**(design §6 P0 锁定前置,D2);repo 无 token 资产 |
## 2. 有序里程碑
### 前置地基(design 锁定 P0,先于一切设计中心-facing 工作)
- **M0 组件设计体系 L1 主题 token 生产级**[自主 build / 需 env 终验观感]:落 `组件设计体系-design` L1 主题层。D2 锁定前置 + 设计中心/设计器观感底座。**M3b/M5 必须在 M0 后**。
- **M-Gate 正确性门禁第二闸(渲染冒烟)**[harness 自主 / 需 headless 终验]:Playwright/headless 对 previewUrl 真渲染断言(可视 + 无控制台报错),替 `AiSmokeRunner` HTTP 探针。design fix#6 唯一补偿控制——**必须先于任何真库 dogfood(M2)**。
### 先宽度(让 2 recipe + 设计器对存量 真端到端可用)
- **M1 Serving 解锁(A10)**[配置部分自主 / 终验需 env]:(a) 修 stale vite 代理死端口 8084 + `safeLocalBase` 默认(可自主改配置);(b) 前端(含设计器)被真正托管 → DesignerPage 能打开(终验需 env)。先消 design §7 已定位的环境性根因。
- **M3a net-new 写路径收口(单一写真相)**[自主 + TDD]:把 `AiLocalReleaseExecutor:158` 裸 `INSERT sys_page_schema` 改为调用**唯一共享写函数**(复用 typed 校验/审计/etag);`PageSchemaController` 加标准层写端点复用同一函数。**验收 = sys_page_schema 写入只剩一个函数,无旁路裸 INSERT**。**收口先于新建入口**。
- **M2 真库 dogfood(沙箱 schema)**[需 env + admin creds]:AI 产 EIP4AI_净新 CRUD → 过三闸(**含 M-Gate 渲染冒烟**)→ **写一次性/沙箱 schema(非共享生产 PG)** → 浏览器打开可用;附净新行清理/回滚脚本。**前置 = M-Gate + M3a**。
- **M3b 设计中心「新建功能」入口**[前端,gated by M0 + M3a]:`DesignCenterPage` 加新建入口,走 M3a 共享写函数;设计角色细分(复用 RBAC)。
- → **宽度闭环**「建实体→生成默认页→设计器微调→发布」可演示(前置 M0/M-Gate/M1/M3a 全绿)。
### 再深度
- **M4 引擎 ALTER 安全通道 + DDL 单源**[自主 build / 需 env 终验]:保真层白名单化 `alterTableSql`(只加列/扩长/改可空,改删走升级窗口)+ `MetaController` alter 端点 + 独立安全门;顺带把 `createTableDdl` 的第二份 DDL 类型映射收敛回引擎单源(消漂移)。
- **M5 onEvent 声明式面板(逻辑 b 主干第一块·design P3 硬骨头)**[前端,gated by M0]:32 facade 动词配置面板。**风险储备**:design 标的最高不确定环(S3 自动化率 <80% 触发工期重估);**20% 复杂逻辑保留「人工作业单」兜底**(design fix#3),不进面板。
- **M7 recipe 扩面**[自主 + TDD]:主子表/EditGrid/审批/组合 tabs recipe + 字段控件补 select/picker/input-tree/引用列(每种自带逐字节对拍基准)。
- **M8 CLI NocoBase 化 + 安全 Part2**[design + code 自主]:feature-package 为单元 scaffold→dev→verify→release 生命周期(D6);「认证用户→AI employee→scope」映射 + `check()` 织入写路径。
## 3. 自主 vs 需环境(build 完成 ≠ 集成已证)
| 里程碑 | 可自主 build + unit-test | 需 env/creds 终验 |
|---|---|---|
| M0 L1 token | 定义 token 层 | 生产级观感(浏览器) |
| M-Gate 渲染冒烟 | Playwright harness 代码 | 真渲染断言(headless) |
| M1 serving | 改 vite/8084 配置 | 托管 + 打开终验 |
| M3a 收口 | 共享写函数 + 端点 + TDD | —(纯写路径,集成在 M2 证) |
| M2 dogfood | — | 端到端(沙箱 PG + admin) |
| M3b 新建入口 | 端点接线 | 浏览器新建终验 |
| M4 ALTER | alterSql + 端点 + TDD | 真 PG 在线加列证 |
| M5 面板 | 面板代码 | 浏览器联动证 |
| M7 recipe | 编译器 + 对拍 TDD | 渲染证 |
| M8 CLI/Part2 | 命令 + 身份映射 + TDD | 端到端证 |
> **纪律**:M3a/M4/M7 的「完成」= **code-complete, integration-pending**;集成声明等 env 终验,不在绿单测上宣称端到端 done。
## 4. 下一步(已定,honest)
**M3a — net-new 写路径收口为单一写真相**(自主 + TDD,不依赖 env,不碰 L1-gated UI,收口 critic 点名的三真相旁路纪律)。其「完成」严格限 **code-complete**;端到端宽度价值待 M0/M-Gate/M1/M2 解锁后证。
**M0(L1)与 M1(serving 配置)可并行起**(L1 是 D2 锁定前置);M2/M3b/M5 的浏览器/真库终验等用户给登录方式。
## 5. Housekeeping
- 本文 + design doc(补 D6/D7)commit 进 main。
- main 现领先 origin/main 20 提交(AI 合并 + 3 收口),**push = 用户决策**(两仓需先 add remote 到私有托管,见 memory `eip3-git-remotes-latentchat`)。
- worktree `eip4-platform-ai-agent` 已与 main 同 commit,可清理。
---
*本文为活的执行计划;状态随里程碑落地回写。方向/决策权威见配套 design doc。*

View File

@@ -0,0 +1,99 @@
# 人走五环建新功能 · NocoBase 式(建模器 + 实时设计器)· 设计
> 日期 2026-06-20 | brainstorm 产物 | 配套《2026-06-19-EIP4开发平台-架构方向-design.md》(方向 D1-D7)+《2026-06-19-EIP4开发平台-落地执行路线图.md》(里程碑 M0-M8)。
> 决策来源:memory `eip4-human-five-ring-wizard`(宽度 vs 深度 → 选 B:人走五环建新功能,AI 退回加速器)。
> 本文是该特性的设计定型,供新会话直接跑 `superpowers:writing-plans` 出实施计划。
## 0. 一句话
给老引擎本来就有的「元数据驱动低代码核」配一套 **NocoBase 式的现代 UI(建模器 + 实时设计器),不做线性问卷向导**;让人能走完整五环(元数据→设计→实现→发布)建新功能,AI 作为加速器、不是唯一通道。
## 1. 锁定的决策(带依据)
- **D-A 形态 = 建模器 + 实时设计器,不做线性 wizard。** 依据:用户指定参考 NocoBase,NocoBase 用「实时所见即所得区块设计器 + 一键切使用/配置模式」,明确**不用向导**;且我们今天刚把 DesignerPage(amis-editor)修到全闭环,与之天然契合。
- **D-B v1 只「建新功能」,不「改已有表」。** 依据:CREATE 建表后端已 live 验证(见 §3);唯一缺口是 ALTER(改已有表的列)= 路线图 M4,留给 v2。
- **D-C 建完实体走「recipe 自动产默认页 → 进设计器微调」,不走「空白页现拖组件绑实体」。** 依据:`PageBlueprintCompiler.compile()` 吃 blueprint 直接产出**已接好 `/api/flow/{TABLE}_SEARCH` 的页**(`PageBlueprintCompiler.java:50`);DesignerPage 现为 **edit-only**(只改存量页),recipe 预接好页正好落在它能干的范围内,**设计器无需长「从零绑实体」的新能力**。
- **D-D「AI 帮我」走 ①面(外部 agent + Skills + CLI 驱动确定性工具),不在平台内置生成 LLM。** 依据:见 §3——平台主路径零 LLM,NocoBase 的「建功能 AI」本身就是外部 coding-agent CLI + Skills;EIP4 已建好这套底座(`docs/skills/` + `platform-cli` + `AiToolRegistry` + `AiEmployee`)。②面(in-app AI employees,平台内置 LLM)= v1 之后单独立项。
- **D-E 元数据单一真相 = `SYS_ENTITY` + `SYS_ENTITYATTRIBUTE`(老系统保真层),新旧共用。** 见 §3。
## 2. 整体形态 + 建功能流程
**两个界面(落在设计中心):**
1. **建模器**(新建的唯一无对应 UI 的环)— 建/浏览实体 + 字段,包 `POST /api/meta/entity`。
2. **实时设计器**(DesignerPage / amis-editor,已有,edit-only)— 微调页面。
**建一个新功能的流:**
```
①建模器建实体+字段
→ POST /api/meta/entity(写 SYS_ENTITY/SYS_ENTITYATTRIBUTE + 真 CREATE 物理表)
②选 recipe(维护CRUD / 树CRUD)
→ PageBlueprintCompiler 自动产出已接 /api/flow 的默认页 → 落 sys_page_schema(标准层)
③默认页进 DesignerPage 微调(拖列/调布局)
④选菜单位置 + 发布(PageSchemaWriter 单一写真相 + 菜单注册)
(五流 _ADD/_UPDATE/_SEARCH/_DELETE/_LOAD 由 DefaultFlowHelper 默认生成,可见可确认,多数不用人管)
```
**设计中心两入口(人/AI 共用同一套后端 + 同一份 schema):**
- **`[+ 新建功能]`**(人):自己在建模器 + 设计器里走五环。
- **`[⚡ AI 建功能]`**(AI ①面):触发外部 agent + 现有 skills/CLI 链(`POST /api/ai/features/auto-develop`),产 `READY_FOR_HUMAN_REVIEW` 草稿,人回设计器审/改/发。
## 3. 关键架构事实(brainstorm 核实,几条反直觉的)
1. **元数据单一真相、新旧共用。** `MetaController.createEntity` 把实体行写进 **`SYS_ENTITY`**(`:89`,克隆 SYS_USERGROUP 的实体描述行做模板载体)、字段行写进 **`SYS_ENTITYATTRIBUTE`**(`:246`)。这两张表 + 引擎在 `platform-legacy-core`,包名 `com.dsasp.server.common.dataDic.service`——**老系统保真层原物**。eip3 老系统本身就是元数据驱动低代码平台;「转换」只动页面层(XML/engineclass → amis `sys_page_schema`),元数据一行没转。
2. **CREATE 建表后端已 live。** `createEntity` 走 `createTableDdl()` 拼真 DDL → `dataDicService.executeCreateSql(ddl)` 真执行(`MetaController.java:130-131`),补索引、失效缓存。AI agent 建新表就走这条。**唯一缺口是 ALTER**(改已有表)= M4。
3. **平台主路径零 LLM。** `AiFeatureRequest` 完全结构化(`featureName/tableName/entityName/List<AiFeatureField> fields/pageRecipe`),连 `auto-develop` 吃的都是它,不是自然语言。`AiFeatureDraftGenerator` 按规则确定性编译。**平台内唯一 LLM = `HttpAiLlmRepairClient`,`@ConditionalOnProperty(...repair.enabled,"true")` 默认关,且只做修复不做生成。** NL→结构化 spec 的魔法在平台外(外部 coding-agent 经 CLI)。
4. **NocoBase 的「建功能 AI」= 外部 agent CLI + Skills。** NocoBase Skills 官方定义 =「给 AI Agent CLI(Claude Code、Codex、Cursor 等)用的可复用领域知识包」,外部加载、非服务端组件,agent 经 CLI/API 在权限+审计下驱动 no-code 操作。EIP4 已有对应底座。NocoBase 另有 in-platform「AI Employees」(业务用户在 App 内对话,内置 LLM)= 我们的 ②面,v1 不做。
5. **recipe 编译器吃 blueprint 产已接 API 的页。** `PageBlueprintCompiler.compile()` 设 `crud.api=/api/flow/{TABLE}_SEARCH`、列、增删改按钮(`:45-72`);`AiFeatureDraftGenerator` 已串了这条(`:47-52`)。
## 4. 真正要新建 vs 复用(端点均已核实)
**复用(端点/能力都已 live):**
| 环 | 复用 |
|---|---|
| 建实体+建表 | `POST /api/meta/entity` |
| 标准层页写 | `PUT /api/page/schema/{templateId}/standard`(M3a 单一真相)|
| 设计器存改+门禁 | `/api/page/schema/{templateId}/overlay` + `/validate` + `/components` |
| recipe 列表 | `GET /api/ai/page-recipes` |
| 菜单注册 | `POST /api/admin/menus/create` |
| 微调页面 | DesignerPage(amis-editor) |
| AI 建功能链(①面) | `POST /api/ai/features/auto-develop`(基址 `/api/ai`)|
| CRUD/flow 自动伺服 | 保真层引擎 |
**真正要新建(4 件):**
1. **建模器 UI(前端,最大块)**:列已有实体 / 建新实体(名/表)+ 字段表(列/类型/显示名/长度/必填/引用其它实体)。包 `POST /api/meta/entity`。最复杂控件 = **引用列(referenceid,外键选其它实体)**。
2. **「recipe→默认页→落标准层」单步端点(后端,小)**:把 `PageBlueprintCompiler.compile` + `/standard` 写串成人可单步调的端点(现在只埋在 `auto-develop` 里)。属路线图「把 AI pipeline 拆成可单步调」收口的第一块。
3. **「+ 新建功能」编排薄壳(前端)**:建模器→选 recipe→落页→跳设计器→发布(菜单注册)串起来。
4. **「⚡ AI 建功能」入口接线(前端 + 少量后端)**:网页触发 `auto-develop`,把 `READY_FOR_HUMAN_REVIEW` 草稿回流到设计器供人审/改/发。
## 5. v1 边界(YAGNI)
- 只建新,**不改已有表**(ALTER/M4 = v2)。
- recipe 限现有 2 种(维护 CRUD / 树 CRUD)→ **v1 只覆盖简单 CRUD/树类功能**;主子表/审批/组合 = 路线图 M7 扩面后。
- 设计器 **edit-only** 够用(recipe 预接好页)。
- **②面 in-app AI employees 不做**(平台内置 LLM = 独立大特性 + 红线扩面,v1 之后立项)。
## 6. 守红线(与架构 D3 + memory `eip4-ai-agent-merge-mapping` 一致)
- 发布**恒人审**。
- AI 入口产物状态**恒 `READY_FOR_HUMAN_REVIEW`**。
- 标准层写**恒走 `PageSchemaWriter` 单一真相**(M3a 已收口,不得旁路裸 INSERT)。
- 平台进程内**不内置生成 LLM**(仅 repair 钩子,默认关)。
## 7. 要在 plan 里钉死的 3 个未知
1. **建模器引用列(外键)UI**:怎么选其它实体?下拉已有实体列表 + 选目标显示列?这是建模器最复杂的控件,需先定交互。
2. **recipe 仅 2 种 = v1 能建的功能类型窄**:这是 v1 定位,需跟产品对齐——v1 明确只支持简单 CRUD/树类新功能,复杂功能引导走老路或等 M7。
3. **发布 online apply 断档**(路线图:线上仍人工跑 SQL):v1「发布」到哪一步算完?**真上线** vs **出部署包人工执行**?决定 ④环的终点与是否需要 env/creds 终验。
## 8. 不做 / 推迟
- ALTER/改已有表(M4,v2)
- recipe 扩面:主子表/EditGrid/审批/组合 tabs(M7)
- ②面 in-app AI employees / 平台内置 LLM 生成端点
- 纯 NocoBase「空白页拖组件现绑实体」(需给 amis-editor 造绑定能力,v1 用 recipe 预接好规避)
---
*本文为 brainstorm 定型设计。下一步:新会话跑 `superpowers:writing-plans` 出带文件路径/代码示例/验证步骤的实施计划,§7 三未知在 plan 阶段钉死。*

View File

@@ -0,0 +1,9 @@
# 生成式 OS 数据驾驶舱(GenOS Cockpit)— 已迁出本仓
> 2026-06-24:本方案定为**独立产品**(不属于 Java 后端仓),已迁至独立仓 `genos-cockpit`。
- 项目:**GenOS Cockpit / 生成式 OS 数据驾驶舱**(独立可单独部署的伴随模块,EIP4 为首个集成)
- 权威文档位置:`/Users/zhengwr/workspace/genos-cockpit/docs/design/2026-06-24-生成式OS数据驾驶舱-design.md`
- 原型简报:`/Users/zhengwr/workspace/genos-cockpit/docs/design/genos-cockpit-claude-design-brief.md`
一句话:用自然语言表达意图 → daemon 驱动用户本机 CLI agent(平台不内置 LLM)→ 经 **EIP4 platform-mcp** 取数(自动继承 RBAC)→ OpenUI Lang 流式自组装成驾驶舱。与 EIP4 **只通过 MCP/REST 松耦合**,不替换 amis、不进确定性五环主路径。最大前置门 = S1 拍板是否引入运行态 LLM。

View File

@@ -0,0 +1,114 @@
# A10 生产上线工程化 · design(2026-06-25)
> 目标读者:拍板人 + 执行者。本文是**待拍板设计**,不是已实现记录。对应进度总览 §3 A10(🔴 未起步)、§5 P2#9、§10.2「生产交付能力缺口」。
> 定位:把「dev 能跑」推进到「客户环境可交付、可回滚、可观测」。**纯设计产出,不依赖运行环境**;落地需用户环境(真 DB / 容器宿主 / Gitea runner)。
> **🛠️ 实施进度(2026-06-25,本地 PG+Docker 真验)**:**W1 Flyway 已实现 + 真验**——`platform-app` 加 flyway-core + flyway-database-postgresql(10.10.0),`db/migration/V1-V3`(sys_page_schema/sys_datastatus/sys_ai_*,DDL 从既有幂等 bootstrap 迁入),`application.yml` 启 Flyway(baseline-on-migrate + baseline-version=0),dev/local 的 spring.sql.init 收敛移除(app 运行态 provisioning 单一走 Flyway)。`FlywayMigrationLocalIT` 对真实 PostgreSQL 15.18 验两场景全绿:① 全新 schema→V1-V3 建全表+幂等;② 既有非空 schema(已有 sys_page_schema+数据)→baseline V0→V1-V3 幂等应用、既有行不破坏(=客户库接管场景)。**docker build 两镜像真验通过**(daemon 已起:platform-app 727MB/flowable 641MB)。**残留(收敛 follow-up)**:platform-ai/metadata/flow-gateway 的 bootstrap-*.sql 仍在(ci.sh/AiAgentDdlTest/parity fixture 用),与 db/migration 形成文档级重复——全收敛(删 bootstrap、ci.sh/测试改指 db/migration)待后续;app 运行态已单源。
>
> **W2+W3+W4 MVP 骨架已落地**(按推荐默认 D1 nginx 单源 / D3 compose+systemd 双轨 / D4 env / D6 客户 PG)——`platform-app/Dockerfile`、`flowable-service/Dockerfile`、`deploy/{nginx.conf,docker-compose.yml,.env.example,README.md,systemd/*.service}`。验证:`docker compose config` 通过(4 服务 + 变量插值);**`docker build` 待有 daemon 的 dev/CI 真验**(本机 daemon 未起)。验证过程揪出并修:flowable-service 双数据源(FLOWABLE_JDBC_*/BIZ_JDBC_*)env 漏传已补。**W1 Flyway 未做(下一批次)→ 当前 compose 假定 DB 已置备,尚不能从零自举平台表**。W5/W6 需准生产。
## 0. 一句话
EIP4 当前只有 **dev 形态**(手工 `run-dev.sh` 起两个 fat jar + 前端 vite proxy)。生产化缺四块成体系交付物:**① Flyway 平台表迁移 ② 容器化/编排(compose+Dockerfile+nginx)③ 单源托管与切流回滚 ④ 数据迁移 runbook 执行 + 性能/灰度基线**。可观测性(actuator+logback)与安全基线(prod profile/JWT/CI)本月已补,是 A10 的前置已就位。
## 1. 现状底数(2026-06-25 实测)
**运行进程(2 个 Spring Boot fat jar + 外部依赖)**
| 进程 | 端口(dev/base) | 角色 |
|---|---|---|
| `platform-app` | 8093 / 8084 | 主应用:保真层引擎 + 现代层 REST + 前端 schema 服务 |
| `flowable-service` | 8089 | 工作流引擎(Flowable)独立进程 |
| PostgreSQL | 5435(共享测试库) | 数据(客户库 eip3 schema + EIP4 平台表) |
| 前端 | vite 5173 dev proxy→8093 | amis SPA,prod 需静态托管 |
**已就位前置**:prod profile(`application-prod.yml`,JWT/DB 强制 env、fail-safe 安全链)、actuator `/actuator/health`(liveness/readiness)、logback 滚动日志、CI(`.gitea/workflows/ci.yml` + parity-nightly,待 runner 激活)。
**缺口(实测)**
- **Flyway 零落地**:平台表 DDL/数据散落 —— `docs/sql/*.sql`(7) + 各模块 `src/main/resources/bootstrap/*.sql`(`bootstrap-page-schema`/`bootstrap-datastatus`/`bootstrap-ai-agent`),且 **`bootstrap-ai-agent.sql` 在 platform-ai 与 platform-app 各一份**(易漂移)。无版本化、无执行顺序保证、无幂等台账。
- **无 `Dockerfile` / `docker-compose` / `nginx.conf`**:四服务编排、切流/回滚仅停在文档。
- **前端无生产托管**:dev 靠 vite proxy;prod 无 nginx/伴服方案。
- **数据迁移 runbook 备而未执行**:`docs/P0-PG升级/PG升级Runbook-v1.md`、`docs/P3-Flowable升级/Flowable升级Runbook-v1.md` 写好未跑。
- **无性能/并发基线、无灰度机制**。
> **关键边界(务必先共识)**:保真层跑在**客户既有 eip3 库**之上,EIP4 只**新增**平台表(`SYS_PAGE_SCHEMA`/`SYS_*_AI`/datastatus 等),**不迁移/不改客户业务表 schema**。故 Flyway 只管「EIP4 新增表」,客户库 schema 由保真层原样消费。这条决定 Flyway 范围与切流模型。
## 2. 目标生产拓扑
```
┌──────────── nginx (单源) ────────────┐
client → │ / → web dist (静态 SPA) │
│ /api/** → platform-app:8084 │
│ /flowable/** → flowable-service:8089 (按需)
└───────────────────────────────────────┘
│ │
platform-app flowable-service
(prod profile) (prod profile)
└────────┬───────────┘
PostgreSQL(客户库 eip3 schema + EIP4 平台表)
```
四容器:`nginx` / `platform-app` / `flowable-service` / `postgres`(生产 PG 多为客户既有实例,compose 里的 pg 仅自测/演示用)。
## 3. 工作分解(建议顺序 + 体量)
| ID | 工作 | 体量 | 依赖 | 产出 |
|---|---|---|---|---|
| **W1** | **Flyway 收敛平台表** | M | — | 引入 flyway-core;把散落 EIP4 平台表 DDL/种子整理为 `db/migration/V{n}__*.sql`(仅 EIP4 新增表,排除 parity 测试种子 + 客户库);去重 `bootstrap-ai-agent`;platform-app 启动跑 migrate(`flyway.baseline-on-migrate=true` 接管既有库)。**幂等 + 版本台账 + 执行顺序确定**。 |
| **W2** | **容器化** | M | W1 | 两个多阶段 `Dockerfile`(temurin-jre-21 运行层 + 非 root + actuator HEALTHCHECK);前端 `npm run build` → 静态产物;`.dockerignore`。 |
| **W3** | **单源托管 + 反代** | S-M | W2 | `deploy/nginx.conf`:serve web dist + `/api`→platform-app、`/flowable`→flowable-service;gzip/缓存/SPA history fallback。**消除 dev 的 vite proxy 依赖**。 |
| **W4** | **compose 编排 + 配置** | M | W2,W3 | `deploy/docker-compose.yml`(4 服务 + healthcheck + depends_on + 网络);`.env.example`(`EIP4_AUTH_JWT_SECRET`/`EIP4_DB_*`/`SERVER_PORT` 等,prod profile 已强制无默认);`SPRING_PROFILES_ACTIVE=prod`。 |
| **W5** | **数据迁移 runbook 执行** | M-L | W1 | 把 PG升级 / Flowable升级 两 runbook 在准生产真跑一遍并补「执行记录 + 回退验证」;产「客户环境部署 checklist」。**需真 DB/环境**。 |
| **W6** | **性能/并发基线 + 灰度** | L | W4,W5 | 关键只读路径压测基线(连接池/statement_timeout 已配,需实测);切流灰度=nginx upstream 权重(老 eip3 Vaadin ↔ 新 eip4 只读双跑),对接已有切流文档;回滚演练。 |
**最小可交付(MVP 切片)**:W1+W2+W3+W4 = 「一条 `docker compose up` 起全栈、Flyway 自动建平台表、nginx 单源访问」。W5/W6 需准生产环境,独立排期。
## 3.1 W1 Flyway 详细执行规格(ready-to-run,2026-06-25 勘探后细化)
> **状态(2026-06-25 更新)**:✅ **已实现 + 对本地真实 PG 验证通过 + 整栈 docker compose 真起 + 残留全收敛**。
> - 真验:`FlywayMigrationLocalIT`(库级两场景)+ 整栈 `docker compose up` 内置空 PG:platform-app 在 prod profile 启动时 Flyway 自建 eip3 schema 落 9 张 sys_* 表、readiness UP、nginx 单源反代生效(见 `deploy/README.md` 验证状态)。
> - 残留收敛(已完成):删 3 份与 db/migration 重复的 bootstrap(page-schema/datastatus/ai-agent);`ci.sh` 改指 `db/migration/V1`;`AiAgentDdlTest` 迁入 platform-app 改守 V3;新增 `SchemaImportCli.CREATE_DDL`↔V1 防漂移 guard(`PlatformMigrationDdlGuardTest`)。db/migration 现为平台表 DDL 唯一真相(SchemaImportCli 内联 DDL 为独立 CLI 兜底,经 guard 钉死不漂移)。
> **已做前置(2026-06-25)**:`bootstrap-ai-agent.sql` 两份去重——删 platform-app 副本,单一真相归 `platform-ai/src/main/resources/bootstrap/bootstrap-ai-agent.sql`(platform-app 经依赖传递消费;原同 classpath 路径双副本=解析歧义,已消除)。
**为何需 PG 才能安全做**:迁移 SQL 是 PG 专有(`::jsonb`/`::xml`/`ON CONFLICT`),H2 跑不了;本机 Docker daemon 未起→testcontainers 也用不了。盲发自动 migrate 进客户库启动路径=高爆炸半径,必须先在 dev PG 验过 `flyway migrate` + 回退。
**迁移清单(EIP4 新增平台表,从既有【幂等】bootstrap 原样迁入)**
| 迁移 | 源(现状) | 表 |
|---|---|---|
| `V1__sys_page_schema.sql` | `platform-metadata/.../bootstrap/bootstrap-page-schema.sql` | sys_page_schema |
| `V2__sys_datastatus.sql` | `platform-flow-gateway/.../bootstrap/bootstrap-datastatus.sql` | sys_datastatus(+种子) |
| `V3__sys_ai_agent.sql` | `platform-ai/.../bootstrap/bootstrap-ai-agent.sql` | sys_ai_task/draft/change_set/run/feature_package/revision/audit_log |
| (排除) | `platform-parity/.../bootstrap/*`(对拍测试种子) / `docs/sql/*`(admin 页数据 upsert,评估后单列) / 客户 eip3 schema | — |
**配置(baseline 策略)**:`flyway-core` 加 platform-app;`spring.flyway`:`baseline-on-migrate=true`、`baseline-version=0`(客户库非空→baseline 于 V0=不动既有,再跑 V1+;迁移幂等→既有平台表也安全)、`locations=classpath:db/migration`。**先 gated**:`enabled: ${EIP4_FLYWAY_ENABLED:false}`,dev 验过再开,prod 经 env 显式启用。
**跨模块处理(ai-agent)**:sys_ai_* DDL 由 platform-ai 拥有并被 `AiAgentDdlTest` 测试。`V3` 迁移在 platform-app/db/migration,内容与 platform-ai 副本须一致——A10 W1 落地时二选一:① V3 引用/复制 platform-ai 副本并加防漂移测试;② 用 Flyway `locations` 叠加 `classpath:bootstrap`(但 bootstrap 非 V__ 命名,需重命名)。建议①。
**收敛 spring.sql.init**:W1 验过后,dev/local 的 `spring.sql.init.schema-locations` 改指 `classpath:db/migration/*.sql`(与 Flyway 同源),并删散落 bootstrap → 真单一真相。**收敛前 dev 行为不变**(spring.sql.init 仍跑现有 bootstrap,Flyway gated off,零回归)。
**验证门(接 PG 后)**:dev PG 跑 `flyway migrate`→`info`/`validate` 全绿 → 既有库 baseline 不破坏既有数据 → 回退演练 → 再 prod 开 `EIP4_FLYWAY_ENABLED=true`(W5 准生产)。
## 4. 待拍板决策点
| # | 决策 | 选项 | 建议 |
|---|---|---|---|
| **D1** | 单源托管形态 | (a) 独立 nginx 容器 serve dist+反代 / (b) platform-app Spring 伴服 dist+/api(少一进程) | **(a) nginx**:标准、解耦、支持灰度 upstream 权重(W6 需要);伴服把前端耦进 Java 发布节奏,不利切流。 |
| **D2** | Flyway 范围 | (a) 仅 EIP4 新增平台表 / (b) 含客户库 schema | **(a)**:客户库是既有 eip3 schema,保真层原样消费,EIP4 无权也无需迁移;`baseline-on-migrate` 接管既有库。 |
| **D3** | 是否容器化 | (a) Docker/compose / (b) systemd + 裸 jar(部分私有化客户禁 Docker) | **(a) 为主 + 文档化 (b) 兜底**:compose 标准化交付,同时给「裸 jar + systemd unit」附录供禁 Docker 客户。**需确认客户环境是否允许 Docker**。 |
| **D4** | 密钥/配置管理 | (a) 环境变量/.env / (b) Vault/KMS | **(a) v1**:prod profile 已强制 env 注入、缺失即 fail-fast;Vault 待客户安全要求再上。 |
| **D5** | 灰度/切流机制 | (a) nginx upstream 权重双跑(eip3↔eip4 只读)/ (b) 全量切换 | **(a)**:契合「只读先切流」既定路线 + 已有切流 runbook;可逐页/逐比例放量、秒级回滚。 |
| **D6** | 生产 PG | (a) 复用客户既有 PG / (b) compose 内置 PG | **(a) 生产 / (b) 仅自测演示**:生产 PG 是客户资产,compose 的 pg 仅 demo。 |
## 5. 风险
- **保真层与客户库耦合**:W1 `baseline-on-migrate` 必须在客户库真跑验证,错配会污染客户既有表(W5 准生产演练前置)。
- **冻结的 amis-fork / 端口契约漂移**(8084/8093/8094):nginx 反代须钉死 prod 端口(8084),与 dev(8093)/fivering(8094) 区隔,写进 .env。
- **Flowable 独立进程的事务/状态一致性**:切流灰度下 eip3/eip4 双写工作流状态需隔离(只读切流期 flowable 仅新系统写)。
- **CI 激活依赖 Gitea runner**:W 完成后的回归靠 CI,但 runner 未注册前不自动跑(基建前置)。
## 6. 建议下一步
1. **先拍 D1-D6**(尤其 D3 需问客户环境是否允许 Docker)。
2. 拍板后按 **W1→W2→W3→W4(MVP)** 执行——纯代码/配置,**不卡环境,可 headless 做完 + 单测/compose lint 验证**。
3. **W5/W6** 排进准生产窗口(需真 DB + 客户环境)。
---
*本文为待拍板设计;现状底数见进度总览 §3 A10 / §10.2,切流细节见 `docs/P0-PG升级`、`docs/P3-Flowable升级` runbook。*

View File

@@ -0,0 +1,209 @@
# 审批闭环 — 完整实施计划(2026-06-25)
> 目标:把 EIP4 审批从「单人串行主链路已 live」推进到「动作类型齐全 + 流程可视化 + 流程监控 + 端到端真实流转」的生产可用闭环。
>
> 现状权威依据:`ApprovalController.java`(gateway)/ `FlowController.java`、`CandidateController.java`(flowable-service)/ `FlowableClient.java`(gateway client)/ `ApprovalDrawer.tsx`、`TodoPage.tsx`(web)实读核实;进度矩阵见 `docs/项目进度与路线-总览-2026-06-21.md` §A2/B3/B4。
---
## 0. 现状基线(核实于 2026-06-25)
### ✅ 已实现并 live(WfTemplate 数据驱动审批主链路)
- 动作:`approve`(complete + 回写 SYS_DATASTATUS 3/2)、`reject`(终止 + 回写 4)、`reback`(退回发起 + 回写 5)、`agent`(委托)。
- 界面:`ApprovalDrawer`(只读业务表单 + 流程轨迹时间线 + 动态按钮 + 审批意见);业务表单走统一 sys_page_schema editform 解析;load 脚本保真层执行(4s 超时守护);action servicename 服务器侧按 buttonId 重解析后执行。
- 入口:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮接线(mock e2e 1/1)。
- 提交审批桥:`ProcessCoreServiceBridge`(startWorkflow)已实证起真实 flowable 实例。
### 🟡 引擎/Client 层已具备、仅缺 gateway 动作接线 + UI 按钮(关键发现:比想象中近)
> 这些**不需要动引擎**,引擎与 `FlowableClient` 方法都已存在并测过:
- `FlowableClient.withdraw(pi, comment)` ← flowable-service `POST /api/flow/process/{pi}/withdraw`(发起人撤回)
- `FlowableClient.terminateProcessInstance(pi, comment)` ← `POST /process/{pi}/terminate`(强制结束)
- flowable-service `POST /process/{pi}/suspend` / `/activate`(挂起/激活,client 侧尚无封装方法)
- `FlowableClient.started(...)` ← `GET /process/started`(我发起的流程列表)
- `FlowableClient.deleteHistoricProcessInstance(pi)` ← `POST /process/{pi}/delete-history`
- `trace` / `traceByBusiness`(轨迹)已用于 ApprovalDrawer。
### ❌ 完全缺失
1. 动作类型:**协办/加签 `assist`**、**转阅/抄送 `circulated`** —— `ApprovalController.java:227` 直接 `badRequest`。**会签**(多实例并行 + 结果聚合)无任何处理。
2. **BPMN 流程图查看** —— 现仅文本轨迹,无图形化高亮当前节点。
3. **流程定义 Modeler(B3)** —— 完全未起步。
4. **「我发起的流程」页 / 流程监控页** —— web 无对应 page(仅 `TodoPage`);撤回/结束按钮无 UI。
5. **审批待办组件 B4** —— UI/UE 组件骨架未补完。
### 🔒 外部阻塞(非代码能力问题)
- 客户真实 BPMN 部署:新提交走通用流 `EIP4_DEFAULT_APPROVAL`,无 `form_key` → 降级默认按钮。全数据驱动 + 候选人计算需客户部署真实 BPMN(`form_key` 指 WfTemplate)。dev act 流程库不可达。
- `reject`/`reback`/action-servicename 写流:仅 wired + 单测,未对真实迁移数据跑 mutation(数据安全自限)。
---
## 1. 范围分层与优先级
| 层 | 内容 | 外部依赖 | 工作量 | 价值 |
|----|------|---------|--------|------|
| **P0**(立即可做) | 协办/加签 `assist`、转阅/抄送 `circulated` 动作落地 | 无 | 中 | 高(补齐审批语义完整性) |
| **P1**(接线打磨) | 流程监控按钮(撤回/结束/挂起)接线 + 「我发起的流程」页 | 无 | 小-中 | 高(引擎已就绪,最后一公里) |
| **P1**(可视化) | BPMN 流程图查看(bpmn-js 高亮当前节点) | 无(用已部署 bpmn) | 中 | 高(审批可视化刚需) |
| **P2**(验证闭环) | 真实流转 / 候选人计算 / 写流对真实记录的端到端验收 | **客户 BPMN** | 中 | 高(但卡外部) |
| **P3**(大工程) | 会签(多实例聚合)+ 流程定义 Modeler(B3) | 部分卡 S1 | 大 | 中(按客户诉求排期) |
> 建议交付顺序:**P0 → P1 监控接线 → P1 BPMN 图 → P2(客户 BPMN 到位后)→ P3**。P0/P1 共约 4 个可独立交付的增量,互不阻塞,均不依赖外部。
---
## 2. 分阶段任务
### 阶段 A — 协办/加签 `assist`(P0)
**语义对账(先做,不可跳过)**:核对老系统 `TaskProcessServiceImpl` 中 assist 的真实行为。预期两种之一:
- (a) **加签**:当前任务保留,给目标人新增一个并行/串行待办(`addCandidateUser` 或动态加 task),目标人办完回到原审批人;
- (b) **协办**:把当前任务的 candidate 增加目标人,任一人可办。
> WfTemplate 数据里 assist 仅 2 例 —— **务必先 SQL 取这 2 例的 xml + servicename,确认是 (a) 还是 (b)**,不要凭猜实现。
**改动**:
- flowable-service `FlowController`:新增 `POST /api/flow/tasks/{taskId}/assist`(入参 targetUserId、comment)。用 `TaskService.addCandidateUser` 或 `runtimeService` 动态加签,按语义对账结果实现。CHAR(36) 补白对齐既有 `TrimmingCandidateUsersHandler` 口径。
- `FlowableClient`:加 `assist(taskId, targetUserId, comment)`。
- `ApprovalController.action`:`case "assist"` → 新 `assist(taskId, req)` 方法(替换当前 400)。
- 单测:FlowController assist 1 + ApprovalController dispatch 1。
**验收**:真实/构造任务加签后,目标人 todo 出现该任务;办理后流程状态正确。
**风险**:加签的「办完回到谁」依赖 BPMN 结构;若客户 BPMN 不可达,先用 dev 构造流程验证机制,标注真实流待客户库。
---
### 阶段 B — 转阅/抄送 `circulated`(P0)
**语义对账**:circulated 仅 2 例。老系统转阅通常是**只读知会**(不阻塞流程):给目标人发一条「抄送待阅」记录,目标人可见单据但无审批动作。核实是否落 `act_ru_identitylink`(type=participant)或独立抄送表。
**改动**:
- flowable-service `FlowController`:`POST /api/flow/tasks/{taskId}/circulate`(targetUserIds[]、comment)。实现 = 加 participant identityLink + 写抄送记录(若老系统有抄送表,迁移对齐;否则用 identityLink + 历史评论)。
- `FlowableClient`:`circulate(taskId, targetUserIds, comment)`。
- `ApprovalController.action`:`case "circulated"` → `circulate(...)`。
- 「抄送给我的」列表:复用 `TodoController` 加 `GET /api/tasks/circulated?user=`(查 participant identityLink)。**前端可暂缓**,先保证动作不报 400。
- 单测:circulate 1 + dispatch 1。
**验收**:转阅后目标人能在「抄送给我」看到只读单据;原审批流不受影响继续。
**风险**:抄送列表入口是新页面,P0 只交付动作 + 后端列表端点,前端页面归 B4。
---
### 阶段 C — 流程监控按钮接线(P1)✅ 实施时核实:已完成(无需重做)
> **2026-06-25 实施勘探更正**:本阶段在 06-21 矩阵里被标为「缺监控按钮」,实测**后端 + amis 页全部已存在**(进度文档 framework P2 那批 `57c3412…d218c2b` 已交付,当时计划按旧矩阵误判):
> - `GET /api/workflow/process/started-amis`(我的发起)+ `monitor-amis`(流程监控)列表端点 —— 各被 1 个 `sys_page_schema` 页引用。
> - 我的发起页(`0db4af06…`)含**撤回**按钮 → `POST /api/workflow/process/{pi}/withdraw`(回写 SYS_DATASTATUS=5)。
> - 流程监控页(`9f3b5a8b…`)含**强制结束**按钮 → `/terminate`(回写=6 作废)+ **高级处理脚本** `/advanced-script`(带 RCE 守卫,仅非生产 profile)+ `/delete-history`。
> - 语义正确:发起人撤回自己的、管理员监控结束别人的。
>
> **结论**:阶段 C 无需实现。残留仅 suspend/activate(挂起/激活)未在 gateway 暴露——价值低,暂不做;监控页缺「流程图/轨迹」按钮归入阶段 D。
>
> ~~原计划(引擎 + client 已全有,只缺 gateway 动作端点 + UI)~~ —— 实际 gateway 端点也已就绪。
**改动**:
- `FlowableClient`:补 `suspend(pi)` / `activate(pi)`(其余 withdraw/terminate/started 已有)。
- gateway 新 `ProcessMonitorController`(或并入 ApprovalController):
- `POST /api/process/{pi}/withdraw`(发起人撤回,回写 SYS_DATASTATUS)
- `POST /api/process/{pi}/terminate`(强制结束,超管/管理员权限校验,回写状态)
- `POST /api/process/{pi}/suspend` / `/activate`
- 权限:撤回限发起人本人;结束/挂起限管理员角色(复用 JWT 角色)。
- web 新 `StartedProcessPage.tsx`(「我发起的流程」):列表走 `started`,行内「撤回」按钮 + 流程轨迹抽屉(复用 ApprovalDrawer 只读模式 + historyMeta 端点,已存在)。
- 单测:ProcessMonitorController 4(每动作 1)+ 权限拒绝 1;前端 vitest 列表渲染 1。
**验收**:发起人撤回未审任务 → 状态回写 + todo 消失;管理员强制结束运行流程 → 实例 ended。
**风险**:撤回/结束对真实客户数据是破坏性操作,**只对 dev 构造流程跑实际 mutation**,真实库标注待客户授权。
---
### 阶段 D — BPMN 流程图查看(P1)
**方案**:bpmn-js 前端渲染 + 后端给 XML & 当前活动节点(业界标准,比服务端出图灵活,可高亮 + 缩放)。
**改动**:
- flowable-service:`GET /api/flow/process/{pi}/bpmn-xml` → 用 `RepositoryService.getProcessModel(procDefId)` 返 BPMN XML 字符串;`GET /api/flow/process/{pi}/active-activities` → `runtimeService.getActiveActivityIds(pi)`(高亮用,已有 RuntimeService)。历史流程取 `HistoricActivityInstance` 标记走过的节点。
- `FlowableClient`:`bpmnXml(pi)` / `activeActivities(pi)`。
- gateway:`GET /api/process/{pi}/diagram`(聚合 xml + active + history 节点)。
- web:引入 `bpmn-js`(NavigatedViewer),新 `ProcessDiagram.tsx`,在 ApprovalDrawer 加「流程图」Tab;高亮当前节点(绿)、走过节点(灰)。
- 单测:diagram 端点 2;前端组件渲染 smoke 1。
**验收**:打开任一运行中流程,流程图正确渲染并高亮当前停留节点。
**风险**:迁移的是 activiti5 流程定义,bpmn-js 需 BPMN 2.0 XML;若部分老流程是 activiti5 私有格式,需确认 `getProcessModel` 返的是标准 BPMN 2.0(flowable 部署后通常是)。先用一条已部署流程验证格式兼容性。
---
### 阶段 E — 端到端真实流转验收(P2,卡客户 BPMN)
**前置①(外部)**:客户提供并部署真实 BPMN(form_key 指 WfTemplate)。到位后:
- 真实流转:提交 → 候选人计算(`CandidateController` + `OrgDirectory` 已就绪)→ 多级审批 → approve/reject/reback 实际推进。
- 写流:对**测试租户/沙箱记录**(非生产迁移数据)跑 reject/reback/action-servicename 实际 mutation,验证回写与服务流副作用。
- 候选人对账:用 `CandidateController` 对真实组织库批量核对解析结果(P3 报告口径)。
**验收**:一条客户真实审批流从提交到归档全程在 EIP4 走通,状态/候选人/表单全部正确。
**阻塞**:无客户 BPMN 则只能 dev 构造流程验机制,标注「机制已验,真实流待客户库」。
---
### 阶段 F — 会签 + 流程定义 Modeler(P3,大工程,按客户诉求排期)
- **会签**:BPMN 多实例(multi-instance)任务,多人并行/串行审批,按比例/全票聚合结果。需引擎多实例支持 + 聚合变量 + UI 显示「3/5 已审批」。**先确认客户是否真有会签节点**(WfTemplate action type 分布里无独立会签 type,可能藏在 BPMN 结构,需核实)。
- **流程定义 Modeler(B3)**:bpmn-js + bpmn-js-properties-panel 在线编辑 BPMN,存 flowable 部署。**卡 S1 拍板**(是否自研 vs 用 flowable-modeler 嵌入)。工作量最大,建议独立 design。
---
## 3. 红线与约束(贯穿全程)
1. **不碰 view_template.xml / 153 bespoke**;审批是框架级通用能力。
2. **破坏性引擎动作(撤回/结束/加签/写流)只对 dev 构造数据跑实际 mutation**,真实迁移数据需用户显式授权。
3. **servicename 服务器侧按 buttonId 重解析,不信前端直传**(沿用 `ApprovalController.runActionServiceIfAny` 既有口径,防注入)。
4. **CHAR(36) 补白 / 候选人补白对齐既有 handler**(`TrimmingCandidateUsersHandler`、`EngineContextBinder` 归一化),避免身份不匹配。
5. **不自我批准**:实现后走 `code-reviewer` + 真库/dev e2e 验证,作者与评审分离。
6. e2e 端口坑:五环 jar = 8094(`playwright.fivering.config.ts`),标准 dev = 8093;psql 查业务表设 `PGOPTIONS='-c search_path=eip3'`。
---
## 4. 外部依赖与待拍板
- **【外部】客户真实 BPMN 部署** → 阻塞阶段 E 全部、阶段 A/B 的真实流验证。
- **【S1 拍板】流程定义 Modeler 自研 vs 嵌入 flowable-modeler**(阶段 F)。
- **【待核实】会签是否为客户真实诉求**(数据里无独立 type,先核实再排期)。
---
## 5. 执行进度(2026-06-25/26 本会话,按 P0→P3 顺序)
### 波1 ✅ 已实现 + 对抗审查收口 + 单测绿 + **live 验证通过**:阶段 A(assist 协办)+ 阶段 B(circulated 转阅)
- 语义对账(红线)已做:SQL 取 view_wftemplate 那 2+2 例(全空 servicename)+ 读老 `ProcessCoreServiceImpl.createSubTask/createNewTask` 坐实语义(协办=建独立子任务、转阅=建只读知会任务)。
- 后端 flowable-service `POST /tasks/{id}/assist`+`/circulate`;gateway `FlowableClient.assist/circulate` + `ApprovalController` 分派把 400 改真实;前端 `ApprovalDrawer` 多选人弹窗 `MultiUserForm`。
- **对抗代码审查(code-reviewer)揪出 1 HIGH + 3 MEDIUM,已修**:
- 【HIGH 已修+live证】协办/转阅是独立任务(无 processInstanceId/formKey),审批渲染原取不到 businessKey/formKey → 协办人/转阅人看不到业务单据。修法=`approvalContext` 对独立任务**沿 parentTaskId 回溯父任务**取 businessKey+formKey(兼防 `processInstanceId(null)` 崩 500);circulate/assist 子任务 `setFormKey(父formKey)`。
- 【MEDIUM 已修】assist 补父任务 404 守卫(与 circulate 对称);派发 `MAX_FANOUT=50` 上限;assist/circulate 加 `@Transactional` 整批原子。
- 【LOW】转阅改 `setFormKey` 而非 description(FormKeyResolver 直接命中);javadoc 与实现对齐。
- 单测:flowable-service FlowControllerTest 21 + ProcessDiagramControllerTest 3 全绿;gateway ApprovalControllerActionTest 5 全绿;前端 tsc 干净 + vitest 83/83。
- **live e2e(8089+8093 新 jar,真引擎)**:① POST assist/circulated 各返 `count:1`(不再 400);② 子任务 approval-context **回溯出父流程 businessKey=probe-bk-1 + processInstanceId**(HIGH 修复实证);③ 子任务**进目标用户待办**(assignee 匹配无补白问题,reviewer Open Question 实证排除);④ 测试产物已清理。
### 波2 ✅ 核实即完成:阶段 C(流程监控)
后端 + amis 页早已存在(见上文阶段 C 更正),无需重做。
### 波3 ✅ 已实现 + 单测绿 + **live 验证通过**:阶段 D(BPMN 流程图)
- 后端 flowable-service 新 `ProcessDiagramController` `GET /process/{pi}/diagram`(返 bpmnXml + activeActivityIds + finishedActivityIds,只读,运行/历史双路取 procDefId);gateway `FlowableClient.diagram` + `TodoController GET /api/workflow/process/{pi}/diagram` 转发。
- 前端新 `src/api/diagram.ts` + `src/components/ProcessDiagram.tsx`(bpmn-js NavigatedViewer,中文节点走浏览器字体,当前节点绿/已走过灰高亮);`ApprovalDrawer` 加「查看流程图」按需展开段。bpmn-js 依赖已装,build ✓(5104 模块)。
- 单测 ProcessDiagramControllerTest 3 绿。**live e2e**:真实带 DI 的迁移实例(PI=511732)返 `bpmnXml=7586 chars / 含 BPMNDiagram 布局 / 当前节点 sid-… / 已走过 4 节点` → bpmn-js 可渲染。
### 阶段 E(P2)⏸ 外部阻塞
真实流转/候选人/写流端到端 —— 需客户 BPMN(dev `EIP4_DEFAULT_APPROVAL` 通用流无 form_key)。注:`eip4flow` 库有 1512 流程定义/9441 实例可读,故**只读类**(流程图/轨迹)已能 live;写类真实流转仍待客户 BPMN。
### 阶段 F(P3)— 会签 ✅ 已实现+live;Modeler ⏸ 待 S1
**会签更正(2026-06-26,用户确认是客户真实诉求)**:先前「阻塞/待核实」判断**错误**——会签不是 WfTemplate 的按钮 type,而是 **BPMN 多实例(multiInstance)节点结构**,故按钮 type 分布看不出。核实结果:
- 迁移库 28/1512 流程定义含 `multiInstanceLoopCharacteristics`;其中 **4 个真实业务流程**:安全技术交底(集合 type=`user`)、总包合同交底/招投标工程评审流程/施工技术交底(集合 type=`scriptUser`)。
- **引擎机制本就全在**:flowable 原生多实例(并行任务+`completionCondition` 聚合) + `multiInstanceUsersHandler` bean 已移植并在 `FlowableEngineConfig` 注册 + 每个会签人走现有 `approve`。故 `user` 类型会签早已能跑。**会签从不是外部阻塞**。
- **真正缺口**:`CandidateUsersHandler` 的 **`scriptUser`(JUEL 脚本)候选人解析分支当初故意没移植**("精简边界" WARN 降级,26 处)。3/4 真实会签流程用 scriptUser(`${APPLYUSERS}`) → 办理人解析返空 → 会签节点被跳过(日志实锤 WARN)。
- **已修复**:`CandidateUsersHandler` 实现 scriptUser 分支 = 单变量 `${VAR}` 直读流程变量、复杂表达式回退 flowable 表达式管理器对 execution 求值、结果按 List/数组/逗号分号串/单值归一为去重 userId 列表。单测 8(`CandidateUsersScriptUserTest`);flowable-service 全量 56 绿无回归。
- **live e2e**:起「招投标工程评审流程」(APPLYUSERS=3人) → 会签节点**生成 3 条并行任务**(修复前 0 条被跳过);完成 **1/3 不推进**(剩 2)、完成 **3/3 聚合推进**到下一节点(完成条件 `nrOfCompletedInstances/nrOfInstances==1` 全票);测试实例已清理。
**剩 Modeler ⏸**:流程定义 BPMN 在线 Modeler(B3,自研 vs 嵌入 flowable-modeler)仍卡 S1 拍板。
**会签残留(跟踪项,非阻断)**:① 会签进度显示("已会签 N/M 人")未做,可从多实例执行的 `nrOfInstances/nrOfCompletedInstances` 取,属 UX 增强;② scriptUser 复杂表达式回退依赖命令上下文,已 try/catch 安全降级;③ 真实 APPLYUSERS 由业务表单/前序步骤设置,本次用 start 变量模拟。
### 残留(非阻断,跟踪项)
- 协办/转阅目标用户用文本输入(与现有「转办」DelegateForm 同款),无真实用户存在性校验 → 错填 userId 会建不可见任务。**与现有转办行为一致**,建议后续统一接用户 picker(同时惠及转办)。
- 协办/转阅按钮在 WfTemplate 均无 servicename(已核实),故 `runActionServiceIfAny` 对其为 no-op,安全。
**改动文件**(全部在 flowable-service + platform-flow-gateway + eip4-web,未触及其他模块;platform-report/legacy-core 的失败测试是它处 WIP/JDK 环境问题,与本次无关):
- 后端:`FlowController.java`、`Requests.java`、`ProcessDiagramController.java`(新)、`FlowableClient.java`、`ApprovalController.java`、`GatewayRequests.java`、`TodoController.java` + 3 测试
- 前端:`approval.ts`、`ApprovalDrawer.tsx`、`diagram.ts`(新)、`ProcessDiagram.tsx`(新)、`package.json`(bpmn-js)

View File

@@ -0,0 +1,62 @@
# 报表迁移:JOR(jatools)引擎重宿主到 EIP4 — design + 实施
> 2026-06-25。回答「EIP3 的真报表(JOR 套打)能否迁移」=**能**,PoC 已证(headless 渲染 + 连真库 + 跑报表 SQL,见 `/tmp/eip4-report-poc.html` 与浏览器截图 `在建工程项目收付款信息表`)。本文为把 PoC 变成可用功能的设计与实施。
## 0. 关键结论(PoC 已验)
- EIP3 报表 = `jatools` JOR **套打模板**(633 个 `.xml`,合并单元格/边框/公式列/分组小计/分页/签字栏),引擎是**纯 Java 服务端**,导出 HTML/PDF/XLS/RTF,浏览器显示(H5;旧 ActiveX `.cab` 仅 IE 已死)。
- **不用移植 900 个源文件**:整套**预编译成品**在 `/Users/zhengwr/workspace/eip3/framework/com.dsasp.client.report/lib/`:
`jatools.jar`(引擎) + `bsh2.0.jar`(改造版 BeanShell,含 8 个自定义类) + 全部依赖(`itext.jar`/`jxl.jar`/`jsqlparser.jar`/`jfreechart-1.0.13.jar`+`jcommon`+`chart.jar`/`barcode4j.jar`+`zxing2.1.core.jar`/`commons-*`/`log4j-1.2.8`/`jaxen`/`xercesImpl`/`postgresql.jar`)。授权许可:`jatools.dat`(912B ASCII),预编译 jar 在 server 模式直接跑通(无物理 dongle);生产需确认授权(客户 EIP3 本就在用)。
- **渲染 recipe(已验)**:`ReportDocument.load(xml)` → 设参数 → `jatools.engine.ReportJob.printAsDHTML(imp, writer)`(HTML)/`printAsPDF(os)`/`printAsXLS(ba)`。headless:`-Djava.awt.headless=true`,`java.desktop@21` 在。
## 1. 参数绑定(查询条件,需求①)
EIP3 `ReportExporter` 的真实通道(`jor/jatools/server/ReportExporter.java`):
- 每个请求参数 `job.setParameter(name, value)`;
- `declareExternalVariables(doc, script, params)`:把 params 注入 script,并遍历 `doc.getVariableContext().variables(VariableContext.PARAMETER)`,按 `Parameter.castValue` 类型转换后 `script.set(p.getName(), value)`;
- 报表 SQL 里的 `${PARAM}` 即由这些已声明变量替换(`SqlReader` 检 `sql.indexOf("${")`)。
- 注:`LocalReportJob` 路径**不做** declareExternalVariables(故 PoC 里用 params 传 DBJdbcUrl 无效);**必须走 `ReportJob` 路径**。
- DB 连接:模板 `<Connection>` 用 `${property("DBJdbcUrl")/DBUser/DBPassword}`,`property()=System2.getProperty()=jatools.properties`。EIP4 须在启动时把 `DBJdbcUrl/DBUser/DBPassword` 注入 System2(指向客户库)。
## 2. 目标架构
- **platform-report 模块**:依赖上述预编译 jar。打包进 fat jar 的可靠做法 = `mvn install:install-file` 各 jar 进**项目内本地仓** `platform-report/local-repo/`(随码提交,坐标如 `com.dsasp.thirdparty:jatools:eip3`),pom 加 `<repository>file://.../local-repo</repository>` 正常依赖。**勿用 system scope**(不进 fat jar)。
- **ReportService**(复刻 ReportExporter 核心,去掉 com.dsasp 应用胶水):`render(templateXml, Map<String,String> params, format) → bytes/String`。`ReportJob` + `FileResourceOutputFactory(tmpDir)` + `printAsDHTML/PDF/XLS`。
- **ReportController**:`GET /api/report/{templateId}?format=html|pdf|xls&<查询参数>` → 加载 JOR 模板 → ReportService → `text/html` / `application/pdf` / xls。
- **模板来源**:633 个 `.xml`。v1:配置一个模板根目录(EIP3 report 目录)+ `templateId→xml` 映射;后续:导入 `sys_report_template` 表(随 sys_* 平台表,Flyway 管)。
- **System2 连接注入**:启动时用 EIP4 `spring.datasource` 配置写入 jatools 的 DBJdbcUrl/DBUser/DBPassword(经 System2 的 setProperty 或可解析的 jatools.properties)。
## 3. 前端集成(菜单页,需求②:不是独立 tab)
- type=200 报表页**已是** sys_page_schema 里的菜单功能页(转换器已生成,含查询条件表单——见 `项目安全费用投入明细` 的 amis filter)。
- 改造该页 body:把 amis CRUD 表换成**报表查看器**(amis `iframe`/`html` 组件)指向 `/api/report/{templateId}?{查询表单参数}`;查询表单 onSubmit 刷新 viewer。
- 仍是原菜单页(满足需求②);查询条件表单字段名 = 报表 VariableContext PARAMETER 名(PROJECTID/日期段/…)。
## 4. 分期
- **Phase 1(后端,本批次)**:platform-report 模块 + ReportService + `/api/report` 端点,headless 渲染一张带查询参数的 JOR 模板→HTML/PDF,接进 platform-app,curl 验证返回报表 HTML。
- **Phase 2(前端集成)**:报表页 body 换查看器 + 查询表单喂参数 + 菜单可达,端到端一张报表(对完整客户库出数据)。
- **Phase 3(铺量)**:633 模板导入 `sys_report_template`;type=200 页批量改造;字体保真;PDF/Excel 下载;图表(B 类,jfreechart 已在 lib)。
## 5. 风险
- headless 中文字体保真(版式已通,需装字体)。
- jatools 授权(生产确认;客户已持有)。
- System2 连接为进程级全局(单客户部署 OK;多租户需改造)。
- 模板里 `<Url>reportviewer.jsp?...`(钻取链接)需改写为 EIP4 路由(Phase 3)。
- eip4dev 是**部分** dev 库,缺部分报表源表/视图;数据验收须对**完整客户库**。
## 6. Phase 2/3 实现纪要(2026-06-25,已完成+live验收)
报表页**不再手搭**——由转换器对 type=200 统一生成,且查询条件落在 amis `crud.filter`(实测唯一能让 picker 正常加载选项的上下文;独立 form 里 picker 弹窗恒空)。
- **后端** `GET /api/report/frame/{templateId}`(`ReportController`):回显 amis CRUD 单行信封 `{status:0,data:{items:[{__url}],total:1}}`,`__url`=`/api/report/render/{id}?format=html&<查询参数>`(templateId 路径段 + 参数键值全 UTF-8 URL 编码,防注入)。crud 的 html 列把 `__url` 渲成 `<iframe>`,JOR HTML 独立加载、CSS 隔离保真。
- **转换器** `TemplateToAmisConverter.convertReport` 分流:含 `<reportfile>`(JOR 套打,328/339)→ `convertReportViewer` 产 `page→crud{api:/api/report/frame/{id}, filter:buildSearchFilter(查询条件), columns:[单 html 列 iframe], initFetch:false(有查询条件时等用户「查询」再加载)}`;无 reportfile(9/339,纯数据)→ 保留原数据表降级;2/339 为空 XML 孤儿模板(测试动态报表等),无产物属正常。
- **认证根因修(关键)** `EngineContextBinder`:工程 picker「选不到」的真因**不是**转换器/页面结构,而是**认证 admin 的引擎身份没被识别成超管**——JWT 注入 `CURRENTUSER="ADMIN"`(5 字符),引擎跳过行级数据过滤的判定是 exact `ctx.get(CURRENTUSER).equals(LoggedInUser.ADMIN)`,而该常量是 CHAR(36) 补白的 `"ADMIN"+31 空格`,5 字符 ≠ 36 字符 → admin 被当普通用户走数据权限 → `PM_PROJECT` 无规则 → `PrivilegeException` →「暂无该数据源的查询权限」(无 token 的 curl 走 ADMIN 默认上下文,故误以为后端正常)。修=`bind()` 把系统管理员(userId trim=ADMIN,或 account 精确小写='admin',与全站 `requireAdmin` 同口径,不放宽大小写防变体账号提权)的 CURRENTUSER 归一为引擎规范 36 字符 `LoggedInUser.ADMIN`,引擎识别超管→跳过过滤。各 `requireAdmin` 门控均 `trim().equalsIgnoreCase`,对补白形式同样判真,不破鉴权门。
- **live 验收**(8093 新 jar + 真库 + Playwright):工程 picker 列出全部 1672 工程→选中值落定→「搜索」→ crud 携 `PROJECTID` 调 frame→iframe `src=…?format=html&PROJECTID=…`→渲出 JOR 套打「在建项目收付款信息表」(单位/中标价/合同价/序号/工程名称/累计收款付款…);菜单 tab 内非独立页。339 报表页已批量重转重导 eip3.sys_page_schema(328 viewer 更新 + 9 表格不变)。
- **评审**:独立 code-reviewer + security-reviewer;按建议收口 templateId 路径编码、`/render` 端点 page/perPage 行为保持不变(分流到 frame)、account 判定与 requireAdmin 对齐大小写敏感(防变体账号提权)。
- **已收尾**:headless 中文字体保真(生产镜像装 `fontconfig+fonts-wqy-zenhei+fonts-dejavu-core`,docker 真镜像渲染验证零豆腐块,字体嵌入子集可移植);PDF/Excel 下载入口(查看器 `filter.actions`/`headerToolbar` 加导出按钮 → `/api/report/render?format=pdf|xls`,端点回 `Content-Disposition: attachment`+RFC5987 中文文件名,浏览器+curl 真验下载保真)。
## 7. B 类图表报表 backlog(2026-06-25 验证暂缓,独立小特性)
**验证结论(暂缓,非 jfreechart)**:`ischart=true` 报表仅 **4 张**(项目考勤图表-前十/单个、未签合同率前十、供应商价格分析土建),且**全部 `<reportfile>` 为空** —— EIP3 图表**不是 JOR/jfreechart 套打**(lib 的 jfreechart 只服务于内嵌在 JOR 版式里的图,这 4 张都没有),而是**老客户端从图表数据流画的 ECharts**。
- 图表数据流(如 `GB_ATTENDANCEINFO_PRJCHART`)被分类为**写服务流、GET 被拒**;POST 返结构化图数据 `{PRJNAMELIST:[类目], NOWLIST/COUNTLIST/ALLLIST:[系列], …标量}`(dev 库无源数据 → 全空)。
- 当前转换器把这 4 张走「图表→数据表」降级,crud 指向 `/api/flow/..._PRJCHART` 的 **GET**(被拒)→ 实为一张加载不出数据的破表。
- **faithful 迁移所需(独立特性)**:①能 POST 取数的图表端点;②把流结果映射成 amis `chart`(ECharts option)——但**图表类型/系列映射在老客户端代码里**(模板 XML 只有 `ischart`+`selectservice`+display,无图表定义),且**每张形状不同**,难用一套通用启发式覆盖;③出图保真还须**完整客户库**(dev 缺源数据)。仅 4 张、低优先,需产品定夺图表口径后再做。
- **钻取链接改 EIP4 路由已做**(2026-06-25):JOR 模板 `<Hyperlink><Url>reportviewer.jsp?xmluuid=<目标报表ID>&PARAM=${PARAM}…</Url>` 经 jatools `HtmlExport` 渲成 `<a href='reportviewer.jsp?xmluuid=…' target='_blank'>`(jar 内已确认 `<a href='` 发射);老 jsp 已失效。`ReportService.rewriteDrillLinks`(HTML 输出后处理,仅 HTML 通道)正则 `reportviewer\.jsp\?xmluuid=([^&'"\s<>]+)` → `/api/report/render/$1?format=html`(其余查询参原样保留,目标报表新标签渲出;目标自身钻取链接亦被同一步递归改写)。短路(无 `reportviewer.jsp` 子串原样返回,302/339 报表跳过正则);`replaceAll(Function)` 字面量拼接防 `$/\` 注入。**全 37 张 drill 报表 xmluuid 恒为首参**(评审实证全语料)。坑:钻取行落在报表明细行,eip4dev 缺源数据 → dev 渲不出 drill 链接,**点击直通须完整客户库验**;改写经 6 单测(真发射格式/裸&/多处/短路/null)+ jar 发射证实 + live 正常报表 round-trip 无损。
- **仍剩余**:完整客户库数据对账(eip4dev 部分库,源表/视图缺→渲布局但空数据,非引擎问题)、B 类图表(§7)。

View File

@@ -0,0 +1,134 @@
# 在线流程定义 Modeler — 设计(2026-06-26)
> 在 EIP4 已有 bpmn-js 流程图查看器之上,扩成**可编辑的 BPMN 流程设计器**:老审批流程能在线编辑修改、新审批流程能在线创建,flowable 流程相关特性全支持,叠加 EIP4 专有语义(办理人/会签/表单绑定)。
>
> 经 brainstorming 逐项拍定(本文末「决策记录」)。承接审批闭环:[[2026-06-25-审批闭环-实施计划]]、流程图查看(main `0ee919b`)。
---
## 0. 目标与成功标准(用户拍定)
1. **老流程能正常编辑修改**(改造 eip4flow 里 1512 个真实迁移流程)。
2. **新功能流程能正常创建**(从空白/模板新建并部署)。
3. **功能不缺失**:全 BPMN/flowable 元素可编可配(各类任务/网关/事件/子流程/边界事件/定时器/信号/错误/补偿…)。
4. **支持 flowable 流程特性**:监听器/超时/异步/网关条件/多实例/事件定义等 flowable 扩展属性可编辑。
**v1 边界(不含)**:DMN(决策表)、CMMN(案例管理)、flowable 自带表单设计器(EIP4 表单走 WfTemplate/amis,不需要)。这三者是 flowable 里平级但独立的编辑器,若客户需要 DMN(复杂规则表)属未来另立评估。
---
## 1. 现状基线(已具备,~70% 基础设施)
| 件 | 状态 |
|----|------|
| 部署端点 `POST /api/flow/deploy`(bpmnXml → `createDeployment().addString().deploy()`) | ✅ 已有 |
| 读流程 BPMN `GET /api/flow/process/{pi}/diagram`(含中文 id 净化) | ✅ 已有 |
| `bpmn-js/lib/Modeler`(可编辑版) | ✅ 已在 eip4-web 依赖 |
| 引擎模型表 `act_re_model`(草稿存储) | ✅ 已有 143 行 |
| `bpmn-js-properties-panel` + `@bpmn-io/properties-panel` | ❌ 需 npm 加 |
| activiti/flowable moddle 描述符 | ❌ 需加(保真地基) |
| 无 `ACT_DE_*`(flowable-modeler 设计态表) | — 不依赖;不嵌 flowable-modeler(Angular 栈,off-stack;其底层本就是 bpmn-js) |
---
## 2. 架构与组件
**前端**(eip4-web,新 `ProcessModelerPage` + 路由 `/process-modeler/:modelId?`):
- 用 `bpmn-js/lib/Modeler`(替查看用的 `NavigatedViewer`)+ 完整元素 palette + `bpmn-js-properties-panel`。
- 布局:左画布 / 右属性面板 / 顶栏(保存草稿·发布上线·校验·返回)。
**后端**(flowable-service,新 `ProcessModelController`,复用既有 `RepositoryService`):
- `GET /api/flow/models` 列草稿
- `GET /api/flow/models/{id}` 取草稿 XML(`getModelEditorSource`)
- `POST /api/flow/models` 建草稿(`newModel`+`saveModel`+`addModelEditorSource`)
- `PUT /api/flow/models/{id}` 存草稿
- `POST /api/flow/models/{id}/deploy` 发布(草稿 XML → 复用既有 /deploy 逻辑)
- `GET /api/flow/process/{procDefId}/source` 载入存量流程为新草稿(复用 /diagram 的中文 id 净化)
- gateway(platform-flow-gateway)转发对应 `/api/workflow/models/**`,套 JWT 权限。
**存储**:草稿 = `act_re_model`(flowable 原生);发布 = `act_re_deployment`/`act_re_procdef`(引擎原生版本机制)。
**版本与运行实例**:发布 = 引擎出**新版本**;**运行中实例留在旧版本不受影响**(flowable 原生版本隔离)。v1 **不做实例迁移**(YAGNI;迁移属高级特性,另案)。
---
## 3. 数据流
1. **新建**:空白/模板 → 编辑 → 存草稿(act_re_model)。
2. **改存量**:打开 procDef → `/source` 灌成草稿 → 编辑 → 存草稿。
3. **发布**:草稿 XML → 同人确认弹窗(影响摘要)→ 校验门 → `/deploy` → 新版本。
---
## 4. 属性面板:标准全套 + EIP4 定制叠加
**标准面板**(bpmn-js-properties-panel):出全部 flowable 流程属性——节点名/文档、网关条件、多实例、监听器、超时、异步、事件定义等 → 满足「功能不缺失 / flowable 特性」。
**EIP4 定制控件**(叠加的自定义分组):
1. **办理人**:读节点 `activiti:candidateUsers="${candidateUsersHandler.getCandidateUsers(execution,'<JSON>')}"` → 解析内嵌 JSON → 友好编辑(角色/部门/前序处理人/scriptUser 多项,对齐已移植的 `UserProperty` 结构)→ 回写表达式。**前后端同源复用 CandidateUsersHandler 配置格式**。
2. **会签**:开关 → `multiInstanceLoopCharacteristics`(并行/顺序)+ collection=`${multiInstanceUsersHandler.getUsers(execution,'<JSON>')}` + 完成规则(全票 `nrOfCompletedInstances/nrOfInstances==1` / 过半 / 指定数)。人员来源复用办理人控件。
3. **formKey**:选择器列 `view_wftemplate` → 设 `formKey=view_wftemplate_id`,绑 EIP4 业务表单。
**原生 assignee/candidateUsers 字段不压**(用户拍定):保留显示供调试/高级,加灰字提示「EIP4 引擎以下方办理人控件为准」缓解误填。
---
## 5. moddle 扩展(保真地基)
迁移 BPMN 用 `xmlns:activiti="http://activiti.org/bpmn"` 存扩展。bpmn-js 默认不认 → 重新导出**会丢扩展**(致命)。**提供完整 activiti moddle 描述符**(JSON,声明整个 activiti 命名空间的元素/属性,非最小集),让编辑器读写原样保留 → 既保真零丢失,又使「flowable 扩展全属性可编辑」。activiti 命名空间予以保留(不归一为 flowable,避免引擎侧读取依赖断裂)。
**铁律测试**:载入真实流程 BPMN → 不改 → 导出 → XML 语义 diff **零丢失**(覆盖 activiti 扩展 / 会签 / 办理人表达式)。
---
## 6. 🔴 关键保真细节:id 可逆净化(保流程 key)
`/diagram` 把中文 process id(如「招投标工程评审流程」)净化为 `nXXX` 是给 bpmn-js 渲染用的。若拿净化版去部署,**流程 key 会变成 nXXX,断了与存量实例/引用的连续性**。
**对策**:载入改存量时**记下 id 映射**(原中文 ↔ 安全 ASCII),编辑器用净化版;**发布时逆向还原原始中文 key**(新加节点的 ASCII id 保留)。这样存量流程 key 不变、版本连续。映射随草稿一并存。
---
## 7. 红线 / 权限 / 审计(套「草稿 + 同人确认部署」)
- **部署门限超管**:`POST /models/{id}/deploy` JWT role 校验(控制器层拦),非超管 403。
- **同人确认**:前端发布弹窗显**影响摘要**(流程 key、当前版本号、运行中实例数、改了哪些节点的办理人/会签)→ 确认才部署。
- **校验门**:部署前服务端跑 flowable 部署校验 + EIP4 校验(办理人表达式可解析 / formKey 命中 view_wftemplate / 会签完成条件合法)→ 不过不部署。
- **审计**:每次部署记一条(谁 / 何时 / model→deploymentId / 新版本号)。
- 不分离作者/审批(v1 取舍;作者-审批分离属 v2 增强)。
**错误处理**:草稿损坏/解析失败 → 422 不部署;校验失败 → 返回具体节点错误;权限不足 → 403。
---
## 8. 测试策略
1. **moddle 保真**:载真实流程 → 不改 → 导出 → XML 语义 diff 零丢失(activiti 扩展/会签/办理人表达式)。
2. **控件双向**:办理人 JSON ↔ 表达式、会签完成条件生成、formKey picker。
3. **id 可逆净化**:净化→还原回原 key、新节点 ASCII id 保留、映射稳定。
4. **后端**:model CRUD + deploy(校验门/权限门/审计)单测。
5. **live e2e**:载存量会签流 → 改办理人 → 存草稿 → 发布 → 起实例验新办理人生效;Playwright 走查编辑器渲染(含中文节点名、palette、属性面板)。
---
## 9. 分阶段交付
- **阶段 1**:完整 activiti moddle 保真 + 只读载入存量(编辑器能开真实流程、palette/标准属性可见、不丢扩展)+ 保真零丢失测试。
- **阶段 2**:三 EIP4 定制控件(办理人/会签/formKey)+ 存草稿(act_re_model)+ 控件双向测试。
- **阶段 3**:发布门(校验+超管权限+同人确认+审计)+ id 可逆净化 + 后端 deploy 门测试。
- **阶段 4**:新建流程(空白/模板)+ live e2e(载存量改办理人→发布→起实例验生效)+ Playwright 走查。
每阶段独立可验、可合 main。
---
## 决策记录(brainstorming 2026-06-26)
| # | 决策 | 取定 |
|---|------|------|
| D1 | v1 范围 | **改存量 + 新建**(两者都要) |
| D2 | 部署门 | **草稿 + 同人确认部署**(限超管 + 校验 + 审计;不分离作者/审批) |
| D3 | 草稿存储 | **复用 flowable `act_re_model`**(model→deployment 一条龙) |
| D4 | 属性面板 | **标准全套 + EIP4 定制控件(办理人/会签/formKey)**;原生字段不压(加提示) |
| D5 | 编辑器能力 | **全功能 bpmn-js Modeler + flowable 流程全属性**(功能不缺失、新特性支持) |
| D6 | moddle | **完整 activiti 描述符**(保真零丢失 + 全属性可编辑),保留 activiti 命名空间 |
| D7 | id 处理 | **可逆净化**,发布还原原始中文流程 key |
| D8 | 版本/运行实例 | flowable 原生版本隔离,发新版本,运行中实例留旧版,v1 不做实例迁移 |
| D9 | v1 边界 | **BPMN 流程编辑器**,不含 DMN/CMMN/flowable 表单设计器 |
## 待 plan 阶段细化
- moddle 描述符来源:社区 flowable/activiti moddle vs 自建最小完整描述符(需核 activiti 命名空间实际用到的元素/属性全集)。
- 影响摘要里「改了哪些节点」的 diff 算法(节点级语义 diff)。
- 模板库(新建流程的起步模板:单人审批/多级审批/会签)放哪、几个。
- 草稿权限模型(谁能看/改别人的草稿)。

View File

@@ -0,0 +1,392 @@
# 在线流程 Modeler(B3)实施计划
> **✅ B3 全 17 任务完成并合 main(2026-07-02)**:platform origin/main 阶段1-4 全合、web origin/main 全合;每任务 TDD+对抗评审+修复轮,每阶段出口 live 验收(挡下 3 个单测/评审都没抓到的真 bug:options语义/面板ref/**bpmn-js PascalCase断部署**),末尾双对抗评审(安全+发布链)判定可宣告完成、唯一 Critical(nginx骨架洞)已修。**Modeler 端到端可用**:打开中文key存量流程→改办理人/会签保真读回→存草稿eip4IdMap保全→同人确认发布→部署新版本中文key保住+审计+起实例真userTask+旧实例不动+非admin403。
>
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
>
> 设计权威:`2026-06-26-在线流程Modeler-design.md`(D1-D9 已拍定)。本计划把 design 落成 TDD 任务,
> 每阶段独立可验、可 `--no-ff` 合 main。执行分支:platform `feat/process-modeler` / web `feat/process-modeler`。
**Goal:** 在既有 bpmn-js 流程图查看器之上交付可编辑 BPMN 流程设计器——1512 个存量真实流程可在线改(key 不变),新流程可从空白/模板建并部署,activiti 扩展零丢失。
**Architecture:** 前端 eip4-web 新 `/process-modeler` 页(bpmn-js `lib/Modeler` + 标准属性面板 + EIP4 React 侧栏控件);后端 flowable-service 新 `ProcessModelController`(flowable 原生 Model API 存草稿 act_re_model,id 净化映射存 metaInfo,发布时逆向还原);platform-flow-gateway 转发 `/api/workflow/models/**` 并承担超管门/EIP4 语义校验/部署审计。
**Tech Stack:** bpmn-js 17.11(已装)+ `bpmn-js-properties-panel`/`@bpmn-io/properties-panel`(新增)+ 自建 vendored activiti moddle 描述符;Flowable 6.8.1 RepositoryService Model API;React 18 + 自研 ui/Dialog;vitest + Mockito/MockMvc + Playwright。
---
## §0 事实基线(2026-07-02 勘探,全部核实过)
**语料(本地 eip4 库,5433,search_path=eip3)**:1512 真实 BPMN(act_ge_bytearray)/1503 部署/143 act_re_model。
扩展面实测:**11 个扩展属性**(activiti:formKey 1476docs / candidateUsers 1465 / exclusive 1311 / assignee 27 / collection 28 / elementVariable 24 / candidateGroups 3 / autoStoreVariables 4 / initiator 3 / dueDate 1 + flowable:assignee 3docs)、**5 个扩展元素**(taskListener 159docs / formProperty 6 / value / field / string);命名空间 activiti=1509docs、flowable=3docs。BPMN 特性:userTask 1505 / conditionExpression 297 / exclusiveGateway 276 / parallelGateway 52 / **multiInstance 28(8 个 distinct key,如「总包合同交底」——key 就是中文,D7 id 可逆净化是硬需求;且 moddle-xml 拒绝中文 id=进 moddle 前必须已净化,T1.1 实证)**。activiti:formKey 值=裸 UUID(view_wftemplate_id 本身,无前缀) / boundary·timer·subProcess·error 个位数 / signal·callActivity·serviceTask 零。
**后端**(file:line 均已核实):
- 部署端点已有:`FlowController.deploy` @ flowable-service `api/FlowController.java:81-105`,body=`{name?,bpmnXml}`,`createDeployment().name().addString().deploy()`,**无鉴权无审计**;网关 FlowableClient **未封装 deploy**。
- `ProcessDiagramController.java`:`sanitizeBpmnIds` @ :120 **单向丢映射**(:125 建 map :130 `"n"+hex(hash)`,方法返回即弃);`readProcessModel(procDefId)` @ :172 是 private(`repositoryService.getProcessModel`);**无 public 按 procDefId 取 XML 端点**。ID 重写正则 `ID_ATTR` @ :113-114 覆盖 `id|bpmnElement|sourceRef|targetRef|attachedToRef|processRef|default`。
- Flowable 6.8.1 裸引擎(flowable-service/pom.xml:26,非 starter;flowable5-compatibility 已引)。`RepositoryService` bean @ `config/FlowableEngineConfig.java:73-76`;`databaseSchemaUpdate=false`(:55,红线)。**Model API(newModel/saveModel/addModelEditorSource/getModelEditorSource/createModelQuery)全仓零使用**——本计划首次启用,act_re_model 表已存在(143 行),无需 DDL。
- 网关模式:`FlowableClient`(client/FlowableClient.java,RestClient,baseUrl 默认 :8089,`execute()` @ :299 连接类失败重试→503、4xx/5xx 透传不重试);控制器方法参数注入 `AuthPrincipal`;**超管判定现成**:`EngineContextBinder.isSystemAdmin(AuthPrincipal)` @ platform-auth `security/EngineContextBinder.java:68-76`(userId trim equalsIgnoreCase "ADMIN" 或 account=="admin")。
- flowable-service **无 Spring Security 无 @Profile**,裸 8089 靠网关保护 → 超管门必须落在网关层。
- 审计现状:部署/审批动作无审计表(只有 taskService.addComment + logger);唯一显式审计模型先例=platform-ai `AiAuditEntry`。Flyway 机制已有(platform-app `db/migration/V1-V3`),本计划加 V4。
- 办理人 JSON(`BasePropertiesConverter.java`):`{"items":[{type,content,isCandidate,isSendMail,isSendPhone(,isSendMessage)}]}`;**BPMN 里花括号写全角 `【】`**,handler 运行时 replace 回 `{}`;前缀常量 `CANDIDATESERVICE="${candidateUsersHandler.getCandidateUsers(execution,'"` @ :34、`MULTIINSTANCESERVICE="${multiInstanceUsersHandler.getUsers(execution,'"` @ :35。type 取值:user/depart/position/formSpecifiedDimension/initiator/sameToTask/beforeTaskLeader/beforeTaskDepartManager/scriptUser/projectRoleType。引擎注册 bean 名(FlowableEngineConfig:62-68):`candidateUsersHandler`(TrimmingCandidateUsersHandler)/`multiInstanceUsersHandler`。
- 起实例(e2e 用):`POST /api/flow/process/start` @ FlowController:246(processDefinitionKey→startProcessInstanceByKey)。
- WfTemplate 全量列表端点**不存在**(WfTemplateService 只按单 id 查)→ 需新建 picker 数据源。
- 测试范本:`ProcessDiagramControllerTest`(@Mock RepositoryService + MockMvc standalone + getProcessModel stub 返 ByteArrayInputStream)、`FlowableClientTest`(MockRestServiceServer)、`CandidateUsersHandlerTest`。
**前端**:
- bpmn-js 17.11.1 已装、`lib/Modeler` 可直接 import、CSS 裸路径可行(ProcessDiagram.tsx:4-6 已验证);**需新增 `bpmn-js-properties-panel` + `@bpmn-io/properties-panel`**;Modeler 需补 `bpmn-js/dist/assets/bpmn-font/css/bpmn.css`(palette 图标)。
- 现有 `/modeler` = 实体建模器(占用)→ 新页用 **`/process-modeler`**。
- admin 门=页面组件内 `isAdminProfile(getProfile())` 自查降级(ModelerPage.tsx:21-22 范式);路由注册 App.tsx:41-52;入口挂 DesignCenterPage.tsx:76-91 按钮区 + Topbar.tsx:71-80 admin 图标。
- 弹窗/确认:自研 `ui/Dialog`(Dialog/Drawer)+ `toast()`;选人表单范本 ApprovalDrawer.tsx `MultiUserForm`(:199-261)。
- api 惯例:`src/api/http.ts` axios 单例;流程域走裸 JSON 派(diagram.ts 防御性默认);网关前缀 `/api/workflow/`。
- 测试:vitest(token 用 importOriginal 只 mock getProfile);Playwright 新配一个 config(照 `playwright.fivering.config.ts`:后端 8094、vite 5174、`apiJson`/`adminToken` 辅助复用 five-ring.spec.ts 写法)。
- 生命周期范本 ProcessDiagram.tsx:29-67(alive flag + destroy try/catch);编辑器页布局范本 editor/DesignerPage.tsx。
## §0.5 计划级决策(design「待 plan 细化」四项 + 实现取舍,执行前已定)
| # | 决策 | 取定与理由 |
|---|------|-----------|
| P1 | moddle 描述符来源 | **自建 vendored** `eip4-web/src/modeler/moddle/activiti.json`(完整 activiti 命名空间描述符,以社区 activiti-bpmn-moddle 内容为种子手工审校收录,不引 npm 依赖——供应链可控 + 可扩展 flowable 别名)。**验收=双门**:①语料覆盖测试(§0 的 11 属性+5 元素全部声明)②moddle 层 round-trip 零丢失测试 |
| P2 | 影响摘要 diff | 前端 DOMParser 节点级 diff:按 userTask id 对齐,比较 candidateUsers/assignee/formKey/multiInstance 四类属性变化,列「节点名:改了什么」。不做通用图 diff(YAGNI) |
| P3 | 新建模板库 | 3 个:单人审批/两级审批/会签,静态 BPMN 字符串放 `src/modeler/templates/`。**以真实流程为骨架改造**(从「总包合同交底」等抽形),保证与引擎兼容 |
| P4 | 草稿权限 | v1 整页 admin 门(页面+网关双层),草稿全体 admin 共见,无 per-user 属主(YAGNI,v2 再说) |
| P5 | EIP4 定制控件宿主 | **不写 preact 属性面板分组**,改为**同右栏叠放的 React 侧板**(selection.changed 驱动),放标准面板上方。理由:preact entries 与 React+RTL 测试栈割裂、集成风险高;React 侧板同样满足 D4「标准全套+定制叠加」,且原生字段照旧显示+灰字提示。含通用「activiti 扩展属性」键值编辑器兜底长尾属性(D5 全属性可编辑)+ taskListener 简单编辑(event+class/delegateExpression) |
| P6 | 语料保真扫描 | 全量 1512 流 round-trip 扫描做成**工具脚本**(连库跑,如 parity 模式),不进 CI 硬门;单测用**合成 fixture**(复刻 §0 全扩展面+中文 id+全角【】),不把客户 BPMN 提交进仓 |
---
## 阶段 1:moddle 保真 + 只读载入存量(可独立合 main)
### Task 1.1 前端依赖 + moddle 描述符 + 保真单测 ✅(8fdfe68,2026-07-02)
> 完成实证:panel 5.60.0/3.47.0;12/12+全量 101/101 绿;**三发现已回写本计划**(双包冲突→T1.5 只载 activiti / 嵌套全角【】→T2.3 / formKey=裸 UUID)。遗留:bpmn-moddle 无类型声明(TS7016 编辑器诊断,tsc -b 不受影响)→ T1.5 顺带补 `.d.ts`。
**Files:**
- Modify: `eip4-web/package.json`(+`bpmn-js-properties-panel@^5.23.0` +`@bpmn-io/properties-panel@^3.23.0`;装完看 npm 实际解析版本,只需兼容 bpmn-js 17)
- Create: `eip4-web/src/modeler/moddle/activiti.json`(完整 activiti 描述符:name=Activiti, uri=`http://activiti.org/bpmn`, prefix=activiti;types 覆盖 §0 全部 11 属性(挂 bpmn:UserTask/Process/SequenceFlow 等宿主的 extension attributes)+ taskListener/formProperty/field/string/value 元素;另加 flowable 别名描述符 `flowable.json`(uri=`http://flowable.org/bpmn`,覆盖 flowable:assignee 等 3docs 用到的属性))
- Create: `eip4-web/src/modeler/moddle/fidelity.test.ts`
- Create: `eip4-web/src/modeler/moddle/fixtures/synthetic-full-surface.bpmn.ts`(合成 fixture:中文 process id/name + userTask 带 candidateUsers 全角【】JSON + formKey + exclusive + 多实例(collection/elementVariable/completionCondition) + taskListener(class+field/string/value) + formProperty + boundaryEvent/timer + conditionExpression + BPMNDiagram DI)
**Step 1** 写失败测试(fidelity.test.ts,moddle 层 round-trip):
```ts
import BpmnModdle from 'bpmn-moddle';
import activiti from './activiti.json';
import flowable from './flowable.json';
import { SYNTHETIC_BPMN } from './fixtures/synthetic-full-surface.bpmn';
const CORPUS_ATTRS = ['formKey','candidateUsers','exclusive','assignee','collection',
'elementVariable','candidateGroups','autoStoreVariables','initiator','dueDate'];
const CORPUS_ELEMENTS = ['taskListener','formProperty','value','field','string'];
it('语料覆盖:全部实测 activiti 属性/元素在描述符中有声明', () => {
const declared = JSON.stringify(activiti);
[...CORPUS_ATTRS, ...CORPUS_ELEMENTS].forEach(n =>
expect(declared, `activiti:${n} 未声明`).toContain(`"${n}"`));
});
it('round-trip 零丢失:import→export 后全部 activiti 扩展原样保留', async () => {
const moddle = new BpmnModdle({ activiti, flowable });
const { rootElement } = await moddle.fromXML(SYNTHETIC_BPMN);
const { xml } = await moddle.toXML(rootElement, { format: false });
// 关键断言:每个扩展属性值逐字保留(含全角【】JSON、中文 id)
for (const frag of ['activiti:formKey="view_wftemplate_'
, "candidateUsersHandler.getCandidateUsers(execution,'【"
, 'activiti:taskListener', 'activiti:elementVariable="assignee"'
, 'multiInstanceUsersHandler.getUsers']) {
expect(xml).toContain(frag);
}
});
```
**Step 2** `cd eip4-web && npm install bpmn-js-properties-panel@^5.23.0 @bpmn-io/properties-panel@^3.23.0 && npx vitest run src/modeler` → 期望 FAIL(描述符/fixture 不存在)。
**Step 3** 写 activiti.json/flowable.json 描述符 + 合成 fixture(fixture 的多实例/办理人形态先 `psql` 抽「总包合同交底」BPMN 对照,形态照抄)。
**Step 4** `npx vitest run src/modeler` → PASS;`npx tsc -b` 干净。
**Step 5** commit:`feat(modeler): activiti/flowable moddle 描述符 + 语料覆盖/round-trip 保真测试`
### Task 1.2 全量语料保真扫描脚本(工具,不进 CI)
**Files:** Create: `eip4-web/tools/modeler-fidelity-sweep.mjs`
node 脚本:`pg` 不引依赖——用 `psql` 子进程拉 `translate(encode(bytes_,'base64'),E'\n','')`(同勘探法),逐条 bpmn-moddle round-trip,对比「activiti:*/flowable:* 属性与元素多重集」前后一致(归一化后 diff),输出 `匹配 N/1512 + 差异清单`。跑:`node tools/modeler-fidelity-sweep.mjs`(连 5433/eip4)。
**验收:1512/1512 零丢失**(有差异=描述符缺口,回补 Task 1.1 描述符后重跑)。结果记进 commit message。
commit:`feat(modeler): 全量 1512 真实流程 moddle round-trip 保真扫描工具(实测零丢失)`
### Task 1.3 后端:id 净化抽成可逆 `BpmnIdSanitizer`
> ⚠️ **T1.2 实证预警——hash 碰撞**:现行 `"n"+hex(hashCode&0x7fffffff)` **有碰撞可能**(1445/1512 文档 process id 为中文;同文档内两个原 id 撞哈希→引用错乱)。查看器容忍,但**可逆 restore 要求双射**:`sanitize` 必须检测碰撞并消解(碰撞时追加 `-2`/`-3` 序号),并补「同文档撞哈希仍双射可逆」单测(构造碰撞对或可注入 hash 的测试缝)。
**Files:**
- Create: `flowable-service/src/main/java/com/eip4/flowservice/api/BpmnIdSanitizer.java`
- Modify: `flowable-service/src/main/java/com/eip4/flowservice/api/ProcessDiagramController.java`(sanitizeBpmnIds 委托新类,行为不变)
- Create: `flowable-service/src/test/java/com/eip4/flowservice/api/BpmnIdSanitizerTest.java`
**Step 1** 失败测试(核心断言:可逆):
```java
@Test void 净化后还原_逐字节等于原文() {
String xml = 读fixture(中文id流程含processRef/sourceRef引用);
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
assertThat(r.xml()).doesNotContain("总包合同交底");
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
@Test void 还原只回写映射内id_新增ASCII节点id保留() { ... }
@Test void 合法NCName_id不改写_映射为空() { ... }
```
**Step 2** `mvn -pl flowable-service -am test -Dtest=BpmnIdSanitizerTest` → FAIL。
**Step 3** 实现:搬 ProcessDiagramController :113-150 的 `ID_ATTR` 正则与净化逻辑进 `sanitize`(返回 `record Result(String xml, Map<String,String> idMap)`,idMap=原→净化);`restore(xml, idMap)` 用同一 `ID_ATTR` 正则反向替换(净化→原,仅命中 map 值者)。ProcessDiagramController 原 static 方法改为委托(保持包级可见签名,原单测不动)。
**Step 4** `mvn -pl flowable-service -am test`(含既有 ProcessDiagramControllerTest 回归)→ 全绿。
**Step 5** commit:`refactor(flow): id 净化抽 BpmnIdSanitizer,补可逆 restore(D7 地基)`
### Task 1.4 后端:按 procDefId 取源 XML 端点
**Files:**
- Modify: `flowable-service/.../api/ProcessDiagramController.java`(新增端点,readProcessModel 已在此类)
- Modify: `flowable-service/src/test/java/com/eip4/flowservice/api/ProcessDiagramControllerTest.java`
**Step 1** 失败测试:`GET /api/flow/process-definitions/{procDefId}/source` → `{found:true, bpmnXml:<净化后>, idMap:{原:净}, procDefKey, version}`;procDefId 不存在 → `{found:false}`(200,防御性——网关照 diagram 惯例)。
**Step 3** 实现:`repositoryService.getProcessModel` + `createProcessDefinitionQuery().processDefinitionId(id).singleResult()`(取 key/version)+ `BpmnIdSanitizer.sanitize`,返回 xml 与 idMap。
**Step 4** `mvn -pl flowable-service -am test` 绿。**Step 5** commit:`feat(flow): 按 procDefId 取净化源 XML 端点(含 idMap)`
### Task 1.5 前端:ProcessModelerPage 骨架 + 只读载入存量
**Files:**
- Create: `eip4-web/src/pages/ProcessModelerPage.tsx`、`src/api/processModeler.ts`、`src/pages/ProcessModelerPage.test.tsx`
- Modify: `src/App.tsx`(+route `/process-modeler`)、`src/pages/DesignCenterPage.tsx`(+入口按钮 `dc-process-modeler`「流程设计」)、`src/shell/Topbar.tsx`(admin 图标可选,跟设计中心并排)
**Step 1** 失败测试(照 ModelerPage.test.tsx 范式:importOriginal 保留 isAdminProfile、mock getProfile + api):admin 可见容器 `data-testid="process-modeler-canvas"` 与属性面板容器;非 admin 显示「仅管理员可用」;`?procDefId=` 时调 `fetchProcDefSource` 并 importXML(mock api 返合成 fixture)。
**Step 3** 实现:照 ProcessDiagram.tsx 生命周期(alive flag/destroy)挂 `bpmn-js/lib/Modeler`:
```ts
import Modeler from 'bpmn-js/lib/Modeler';
import { BpmnPropertiesPanelModule, BpmnPropertiesProviderModule } from 'bpmn-js-properties-panel';
import 'bpmn-js/dist/assets/diagram-js.css';
import 'bpmn-js/dist/assets/bpmn-js.css';
import 'bpmn-js/dist/assets/bpmn-font/css/bpmn.css';
import '@bpmn-io/properties-panel/dist/assets/properties-panel.css';
import activitiModdle from '../modeler/moddle/activiti.json';
// (app 代码首次 import json:本 task 顺带在 tsconfig.app.json 开 "resolveJsonModule": true)
const modeler = new Modeler({
container: canvasRef.current,
propertiesPanel: { parent: panelRef.current },
additionalModules: [BpmnPropertiesPanelModule, BpmnPropertiesProviderModule],
// ⚠️ 只载 activiti!T1.1 实证:activiti+flowable 双包同载会因 bpmn:UserTask 同名 extends
// 属性冲突(not allowed without redefines)静默丢弃 userTask。语料 1509/3 两命名空间不混用;
// 单载 activiti 时 flowable 文档经 moddle lax $attrs 零丢失往返。flowable.json 只做隔离单测。
// ⚠️ 同理:只 import 标准 BpmnPropertiesProviderModule,严禁引 Camunda provider——
// 它会把 camunda 描述符注进 moddle,即双包冲突的变体(T1.1 评审 M-3)。
moddleExtensions: { activiti: activitiModdle },
});
```
布局参照 DesignerPage:顶栏(名称/保存草稿·发布·返回,本阶段按钮 disabled 占位)+ 左画布 + 右栏(上=EIP4 侧板占位,下=标准面板)。存量入口:设计中心按钮 → 新页内「打开存量流程」下拉(数据源复用 `GET /api/process-select/options`)。
**Step 4** `npx vitest run` + `npx tsc -b` + `npm run build` 全绿。
**Step 5** commit:`feat(modeler): /process-modeler 页骨架(Modeler+标准属性面板+存量只读载入)`
### Task 1.6 网关:source 转发 + 阶段 1 live 验收
> 🔴 **阶段1 live 验收实证(2026-07-02)——options 语义缺口已修**:`/api/process-select/options` 在合并库返回的 143 选项**全部 source='model',option.id=act_re_model 的 id 非 procDefId**(计划原假设错),打开器按 procDefId 载入恒 found:false。修法=新增 **by-key 取最新版**端点(`GET /api/flow/process-definitions/by-key/{key}/source` + 网关同门转发),前端打开器按 option.source 双参分派(model→?procKey=key / processDefinition→?procDefId=id)。
>
> ⚠️ **T1.4 评审 M-2——中文 procDefId 编码**:真实 procDefId 形如 `总包合同交底:3:<uuid>`(中文+冒号进 path segment)。网关 FlowableClient 转发**必须用 UriComponentsBuilder/uriVariables 正确编码**(禁字符串拼 URL),且测试必须含一个**中文 procDefId 用例**(MockRestServiceServer 断言转发 URL 编码正确);live 验收也必须用中文 key 流程点穿 HTTP 全链。
**Files:**
- Modify: `platform-flow-gateway/.../client/FlowableClient.java`(+`procDefSource(procDefId)`)
- Create: `platform-flow-gateway/.../web/ProcessModelerController.java`(`GET /api/workflow/process-definitions/{id}/source`,**超管门**:`AuthPrincipal` 校验 `EngineContextBinder.isSystemAdmin`,非超管 403——若该方法非 public static,本 task 顺带提升可见性并补一个判定单测)
- Create: `platform-flow-gateway/src/test/.../ProcessModelerControllerTest.java`(admin 200 转发 / 非 admin 403 / flowable 不可达 503——照 FlowableClientTest 的 MockRestServiceServer 模式)
**live 验收(阶段 1 出口)**:`mvn -pl platform-app,flowable-service -am package -DskipTests` → `run-dev.sh both` → 浏览器 admin 登录 → 设计中心「流程设计」→ 打开「总包合同交底」→ palette/标准属性面板可见、中文节点名正常渲染、点 userTask 属性面板出 BPMN 标准属性。截图留档。
commit + `--no-ff` 合 main:`feat(modeler): 阶段1 存量流程只读载入(moddle保真+可逆净化+页面骨架)`
---
## 阶段 2:EIP4 三控件 + 草稿(act_re_model)
### Task 2.1 后端:ProcessModelController(草稿 CRUD + from-procdef)
**Files:**
- Create: `flowable-service/.../api/ProcessModelController.java`(`@RequestMapping("/api/flow")`)
- Create: `flowable-service/src/test/.../ProcessModelControllerTest.java`(@Mock RepositoryService + Model + ModelQuery,MockMvc standalone,照 ProcessDiagramControllerTest)
端点(全裸 JSON,防御性风格同 diagram):
- `GET /models` → `createModelQuery().orderByLastUpdateTime().desc().list()` → `[{id,name,key,lastUpdateTime}]`
- `GET /models/{id}` → model + `new String(getModelEditorSource(id), UTF_8)` → `{found,id,name,key,bpmnXml,metaInfo}`
- `POST /models` body `{name,key,bpmnXml,metaInfo?}` → `newModel()`+`saveModel`+`addModelEditorSource`(XML 先过 BpmnXMLConverter 解析守卫,坏 XML→422)
- `PUT /models/{id}` → 更新 name/editorSource/metaInfo(不存在→404)
- `POST /models/from-procdef` body `{procDefId}` → 读源 XML → `BpmnIdSanitizer.sanitize` → 建 model,**metaInfo=`{"eip4IdMap":{...},"sourceProcDefId":"...","originalKey":"总包合同交底"}`**(jackson 序列化)→ `{modelId}`
TDD 循环同前;测试含:from-procdef 的 metaInfo 落 idMap、坏 XML 422、404。
commit:`feat(flow): 流程草稿 ProcessModelController(act_re_model,Model API 首次启用)`
### Task 2.2 网关:models 全套转发 + wftemplate picker 数据源
> 📌 **T1.6 评审 M-3**:本 task 给 ProcessModelerController 加第二个及以后端点时,先抽 `requireSuperAdmin()` 私有方法(返回 403 ResponseEntity 或 null),所有端点统一过门防漏。
**Files:**
- Modify: `FlowableClient.java`(+models list/get/create/update/fromProcDef 五方法)
- Modify: `ProcessModelerController.java`(+`/api/workflow/models/**` 五端点,全部过超管门)
- Modify: `platform-flow-gateway/.../web/`(新 `GET /api/workflow/wftemplates`:JdbcTemplate `SELECT view_wftemplate_id, ... FROM view_wftemplate`——**实现前先 psql `\d view_wftemplate` 核实名称列**(name 或 xml 内 title,照 WfTemplateService.parse 的取名逻辑),返 `[{id,name}]`)
- Tests:转发/403/wftemplates 列表(mock JdbcTemplate)
commit:`feat(gateway): 流程草稿转发(超管门)+wftemplate picker 数据源`
### Task 2.3 前端:办理人表达式编解码器(纯函数,TDD 核心件)
**Files:** Create: `eip4-web/src/modeler/candidateExpression.ts` + `candidateExpression.test.ts`
**Step 1** 失败测试(真实形态往返):
```ts
// T1.1 psql 实证真实形态:外层对象与 items 内每个对象的花括号**全部**是全角【】,
// 方括号[]半角,XML 属性内引号转义为 &quot;,content 可带 CHAR 尾部补白空格(不可 trim)。
const REAL = `\${candidateUsersHandler.getCandidateUsers(execution,'【"items":[【"type":"user","content":"u1,u2","isCandidate":true,"isSendMail":false,"isSendPhone":false】]】')}`;
it('解析真实表达式(全角【】)', () => {
const r = parseCandidateExpression(REAL);
expect(r!.items[0]).toMatchObject({ type: 'user', content: 'u1,u2', isCandidate: true });
});
it('构建=引擎口径(全角【】+前缀后缀逐字)', () => {
expect(buildCandidateExpression(r.items)).toBe(REAL);
});
it('scriptUser/depart/beforeTaskLeader 各 type 往返不丢字段', ...);
it('multiInstance 前缀变体 multiInstanceUsersHandler.getUsers 同套解析', ...);
it('非法/空表达式返回 null 不抛', ...);
```
> ⚠️ 全角【】的准确包裹形态(`【"items":...】` 还是 `{"items":...}` 外层才转)**以「总包合同交底」真实 BPMN 逐字为准**——写实现前先 psql 抽原文对照,测试 fixture 逐字复制真实片段。
**Step 3** 实现 `parse/build`(前后缀常量逐字对齐 BasePropertiesConverter :34-35;build 输出全角,parse 兼容全角/半角)。
commit:`feat(modeler): 办理人/会签表达式编解码器(与 BasePropertiesConverter 逐字对齐)`
### Task 2.4 前端:EIP4 侧板(办理人/会签/formKey/扩展属性/监听器)
> 🔴 **T2.3 实证——meta 透传是正确性硬要求**:真实表达式外层对象除 items 外还有 5 个业务 meta 字段(messageTemplate/taskSuccessService/isSkipInitiator/isNoUserSkip/isSkipBeforeTask;taskSuccessService 是真实任务后置服务钩子如 PM_CONTRACTUALREGISTER_UPDATEPROJECTSTATUS)。codec 的 parse 已返 `{items,variant,meta}`、build 收 meta 可选参——**侧板写回办理人/会签时必须把 parse 出的 meta 原样传回 build**,否则发布会打掉已部署流程的业务字段。测试必须含「改 items 后 meta 逐字保留」用例。
>
> 📌 **随本 task 顺带收 T1.5 评审遗留**:红线回归测试——ProcessModelerPage 测试断言 `ModelerCtor.mock.calls[0][0].moddleExtensions` 键恰为 `['activiti']` 且 `additionalModules` 长度为 2(防「顺手」加 provider 静默回归)。(canvas ref null 分支已随 dffd1f3 修复,勿重复。)
**Files:**
- Create: `src/modeler/Eip4Panel.tsx`(+`Eip4Panel.test.tsx`)、`src/modeler/useSelectedElement.ts`(订阅 `selection.changed`)
- Modify: `ProcessModelerPage.tsx`(右栏上方挂 Eip4Panel)
控件(全部经 bpmn-js `modeling.updateProperties(element, {...})` 写回,undo/redo 天然生效):
1. **办理人**(userTask 选中时):解析 `activiti:candidateUsers` → items 表格编辑(type 下拉=§0 的 10 种 + content 文本 + isCandidate/三个通知开关)→ build 回写。原生字段照旧显示于标准面板,控件顶部灰字:「EIP4 引擎以本控件为准,下方原生字段仅供高级调试」。
2. **会签**:开关=读写 `loopCharacteristics`(`moddle.create('bpmn:MultiInstanceLoopCharacteristics', {isSequential, collection: MI表达式, elementVariable:'assignee'})` + completionCondition 三预设:全票 `${nrOfCompletedInstances/nrOfInstances==1}`/过半 `>0.5`/指定数 `>=N`;**结构逐字对照真实会签流**);人员来源复用办理人 items 编辑器。
3. **formKey**:下拉(数据源 `GET /api/workflow/wftemplates`)写 `activiti:formKey`。
4. **扩展属性**(兜底 D5):列出 `element.businessObject.$attrs` 里 activiti:/flowable: 长尾键值可增删改。
5. **任务监听器**:读写 `extensionElements` 里 `activiti:taskListener`(event 下拉 create/assignment/complete/all + class/delegateExpression 文本;v1 不做 fields 编辑,原样保留)。
测试:RTL 渲染 + 假 element/modeling(vi.fn 断言 updateProperties 载荷);办理人/会签/formKey 三控件各 set/clear 用例。
commit:`feat(modeler): EIP4 侧板三控件+扩展属性/监听器编辑`
### Task 2.5 前端:存草稿 + 草稿列表打开
> 📌 **T2.2 评审遗留——草稿删除端点**:五端点无 DELETE,POST 重试窗口产生的重复草稿无 API 可清、草稿列表 UX 也需要删除。**本 task 或 T4.1 补**:flowable-service `DELETE /api/flow/models/{id}`(deleteModel)+ 网关同门转发 + 前端草稿列表删除按钮(confirm)。
>
> 📌 **T2.2 实证——wftemplates 名称现实**:view_wftemplate **无名称列**(计划原假设错),网关已按 entityid→sys_entity.name 解析——1016 活动模板仅 339 有中文名,其余下拉显 uuid。**formKey 下拉须加过滤输入框**(1016 项不可裸滚动),无名项显示「<uuid 前 8 位>…(未命名)」。此项归本 task 或 T2.4 收口轮顺带。
**Files:** Modify `processModeler.ts`(saveDraft/createDraft/listModels/getModel/fromProcDef)、`ProcessModelerPage.tsx`(顶栏「保存草稿」`saveXML({format:true})`→PUT;打开器加「草稿」tab);tests。
**阶段 2 live 验收**:打开「总包合同交底」→ from-procdef 建草稿 → 改办理人(加一个 user)→ 保存 → psql 查 `act_re_model` 新行 + `act_ge_bytearray` 编辑源含改动 + metaInfo 含 eip4IdMap → 重开草稿回显正确。
commit + 合 main:`feat(modeler): 阶段2 EIP4 控件+草稿闭环`
---
## 阶段 3:发布门(校验 + 超管 + 同人确认 + 审计 + id 还原)
### Task 3.1 后端:deploy-from-model(id 还原 + 引擎校验门)
> 🔴 **阶段2 live 实证——bpmn-js 输出被严格 XSD 校验拒(已修,且警示 T3.1)**:flowable `convertToBpmnModel(src, validateSchema=true, ...)` 的严格 Xerces XSD 校验**拒绝 bpmn-js saveXML 的默认命名空间输出**(`cvc-complex-type.2.4.a: Invalid content ... {MODEL}Process`),原始带前缀 source 能过。草稿保存已改 validateSchema=false(草稿是半成品,XSD 不适用)+ 字节级 DOCTYPE 守卫保 XXE。**本 task deploy 必须验证同问题**:`createDeployment().addString().deploy()` 也解析 bpmn-js 输出,若 Flowable 部署校验拒默认命名空间/activiti 扩展,需在部署前把 bpmn-js XML 规范化(或确认 deploy 路径不走严格 XSD)——阶段 3 live 必须用「编辑器改过并 saveXML 的真实流程」部署,不能只用原始 source。
> ⚠️ **T1.3 评审 I-2 预警——文本引用**:bpmn-js `saveXML` 会给流节点补 `<bpmn:incoming>/<bpmn:outgoing>` **元素文本**引用(存量 1512 文档 0 命中,但编辑器导出会有),`BpmnIdSanitizer.restore` 只还原**属性位** → 直接部署会落库「属性=中文原 id、文本引用=净化 id」的脏 XML(Flowable 不解析 incoming/outgoing 故功能无害,但再次 from-procdef 重编辑时碰撞序号换位可能指错节点)。**本 task 必须**:restore 前剥除 incoming/outgoing 元素(Flowable 自行从 sequenceFlow 推导)或把文本引用位纳入 restore,二选一并加测试(含「编辑器导出态 XML → 部署 XML 无净化 id 残留」断言)。
**Files:** Modify `ProcessModelController.java` + test。
`POST /models/{id}/deploy`:
1. 读 editorSource + metaInfo.eip4IdMap → `BpmnIdSanitizer.restore`(**存量 key 还原为中文原 key**;无 idMap=新建流程,跳过)。
2. **引擎校验门**:`BpmnXMLConverter.convertToBpmnModel` + `new ProcessValidatorFactory().createDefaultProcessValidator().validate(model)` → 有 error 返回 422 `{errors:[{activityId,problem}]}` 不部署。
3. `createDeployment().name(model.getName()).addString(key+".bpmn20.xml", restoredXml).deploy()` → 查新 procdef → `{deploymentId, processKey, newVersion}`。
4. `GET /models/{id}/impact`:还原后解析 key → `{processKey, currentVersion(latest procdef), runningInstances(runtimeService.createProcessInstanceQuery().processDefinitionKey(key).count())}`。
测试:还原后部署 XML 含原中文 key(捕获 addString 参数断言)、校验失败 422 不调 deploy、impact 计数。
commit:`feat(flow): 草稿发布(id还原+ProcessValidator校验门)+影响摘要端点`
### Task 3.2 网关:EIP4 语义校验 + 部署审计(Flyway V4)
> 📌 **T2.4 评审补充**:语义校验白名单须加两条——①办理人/会签表达式的 `items` **非空**(`items:[]` 的 MI collection 运行期会炸,仅 JSON 可解析+type 白名单不够);②completionCondition 允许「三预设 或 保留的自定义 body」(T2.4 已实现自定义保留态,校验别把存量自定义条件拒了,白名单改为预设正则 ∪ 非空任意表达式加告警)。
**Files:**
- Create: `platform-flow-gateway/.../aggregate/ModelSemanticValidator.java` + test:解析 XML(**照 WfTemplateService.newJdkDbf :116-135 钉 JDK 解析器**,防 xerces 击穿)→ ①每个 `activiti:candidateUsers`/multiInstance collection 的内嵌 JSON 可解析且 items[].type ∈ 白名单 ②`activiti:formKey` 存在于 view_wftemplate(JdbcTemplate exists)③completionCondition 匹配预设白名单正则。返回 `List<String> errors`。
- Create: `platform-app/src/main/resources/db/migration/V4__flow_deploy_audit.sql`(照 V3 风格):`sys_flow_deploy_audit(id bigserial pk, model_id, deployment_id, process_key, new_version int, operator varchar(64), deployed_at timestamp default now())`
- Modify: `ProcessModelerController.java`:deploy 端点=超管门 → ModelSemanticValidator(fail→422 带明细)→ FlowableClient.deployModel → 成功后 JdbcTemplate INSERT 审计行(operator=principal.userId())。
- Tests:语义校验三类各 fail 用例 / 非 admin 403 / 审计行落库断言(mock JdbcTemplate 捕获参数)。
commit:`feat(gateway): 发布语义校验门+sys_flow_deploy_audit 审计(V4)`
> 🔴🔴 **阶段3 live 揪出 CRITICAL——activiti.json 描述符致 bpmn-js Modeler 输出 PascalCase 元素名(部署链断)**:bpmn-js Modeler.saveXML 对 activiti.json `extends` 的 bpmn 类型(Process/UserTask/StartEvent)序列化成大写 `<Process>/<UserTask>/<StartEvent>`(未扩展的 sequenceFlow/endEvent 仍小写)。Flowable 大小写敏感→`<Process>` 不识别→ProcessValidator 报 flowable-process-definition-not-executable,**部署完全断**。「isExecutable 丢失」是此 bug 症状非独立问题。**T1.1/T1.2 moddle round-trip 测试抓不到**(直接 fromXML→toXML 读写同形),只有真 Modeler saveXML+真部署暴露(live 铁证)。修=重构 activiti.json 扩展类型定义让 Modeler 序列化保持小写 BPMN 元素名(moddle extends 惯用法),验收硬门=saveXML 输出小写 userTask/process + 真部署 200 + 起实例生成 userTask。已挂 T3.3 修复轮 + 需前端保真测试升级到「过 bpmn-js Modeler.saveXML 非仅 bpmn-moddle」。
### Task 3.3 前端:同人确认弹窗(影响摘要)+ 发布流
**Files:** Create `src/modeler/PublishConfirm.tsx`(+test)、`src/modeler/diffSummary.ts`(+test,P2 节点级 diff);Modify `ProcessModelerPage.tsx`。
发布点击 → 并发取 impact + 本地 diffSummary(打开时的源 XML vs 当前 saveXML)→ `ui/Dialog`:流程 key/当前版本→新版本/运行中实例数(灰字:留在旧版本不受影响)/「办理人或会签变更节点」清单 → 确认 → deploy → `toast('已发布 vN','ok')`;422 校验失败按节点渲染错误清单。
commit:`feat(modeler): 同人确认发布(影响摘要+节点级diff+校验错误展示)`
**阶段 3 live 验收**:改「总包合同交底」办理人 → 发布 → psql 验 act_re_procdef 新版本 **key_ 仍=总包合同交底**、sys_flow_deploy_audit 有行、旧版本运行实例不受影响;非 admin 用户 curl deploy=403。合 main。
---
## 阶段 4:新建流程 + live e2e + 收尾
### Task 4.1 模板库 + 新建流
**Files:** Create `src/modeler/templates/{blank,single-approval,two-level,cosign}.bpmn.ts` + `NewProcessDialog.tsx`(名称/key/模板选择;key 允许中文——引擎既有事实)+ tests。模板以真实流程结构为骨架(psql 抽形改造),三模板全部先过 Task 1.1 round-trip 测试 + 后端 ProcessValidator 校验。
commit:`feat(modeler): 空白/单人/两级/会签模板新建流程`
### Task 4.2 Playwright live e2e(8094 惯例)
**Files:** Create `eip4-web/playwright.process-modeler.config.ts`(照 fivering:VITE_BACKEND_TARGET=8094、vite 5174、testMatch process-modeler)+ `e2e/process-modeler.spec.ts`。
场景(复用 five-ring 的 apiJson/adminToken/登录块):
1. **改存量全链**:登录 admin → 流程设计 → 打开「总包合同交底」→ 改办理人 content 加用户 → 保存草稿 → 发布(确认弹窗断言含 key/版本/实例数)→ `apiJson POST /api/flow/process/start {processDefinitionKey:'总包合同交底'}` → 取新实例任务 approval-context 断言新办理人生效。
2. **新建全链**:会签模板新建 → formKey 选一个 → 发布 → start → 任务出现。
3. **走查**:中文节点名渲染 / palette 元素齐 / 标准面板 + EIP4 侧板同屏 / 非 admin 页面降级。
跑法(spec 头注释):`java -jar platform-app/target/*.jar --server.port=8094` + flowable 8089 → `npx playwright test -c playwright.process-modeler.config.ts`。
commit:`test(modeler): 流程Modeler live e2e(改存量/新建/走查 3 场景)`
### Task 4.3 收尾:文档回写 + 对抗评审
- 总览 B3 行 🔴→🟢(证据哈希)、A2 行「仅剩」措辞更新、README/设计中心导航登记;本计划顶部加完成横幅。
- **对抗评审**(house 惯例,不可跳):code-reviewer + security-reviewer 双 agent 过 diff(重点:网关超管门绕过面 / restore 正则替换的边界(id 是另一 id 前缀)/ deploy XML 注入面 / 审计字段),揪修后全量 `mvn clean install` + `npm test` + e2e 重跑。
- 合 main + push。
---
## B3 最终发布链对抗评审处置(2026-07-02)
判定「可宣告完成,无 Critical 无阻断」。id 保真闭环三来源自洽+发布错误契约双形状透传扎实。跟进项处置:
- **I-1 formKey 门误拒改存量——语料 dry-run 证伪(无需修)**:全库 803 个 distinct activiti:formKey **全部命中 view_wftemplate(miss=0)**,formKey 门不会误拒任何存量流程。评审担心的静默回归在真实库不成立。
- **I-2 空 content 语义缺口**:已作已知限制记录(见下),v2 精化(content 可能是变量表达式,硬要求非空会误拒,需按 type 分白名单)。
- **M-1**(下游 422 顶层文案 handler 用 message、前端读 msg,per-node 错误仍渲染)/ M-2(by-id 写删侧无 category 守卫,超管门+UI 已兜)/ M-3(writeCosign 重建只保 4 属性,真实会签仅用 handler-collection 模式暴露低)= 低优先清理 backlog。
## B3 最终安全对抗评审(2026-07-02 阶段4)——1 Critical 已修 + A10 生产加固 backlog
- **✅ Critical#1 已修**:`deploy/nginx.conf` 的 `/flowable/` 裸 proxy 到无鉴权 8089 对公网暴露→绕过网关超管门匿名部署/覆盖生产 BPMN。改 `return 404`(前端只走 `/api/workflow/` 网关,不需要直达)。**注:此洞在 A10 部署骨架里、生产未切流,非 B3 运行时可达**;网关侧超管门本身实现严密无绕过面(评审确认)。
- **A10 生产加固 backlog(非 B3 dev 阻塞,超管信任模型内可接受,随 A10 生产化做)**:High#2 部署 BPMN 可含 serviceTask/JUEL 表达式/监听器=引擎内表达式求值面(超管信任内可接受;修 #1 后降为加固项,v2 可加可执行元素白名单);Medium#3 网关→flowable-service 无凭据纯靠网络隔离(加 X-Internal-Auth 共享密钥纵深);Medium#4 审计只覆盖网关 deploy 路径+写失败静默(下沉审计到 flowable-service 实际部署点或加失败告警)。Low#5(无细粒度流程授权=v1有意)/#6(伪造metaInfo不提权=超管本可写任意key)/#7(impact 缺 DOCTYPE 兜底=enableSafeBpmnXml 已挡)/#8(disableSchemaValidation 只跳 XSD 不开 DTD) 均已缓解/可接受。
## 已知限制 / v2 精化点(2026-07-02 阶段4 e2e 发现)
- **会签办理人 content 为空的语义缺口**:ModelSemanticValidator 校验 `items 非空`(数组长度)但不校验 candidate item 的 `content 非空`。会签模板出厂 items=[{type:user,content:""}] 过语义门,但运行期 multiInstanceUsersHandler 解析空 content → MI 跳过 → 流程无任务直接结束。**不硬修**(content 常是 `${APPLYUSERS}` 变量表达式,硬要求非空会误拒合法流程);v2 可考虑「content 空且非变量表达式 → WARNING」。用户新建会签流程须填办理人,否则部署出空转流程。
- **live e2e 非幂等**:发布无运行时下架端点,每跑场景A「总包合同交底」版本 +1(live 验收固有,非 CI 硬门)。
- **非超管 403 e2e 降级**:dev 库无非超管账号,场景C④用无 token(principal==null 走同一 requireSuperAdmin 分支)+admin 对照证门有效;真非超管 token 断言待 dev 库补账号。
## 验收清单(全项打勾才算 B3 完成)
- [ ] 1512 流 moddle round-trip 扫描零丢失(Task 1.2 工具实测)
- [ ] 打开存量中文 key 流程→编辑→发布,act_re_procdef 新版本 key 不变(D7)
- [ ] 办理人/会签/formKey 三控件双向往返与 BasePropertiesConverter 逐字兼容(D4)
- [ ] 发布门:非超管 403 / ProcessValidator+语义校验 422 / 审计行落库(D2)
- [ ] 运行中实例留旧版本(D8,e2e 断言)
- [ ] 新建(空白+3 模板)可部署可起实例(D1)
- [ ] Playwright 3 场景 + 全量单测 + `mvn clean install` + `tsc -b`/`npm run build` 全绿
- [ ] 对抗评审收口,文档回写
## 红线提醒(执行中不可越)
**每阶段合 main 前必须全 reactor `mvn clean install` 真绿**(模块级 `mvn -pl` 跑不到 platform-app 的 ArchitectureRulesTest,阶段2 wftemplates 给 @RestController 注 JdbcTemplate 触棘轮就是模块级漏过、全 reactor 才 catch;且判绿看 `BUILD SUCCESS` 字样,勿信 `| tail` 后的 `$?`=tail 退出码);控制器新增 SQL 一律收口 Service(ArchUnit 棘轮禁 @RestController 直用 JdbcTemplate);**生产 8089 不对外**(T1.6 评审:门在网关的前提=flowable-service 网络隔离,阶段 3 部署门验收清单显式检查,deploy/nginx/compose 不得暴露 8089);flowable `databaseSchemaUpdate=false` 不动(act_re_model 已存在无需 DDL;审计表走 Flyway V4 是平台表非引擎表);保真层 `com.dsasp.*` 不改(BasePropertiesConverter 只读对齐,不重构);XML 解析一律钉 JDK 解析器(xerces 击穿前科);JDK 21;部署门只落网关(flowable-service 裸 8089 无安全栈);每 task TDD、每阶段对抗自查后才合 main。

66
docs/skills/README.md Normal file
View File

@@ -0,0 +1,66 @@
# EIP4 Agent Skills
本目录是 EIP4 给 AI Agent 使用的领域操作规程。目标是让 Codex、Claude Code、Cursor、OpenCode 等 Agent 都按同一套规则操作 EIP4,而不是临时猜接口、猜表结构或直连线上库。
## Skills
| Skill | 用途 |
|---|---|
| `eip4-env-manage` | 环境探测、启动检查、端口和 profile 边界 |
| `eip4-ai-feature-development` | 从自然语言需求生成实体、服务流、页面、菜单和本地 smoke |
| `eip4-release-manage` | 部署包、人审、发布前校验和回滚边界 |
| `eip4-data-modeling` | 建实体/加字段/引用列/主子表(/api/meta/entity) |
| `eip4-page-recipe` | 用 recipe 生成默认页:维护/树/主子表(/api/design/recipe/compile) |
| `eip4-acl-manage` | 菜单/角色/用户组授权(/api/admin/*) |
## 快速接入(一键安装)
用 `eip4 init` 把这些 skills 安装到目标项目,供 Claude Code / Codex / OpenCode 直接读取。skill 示例里的 base URL 会按当前环境自动渲染(不再硬编码 8084/8093):
```bash
# 可选:先登记环境地址(init 会用 current env 渲染示例端口)
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
--name local --base-url http://localhost:8094 --use
# 一键安装 skills + 生成 AGENTS.md
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar init --base-url http://localhost:8094
# 然后在该目录启动你的 agent
cd <project> && claude
```
产出:
- `.claude/skills/<name>/SKILL.md`:Claude Code 原生 skill(自带 frontmatter)。
- `AGENTS.md`:Codex / OpenCode 共用入口,内容受 `EIP4-SKILLS` 标记块管理(块外内容不动,可重复执行)。块内**内嵌每个 skill 的完整正文**,因此 Codex / OpenCode 只读 `AGENTS.md` 即可拿到全部规程,不依赖 `.claude/skills/`。
参数:`--dir` 目标项目根(默认当前目录)、`--base-url` 或 `--env` 指定渲染地址、`--skills-dir` 用本地目录覆盖内置 skills。skills 已随 `platform-cli` jar 一起打包,`init` 默认从 jar 内读取,无需仓库在场。
查看与校验已安装的 skills:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills list
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills check --dir <project>
```
`skills check` 在目标项目缺少任一内置 skill 时退出码非 0,便于在 CI/接入脚本里把关。
## MCP 接入(标准协议)
除 skills + CLI 外,EIP4 还提供 MCP server(`platform-mcp`,stdio),把 `eip4_auto_develop / eip4_list_page_recipes / eip4_validate_page_schema / eip4_list_components / eip4_access_check / eip4_list_entities / eip4_entity_attributes` 暴露为 MCP 工具,让 Agent 用标准协议调用,而不必死记 CLI/REST 用法:
```bash
mvn -pl platform-mcp package
claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url http://localhost:8094
# 或设环境变量 EIP4_BASE_URL;默认 http://localhost:8084
```
工具忠实转发到平台 REST,复用人审红线(产物恒 `READY_FOR_HUMAN_REVIEW`)与 `access-check`;MCP server 应只配本地/开发 baseUrl,不另开权限面。
## 通用原则
1. 优先使用 `platform-cli`,其次使用公开 REST API,最后才考虑人工 SQL。
2. 默认只允许本地开发和测试环境自动执行写操作。
3. 线上环境只能生成部署包和校验证据,不能由 Agent 默认直接写入。
4. 每次自动开发必须保留 request、draft、change-set、apply、smoke、repair、deployment package evidence。
5. 任何失败先回到本地复现和修复,再重新生成部署包。

View File

@@ -0,0 +1,32 @@
# Skill: eip4-acl-manage
## 触发场景
- 给角色授菜单、管理用户组 / 角色成员、查看菜单树。
> 调用方式:经 REST(无对应 CLI 子命令),或经 `platform-mcp`(MCP)。非 local 环境需带 `Authorization: Bearer <token>`,取 token 见 `eip4-env-manage`。
## 菜单
- `GET {{EIP4_BASE_URL}}/api/admin/menu-all` — 管理视角全量菜单树(`roots[]` 两级,含 `templateId`)。
- `GET {{EIP4_BASE_URL}}/api/menu` — 当前用户可见菜单树。
- `GET {{EIP4_BASE_URL}}/api/admin/user/{userId}/menu` — 指定用户可见菜单。
- 菜单写:`POST {{EIP4_BASE_URL}}/api/admin/menus/create`、`/api/admin/menus/{id}/update`、`/api/admin/menus/{id}/delete`。
## 角色授权
- `POST {{EIP4_BASE_URL}}/api/admin/roles/{id}/set-menus`,body `{"menuIds": ["..."]}`(整存差量,空数组=清空)。
- `GET {{EIP4_BASE_URL}}/api/admin/roles/{roleId}/users` — 角色成员。
## 用户 / 用户组
- `GET {{EIP4_BASE_URL}}/api/admin/users?page=1&perPage=20&keyword=` — 用户分页(密码列不下发)。
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/create`,body `{"name","description"}`。
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/update | /delete`。
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-user | /remove-user`(幂等)。
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-role | /remove-role`。
## 红线
- 写操作仅管理员,事务性。
- 授权走「用户组 → 角色 → 菜单」链(`sys_usergrouprole` / `sys_usergroupuser`),不直接给单用户授菜单。

View File

@@ -0,0 +1,113 @@
# Skill: eip4-ai-feature-development
## 触发场景
- 用户描述一个新功能,希望 AI 自动生成。
- 用户要求从 EIP3 模板、实体、服务流或页面定义生成 EIP4 功能。
- 用户要求本地自动开发、自动修复和 smoke。
## 输入要求
最小需求应包含:
- 功能目标
- 功能名称
- 业务表名
- 实体名称
- 页面 templateId
- 菜单名称
- 字段列表
- 页面配方,可省略。默认 `maintenance-crud-v1`;树形维护页使用 `tree-crud-v1`
字段格式:
```text
column:label:type[:length][:required]
```
示例:
```text
NAME:名称:string:100:true
CODE:编码:string:64:true
ENABLED:启用:boolean::false
```
## 推荐命令
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
--base-url {{EIP4_BASE_URL}} \
--objective "新增客户等级维护功能" \
--feature-name "客户等级维护" \
--table-name EIP4AI_CUSTOMER_LEVEL \
--entity-name "客户等级" \
--template-id eip4ai-customer-level \
--menu-name "客户等级维护" \
--field NAME:名称:string:100:true \
--field CODE:编码:string:64:true \
--field ENABLED:启用:boolean::false \
--page-recipe maintenance-crud-v1 \
--max-repair-attempts 2 \
--output target/ai-runs/customer-level.json
```
树形维护页示例:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
--base-url {{EIP4_BASE_URL}} \
--objective "新增组织分类树形维护功能" \
--feature-name "组织分类维护" \
--table-name EIP4AI_ORG_CATEGORY \
--entity-name "组织分类" \
--template-id eip4ai-org-category \
--menu-name "组织分类维护" \
--field NAME:名称:string:100:true \
--field CODE:编码:string:64:true \
--page-recipe tree-crud-v1 \
--max-repair-attempts 2 \
--output target/ai-runs/org-category-tree.json
```
## 通过标准
- `applyStatus` 为 `PASSED`。
- `smokeStatus` 为 `PASSED`。
- 最终状态为 `READY_FOR_HUMAN_REVIEW`。
- 部署包存在且 `requiresHumanApproval=true`。
- 页面 schema 只能使用组件能力表中注册的组件和动作。
- `PAGE_SCHEMA` 草稿必须声明并通过 `page-recipe` 门禁;普通维护页为 `maintenance-crud-v1`,树形维护页为 `tree-crud-v1`。
- `TEST` 草稿必须通过 `smoke-plan` 和 `render-plan`;`renderTests` 是后续 Playwright 渲染验收的输入,需包含 previewUrl、预期组件、列、动作、数据 API 和关键文本。
## 页面 schema 校验
```bash
curl {{EIP4_BASE_URL}}/api/page/schema/components
curl -X POST {{EIP4_BASE_URL}}/api/page/schema/validate \
-H "Content-Type: application/json" \
--data-binary @target/ai-runs/page-schema.json
```
设计器保存 overlay 时也会执行同一套 typed schema 校验;未注册组件或不支持的 `actionType` 会被拒绝。
## AI 工具权限检查
```bash
curl {{EIP4_BASE_URL}}/api/ai/tools
curl {{EIP4_BASE_URL}}/api/ai/employees
curl -X POST {{EIP4_BASE_URL}}/api/ai/tools/access-check \
-H "Content-Type: application/json" \
-d '{"employeeId":"agent-developer","toolName":"local.apply","grantedScopes":["ai:local:apply"],"targetEnv":"local","productionWrite":false}'
```
本地 apply、smoke 等工具只允许本地目标;生产写默认被阻断,线上部署仍走人工发布。
## 失败处理
1. 查看输出 JSON 中的 apply/smoke/repair evidence。
2. 如果自动修复已尝试但失败,基于 evidence 修改本地代码或元数据生成逻辑。
3. 重新运行本地 auto-develop。
4. 不直接连接线上库修复。

View File

@@ -0,0 +1,59 @@
# Skill: eip4-amis-pitfalls
EIP4 前端用 amis(JSON schema 配置 UI)。本 skill 汇集「写 / 改 amis schema 时会撞、且不真渲染就发现不了」的实战坑。**绝大多数页面由转换器 / recipe 编译器生成**,所以多数修复落在生成逻辑(Java),但症状表现为 amis 行为——下面按 amis 概念分组。
## 触发场景
- 生成或手改 amis 页面后:联动失效、选不中、显 id、空列表报错、行内编辑异常。
- 在 DesignerPage overlay 或 recipe 模板里调字段 / 事件 / 列。
- 排查「功能通了但 UI/UE 不对」。
## 铁律(先读这条)
1. **必真渲染实测**:任何 amis 改动都要 vite 反代 + Playwright / 浏览器逐屏看。功能点 e2e(落库 / status)**≠** 视觉 / UE 走查——很多坑只在渲染时暴露。
2. **线上 sdk.js 与 amis-fork 源码已漂移**:以实际加载的 sdk 行为为准,别照搬某版源码 API;直接改 sdk 有全站回归险。
3. **属性别凭记忆**:amis 属性多且迭代快,查官方文档(context7 / amis.io),别幻觉出不存在的属性或事件名。
4. **行为不确定先隔离钉死**:建隔离 `amis.embed` 手写最小 schema 跑真事件,确认机制后再写后端 / 转换器。
5. **校验工具**:`POST {{EIP4_BASE_URL}}/api/page/schema/validate`(不写库);`GET {{EIP4_BASE_URL}}/api/page/schema/components` 查注册组件 / 动作(未注册会被 typed 校验拒)。
## 引用列 / picker / select 联动
- **picker 显名**:用 form `initApi`(**不要** service 包裹,service 破坏 fetch 时序)+ 引用字段返 `{_id, _label}` 对象(自带 label 不依赖二次拉取)。**禁全局递归 schema filter**(崩过)。
- **单选 select 取联动源**:`event.data.selectedItems` 是 **Option 对象,不是数组** → 写 `selectedItems.FIELD`,**别加 `[0]`**(只有多选才是数组)。引用联动 fill 失败,十有八九是这。
- 联动 / 校验动作要锚定 `onEvent.actions[]`。
- CHAR(36) 外键值常带尾空格 → 匹配不上,要 **trim**。
## 树(tree / tree-select / treeGrid)
- **选不中**:>100 节点触发 amis 虚拟列表,`valueSet.has` 走对象身份判断 → 选中 / 高亮失效。设 `virtualThreshold` 关虚拟,或避免一次性渲染大树。
- **点一次发两请求**:别同时写 `onEvent.change` 里 reload **和** `api: node=${tree}` 自动重拉,二者叠加双触发;去掉显式 reload。
- 加节点用弹窗表单(含多必填列),顶级节点省略 parentid;「加子节点」预填父名要 `canAccessSuperData:false` + 显式传 data。
- 树形维护对应实体 type=101 → 用 tree-select + onlyLeaf。
## CRUD 列表 / 空数据
- 列表 data 必须是**数组**;后端空结果 `{result:{}}` 要兜底成 `items:[]`,否则 amis 报红横幅 `data.items 必须是数组`。
- **别直接绑外键 id 当显示列**(会显裸 id):用计算 / columnsql 显示列,或按列名映射目标表取名(如 DEPARTID→SYS_DEPART、ORGID→SYS_ORG)。
- 点整行选中:`checkOnItemClick: true`。
## 行内编辑 / 主子表
- `quickEdit.needConfirm` 必须**显式 `false`**——amis 默认会强注一个 confirm 步骤,不写就每格都要点确认。
- 派生列公式里的 `|` 会破坏表达式切分;深嵌套表达式可能 StackOverflowError,求值要兜底。
- 多行子表用 `${index}` 按行隔离,防字段串台。
## 对话框 / 表单 / 附件
- 🔑 **行级按钮打开的 dialog 表单,会按字段 name 自动回填该行同名字段**:命名冲突会意外带入行数据,起名时留意。
- 附件双态:只读 / 编辑都用 `input-file` + `staticOn: ${__readonly}`(**别**用 each / service 拼),契约字段 `{id, name, value, url, sizeKb}`;保真层大写 `DOCUMENT` 要归一为 amis 小写。
## onEvent 事件挂载
- 要挂事件的工具栏 / 按钮**必须有 id**,否则联动挂不上。
- 区分事件类型(`inited` vs `change`),别一把抓全挂。
- 联动脚本要覆盖**所有**按钮模式(不只 FULL_AUTO,NO_S3 等也要)。
## 红线
- 改 amis 行为前先想清楚改的是「生成逻辑(转换器 / recipe)」还是「单页 overlay」——前者影响全站,必跑回归。
- schema 只能用注册过的组件 / 动作;改动后 `validate` + 真渲染**双验证**再收工。

View File

@@ -0,0 +1,55 @@
# Skill: eip4-data-modeling
## 触发场景
- 用户要新建业务实体(表)、给已有表加字段。
- 需要引用列(外键)、主子表结构。
> 调用方式:经 REST(无对应 CLI 子命令),或经 `platform-mcp`(MCP)。非 local 环境需带 `Authorization: Bearer <token>`,取 token 见 `eip4-env-manage`。
## 端点
建实体:`POST {{EIP4_BASE_URL}}/api/meta/entity`
```json
{
"tablename": "EIP4AI_DEMO",
"name": "演示实体",
"attributes": [
{"column": "TITLE", "display": "标题", "type": "string", "length": 200, "mandatory": true},
{"column": "OWNER", "display": "负责人", "type": "reference", "referenceTable": "SYS_USER"}
],
"tabletype": 0,
"masterTable": "PARENT_TABLE"
}
```
- `tablename` 必须 EIP4 前缀,大写,匹配 `[A-Z][A-Z0-9_]{2,40}`。
- `type`:`string | integer | number | date | datetime | boolean | reference`。
- `reference` 必带 `referenceTable`,自动生成 CHAR(36) 外键列指向目标表。
- `tabletype`:`0`=主表 `1`=子表 `2`=中间表;子表用 `masterTable` 指定主表,自动加 `MASTERID` 回链列。
- 标准列(主键/版本/审计时间/操作人)由引擎自动补齐,**不要手传**。
加字段:`POST {{EIP4_BASE_URL}}/api/meta/entity/{table}/attributes`,body 为 `{"attributes":[...]}`。
- ALTER ADD COLUMN 恒可空(有数据的表加 NOT NULL 会失败)。
查询:
- `GET {{EIP4_BASE_URL}}/api/meta/entities` — 实体目录(引用列目标表选择)。
- `GET {{EIP4_BASE_URL}}/api/meta/entity/{table}` — 单实体属性(columns + displayColumn)。
- `GET {{EIP4_BASE_URL}}/api/meta/entity-types` — 实体分类。
删除:`DELETE {{EIP4_BASE_URL}}/api/meta/entity/{table}`(仅 EIP4 前缀表)。
## 命令示例
```bash
curl -X POST {{EIP4_BASE_URL}}/api/meta/entity \
-H "Content-Type: application/json" \
--data-binary @entity.json
```
## 红线
- 表名必须 EIP4 前缀,DDL 经 CreateTableSqlGuard / AlterTableSqlGuard / DropTableSqlGuard 强制校验。
- 建表/加列/删表只对 EIP4 前缀表;生产表禁碰。
- 不手传标准审计列。

View File

@@ -0,0 +1,64 @@
# Skill: eip4-env-manage
## 触发场景
- 用户要求启动、检查或切换 EIP4 环境。
- 用户要求 Agent 在本地验证功能。
- 用户要求确认当前服务是否可被 AI 自动开发链路使用。
## 操作规则
1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
2. 使用 JDK 21,不能使用 JDK 26。
3. 默认本地 base URL 由 `eip4 init` 渲染,当前环境为 `{{EIP4_BASE_URL}}`;多套环境用 `eip4 env add/use` 管理。
4. 使用 CLI 探测环境:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
--name local \
--base-url {{EIP4_BASE_URL}} \
--kind local \
--use
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status
```
5. 如果服务未启动,优先使用重新打包后的 jar:
```bash
JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests
/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local
```
## 鉴权 / Token
- 非 prod profile(default / local / ci)放行 `/api/**`;本地 `eip4 init` 默认渲染 local,故本地 curl / CLI **无需 token**。
- prod 或开启 JWT 的环境:`/api/**` 需请求头 `Authorization: Bearer <token>`(`/api/auth/**` 例外,登录本身免令牌)。
- 取 token(登录响应顶层字段 `token`=JWT、`expireSeconds`=过期秒数;失败 401 仅含 `success:false` + `msg`):
```bash
TOKEN=$(curl -s -X POST {{EIP4_BASE_URL}}/api/auth/login \
-H "Content-Type: application/json" \
-d '{"account":"admin","password":"111111"}' \
| python3 -c 'import sys,json;print(json.load(sys.stdin)["token"])')
curl {{EIP4_BASE_URL}}/api/meta/entities -H "Authorization: Bearer $TOKEN"
```
> `admin/111111` 为本地 dev 种子账号;按环境替换。
## 禁止事项
- 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。
- 不把线上环境设置为默认写入目标。
- 不跳过 JDK 版本检查。
- 显式选择非当前 env 执行 AI 或发布类命令时,必须要求 `--yes` 或等效人工确认。
## 常用命令
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env list
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env current
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env use --name local
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --all
```

View File

@@ -0,0 +1,48 @@
# Skill: eip4-page-recipe
## 触发场景
- 用户要为某实体生成默认页面(维护 / 树 / 主子表)。
- 需要派生列、父级汇总。
> 调用方式:经 REST(无对应 CLI 子命令),或经 `platform-mcp`(MCP)。非 local 环境需带 `Authorization: Bearer <token>`,取 token 见 `eip4-env-manage`。
## recipe 类型
权威列表以 `GET {{EIP4_BASE_URL}}/api/ai/page-recipes` 为准;当前三种(id 带 `-v1`,须逐字传,端点精确匹配,不接受省略 `-v1` 的别名):
- `maintenance-crud-v1` — 普通维护 CRUD(列表 + 表单)。
- `tree-crud-v1` — 树形维护(有 parentid 的层级表)。
- `master-detail-v1` — 主子表(主表 + 子表行内编辑)。
## 端点
编译生成默认页:`POST {{EIP4_BASE_URL}}/api/design/recipe/compile`
```json
{
"tableName": "EIP4_DEMO",
"title": "演示页面",
"recipe": "maintenance-crud-v1",
"pageSize": 20,
"displayField": "NAME",
"childTable": "DEMO_DETAIL",
"linkColumn": "MASTERID",
"childDerived": [{"column": "AMOUNT", "formula": "QTY*PRICE"}],
"childRollup": [{"masterColumn": "TOTAL", "childColumn": "AMOUNT", "agg": "SUM"}]
}
```
- `childTable` / `linkColumn` 仅 `master-detail-v1` 需要;`childDerived` / `childRollup` 可选。
- 生成流程:读实体属性 → 装配编译 → typed schema 严格校验(不过则 400)→ 落标准层(页面唯一真相)。
- 返回 `data.templateId`。
查可用 recipe(经 AI 链路):`GET {{EIP4_BASE_URL}}/api/ai/page-recipes`。
校验页面 schema(不写库):`POST {{EIP4_BASE_URL}}/api/page/schema/validate`。
组件能力表:`GET {{EIP4_BASE_URL}}/api/page/schema/components`。
## 红线
- schema 只能使用注册过的组件 / 动作;typed 校验会拒未注册组件或不支持的 actionType。
- 生成 = 落标准层;设计器 overlay 在其上叠加,二者共用同一份 typed schema 校验。

View File

@@ -0,0 +1,96 @@
# Skill: eip4-release-manage
## 触发场景
- 用户要求生成部署包。
- 用户要求发布 AI 生成的功能。
- 用户要求线上 bug 修复或回滚。
## 当前边界
当前 `platform-ai` 只生成线上人工部署包,不自动连接线上环境执行写操作。这是设计边界,不是功能缺失。
## 发布前检查
1. 确认本地 auto-develop 已通过。
2. 使用 CLI 生成 AI 功能包快照:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package \
--base-url {{EIP4_BASE_URL}} \
--task-id ait-xxx \
--change-set-id aics-xxx \
--output target/ai-runs/feature-package.json
```
3. 保存里程碑 revision:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai revision \
--base-url {{EIP4_BASE_URL}} \
--task-id ait-xxx \
--package-id aipkg-xxx \
--note "本地门禁通过,待人工部署" \
--output target/ai-runs/revision.json
```
4. 运行离线发布校验:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release verify \
--package-file target/ai-runs/feature-package.json
```
5. 导出 `.eip4pkg.json` 并做导入预览:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release export \
--package-file target/ai-runs/feature-package.json \
--output target/ai-runs/feature-package.eip4pkg.json
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-preview \
--package-file target/ai-runs/feature-package.eip4pkg.json
```
6. 如存在上一版功能包,先做离线差异检查:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release diff \
--left target/ai-runs/feature-package-old.json \
--right target/ai-runs/feature-package.json
```
7. 需要回滚预案时,只生成回滚计划文件:
```bash
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release rollback-plan \
--package-file target/ai-runs/feature-package.eip4pkg.json \
--output target/ai-runs/rollback-plan.json
```
8. 确认部署包包含:
- manifest
- SQL 草案
- rollback SQL
- 本地 apply evidence
- smoke evidence
- repair evidence
9. 确认部署包需要人工审批。
10. 如果包含 `${parentMenuId}` 等占位符,必须人工替换并复核;`release verify` 默认会阻断这类包。
## 线上 bug 修复路径
1. 收集线上错误日志、请求样本或人工复现步骤。
2. 在本地创建新的 AI 修复任务。
3. 本地执行 apply/smoke/repair。
4. 生成新的部署包。
5. 人工审核后走现有上线流程。
## 禁止事项
- 不让 Agent 默认直接写线上数据库。
- 不绕过部署包和人审。
- 不把 smoke 失败的变更包交给发布流程。
- 不发布 `release verify` 失败的功能包。
- 不把 `import-preview` 当成导入或启用;它只是离线检查。
- 不把 `rollback-plan` 当成回滚执行;它只生成计划和 SQL 清单。

129
docs/sql/SYS_AI_AGENT.sql Normal file
View File

@@ -0,0 +1,129 @@
-- ============================================================================
-- 生产建表脚本:SYS_AI_AGENT(AI Agent 运行态平台表)
-- ----------------------------------------------------------------------------
-- 归属:platform-ai(P5 Agent 开发底座)。
-- 契约:/api/ai/tasks、/api/ai/tasks/{taskId}/drafts、change-sets、runs、audit。
--
-- 【Flyway 已落地(A10 W1,2026-06-25)】
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。
-- ✅ 已引入 Flyway。这些表【单一真相】= platform-app/src/main/resources/db/migration/V3__sys_ai_agent.sql
-- (运行态由 Flyway 启动时幂等 migrate;内容与本脚本一致)。本文件保留为人读的生产建表参考。
-- 原 bootstrap-ai-agent.sql 自举副本已删除(收敛入 V3)。
--
-- 边界:这些表只保存 AI 开发运行态和草稿。发布到 SYS_PAGE_SCHEMA / SYS_ENTITY /
-- 服务流等生产元数据必须经过独立人审门禁,不能由 Agent 接口直接落生产。
-- ============================================================================
CREATE TABLE IF NOT EXISTS sys_ai_task (
task_id character varying(64) NOT NULL,
objective text NOT NULL,
status character varying(32) NOT NULL,
plan_json jsonb NOT NULL,
created_at bigint NOT NULL,
updated_at bigint NOT NULL,
CONSTRAINT pk_sys_ai_task PRIMARY KEY (task_id)
);
CREATE TABLE IF NOT EXISTS sys_ai_draft (
draft_id character varying(64) NOT NULL,
task_id character varying(64) NOT NULL,
artifact_type character varying(32) NOT NULL,
target_id character varying(128) NOT NULL,
payload_json jsonb NOT NULL,
gates_json jsonb NOT NULL,
metadata_json jsonb NOT NULL,
created_at bigint NOT NULL,
CONSTRAINT pk_sys_ai_draft PRIMARY KEY (draft_id)
);
CREATE TABLE IF NOT EXISTS sys_ai_change_set (
change_set_id character varying(64) NOT NULL,
task_id character varying(64) NOT NULL,
status character varying(32) NOT NULL,
draft_ids_json jsonb NOT NULL,
summary_json jsonb NOT NULL,
created_at bigint NOT NULL,
CONSTRAINT pk_sys_ai_change_set PRIMARY KEY (change_set_id)
);
CREATE TABLE IF NOT EXISTS sys_ai_run (
run_id character varying(64) NOT NULL,
task_id character varying(64) NOT NULL,
change_set_id character varying(64) NOT NULL,
run_type character varying(32) NOT NULL,
status character varying(32) NOT NULL,
payload_json jsonb NOT NULL,
created_at bigint NOT NULL,
CONSTRAINT pk_sys_ai_run PRIMARY KEY (run_id)
);
CREATE TABLE IF NOT EXISTS sys_ai_feature_package (
package_id character varying(64) NOT NULL,
task_id character varying(64) NOT NULL,
change_set_id character varying(64) NOT NULL,
status character varying(32) NOT NULL,
manifest_json jsonb NOT NULL,
deployment_package_json jsonb NOT NULL,
created_at bigint NOT NULL,
CONSTRAINT pk_sys_ai_feature_package PRIMARY KEY (package_id)
);
CREATE TABLE IF NOT EXISTS sys_ai_revision (
revision_id character varying(64) NOT NULL,
task_id character varying(64) NOT NULL,
package_id character varying(64) NOT NULL,
status character varying(32) NOT NULL,
note text NOT NULL,
snapshot_json jsonb NOT NULL,
created_at bigint NOT NULL,
CONSTRAINT pk_sys_ai_revision PRIMARY KEY (revision_id)
);
CREATE TABLE IF NOT EXISTS sys_ai_audit_log (
audit_id character varying(64) NOT NULL,
task_id character varying(64) NOT NULL,
action character varying(96) NOT NULL,
actor character varying(64) NOT NULL,
details_json jsonb NOT NULL,
created_at bigint NOT NULL,
CONSTRAINT pk_sys_ai_audit_log PRIMARY KEY (audit_id)
);
CREATE INDEX IF NOT EXISTS idx_sys_ai_draft_task ON sys_ai_draft (task_id, created_at);
CREATE INDEX IF NOT EXISTS idx_sys_ai_change_set_task ON sys_ai_change_set (task_id, created_at);
CREATE INDEX IF NOT EXISTS idx_sys_ai_run_task ON sys_ai_run (task_id, created_at);
CREATE INDEX IF NOT EXISTS idx_sys_ai_run_change_set ON sys_ai_run (change_set_id, created_at);
CREATE INDEX IF NOT EXISTS idx_sys_ai_feature_package_task ON sys_ai_feature_package (task_id, created_at);
CREATE INDEX IF NOT EXISTS idx_sys_ai_revision_task ON sys_ai_revision (task_id, created_at);
CREATE INDEX IF NOT EXISTS idx_sys_ai_audit_log_task ON sys_ai_audit_log (task_id, created_at);
COMMENT ON TABLE sys_ai_task IS 'AI Agent 开发任务。只描述需求、状态和计划,不代表已发布功能';
COMMENT ON TABLE sys_ai_draft IS 'AI Agent 草稿产物。payload_json 保存实体/页面/服务流/代码等草稿';
COMMENT ON TABLE sys_ai_change_set IS 'AI Agent 待人审变更包。通过门禁后供人工确认和发布';
COMMENT ON TABLE sys_ai_run IS 'AI Agent 本地执行证据。保存 smoke/local-apply 的结构化结果';
COMMENT ON TABLE sys_ai_feature_package IS 'AI Agent 功能包快照。封装部署包、manifest 和本地证据,用于人审/导出/版本里程碑';
COMMENT ON TABLE sys_ai_revision IS 'AI Agent 里程碑版本。保存功能包快照,后续用于差异比较和回滚';
COMMENT ON TABLE sys_ai_audit_log IS 'AI Agent 操作审计日志';
COMMENT ON COLUMN sys_ai_task.task_id IS 'Agent 任务 id';
COMMENT ON COLUMN sys_ai_task.objective IS '用户目标或需求描述';
COMMENT ON COLUMN sys_ai_task.status IS '任务状态,例如 DRAFTING / READY_FOR_REVIEW';
COMMENT ON COLUMN sys_ai_task.plan_json IS 'Agent 计划步骤 JSON';
COMMENT ON COLUMN sys_ai_task.created_at IS '创建时间 epoch 毫秒';
COMMENT ON COLUMN sys_ai_task.updated_at IS '更新时间 epoch 毫秒';
COMMENT ON COLUMN sys_ai_draft.artifact_type IS '草稿类型:ENTITY / PAGE_SCHEMA / SERVICEFLOW / MENU / CODE / TEST';
COMMENT ON COLUMN sys_ai_draft.target_id IS '目标标识,例如实体编码、templateId、服务流 id 或文件路径';
COMMENT ON COLUMN sys_ai_draft.payload_json IS '草稿内容 JSON';
COMMENT ON COLUMN sys_ai_draft.gates_json IS '草稿门禁结果 JSON';
COMMENT ON COLUMN sys_ai_draft.metadata_json IS '来源、上下文、生成参数等附加信息';
COMMENT ON COLUMN sys_ai_change_set.draft_ids_json IS '纳入变更包的 draft_id 列表';
COMMENT ON COLUMN sys_ai_change_set.summary_json IS '变更摘要、风险、人审要求和回滚提示';
COMMENT ON COLUMN sys_ai_run.run_type IS '执行类型:SMOKE / LOCAL_APPLY / AUTO_DEVELOP / REPAIR_PLAN / REPAIR_EXECUTION';
COMMENT ON COLUMN sys_ai_run.status IS '执行状态:PASSED / FAILED / APPLY_FAILED / SMOKE_FAILED 等';
COMMENT ON COLUMN sys_ai_run.payload_json IS '执行结果 JSON,包含逐条 smoke 或 apply step 详情';
COMMENT ON COLUMN sys_ai_feature_package.manifest_json IS '功能包 manifest,包含包 id、变更包 id、证据数量和发布边界';
COMMENT ON COLUMN sys_ai_feature_package.deployment_package_json IS '部署包完整 JSON 快照';
COMMENT ON COLUMN sys_ai_revision.snapshot_json IS '里程碑快照 JSON,当前保存 AiFeaturePackage';
COMMENT ON COLUMN sys_ai_audit_log.details_json IS '操作详情 JSON';

View File

@@ -4,12 +4,11 @@
-- 归属:platform-metadata(页面 schema 服务化,P4-4)。 -- 归属:platform-metadata(页面 schema 服务化,P4-4)。
-- 契约:GET /api/page/schema/{templateId} 的下发数据源。 -- 契约:GET /api/page/schema/{templateId} 的下发数据源。
-- --
-- 【Flyway 待办(P5)】 -- 【Flyway 已落地(A10 W1,2026-06-25)】
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。 -- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。
-- 本工程当前未引入 Flyway。本脚本即「生产建表脚本」,P5 引入 Flyway 时 -- ✅ 已引入 Flyway。本表【单一真相】= platform-app/src/main/resources/db/migration/V1__sys_page_schema.sql
-- 原样改名为 V{n}__create_sys_page_schema.sql 纳入 src/main/resources/db/migration 即可 -- (运行态由 Flyway 启动时幂等 migrate;内容与本脚本一致)。本文件保留为人读的生产建表参考。
-- (内容无需改动,故此处保持 Flyway 友好:单条幂等 DDL,无数据)。 -- 原 bootstrap-page-schema.sql 自举副本已删除(收敛入 V1)。
-- 本地 / CI 自举副本见 platform-metadata/src/main/resources/bootstrap/bootstrap-page-schema.sql。
-- --
-- 初始数据导入(1489 个转换产物)由 SchemaImportCli 批量入库,不在本 DDL 内。 -- 初始数据导入(1489 个转换产物)由 SchemaImportCli 批量入库,不在本 DDL 内。
-- ============================================================================ -- ============================================================================

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:onEvent seq 映射已修复上线,计划执行完毕。可后续 `git mv` 入 `docs/归档/`。
# onEvent 脚本挂回修复(按钮联动 / 表单只读联动)Implementation Plan # onEvent 脚本挂回修复(按钮联动 / 表单只读联动)Implementation Plan
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. > **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:processCoreService 桥接 bean 已端到端实证落地。可后续 `git mv` 入 `docs/归档/`。
# 提交审批端到端 — processCoreService 桥接 bean 设计(MVP) # 提交审批端到端 — processCoreService 桥接 bean 设计(MVP)
> 日期:2026-06-14 > 日期:2026-06-14

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:新闻管理切片已修复上线 + live 验收。可后续 `git mv` 入 `docs/归档/`。
# 新闻管理 功能垂直切片 全 parity Implementation Plan # 新闻管理 功能垂直切片 全 parity Implementation Plan
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans / superpowers:subagent-driven-development 逐任务实施。每条修复 TDD + 浏览器端到端对老系统验收,修完作为其余 ~150 功能的模板再泛化。 > **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans / superpowers:subagent-driven-development 逐任务实施。每条修复 TDD + 浏览器端到端对老系统验收,修完作为其余 ~150 功能的模板再泛化。
@@ -48,7 +50,7 @@
## WS-B:onEvent 脚本挂回(按钮联动 / 表单只读联动) ## WS-B:onEvent 脚本挂回(按钮联动 / 表单只读联动)
> P0(rewritten-root 路径)已修并提交 `7b76dce`。本 WS 修 P0+(seq 映射/覆盖/事件类型/组件)。**完整 TDD 细化见原稿** `docs/plans/2026-06-14-onEvent脚本挂回修复-plan.md`(Phase 0 Spike→Phase 4 验收),此处仅列要点,实施以原稿为准。 > P0(rewritten-root 路径)已修并提交 `7b76dce`。本 WS 修 P0+(seq 映射/覆盖/事件类型/组件)。**完整 TDD 细化见原稿** `docs/归档/2026-06-14-onEvent脚本挂回修复-plan.md`(Phase 0 Spike→Phase 4 验收),此处仅列要点,实施以原稿为准。
**根因:** `TemplateToAmisConverter.attachScriptOnEvent`:1644 只挂 `full_auto_index.json` 的 FULL_AUTO 脚本(漏 NO_S3 的「按钮状态控制」onselectedscript),且每段同挂 inited+change 不分事件/组件;工具栏按钮无 `id` 致 enableButton 指令定位不到。影响 930 onselected/422 onload/259 enableButton 模板。 **根因:** `TemplateToAmisConverter.attachScriptOnEvent`:1644 只挂 `full_auto_index.json` 的 FULL_AUTO 脚本(漏 NO_S3 的「按钮状态控制」onselectedscript),且每段同挂 inited+change 不分事件/组件;工具栏按钮无 `id` 致 enableButton 指令定位不到。影响 930 onselected/422 onload/259 enableButton 模板。

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:菜单树模式 + 字段级树选择框已修复 live 验收。可后续 `git mv` 入 `docs/归档/`。
# 菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划 # 菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划
日期:2026-06-15 日期:2026-06-15

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:Phase 0-4 全部实现 + live 验收。仍可作 WfTemplate 驱动审批机制参考;可后续 `git mv` 入 `docs/归档/`。
# WfTemplate 驱动审批界面 — 完整实现方案 # WfTemplate 驱动审批界面 — 完整实现方案
日期:2026-06-16 日期:2026-06-16

File diff suppressed because it is too large Load Diff

View File

@@ -1,3 +1,5 @@
> 📦 **归档候选(2026-06-21)**:M0 一次性本地压测基线(被 `M0交付/M0剩余项状态登记` 引用,物理归档前先改该引用)。
# C3 压测基线 v1(M0 交付物) # C3 压测基线 v1(M0 交付物)
> 版本 v1.0(2026-06-10)| 工具:`eip4-platform/tools/loadtest/load_p95.py`(零依赖,可复跑) > 版本 v1.0(2026-06-10)| 工具:`eip4-platform/tools/loadtest/load_p95.py`(零依赖,可复跑)

View File

@@ -1,3 +1,5 @@
> 📦 **归档候选(2026-06-21)**:M0-C5 一次性 amis fork 构建预演(被 `M0交付/M0剩余项状态登记` 引用,物理归档前先改该引用)。
# C5 任务:amis 6.13.0 Fork 构建预演报告 # C5 任务:amis 6.13.0 Fork 构建预演报告
**任务编号**:EIP4 M0 – C5 **任务编号**:EIP4 M0 – C5

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:单次 CRUD QA dogfooding 清单,多数缺口已处理(对齐 `2ecda94`)。注:被 `通用模板全类型可用性…06-16` 引用,物理归档前先改该引用。
# CRUD 全面 QA 发现与剩余问题清单(2026-06-14) # CRUD 全面 QA 发现与剩余问题清单(2026-06-14)
> 来源:本会话 dogfooding + 2 个并行只读巡检 agent(25 业务实体读 / 1241 编辑表单)+ 写流 QA(18 个 _ADD)+ playwright 浏览器抽验。 > 来源:本会话 dogfooding + 2 个并行只读巡检 agent(25 业务实体读 / 1241 编辑表单)+ 写流 QA(18 个 _ADD)+ playwright 浏览器抽验。

View File

@@ -1,3 +1,5 @@
> ⚠️ **已被取代(2026-06-21)**:本文口径停在 06-17。最新进度权威见 [项目进度与路线-总览-2026-06-21.md](项目进度与路线-总览-2026-06-21.md)。本文保留作历史快照,勿据以判进度。
# EIP3 → EIP4 迁移:项目进度与路线总览 # EIP3 → EIP4 迁移:项目进度与路线总览
> 维护日期:2026-06-17 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新功能)。 > 维护日期:2026-06-17 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新功能)。
@@ -33,7 +35,7 @@
|---|---|---|---| |---|---|---|---|
| **A0** | **通用模板 1363** | 🟢 基本可用;残余:少数列表缺 EDITFORM 降级、引用列、type6 组合前端 tabs、日历 type5 收尾 | 中(收口) | | **A0** | **通用模板 1363** | 🟢 基本可用;残余:少数列表缺 EDITFORM 降级、引用列、type6 组合前端 tabs、日历 type5 收尾 | 中(收口) |
| **A1** | **153 定制视图**=framework 47 + 业务 106 | 🔴 只用户管理 done;framework 有 backlog+机制①骨架;业务 106(源码在 `EIP-3.0` 仓 3.1G)基本没动 | **最大块** | | **A1** | **153 定制视图**=framework 47 + 业务 106 | 🔴 只用户管理 done;framework 有 backlog+机制①骨架;业务 106(源码在 `EIP-3.0` 仓 3.1G)基本没动 | **最大块** |
| A1↳ | picker 全家(用户选择框×4 / 流程选择框) | 🔴 keystone,审批/表单/短消息全链路依赖 | 中 | | A1↳ | picker 全家(用户选择框×4 / 流程选择框) | 🟡 用户选择框×4 + 流程选择框均已接线并页面烟测;仍待业务保存/权限差异验收,审批/表单/短消息全链路依赖 | 中 |
| A1↳ | 可视化设计器 / 代码编辑器(功能·视图管理、服务流、自动编号、定时任务) | 🔴 重度视图必需 → **与 B1 同根** | 大 | | A1↳ | 可视化设计器 / 代码编辑器(功能·视图管理、服务流、自动编号、定时任务) | 🔴 重度视图必需 → **与 B1 同根** | 大 |
| **A2** | **流程审批优化** | 🟡 引擎/抽屉/轨迹/WfTemplate/写桥已建;缺:列表入口按钮接线、BPMN 流程图、流程定义(Modeler)、流程监控按钮(撤回/结束/高级处理)、客户 BPMN 部署=前置① | 中 | | **A2** | **流程审批优化** | 🟡 引擎/抽屉/轨迹/WfTemplate/写桥已建;缺:列表入口按钮接线、BPMN 流程图、流程定义(Modeler)、流程监控按钮(撤回/结束/高级处理)、客户 BPMN 部署=前置① | 中 |
| **A3** | **报表系统**(339 个) | 🟠 转换器产基本列表;套打(JOR 版式)/图表/打印/报表菜单树路由 降级或未做 → 需报表渲染能力 | 大(独立立项) | | **A3** | **报表系统**(339 个) | 🟠 转换器产基本列表;套打(JOR 版式)/图表/打印/报表菜单树路由 降级或未做 → 需报表渲染能力 | 大(独立立项) |

86
docs/新人上手.md Normal file
View File

@@ -0,0 +1,86 @@
# 新人上手 — 第一天路径
> 目标:半天内从零到「本地起全栈 + 登录看到真实页面 + 全量测试绿」。
> 遇到与本文不符的情况,以 `README.md`(仓根)+ `docs/架构设计.md` 为准并回改本文。
## 0. 前置软件
| 软件 | 版本 | 说明 |
|---|---|---|
| JDK | **21(硬性,严禁 26)** | `brew install openjdk@21`。保真层 Groovy 4.0.27 不认 JDK 26 字节码,服务流会批量 500(`scripts/run-dev.sh` 有守卫,详见仓根 README) |
| Node | 22+ | 前端 Vite + amis 本地 SDK |
| PostgreSQL | 15 | 本地 `localhost:5433`(惯例 `PGDATA=~/eip4-pgdata`,非 brew 默认);psql 查业务表先 `set search_path=eip3` |
| Maven | 3.9+ | 模块化构建注意:`mvn -pl <模块>` **必须加 `-am`** |
## 1. 取码
> ⚠️ **托管现状**:三仓目前在项目负责人的**私人 Git 托管**,**非团队基础设施**。
> 团队接手前需二选一:迁移到团队代码托管(届时本节地址与 CONTRIBUTING 的 CI 段随之更新),
> 或由仓主开通协作者账号。CI runner 也应部署在团队侧而非个人机器。
取码地址与账号**向项目负责人索取**(当前为私有 Gitea,SSH 走非标准端口,需在 `~/.ssh/config` 为该 Host 配 `Port`)。
clone 三个仓到同一父目录(前后端脚本按兄弟目录相互引用):
```bash
git clone <GIT_HOST>:<OWNER>/eip4-platform.git
git clone <GIT_HOST>:<OWNER>/eip4-web.git
git clone <GIT_HOST>:<OWNER>/amis-fork.git # 渲染 SDK 源,日常开发只读,可后取
```
## 2. 后端:构建 + 开发库 + 起服务
```bash
cd eip4-platform
mvn clean install # 全 reactor 构建+单测(首次较久);绿=环境 OK 第一证
bash tools/local-devdb/build_devdb.sh --drop-target
# 构建日常开发库 eip4dev(约 6 分钟,需内网可达客户库副本 192.168.20.68:5435)
mvn -pl platform-app,flowable-service -am package -DskipTests # 出可运行 jar
bash scripts/run-dev.sh both # platform :8093(dev profile) + flowable-service :8089
curl -s localhost:8093/v3/api-docs | head -c 80 # 健康判定用这个端点(返回 JSON 即活)
```
- 日志:`/tmp/eip4-platform.log`、`/tmp/eip4-flowable.log`。
- 不在内网/没有客户库副本:用 `deploy/` 的 compose 演示栈(见 `deploy/README.md`),或 local profile + `eip4m0` 极简自举集(CI/对拍口径,账号 alice/123456)。
- 三套 profile 的含义与端口:见仓根 `README.md`「三套 profile」表。
## 3. 前端:起 dev server
```bash
cd ../eip4-web
npm install
npm run dev # :5173,/api 反代 dev 后端 :8093(.env 已配)
```
浏览器 `http://localhost:5173/login`,**dev 库账号 `admin` / `111111`**。
登录后随便开几个菜单(如 新闻管理/用户管理),列表能出数据即全链路通。
```bash
npx vitest run && npm run build # 前端测试 + 生产构建绿=环境 OK 第二证
```
## 4. 必读文档(按序,约 1-2 小时)
1. 仓根 `README.md` — 模块地图、双层制纪律、三套 profile、JDK 红线
2. `docs/架构设计.md` — 双层制(保真层供奉/现代层生长)全部架构决策
3. `docs/迁移手册.md` — 引擎坑位台账(§5 引擎行为契约最常用)
4. `docs/README.md` — 全文档索引与状态分级(**历史/归档文档勿据以判断进度**)
5. `docs/项目进度与路线-总览-2026-06-21.md` — 进度权威(A/B 矩阵 + 待拍板)
6. 仓根 `CONTRIBUTING.md` — 分支/合并/提交/质量门约定
## 5. 高频坑(前人真踩过的)
- **fat jar 不重打**:改代码后 `mvn -pl platform-app -am package` 若行为没变,加 `clean` —— 增量打包可能没把改动打进 fat jar。
- **`mvn -pl` 忘 `-am`**:兄弟模块改动没被一起构建,报旧类错误。
- **前端页面卡死/转圈**:先杀孤儿 vite 进程(端口会漂 5173→5176…),再 `rm -rf node_modules/.vite` 清 pre-bundle 缓存重起。
- **psql 查不到表**:业务 schema 是 `eip3`,先 `set search_path=eip3`。
- **登录接口取 token**:`POST /api/auth/login` 的 token 在响应**顶层** `token` 字段;引擎主键 CHAR 补白,比对/传参前 `trim`。
- **改转换器不生效**:转换器产物落 `sys_page_schema`,改完须**重转重导**(BatchConvertCli + SchemaImportCli)运行库才变。
- **CRLF + tab 的老文件**:别用 sed 改,用 python 脚本改(保字节格式)。
## 6. 红线(越线=返工)
- 保真层 `com.dsasp.*` **只移植不重写**、不改包名(ArchUnit 强制现代层→保真层单向依赖)。
- 引擎 DDL 只走守卫单点(`AlterTableSqlGuard`/`CreateTableSqlGuard`/`DropTableSqlGuard`),禁裸 JDBC DDL。
- Flowable `databaseSchemaUpdate=false`,严禁引擎自动改表。
- AI 产物终点恒人审(`READY_FOR_HUMAN_REVIEW`),平台不内置生成 LLM;**对外严禁承诺「AI 全自动开发」**。
- amis 锁 6.13.0 本地 SDK,不依赖 CDN、不升版本。

View File

@@ -4,6 +4,10 @@
> 本文档固化了立项后关于工程结构、选型、中间件、保真层安全/性能的全部架构决策。 > 本文档固化了立项后关于工程结构、选型、中间件、保真层安全/性能的全部架构决策。
> **新会话/新成员开工 eip4-platform 前必读本文。** > **新会话/新成员开工 eip4-platform 前必读本文。**
## 当前架构图(2026-06-26)
![EIP4 最新架构](assets/eip4-architecture-2026-06-26.png)
--- ---
## 一、总原则:双层制——保真层供奉,现代层生长 ## 一、总原则:双层制——保真层供奉,现代层生长
@@ -18,7 +22,8 @@ eip4-platform(Maven 多模块单体)
├── platform-auth P2:组织/权限/数据权限真实现(替换 PoC 桩) ├── platform-auth P2:组织/权限/数据权限真实现(替换 PoC 桩)
├── platform-flow-gateway Flowable REST 客户端、待办聚合、3 个 handler bean ├── platform-flow-gateway Flowable REST 客户端、待办聚合、3 个 handler bean
├── platform-converter 模板转换器 + S3 脚本改写器(可独立 CLI 跑批) ├── platform-converter 模板转换器 + S3 脚本改写器(可独立 CLI 跑批)
├── platform-ai MCP Server、schema 双闸校验 ├── platform-ai AI Agent 开发底座、schema 双闸校验、自动修复、本地门禁和人工部署包
├── platform-cli EIP4 Agent 受控命令入口:环境探测、AI 自动开发、后续发布编排
├── platform-parity C1 逐行对拍框架:录制/重放/逐行 diff(P1 一级交付物,可独立 CLI 跑批) ├── platform-parity C1 逐行对拍框架:录制/重放/逐行 diff(P1 一级交付物,可独立 CLI 跑批)
└── platform-app Spring Boot 启动器,组装上述模块 └── platform-app Spring Boot 启动器,组装上述模块
``` ```

View File

@@ -123,7 +123,7 @@ classpath:`mvn -pl platform-converter dependency:build-classpath -Dmdep.output
**live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。 **live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。
**部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有远程 git.latent.chat)。 **部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有私有远程)。
**剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。 **剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。

View File

@@ -1,3 +1,5 @@
> 📌 **落地状态以总览为准(2026-06-21)**:本文「未开始/未实现」等表述已过时——L1 主题(amis-theme.css §10-15 密度/按钮/弹窗)、L2 行选中、设计中心 DesignCenterPage 已上线。当前落地状态见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B4。
# EIP4 组件设计体系 — 设计文档 # EIP4 组件设计体系 — 设计文档
> 日期:2026-06-15 状态:设计已成形(brainstorm 共识),具体数值/形态待真实数据校准 > 日期:2026-06-15 状态:设计已成形(brainstorm 共识),具体数值/形态待真实数据校准

View File

@@ -2,7 +2,7 @@
日期:2026-06-16 日期:2026-06-16
触发:用户要求「停下来通盘考虑,保证**所有类型**的旧模板(不光 tree)**没有自定义模板**的功能都能正常使用——新架构(转换器+设计器);自定义的走 bespoke」。 触发:用户要求「停下来通盘考虑,保证**所有类型**的旧模板(不光 tree)**没有自定义模板**的功能都能正常使用——新架构(转换器+设计器);自定义的走 bespoke」。
方法:精读 `转换器覆盖度审计-2026-06-13` / `EIP4-架构与缺口现状-2026-06-13` / `CRUD-QA-发现与剩余-2026-06-14` / `M0交付/153定制视图处置清单v1` + 全库 `view_template` 实测分布,合成一张通盘视图。 方法:精读 `转换器覆盖度审计-2026-06-13` / `EIP4-架构与缺口现状-2026-06-13` / `归档/CRUD-QA-发现与剩余-2026-06-14` / `M0交付/153定制视图处置清单v1` + 全库 `view_template` 实测分布,合成一张通盘视图。
> **状态校准(2026-06-16 晚)**:本计划 §三 的 **P0 三项(日历 type5 / 树 type3 接端点 / 组合 type6)转换器源码已全部实现并提交**(eip4-platform main `598f4f9`,连同审批 `33fda45` / 引用列显名 `cd133aa` / chore `bf56595`;提交前 `mvn test` 绿)。**但下文 §二 矩阵里 type3/5/6 的"未接/占位/语义错"描述的是 _运行库(883 页)现状_——在「全量重转重导 + 重启」之前仍成立**。即:源码已修 ✅,运行库待部署 ⏳。详见末尾「§七 收口落地与校准」。 > **状态校准(2026-06-16 晚)**:本计划 §三 的 **P0 三项(日历 type5 / 树 type3 接端点 / 组合 type6)转换器源码已全部实现并提交**(eip4-platform main `598f4f9`,连同审批 `33fda45` / 引用列显名 `cd133aa` / chore `bf56595`;提交前 `mvn test` 绿)。**但下文 §二 矩阵里 type3/5/6 的"未接/占位/语义错"描述的是 _运行库(883 页)现状_——在「全量重转重导 + 重启」之前仍成立**。即:源码已修 ✅,运行库待部署 ⏳。详见末尾「§七 收口落地与校准」。

View File

@@ -0,0 +1,271 @@
# EIP3 → EIP4 项目进度与路线 · 总览(2026-06-21)
> 维护日期:2026-07-02(06-26 增量已并入;07-02 做过一轮文档-代码对抗核查对齐,见 §8 末)| 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新能力)+ 下一步。
> **本文取代 `归档/项目进度与路线-总览-2026-06-17.md`**(口径刷新至 06-21,新增「06-17→06-21 增量交付」一节;旧版已于 07-02 物理归档)。
> 配套权威:`README.md`(文档索引)、`架构设计.md`、`plans/2026-06-19-EIP4开发平台-架构方向-design.md`(方向 D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`(主特性设计)、`framework定制视图-engineclass移植backlog-2026-06-17.md` + `framework定制视图-TODO-2026-06-17.md`(A 兼容台账)。
>
> 编制方法:6 路并行盘点(两仓 git 真相 / 设计计划 / AI 契约 / 现有索引 / 全量文档分级)→ 综合 → 3 路对抗核对(过报 / 漏报 / 文档整理),核对修正已并入正文。所有 git 短哈希均对两仓 origin/main 核实存在。
---
## 0. 一句话进度
EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁移的**只读切流链路已闭合、写路径主线已端到端落库**。
- **A 兼容线**:通用模板 1363 基本可用;153 定制视图中 framework 推进过半、**业务 106 未动(最大块)**。
- **B 新能力线本期里程碑突破**:「人走五环建新功能」低代码平台 **v1 全链交付并合入 origin/main 两仓**;设计器选型(amis-editor)拍板且 **DesignerPage 全闭环上线**(解除历史 P1 头号阻塞);AI 确定性(非 LLM)五环生产线**已合 main**。
- **安全基线(§10.1 四项 P0 + 评审追加 2 孪生 + Groovy 沙箱)2026-06-25 全数收口并 push**(platform `eba9ce1` / web `2a37251`),可达 RCE/越权/fail-open 已闭。
- **报表保真层(套打 JOR)2026-06-25/26 重宿主 + 安全/OOM 收口全数完成并 push origin/main**(§11):SQLi 门 / IDOR 授权 / XXE / 并发·字节·超时·结果集封顶 / CVE 依赖替换 / 报表只读数据源;11 类 79 单测 + live e2e + 安全对抗复审,三批 merge `e6c73a4`/`dccca17`/`d697885`。
- **B3 在线流程 Modeler v1 全链交付并合 main(2026-07-02)**:可编辑存量/新建 BPMN→草稿→同人确认发布→部署 Flowable(中文 key 保真+EIP4 办理人/会签控件+发布门+审计),A2 审批线的「流程定义在线编辑」最后一块补齐。
- 项目仍在 **dev 环境**;生产上线工程化(A10)**MVP 骨架已合 main(2026-06-25)**:W1 Flyway(`db/migration/V1-V3`)+ W2-W4 容器化/nginx 单源/compose 编排(`deploy/` + 模块根 Dockerfile),切流执行 / 性能并发 / 灰度未做。
---
## 1. 规模底数(2026-06-17 实测,仍有效)
| 项 | 数 |
|---|---|
| `view_template` 模板总量 | **1516** |
| ├ 通用(无 engineclass,走转换器) | **1363** |
| └ 定制(有 engineclass) | **153** = framework **47** + 业务 pm/hr/oa/dm **106** |
| `sys_page_schema` 已转换页(含 view_page 表单) | 2729 |
| 类型分布 | 列表 type1=858 / 报表 type200=339 / type100=121 / 编辑表单 type7=70 / 树 type3=50 / 树Grid type4=45 / 组合 type6=20 / 树选 type101=11 |
> 元数据单一真相:`SYS_ENTITY` + `SYS_ENTITYATTRIBUTE`(老系统保真层原物,新旧共用)。eip3 本身即元数据驱动低代码平台,「转换」只动页面层,元数据一行没转。
---
## 2. 06-17 → 06-21 增量交付(本期里程碑)
> 两仓 origin/main 终点 = merge commit(eip4-platform `75f942b` / eip4-web `d1fd6ed`),本地 main == origin/main(已 push,无需再决策)。AI 工作 20 提交(`a51f353 → 9aea6c1`)随 human-five-ring 推上 origin/main。
| 交付 | 仓 | git 证据 |
|---|---|---|
| **人走五环可视化新建特性 · 后端全链**(元数据建实体 / 引用列 → recipe 单步编译 → 默认流预览落库 → 发布产人审部署包 + 菜单注册) | platform | merge `75f942b`;`4400eab`(8094 真 DB 五环①②③④含引用列 OWNER→SYS_USER live e2e)、`303b4d0`(修 DesignFeatureController 多构造器漏 `@Autowired` 致 Spring 启动崩)。`/api/meta/{entities,attributes,entity,entity-types}` + `/api/design/{recipe/compile,flows,publish}`。418 单测 + live e2e |
| **人走五环 · 前端**(ModelerPage 建模器 + 引用列 picker + NewFeatureShell 编排壳(四步向导:建实体/建子表/生成页/发布) + AI①面 AiFeatureForm + admin-gated 路由) | web | merge `d1fd6ed`;`915443f/fef5e33/4e7a95c/2b261e3/4b9c933`(建模器 UI + meta/recipe/publish api 模块)、`8f94ba3/bfb076f/7153592/a6bd4b0`(编排壳 + 设计中心入口 + 五环 Playwright)、`4e0e974/4b564c6`(AI 入口恒 READY_FOR_HUMAN_REVIEW + M-Gate 渲染冒烟)。73 vitest + build |
| **DesignerPage 实时设计器闭环上线**(amis-editor 打通:去 StrictMode 修空白屏 / 画布高度约束可滚 / 滚动条可见 / 设计中心独立 tab / `editor.html` CSS import 进 bundle 修生产构建 404)——**解除历史 P1 头号阻塞「DesignerPage 实测不可用」** | web | `2278cbc`(去 StrictMode 修空白屏)、`8603d0f`(滚动条可见)、`3abeefe`(画布可滚)、`f39661a`(设计中心独立 tab)、`ae0155e`(editor.html CSS 进 bundle 修生产构建 404)、`690f4c7`(dev 反代默认 8093 开箱即通) |
| **主子表四件套**(建模 / 派生字段 金额=数量×单价 / 父级聚合 总额 SUM / 引用驱动联动 选物料带出单价规格) | platform + web | platform `b0daaaa/d71ad6f/ce544fa/ba8177e/63e6522/3e4264d`(含排除标准审计列让生成页真正可用);web `934c646/c735f24/df0ac72/4a107f3/b578d8d`(向导映射 UI + 真事件 e2e;单选 select 经 `selectedItems.<源>` 取值) |
| **AI 确定性(非 LLM)五环增量生产线合 main + 写路径对齐 + 三道硬门收口** | platform | platform-ai + platform-cli 两 Maven 模块;`e550725…6c60383`(blueprint 编译器 + recipe 闸 + 渲染计划闸)、`d3b8846`(**M3a:net-new 标准写收敛到单一 `PageSchemaWriter`** = 单一写真相基石)、`1ff0d33/5f32050/6c60383`(AI-recipe 增改删对齐保真层服务流 `_ADD/_UPDATE/_DELETE`,含 tree-crud 写口径,非自创 `/api/entity` save)、`bac69d8`(typed-recipe 闸只作用 AI 草稿不误伤设计器 overlay)、`c379f5b`(AI 端点要求 admin)、`9aea6c1`(对外措辞收敛为 AI 辅助 + 人审)。`POST /api/ai/features/auto-develop` 终态恒 READY_FOR_HUMAN_REVIEW |
| **附件双态组件**(查看只读可下载 / 编辑可增删;读路径大写 DOCUMENT 归一 + 写路径对账落库) | platform | `22211b2`(转换器 buildAttachmentField 收敛单个 input-file + `staticOn ${__readonly}`;FlowController.resolveAttachmentFields 修空白图标 + normalizeAttachmentFieldsForWrite 交保真层落库) |
| **framework 视图移植 P2**(审批历史抽屉 / 我发起的流程 / 流程监控 / 数据导入 / 脚本编辑器 / 工作日历 / treegrid 过滤搜索 / 用户+流程 picker 对齐 / 短消息 + 消息详情;定时任务「设置提醒人」) | platform + web | platform `57c3412…d218c2b` 一批(机制① delta 注入 + 整页改写器 + filterscript 级联 + `_SEARCH` real-first + 搜索时间段 + 树编辑 layout)、`c9e4d35`(**DataImportConfigController** 315 行 + **ScheduleJobNotifyController** 397 行,均含单测);web `bf7bb25`(picker parity + 消息详情)、`0d6fab4`(用户选择框 → amis picker)、`d03c2ba`(审批历史抽屉)等 |
---
## 3. A:EIP3 兼容矩阵(老模板可用性)→ 刷新至 06-21
档位:🟢 基本可用 | 🟡 demo/部分(有页/端点未逐功能验收)| 🟠 通用页已产·engineclass delta 未移植 | 🔴 未起步
| ID | 工作块 | 档位 | 说明 |
|---|---|---|---|
| **A0** | 通用模板 1363(转换器) | 🟢 | 基本可用。P0 三项(日历 type5 / 树 type3 / 组合 type6)源码 `598f4f9` 已实现,后续多轮全量重转重导已执行,运行库大概率已生效(**需复核**);残 P1 = 19 页缺 EDITFORM 映射 + onselected/filter/enableButton 脚本挂回 |
| **A1** | 153 定制视图(framework 47 + 业务 106) | 🟠 | framework 除用户管理(parity,`bf7bb25/0d6fab4/17c449c`)外多项已移植(审批历史 / 我发起 / 脚本编辑器 / 工作日历 / treegrid),按 Java 类去重约 38 待写单元;**业务 106 基本没动 = 最大块**(源码已核实在本地 `../EIP-3.0/`,pm/hr/oa/dm 3.1G,2026-07-02);终判 158.75 人日卡 S1 止损评审 |
| **A2** | 流程审批优化 | 🟢 | ApprovalDrawer / WfTemplate 驱动审批 / 审批历史抽屉 / 监控按钮(撤回/结束/高级,早已 live)+ **2026-06-26 审批闭环批补齐**:协办(assist)/转阅(circulated)动作、BPMN 流程图查看(bpmn-js)、会签(BPMN 多实例,scriptUser 候选人解析移植)、会签进度「已会签 N/M」、**xerces 击穿修复**(report 古董 xerces 击穿全部 WfTemplate 解析,已钉 JDK 解析器)。均单测+live。仅剩**客户 BPMN 真实流转(前置①外部)**与**流程定义 Modeler(=B3)**。详见 `docs/plans/2026-06-25-审批闭环-实施计划.md`(main `c95eaee`) |
| **A3** | 报表系统(339) | 🟢 | **套打 JOR 重宿主已完成**(复用客户预编译引擎 headless 渲染,328/339 type=200 为报表查看器 crud,`/api/report/render` 三格式 HTML/PDF/XLS + iframe 保真,push `53f3c25`)+ **保真层安全/OOM 收口已完成**(见 §11,三批 merge)。残:中文字体保真细化 / 钻取链接 / 完整客户库逐张对账;图表 ECharts、报表设计器 B6 仍未起步 |
| **A4** | 附件系统 | 🟠 | 双态组件已上线;缺图片预览、老附件物理文件迁移(下载 403)、DOCUMENT 全生命周期 |
| **A5** | 消息 & 邮件 | 🟠 | 短消息发送 + 消息详情已移植;webmail(IMAP/SMTP)独立子系统未起步;已读联动未接 |
| **A6** | 数据导入/导出 | 🔴 | 数据导入配置端点 `DataImportConfigController` 已落(c9e4d35);整体 FTP+Excel 导入管线 / Excel 导出未成体系 |
| **A7** | 定时任务/调度 | 🔴 | 调度运行时未起步;但「定时任务·设置提醒人」保真端点 `ScheduleJobNotifyController` 已交付(c9e4d35,拆 SENDINFO JSON 为 amis input-table 可编辑回写) |
| **A8** | RBAC/数据权限 parity | 🟡 | 菜单/用户/角色/部门/数据权限 5 块管理后台已建(CRUD + amis 页);用户管理达 parity,其余仍 demo 级未逐功能对照验收 |
| **A9** | 个人设置/工作日历 | 🟠 | 工作日历视图已移植;个人设置(改密/年历)未起步 |
| **A10** | 部署上线工程化 | 🟡(MVP 骨架已合 main,切流未执行) | 仍 dev(web 5173 + 后端 8093)。**2026-06-25 已落地 MVP 骨架**:design(`plans/2026-06-25-A10-生产上线工程化-design.md`,D1-D6 待拍板)+ **W1 Flyway 平台表迁移**(`platform-app/src/main/resources/db/migration/V1-V3`,本地 PG 真验,merge `f7675c9`)+ **W2-W4 容器化/nginx 单源/compose 编排**(`deploy/` compose+nginx.conf+.env.example+systemd、`platform-app`/`flowable-service` 模块根 Dockerfile,merge `97a0eb1`;后续 `fa3c92b` bootstrap 单一真相 / `2db44a6` 演示库自洽起栈)。**未做**:生产切流执行 / 数据迁移 runbook 实跑 / 性能并发 / 灰度(PG/Flowable Runbook 已备未执行) |
---
## 4. B:EIP4 新能力矩阵 → 本期重大刷新
| ID | 工作块 | 档位 | 说明 |
|---|---|---|---|
| **人走五环** | NocoBase 式建模器 + 实时设计器 v1 | 🟢 | **v1 全链交付 + live 验收 + 合 main 两仓**(platform 418 单测 / web 73 vitest)。五环①②③④(含引用列)+ AI①面恒 READY_FOR_HUMAN_REVIEW + production 人审部署包(requiresHumanApproval=true)+ 主子表四件套全完,红线全守。**v1 限简单 CRUD/树 recipe + 只建新不改表** |
| **B1** | 新设计器(低代码可视化) | 🟢 | **选型已拍板**:D1 签字下注 amis-editor(接受 amis-fork 6.13.0 冻结天花板 / bus factor≈1 自维护);形态 = NocoBase 式建模器 + 实时设计器,不做线性 wizard。**DesignerPage 已修到全闭环**(`2278cbc` 等 6 提交),原 P1 头号阻塞已解除 |
| **B2** | AI 模块 | 🟢 | **确定性(非 LLM)五环增量生产线已合 main**(超 PoC)。platform-ai + platform-cli 落地;终点恒人审、平台不内置生成 LLM(唯 LLM 修复 `HttpAiLlmRepairClient` 默认关、只修不生成)。落地 P0/P1/P2/P4/P5 第一版完成,P3 进行中 |
| **B3** | 流程建模器 BPMN Modeler | 🟢 | **v1 全链交付并合 main(2026-07-02,platform+web)**。bpmn-js Modeler 可编辑存量/新建 BPMN 流程→存草稿(act_re_model)→同人确认发布→部署到 Flowable。含:可逆 id 净化(中文流程 key 保真 D7)、EIP4 侧板五控件(办理人/会签保真读回/formKey/扩展属性/监听器)、办理人表达式 codec(逐字对齐引擎)、activiti moddle 完整描述符(1512/1512 保真零丢失)、发布门(ProcessValidator+网关语义校验+超管门+审计 V4)、4 新建模板、Playwright e2e 三场景。17 任务 TDD+对抗评审+每阶段 live 验收(挡 3 真 bug 含 bpmn-js PascalCase 断部署)。设计+实施计划见 `plans/2026-07-02-在线流程Modeler-实施计划.md`。残:A10 生产加固 backlog(nginx 洞已修/引擎表达式白名单/网关内部鉴权)、空 content 语义校验、细粒度流程授权(v2)。BPMN 只读查看(A2 流程图)仍在 |
| **B4** | 生产级 UI/UE 组件体系 | 🟡 | L1 主题(amis-theme.css §10-15 密度/按钮/弹窗/字号)+ L2 行选中 `checkOnItemClick` + 设计中心 DesignCenterPage 已上线;剩选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办 未完整(`组件设计体系-design-2026-06-15` 落地状态需对齐本矩阵) |
| **B5** | 移动端 / 响应式 | 🔴 | 未起步 |
| **B6** | 报表设计器(自助报表) | 🔴 | 未起步(与 A3 同根待立项) |
| **B7** | 平台底座 | 🟡 | 元数据单一真相 + `PageSchemaWriter` 单一写真相(`d3b8846`)+ 五重门禁(page-recipe / typed-page-schema / amis-schema / local-smoke / render-plan)已建 |
---
## 5. 下一步工作(优先级排序)
> 来源:综合 6 路盘点 + 对抗核对;size:S=小 / M=中 / L=大。
### P0(先做,本期)
1. **【S,本文即产出】刷新主进度文档到 06-21**:本总览已建;下一步把 `README.md` 索引刷到 06-21、补登 plans/06-19/06-20 三份新 design 与 AI 契约导航、标注已完成的一次性 plan/简报为「归档候选」。*理由:文档时间线断层(最新交付 06-21,文档停 06-17),接手者会被误导。*
2. **【M】AI 门禁余项收口**:存量 overlay 组件 vs 白名单清零、引擎 ALTER 安全通道(`executeCreateSql` 现只接受 CREATE,net-new 仍有裸 JDBC 旁路风险)、安全门 advisory → enforced。*理由:合 main 硬门已清,但这批非红线清理是安全门转强制的前提。依赖:AI 分支已合 main(75f942b)。*
### P1(紧接其后)
3. **【L】framework 业务 106 视图(pm/hr/oa/dm)engineclass delta 移植启动**:A1 真实大头。机制① `EngineclassDelta` 注册表 + 用户管理 Delta 移植方法论已就位可复用。*依赖:S1 止损评审定处置方式(见 §6)。*
4. **【L】人走五环 v2**:ALTER 改已有表(引擎现零迁移路径)+ 主子表/审批/组合 tabs recipe 扩面(路线图 M7)。*须作为新 recipe 增量加入 blueprint,不得绕过门禁。依赖:v1(75f942b/d1fd6ed)+ 引擎 ALTER 安全通道(#2)。*
5. **【✅ 大部完成 2026-06-26】流程审批闭环**:协办/转阅/BPMN流程图/会签/会签进度/监控按钮/xerces修复 全部已做并合 main(`c95eaee`)。**仅剩**:客户 BPMN 真实流转(外部依赖)+ 流程定义 Modeler(=B3,S1 拍板)。*amis 列表入口按钮接线此前已 live(228 页 openApprovalDrawer)。*
6. **【M】AI 链与人工链部署包统一**:`DeploymentPackageBuilder` 下沉(platform-metadata 与 platform-ai 各一份)+ 净新标准页运行时 DELETE/回滚端点 + publish 写角色菜单授权(现仅 INSERT sys_menu,非超管不可见)。*影响人走五环 v1 完整可用。*
### P2(立项 / 排期)
7. **【L】报表系统 A3 立项**:套打 JOR(45) + 图表 ECharts + 打印 + 报表菜单树路由(与 B6 报表设计器同根,体量大独立立项)。
8. **【M】附件 A4 补完**:图片预览 + 老附件物理文件迁移(修下载 403)+ DOCUMENT 全生命周期。
9. **【L】生产上线工程化 A10**:生产构建 / 单源托管(Nginx 或 Spring 伴服 dist + /api)/ 数据迁移 runbook 执行 / 性能并发 / 灰度。*客户最终交付硬门,越早打通越好。*
10. **【M】生产级 UI/UE 组件体系 B4 补完**:选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办(L1/L2/设计中心已上线,补 P1-P4 模式骨架)。
---
## 6. 待拍板决策(决定后续排期)
1. **153 定制视图终判三选一**(分期交付 / 引第三方甘特组件 / 扩预算):158.75 人日 ≈ 7.56 人月,超 3 人月止损线,卡 S1 止损评审会。framework 47 已大幅推进,但业务 106 是主体,处置方式直接决定工期。
2. **②面 in-app AI employees / 平台内置生成 LLM 是否立项及时点**:v1 红线 = 平台进程内不内置生成 LLM(AI 走①面外部 agent + Skills + CLI)。②面何时启动、是否触碰对外口径红线待产品决策。
3. **type100(116) / type101(10) 列表选择框死页**:运行时由 `/api/picker/{dialogid}/list` 承接、不读这些 schema;是彻底停转还是留待低代码处理。
4. **onEvent 声明式面板(M5)自动化率目标与人工兜底边界**:逻辑编排 = b 声明式 80% 主干 + 人工 20% 兜底 + c AI 增量(D3),架构标最高不确定环;S3 自动化率 <80% 触发工期重估。
5. **对外口径统一**:人走五环 + AI①面已交付,客户演示/报价如何呈现「AI 辅助」而不越「严禁承诺 AI 全自动开发」红线。
6. **邮件全家桶(webmail IMAP/SMTP)是否纳入本期 parity 必交范围**:独立子系统、体量大。
---
## 7. 现行权威文档导航
| 类别 | 文档 |
|---|---|
| 进度权威(本文) | `项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 下一步 + 待拍板) |
| 架构基线 | `架构设计.md`、`迁移手册.md` |
| 方向 / 特性 design | `plans/2026-06-19-EIP4开发平台-架构方向-design.md`(D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`、`plans/2026-06-25-A10-生产上线工程化-design.md`(待拍板 D1-D6 + W1-W6) |
| 活路线图 | `plans/2026-06-19-EIP4开发平台-落地执行路线图.md`(M0-M8,状态随里程碑回写) |
| AI 契约 | `AI_AGENT_AUTO_DEVELOPMENT.md`(对外口径红线)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`、`AI_AGENT_REPAIR_CONTRACT.md`、`AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` |
| 决策红线来源 | `决策与盘点/EIP3架构决策会纪要.md`(对外口径红线:严禁承诺 AI 全自动开发)、`决策与盘点/EIP3架构决策报告.md` |
| 运维 runbook | `P0-PG升级/PG升级Runbook-v1.md`、`P3-Flowable升级/Flowable升级Runbook-v1.md` |
| A 兼容台账 | `framework定制视图-engineclass移植backlog-2026-06-17.md`(主 backlog)、`framework定制视图-TODO-2026-06-17.md`(活清单·Done/In-Progress/待验三态)、`用户管理-Delta移植-实现过程与踩坑-2026-06-17.md`(方法论/交接) |
| 通用模板线 | `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` |
---
## 8. 文档整理动作记录(2026-06-21 本次)
- **新建本文**为进度权威;`项目进度与路线-总览-2026-06-17.md` 顶部加「已被取代」横幅。
- **README.md** 刷新到 06-21(索引 + 模块完成度 + 导航 + 下一步)。
- **`plans/2026-06-20-人走五环建新功能-实施计划.md`** 加「24 任务全部完成 + 合 main」横幅;**`plans/2026-06-19-EIP4开发平台-落地执行路线图.md`** 回写里程碑状态。
- 以下**已完成的一次性 plan/报告标为「归档候选」**(本次未物理移动,避免破坏现行文档中的相对引用;可后续批量 `git mv` 入 `归档/`):`plans/2026-06-14-onEvent脚本挂回修复-plan.md`、`plans/2026-06-14-提交审批桥接-design.md`、`plans/2026-06-14-新闻管理垂直切片-plan.md`、`plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md`、`plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md`、`CRUD-QA-发现与剩余-2026-06-14.md`、`C3压测基线.md`、`C5构建预演报告.md`。
- 以下 design/契约文档**正文有过时点**,顶部加「现状以 06-21 总览为准」横幅并指明过时处:`组件设计体系-design-2026-06-15.md`(「未开始」已过时)、`AI_AGENT_AUTO_DEVELOPMENT.md`(「只覆盖最简单 CRUD recipe」已过时,实有 tree-crud + master-detail)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`(master-detail 列为未来 TODO,实已有 `master-detail-v1.yaml`)、`AI_AGENT_Nocobase_SOURCE_REVIEW.md`(P3 进度前后自相矛盾)。
**2026-07-02 文档-代码对抗核查对齐**(5 路并行核对本文 §9/§10/§11 + A/B 矩阵全部声明 vs 两仓代码,48 条声明 46 条完全一致、无虚报):
- 修正本文与代码不一致处:A10 行 🔴→🟡(W1-W4 骨架 06-25 已合 main,本文此前低报);§9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)已改;§10.2 render-plan 行号迁移至 `AiDraftGateValidator.java:246`;§11 报表单测 73→79;§2「五步编排壳」实为四步向导。
- 代码侧同步修正:`CandidateUsersHandler` 类级 javadoc(scriptUser 已于 06-26 接入,注释仍写「WARN 降级未接入」)。
- **归档候选物理归档执行**:上方列出的 8 份一次性 plan/报告 + `项目进度与路线-总览-2026-06-17.md`(已被取代)+ `plans/2026-06-20-人走五环建新功能-实施计划.md`(24 任务全完成)共 10 份 `git mv` 入 `归档/`,引用处(README 索引、M0剩余项登记、通用模板收口计划、架构方向-design)已同步改路径。
---
## 9. P0/P1 实施记录(2026-06-21 续·已落地 + E2E 验证)
> 本节记录文档对齐之后启动的 P0/P1 实施。代码**已提交两仓特性分支 `feat/p0p1-impl`(未 push)**:eip4-platform 4 提交(docs / P0② / P0②b+P1⑥ / 对抗审查修复)、eip4-web 1 提交(P1④+P1⑤)。后端改动 `mvn -pl platform-app -am package` 重建 jar + 重启 8094 验证(已执行)。验收脚本:`scripts/p0-alter-acceptance.sh`、`scripts/p1-6-acceptance.sh`。
| 项 | 状态 | 交付 + 证据 |
|---|---|---|
| **P0② AI 门禁 + 引擎 ALTER 安全通道** | ✅ 完成·已验证 | (a) `AlterTableSqlGuard`(legacy-core,只允许 加列/改可空——同族扩长即 ALTER COLUMN TYPE 已经下方对抗审查①移除,拒 DROP/RENAME/SET NOT NULL/TYPE 变更/多语句/小写绕过)+ `DataDicService.executeAlterSql` 通道 + `MetaController POST /api/meta/entity/{table}/attributes` 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) `PageSchemaController` `?strict` 分流 + `GET /api/page/schema/overlay/audit` 白名单对账端点;(c) `AiAgentService.applyLocalRelease` 织入 `AiToolRegistry.check`(安全门 advisory→**enforced**,非本机/越权写路径 403)。**单测**:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。**真库 e2e**:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。 |
| **P1④ 人走五环 v2 · 改表加列** | ✅ 完成·浏览器 E2E | 前端 `meta.ts alterEntity` + `ModelerPage` 行内「加字段」Dialog(复用 FieldTable);打破「v1 只建新不改表」。**build 绿**(tsc 无错)+ **vitest 73/73**。**浏览器 E2E**:`five-ring.spec.ts` 新增「改已有表加列(建模器加字段→元数据落库)」,与五环/主子表共 **5/5 绿**。recipe 扩面(M7 新页型)暂缓。 |
| **P1⑥ 运行时 DELETE + 菜单授权** | ✅ 完成·真库 e2e | `PageSchemaWriter.deleteStandard` + `DELETE /api/page/schema/{tpl}/standard`(@Transactional 对称撤销:删 schema+overlay+软删菜单+清 sys_role_menu);`MenuRegistrar.grantToRoles` + `PublishOrchestrator.grantMenuRoles` + `DesignFeatureController.publish` 透传 roleIds(缺省 warning)。**单测**:PageSchemaWriter 6/0、MenuRegistrar 4/0、PageSchemaController 28/0、DeploymentPackageBuilder 1/0(无回归)。**真库 e2e**:发布带 roleIds→授权写 sys_role_menu ✓、无 roleIds→warning 负控 ✓、DELETE 对称撤销(计数全对)+ GET→404 + psql 核对授权落库/清除 ✓。部署包下沉(builder unify)暂缓(纯重构、回归风险高、可见价值低)。 |
| **P1⑤ 审批列表入口** | 🟡 接线完成·e2e 验证(运行时阻塞) | 列表入口接线**已 live**:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮(psql 实证名实一致)+ 既有单测(registerApprovalAction 5/converter)。**浏览器 E2E**:新增 `approval-list-entry.spec.ts`(纯 mock)验证生产主路径「转换列表页按钮→选中行→openApprovalDrawer→AppShell→ApprovalDrawer 抽屉打开」1/1 绿。**外部阻塞**:点同意后真实流程流转/候选人计算需客户 BPMN(act 库 dev 不可达);BPMN 流程图编辑器=B3 级另案。 |
| **P1③ framework 业务 106 视图** | 🔴 未启动·待拍板 | 卡 S1 止损评审(§6 待拍板①:分期/第三方/扩预算),需客户决策方向。源码已在本地 `../EIP-3.0/`(2026-07-02 核实),仅剩决策一重阻塞。 |
**对抗审查收口(2026-06-21)**:实施完成后用 3-lens workflow 对自己的 P0②/P1⑥ 代码做对抗审查,揪出并修复 **4 major + 多 minor 真 bug**——①Guard 移除 ALTER COLUMN TYPE(静态守卫拿不到旧尺寸,缩短 `varchar(1)`/`numeric(1,0)` 会截断/溢出存量数据);②`addAttributes` 校验-写分离 + `@Transactional` + ALTER 失败抛异常(防孤儿元数据,PG 事务性 DDL 一起回滚);③`createEntity` 检查 `executeCreateSql` 返回值 + `@Transactional`(引擎拒建表不再静默成功);④`AiToolRegistry.isLocalEnv/isProductionEnv` 改 URI host 精确解析(防 `http://127.0.0.1.evil.com` 伪本地前缀绕过安全门);⑤`grantToRoles` 改 `INSERT...WHERE NOT EXISTS`(**实证 `sys_role_menu` 无唯一约束→`ON CONFLICT DO NOTHING` 不去重→重复发布插重复行**)+ `deleteStandard` trim/isactive 过滤 + `publish` roleIds 只接 String + `columnSqlType` 空 refTable 抛错。修复后全单测 + 双真库验收(含幂等 [2b])+ 浏览器 e2e 6/6 全绿。overlay 审计端点实跑:dev 库仅 1 overlay 用 `dialog`/`submit`(白名单偏窄,非存量页问题)。
**红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空、移除 TYPE 变更,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。
**仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一(已查:两生成器**当前逻辑等价无 bug**,统一是防未来漂移的纯重构,需改 AI 黄金测试,低优先)/ P1⑤ 真实流转(依赖客户 BPMN)/ **P1③ framework 业务 106 视图(阻塞=待 S1 拍板;EIP-3.0 源码已核实在本地 `../EIP-3.0/`,2026-07-02)**。
---
## 10. 架构改进待办(2026-06-24 核实并并入)
> 来源:① 一轮 8 维度架构评审(模块边界 / 巨型类 / 安全 / 性能 / 前端 / AI 五环 / 测试 / 运维),② 对另一份《EIP4 架构分析与改进建议》(其他 agent 产出)逐条对照**真实代码**核实(确认 / 夸大 / 已缓解 / 有意取舍)。**本节合并其可采纳内容,原文档已删除**(无外部引用)。
> **定级第一原则=可达性**(无需前提即可触达 > 需管理员/DBA 前提的二阶面),而非「是否存在字符串拼接」。下列项**独立于 §5/§9**:§9 收口的是 AI 写路径安全门,本节是评审新发现的、AI 链之外的可达攻陷面与工程缺口。
### 10.1 P0 — 安全/工程止血(可达攻陷面 + 零回归防护)✅ 全数收口(2026-06-25)
> 三条安全项强耦合(都靠「非 prod permitAll / prod 仅 authenticated」放大),建议作为一个「**安全基线**」批次一起做。
**✅ 全数收口(2026-06-25·安全基线批次)**:本节 4 项 P0 + 独立 security-reviewer 对抗评审追加的 2 个同类孪生漏洞 + Groovy 沙箱硬化,已全部 TDD + 全 reactor `mvn clean install` 绿 + 原子提交 --no-ff 合 main 并 push origin(**eip4-platform origin/main=`eba9ce1`、eip4-web origin/main=`2a37251`**)。逐项落地:
> - **①RCE/任意 DROP**:拆 `ScriptExecuteController`——任意请求体 Groovy 的 `/api/script/execute` + `/api/script/execute-template-by-name` 移入 `@Profile(SecurityProfiles.BYPASS=dev|local|ci|parity)`,生产仅保留**只重放脚本库内已审产物**的新 `ScriptReplayController`(`/api/script/execute-template`);`RewrittenScriptStore.load` 加 templateId 路径穿越守卫(resolve+normalize+startsWith root,+NUL 字节兜底);三个 `Poc*Controller`(含裸拼 DROP)全 `@Profile(BYPASS)`。(`980d83e`)
> - **②安全默认 fail-open**:宽松 permitAll 链由 `@Profile("!prod")` **反转为显式 opt-in** `@Profile("dev|local|ci|parity")`,严格认证链覆盖默认(含裸 `java -jar` 未设 profile)与 prod;新增 `SecurityProfiles`(旁路名单唯一真相)、`JwtSecretSafetyCheck`(严格 profile 用 dev 默认密钥即启动 fail-fast)、`application-prod.yml`(JWT/DB 无默认值、强制环境变量)。(`24160db`)
> - **③asUser/roles 越权**:`EntityController.buildCtx` 调换优先级 → JWT 绑定身份**恒权威**,客户端 asUser/roles 仅在无 JWT 身份时(非生产旁路)生效。(`1f2365f`)
> - **④CI 孤儿**:`.github/workflows/ci.yml` → `.gitea/workflows/ci.yml`(JDK 改 21);`ci.sh` 起服务加 `--spring.profiles.active=ci`(配合 fail-safe,否则健康检查 401/对拍免令牌失效);新增 eip4-web `.gitea/workflows/ci.yml`(tsc+build+vitest)。(`1a0985f` / web `63d46af`)。**前置条件**:Gitea 需启用 Actions 且注册 `ubuntu-latest` 标签 act_runner 才真跑。
> - **🔴 评审追加(原 §10.1 漏列的同类孪生,已一并修)**:(a) **CRITICAL** `TodoController.runProcessAdvancedScript`(`/api/workflow/process/{id}/advanced-script`)执行请求体 Groovy、无 `@Profile`/无角色门 = 任意认证用户 prod RCE → 注入 `Environment` + `SecurityProfiles.isBypassActive` 守卫,严格 profile 直接 amisFail 不执行(`bc9ae8c`);(b) **HIGH** `PickerController.buildCtx` 与 EntityController 同款 asUser-first IDOR(prod 可达)→ 同改 JWT 权威(`1f2365f`)。
> - **Groovy 沙箱硬化(评审 MEDIUM)**:强化 `MethodCallExpressionChecker`(原仅挡 `System.exit`)→ 编译期拦反射/进程执行/元编程/动态求值(Runtime/ProcessBuilder/`'cmd'.execute()`/Class.forName/反射/GroovyShell/metaClass/危险 System 方法…),覆盖 MethodCall/StaticMethodCall/ConstructorCall/Property 四类表达式;一处收口两条运行时 Groovy 路径(服务流 + onEvent/editgrid 重放,均经 `SecureGroovyScriptEngineFactory`)。先勘探 1428 改写脚本语料确认零使用再 TDD(8/8)+ 全语料编译零加固回归。(merge `eba9ce1`)
> - **生产上线 checklist(运维必知,fail-safe 行为变更)**:prod 必须 `-Dspring.profiles.active=prod` 且设 `EIP4_AUTH_JWT_SECRET`/`EIP4_DB_*`,否则按设计启动失败;`run-dev.sh`(dev)/`ci.sh`(ci) 已自带旁路 profile,本地/对拍不受影响。
> - **未做(更小,DEFER)**:`@EnableMethodSecurity` + 方法级 IMPERSONATE 角色(现以 profile-gate + JWT 权威已闭可达面);`EditGridScriptController` view_page id 白名单(脚本=DB 内已审 + 沙箱已硬化,残余风险低);`SecureASTCustomizer.setIndirectImportCheckEnabled(true)`(服务流脚本不在勘探语料、风险更高);新增「禁生产源码出现 `Poc*` 的 @RestController」ArchUnit 规则(现 3 个 Poc 已 @Profile 隔离)。
| 项 | 严重度 | 证据(file:line) | 建议 |
|---|---|---|---|
| **RCE — `/api/script/execute` + `/api/poc/write-test`** | ✅ 已修(06-25) | `ScriptExecuteController.java:65→:193-198` 真执行请求体 Groovy(不受 facade 绑定约束=任意 Java/RCE),无 `@Profile`、无鉴权;`PocWriteTestController.java:181` `jdbcTemplate.execute("DROP TABLE IF EXISTS "+target)` 裸拼旁路 `DropTableSqlGuard`,无 `@Profile`。三个 `Poc*Controller` + 散落 `/api/poc/*` 随生产 jar 装配;全平台 `@PreAuthorize` 0 命中且无 `@EnableMethodSecurity` | 生产构建移除 / `@Profile("!prod")` 隔离全部 `Poc*`/`ScriptExecute` 端点;保留者加平台管理员级鉴权(开 `@EnableMethodSecurity`);新增 ArchUnit 规则禁生产源码出现 `Poc*` 的 `@RestController` |
| **安全默认 fail-open** | ✅ 已修(06-25) | `SecurityConfig.java:68-71` `@Profile("!prod")`→`anyRequest().permitAll()`(default/local/ci/dev 全放行);prod 严格链(`:50-61`)存在但仅 `@Profile("prod")`,且**仓内无 `application-prod.yml`**=prod 必须显式激活否则默认洞开;`JwtService.java:44-55` 仅校验长度,`application.yml:29` dev 默认密钥能静默签发可伪造令牌 | 补 `application-prod.yml`(JWT secret 强制环境变量、缺省启动失败);**反转 fail-safe**:未知/无 profile 默认走严格链,`permitAll` 收窄到仅 `local\|ci\|test`;prod 若 JWT secret 仍为 dev 默认值则 fail-fast |
| **`asUser/roles` 越权(prod 同样生效)** | ✅ 已修(06-25) | `EntityController.java:222-241` 客户端 `asUser/roles`(无 `@Profile` 的 `@RequestParam`)**优先于** `:247` JWT 绑定的 `UserSession.get()`,直驱 `DataPrivilegeServiceImpl` 行级数据权限,不校验是否等于 JWT 主体 | `asUser/roles` 测试通道 `@Profile("!prod")` 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 `IMPERSONATE` 角色 |
| **CI 孤儿=自动回归实质为零** | ✅ 已修(06-25) | `eip4-platform/.github/workflows/ci.yml` 是 GitHub Actions 语法但 origin=私有 Gitea(不执行 GHA);`java-version "17"` 写死(项目 JDK21,即便能跑也编译失败=从未真跑过);`eip4-web` 无任何 CI | 把 `scripts/ci.sh` 迁成 `.gitea/workflows/ci.yml`(JDK 改 21)或公司 Jenkins;前端加最小 CI(vitest + `tsc -b`);Gitea 配 branch protection。**理由:P0 安全项修完后没有门禁防再退化。** |
### 10.2 P1 — 稳定性 / 交付能力 / 验证体系 / 可维护性
**【稳定性】**
- **✅【已完成 2026-06-24·稳定性三件套】稳定性配置真空 · high**:原状=HikariCP `maximum-pool-size:5` + `statement_timeout` 全仓零命中 + perPage 无封顶 + `queryForRowSet` 全量物化,四者叠加=一个大/恶意查询(`perPage=999999`)即耗尽连接 + OOM。**已做**:① perPage 硬封顶——新增 `Pagination.clampPerPage`(上限 5000,护栏非产品限),接入 `FlowController.applyPaging` 与 `PickerController.list` 两处 REST 入口(`page` 不封,深翻页合法);② `statement_timeout`——base `application.yml` 加 `hikari.connection-init-sql: SET statement_timeout='${EIP4_DB_STATEMENT_TIMEOUT:120s}'`(dev/local 继承、prod 无 profile 亦继承 base,可环境变量放宽/设 0 关闭);③ 连接池 `maximum-pool-size` 5→20(prod 继承 base 受益)。**验证**:`PaginationTest` 3/3 + `FlowControllerTest`(含新「perPage 超大封顶」集成测试,经真实 `executeGet` 路径) + `PickerControllerTest` 无回归=68/68 绿;`SET statement_timeout='120s'` 经真实 PG(localhost:5433)执行 `SHOW`=2min 确认语法/取值正确;`application.yml` YAML 解析校验通过。**残留(独立较大项,未做)**:`SqlRowSet` 全量物化 → 导出走流式 `RowCallbackHandler`(属性能 P2,见 §10.3)。
**【生产交付能力 — 意图与实现最大成体系缺口,对应 A10】**
- **✅【已完成 2026-06-25·A10 W1】Flyway 平台表迁移**:`platform-app/src/main/resources/db/migration/V1__sys_page_schema.sql`/`V2__sys_datastatus.sql`/`V3__sys_ai_agent.sql` 单一真相,本地 PG 真验(merge `f7675c9`);`bootstrap-ai-agent.sql` 重复已去(`11e668a`/`fa3c92b` 收敛 bootstrap 单一真相)。
- **✅【已完成 2026-06-25·A10 W2-W4】compose/Dockerfile/Nginx 骨架**:`deploy/`(docker-compose.yml + nginx.conf + .env.example + systemd/ + postgres-init/)+ `platform-app/Dockerfile`、`flowable-service/Dockerfile`(merge `97a0eb1`,`2db44a6` 内置演示库自洽起栈)。**残留**:生产切流/灰度未执行(见 A10 行)。
- **✅【已完成 2026-06-24】可观测性近零**:原状=无 actuator/无健康端点/无 logback 配置/base 日志 DEBUG(prod 继承会刷屏)。**已做**:① platform-app 加 `spring-boot-starter-actuator`,`management` 只暴露 `health`(`probes.enabled` 开 liveness/readiness,`show-details/components: when-authorized` 匿名不泄露 db 等组件细节)——不上 Prometheus 全家桶,守中间件最小化;② `SecurityConfig.PUBLIC_PATHS` 加 `/actuator/health(/**)`,prod 链探针免认证可达;③ 新增 `logback-spring.xml`(控制台 + 50MB×14 天滚动文件,文件 appender 仅 dev/local/prod 启用、不污染单测);④ base `application.yml` 的 `com.dsasp`/`jdbc.core` 日志 DEBUG→INFO(prod 继承 INFO,dev 仍 DEBUG)。**验证**:真启动 dev profile(1.7s 起)curl `/actuator/health`=`200 {"status":"UP","groups":["liveness","readiness"]}`、`/health/readiness`=200 UP、`/health/liveness`=200 UP;SecurityProfileTest 3/3 + ArchitectureRulesTest 6/6 无回归。**残留**:prod JSON 结构化日志需 Spring Boot 3.4 内建或 logstash-encoder 依赖,留作后续(避免现在加依赖)。
**【验证体系】**
- **🟡【夜间 job 已接 2026-06-25,实跑待 runner+DB】逐行对拍框架已冻结**:原状=`parity-reports/` 全是 `20260611` 时间戳,11 天引擎/转换器改动从未重拍;push CI 只在有提交时跑对拍。**核实**:`ParityCli` 本就「直连 JDBC 基线 vs 引擎 REST 被测逐行 diff,任一不一致退出码 2」=「非 0 即阻断」是内建的(基线=实时 JDBC,非冻结文件);RowDiffTest 30/30 框架健康。**已做**:新增 `.gitea/workflows/parity-nightly.yml`(cron 每日 02:00 CST + 手动 dispatch,跑 `scripts/ci.sh` 全量 seed+all+privilege 对拍、归档报告)——无提交的日子也能捕获隐性漂移。**仍待(环境/基建门,非代码)**:① 真正重拍刷新基线需在 dev/CI 起引擎+真 DB 实跑(`bash scripts/ci.sh` 或 `ParityCli --seed --all`,DB 依赖,本会话 headless 跑不了);② 工作流激活需 Gitea 注册 act_runner(同 ci.yml);③ `--discover`/`--realprivilege` 更广范围退出语义偏探索性,纳入硬门前需真跑核实。
- **保真层引擎核心无单测 + 集成测试静默跳过 · high · L**:`FlowExcuteServiceImpl`(534 行服务流主干)无单测;`FlowExecuteLocalIT.java:60` `assumeTrue(false,"本地不可达,跳过")`=无 DB 的 CI 永远绿但什么都没测(反模式:把「未运行」伪装成「通过」)。→ CI 必须起 testcontainers,DB 不可达应**红**而非跳过。
- **测试金字塔倒置 · high · L**:根目录 71 png + 前端 121 png 人工 dogfooding 是主回归手段;前端 vitest 仅 17 个;3 套 e2e config 故意不配 webServer(复用已跑环境)无法干净 CI 跑起。→ 关键闭环固化成自启动可进 CI 的稳定 e2e;扩 vitest 把「翻译正确但运行时哑火」下沉到单测。
**【可维护性核心】**
- **🟡【已完成安全半步 2026-06-24】【采纳自原文档 A5】AiLocalReleaseExecutor 裸写 sys_serviceflow/sys_menu**:**已做**——把执行器里所有裸 JDBC(sys_serviceflow UPSERT + sys_menu INSERT/UPDATE + ensureAiMenuParent + tableExists + 实体复用查询)下沉到新类 `platform-ai/.../service/AiReleaseWriter`,执行器只剩编排不再直接碰库;SQL 逐字保留(纯搬迁零行为变更)。**顺带补缺口**:新增 `AiReleaseWriterTest`(4 值断言:serviceflow 审计/`?::xml`/bool→int、菜单 INSERT 全列值、UPDATE 全字段、自动建「AI Agent」目录)——补上原 `AiLocalReleaseExecutorTest` 只查「SQL 含表名」的宽松缺口。**验证**:platform-ai 30/30 绿(黄金测试经搬迁仍绿=行为未变)。**未做(推迟为专项)**:与人走五环 `MenuRegistrar` 统一成单一写器——调查发现两者已实质分叉(本类 UPDATE 全字段 + operator 字面量 'AI_AGENT' + 顶级目录「AI Agent」vs MenuRegistrar 窄 UPDATE + `?` operator + 「新功能」),且各有钉死测试,真统一需重写两路测试 + 重验两条红线邻近路径(建议 live e2e),风险/工作量超「快速增量」,留作 A5 完整版专项。
- **✅【已完成 2026-06-24】【采纳自原文档 A4】ArchUnit 规则扩充**:`ArchitectureRulesTest.java` 从 1 条扩到 **6 条**——3 条强制(保真层禁依赖现代层 / 库模块[converter·parity]不得依赖应用编排层 / 模块切片 `beFreeOfCycles` 无环)+ 3 条**棘轮**(控制器不得新增直用 `JdbcTemplate` / 不得新增 Controller→Controller 互注入 / 不得新增 `Poc*` 调试控制器)。棘轮以「已知债务清单」基线化存量(JdbcTemplate 26 个 / 互注入 4 个 / Poc 3 个),只挡新增、清单即待偿台账。**验证**:`mvn -pl platform-app test -Dtest=ArchitectureRulesTest` 6/6 绿;并以临时探针走完整 RED→GREEN(探针触发恰好 3 条棘轮失败、强制规则不受影响,证明非空绿)。**一处刻意偏离原文档**:未加「禁控制器调 `POJOCRUDService`/引擎」——因 `com.eip4.*→com.dsasp.*` 是双层制明确允许(现代层=保真层薄门面),真正的坏味道是控制器直拼原始 SQL(已由 JdbcTemplate 棘轮覆盖)。**后续**:随 A1/A3 把控制器 SQL 收口到 Service 后,从清单删项,清空即把棘轮升为强制规则。
- **【采纳自原文档 D1】render-plan 无执行闭环 · high · M**:`validateRenderPlanGate`(SRP 拆分后已迁至 `AiDraftGateValidator.java:246`)纯字段校验,Playwright 只在生成的人工指令字符串里,`READY_FOR_HUMAN_REVIEW` 不含渲染证据。→ 新增 headless render runner 真跑 renderTests 后回写 `runEvidence`。
- **✅【已完成 2026-06-25】AiAgentService(曾 1846 LOC)SRP 收窄**:原状=~28 public 入口 + 内联 9+ `validate*Gate` + 部署/回滚 SQL 生成 + 运行记录映射揉一类。**已做**:① 部署/回滚 SQL 簇 → `AiDeploymentSqlBuilder`(黄金串测试钉死红线 SQL 字节);② 草稿门禁电池(validateDraft + 各 `validate*Gate` + SchemaGate 懒加载状态 + 正则常量)→ `AiDraftGateValidator`(直测各类 pass/fail,D3 红线判定零变更)。主类 **1846→1329 行(-28%)** 收敛为薄编排门面(29 public 方法协调 store + 抽出的 collaborator)。**验证**:逐方法/逐字搬迁、行为零变更——AiAgentServiceTest 22/22 + AiAgentControllerTest 11/11 + pipeline 无回归,platform-ai 79 全绿 + 全 reactor `mvn clean install` 绿;新增 AiDeploymentSqlBuilderTest 8 + AiDraftGateValidatorTest 7。**有意丢弃 AiRunStore**:持久化已由现有 `AiAgentStore`(saveTask/saveDraft/saveRun/…)承担,另抽会重复。分支 `feat/ai-agent-service-split` --no-ff 合 main,origin/main=`285d601`。
- **【采纳自原文档 A1/A3】platform-metadata 过厚(31 Controller / 4 Service / 0 Repository)+ Controller 互注入 · medium · L**:`EntityController.java:46/:398` 直接注入并调用 `PickerController`。→ 抽 `PickerService`/`ReferenceResolutionService` 切断互注入;建 web/service/repository 分层(与 ArchUnit 合并做)。
- **🟡【有界安全修已完成 2026-06-25,完整支持仍 L】前端 scriptCommands 联动静默哑火**:原状=`scriptCommands.ts` 把 `setLabel/setRequired/setFilter/setOptions/setNullSelection/setStyle` 翻成 amis `setValue`,但核实 amis `setValue`(CmptAction)只读 `args.value`、丢弃语义 args → 运行时 no-op(且 `args.value` 为 undefined 经 onChange 路径可能清值);amis 全量 `registerAction` 无这些动词的内置 action。**已做(有界安全修,eip4-web origin/main=`68d797e`)**:6 个动词改为<strong>显式跳过(返回 null,translateCommands 自动过滤)+ 一次性 `console.warn`</strong>——消除清值风险、不再伪装「已处理」、不再用假绿单测掩盖;新增覆盖(跳过/整体过滤/告警去重),full vitest 83/83 + tsc -b 干净。**仍 L(未做)**:要让「动态必填/选项/过滤」真生效需<strong>转换器侧生成数据绑定 schema</strong>(`requiredOn`/`source` 绑数据变量)+ 重放改数据变量 + Playwright 真 DOM e2e,跨 platform-converter + eip4-web,对冻结 amis-fork 有回归面,需独立排期。
- **WritePrivilegeChecker 复杂规则 fail-open(读写权限不对称)· medium · M**:`WritePrivilegeChecker.java:156-159` 对部门集合/范围比较类规则 default 放行,而读侧对同类型生成真实约束 → 若客户库含此类写规则可越权 update/delete。→ 不支持类型改 fail-closed。
### 10.3 P2 — 整洁度 / 一致性收敛(多为采纳自原文档的真问题,但属低优先)
- **✅【已完成 2026-06-24】【D5】抽共享 `LocalHostPolicy`**:原状=`AiToolRegistry`/`AiSmokeRunner`/`AiLocalReleaseExecutor` 三处本机白名单互异(ToolRegistry 认展开式 `0:0:0:0:0:0:0:1` 漏 `[::1]`,另两处反之)。**已做**:新增 `LocalHostPolicy.isLocalHost`(去 IPv6 方括号归一 + 精确比对回环集 `{localhost,127.0.0.1,::1,0:0:0:0:0:0:0:1}`,杜绝 `127.0.0.1.evil.com` 伪本地绕过),三处删本地副本统一委托。**验证**:新增 `LocalHostPolicyTest`(接受全部回环形态 + 拒绝伪本地/非本机)3/3 + 三处既有测试(AiToolRegistry 6/AiSmokeRunner 3/AiLocalReleaseExecutor 3)无回归,整套 platform-ai 69/69 绿。
- **✅【已完成 2026-06-24·eip4-web】【B4】抽 `isAdminProfile(profile)` 单函数**:原状=`profile?.account==='admin'||profile?.userId==='ADMIN'` 在 Topbar/ModelerPage/NewFeatureShell/AiFeatureForm/DesignCenterPage 5 处逐字硬编码。**已做**:`auth/token.ts` 加纯函数 `isAdminProfile`(口径逐字保留),5 处统一委托。顺带把 5 个页面测试的 `vi.mock('../auth/token')` 从整模块替换改为 `importOriginal` 只覆盖 `getProfile`(不再 mock 纯函数,修复因 mock 漏 `isAdminProfile` 致的 render 崩)。**验证**:新增 `token.test.ts` 4 测试 + `tsc -b` 干净 + `vitest` 18 文件/77 测试全绿。
- **✅【已完成 2026-06-24·eip4-web】【B2】删 `api/schema.ts` overlay 死代码**:核实 `fetchSchemaLayer`/`putOverlay`/`restoreStandard` 全仓(含 e2e)零引用(真实 overlay API 在 `editor/overlayApi.ts`)后删除;tsc 干净 + vitest 77/77。**未做【B1/B5】**:拆 AmisRenderer SDK 注册逻辑、合并 todo.ts/done.ts 503 降级——均**低优先整洁度**,非架构风险。
- **【D2/D3】AI 多入口来源审计**:REST/CLI/MCP 三通道 actor 恒「agent」无区分,加 `X-EIP4-Agent-Channel` 头 + 审计;`runLocalSmoke` 过 `smoke.run` 工具门对齐 `applyLocalRelease`(localhost 硬门已兜底,非可利用洞)。
- **converter 单测 4820 行/164 用例塞 1 文件**(按控件族拆 6-10 个);**cli/mcp 各仅 1 测试文件**(对外 AI 门面加契约/快照测试);**e2e 5 套 config 碎片化**(合并为 1 主 config + projects)。
- **保真层级联/附件加载残留 N+1**(`loadDoc` 按子行 id 集合一次 IN);端口契约(8084/8093/8094 漂移)+ 源码树 `.omc` 卫生。
### 10.4 严重度纠偏与已缓解(核实原文档后修正,避免误导排期)
| 原文档断言 | 核实结论 | 纠偏 |
|---|---|---|
| **ColumnSQL =最大残余注入面(high/P0)** | **降为 low/二阶纵深防御** | 裸拼属实(`POInfo.java:377` `LEFT JOIN lateral ("+ColumnSQL+")`),但**无可达写路径**:`MetaController.saveAttr` 不写 columnsql、`FieldEditorController` 改业务数据且受 `IdentifierWhitelist` 守卫、`MasterDetailLinker` INSERT 列清单不含它=需 DBA 直改库才触发。价值在加守卫禁任何写路径设 columnsql,优先级远低于 10.1 |
| Admin/AdminWrite 拼 SQL+级联删+调引擎 | **归因部分不实** | AdminController **只读、不调引擎**;级联删只在 AdminWriteController;调引擎实为 EntityController |
| `deleteByType` 列为待修注入热点 | **已缓解** | 已被 `LogController.deleteByType:73` 枚举白名单闸住(非法 type 拒绝);保真层主 CRUD 值位置多数已 `escapeSqlLiteral` 转义 |
| NewFeatureShell/AiFeatureForm 各内联 250+ 行 schema | **夸大** | 合计 ~290 行,但 AiFeatureForm 仅 ~69 行 |
| LLM 修复客户端泄露风险(high) | **已默认关闭** | `HttpAiLlmRepairClient` 经 `@ConditionalOnProperty havingValue=true` + endpoint 空串双重默认关;聚焦「开启时脱敏 + https 白名单」 |
### 10.5 有意取舍(design-intent,不当缺陷)
不引 ORM / 保真层 `com.dsasp.*` 逐字节复刻不重写(故保真层字符串拼接、类级 `@Transactional`、`DataLogManager` 的 `DiscardOldestPolicy` 均源于此,改写须跨流回归不可当普通坏味道)/ 无多租户单客户私有化 / 保真层 MD5 无盐口令(复刻旧 `EncryptUtil` 验存量库)/ AI 红线焊死(部署包恒人审、本机三处校验、LLM 默认关)。这些是已记录的有意决策,**别当 bug**。
> **采纳裁决一句话**:原文档的「工程整洁度 + AI 门禁」清单(A4/A5/D1/D5/B2/B4 等)核实属实、可放心采纳为 P1/P2;但其安全威胁建模做反了(把不可达的 ColumnSQL 当 critical、漏了可达的 RCE/permitAll/asUser),**安全 P0 以本节 10.1 为准**。
---
## 11. 报表保真层(套打 JOR)重宿主 + 安全/OOM 收口(2026-06-25/26)
真实报表 = jatools JOR 套打模板(633 个),**重宿主非重建**:复用客户预编译引擎在无界面环境 headless 渲染为 HTML/PDF/XLS。Phase 1-3(渲染服务 + `/api/report/render` 三格式 + `/api/report/frame` amis 信封 + 转换器对 type=200 产报表查看器 crud,铺全 339)已完成并 push(origin/main `53f3c25`)。其上做了一轮**安全 / 性能 / OOM 审计与收口**(8 维度审计 + 安全 reviewer 对抗复审,TDD + 真库 live e2e),分三批合入 origin/main:
| 批次 | 内容 | merge |
|---|---|---|
| 1 | SQLi 参数门(模板引用名白名单 + 字符白名单值校验 + 身份/数据域注入)/ IDOR 对象级菜单授权 / XXE(字节级拒 DOCTYPE,防 BOM/UTF-16 绕过)/ 渲染并发闸(429) / 产物字节上限(413) / DB `statement_timeout`+`socketTimeout` / 错误响应通用化 | `e6c73a4` |
| 2 | 残留收口:结果集 `maxResultBuffer` 驱动层封顶(防 `TYPE_SCROLL_INSENSITIVE` 全量物化 OOM)+ 多值 `IN (${LIST})` 逗号放行 | `dccca17` |
| 3 | CVE 依赖替换(commons-collections 3.0→3.2.2 / log4j 1.2.8→reload4j 1.2.25,引擎 jar 不可改但依赖可换)+ 报表只读数据源(`eip4.report.db.*`,未配回落主源,向后兼容)+ 只读账号 GRANT/巡检 SQL | `d697885` |
**审计头号风险**:报表 SQL 的 `${PARAM}` 经 jatools `evalTemplate` **字符串拼接**进 SQL 后 `prepareStatement` 执行(无占位符绑定)→ 全参数 SQL 注入。引擎为预编译 jar 不可改,故全部在包装层收口(`ReportParamGuard` 等 11 个类、79 单测)。
**关键验证**:数值上下文注入 `?PROJECTID=0 union select…` → 400;IDOR 非超管越权 → 403、超管 bypass → 200;`maxResultBuffer` 经独立 JDBC 探针在同款 `TYPE_SCROLL_INSENSITIVE` 路径实证超限即抛非 OOM;CVE 替换后依赖树/运行时 classpath 实证生效、live HTML/PDF=200 无 ClassNotFound。
**仍开口(引擎/部署层)**:凭据外泄不可在渲染层修(模板 `<Connection>` 经同一 `property("DBPassword")` 解析口令,巡检脚本实测当前 326 模板 0 处泄露)→ 真 containment = 只读 DB 账号(脚本已交付 `platform-report/docs/security/`,待运维执行并配 `eip4.report.db.*`);结果集 OOM 对多并发非完全封顶(`maxResultBuffer` 是单查询上限×并发数);裸 `DriverManager` 连接池化未做;`bsh`(jatools fork)/`itext`(只生成不解析 PDF)/`xerces 2.6.2`(XXE 已被前置 DOCTYPE 拒绝兜住) 三 CVE 件不可换,已记录理由。
---
*本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。架构改进待办见 §10(2026-06-24 并入,取代已删除的《EIP4 架构分析与改进建议》)。*

View File

@@ -0,0 +1,21 @@
# flowable-service 生产镜像(A10 W2)。
# 前置:先 `mvn -pl flowable-service -am package -DskipTests` 产出 fat jar(见 deploy/README.md)。
FROM eclipse-temurin:21-jre
WORKDIR /app
COPY target/flowable-service-*.jar /app/app.jar
RUN useradd -r -u 10002 eip4flw \
&& chown -R 10002:10002 /app
USER 10002
ENV SPRING_PROFILES_ACTIVE=prod \
SERVER_PORT=8089 \
JAVA_OPTS=""
EXPOSE 8089
# flowable-service 未配 actuator,健康探针用 TCP 端口可达(bash /dev/tcp,temurin 基础镜像自带 bash)。
HEALTHCHECK --interval=15s --timeout=5s --start-period=90s --retries=12 \
CMD bash -c "echo > /dev/tcp/127.0.0.1/${SERVER_PORT}" || exit 1
ENTRYPOINT ["sh", "-c", "exec java $JAVA_OPTS -jar /app/app.jar"]

View File

@@ -38,9 +38,11 @@ import com.dsasp.server.wf.support.WfTypes;
* 仅用其 processInstanceId,经引擎运行时反查,避免对实现类的硬转型,与 PoC 桩同口径)。</li> * 仅用其 processInstanceId,经引擎运行时反查,避免对实现类的硬转型,与 PoC 桩同口径)。</li>
* </ol> * </ol>
* *
* <p><b>当前未接入的分支(WARN 降级,报告登记):</b>{@code scriptUser}(JUEL 脚本,26 处, * <p><b>分支覆盖现状:</b>{@code scriptUser}(JUEL 脚本)已于 2026-06-26 接入
* 需服务流脚本引擎,超独立服务精简边界)、{@code agentService} 代理人替换后处理(项目定制扩展)。 * {@link #resolveScriptUsers}(单变量直读流程变量 + 复杂表达式回退引擎 ExpressionManager 求值
* 占主导的 user/position/depart/formSpecifiedDimension/initiator 等类型(实测分布见报告)全部覆盖。</p> * + coerceUserList 归一,支撑招投标/总包合同/施工技术交底等会签流的 {@code ${APPLYUSERS}});
* 占主导的 user/position/depart/formSpecifiedDimension/initiator 等类型(实测分布见报告)全部覆盖。
* <b>仍未接入:</b>{@code agentService} 代理人替换后处理(项目定制扩展,WARN 降级)。</p>
*/ */
public class CandidateUsersHandler { public class CandidateUsersHandler {
@@ -86,11 +88,11 @@ public class CandidateUsersHandler {
? WfTypes.INITIATORLEADER : WfTypes.INITIATORDEPARTMANAGER; ? WfTypes.INITIATORLEADER : WfTypes.INITIATORDEPARTMANAGER;
users = directory.assignmentUser(t, userProperty.getContent(), beforeUser, null); users = directory.assignmentUser(t, userProperty.getContent(), beforeUser, null);
}else if(WfTypes.SCRIPTUSER.equals(userProperty.getType())){ }else if(WfTypes.SCRIPTUSER.equals(userProperty.getType())){
// 原版经 ScriptingEngines.evaluate(content,"juel",execution) 求值; // scriptUser:content 为 JUEL 表达式(会签等多实例办理人集合多用此类型,绝大多数形如 ${VARNAME},
// 独立服务不内置服务流脚本引擎(精简边界),WARN 降级,报告登记。 // 如招投标/总包合同/施工技术交底会签的 ${APPLYUSERS})。原版经服务流脚本引擎求值;此处优先按
log.warn("candidateUsersHandler: scriptUser(JUEL 脚本)分支独立服务暂未接入,跳过该项" // 单变量名直读流程变量(稳,无命令上下文依赖),复杂表达式回退 flowable 表达式管理器对 execution 求值,
+ "(影响面≈0.5%/26 处;命中则该任务无此类候选人,生产可监控)"); // 结果按 List/数组/逗号分隔串/单值归一为 userId 列表。修复前此分支 WARN 降级返空 → 这类会签节点无办理人被跳过。
users = new ArrayList<String>(); users = resolveScriptUsers(runtimeService, processInstanceId, execution, userProperty.getContent());
}else if(WfTypes.PROJECTROLETYPE.equals(userProperty.getType())){ }else if(WfTypes.PROJECTROLETYPE.equals(userProperty.getType())){
users = directory.getUsersByProjectRole(projectId, userProperty.getContent()); users = directory.getUsersByProjectRole(projectId, userProperty.getContent());
} }
@@ -207,6 +209,93 @@ public class CandidateUsersHandler {
} }
} }
/** {@code ${VAR}} 单变量名匹配(会签 scriptUser 绝大多数为此形态)。 */
private static final java.util.regex.Pattern SINGLE_VAR =
java.util.regex.Pattern.compile("\\$\\{\\s*([A-Za-z_][A-Za-z0-9_]*)\\s*\\}");
/**
* scriptUser 类型办理人解析:content 为 JUEL 表达式。绝大多数(含会签 {@code ${APPLYUSERS}})是单变量名,
* 优先直读该流程变量(稳,无命令上下文依赖);非单变量的复杂表达式回退 flowable 表达式管理器对 execution 求值。
* 结果按 List/数组/逗号分号(全/半角)分隔串/单值归一为去重 userId 列表;解析不出返回空(安全降级)。
*/
protected List<String> resolveScriptUsers(RuntimeService runtimeService, String processInstanceId,
Object execution, String content) {
if (content == null || content.isBlank()) {
return new ArrayList<String>();
}
Object value = null;
String varName = singleVarName(content);
if (varName != null && runtimeService != null && processInstanceId != null) {
value = getVariable(runtimeService, processInstanceId, varName);
}
if (value == null) {
value = evalExpression(execution, content);
}
List<String> users = coerceUserList(value);
if (users.isEmpty()) {
log.warn("candidateUsersHandler: scriptUser 表达式解析出空候选人 content={}(检查流程变量是否已设置)", content);
}
return users;
}
/** 单变量表达式 {@code ${VAR}} → 变量名;非单变量(复杂表达式/含运算)返回 null。 */
static String singleVarName(String content) {
if (content == null) {
return null;
}
java.util.regex.Matcher m = SINGLE_VAR.matcher(content.trim());
return m.matches() ? m.group(1) : null;
}
/** 把表达式求值结果归一为去重 userId 列表:支持 Collection/数组/逗号分号(全角半角)分隔串/单值。 */
static List<String> coerceUserList(Object value) {
List<String> out = new ArrayList<String>();
if (value == null) {
return out;
}
if (value instanceof java.util.Collection<?> col) {
for (Object o : col) {
addUser(out, o);
}
} else if (value instanceof Object[] arr) {
for (Object o : arr) {
addUser(out, o);
}
} else if (value instanceof String s) {
for (String part : s.split("[,;,;\\s]+")) {
addUser(out, part);
}
} else {
addUser(out, value);
}
return out;
}
private static void addUser(List<String> out, Object o) {
if (o == null) {
return;
}
String s = o.toString().trim();
if (!s.isEmpty() && !out.contains(s)) {
out.add(s);
}
}
/** 复杂 JUEL 表达式回退:命令上下文内经 flowable 表达式管理器对 execution(VariableScope)求值。 */
private Object evalExpression(Object execution, String content) {
try {
if (execution instanceof org.flowable.variable.api.delegate.VariableScope vs) {
var pec = org.flowable.engine.impl.context.Context.getProcessEngineConfiguration();
if (pec != null) {
return pec.getExpressionManager().createExpression(content).getValue(vs);
}
}
} catch (Exception e) {
log.warn("candidateUsersHandler: scriptUser 复杂表达式求值失败 content={}: {}", content, e.toString());
}
return null;
}
private static boolean isEmpty(String s) { private static boolean isEmpty(String s) {
return s == null || s.trim().isEmpty(); return s == null || s.trim().isEmpty();
} }

View File

@@ -26,4 +26,10 @@ public class ApprovalContextDto {
public boolean ended; public boolean ended;
/** 任务/实例是否挂起(挂起不可办理)。 */ /** 任务/实例是否挂起(挂起不可办理)。 */
public boolean suspended; public boolean suspended;
/** 是否会签(BPMN 多实例)任务:true 时下面三个计数有效,前端显「已会签 N/M」。 */
public boolean cosign;
/** 会签总人数(多实例 nrOfInstances)。 */
public int cosignTotal;
/** 会签已完成人数(多实例 nrOfCompletedInstances)。 */
public int cosignCompleted;
} }

View File

@@ -0,0 +1,134 @@
package com.eip4.flowservice.api;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.Map;
import java.util.Set;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* BPMN id 净化/还原(可逆双射)。
*
* <p>迁移的 1512 个真实流程里,1445 个的 process id 就是中文(如「总包合同交底」),BPMN 常把中文用作
* process/diagram/节点 id。bpmn-js / moddle 的 NCName 校验拒非 ASCII id → 整图无法渲染,且 moddle-xml
* 在 import 前就会拒中文 id。{@link #sanitize} 把非法(非 ASCII NCName)id 及其全部引用一致重写为安全
* ASCII id(稳定哈希),保存原→净化映射;{@link #restore} 依映射逆向还原——发布存量流程时把中文原 key
* 原样写回引擎,保证 process key 不变(D7 硬需求)。</p>
*
* <p><b>双射保证</b>:同一文档内两个不同中文 id 若哈希相同(Java String.hashCode 存在碰撞),基名冲突时
* 追加 {@code -2}/{@code -3} 序号;生成的净化 id 亦不与文档内既有合法 id 冲突。故净化后引用不串、restore
* 可精确逆向。<b>非碰撞场景</b>下净化输出与历史实现({@code "n"+hex(hashCode)})逐字节一致,保住查看器回归。</p>
*
* <p><b>restore 前缀安全</b>:还原一律复用 {@link #ID_ATTR} 正则逐个属性值精确匹配,绝不裸 {@code String.replace}
* 子串替换——否则净化 id {@code n1} 会误伤前缀相同的 {@code n1x}。映射外的 id(如设计器新增的 ASCII 节点)原样保留。</p>
*/
final class BpmnIdSanitizer {
private BpmnIdSanitizer() {
}
/** id/引用类属性(值须为合法 NCName);name/value 等展示属性不在内,避免改坏中文节点名。 */
static final Pattern ID_ATTR = Pattern.compile(
"\\b(id|bpmnElement|sourceRef|targetRef|attachedToRef|processRef|default)\\s*=\\s*\"([^\"]+)\"");
/** 净化结果:{@code xml}=净化后 XML;{@code idMap}=原 id→净化 id(双射,供 {@link #restore} 逆向)。 */
record Result(String xml, Map<String, String> idMap) {
}
/**
* 把 BPMN 里非法(非 ASCII NCName)的 id 及其全部引用一致重写为安全 ASCII id。
* 只重写 id/引用类属性,name 等展示属性不动。返回净化 XML 与「原 id→净化 id」映射。
*/
static Result sanitize(String xml) {
if (xml == null || xml.isEmpty()) {
return new Result(xml, Map.of());
}
// 先登记文档内所有合法 id,占位保证生成的净化 id 不与既有合法 id 冲突(双射 + restore 安全)。
Set<String> used = new LinkedHashSet<>();
Matcher scanLegal = ID_ATTR.matcher(xml);
while (scanLegal.find()) {
String val = scanLegal.group(2);
if (isValidNcName(val)) {
used.add(val);
}
}
// 收集非法 id → 唯一净化 id;基名冲突(含 hash 碰撞)时追加 -2/-3… 保双射。
Map<String, String> map = new LinkedHashMap<>();
Matcher scan = ID_ATTR.matcher(xml);
while (scan.find()) {
String val = scan.group(2);
if (!isValidNcName(val) && !map.containsKey(val)) {
String base = "n" + Integer.toHexString(val.hashCode() & 0x7fffffff);
String safe = base;
int seq = 2;
while (used.contains(safe)) {
safe = base + "-" + seq++;
}
map.put(val, safe);
used.add(safe);
}
}
if (map.isEmpty()) {
return new Result(xml, Map.of());
}
return new Result(rewrite(xml, map), map);
}
/**
* 依 {@code idMap}(原→净化)逆向还原:把净化 id 精确写回原 id。映射外的 id(如新增 ASCII 节点)原样保留。
* 逐个属性值精确匹配(复用 {@link #ID_ATTR}),前缀安全。
*/
static String restore(String xml, Map<String, String> idMap) {
if (xml == null || xml.isEmpty() || idMap == null || idMap.isEmpty()) {
return xml;
}
// 反转前校验双射:idMap 值(净化 id)重复会让 inverse 静默覆盖 → 还原错。fail-fast
// (T2.1 起 idMap 从 metaInfo JSON 反序列化,损坏数据须炸不能静默还原成别的 key)。
Map<String, String> inverse = new LinkedHashMap<>();
for (Map.Entry<String, String> e : idMap.entrySet()) {
String clash = inverse.put(e.getValue(), e.getKey());
if (clash != null) {
throw new IllegalArgumentException("idMap 非双射:净化 id \"" + e.getValue()
+ "\" 同时映射自 \"" + clash + "\" 与 \"" + e.getKey() + "\"");
}
}
return rewrite(xml, inverse);
}
/**
* 逐个 id/引用类属性值按 {@code map} 精确替换(命中才换,未命中原样)。前缀安全:只锚定完整属性值。
* 未改值的属性原样回写(append group(0) 原文),不重构 → 不归一 {@code id = "x"} 这类等号周围空白,保逐字节契约。
*/
private static String rewrite(String xml, Map<String, String> map) {
Matcher rw = ID_ATTR.matcher(xml);
StringBuilder sb = new StringBuilder();
while (rw.find()) {
String val = rw.group(2);
String repl = map.getOrDefault(val, val);
String replacement = repl.equals(val) ? rw.group(0) : rw.group(1) + "=\"" + repl + "\"";
rw.appendReplacement(sb, Matcher.quoteReplacement(replacement));
}
rw.appendTail(sb);
return sb.toString();
}
/** ASCII NCName:首字符字母/下划线,其余字母/数字/下划线/连字符/点;非 ASCII(中文等)视为非法。 */
private static boolean isValidNcName(String s) {
if (s == null || s.isEmpty()) {
return false;
}
char c0 = s.charAt(0);
if (!((c0 >= 'A' && c0 <= 'Z') || (c0 >= 'a' && c0 <= 'z') || c0 == '_')) {
return false;
}
for (int i = 1; i < s.length(); i++) {
char c = s.charAt(i);
if (!((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9')
|| c == '_' || c == '-' || c == '.')) {
return false;
}
}
return true;
}
}

View File

@@ -3,9 +3,11 @@ package com.eip4.flowservice.api;
import java.util.ArrayList; import java.util.ArrayList;
import java.util.List; import java.util.List;
import java.util.Map; import java.util.Map;
import java.util.Set;
import java.util.stream.Collectors; import java.util.stream.Collectors;
import org.flowable.engine.HistoryService; import org.flowable.engine.HistoryService;
import org.flowable.engine.IdentityService;
import org.flowable.engine.RepositoryService; import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService; import org.flowable.engine.RuntimeService;
import org.flowable.engine.TaskService; import org.flowable.engine.TaskService;
@@ -37,11 +39,17 @@ public class FlowController {
/** 默认审批流程 key:命名流程定义未部署时回退到此,保「提交审批」闭环可走(dev 无客户 BPMN 时)。 */ /** 默认审批流程 key:命名流程定义未部署时回退到此,保「提交审批」闭环可走(dev 无客户 BPMN 时)。 */
private static final String DEFAULT_APPROVAL_KEY = "EIP4_DEFAULT_APPROVAL"; private static final String DEFAULT_APPROVAL_KEY = "EIP4_DEFAULT_APPROVAL";
private static final int STATUS_PROCESSING = 2;
/** 协办/转阅单次最多派发人数(防滥用刷任务,对齐人工选人场景的合理上限)。 */
private static final int MAX_FANOUT = 50;
private static final Set<String> WITHDRAW_COMMENT_WHITELIST =
Set.of("回退", "主动召回", "更换任务处理人员");
private final TaskService taskService; private final TaskService taskService;
private final RuntimeService runtimeService; private final RuntimeService runtimeService;
private final HistoryService historyService; private final HistoryService historyService;
private final RepositoryService repositoryService; private final RepositoryService repositoryService;
private final IdentityService identityService;
private final JdbcTemplate bizJdbc; private final JdbcTemplate bizJdbc;
private final com.eip4.flowservice.wf.FormKeyResolver formKeyResolver; private final com.eip4.flowservice.wf.FormKeyResolver formKeyResolver;
private final com.eip4.flowservice.wf.StartFormKeyResolver startFormKeyResolver; private final com.eip4.flowservice.wf.StartFormKeyResolver startFormKeyResolver;
@@ -49,22 +57,23 @@ public class FlowController {
@org.springframework.beans.factory.annotation.Autowired @org.springframework.beans.factory.annotation.Autowired
public FlowController(TaskService taskService, RuntimeService runtimeService, public FlowController(TaskService taskService, RuntimeService runtimeService,
HistoryService historyService, RepositoryService repositoryService, HistoryService historyService, RepositoryService repositoryService,
JdbcTemplate bizJdbc, com.eip4.flowservice.wf.FormKeyResolver formKeyResolver, IdentityService identityService, JdbcTemplate bizJdbc, com.eip4.flowservice.wf.FormKeyResolver formKeyResolver,
com.eip4.flowservice.wf.StartFormKeyResolver startFormKeyResolver) { com.eip4.flowservice.wf.StartFormKeyResolver startFormKeyResolver) {
this.taskService = taskService; this.taskService = taskService;
this.runtimeService = runtimeService; this.runtimeService = runtimeService;
this.historyService = historyService; this.historyService = historyService;
this.repositoryService = repositoryService; this.repositoryService = repositoryService;
this.identityService = identityService;
this.bizJdbc = bizJdbc; this.bizJdbc = bizJdbc;
this.formKeyResolver = formKeyResolver; this.formKeyResolver = formKeyResolver;
this.startFormKeyResolver = startFormKeyResolver; this.startFormKeyResolver = startFormKeyResolver;
} }
/** 兼容老单测的五参构造(无解析器:就地构造)。生产由 Spring 走七参构造。 */ /** 兼容老单测的五参构造(无解析器:就地构造)。生产由 Spring 走八参构造。 */
public FlowController(TaskService taskService, RuntimeService runtimeService, public FlowController(TaskService taskService, RuntimeService runtimeService,
HistoryService historyService, RepositoryService repositoryService, HistoryService historyService, RepositoryService repositoryService,
JdbcTemplate bizJdbc) { JdbcTemplate bizJdbc) {
this(taskService, runtimeService, historyService, repositoryService, bizJdbc, this(taskService, runtimeService, historyService, repositoryService, null, bizJdbc,
new com.eip4.flowservice.wf.FormKeyResolver(historyService), new com.eip4.flowservice.wf.FormKeyResolver(historyService),
new com.eip4.flowservice.wf.StartFormKeyResolver(repositoryService)); new com.eip4.flowservice.wf.StartFormKeyResolver(repositoryService));
} }
@@ -207,11 +216,44 @@ public class FlowController {
} }
} }
@GetMapping("/process/started")
@Operation(summary = "我发起的流程实例",
description = "按 startedBy 查询历史流程实例,返回流程实例、业务主键、起止时间与当前活动任务。"
+ "供转换页「我的发起任务」聚合成 VIEW_ACT_PROCESS_* 旧字段。")
public List<ProcessInstanceDto> started(
@RequestParam(required = false) String startedBy,
@RequestParam(defaultValue = "0") int firstResult,
@RequestParam(defaultValue = "50") int maxResults) {
var q = historyService.createHistoricProcessInstanceQuery();
if (startedBy != null && !startedBy.isBlank()) {
q = q.startedBy(startedBy.trim());
}
return q.orderByProcessInstanceStartTime().desc()
.listPage(firstResult, maxResults)
.stream()
.map(hpi -> {
ProcessInstance runtime = runtimeService.createProcessInstanceQuery()
.processInstanceId(hpi.getId()).singleResult();
List<org.flowable.task.api.Task> activeTasks = taskService.createTaskQuery()
.processInstanceId(hpi.getId()).active().list();
return ProcessInstanceDto.of(hpi, runtime, activeTasks);
})
.collect(Collectors.toList());
}
@PostMapping("/process/start") @PostMapping("/process/start")
@Operation(summary = "发起流程", description = "按 processDefinitionKey 或 processDefinitionId 发起,可带 businessKey 与变量") @Operation(summary = "发起流程", description = "按 processDefinitionKey 或 processDefinitionId 发起,可带 businessKey 与变量")
public ResponseEntity<ProcessInstanceDto> start(@RequestBody Requests.StartRequest req) { public ResponseEntity<ProcessInstanceDto> start(@RequestBody Requests.StartRequest req) {
if (req == null) {
return ResponseEntity.badRequest().build();
}
ProcessInstance pi; ProcessInstance pi;
String startUserId = trimToNull(req.startUserId);
boolean bindStartUser = identityService != null && startUserId != null;
try { try {
if (bindStartUser) {
identityService.setAuthenticatedUserId(startUserId);
}
if (req.processDefinitionId != null && !req.processDefinitionId.isBlank()) { if (req.processDefinitionId != null && !req.processDefinitionId.isBlank()) {
pi = runtimeService.startProcessInstanceById(req.processDefinitionId, req.businessKey, req.variables); pi = runtimeService.startProcessInstanceById(req.processDefinitionId, req.businessKey, req.variables);
} else if (req.processDefinitionKey != null && !req.processDefinitionKey.isBlank()) { } else if (req.processDefinitionKey != null && !req.processDefinitionKey.isBlank()) {
@@ -237,6 +279,10 @@ public class FlowController {
"[起流失败] key={} id={} bizKey={} 变量类型[{}]: {}", "[起流失败] key={} id={} bizKey={} 变量类型[{}]: {}",
req.processDefinitionKey, req.processDefinitionId, req.businessKey, varTypes, e.toString(), e); req.processDefinitionKey, req.processDefinitionId, req.businessKey, varTypes, e.toString(), e);
throw e; throw e;
} finally {
if (bindStartUser) {
identityService.setAuthenticatedUserId(null);
}
} }
return ResponseEntity.ok(ProcessInstanceDto.of(pi)); return ResponseEntity.ok(ProcessInstanceDto.of(pi));
} }
@@ -305,6 +351,83 @@ public class FlowController {
return ResponseEntity.noContent().build(); return ResponseEntity.noContent().build();
} }
@PostMapping("/process/{processInstanceId}/delete-history")
@Operation(summary = "删除已结束历史流程实例",
description = "对齐老 ProcessCoreService.dleteCompleteProcessInstance:仅允许删除已结束的历史流程实例;"
+ "运行中实例返回 409,避免审批表单删除页误删活动流程。")
public ResponseEntity<Map<String, Object>> deleteHistoricProcessInstance(@PathVariable String processInstanceId) {
String pid = trimToNull(processInstanceId);
if (pid == null) {
return ResponseEntity.badRequest().body(errorBody("processInstanceId 不能为空"));
}
ProcessInstance runtime = runtimeService.createProcessInstanceQuery()
.processInstanceId(pid).singleResult();
if (runtime != null) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("流程未结束,不能删除审批表单"));
}
var hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(pid).singleResult();
if (hpi == null) {
return ResponseEntity.notFound().build();
}
if (hpi.getEndTime() == null) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("流程未结束,不能删除审批表单"));
}
String businessKey = hpi.getBusinessKey();
historyService.deleteHistoricProcessInstance(pid);
Map<String, Object> resp = new java.util.LinkedHashMap<>();
resp.put("deleted", true);
resp.put("processInstanceId", pid);
resp.put("businessKey", businessKey);
return ResponseEntity.ok(resp);
}
@PostMapping("/process/{processInstanceId}/terminate")
@Operation(summary = "结束运行中流程实例",
description = "对齐老 ProcessMonitorComponentNew:流程监控页按实例结束活动流程。仅运行中且有活动任务的流程可结束;"
+ "操作会记录流程评论、设置 approveResult=invalid,并 deleteProcessInstance。")
public ResponseEntity<Map<String, Object>> terminateProcessInstance(@PathVariable String processInstanceId,
@RequestBody(required = false) Requests.ActionRequest req) {
String pid = trimToNull(processInstanceId);
if (pid == null) {
return ResponseEntity.badRequest().body(errorBody("processInstanceId 不能为空"));
}
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(pid).singleResult();
if (pi == null) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("该流程已结束"));
}
List<org.flowable.task.api.Task> activeTasks = taskService.createTaskQuery()
.processInstanceId(pid).active().list();
if (activeTasks == null || activeTasks.isEmpty()) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("该流程已结束"));
}
String comment = firstNonBlank(req == null ? null : req.comment, "流程有误作废处理");
for (org.flowable.task.api.Task task : activeTasks) {
if (task.getId() != null) {
taskService.addComment(task.getId(), pid, comment);
}
}
try {
runtimeService.setVariable(pid, "approveResult", "invalid");
} catch (RuntimeException ignore) {
/* 变量写入失败不阻断终止 */
}
String businessKey = pi.getBusinessKey();
runtimeService.deleteProcessInstance(pid, comment);
Map<String, Object> resp = new java.util.LinkedHashMap<>();
resp.put("terminated", true);
resp.put("processEnded", true);
resp.put("processInstanceId", pid);
resp.put("businessKey", businessKey);
resp.put("activeTaskCount", activeTasks.size());
return ResponseEntity.ok(resp);
}
@PostMapping("/tasks/{taskId}/delegate") @PostMapping("/tasks/{taskId}/delegate")
@Operation(summary = "委托任务", description = "委托给指定用户:assignee 变为受托人,owner 记原办理人") @Operation(summary = "委托任务", description = "委托给指定用户:assignee 变为受托人,owner 记原办理人")
public ResponseEntity<TaskDto> delegate(@PathVariable String taskId, @RequestBody Requests.DelegateRequest req) { public ResponseEntity<TaskDto> delegate(@PathVariable String taskId, @RequestBody Requests.DelegateRequest req) {
@@ -316,6 +439,168 @@ public class FlowController {
return ResponseEntity.ok(t != null ? TaskDto.of(t) : null); return ResponseEntity.ok(t != null ? TaskDto.of(t) : null);
} }
@PostMapping("/tasks/{taskId}/assist")
@org.springframework.transaction.annotation.Transactional
@Operation(summary = "协办(加签)",
description = "对齐老 ProcessCoreServiceImpl.createSubTask:为每个目标用户建一条独立子任务"
+ "(assignee=该用户,parentTaskId=当前任务,name=协办,formKey=父任务formKey 以便协办人渲染业务单据),父任务记意见。"
+ "子任务进协办人待办,办毕各自 complete,不阻断主任务办理。父任务不存在 → 404,targetUserIds 为空 → 400,超 "
+ MAX_FANOUT + " 人 → 400。整批 @Transactional 原子。")
public ResponseEntity<Map<String, Object>> assist(@PathVariable String taskId,
@RequestBody(required = false) Requests.ActionRequest req) {
List<String> userIds = targetUserIds(req);
ResponseEntity<Map<String, Object>> bad = validateFanout(userIds, "协办");
if (bad != null) {
return bad;
}
var parent = taskService.createTaskQuery().taskId(taskId).singleResult();
if (parent == null) {
return ResponseEntity.notFound().build();
}
// 协办子任务也带 formKey(取父任务 formKey),使协办人打开能渲染同一业务单据。
String formKey = formKeyResolver.resolve(parent.getFormKey(),
parent.getProcessDefinitionId(), parent.getTaskDefinitionKey());
addCommentIfPresent(taskId, parent, req == null ? null : req.comment);
for (String userId : userIds) {
org.flowable.task.api.Task sub = taskService.newTask();
sub.setAssignee(userId);
sub.setParentTaskId(taskId);
sub.setName("协办");
if (formKey != null) {
sub.setFormKey(formKey);
}
taskService.saveTask(sub);
}
Map<String, Object> r = new java.util.LinkedHashMap<>();
r.put("assisted", true);
r.put("count", userIds.size());
r.put("taskId", taskId);
return ResponseEntity.ok(r);
}
@PostMapping("/tasks/{taskId}/circulate")
@org.springframework.transaction.annotation.Transactional
@Operation(summary = "转阅(抄送)",
description = "对齐老 ProcessCoreServiceImpl.createNewTask:为每个目标用户建一条只读转阅任务"
+ "(name=转阅,assignee=该用户,parentTaskId=当前任务,formKey=父任务formKey 以便转阅人渲染同一业务单据)。"
+ "转阅不阻断、不推进主流程。父任务不存在 → 404,targetUserIds 为空 → 400,超 " + MAX_FANOUT
+ " 人 → 400。整批 @Transactional 原子。")
public ResponseEntity<Map<String, Object>> circulate(@PathVariable String taskId,
@RequestBody(required = false) Requests.ActionRequest req) {
List<String> userIds = targetUserIds(req);
ResponseEntity<Map<String, Object>> bad = validateFanout(userIds, "转阅");
if (bad != null) {
return bad;
}
var parent = taskService.createTaskQuery().taskId(taskId).singleResult();
if (parent == null) {
return ResponseEntity.notFound().build();
}
String formKey = formKeyResolver.resolve(parent.getFormKey(),
parent.getProcessDefinitionId(), parent.getTaskDefinitionKey());
addCommentIfPresent(taskId, parent, req == null ? null : req.comment);
for (String userId : userIds) {
org.flowable.task.api.Task copy = taskService.newTask();
copy.setName("转阅");
copy.setAssignee(userId);
// 用 setFormKey(而非塞 description)使审批渲染路径 FormKeyResolver 直接命中。
if (formKey != null) {
copy.setFormKey(formKey);
}
copy.setParentTaskId(taskId);
taskService.saveTask(copy);
}
Map<String, Object> r = new java.util.LinkedHashMap<>();
r.put("circulated", true);
r.put("count", userIds.size());
r.put("taskId", taskId);
return ResponseEntity.ok(r);
}
/** 协办/转阅派发人数校验:空 → 400「需指定」;超 {@link #MAX_FANOUT} → 400。合法返回 null。 */
private ResponseEntity<Map<String, Object>> validateFanout(List<String> userIds, String verb) {
if (userIds.isEmpty()) {
return ResponseEntity.badRequest().body(errorBody(verb + "需指定 targetUserIds"));
}
if (userIds.size() > MAX_FANOUT) {
return ResponseEntity.badRequest().body(errorBody(verb + "人数超过上限 " + MAX_FANOUT));
}
return null;
}
/** 协办/转阅目标用户:优先 targetUserIds 列表,回退单个 targetUserId;去空白去重。 */
private static List<String> targetUserIds(Requests.ActionRequest req) {
java.util.LinkedHashSet<String> set = new java.util.LinkedHashSet<>();
if (req != null && req.targetUserIds != null) {
for (String u : req.targetUserIds) {
if (u != null && !u.isBlank()) {
set.add(u.trim());
}
}
}
if (req != null && req.targetUserId != null && !req.targetUserId.isBlank()) {
set.add(req.targetUserId.trim());
}
return new java.util.ArrayList<>(set);
}
/** 父任务存在且意见非空时记入流程评论(对齐老 addComment:用父任务的 processInstanceId)。 */
private void addCommentIfPresent(String taskId, org.flowable.task.api.Task parent, String comment) {
if (parent != null && comment != null && !comment.isBlank()) {
taskService.addComment(taskId, parent.getProcessInstanceId(), comment);
}
}
/** 父任务回溯出的业务上下文(供协办/转阅独立任务渲染同一业务单据)。 */
private record ParentContext(String processInstanceId, String formKey,
String processDefinitionId, String taskDefinitionKey) {
}
/** 按 parentTaskId 取父任务的业务上下文:运行库优先,否则历史库;都查不到返回 null。 */
private ParentContext resolveParentContext(String parentTaskId) {
var p = taskService.createTaskQuery().taskId(parentTaskId).singleResult();
if (p != null) {
return new ParentContext(p.getProcessInstanceId(), p.getFormKey(),
p.getProcessDefinitionId(), p.getTaskDefinitionKey());
}
HistoricTaskInstance hp = historyService.createHistoricTaskInstanceQuery()
.taskId(parentTaskId).singleResult();
if (hp != null) {
return new ParentContext(hp.getProcessInstanceId(), hp.getFormKey(),
hp.getProcessDefinitionId(), hp.getTaskDefinitionKey());
}
return null;
}
private static boolean isBlank(String s) {
return s == null || s.isBlank();
}
/**
* 会签(BPMN 多实例)进度:沿执行树从任务执行向上找带 {@code nrOfInstances} 局部变量的多实例根执行,
* 读总人数/已完成数填入 dto(前端显「已会签 N/M」)。非多实例任务找不到 → 不改 dto(cosign=false)。
*/
private void fillCosign(ApprovalContextDto dto, String executionId) {
String execId = executionId;
for (int depth = 0; depth < 12 && !isBlank(execId); depth++) {
Map<String, Object> locals;
try {
locals = runtimeService.getVariablesLocal(execId);
} catch (RuntimeException e) {
return;
}
if (locals != null && locals.get("nrOfInstances") instanceof Number total) {
dto.cosign = true;
dto.cosignTotal = total.intValue();
dto.cosignCompleted = locals.get("nrOfCompletedInstances") instanceof Number done
? done.intValue() : 0;
return;
}
var exec = runtimeService.createExecutionQuery().executionId(execId).singleResult();
execId = exec != null ? exec.getParentId() : null;
}
}
@GetMapping("/tasks/{taskId}/approval-context") @GetMapping("/tasks/{taskId}/approval-context")
@Operation(summary = "任务审批上下文", @Operation(summary = "任务审批上下文",
description = "聚合返回 WfTemplate 驱动审批界面所需事实:formKey(=view_wftemplate_id,经 FormKeyResolver 历史回补)、" description = "聚合返回 WfTemplate 驱动审批界面所需事实:formKey(=view_wftemplate_id,经 FormKeyResolver 历史回补)、"
@@ -332,13 +617,49 @@ public class FlowController {
dto.processDefinitionId = t.getProcessDefinitionId(); dto.processDefinitionId = t.getProcessDefinitionId();
dto.taskDefinitionKey = t.getTaskDefinitionKey(); dto.taskDefinitionKey = t.getTaskDefinitionKey();
dto.suspended = t.isSuspended(); dto.suspended = t.isSuspended();
dto.formKey = formKeyResolver.resolve(t.getFormKey(), t.getProcessDefinitionId(), t.getTaskDefinitionKey()); fillCosign(dto, t.getExecutionId());
dto.startFormKey = startFormKeyResolver.resolve(t.getProcessDefinitionId());
ProcessInstance pi = runtimeService.createProcessInstanceQuery() String formKeyRaw = t.getFormKey();
.processInstanceId(t.getProcessInstanceId()).singleResult(); String procDefId = t.getProcessDefinitionId();
if (pi != null) { String taskDefKey = t.getTaskDefinitionKey();
dto.businessKey = pi.getBusinessKey(); String pid = t.getProcessInstanceId();
dto.ended = false;
// 协办/转阅是独立任务(无 processInstanceId/businessKey):沿 parentTaskId 回溯父任务取业务上下文,
// 使协办人/转阅人打开能渲染同一业务单据。同时避免下面用 null pid 查 runtime 抛 IllegalArgument。
if (isBlank(pid) && !isBlank(t.getParentTaskId())) {
ParentContext pc = resolveParentContext(t.getParentTaskId());
if (pc != null) {
pid = pc.processInstanceId();
if (isBlank(formKeyRaw)) {
formKeyRaw = pc.formKey();
}
if (isBlank(procDefId)) {
procDefId = pc.processDefinitionId();
}
if (isBlank(taskDefKey)) {
taskDefKey = pc.taskDefinitionKey();
}
dto.processInstanceId = pid; // 让前端轨迹/business-data 能定位父流程
}
}
dto.formKey = formKeyResolver.resolve(formKeyRaw, procDefId, taskDefKey);
dto.startFormKey = startFormKeyResolver.resolve(procDefId);
if (!isBlank(pid)) {
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(pid).singleResult();
if (pi != null) {
dto.businessKey = pi.getBusinessKey();
dto.ended = false;
} else {
// 父流程可能已进历史(协办/转阅后主流程已结束)
var hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(pid).singleResult();
if (hpi != null) {
dto.businessKey = hpi.getBusinessKey();
dto.ended = hpi.getEndTime() != null;
}
}
} }
return ResponseEntity.ok(dto); return ResponseEntity.ok(dto);
} }
@@ -452,6 +773,90 @@ public class FlowController {
return ResponseEntity.ok(r); return ResponseEntity.ok(r);
} }
@PostMapping("/process/{processInstanceId}/withdraw")
@Operation(summary = "发起人撤回",
description = "对齐老 MySendTaskComponent + activebackProcess:按流程实例找当前活动任务,"
+ "若已有非白名单审批意见则拒绝;否则移动回发起/起始节点、记「主动召回」评论并挂起流程实例。")
public ResponseEntity<Map<String, Object>> withdraw(@PathVariable String processInstanceId,
@RequestBody(required = false) Requests.ActionRequest req) {
String pid = processInstanceId == null ? "" : processInstanceId.trim();
if (pid.isBlank()) {
return ResponseEntity.badRequest().body(errorBody("processInstanceId 不能为空"));
}
List<org.flowable.task.api.Task> activeTasks = taskService.createTaskQuery()
.processInstanceId(pid).active().orderByTaskCreateTime().asc().list();
if (activeTasks == null || activeTasks.isEmpty()) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("该任务无法撤回,请检查!"));
}
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(pid).singleResult();
var hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(pid).singleResult();
String businessKey = firstNonBlank(pi == null ? null : pi.getBusinessKey(),
hpi == null ? null : hpi.getBusinessKey());
Integer status = businessStatus(businessKey);
if (status != null && status != STATUS_PROCESSING) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("该任务无法撤回,请检查!"));
}
if (hasDisallowedFlowComment(pid)) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("该任务已流转,无法撤回!"));
}
String targetKey = trimToNull(hpi == null ? null : hpi.getStartActivityId());
if (targetKey == null) {
targetKey = firstHistoricTaskKey(pid);
}
if (targetKey == null) {
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT)
.body(errorBody("该任务无法撤回,请检查!"));
}
String comment = firstNonBlank(req == null ? null : req.comment, "主动召回");
taskService.addComment(activeTasks.get(0).getId(), pid, comment);
try {
runtimeService.setVariable(pid, "approveResult", "withdraw");
} catch (RuntimeException ignore) {
/* 变量写入失败不阻断撤回 */
}
List<String> currentKeys = activeTasks.stream()
.map(org.flowable.task.api.Task::getTaskDefinitionKey)
.filter(s -> s != null && !s.isBlank())
.distinct()
.toList();
try {
if (!currentKeys.isEmpty()
&& !(currentKeys.size() == 1 && targetKey.equals(currentKeys.get(0)))) {
runtimeService.createChangeActivityStateBuilder()
.processInstanceId(pid)
.moveActivityIdsToSingleActivityId(currentKeys, targetKey)
.changeState();
}
if (pi == null || !pi.isSuspended()) {
runtimeService.suspendProcessInstanceById(pid);
}
} catch (RuntimeException e) {
org.slf4j.LoggerFactory.getLogger(FlowController.class)
.error("[撤回失败] pid={} active={} → {}: {}", pid, currentKeys, targetKey, e.toString());
Map<String, Object> err = errorBody("该任务无法撤回,请检查!");
err.put("detail", e.getMessage());
return ResponseEntity.status(org.springframework.http.HttpStatus.CONFLICT).body(err);
}
Map<String, Object> r = new java.util.LinkedHashMap<>();
r.put("withdrawn", true);
r.put("targetKey", targetKey);
r.put("businessKey", businessKey);
r.put("processInstanceId", pid);
return ResponseEntity.ok(r);
}
@GetMapping("/process/{processInstanceId}/trace") @GetMapping("/process/{processInstanceId}/trace")
@Operation(summary = "流程轨迹", description = "返回该流程实例所有历史任务节点(含当前活动节点),按开始时间升序。每节点包含办理人姓名(经 sys_user 反查)、审批意见(Flowable 评论)、办理结果变量。") @Operation(summary = "流程轨迹", description = "返回该流程实例所有历史任务节点(含当前活动节点),按开始时间升序。每节点包含办理人姓名(经 sys_user 反查)、审批意见(Flowable 评论)、办理结果变量。")
public ResponseEntity<List<TraceNodeDto>> trace(@PathVariable String processInstanceId) { public ResponseEntity<List<TraceNodeDto>> trace(@PathVariable String processInstanceId) {
@@ -557,6 +962,68 @@ public class FlowController {
} }
} }
private boolean hasDisallowedFlowComment(String processInstanceId) {
try {
List<org.flowable.engine.task.Comment> comments =
taskService.getProcessInstanceComments(processInstanceId, "comment");
if (comments == null) {
return false;
}
for (org.flowable.engine.task.Comment c : comments) {
String msg = trimToNull(c.getFullMessage());
if (msg != null && !WITHDRAW_COMMENT_WHITELIST.contains(msg)) {
return true;
}
}
} catch (RuntimeException ignored) {
return false;
}
return false;
}
private String firstHistoricTaskKey(String processInstanceId) {
List<HistoricTaskInstance> first = historyService.createHistoricTaskInstanceQuery()
.processInstanceId(processInstanceId).orderByHistoricTaskInstanceStartTime().asc().listPage(0, 1);
return first == null || first.isEmpty() ? null : trimToNull(first.get(0).getTaskDefinitionKey());
}
private Integer businessStatus(String businessKey) {
String bk = trimToNull(businessKey);
if (bk == null) {
return null;
}
try {
return bizJdbc.query(
"SELECT DATASTATUS FROM SYS_DATASTATUS WHERE BUSINESSKEY = ?",
rs -> rs.next() ? rs.getInt(1) : null,
bk);
} catch (RuntimeException ignored) {
return null;
}
}
private static String firstNonBlank(String... values) {
for (String value : values) {
String s = trimToNull(value);
if (s != null) {
return s;
}
}
return null;
}
private static String trimToNull(String value) {
String s = value == null ? null : value.trim();
return s == null || s.isBlank() ? null : s;
}
private static Map<String, Object> errorBody(String msg) {
Map<String, Object> err = new java.util.LinkedHashMap<>();
err.put("status", 1);
err.put("msg", msg);
return err;
}
@GetMapping("/process-definitions/count") @GetMapping("/process-definitions/count")
@Operation(summary = "流程定义计数", description = "启动后定义加载自检(预期 1,509)") @Operation(summary = "流程定义计数", description = "启动后定义加载自检(预期 1,509)")
public long processDefinitionCount() { public long processDefinitionCount() {

View File

@@ -0,0 +1,202 @@
package com.eip4.flowservice.api;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;
import org.flowable.engine.HistoryService;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.history.HistoricProcessInstance;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.engine.runtime.ProcessInstance;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.ResponseEntity;
import org.springframework.util.StreamUtils;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
/**
* 流程图(BPMN)查看端点:返回流程定义的 BPMN 2.0 XML + 当前/历史活动节点,供前端 bpmn-js 渲染并高亮。
*
* <p>迁移的 1512 个流程定义中 1501(99.3%)含 BPMNDI 布局段,bpmn-js 可直接据此排版。
* 节点名为中文 → 用前端 bpmn-js(浏览器字体)而非服务端出图(PNG 中文易乱码且需服务器字体)。</p>
*
* <p>只读:仅查询引擎,不改任何流程/任务/业务数据。运行中实例取运行库 procDefId 与当前节点;
* 已结束实例回退历史库取 procDefId(无当前节点)。实例不存在返回 {@code found=false}(前端降级)。</p>
*/
@RestController
@RequestMapping("/api/flow")
@Tag(name = "流程图", description = "BPMN XML + 当前/历史节点(bpmn-js 渲染高亮)")
public class ProcessDiagramController {
private static final Logger log = LoggerFactory.getLogger(ProcessDiagramController.class);
private final RepositoryService repositoryService;
private final RuntimeService runtimeService;
private final HistoryService historyService;
public ProcessDiagramController(RepositoryService repositoryService, RuntimeService runtimeService,
HistoryService historyService) {
this.repositoryService = repositoryService;
this.runtimeService = runtimeService;
this.historyService = historyService;
}
@GetMapping("/process/{processInstanceId}/diagram")
@Operation(summary = "流程图数据",
description = "返回 {found, bpmnXml, activeActivityIds(当前停留), finishedActivityIds(已走过)}。"
+ "运行中实例取运行库 procDefId + getActiveActivityIds;已结束取历史库 procDefId(无当前节点);"
+ "实例不存在 found=false。bpmnXml = repositoryService.getProcessModel(procDefId)。")
public ResponseEntity<Map<String, Object>> diagram(@PathVariable String processInstanceId) {
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("processInstanceId", processInstanceId);
// procDefId:运行库优先(含当前活动节点),否则历史库(已结束)
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
String procDefId = pi != null ? pi.getProcessDefinitionId() : null;
boolean running = pi != null;
if (procDefId == null) {
HistoricProcessInstance hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
procDefId = hpi != null ? hpi.getProcessDefinitionId() : null;
}
if (procDefId == null) {
resp.put("found", false);
resp.put("activeActivityIds", List.of());
resp.put("finishedActivityIds", List.of());
return ResponseEntity.ok(resp);
}
String bpmnXml = readProcessModel(procDefId);
if (bpmnXml == null) {
resp.put("found", false);
resp.put("activeActivityIds", List.of());
resp.put("finishedActivityIds", List.of());
return ResponseEntity.ok(resp);
}
// 当前停留节点(仅运行中实例有)
List<String> active = running ? safeActiveActivityIds(processInstanceId) : List.of();
// 已走过的历史节点
List<String> finished = historyService.createHistoricActivityInstanceQuery()
.processInstanceId(processInstanceId).finished().list().stream()
.map(a -> a.getActivityId())
.filter(id -> id != null && !id.isBlank())
.distinct()
.collect(Collectors.toList());
// 迁移的 BPMN 常用中文做 process/diagram id(如「招投标工程评审流程」),bpmn-js/moddle 的 NCName
// 校验拒非 ASCII id → 整图「no diagram to display」。服务端把非法 id 及其所有引用一致重写为安全 ASCII id
// (只动 id/ref 类属性,不碰 name;活动 id 多为 sid-* 合法),并同步重映射当前/历史节点 id。
List<String> mutableActive = new java.util.ArrayList<>(active);
List<String> mutableFinished = new java.util.ArrayList<>(finished);
String safeXml = sanitizeBpmnIds(bpmnXml, mutableActive, mutableFinished);
resp.put("found", true);
resp.put("bpmnXml", safeXml);
resp.put("activeActivityIds", mutableActive);
resp.put("finishedActivityIds", mutableFinished);
return ResponseEntity.ok(resp);
}
@GetMapping("/process-definitions/{procDefId}/source")
@Operation(summary = "按流程定义 id 取净化源 XML",
description = "返回 {procDefId, found, bpmnXml(净化后), idMap(原id→净化id), procDefKey, version},供 bpmn-js Modeler 在线编辑载入。"
+ "流程定义不存在 / BPMN 读取失败或为空 → found=false(HTTP 200,前端降级)。"
+ "中文 process id 经 BpmnIdSanitizer 可逆净化,idMap 供发布时逆向还原原 key(D7)。")
public ResponseEntity<Map<String, Object>> source(@PathVariable String procDefId) {
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
.processDefinitionId(procDefId).singleResult();
return sourceResponse(procDefId, def);
}
@GetMapping("/process-definitions/by-key/{key}/source")
@Operation(summary = "按流程 key 取最新版净化源 XML",
description = "返回与 by-id 端点完全相同的形状 {procDefId, found, bpmnXml, idMap, procDefKey, version},"
+ "供 Modeler 打开器按真流程 key 载入(process-select 的 source='model' 项 id 是 act_re_model id 而非 procDefId,"
+ "by-id 永远 found:false → 改用本端点)。processDefinitionKey(key).latestVersion() 取最新版,key 不存在 found:false。")
public ResponseEntity<Map<String, Object>> sourceByKey(@PathVariable String key) {
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
.processDefinitionKey(key).latestVersion().singleResult();
String procDefId = def == null ? null : def.getId();
return sourceResponse(procDefId, def);
}
/**
* 按已解析的流程定义构建源响应(by-id / by-key 共用,逻辑单一不复制):净化 XML + 原→净化 idMap + key/version。
* {@code def==null}(不存在)或 BPMN 空/读失败 → {@code found:false}(HTTP 200,前端降级)。
* {@code procDefId} 是读取部署 BPMN 资源用的定义 id(by-id=入参、by-key=解析出的最新版 id),命中时随响应回显。
*/
private ResponseEntity<Map<String, Object>> sourceResponse(String procDefId, ProcessDefinition def) {
Map<String, Object> resp = new LinkedHashMap<>();
if (procDefId != null) {
resp.put("procDefId", procDefId);
}
if (def == null) {
resp.put("found", false);
return ResponseEntity.ok(resp);
}
String bpmnXml = readProcessModel(procDefId);
if (bpmnXml == null || bpmnXml.isBlank()) {
log.warn("[流程源] BPMN 为空或读取失败 procDefId={}", procDefId);
resp.put("found", false);
return ResponseEntity.ok(resp);
}
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(bpmnXml);
resp.put("found", true);
resp.put("bpmnXml", r.xml());
resp.put("idMap", r.idMap());
resp.put("procDefKey", def.getKey());
resp.put("version", def.getVersion());
return ResponseEntity.ok(resp);
}
/**
* 把 BPMN 里非法(非 ASCII NCName)的 id 及其全部引用一致重写为安全 ASCII id,使 bpmn-js 能解析渲染,
* 并同步重映射 active/finished 节点 id。净化算法委托 {@link BpmnIdSanitizer}(含可逆映射与 hash 碰撞消解)。
*/
static String sanitizeBpmnIds(String xml, List<String> active, List<String> finished) {
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
Map<String, String> map = r.idMap();
active.replaceAll(id -> map.getOrDefault(id, id));
finished.replaceAll(id -> map.getOrDefault(id, id));
return r.xml();
}
/** 读流程定义 BPMN XML(getProcessModel 返回部署的 BPMN 资源流)。读失败返回 null(前端降级)。 */
private String readProcessModel(String procDefId) {
try (InputStream is = repositoryService.getProcessModel(procDefId)) {
if (is == null) {
return null;
}
return StreamUtils.copyToString(is, StandardCharsets.UTF_8);
} catch (Exception e) {
log.warn("[流程图] 读取 BPMN 失败 procDefId={}: {}", procDefId, e.toString());
return null;
}
}
/** getActiveActivityIds 对已结束/不存在实例会抛异常 → 包裹降级为空。 */
private List<String> safeActiveActivityIds(String processInstanceId) {
try {
List<String> ids = runtimeService.getActiveActivityIds(processInstanceId);
return ids == null ? List.of() : ids;
} catch (RuntimeException e) {
log.debug("[流程图] 取当前节点降级 pi={}: {}", processInstanceId, e.toString());
return List.of();
}
}
}

View File

@@ -1,6 +1,10 @@
package com.eip4.flowservice.api; package com.eip4.flowservice.api;
import java.util.List;
import org.flowable.engine.history.HistoricProcessInstance;
import org.flowable.engine.runtime.ProcessInstance; import org.flowable.engine.runtime.ProcessInstance;
import org.flowable.task.api.Task;
/** /**
* 流程实例 DTO(发起流程出参)。 * 流程实例 DTO(发起流程出参)。
@@ -9,7 +13,13 @@ public class ProcessInstanceDto {
public String id; public String id;
public String processDefinitionId; public String processDefinitionId;
public String processDefinitionKey; public String processDefinitionKey;
public String processDefinitionName;
public String businessKey; public String businessKey;
public String startUserId;
public Long startTimeMillis;
public Long endTimeMillis;
public List<String> activeTaskNames = List.of();
public List<String> activeTaskAssignees = List.of();
public boolean ended; public boolean ended;
public boolean suspended; public boolean suspended;
@@ -18,9 +28,40 @@ public class ProcessInstanceDto {
d.id = pi.getId(); d.id = pi.getId();
d.processDefinitionId = pi.getProcessDefinitionId(); d.processDefinitionId = pi.getProcessDefinitionId();
d.processDefinitionKey = pi.getProcessDefinitionKey(); d.processDefinitionKey = pi.getProcessDefinitionKey();
d.processDefinitionName = pi.getProcessDefinitionName();
d.businessKey = pi.getBusinessKey(); d.businessKey = pi.getBusinessKey();
d.startUserId = pi.getStartUserId();
d.startTimeMillis = pi.getStartTime() != null ? pi.getStartTime().getTime() : null;
d.ended = pi.isEnded(); d.ended = pi.isEnded();
d.suspended = pi.isSuspended(); d.suspended = pi.isSuspended();
return d; return d;
} }
public static ProcessInstanceDto of(HistoricProcessInstance hpi, ProcessInstance runtime,
List<Task> activeTasks) {
ProcessInstanceDto d = new ProcessInstanceDto();
d.id = hpi.getId();
d.processDefinitionId = hpi.getProcessDefinitionId();
d.processDefinitionKey = hpi.getProcessDefinitionKey();
d.processDefinitionName = hpi.getProcessDefinitionName();
d.businessKey = hpi.getBusinessKey();
d.startUserId = hpi.getStartUserId();
d.startTimeMillis = hpi.getStartTime() != null ? hpi.getStartTime().getTime() : null;
d.endTimeMillis = hpi.getEndTime() != null ? hpi.getEndTime().getTime() : null;
d.ended = hpi.getEndTime() != null;
d.suspended = runtime != null && runtime.isSuspended();
if (activeTasks != null && !activeTasks.isEmpty()) {
d.activeTaskNames = activeTasks.stream()
.map(Task::getName)
.filter(s -> s != null && !s.isBlank())
.distinct()
.toList();
d.activeTaskAssignees = activeTasks.stream()
.map(Task::getAssignee)
.filter(s -> s != null && !s.isBlank())
.distinct()
.toList();
}
return d;
}
} }

View File

@@ -0,0 +1,620 @@
package com.eip4.flowservice.api;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Date;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.regex.Pattern;
import java.util.stream.Collectors;
import org.flowable.bpmn.converter.BpmnXMLConverter;
import org.flowable.bpmn.model.BpmnModel;
import org.flowable.common.engine.impl.util.io.StringStreamSource;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.repository.Model;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.validation.ProcessValidator;
import org.flowable.validation.ProcessValidatorFactory;
import org.flowable.validation.ValidationError;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.util.StreamUtils;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
/**
* 流程草稿 CRUD(flowable 原生 Model API 存 act_re_model,本控制器为全仓首次启用 Model API)。
*
* <p>在线 Modeler 的草稿仓:编辑中的 BPMN 存为 flowable Model(editorSource=BPMN XML,metaInfo=EIP4 元数据 JSON),
* 不进部署库;发布(T3.1)时才 restore 中文原 key + 校验门 + deploy。act_re_model 表已有 143 行存量、schema 已在,
* {@code databaseSchemaUpdate=false} 不涉 DDL。</p>
*
* <p><b>存量隔离</b>:本控制器建的草稿一律 {@code setCategory("eip4")},{@link #list()} 只查该分类,
* 库里 143 条老 shape act_re_model(旧 metaInfo + 可能悬空 editorSource)不进 Modeler 列表、避免打不开。</p>
*
* <p>写入前 XML 一律过解析守卫({@link #parseGuard}):①字节级拒 DOCTYPE(XXE 门);②{@link BpmnXMLConverter}
* 以 {@code validateSchema=false}(草稿是半成品,不做严格 XSD——bpmn-js 默认命名空间输出与严格 XSD 已知固有不兼容,
* 完整校验属部署门)+ {@code enableSafeBpmnXml=true}(加固解析器,双保险防外部实体)解析。坏 XML 返 422 且绝不落库;
* 422 只回通用文案,原始解析原因仅进日志。守卫异常就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}
* (那里 FlowableException→400,语义不符)。
* {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法,
* 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿,
* 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。</p>
*
* <p><b>鉴权</b>:本控制器随 flowable-service 跑在裸 8089,进程本身无鉴权栈;所有写端点
* (POST/PUT/from-procdef)必须经 platform-flow-gateway 的超管门访问(T2.2),生产环境 8089 不对外暴露。</p>
*/
@RestController
@RequestMapping("/api/flow")
@Tag(name = "流程草稿", description = "flowable Model API 草稿 CRUD(act_re_model)+ 从流程定义建草稿")
public class ProcessModelController {
private static final Logger log = LoggerFactory.getLogger(ProcessModelController.class);
/** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */
static final String EIP4_CATEGORY = "eip4";
/** DOCTYPE 门 prolog 扫描字节上限(BOM/XML 声明/注释/DOCTYPE 都在最前)。 */
private static final int PROLOG_SCAN_BYTES = 8192;
/**
* bpmn-js {@code saveXML} 补的 {@code <*:incoming>/<*:outgoing>} 文本引用元素(前缀可选:bpmn/bpmn2/默认)。
* 发布前整体剥除——Flowable 从 {@code sequenceFlow} 的 sourceRef/targetRef 自行推导入出边,这些元素冗余;
* 且它们把节点/流 id 存为<b>元素文本</b>(非属性),{@link BpmnIdSanitizer#restore} 只还原属性位不碰文本
* → 不剥则落库「属性=中文原 key、文本引用=净化 id」的脏 XML(T1.3 评审 I-2)。
*/
private static final Pattern FLOW_REF_ELEMENT = Pattern.compile(
"<(?:[\\w.-]+:)?(?:incoming|outgoing)>[^<]*</(?:[\\w.-]+:)?(?:incoming|outgoing)>");
private final RepositoryService repositoryService;
private final RuntimeService runtimeService;
private final ProcessValidator processValidator;
private final ObjectMapper objectMapper = new ObjectMapper();
@Autowired
public ProcessModelController(RepositoryService repositoryService, RuntimeService runtimeService) {
this(repositoryService, runtimeService, new ProcessValidatorFactory().createDefaultProcessValidator());
}
/**
* 单参构造:既有草稿 CRUD 单测保留零改动地 {@code new ProcessModelController(repositoryService)}
* (那些用例不触发发布/影响路径,无需 RuntimeService/校验器)。
*/
ProcessModelController(RepositoryService repositoryService) {
this(repositoryService, null, new ProcessValidatorFactory().createDefaultProcessValidator());
}
/**
* 全参构造:发布/影响端点单测注入 <b>mock</b> {@link ProcessValidator}
* ({@code ProcessValidatorFactory} 产的默认校验器无法 mock,须构造注入以断言 ERROR-vs-WARNING 分支)。
*/
ProcessModelController(RepositoryService repositoryService, RuntimeService runtimeService,
ProcessValidator processValidator) {
this.repositoryService = repositoryService;
this.runtimeService = runtimeService;
this.processValidator = processValidator;
}
@GetMapping("/models")
@Operation(summary = "草稿列表",
description = "createModelQuery().modelCategory(\"eip4\").orderByLastUpdateTime().desc() → "
+ "{models:[{id,name,key,lastUpdateTime(ISO)}]}。只列 EIP4 建的草稿,隔离存量 act_re_model。")
public ResponseEntity<Map<String, Object>> list() {
List<Map<String, Object>> models = repositoryService.createModelQuery()
.modelCategory(EIP4_CATEGORY)
.orderByLastUpdateTime().desc().list().stream()
.map(m -> {
Map<String, Object> row = new LinkedHashMap<>();
row.put("id", m.getId());
row.put("name", m.getName());
row.put("key", m.getKey());
row.put("lastUpdateTime", toIso(m.getLastUpdateTime()));
return row;
})
.collect(Collectors.toList());
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("models", models);
return ResponseEntity.ok(resp);
}
@GetMapping("/models/{id}")
@Operation(summary = "取草稿",
description = "getModel + getModelEditorSource → {found,id,name,key,bpmnXml,metaInfo}。"
+ "草稿不存在或编辑源为空 → {found:false}(HTTP 200,前端降级)。")
public ResponseEntity<Map<String, Object>> get(@PathVariable String id) {
Map<String, Object> resp = new LinkedHashMap<>();
Model model = repositoryService.getModel(id);
if (model == null) {
resp.put("found", false);
return ResponseEntity.ok(resp);
}
byte[] source = repositoryService.getModelEditorSource(id);
if (source == null) {
resp.put("found", false);
return ResponseEntity.ok(resp);
}
resp.put("found", true);
resp.put("id", model.getId());
resp.put("name", model.getName());
resp.put("key", model.getKey());
resp.put("bpmnXml", new String(source, StandardCharsets.UTF_8));
resp.put("metaInfo", model.getMetaInfo());
return ResponseEntity.ok(resp);
}
@PostMapping("/models")
@Operation(summary = "建草稿",
description = "body {name,key,bpmnXml,metaInfo?}。name/key 空白→422;XML 过 BpmnXMLConverter 解析守卫"
+ "(坏 XML→422 不落库);过门后 newModel+setCategory(eip4)+saveModel+addModelEditorSource → {modelId}。")
public ResponseEntity<Map<String, Object>> create(@RequestBody CreateModelRequest req) {
// key 是 T3.1 部署资源名/中文原 key 还原的依赖,name 用于列表展示:空白一律拒。
if (isBlank(req.name) || isBlank(req.key)) {
return status(HttpStatus.UNPROCESSABLE_ENTITY, "name 与 key 不能为空");
}
ResponseEntity<Map<String, Object>> rejected = parseGuard(req.bpmnXml);
if (rejected != null) {
return rejected;
}
Model model = repositoryService.newModel();
model.setName(req.name);
model.setKey(req.key);
model.setCategory(EIP4_CATEGORY);
if (req.metaInfo != null) {
model.setMetaInfo(req.metaInfo);
}
repositoryService.saveModel(model);
repositoryService.addModelEditorSource(model.getId(), req.bpmnXml.getBytes(StandardCharsets.UTF_8));
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("modelId", model.getId());
return ResponseEntity.ok(resp);
}
@PutMapping("/models/{id}")
@Operation(summary = "更新草稿",
description = "草稿不存在→404;更新 name/metaInfo(仅当请求提供,避免覆盖 eip4IdMap)与 editorSource(XML 同守卫 422) → {status:0}。")
public ResponseEntity<Map<String, Object>> update(@PathVariable String id, @RequestBody UpdateModelRequest req) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
ResponseEntity<Map<String, Object>> rejected = parseGuard(req.bpmnXml);
if (rejected != null) {
return rejected;
}
if (req.name != null) {
model.setName(req.name);
}
// metaInfo 仅当请求显式提供时更新:草稿存 eip4IdMap 于 metaInfo,普通保存不重发 metaInfo 时不能抹掉它。
if (req.metaInfo != null) {
model.setMetaInfo(req.metaInfo);
}
repositoryService.saveModel(model);
repositoryService.addModelEditorSource(id, req.bpmnXml.getBytes(StandardCharsets.UTF_8));
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
return ResponseEntity.ok(resp);
}
@DeleteMapping("/models/{id}")
@Operation(summary = "删草稿",
description = "草稿不存在→404;存在则 deleteModel(id)(连带 editorSource/metaInfo 一并删) → {status:0}。")
public ResponseEntity<Map<String, Object>> delete(@PathVariable String id) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
repositoryService.deleteModel(id);
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
return ResponseEntity.ok(resp);
}
@PostMapping("/models/from-procdef")
@Operation(summary = "从流程定义建草稿",
description = "body {procDefId}。读部署 BPMN → BpmnIdSanitizer.sanitize 净化中文 id → 建草稿"
+ "(name/key=procDef,editorSource=净化 XML,metaInfo={eip4IdMap,sourceProcDefId,originalKey}) → {modelId}。"
+ "procDef 不存在或 BPMN 空 → {found:false}(HTTP 200,前端降级)。")
public ResponseEntity<Map<String, Object>> fromProcDef(@RequestBody FromProcDefRequest req) {
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
.processDefinitionId(req.procDefId).singleResult();
if (def == null) {
return found(false);
}
String bpmnXml = readProcessModel(req.procDefId);
if (bpmnXml == null || bpmnXml.isBlank()) {
return found(false);
}
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(bpmnXml);
Map<String, Object> meta = new LinkedHashMap<>();
meta.put("eip4IdMap", r.idMap());
meta.put("sourceProcDefId", req.procDefId);
meta.put("originalKey", def.getKey());
String metaInfoJson;
try {
metaInfoJson = objectMapper.writeValueAsString(meta);
} catch (Exception e) {
// 纯 Map<String,String/Object> 序列化理论上不会失败;防御性 500
log.error("[流程草稿] metaInfo 序列化失败 procDefId={}", req.procDefId, e);
return status(HttpStatus.INTERNAL_SERVER_ERROR, "metaInfo 序列化失败");
}
Model model = repositoryService.newModel();
model.setName(def.getName());
model.setKey(def.getKey());
model.setCategory(EIP4_CATEGORY);
model.setMetaInfo(metaInfoJson);
repositoryService.saveModel(model);
repositoryService.addModelEditorSource(model.getId(), r.xml().getBytes(StandardCharsets.UTF_8));
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("modelId", model.getId());
return ResponseEntity.ok(resp);
}
@PostMapping("/models/{id}/deploy")
@Operation(summary = "发布草稿为流程定义",
description = "草稿不存在→404;还原 eip4IdMap 里的中文原 key(存量流程 D7 硬需求,新建流程无 idMap 跳过)+"
+ "剥除 bpmn-js 补的 incoming/outgoing 文本引用 → 引擎 ProcessValidator 语义校验(仅 ERROR 级阻断,"
+ "返 422 {errors:[{activityId,problem,defaultDescription}]} 不部署;WARNING 放行)→ "
+ "createDeployment().disableSchemaValidation()(只跳 XSD:bpmn-js 默认命名空间与严格 XSD 已知不兼容,"
+ "语义校验已在上一步)部署 → {status:0,deploymentId,processKey,newVersion}。")
public ResponseEntity<Map<String, Object>> deploy(@PathVariable String id) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
byte[] source = repositoryService.getModelEditorSource(id);
if (source == null) {
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空,无法发布: " + id);
}
String deployXml;
BpmnModel bpmnModel;
try {
// resolveIdMap 在 try 内:存量草稿 metaInfo 不可读/丢 eip4IdMap 时 fail-fast(评审 I1),不静默跳过还原。
Map<String, String> idMap = resolveIdMap(model.getMetaInfo());
deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap);
// XXE 兜底:还原后 XML 再过字节级 DOCTYPE 守卫(与 parseGuard 同源防御);enableSafeBpmnXml 亦禁 DOCTYPE,双保险。
if (hasDoctypeInBytes(deployXml.getBytes(StandardCharsets.UTF_8))) {
log.warn("[流程发布] 拒绝: 还原后 XML 含 DOCTYPE 声明(XXE 防御) id={}", id);
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
// validateSchema=false:bpmn-js 默认命名空间输出与严格 XSD 已知不兼容,语义交给下方 ProcessValidator;
// enableSafeBpmnXml=true:加固解析器关外部实体/DTD。
bpmnModel = new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(deployXml), false, true);
} catch (IllegalStateException e) {
// resolveIdMap 的 fail-fast:存量草稿 metaInfo 不可读/丢 eip4IdMap,还原不出中文原 key→拒发,防落库 nXXX 坏 key(D7)。
log.warn("[流程发布] id 映射不可用 id={}: {}", id, e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿 id 映射不可用,无法还原原 key");
} catch (IllegalArgumentException e) {
// BpmnIdSanitizer.restore 的 fail-fast:idMap 非双射(metaInfo 损坏)——须炸不能静默还原成别的 key。
log.warn("[流程发布] id 还原失败(idMap 损坏) id={}: {}", id, e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿 id 映射损坏,无法还原原 key");
} catch (Exception e) {
log.warn("[流程发布] BPMN 解析失败 id={}: {}", id, e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
// 引擎校验门:区分 ERROR/WARNING,只 ERROR 级阻断部署。此处仅引擎「结构」校验(节点连通/网关/多实例等);
// EIP4 「语义」校验(formKey 存在于 view_wftemplate、办理人/会签内嵌 JSON 白名单)在网关 ModelSemanticValidator(T3.2)。
List<Map<String, Object>> blocking = new ArrayList<>();
for (ValidationError ve : processValidator.validate(bpmnModel)) {
if (ve.isWarning()) {
log.info("[流程发布] 校验告警(放行) id={} activityId={} problem={} desc={}",
id, ve.getActivityId(), ve.getProblem(), ve.getDefaultDescription());
continue;
}
Map<String, Object> err = new LinkedHashMap<>();
err.put("activityId", ve.getActivityId());
err.put("problem", ve.getProblem());
err.put("defaultDescription", ve.getDefaultDescription());
blocking.add(err);
}
if (!blocking.isEmpty()) {
log.warn("[流程发布] ProcessValidator 拒绝 id={} errorCount={}", id, blocking.size());
Map<String, Object> body = new LinkedHashMap<>();
body.put("status", 1);
body.put("msg", "流程校验未通过");
body.put("errors", blocking);
return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY).body(body);
}
// 部署资源名用中文原 key(仅 act_ge_bytearray 名,不决定 process key——后者取自 XML 的 <process id>)。
String resource = model.getKey() + ".bpmn20.xml";
var deployment = repositoryService.createDeployment()
.disableSchemaValidation()
.name(model.getName())
.addString(resource, deployXml)
.deploy();
var deployed = repositoryService.createProcessDefinitionQuery()
.deploymentId(deployment.getId()).singleResult();
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
resp.put("deploymentId", deployment.getId());
resp.put("processKey", deployed != null ? deployed.getKey() : model.getKey());
resp.put("newVersion", deployed != null ? deployed.getVersion() : 0);
return ResponseEntity.ok(resp);
}
@GetMapping("/models/{id}/impact")
@Operation(summary = "发布影响摘要",
description = "草稿不存在→404;还原后解析 processKey → {processKey,currentVersion(该 key 最新已部署版本,"
+ "无则 0),runningInstances(该 key 运行中实例数)}。供同人确认弹窗展示「新版本/旧版本实例不受影响」。")
public ResponseEntity<Map<String, Object>> impact(@PathVariable String id) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
byte[] source = repositoryService.getModelEditorSource(id);
if (source == null) {
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空: " + id);
}
String processKey;
try {
// impact 是只读预览:resolveIdMap 抛(存量草稿 metaInfo 不可读)/半成品草稿解析失败,一律回退 model.key
// ——from-procdef 建草稿的 model.key 就是中文原 key(创建时 setKey(def.getKey())),回退即得正确 processKey,
// 不该因草稿未完成/元数据损坏而 500;真正阻断坏 key 部署由 deploy 端点 fail-fast 负责。
// 无独立 DOCTYPE 字节守卫:impact 只查计数不部署,且 convertToBpmnModel 的 enableSafeBpmnXml=true 已禁 DOCTYPE/外部实体。
Map<String, String> idMap = resolveIdMap(model.getMetaInfo());
String deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap);
BpmnModel bpmnModel = new BpmnXMLConverter()
.convertToBpmnModel(new StringStreamSource(deployXml), false, true);
var mainProcess = bpmnModel.getMainProcess();
processKey = mainProcess != null ? mainProcess.getId() : model.getKey();
} catch (Exception e) {
log.warn("[流程发布] 影响摘要解析失败,回退 model.key id={}: {}", id, e.toString());
processKey = model.getKey();
}
var latest = repositoryService.createProcessDefinitionQuery()
.processDefinitionKey(processKey).latestVersion().singleResult();
long runningInstances = runtimeService.createProcessInstanceQuery()
.processDefinitionKey(processKey).count();
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("processKey", processKey);
resp.put("currentVersion", latest != null ? latest.getVersion() : 0);
resp.put("runningInstances", runningInstances);
return ResponseEntity.ok(resp);
}
/**
* 发布/影响摘要前的 XML 规范化:①{@link #FLOW_REF_ELEMENT} 剥除 bpmn-js 补的 incoming/outgoing 文本引用元素;
* ②{@link BpmnIdSanitizer#restore} 依 {@code idMap} 把净化 id 还原为中文原 key(idMap 空=新建流程,原样返回)。
* restore 在剥除后跑:文本引用已消除,还原只作用于属性位,最终部署 XML 无残留净化 id。
* idMap 非双射时 restore fail-fast 抛 {@link IllegalArgumentException},由调用方转 422。
*/
private static String prepareDeployXml(String xml, Map<String, String> idMap) {
String stripped = FLOW_REF_ELEMENT.matcher(xml).replaceAll("");
return BpmnIdSanitizer.restore(stripped, idMap);
}
/** from-procdef 建草稿写入 metaInfo 的存量标记键(其一存在即表明本草稿源自既有流程定义,editorSource 是净化 XML)。 */
private static final String[] FROM_PROCDEF_MARKERS = {"sourceProcDefId", "originalKey"};
/**
* 从 metaInfo JSON 取 {@code eip4IdMap}(原→净化),供 {@link BpmnIdSanitizer#restore} 还原中文原 key。
*
* <p><b>坏 key 地雷收口(评审 I1)</b>:绝不把「idMap 不可读」静默塌成「空 idMap→跳过还原」——那会让 from-procdef
* 存量草稿(editorSource 的 {@code <process id>} 是净化 {@code nXXX})在 metaInfo 损坏时静默部署出 key=nXXX 而非
* 中文原 key(HTTP 200 无声,违 D7;且与 restore 非双射 fail-fast 自相矛盾)。据 from-procdef 写的
* {@link #FROM_PROCDEF_MARKERS} 判存量草稿:</p>
* <ul>
* <li>metaInfo 空/null → 真·新建,空 Map(跳过还原,key 原样)。</li>
* <li>metaInfo 非空但 JSON 解析失败 → 损坏,{@link IllegalStateException} fail-fast(调用方转 422)。</li>
* <li>解析成功、{@code eip4IdMap} <b>存在</b>(是 Map,含空 {@code {}})→ 直接用(空=全 ASCII 存量流程无需还原,正常)。</li>
* <li>解析成功、{@code eip4IdMap} <b>缺失/非 Map</b> 且带 from-procdef 标记 → 存量草稿丢了映射,无法还原原 key,
* {@link IllegalStateException} fail-fast(宁拒不发坏 key)。</li>
* <li>解析成功、无 {@code eip4IdMap} 且无标记 → 真·新建(前端另存了别的 metaInfo),空 Map 正常放行。</li>
* </ul>
*/
private Map<String, String> resolveIdMap(String metaInfo) {
if (metaInfo == null || metaInfo.isBlank()) {
return Map.of();
}
Map<String, Object> meta;
try {
meta = objectMapper.readValue(metaInfo, new TypeReference<Map<String, Object>>() {});
} catch (Exception e) {
// 非空 metaInfo 却解析不了=损坏,不能猜它是不是存量草稿→一律 fail-fast(宁拒不发可能的坏 key)。
throw new IllegalStateException("metaInfo 无法解析,无法确认 id 映射: " + e, e);
}
Object raw = meta.get("eip4IdMap");
if (raw instanceof Map<?, ?> m) {
// eip4IdMap 存在(即使空):空=全 ASCII 存量流程无需还原,直接用。
Map<String, String> idMap = new LinkedHashMap<>();
for (Map.Entry<?, ?> e : m.entrySet()) {
idMap.put(String.valueOf(e.getKey()), String.valueOf(e.getValue()));
}
return idMap;
}
// eip4IdMap 缺失/非 Map:带 from-procdef 标记=存量草稿丢了映射(editorSource 是净化 XML)→fail-fast 防坏 key。
for (String marker : FROM_PROCDEF_MARKERS) {
if (meta.containsKey(marker)) {
throw new IllegalStateException(
"存量草稿 metaInfo 缺 eip4IdMap,无法还原净化 id 为中文原 key(marker=" + marker + ")");
}
}
return Map.of(); // 无标记=真·新建,key 原样部署。
}
/**
* BPMN 解析守卫:过则返回 {@code null}(放行),坏 XML 返回 422 ResponseEntity({status:1,msg})。
* 就地 catch 一切异常,不让引擎 XMLException/FlowableException 逸出到全局 advice(那里映射成 400,语义不符)。
*
* <p><b>两道关</b>:①解析前字节级 {@link #hasDoctypeInBytes} 拒 DOCTYPE 声明(XXE 兜底,不依赖 flowable
* 内部 {@code supportDTD=false} 实现);②{@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)}
* 解析——{@code validateSchema=false}:草稿是可视化工具编辑的半成品,<b>不做</b>严格 BPMN 2.0 XSD 校验。
* bpmn-js {@code saveXML} 用默认命名空间(无前缀 definitions/process)重序列化,Flowable 严格 Xerces XSD 校验
* 会拒({@code cvc-complex-type.2.4.a})——这是 bpmn-js(面向 BPMN 模型,非字节级 XSD 合规)与严格 XSD 的
* <b>已知固有不兼容</b>;完整校验属部署门(T3.1 {@code ProcessValidator} 在解析后的模型上跑,非 XSD)。
* {@code validateSchema=false} 仍解析(非良构 XML 抛→422);{@code enableSafeBpmnXml=true} 保加固解析器
* (禁外部 DTD/参数实体/DOCTYPE),双保险关 XXE/SSRF。</p>
*
* <p>422 只回通用文案;原始解析原因(可能含内部路径/实体细节)仅进 {@code log.warn},不回显给调用方。</p>
*/
private ResponseEntity<Map<String, Object>> parseGuard(String xml) {
// ① XXE 兜底:解析前字节级拒 DOCTYPE。按 StringStreamSource 喂解析器的 UTF-8 字节视角扫描(含 BOM/UTF-16
// 识别),消除「扫描端 vs 解析端编码错位」绕过。null XML 同走 422(与解析必抛等价)。
if (xml == null || hasDoctypeInBytes(xml.getBytes(StandardCharsets.UTF_8))) {
log.warn("[流程草稿] BPMN 拒绝: {}", xml == null ? "空 XML" : "含 DOCTYPE 声明(XXE 防御)");
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
try {
// ② validateSchema=false(不做严格 XSD)+ enableSafeBpmnXml=true(加固解析器);详见方法 javadoc。
new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(xml), false, true);
return null;
} catch (Exception e) {
log.warn("[流程草稿] BPMN 解析守卫拒绝: {}", e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
}
/**
* 字节级 DOCTYPE 检测(XXE 门):按 BOM / 无 BOM 的 UTF-16 空字节特征识别编码后解码 prolog,再走
* {@link #hasDoctype}。消除「扫描端与解析端编码视角不一致」的绕过(UTF-8 BOM / UTF-16 会让纯字节扫描漏判
* {@code <!DOCTYPE},而 xerces 仍按 BOM 正确解析触发 XXE)。移植 platform-report {@code ReportXmlGuard}
* (flowable-service 不依赖 platform-* 模块,故就地复刻,不引依赖)。
*/
static boolean hasDoctypeInBytes(byte[] raw) {
if (raw == null || raw.length == 0) {
return false;
}
java.nio.charset.Charset cs;
int off = 0;
int u0 = raw[0] & 0xFF;
int u1 = raw.length > 1 ? raw[1] & 0xFF : -1;
int u2 = raw.length > 2 ? raw[2] & 0xFF : -1;
if (u0 == 0xEF && u1 == 0xBB && u2 == 0xBF) {
cs = StandardCharsets.UTF_8;
off = 3; // UTF-8 BOM
} else if (u0 == 0xFF && u1 == 0xFE) {
cs = StandardCharsets.UTF_16LE;
off = 2; // UTF-16LE BOM
} else if (u0 == 0xFE && u1 == 0xFF) {
cs = StandardCharsets.UTF_16BE;
off = 2; // UTF-16BE BOM
} else if (u0 == '<' && u1 == 0x00) {
cs = StandardCharsets.UTF_16LE; // 无 BOM UTF-16LE(ASCII 起始字符夹空字节)
} else if (u0 == 0x00 && u1 == '<') {
cs = StandardCharsets.UTF_16BE; // 无 BOM UTF-16BE
} else {
cs = StandardCharsets.ISO_8859_1; // UTF-8 / Latin1:prolog 为 ASCII,字节级保真扫描
}
int scanLen = Math.min(raw.length - off, PROLOG_SCAN_BYTES);
return hasDoctype(new String(raw, off, scanLen, cs));
}
/**
* 文档 prolog(根元素之前)是否含 DOCTYPE 声明(大小写不敏感)。正确跳过 XML 声明 {@code <?xml?>} 与注释
* {@code <!-- -->},命中根元素起始标签即停(元素内容里的字面 {@code <!DOCTYPE} 文本不算)。
*/
static boolean hasDoctype(String xml) {
if (xml == null) {
return false;
}
int i = 0;
int n = xml.length();
while (i < n) {
char c = xml.charAt(i);
if (c == ' ' || c == '\t' || c == '\n' || c == '\r' || c == '') {
i++;
continue;
}
if (c != '<') {
return false; // prolog 里非标记的文本 → 视为无 DOCTYPE
}
if (xml.regionMatches(true, i, "<!DOCTYPE", 0, 9)) {
return true;
}
if (xml.startsWith("<!--", i)) { // 注释:整段跳过
int end = xml.indexOf("-->", i + 4);
if (end < 0) {
return false;
}
i = end + 3;
continue;
}
if (xml.startsWith("<?", i)) { // XML 声明 / 处理指令:整段跳过
int end = xml.indexOf("?>", i + 2);
if (end < 0) {
return false;
}
i = end + 2;
continue;
}
return false; // 到达根元素起始标签,prolog 结束,无 DOCTYPE
}
return false;
}
/** 读流程定义部署 BPMN XML(getProcessModel 返回资源流)。读失败/为空返回 null(前端降级)。 */
private String readProcessModel(String procDefId) {
try (InputStream is = repositoryService.getProcessModel(procDefId)) {
if (is == null) {
return null;
}
return StreamUtils.copyToString(is, StandardCharsets.UTF_8);
} catch (Exception e) {
log.warn("[流程草稿] 读取 BPMN 失败 procDefId={}: {}", procDefId, e.toString());
return null;
}
}
private static ResponseEntity<Map<String, Object>> found(boolean value) {
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("found", value);
return ResponseEntity.ok(resp);
}
private static ResponseEntity<Map<String, Object>> status(HttpStatus httpStatus, String msg) {
Map<String, Object> body = new LinkedHashMap<>();
body.put("status", 1);
body.put("msg", msg);
return ResponseEntity.status(httpStatus).body(body);
}
/** {@link Date} → ISO-8601 UTC 字符串(如 {@code 1970-01-01T00:00:00Z});null 原样透传。 */
private static String toIso(Date d) {
return d == null ? null : d.toInstant().toString();
}
/** null 或纯空白(含全角/半角空格)视为空白。 */
private static boolean isBlank(String s) {
return s == null || s.isBlank();
}
/** 建草稿入参。 */
public static class CreateModelRequest {
public String name;
public String key;
public String bpmnXml;
public String metaInfo;
}
/** 更新草稿入参(editorSource 走 bpmnXml;name/metaInfo 为 null 表示不改)。 */
public static class UpdateModelRequest {
public String name;
public String bpmnXml;
public String metaInfo;
}
/** 从流程定义建草稿入参。 */
public static class FromProcDefRequest {
public String procDefId;
}
}

View File

@@ -15,6 +15,8 @@ public final class Requests {
public String processDefinitionKey; public String processDefinitionKey;
public String processDefinitionId; public String processDefinitionId;
public String businessKey; public String businessKey;
/** 当前发起人 userId;用于 Flowable 历史实例 startedBy,支撑“我的发起任务”。 */
public String startUserId;
public Map<String, Object> variables; public Map<String, Object> variables;
} }
@@ -37,8 +39,10 @@ public final class Requests {
public static class ActionRequest { public static class ActionRequest {
/** 审批意见(记入流程评论)。 */ /** 审批意见(记入流程评论)。 */
public String comment; public String comment;
/** 目标用户(转办/协办/转阅用;reject/reback 不需要)。 */ /** 目标用户(转办用;reject/reback 不需要)。 */
public String targetUserId; public String targetUserId;
/** 多目标用户(协办/转阅:老系统用 MultiSelectField 选多人,每人各建一条子/转阅任务)。 */
public java.util.List<String> targetUserIds;
} }
/** /**

View File

@@ -6,6 +6,7 @@ import java.util.Map;
import javax.sql.DataSource; import javax.sql.DataSource;
import org.flowable.engine.HistoryService; import org.flowable.engine.HistoryService;
import org.flowable.engine.IdentityService;
import org.flowable.engine.ProcessEngine; import org.flowable.engine.ProcessEngine;
import org.flowable.engine.RepositoryService; import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService; import org.flowable.engine.RuntimeService;
@@ -88,4 +89,9 @@ public class FlowableEngineConfig {
public HistoryService historyService(ProcessEngine engine) { public HistoryService historyService(ProcessEngine engine) {
return engine.getHistoryService(); return engine.getHistoryService();
} }
@Bean
public IdentityService identityService(ProcessEngine engine) {
return engine.getIdentityService();
}
} }

View File

@@ -16,15 +16,15 @@ flowable:
datasource: datasource:
# Hikari 原生属性名 jdbc-url(@ConfigurationProperties 绑到已 build 的 HikariDataSource, # Hikari 原生属性名 jdbc-url(@ConfigurationProperties 绑到已 build 的 HikariDataSource,
# 须用 jdbc-url 而非 url,否则报 "jdbcUrl is required with driverClassName") # 须用 jdbc-url 而非 url,否则报 "jdbcUrl is required with driverClassName")
jdbc-url: ${FLOWABLE_JDBC_URL:jdbc:postgresql://localhost:5433/eip4flow?currentSchema=eip3} jdbc-url: ${FLOWABLE_JDBC_URL:jdbc:postgresql://localhost:5433/eip4?currentSchema=eip3}
username: ${FLOWABLE_JDBC_USER:zhengwr} username: ${FLOWABLE_JDBC_USER:zhengwr}
password: ${FLOWABLE_JDBC_PASS:} password: ${FLOWABLE_JDBC_PASS:}
driver-class-name: org.postgresql.Driver driver-class-name: org.postgresql.Driver
biz: biz:
datasource: datasource:
# F2-13: 本地验证用本地 eip4dev(5435 不可达,人名解析正降级) # F2-13: 本地验证用合并库 eip4(业务+流程同库;原 eip4dev 已并入)。5435 不可达,人名解析正降级。
jdbc-url: ${BIZ_JDBC_URL:jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3} jdbc-url: ${BIZ_JDBC_URL:jdbc:postgresql://localhost:5433/eip4?currentSchema=eip3}
username: ${BIZ_JDBC_USER:zhengwr} username: ${BIZ_JDBC_USER:zhengwr}
password: ${BIZ_JDBC_PASS:} password: ${BIZ_JDBC_PASS:}
driver-class-name: org.postgresql.Driver driver-class-name: org.postgresql.Driver

View File

@@ -0,0 +1,64 @@
package com.dsasp.server.wf.user.assignee;
import static org.assertj.core.api.Assertions.assertThat;
import java.util.Arrays;
import java.util.List;
import org.junit.jupiter.api.Test;
/**
* scriptUser 会签办理人解析的纯函数单测(同包以访问包级 helper):
* 单变量名提取 + 求值结果归一为 userId 列表。修复前 scriptUser 分支 WARN 降级返空,
* 致招投标/总包合同/施工技术交底等会签节点(集合用 ${APPLYUSERS})无办理人被跳过。
*/
class CandidateUsersScriptUserTest {
@Test
void singleVarName_提取简单变量() {
assertThat(CandidateUsersHandler.singleVarName("${APPLYUSERS}")).isEqualTo("APPLYUSERS");
assertThat(CandidateUsersHandler.singleVarName(" ${ APPLYUSERS } ")).isEqualTo("APPLYUSERS");
}
@Test
void singleVarName_复杂表达式返回null() {
assertThat(CandidateUsersHandler.singleVarName("${a + b}")).isNull();
assertThat(CandidateUsersHandler.singleVarName("${users[0]}")).isNull();
assertThat(CandidateUsersHandler.singleVarName("ADMIN")).isNull();
assertThat(CandidateUsersHandler.singleVarName(null)).isNull();
}
@Test
void coerceUserList_支持List() {
assertThat(CandidateUsersHandler.coerceUserList(List.of("u1", "u2")))
.containsExactly("u1", "u2");
}
@Test
void coerceUserList_支持数组() {
assertThat(CandidateUsersHandler.coerceUserList(new String[] { "u1", "u2" }))
.containsExactly("u1", "u2");
}
@Test
void coerceUserList_逗号分号全角半角分隔串() {
assertThat(CandidateUsersHandler.coerceUserList("u1,u2; u3,u4;u5"))
.containsExactly("u1", "u2", "u3", "u4", "u5");
}
@Test
void coerceUserList_单值() {
assertThat(CandidateUsersHandler.coerceUserList("ADMIN")).containsExactly("ADMIN");
}
@Test
void coerceUserList_去重去空白() {
assertThat(CandidateUsersHandler.coerceUserList(Arrays.asList(" u1 ", "u1", "", "u2", null)))
.containsExactly("u1", "u2");
}
@Test
void coerceUserList_null返回空() {
assertThat(CandidateUsersHandler.coerceUserList(null)).isEmpty();
}
}

View File

@@ -0,0 +1,223 @@
package com.eip4.flowservice.api;
import static org.assertj.core.api.Assertions.assertThat;
import java.util.LinkedHashMap;
import java.util.Map;
import org.junit.jupiter.api.Test;
/**
* BpmnIdSanitizer 可逆双射单测:净化(中文 id→安全 ASCII)与还原(restore)严格互逆,
* 覆盖 hash 碰撞消解、restore 前缀安全、合法 id 不动、混合场景。
*
* <p>非碰撞净化输出须与 ProcessDiagramController 旧实现逐字节一致(由既有 ProcessDiagramControllerTest 兜底),
* 本类聚焦「可逆」这一新增契约。</p>
*/
class BpmnIdSanitizerTest {
/** 中文 process id + processRef/sourceRef/targetRef/default/attachedToRef 全引用面净化→restore 须逐字节还原。 */
@Test
void 净化后还原_逐字节等于原文() {
String xml = """
<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL">
<process id="总包合同交底" name="总包合同交底">
<startEvent id="start"/>
<userTask id="审批" name="审批人"/>
<boundaryEvent id="超时" attachedToRef="审批"/>
<exclusiveGateway id="gw" default="回退"/>
<sequenceFlow id="回退" sourceRef="gw" targetRef="审批"/>
<sequenceFlow id="通过" sourceRef="审批" targetRef="end"/>
<endEvent id="end"/>
</process>
<collaboration id="collab">
<participant id="part" processRef="总包合同交底"/>
</collaboration>
<bpmndi:BPMNDiagram id="di" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI">
<bpmndi:BPMNPlane bpmnElement="总包合同交底"/>
</bpmndi:BPMNDiagram>
</definitions>""";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 中文 id 不再出现在 id/引用类属性中;name 展示属性照旧保留中文
assertThat(r.xml()).doesNotContain("id=\"总包合同交底\"");
assertThat(r.xml()).doesNotContain("processRef=\"总包合同交底\"");
assertThat(r.xml()).doesNotContain("attachedToRef=\"审批\"");
assertThat(r.xml()).contains("name=\"总包合同交底\"");
assertThat(r.xml()).contains("name=\"审批人\"");
// idMap 覆盖全部 5 个中文 id(合法 ASCII id 不入 map)
assertThat(r.idMap()).containsOnlyKeys("总包合同交底", "审批", "超时", "回退", "通过");
// restore 逐字节还原
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/**
* hash 碰撞消解:Java String.hashCode 下 "中Aa" 与 "中BB" 撞哈希('A'*31+'a' == 'B'*31+'B' == 2112),
* 二者又都是非法 NCName(含中文)→ 旧实现会撞成同一净化 id(非双射)。sanitize 须给两者不同净化 id,restore 仍完整还原。
*/
@Test
void 撞哈希两中文id_净化后仍双射可逆() {
// 前置自证:确实撞哈希
assertThat("中Aa".hashCode()).isEqualTo("中BB".hashCode());
String xml = """
<definitions>
<process id="p">
<userTask id="中Aa"/>
<userTask id="中BB"/>
<sequenceFlow id="f1" sourceRef="中Aa" targetRef="中BB"/>
</process>
</definitions>""";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
String s1 = r.idMap().get("中Aa");
String s2 = r.idMap().get("中BB");
// 双射:两净化 id 互不相同(否则 sourceRef/targetRef 引用会串)
assertThat(s1).isNotNull();
assertThat(s2).isNotNull();
assertThat(s1).isNotEqualTo(s2);
// 碰撞消解序号:其一为基名,另一为基名 +"-2"
assertThat(s1 + "|" + s2).containsPattern("-2");
// 净化后中文 id 消失
assertThat(r.xml()).doesNotContain("中Aa");
assertThat(r.xml()).doesNotContain("中BB");
// restore 逐字节还原(引用不串)
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/**
* restore 前缀安全:idMap 同时含净化 id "n1" 与 "n1x"(后者以前者为前缀)。
* 裸 String.replace("n1",..) 会把 "n1x" 误伤成 "<orig1>x";必须锚定完整属性值精确匹配。
*/
@Test
void restore前缀安全_n1不误伤n1x() {
Map<String, String> idMap = new LinkedHashMap<>();
idMap.put("原A", "n1");
idMap.put("原B", "n1x");
String xml = "<userTask id=\"n1x\"/><sequenceFlow id=\"f\" sourceRef=\"n1\" targetRef=\"n1x\"/>";
String out = BpmnIdSanitizer.restore(xml, idMap);
assertThat(out).isEqualTo("<userTask id=\"原B\"/><sequenceFlow id=\"f\" sourceRef=\"原A\" targetRef=\"原B\"/>");
assertThat(out).doesNotContain("原Ax"); // 无前缀误伤
assertThat(out).doesNotContain("n1x");
assertThat(out).doesNotContain("n1\"");
}
/** 全合法 NCName id:不改写,idMap 为空,restore 无副作用。 */
@Test
void 合法NCName_id不改写_映射为空() {
String xml = "<process id=\"p\"><userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"p\" targetRef=\"sid-A\" default=\"f1\"/></process>";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
assertThat(r.idMap()).isEmpty();
assertThat(r.xml()).isEqualTo(xml);
// 空 idMap 的 restore 原样返回
assertThat(BpmnIdSanitizer.restore(xml, r.idMap())).isEqualTo(xml);
}
/** 混合:部分中文部分合法,只映射中文者;合法 id 原样保留;restore 还原。 */
@Test
void 混合_只映射中文id_合法id原样保留() {
String xml = "<process id=\"审批流程\"><userTask id=\"legalTask\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"审批流程\" targetRef=\"legalTask\"/></process>";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
assertThat(r.idMap()).containsOnlyKeys("审批流程");
assertThat(r.xml()).contains("id=\"legalTask\"");
assertThat(r.xml()).contains("targetRef=\"legalTask\"");
assertThat(r.xml()).doesNotContain("审批流程");
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/** restore 只回写映射内 id;净化后新增的 ASCII 节点 id(不在 idMap)原样保留。 */
@Test
void restore只回写映射内id_新增ascii_id保留() {
Map<String, String> idMap = new LinkedHashMap<>();
idMap.put("审批", "n5");
// n9 是设计器新增节点,不在 idMap → restore 不得改动
String xml = "<userTask id=\"n5\"/><userTask id=\"n9\"/>"
+ "<sequenceFlow id=\"f\" sourceRef=\"n5\" targetRef=\"n9\"/>";
String out = BpmnIdSanitizer.restore(xml, idMap);
assertThat(out).isEqualTo("<userTask id=\"审批\"/><userTask id=\"n9\"/>"
+ "<sequenceFlow id=\"f\" sourceRef=\"审批\" targetRef=\"n9\"/>");
}
/** null/空 XML 防御:不抛,idMap 为空。 */
@Test
void 空xml不抛_映射为空() {
assertThat(BpmnIdSanitizer.sanitize(null).idMap()).isEmpty();
assertThat(BpmnIdSanitizer.sanitize("").idMap()).isEmpty();
assertThat(BpmnIdSanitizer.restore(null, Map.of())).isNull();
assertThat(BpmnIdSanitizer.restore("<a/>", Map.of())).isEqualTo("<a/>");
}
/**
* 生成的净化 id 不与文档内既有合法字面 id 冲突(used 占位契约)。
* "审批".hashCode()&0x7fffffff 的 hex 恰为 b7af8 → 基名 "nb7af8" 与合法字面 id "nb7af8" 撞
* → sanitize 须让 审批 映射为 nb7af8-2(否则 restore 会误改那个合法 id),restore 逐字节还原。
*/
@Test
void 净化id不与既有合法id冲突_让位加序号() {
assertThat(Integer.toHexString("审批".hashCode() & 0x7fffffff)).isEqualTo("b7af8"); // 前置自证
String xml = """
<process id="p">
<userTask id="nb7af8"/>
<userTask id="审批"/>
<sequenceFlow id="f" sourceRef="nb7af8" targetRef="审批"/>
</process>""";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 中文 id 让位到 -2;既有合法字面 id nb7af8 原样不动、不入 map
assertThat(r.idMap()).containsOnlyKeys("审批");
assertThat(r.idMap().get("审批")).isEqualTo("nb7af8-2");
assertThat(r.xml()).contains("id=\"nb7af8\"");
assertThat(r.xml()).contains("sourceRef=\"nb7af8\"");
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/**
* M-1 逐字节契约:未改值的合法属性(含等号周围空白)须原样回写,不被重构归一。
* 即便 map 非空(另有中文 id 被改),带空白的合法属性 round-trip 后原文不变。
*/
@Test
void 未改值属性含等号空白_原样保留不归一() {
// legalTask 用 `id = "..."`(等号带空格)合法写法;审批 是被净化的中文 id → map 非空
String xml = "<userTask id = \"legalTask\"/>"
+ "<userTask id=\"审批\"/>"
+ "<sequenceFlow id=\"f\" sourceRef=\"legalTask\" targetRef=\"审批\"/>";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 审批被改;legalTask 的等号空白写法逐字保留(旧实现会归一成 id="legalTask")
assertThat(r.idMap()).containsOnlyKeys("审批");
assertThat(r.xml()).contains("id = \"legalTask\"");
// round-trip 后原文逐字节不变
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/** M-2 fail-fast:idMap 值(净化 id)重复=非双射(损坏 metaInfo),restore 抛而非静默还原错。 */
@Test
void restore_idMap值重复_抛非双射异常() {
Map<String, String> broken = new LinkedHashMap<>();
broken.put("原A", "n1");
broken.put("原B", "n1"); // 两个原 id 映到同一净化 id → 反转会静默覆盖
String xml = "<userTask id=\"n1\"/>";
org.assertj.core.api.Assertions.assertThatThrownBy(() -> BpmnIdSanitizer.restore(xml, broken))
.isInstanceOf(IllegalArgumentException.class)
.hasMessageContaining("非双射")
.hasMessageContaining("n1");
}
}

View File

@@ -3,6 +3,7 @@ package com.eip4.flowservice.api;
import static org.mockito.ArgumentMatchers.any; import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString; import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq; import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when; import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
@@ -10,11 +11,19 @@ import static org.springframework.test.web.servlet.request.MockMvcRequestBuilder
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import java.util.Date;
import org.flowable.engine.HistoryService; import org.flowable.engine.HistoryService;
import org.flowable.engine.IdentityService;
import org.flowable.engine.RepositoryService; import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService; import org.flowable.engine.RuntimeService;
import org.flowable.engine.TaskService; import org.flowable.engine.TaskService;
import org.flowable.engine.history.HistoricProcessInstance;
import org.flowable.engine.history.HistoricProcessInstanceQuery;
import org.flowable.engine.runtime.ProcessInstance; import org.flowable.engine.runtime.ProcessInstance;
import org.flowable.engine.runtime.ProcessInstanceQuery;
import org.flowable.engine.runtime.ChangeActivityStateBuilder;
import org.flowable.engine.task.Comment;
import org.flowable.task.api.Task; import org.flowable.task.api.Task;
import org.flowable.task.api.TaskQuery; import org.flowable.task.api.TaskQuery;
import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.BeforeEach;
@@ -41,15 +50,26 @@ class FlowControllerTest {
@Mock @Mock
RepositoryService repositoryService; RepositoryService repositoryService;
@Mock @Mock
IdentityService identityService;
@Mock
TaskQuery taskQuery; TaskQuery taskQuery;
@Mock @Mock
ProcessInstanceQuery processInstanceQuery;
@Mock
HistoricProcessInstanceQuery historicProcessInstanceQuery;
@Mock
ChangeActivityStateBuilder changeActivityStateBuilder;
@Mock
JdbcTemplate bizJdbc; JdbcTemplate bizJdbc;
MockMvc mvc; MockMvc mvc;
@BeforeEach @BeforeEach
void setUp() { void setUp() {
FlowController controller = new FlowController(taskService, runtimeService, historyService, repositoryService, bizJdbc); FlowController controller = new FlowController(taskService, runtimeService, historyService, repositoryService,
identityService, bizJdbc,
new com.eip4.flowservice.wf.FormKeyResolver(historyService),
new com.eip4.flowservice.wf.StartFormKeyResolver(repositoryService));
mvc = MockMvcBuilders.standaloneSetup(controller).build(); mvc = MockMvcBuilders.standaloneSetup(controller).build();
} }
@@ -70,10 +90,12 @@ class FlowControllerTest {
mvc.perform(post("/api/flow/process/start") mvc.perform(post("/api/flow/process/start")
.contentType("application/json") .contentType("application/json")
.content("{\"processDefinitionKey\":\"leaveProcess\",\"businessKey\":\"biz-9\"}")) .content("{\"processDefinitionKey\":\"leaveProcess\",\"businessKey\":\"biz-9\",\"startUserId\":\"U1\"}"))
.andExpect(status().isOk()) .andExpect(status().isOk())
.andExpect(jsonPath("$.id").value("pi-1")) .andExpect(jsonPath("$.id").value("pi-1"))
.andExpect(jsonPath("$.processDefinitionKey").value("leaveProcess")); .andExpect(jsonPath("$.processDefinitionKey").value("leaveProcess"));
verify(identityService).setAuthenticatedUserId("U1");
verify(identityService).setAuthenticatedUserId((String) null);
} }
@Test @Test
@@ -99,6 +121,168 @@ class FlowControllerTest {
verify(runtimeService).activateProcessInstanceById("pi-3"); verify(runtimeService).activateProcessInstanceById("pi-3");
} }
@Test
void 删除已结束历史流程实例_转调historyDelete() throws Exception {
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("PI-DONE")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
HistoricProcessInstance hpi = org.mockito.Mockito.mock(HistoricProcessInstance.class);
when(hpi.getBusinessKey()).thenReturn("BK-DONE");
when(hpi.getEndTime()).thenReturn(new Date());
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("PI-DONE")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(hpi);
mvc.perform(post("/api/flow/process/PI-DONE/delete-history"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.deleted").value(true))
.andExpect(jsonPath("$.businessKey").value("BK-DONE"));
verify(historyService).deleteHistoricProcessInstance("PI-DONE");
}
@Test
void 删除运行中流程实例_拒绝且不删历史() throws Exception {
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("PI-RUN")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(pi);
mvc.perform(post("/api/flow/process/PI-RUN/delete-history"))
.andExpect(status().isConflict())
.andExpect(jsonPath("$.msg").value("流程未结束,不能删除审批表单"));
verify(historyService, never()).deleteHistoricProcessInstance(anyString());
}
@Test
void 结束运行中流程实例_记录评论并删除实例() throws Exception {
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(pi.getBusinessKey()).thenReturn("BK-END");
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("PI-END")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(pi);
Task task = org.mockito.Mockito.mock(Task.class);
when(task.getId()).thenReturn("T-END");
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.processInstanceId("PI-END")).thenReturn(taskQuery);
when(taskQuery.active()).thenReturn(taskQuery);
when(taskQuery.list()).thenReturn(java.util.List.of(task));
mvc.perform(post("/api/flow/process/PI-END/terminate")
.contentType("application/json")
.content("{}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.terminated").value(true))
.andExpect(jsonPath("$.businessKey").value("BK-END"))
.andExpect(jsonPath("$.activeTaskCount").value(1));
verify(taskService).addComment("T-END", "PI-END", "流程有误作废处理");
verify(runtimeService).setVariable("PI-END", "approveResult", "invalid");
verify(runtimeService).deleteProcessInstance("PI-END", "流程有误作废处理");
}
@Test
void 结束已结束流程实例_返回409且不删除() throws Exception {
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("PI-DONE")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
mvc.perform(post("/api/flow/process/PI-DONE/terminate")
.contentType("application/json")
.content("{}"))
.andExpect(status().isConflict())
.andExpect(jsonPath("$.msg").value("该流程已结束"));
verify(runtimeService, never()).deleteProcessInstance(anyString(), anyString());
}
@Test
void 撤回流程_移动回起始节点并挂起实例() throws Exception {
Task task = org.mockito.Mockito.mock(Task.class);
when(task.getId()).thenReturn("T1");
when(task.getTaskDefinitionKey()).thenReturn("approve");
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.processInstanceId("PI-1")).thenReturn(taskQuery);
when(taskQuery.active()).thenReturn(taskQuery);
when(taskQuery.orderByTaskCreateTime()).thenReturn(taskQuery);
when(taskQuery.asc()).thenReturn(taskQuery);
when(taskQuery.list()).thenReturn(java.util.List.of(task));
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(pi.getBusinessKey()).thenReturn("BK-1");
when(pi.isSuspended()).thenReturn(false);
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("PI-1")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(pi);
HistoricProcessInstance hpi = org.mockito.Mockito.mock(HistoricProcessInstance.class);
when(hpi.getBusinessKey()).thenReturn("BK-1");
when(hpi.getStartActivityId()).thenReturn("startEvent");
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("PI-1")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(hpi);
when(bizJdbc.query(anyString(), any(org.springframework.jdbc.core.ResultSetExtractor.class), eq("BK-1")))
.thenReturn(2);
when(runtimeService.createChangeActivityStateBuilder()).thenReturn(changeActivityStateBuilder);
when(changeActivityStateBuilder.processInstanceId("PI-1")).thenReturn(changeActivityStateBuilder);
when(changeActivityStateBuilder.moveActivityIdsToSingleActivityId(java.util.List.of("approve"), "startEvent"))
.thenReturn(changeActivityStateBuilder);
mvc.perform(post("/api/flow/process/PI-1/withdraw")
.contentType("application/json")
.content("{}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.withdrawn").value(true))
.andExpect(jsonPath("$.businessKey").value("BK-1"))
.andExpect(jsonPath("$.targetKey").value("startEvent"));
verify(taskService).addComment("T1", "PI-1", "主动召回");
verify(changeActivityStateBuilder).changeState();
verify(runtimeService).suspendProcessInstanceById("PI-1");
}
@Test
void 撤回流程_已有非白名单意见则拒绝() throws Exception {
Task task = org.mockito.Mockito.mock(Task.class);
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.processInstanceId("PI-2")).thenReturn(taskQuery);
when(taskQuery.active()).thenReturn(taskQuery);
when(taskQuery.orderByTaskCreateTime()).thenReturn(taskQuery);
when(taskQuery.asc()).thenReturn(taskQuery);
when(taskQuery.list()).thenReturn(java.util.List.of(task));
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(pi.getBusinessKey()).thenReturn("BK-2");
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("PI-2")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(pi);
HistoricProcessInstance hpi = org.mockito.Mockito.mock(HistoricProcessInstance.class);
when(hpi.getBusinessKey()).thenReturn("BK-2");
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("PI-2")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(hpi);
when(bizJdbc.query(anyString(), any(org.springframework.jdbc.core.ResultSetExtractor.class), eq("BK-2")))
.thenReturn(2);
Comment comment = org.mockito.Mockito.mock(Comment.class);
when(comment.getFullMessage()).thenReturn("同意");
when(taskService.getProcessInstanceComments("PI-2", "comment"))
.thenReturn(java.util.List.of(comment));
mvc.perform(post("/api/flow/process/PI-2/withdraw")
.contentType("application/json")
.content("{}"))
.andExpect(status().isConflict())
.andExpect(jsonPath("$.msg").value("该任务已流转,无法撤回!"));
verify(runtimeService, never()).createChangeActivityStateBuilder();
verify(taskService, never()).addComment(eq("T1"), eq("PI-2"), anyString());
}
@Test @Test
void 委托缺少受托人返回400() throws Exception { void 委托缺少受托人返回400() throws Exception {
mvc.perform(post("/api/flow/tasks/task-7/delegate") mvc.perform(post("/api/flow/tasks/task-7/delegate")
@@ -146,4 +330,163 @@ class FlowControllerTest {
.andExpect(status().isOk()) .andExpect(status().isOk())
.andExpect(org.springframework.test.web.servlet.result.MockMvcResultMatchers.content().string("1509")); .andExpect(org.springframework.test.web.servlet.result.MockMvcResultMatchers.content().string("1509"));
} }
// ---------------------------------------------------------------- 协办(assist) / 转阅(circulate)
@Test
void 协办缺少目标用户返回400() throws Exception {
mvc.perform(post("/api/flow/tasks/task-9/assist")
.contentType("application/json")
.content("{\"comment\":\"请协助\"}"))
.andExpect(status().isBadRequest());
}
@Test
void 协办为每个目标用户建子任务并记意见() throws Exception {
// 父任务查得(取 processInstanceId 记意见)
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("task-9")).thenReturn(taskQuery);
Task parent = org.mockito.Mockito.mock(Task.class);
when(parent.getProcessInstanceId()).thenReturn("pi-9");
when(taskQuery.singleResult()).thenReturn(parent);
// 每次 newTask() 返回一个新子任务桩
Task sub = org.mockito.Mockito.mock(Task.class);
when(taskService.newTask()).thenReturn(sub);
mvc.perform(post("/api/flow/tasks/task-9/assist")
.contentType("application/json")
.content("{\"comment\":\"请协助\",\"targetUserIds\":[\"u-a\",\"u-b\"]}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.assisted").value(true))
.andExpect(jsonPath("$.count").value(2));
// 两个子任务:各设受托人/父任务/名称「协办」后保存
verify(sub).setAssignee("u-a");
verify(sub).setAssignee("u-b");
verify(sub, org.mockito.Mockito.times(2)).setParentTaskId("task-9");
verify(sub, org.mockito.Mockito.times(2)).setName("协办");
verify(taskService, org.mockito.Mockito.times(2)).saveTask(sub);
verify(taskService).addComment("task-9", "pi-9", "请协助");
}
@Test
void 转阅为每个目标用户建转阅任务并存formKey() throws Exception {
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("task-10")).thenReturn(taskQuery);
Task parent = org.mockito.Mockito.mock(Task.class);
when(parent.getProcessInstanceId()).thenReturn("pi-10");
when(parent.getFormKey()).thenReturn("wf-tpl-77"); // FormKeyResolver: 原始非空直接返回
when(taskQuery.singleResult()).thenReturn(parent);
Task copy = org.mockito.Mockito.mock(Task.class);
when(taskService.newTask()).thenReturn(copy);
mvc.perform(post("/api/flow/tasks/task-10/circulate")
.contentType("application/json")
.content("{\"comment\":\"请阅\",\"targetUserIds\":[\"u-c\"]}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.circulated").value(true))
.andExpect(jsonPath("$.count").value(1));
verify(copy).setName("转阅");
verify(copy).setAssignee("u-c");
verify(copy).setFormKey("wf-tpl-77"); // 用 setFormKey 而非 description,审批渲染 FormKeyResolver 直接命中
verify(copy).setParentTaskId("task-10");
verify(taskService).saveTask(copy);
}
@Test
void 转阅父任务不存在返回404() throws Exception {
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("nope")).thenReturn(taskQuery);
when(taskQuery.singleResult()).thenReturn(null);
mvc.perform(post("/api/flow/tasks/nope/circulate")
.contentType("application/json")
.content("{\"targetUserIds\":[\"u-c\"]}"))
.andExpect(status().isNotFound());
}
@Test
void 协办独立任务approvalContext回溯父任务取业务上下文() throws Exception {
// 协办/转阅建的是独立任务:无 processInstanceId,有 parentTaskId。审批上下文须回溯父任务取 businessKey/formKey,
// 否则协办人/转阅人打开看不到业务单据(code review HIGH 修复点)。
when(taskService.createTaskQuery()).thenReturn(taskQuery);
Task sub = org.mockito.Mockito.mock(Task.class);
when(sub.getName()).thenReturn("协办");
when(sub.getProcessInstanceId()).thenReturn(null);
when(sub.getParentTaskId()).thenReturn("parent-1");
when(sub.getFormKey()).thenReturn(null);
TaskQuery subQuery = org.mockito.Mockito.mock(TaskQuery.class);
when(taskQuery.taskId("sub-1")).thenReturn(subQuery);
when(subQuery.singleResult()).thenReturn(sub);
// 父任务:真实流程任务,带 processInstanceId/formKey
Task parent = org.mockito.Mockito.mock(Task.class);
when(parent.getProcessInstanceId()).thenReturn("pi-1");
when(parent.getFormKey()).thenReturn("wf-77");
when(parent.getProcessDefinitionId()).thenReturn("def-1");
when(parent.getTaskDefinitionKey()).thenReturn("node-a");
TaskQuery parentQuery = org.mockito.Mockito.mock(TaskQuery.class);
when(taskQuery.taskId("parent-1")).thenReturn(parentQuery);
when(parentQuery.singleResult()).thenReturn(parent);
// 父流程实例 businessKey
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-1")).thenReturn(processInstanceQuery);
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(pi.getBusinessKey()).thenReturn("BK-1");
when(processInstanceQuery.singleResult()).thenReturn(pi);
mvc.perform(get("/api/flow/tasks/sub-1/approval-context"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.formKey").value("wf-77"))
.andExpect(jsonPath("$.businessKey").value("BK-1"))
.andExpect(jsonPath("$.processInstanceId").value("pi-1"));
}
@Test
void 会签任务approvalContext回填会签进度() throws Exception {
// 会签(多实例)任务:approval-context 沿执行树向上找带 nrOfInstances 的多实例根执行,回填进度
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("mi-1")).thenReturn(taskQuery);
Task t = org.mockito.Mockito.mock(Task.class);
when(t.getProcessInstanceId()).thenReturn("pi-mi");
when(t.getExecutionId()).thenReturn("exec-leaf");
when(taskQuery.singleResult()).thenReturn(t);
// fillCosign:叶执行无 nrOfInstances → 向上到根执行命中
when(runtimeService.getVariablesLocal("exec-leaf")).thenReturn(java.util.Map.of());
when(runtimeService.getVariablesLocal("exec-root"))
.thenReturn(java.util.Map.of("nrOfInstances", 3, "nrOfCompletedInstances", 1));
var execQuery = org.mockito.Mockito.mock(org.flowable.engine.runtime.ExecutionQuery.class);
when(runtimeService.createExecutionQuery()).thenReturn(execQuery);
when(execQuery.executionId("exec-leaf")).thenReturn(execQuery);
org.flowable.engine.runtime.Execution leaf = org.mockito.Mockito.mock(org.flowable.engine.runtime.Execution.class);
when(leaf.getParentId()).thenReturn("exec-root");
when(execQuery.singleResult()).thenReturn(leaf);
// 业务实例查不到(聚焦会签字段),走 PI null 分支
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-mi")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("pi-mi")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/tasks/mi-1/approval-context"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.cosign").value(true))
.andExpect(jsonPath("$.cosignTotal").value(3))
.andExpect(jsonPath("$.cosignCompleted").value(1));
}
@Test
void 协办超过上限返回400() throws Exception {
StringBuilder ids = new StringBuilder("[");
for (int i = 0; i < 51; i++) {
ids.append(i == 0 ? "" : ",").append("\"u").append(i).append("\"");
}
ids.append("]");
mvc.perform(post("/api/flow/tasks/t/assist")
.contentType("application/json")
.content("{\"targetUserIds\":" + ids + "}"))
.andExpect(status().isBadRequest());
}
} }

View File

@@ -0,0 +1,257 @@
package com.eip4.flowservice.api;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import java.io.ByteArrayInputStream;
import java.nio.charset.StandardCharsets;
import java.util.List;
import org.flowable.engine.HistoryService;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.history.HistoricActivityInstance;
import org.flowable.engine.history.HistoricActivityInstanceQuery;
import org.flowable.engine.history.HistoricProcessInstance;
import org.flowable.engine.history.HistoricProcessInstanceQuery;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.engine.repository.ProcessDefinitionQuery;
import org.flowable.engine.runtime.ProcessInstance;
import org.flowable.engine.runtime.ProcessInstanceQuery;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
/**
* 流程图端点薄层单测:mock 引擎,验证 BPMN XML 透出 + 当前/历史节点收敛 + 实例不存在降级。
*/
@ExtendWith(MockitoExtension.class)
class ProcessDiagramControllerTest {
@Mock RepositoryService repositoryService;
@Mock RuntimeService runtimeService;
@Mock HistoryService historyService;
@Mock ProcessInstanceQuery processInstanceQuery;
@Mock HistoricProcessInstanceQuery historicProcessInstanceQuery;
@Mock HistoricActivityInstanceQuery historicActivityInstanceQuery;
@Mock ProcessDefinitionQuery processDefinitionQuery;
MockMvc mvc;
@BeforeEach
void setUp() {
ProcessDiagramController controller = new ProcessDiagramController(repositoryService, runtimeService, historyService);
mvc = MockMvcBuilders.standaloneSetup(controller).build();
}
@Test
void 运行中流程返回XML与当前及历史节点() throws Exception {
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(pi.getProcessDefinitionId()).thenReturn("def-1");
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-1")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(pi);
when(runtimeService.getActiveActivityIds("pi-1")).thenReturn(List.of("task_b"));
String xml = "<?xml version=\"1.0\"?><definitions><process id=\"p\"/></definitions>";
when(repositoryService.getProcessModel("def-1"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
HistoricActivityInstance a1 = org.mockito.Mockito.mock(HistoricActivityInstance.class);
when(a1.getActivityId()).thenReturn("task_a");
when(historyService.createHistoricActivityInstanceQuery()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.processInstanceId("pi-1")).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.finished()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.list()).thenReturn(List.<HistoricActivityInstance>of(a1));
mvc.perform(get("/api/flow/process/pi-1/diagram"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.bpmnXml").value(xml))
.andExpect(jsonPath("$.activeActivityIds[0]").value("task_b"))
.andExpect(jsonPath("$.finishedActivityIds[0]").value("task_a"));
}
@Test
void 已结束流程走历史取XML无当前节点() throws Exception {
// 运行库查不到
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-2")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
// 历史库查得 procDefId
HistoricProcessInstance hpi = org.mockito.Mockito.mock(HistoricProcessInstance.class);
when(hpi.getProcessDefinitionId()).thenReturn("def-2");
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("pi-2")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(hpi);
String xml = "<definitions/>";
when(repositoryService.getProcessModel("def-2"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
when(historyService.createHistoricActivityInstanceQuery()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.processInstanceId("pi-2")).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.finished()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.list()).thenReturn(List.<HistoricActivityInstance>of());
mvc.perform(get("/api/flow/process/pi-2/diagram"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.bpmnXml").value(xml))
.andExpect(jsonPath("$.activeActivityIds").isEmpty());
}
@Test
void 实例不存在返回found_false不报错() throws Exception {
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId(eq("nope"))).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("nope")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/process/nope/diagram"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void sanitizeBpmnIds_中文id重写为安全ascii并同步引用与节点() {
// 迁移 BPMN 用中文 process id + 中文 diagram id,bpmn-js 拒非 ASCII NCName。重写后引用须一致,name 不动。
String xml = "<definitions>"
+ "<process id=\"招投标流程\" name=\"招投标流程\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"招投标流程\" targetRef=\"sid-A\"/>"
+ "</process>"
+ "<bpmndi:BPMNDiagram id=\"BPMNDiagram_招投标流程\">"
+ "<bpmndi:BPMNPlane bpmnElement=\"招投标流程\"/>"
+ "</bpmndi:BPMNDiagram></definitions>";
List<String> active = new java.util.ArrayList<>(List.of("sid-A"));
List<String> finished = new java.util.ArrayList<>(List.of("招投标流程"));
String out = ProcessDiagramController.sanitizeBpmnIds(xml, active, finished);
// 中文 id 不再出现在 id/ref 属性里,但 name 保留中文
org.junit.jupiter.api.Assertions.assertFalse(out.contains("id=\"招投标流程\""));
org.junit.jupiter.api.Assertions.assertFalse(out.contains("bpmnElement=\"招投标流程\""));
org.junit.jupiter.api.Assertions.assertFalse(out.contains("sourceRef=\"招投标流程\""));
org.junit.jupiter.api.Assertions.assertTrue(out.contains("name=\"招投标流程\"")); // 展示名不动
org.junit.jupiter.api.Assertions.assertTrue(out.contains("id=\"sid-A\"")); // 合法 id 不动
// 同一中文 id 的所有引用映射到同一安全 id(process id 与 sourceRef/bpmnElement 一致)
java.util.regex.Matcher m = java.util.regex.Pattern.compile("<process id=\"(n[0-9a-f]+)\"").matcher(out);
org.junit.jupiter.api.Assertions.assertTrue(m.find());
String safe = m.group(1);
org.junit.jupiter.api.Assertions.assertTrue(out.contains("sourceRef=\"" + safe + "\""));
org.junit.jupiter.api.Assertions.assertTrue(out.contains("bpmnElement=\"" + safe + "\""));
// 历史节点 id 同步重映射,当前节点 sid-A 不变
org.junit.jupiter.api.Assertions.assertEquals(safe, finished.get(0));
org.junit.jupiter.api.Assertions.assertEquals("sid-A", active.get(0));
}
@Test
void source_按procDefId返净化XML与idMap及key版本() throws Exception {
// 存量流程 process id 为中文(如「总包合同交底」),moddle 载入前须净化;端点透出原→净化映射供发布时逆向。
ProcessDefinition def = org.mockito.Mockito.mock(ProcessDefinition.class);
when(def.getKey()).thenReturn("总包合同交底");
when(def.getVersion()).thenReturn(3);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-1")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
String xml = "<definitions>"
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
+ "</process></definitions>";
when(repositoryService.getProcessModel("def-1"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
mvc.perform(get("/api/flow/process-definitions/def-1/source"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.procDefKey").value("总包合同交底"))
.andExpect(jsonPath("$.version").value(3))
// idMap 非空且含中文原 key;净化后 XML 的 id 属性不再含中文(name 展示位不受影响)
.andExpect(jsonPath("$.idMap").isNotEmpty())
.andExpect(jsonPath("$.idMap['总包合同交底']").isNotEmpty())
.andExpect(jsonPath("$.bpmnXml",
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("id=\"总包合同交底\""))))
// sequenceFlow 的 sourceRef 引用也须随 process id 一致重写,不白放(评审 M-1)
.andExpect(jsonPath("$.bpmnXml",
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("sourceRef=\"总包合同交底\""))));
}
@Test
void source_定义不存在返found_false() throws Exception {
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("nope")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/process-definitions/nope/source"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void sourceByKey_按key命中返最新版净化XML与idMap及版本() throws Exception {
// process-select options 的 source='model' 项 id 是 act_re_model id(非 procDefId),by-id 永远 found:false;
// 打开器改用 option.key(真流程 key)走本端点。latestVersion() 在两版本(v1/v2)里取 v2。
ProcessDefinition v2 = org.mockito.Mockito.mock(ProcessDefinition.class);
when(v2.getId()).thenReturn("总包合同交底:2:aa22");
when(v2.getKey()).thenReturn("总包合同交底");
when(v2.getVersion()).thenReturn(2);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionKey("总包合同交底")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(v2);
String xml = "<definitions>"
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
+ "</process></definitions>";
when(repositoryService.getProcessModel("总包合同交底:2:aa22"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
mvc.perform(get("/api/flow/process-definitions/by-key/{key}/source", "总包合同交底"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.procDefId").value("总包合同交底:2:aa22"))
.andExpect(jsonPath("$.procDefKey").value("总包合同交底"))
.andExpect(jsonPath("$.version").value(2))
.andExpect(jsonPath("$.idMap['总包合同交底']").isNotEmpty())
.andExpect(jsonPath("$.bpmnXml",
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("id=\"总包合同交底\""))));
}
@Test
void sourceByKey_key不存在返found_false() throws Exception {
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionKey("无此流程")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/process-definitions/by-key/{key}/source", "无此流程"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void source_读取XML异常返found_false不抛500() throws Exception {
ProcessDefinition def = org.mockito.Mockito.mock(ProcessDefinition.class);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-x")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
when(repositoryService.getProcessModel("def-x")).thenThrow(new RuntimeException("boom"));
mvc.perform(get("/api/flow/process-definitions/def-x/source"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
}

View File

@@ -0,0 +1,743 @@
package com.eip4.flowservice.api;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import java.io.ByteArrayInputStream;
import java.nio.charset.StandardCharsets;
import java.util.Date;
import java.util.List;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.repository.Deployment;
import org.flowable.engine.repository.DeploymentBuilder;
import org.flowable.engine.repository.Model;
import org.flowable.engine.repository.ModelQuery;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.engine.repository.ProcessDefinitionQuery;
import org.flowable.engine.runtime.ProcessInstanceQuery;
import org.flowable.validation.ProcessValidator;
import org.flowable.validation.ValidationError;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.ArgumentCaptor;
import org.mockito.Mock;
import org.mockito.Mockito;
import org.mockito.junit.jupiter.MockitoExtension;
import org.springframework.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
/**
* 流程草稿 CRUD 端点薄层单测:mock RepositoryService + Model API(newModel/saveModel/addModelEditorSource/
* getModelEditorSource/createModelQuery),验证列表/取草稿/建草稿(坏 XML 不落库)/PUT 404/from-procdef
* 净化 XML 与 idMap 落 metaInfo。standaloneSetup 不挂 FlowExceptionHandler——422/404 由控制器本地 ResponseEntity
* 显式产出(不经引擎异常映射)。
*/
@ExtendWith(MockitoExtension.class)
class ProcessModelControllerTest {
@Mock RepositoryService repositoryService;
@Mock ModelQuery modelQuery;
@Mock ProcessDefinitionQuery processDefinitionQuery;
MockMvc mvc;
// 最小 schema 合法 BPMN(default ns=BPMN20 MODEL)。
private static final String VALID_BPMN = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" targetNamespace=\"http://eip4\">"
+ "<process id=\"p1\" name=\"p1\">"
+ "<startEvent id=\"start\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"start\" targetRef=\"end\"/>"
+ "<endEvent id=\"end\"/>"
+ "</process></definitions>";
// bpmn-js saveXML 风格:默认命名空间(无前缀 definitions/process)+ 带前缀 BPMNDI 布局段。
// 此处 BPMNDiagram 排在 process 之前(触发严格 XSD 的 cvc-complex-type.2.4.a 序列违例——definitions 内容
// 模型要求 rootElement* 在 BPMNDiagram* 之前)——模拟 bpmn-js 输出被严格 XSD 拒的真实故障族。
// 草稿保存关 validateSchema 后应良构解析通过 → 200。
private static final String BPMN_JS_STYLE = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\""
+ " xmlns:bpmndi=\"http://www.omg.org/spec/BPMN/20100524/DI\""
+ " xmlns:dc=\"http://www.omg.org/spec/DD/20100524/DC\""
+ " xmlns:di=\"http://www.omg.org/spec/DD/20100524/DI\""
+ " id=\"Definitions_1\" targetNamespace=\"http://bpmn.io/schema/bpmn\">"
+ "<bpmndi:BPMNDiagram id=\"BPMNDiagram_1\">"
+ "<bpmndi:BPMNPlane id=\"BPMNPlane_1\" bpmnElement=\"Process_1\">"
+ "<bpmndi:BPMNShape id=\"StartEvent_1_di\" bpmnElement=\"StartEvent_1\">"
+ "<dc:Bounds x=\"152\" y=\"82\" width=\"36\" height=\"36\"/>"
+ "</bpmndi:BPMNShape></bpmndi:BPMNPlane></bpmndi:BPMNDiagram>"
+ "<process id=\"Process_1\" isExecutable=\"true\">"
+ "<startEvent id=\"StartEvent_1\" name=\"开始\"/>"
+ "</process></definitions>";
// 含 DOCTYPE 声明(XXE 面):正文良构、关严格 XSD 后本可解析,但字节级 DOCTYPE 守卫必须拒。
private static final String DOCTYPE_XML = "<?xml version=\"1.0\"?>"
+ "<!DOCTYPE definitions [<!ENTITY xxe \"payload\">]>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\">"
+ "<process id=\"p1\"><startEvent id=\"s\"/></process></definitions>";
// 存量流程编辑器导出态(发布路径 fixture):process id + sequenceFlow id 原为中文,已被 sanitize 成净化 id
// (n1a2b3c / nflow1 / nflow2);bpmn-js saveXML 给流节点补了 <incoming>/<outgoing> 文本引用(内含净化 id)。
// metaInfo.eip4IdMap 记「中文原 id→净化 id」,发布时 restore 逆向还原。model.key=中文原 key「总包合同交底」。
private static final String DRAFT_SANITIZED_XML = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" targetNamespace=\"http://eip4\">"
+ "<process id=\"n1a2b3c\" name=\"总包合同交底\" isExecutable=\"true\">"
+ "<startEvent id=\"start1\"><outgoing>nflow1</outgoing></startEvent>"
+ "<userTask id=\"taskA\" name=\"交底\"><incoming>nflow1</incoming><outgoing>nflow2</outgoing></userTask>"
+ "<endEvent id=\"end1\"><incoming>nflow2</incoming></endEvent>"
+ "<sequenceFlow id=\"nflow1\" sourceRef=\"start1\" targetRef=\"taskA\"/>"
+ "<sequenceFlow id=\"nflow2\" sourceRef=\"taskA\" targetRef=\"end1\"/>"
+ "</process></definitions>";
// 对应上面 fixture 的 metaInfo:eip4IdMap 三条(process + 两条 sequenceFlow) + sourceProcDefId + 中文 originalKey。
private static final String DRAFT_META_INFO = "{\"eip4IdMap\":{\"总包合同交底\":\"n1a2b3c\","
+ "\"流转1\":\"nflow1\",\"流转2\":\"nflow2\"},\"sourceProcDefId\":\"def-1\",\"originalKey\":\"总包合同交底\"}";
@BeforeEach
void setUp() {
ProcessModelController controller = new ProcessModelController(repositoryService);
mvc = MockMvcBuilders.standaloneSetup(controller).build();
}
@Test
void 列表只查eip4分类并按最近更新降序返回id名key时间() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("m1");
when(m.getName()).thenReturn("总包合同交底");
when(m.getKey()).thenReturn("总包合同交底");
when(m.getLastUpdateTime()).thenReturn(new Date(0L)); // 1970-01-01T00:00:00Z
when(repositoryService.createModelQuery()).thenReturn(modelQuery);
when(modelQuery.modelCategory("eip4")).thenReturn(modelQuery);
when(modelQuery.orderByLastUpdateTime()).thenReturn(modelQuery);
when(modelQuery.desc()).thenReturn(modelQuery);
when(modelQuery.list()).thenReturn(List.of(m));
mvc.perform(get("/api/flow/models"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.models[0].id").value("m1"))
.andExpect(jsonPath("$.models[0].name").value("总包合同交底"))
.andExpect(jsonPath("$.models[0].key").value("总包合同交底"))
.andExpect(jsonPath("$.models[0].lastUpdateTime").value("1970-01-01T00:00:00Z"));
// 列表只列 EIP4 建的草稿:隔离库里 143 条老 shape 存量 act_re_model(打不开)
verify(modelQuery).modelCategory("eip4");
}
@Test
void 取草稿返回XML与metaInfo() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("m1");
when(m.getName()).thenReturn("总包合同交底");
when(m.getKey()).thenReturn("总包合同交底");
when(m.getMetaInfo()).thenReturn("{\"eip4IdMap\":{\"总包合同交底\":\"n1\"}}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn("<definitions/>".getBytes(StandardCharsets.UTF_8));
mvc.perform(get("/api/flow/models/m1"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.id").value("m1"))
.andExpect(jsonPath("$.key").value("总包合同交底"))
.andExpect(jsonPath("$.bpmnXml").value("<definitions/>"))
.andExpect(jsonPath("$.metaInfo").value("{\"eip4IdMap\":{\"总包合同交底\":\"n1\"}}"));
}
@Test
void 取草稿_model不存在返found_false() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
mvc.perform(get("/api/flow/models/nope"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void 取草稿_editorSource为空返found_false() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m2")).thenReturn(m);
when(repositoryService.getModelEditorSource("m2")).thenReturn(null);
mvc.perform(get("/api/flow/models/m2"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void 建草稿_合法XML落库返modelId() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("newid");
when(repositoryService.newModel()).thenReturn(m);
String body = "{\"name\":\"新流程\",\"key\":\"newproc\",\"bpmnXml\":"
+ jsonString(VALID_BPMN) + ",\"metaInfo\":\"{}\"}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.modelId").value("newid"));
verify(m).setName("新流程");
verify(m).setKey("newproc");
verify(m).setCategory("eip4"); // 建草稿打 EIP4 分类,供 list() 过滤隔离存量
verify(repositoryService).saveModel(m);
ArgumentCaptor<byte[]> src = ArgumentCaptor.forClass(byte[].class);
verify(repositoryService).addModelEditorSource(eq("newid"), src.capture());
org.junit.jupiter.api.Assertions.assertTrue(
new String(src.getValue(), StandardCharsets.UTF_8).contains("<process id=\"p1\""));
}
@Test
void 建草稿_空白name或key返422且不落库() throws Exception {
// key 是 T3.1 部署资源名/中文原 key 还原的依赖:空白一律拒,在解析守卫之前拦。
String body = "{\"name\":\" \",\"key\":\"\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
verify(repositoryService, never()).newModel();
verify(repositoryService, never()).saveModel(any());
}
@Test
void 建草稿_坏XML返422且不落库() throws Exception {
String body = "{\"name\":\"坏流程\",\"key\":\"bad\",\"bpmnXml\":"
+ jsonString("<definitions><broken") + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
// 解析守卫先于任何写:坏 XML 一律不落库
verify(repositoryService, never()).newModel();
verify(repositoryService, never()).saveModel(any());
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
}
@Test
void 建草稿_bpmnJs默认命名空间输出_关严格XSD后200落库() throws Exception {
// 回归锚点:bpmn-js saveXML 默认命名空间输出被严格 XSD 拒(改前必红=422)。草稿保存不该做完整 XSD 校验
// (完整校验属部署时 ProcessValidator,非 XSD)→ 关 validateSchema 后良构解析通过 → 200 建草稿成功。
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("draft-js");
when(repositoryService.newModel()).thenReturn(m);
String body = "{\"name\":\"新流程\",\"key\":\"newproc\",\"bpmnXml\":" + jsonString(BPMN_JS_STYLE) + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.modelId").value("draft-js"));
verify(repositoryService).saveModel(m);
verify(repositoryService).addModelEditorSource(eq("draft-js"), any());
}
@Test
void 建草稿_含DOCTYPE声明_字节级XXE守卫返422不落库() throws Exception {
// 正文良构(关 XSD 后本可解析),但 DOCTYPE 声明是 XXE 面 → 解析前字节级守卫拒,不依赖 flowable 内部实现。
String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":" + jsonString(DOCTYPE_XML) + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
}
@Test
void 建草稿_非良构XML_关严格XSD后仍返422不落库() throws Exception {
// 关 validateSchema=false 仅关严格 XSD,仍解析:标签不匹配是非良构 XML,解析必抛 → 422。
String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":"
+ jsonString("<definitions><process></definitions>") + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
}
@Test
void 更新_草稿不存在返404() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
String body = "{\"name\":\"x\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
mvc.perform(put("/api/flow/models/nope").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
}
@Test
void 更新_合法XML更新name与editorSource返status0() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
String body = "{\"name\":\"改名\",\"bpmnXml\":" + jsonString(VALID_BPMN) + ",\"metaInfo\":\"{}\"}";
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0));
verify(m).setName("改名");
verify(m).setMetaInfo("{}");
verify(repositoryService).saveModel(m);
verify(repositoryService).addModelEditorSource(eq("m1"), any());
}
@Test
void 更新_只带name不带metaInfo时不改metaInfo() throws Exception {
// 草稿的 eip4IdMap 存于 metaInfo,普通保存草稿只发 name+XML 不重发 metaInfo:此时绝不能 setMetaInfo(null)
// 抹掉它——这是 T3.1 发布逆向还原原 key 的命根契约。
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
String body = "{\"name\":\"只改名\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0));
verify(m).setName("只改名");
verify(m, never()).setMetaInfo(any());
verify(repositoryService).saveModel(m);
verify(repositoryService).addModelEditorSource(eq("m1"), any());
}
@Test
void 更新_坏XML返422且不落库() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
String body = "{\"name\":\"x\",\"bpmnXml\":" + jsonString("<nope") + "}";
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
}
@Test
void 删草稿_存在则删除返status0() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
mvc.perform(delete("/api/flow/models/m1"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0));
verify(repositoryService).deleteModel("m1");
}
@Test
void 删草稿_不存在返404不删除() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
mvc.perform(delete("/api/flow/models/nope"))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).deleteModel(anyString());
}
@Test
void fromProcDef_净化XML与idMap落metaInfo() throws Exception {
// 存量流程 process id 为中文,from-procdef 净化后建草稿:editorSource 无中文 id,metaInfo JSON 含
// eip4IdMap + sourceProcDefId + 中文 originalKey(发布时逆向还原原 key)。
ProcessDefinition def = Mockito.mock(ProcessDefinition.class);
when(def.getName()).thenReturn("总包合同交底");
when(def.getKey()).thenReturn("总包合同交底");
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-1")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
String xml = "<definitions>"
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
+ "</process></definitions>";
when(repositoryService.getProcessModel("def-1"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("draft-1");
when(repositoryService.newModel()).thenReturn(m);
String body = "{\"procDefId\":\"def-1\"}";
mvc.perform(post("/api/flow/models/from-procdef").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.modelId").value("draft-1"));
verify(m).setName("总包合同交底");
verify(m).setKey("总包合同交底");
verify(m).setCategory("eip4"); // from-procdef 建的草稿同样打 EIP4 分类
// metaInfo:JSON 含 eip4IdMap + sourceProcDefId + 中文 originalKey
ArgumentCaptor<String> meta = ArgumentCaptor.forClass(String.class);
verify(m).setMetaInfo(meta.capture());
String metaJson = meta.getValue();
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("eip4IdMap"), metaJson);
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("\"sourceProcDefId\":\"def-1\""), metaJson);
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("\"originalKey\":\"总包合同交底\""), metaJson);
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("总包合同交底"), metaJson); // idMap 键含中文原 id
// editorSource:净化后 XML 不再含中文 id(id/ref 属性),name 保留中文
ArgumentCaptor<byte[]> src = ArgumentCaptor.forClass(byte[].class);
verify(repositoryService).addModelEditorSource(eq("draft-1"), src.capture());
String savedXml = new String(src.getValue(), StandardCharsets.UTF_8);
org.junit.jupiter.api.Assertions.assertFalse(savedXml.contains("id=\"总包合同交底\""), savedXml);
org.junit.jupiter.api.Assertions.assertFalse(savedXml.contains("sourceRef=\"总包合同交底\""), savedXml);
org.junit.jupiter.api.Assertions.assertTrue(savedXml.contains("name=\"总包合同交底\""), savedXml);
}
@Test
void fromProcDef_procDef不存在返found_false不落库() throws Exception {
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("nope")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null);
mvc.perform(post("/api/flow/models/from-procdef")
.contentType(MediaType.APPLICATION_JSON).content("{\"procDefId\":\"nope\"}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
verify(repositoryService, never()).newModel();
}
@Test
void fromProcDef_BPMN读取为空返found_false不落库() throws Exception {
// procDef 存在但部署 BPMN 资源读不出(getProcessModel 返 null)→ 降级 found:false,不建空草稿。
ProcessDefinition def = Mockito.mock(ProcessDefinition.class);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-empty")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
when(repositoryService.getProcessModel("def-empty")).thenReturn(null);
mvc.perform(post("/api/flow/models/from-procdef")
.contentType(MediaType.APPLICATION_JSON).content("{\"procDefId\":\"def-empty\"}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
verify(repositoryService, never()).newModel();
}
// ===== T3.1 发布(deploy)/ 影响摘要(impact) =====
/** 建带 mock ProcessValidator + RuntimeService 的控制器与 MockMvc(发布/影响端点专用,校验器须可 mock)。 */
private MockMvc deployMvc(RuntimeService runtimeService, ProcessValidator validator) {
return MockMvcBuilders.standaloneSetup(
new ProcessModelController(repositoryService, runtimeService, validator)).build();
}
@Test
void 发布_还原中文原key与剥除incoming_outgoing后部署XML无残留净化id且disableSchemaValidation() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getName()).thenReturn("总包合同交底");
when(m.getKey()).thenReturn("总包合同交底"); // 中文原 key(from-procdef 时存,发布资源名/还原目标)
when(m.getMetaInfo()).thenReturn(DRAFT_META_INFO);
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
// 校验器无 ERROR → 放行部署。
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of());
// 部署链 mock:disableSchemaValidation().name().addString().deploy()。
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
when(repositoryService.createDeployment()).thenReturn(db);
when(db.disableSchemaValidation()).thenReturn(db);
when(db.name(any())).thenReturn(db);
when(db.addString(anyString(), anyString())).thenReturn(db);
Deployment dep = Mockito.mock(Deployment.class);
when(dep.getId()).thenReturn("dep-1");
when(db.deploy()).thenReturn(dep);
ProcessDefinition deployed = Mockito.mock(ProcessDefinition.class);
when(deployed.getKey()).thenReturn("总包合同交底");
when(deployed.getVersion()).thenReturn(2);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.deploymentId("dep-1")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(deployed);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0))
.andExpect(jsonPath("$.deploymentId").value("dep-1"))
.andExpect(jsonPath("$.processKey").value("总包合同交底"))
.andExpect(jsonPath("$.newVersion").value(2));
// disableSchemaValidation 必被调用(防有人回退成严格 XSD,咬 bpmn-js 默认命名空间输出→cvc-complex-type)。
verify(db).disableSchemaValidation();
// 捕获部署 XML:属性位还原为中文原 key/流 id,incoming/outgoing 文本引用剥除 → 全程无残留净化 id。
ArgumentCaptor<String> deployXml = ArgumentCaptor.forClass(String.class);
verify(db).addString(eq("总包合同交底.bpmn20.xml"), deployXml.capture());
String xml = deployXml.getValue();
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"总包合同交底\""), xml);
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"流转1\""), xml);
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"流转2\""), xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("n1a2b3c"), "残留净化 process id: " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("nflow1"), "残留净化流 id(incoming/outgoing 未剥除): " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("nflow2"), "残留净化流 id(incoming/outgoing 未剥除): " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("<incoming>"), "incoming 元素未剥除: " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("<outgoing>"), "outgoing 元素未剥除: " + xml);
}
@Test
void 发布_ProcessValidator_ERROR级返422带明细且不部署() throws Exception {
Model m = Mockito.mock(Model.class);
// metaInfo 默认 null → 无 idMap(新建流程分支,不还原);getKey 在 ERROR 返回前不会被读,不 stub 免 strict-stub。
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
ValidationError err = new ValidationError();
err.setActivityId("taskA");
err.setProblem("flowable-usertask-no-assignment");
err.setDefaultDescription("用户任务无办理人");
err.setWarning(false);
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of(err));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.errors[0].activityId").value("taskA"))
.andExpect(jsonPath("$.errors[0].problem").value("flowable-usertask-no-assignment"))
.andExpect(jsonPath("$.errors[0].defaultDescription").value("用户任务无办理人"));
// ERROR 级校验失败 → 绝不部署。
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_ProcessValidator仅WARNING放行部署() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getName()).thenReturn("新流程");
when(m.getKey()).thenReturn("newproc");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
ValidationError warn = new ValidationError();
warn.setActivityId("taskA");
warn.setProblem("some-warning");
warn.setWarning(true);
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of(warn));
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
when(repositoryService.createDeployment()).thenReturn(db);
when(db.disableSchemaValidation()).thenReturn(db);
when(db.name(any())).thenReturn(db);
when(db.addString(anyString(), anyString())).thenReturn(db);
Deployment dep = Mockito.mock(Deployment.class);
when(dep.getId()).thenReturn("dep-2");
when(db.deploy()).thenReturn(dep);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.deploymentId("dep-2")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null); // 查不到也不炸:回退 model.key/0
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0))
.andExpect(jsonPath("$.deploymentId").value("dep-2"))
.andExpect(jsonPath("$.processKey").value("newproc"))
.andExpect(jsonPath("$.newVersion").value(0));
// 仅 WARNING → 放行:部署照常发生。
verify(db).deploy();
}
@Test
void 发布_草稿不存在返404不部署() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/nope/deploy"))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).createDeployment();
}
@Test
void 影响摘要_还原后解析processKey返当前版本与运行实例数() throws Exception {
Model m = Mockito.mock(Model.class);
// processKey 取自还原后 XML 的 <process id>(=总包合同交底),不读 model.getKey → 不 stub 免 strict-stub。
when(m.getMetaInfo()).thenReturn(DRAFT_META_INFO);
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
ProcessDefinition latest = Mockito.mock(ProcessDefinition.class);
when(latest.getVersion()).thenReturn(3);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionKey("总包合同交底")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(latest);
RuntimeService runtimeService = Mockito.mock(RuntimeService.class);
ProcessInstanceQuery piq = Mockito.mock(ProcessInstanceQuery.class);
when(runtimeService.createProcessInstanceQuery()).thenReturn(piq);
when(piq.processDefinitionKey("总包合同交底")).thenReturn(piq);
when(piq.count()).thenReturn(5L);
MockMvc localMvc = deployMvc(runtimeService, Mockito.mock(ProcessValidator.class));
localMvc.perform(get("/api/flow/models/m1/impact"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.processKey").value("总包合同交底"))
.andExpect(jsonPath("$.currentVersion").value(3))
.andExpect(jsonPath("$.runningInstances").value(5));
}
@Test
void 影响摘要_草稿不存在返404() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(get("/api/flow/models/nope/impact"))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
}
@Test
void 发布_非双射idMap_restore_fail_fast返422不部署() throws Exception {
// metaInfo 的 eip4IdMap 两个中文原 id 映射到同一净化 id(n1)→restore 反转检测到非双射抛 IllegalArgumentException
// →deploy catch→422,绝不部署(损坏映射还原会指错 key)。
Model m = Mockito.mock(Model.class);
when(m.getMetaInfo()).thenReturn("{\"eip4IdMap\":{\"总包合同交底\":\"n1\",\"其他流程\":\"n1\"}}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_存量草稿metaInfo缺eip4IdMap_fail_fast返422不部署() throws Exception {
// I1 坏 key 地雷:from-procdef 标记(sourceProcDefId/originalKey)在但 eip4IdMap 键丢了→editorSource 是净化 nXXX
// 却无从还原→绝不能静默塌成「空 idMap 跳过还原」部署出 key=nXXX(违 D7)→resolveIdMap fail-fast→422 不部署。
Model m = Mockito.mock(Model.class);
when(m.getMetaInfo()).thenReturn("{\"sourceProcDefId\":\"def-1\",\"originalKey\":\"总包合同交底\"}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_metaInfo解析失败_fail_fast返422不部署() throws Exception {
// 非空 metaInfo 却是坏 JSON:无从确认是不是存量草稿→宁拒不发(可能的坏 key)→resolveIdMap fail-fast→422 不部署。
Model m = Mockito.mock(Model.class);
when(m.getMetaInfo()).thenReturn("{坏JSON不可解析");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_存量草稿eip4IdMap为空_全ASCII流程不误拒正常部署() throws Exception {
// 防 I1 修过头:from-procdef 的全 ASCII 存量流程 sanitize 出空 eip4IdMap {}(present),editorSource 本就是 ASCII key,
// 无需还原→eip4IdMap 存在(空)即「可用」,不该被 fail-fast 误拒→正常部署。
Model m = Mockito.mock(Model.class);
when(m.getName()).thenReturn("ascii流程");
when(m.getKey()).thenReturn("asciiKey");
when(m.getMetaInfo())
.thenReturn("{\"eip4IdMap\":{},\"sourceProcDefId\":\"def-1\",\"originalKey\":\"asciiKey\"}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of());
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
when(repositoryService.createDeployment()).thenReturn(db);
when(db.disableSchemaValidation()).thenReturn(db);
when(db.name(any())).thenReturn(db);
when(db.addString(anyString(), anyString())).thenReturn(db);
Deployment dep = Mockito.mock(Deployment.class);
when(dep.getId()).thenReturn("dep-3");
when(db.deploy()).thenReturn(dep);
ProcessDefinition deployed = Mockito.mock(ProcessDefinition.class);
when(deployed.getKey()).thenReturn("p1");
when(deployed.getVersion()).thenReturn(1);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.deploymentId("dep-3")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(deployed);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0))
.andExpect(jsonPath("$.processKey").value("p1"));
verify(db).deploy();
}
@Test
void 发布_editorSource含DOCTYPE_字节级XXE守卫返422不部署() throws Exception {
// deploy 路径自带的字节级 DOCTYPE 守卫(还原后 XML 再过一道):即便存储的 editorSource 含 DOCTYPE(理论不该,
// 因写入端已拒),部署也在解析前拒,绝不部署。
Model m = Mockito.mock(Model.class);
// metaInfo 默认 null→真·新建分支,resolveIdMap 返空,prepareDeployXml 剥除+空还原=原样→deployXml 仍含 DOCTYPE。
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DOCTYPE_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).createDeployment();
}
/** 把任意字符串编成 JSON 字符串字面量(转义引号/反斜杠/换行),用于拼请求体。 */
private static String jsonString(String s) {
StringBuilder sb = new StringBuilder("\"");
for (int i = 0; i < s.length(); i++) {
char c = s.charAt(i);
switch (c) {
case '"' -> sb.append("\\\"");
case '\\' -> sb.append("\\\\");
case '\n' -> sb.append("\\n");
case '\r' -> sb.append("\\r");
case '\t' -> sb.append("\\t");
default -> sb.append(c);
}
}
return sb.append("\"").toString();
}
}

View File

@@ -13,5 +13,12 @@
<description>P5 占位:MCP Server、schema 双闸校验</description> <description>P5 占位:MCP Server、schema 双闸校验</description>
<dependencies> <dependencies>
<dependency><groupId>com.eip4</groupId><artifactId>platform-legacy-core</artifactId></dependency> <dependency><groupId>com.eip4</groupId><artifactId>platform-legacy-core</artifactId></dependency>
<dependency><groupId>com.eip4</groupId><artifactId>platform-converter</artifactId></dependency>
<dependency><groupId>com.eip4</groupId><artifactId>platform-metadata</artifactId></dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jdbc</artifactId></dependency>
<dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId></dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId></dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
</dependencies> </dependencies>
</project> </project>

View File

@@ -0,0 +1,10 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiAgentRepairContext(
String taskId,
String changeSetId,
AiRepairPlan repairPlan,
List<AiDraft> drafts) {
}

View File

@@ -0,0 +1,9 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiAgentRepairResult(
String status,
List<AiRepairDraftPatch> draftPatches,
List<String> messages) {
}

View File

@@ -0,0 +1,20 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiApplyRun(
String taskId,
String changeSetId,
String baseUrl,
String status,
long startedAt,
long finishedAt,
List<AiApplyStepResult> steps,
AiSmokeRun smokeRun) {
public boolean passed() {
boolean stepsPassed = steps != null && steps.stream()
.allMatch(s -> "APPLIED".equals(s.status()) || "SKIPPED".equals(s.status()));
return stepsPassed && smokeRun != null && smokeRun.passed();
}
}

View File

@@ -0,0 +1,12 @@
package com.eip4.platform.ai.model;
import java.util.Map;
public record AiApplyStepResult(
String id,
AiArtifactType artifactType,
String target,
String status,
String message,
Map<String, Object> details) {
}

View File

@@ -0,0 +1,15 @@
package com.eip4.platform.ai.model;
/**
* Agent 允许产生的受控产物类型。
*
* <p>这里刻意不用自由字符串:后续 MCP 工具、发布门禁和审计都需要按类型施加不同规则。
*/
public enum AiArtifactType {
ENTITY,
PAGE_SCHEMA,
SERVICEFLOW,
MENU,
CODE,
TEST
}

View File

@@ -0,0 +1,12 @@
package com.eip4.platform.ai.model;
import java.util.Map;
public record AiAuditEntry(
String id,
String taskId,
String action,
String actor,
long createdAt,
Map<String, Object> details) {
}

View File

@@ -0,0 +1,19 @@
package com.eip4.platform.ai.model;
public record AiAutoDevelopmentRequest(
AiFeatureRequest feature,
String baseUrl,
Boolean generateDeploymentPackage,
Integer maxRepairAttempts) {
public boolean shouldGenerateDeploymentPackage() {
return generateDeploymentPackage == null || generateDeploymentPackage;
}
public int repairAttemptLimit() {
if (maxRepairAttempts == null) {
return 2;
}
return Math.max(0, Math.min(5, maxRepairAttempts));
}
}

View File

@@ -0,0 +1,18 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiAutoDevelopmentRun(
String taskId,
String changeSetId,
String originalChangeSetId,
String status,
long startedAt,
long finishedAt,
AiFeatureDevelopment development,
AiReleasePlan releasePlan,
AiApplyRun applyRun,
AiDeploymentPackage deploymentPackage,
List<AiRepairExecution> repairExecutions,
List<String> messages) {
}

View File

@@ -0,0 +1,13 @@
package com.eip4.platform.ai.model;
import java.util.List;
import java.util.Map;
public record AiChangeSet(
String id,
String taskId,
String status,
long createdAt,
List<String> draftIds,
Map<String, Object> summary) {
}

View File

@@ -0,0 +1,17 @@
package com.eip4.platform.ai.model;
import java.util.List;
import java.util.Map;
public record AiDeploymentPackage(
String taskId,
String changeSetId,
String status,
boolean requiresHumanApproval,
long generatedAt,
Map<String, Object> manifest,
List<String> sqlStatements,
List<String> rollbackSqlStatements,
List<String> warnings,
List<AiRunRecord> runEvidence) {
}

View File

@@ -0,0 +1,21 @@
package com.eip4.platform.ai.model;
import java.util.List;
import java.util.Map;
import com.fasterxml.jackson.databind.JsonNode;
public record AiDraft(
String id,
String taskId,
AiArtifactType artifactType,
String targetId,
JsonNode payload,
long createdAt,
List<AiGateResult> gates,
Map<String, Object> metadata) {
public boolean passed() {
return gates == null || gates.stream().allMatch(AiGateResult::passed);
}
}

View File

@@ -0,0 +1,12 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiEmployeeDefinition(
String id,
String name,
String role,
List<String> toolNames,
List<String> requiredScopes,
List<String> policies) {
}

View File

@@ -0,0 +1,9 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiFeatureDevelopment(
AiTask task,
List<AiDraft> drafts,
AiChangeSet changeSet) {
}

View File

@@ -0,0 +1,9 @@
package com.eip4.platform.ai.model;
public record AiFeatureField(
String column,
String label,
String type,
Integer length,
Boolean required) {
}

View File

@@ -0,0 +1,13 @@
package com.eip4.platform.ai.model;
import java.util.Map;
public record AiFeaturePackage(
String id,
String taskId,
String changeSetId,
String status,
long createdAt,
Map<String, Object> manifest,
AiDeploymentPackage deploymentPackage) {
}

View File

@@ -0,0 +1,24 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiFeatureRequest(
String objective,
String featureName,
String tableName,
String entityName,
String templateId,
String menuName,
List<AiFeatureField> fields,
String pageRecipe) {
public AiFeatureRequest(String objective,
String featureName,
String tableName,
String entityName,
String templateId,
String menuName,
List<AiFeatureField> fields) {
this(objective, featureName, tableName, entityName, templateId, menuName, fields, null);
}
}

View File

@@ -0,0 +1,9 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiGateResult(
String name,
boolean passed,
List<String> messages) {
}

View File

@@ -0,0 +1,12 @@
package com.eip4.platform.ai.model;
import java.util.Map;
import com.fasterxml.jackson.databind.JsonNode;
public record AiGeneratedDraft(
AiArtifactType artifactType,
String targetId,
JsonNode payload,
Map<String, Object> metadata) {
}

View File

@@ -0,0 +1,14 @@
package com.eip4.platform.ai.model;
import java.util.List;
import java.util.Map;
public record AiReleasePlan(
String taskId,
String changeSetId,
String status,
boolean requiresHumanApproval,
Map<String, Object> environmentPolicy,
List<AiReleaseStep> steps,
List<String> rollbackNotes) {
}

View File

@@ -0,0 +1,13 @@
package com.eip4.platform.ai.model;
import java.util.Map;
public record AiReleaseStep(
String id,
AiArtifactType artifactType,
String title,
String mode,
String target,
String action,
Map<String, Object> details) {
}

View File

@@ -0,0 +1,14 @@
package com.eip4.platform.ai.model;
import java.util.Map;
public record AiRepairAction(
String id,
String source,
String actionType,
String artifactType,
String targetId,
boolean automated,
String rationale,
Map<String, Object> details) {
}

View File

@@ -0,0 +1,12 @@
package com.eip4.platform.ai.model;
import java.util.Map;
import com.fasterxml.jackson.databind.JsonNode;
public record AiRepairDraftPatch(
AiArtifactType artifactType,
String targetId,
JsonNode payload,
Map<String, Object> metadata) {
}

View File

@@ -0,0 +1,17 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiRepairExecution(
String taskId,
String changeSetId,
String status,
long startedAt,
long finishedAt,
AiRepairPlan repairPlan,
List<AiDraft> generatedDrafts,
AiChangeSet repairedChangeSet,
AiApplyRun retryApplyRun,
AiDeploymentPackage deploymentPackage,
List<String> messages) {
}

View File

@@ -0,0 +1,4 @@
package com.eip4.platform.ai.model;
public record AiRepairExecutionRequest(String baseUrl) {
}

View File

@@ -0,0 +1,13 @@
package com.eip4.platform.ai.model;
import java.util.List;
public record AiRepairPlan(
String taskId,
String changeSetId,
String sourceRunId,
String status,
long generatedAt,
List<AiRepairAction> actions,
List<String> messages) {
}

Some files were not shown because too many files have changed in this diff Show More