P4-2 脚本迁移线:全量改写产出 + facade 动词表运行时实现
任务1 全量改写执行: - run_rewrite.py 对客户库缓存 1,427 条逐条改写,按 template_id+脚本序号落盘 output/rewritten/(497 FULL_AUTO + 30 PARTIAL + 85 HARD + 815 NO_S3) - 人工作业单 115 份(PARTIAL 30 + HARD 85),每份附原文/已改部分/余留模式/建议改法/工时口径 - 自动化率 81.2% 复现 C4 实测,0 误改 任务2 facade 动词表运行时: - ScriptFacade 把 31 改写目标动词 + bindField 作为 Groovy 闭包注入 Bindings (PoC enableButton 模式扩展);服务端语义动词直接求值,UI 语义动词捕获为 amis 事件动作指令 JSON(actionType/componentId/args) - 保真层纪律:全在 com.eip4 现代层,com.dsasp 源码零改,ArchUnit 复跑通过 - ScriptExecuteController 提供 /api/script/execute 与 /api/script/execute-template 验证: - 单测 17 方法逐动词覆盖,均经真实 Groovy 过保真层引擎,BUILD SUCCESS - 集成 6 条真实 FULL_AUTO 改写脚本经 8086 执行,amis 指令协议合规 - 回归 PoC script-test 通过,ArchUnit 架构纪律通过 报告 tools/s3_rewriter/P4脚本迁移执行报告.md;新坑入 docs/迁移手册.md 5.39/9.3 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
22
docs/迁移手册.md
22
docs/迁移手册.md
@@ -450,6 +450,17 @@ com.dsasp.* com.eip4.*
|
||||
- **对策**:置 jar 于 `platform-legacy-core/local-libs/`(标准 Maven repo 布局 `ft/otp/jotpverify/1.0.0/jotpverify-1.0.0.{jar,pom}`),在 **platform-legacy-core 模块 pom** 加 `file://${project.basedir}/local-libs` 私有仓库 + 依赖坐标 `ft.otp:jotpverify:1.0.0`。**父 pom 不动**,模块自包含、构建可复现(随工程进版本库)。`UserOtpServiceImpl` 代码原样保留一行未改。**注意**:offline(`-o`)首次构建会拒绝 file:// 仓库(未缓存),需联网构建一次(无网络下载,仅解析本地 file 仓库)。
|
||||
- **影响范围**:凡移植带私有 lib jar 的 framework 模块同此法(模块 local-libs 私有仓库),勿往父 pom 加 system-scope 或全局坐标。
|
||||
|
||||
### 5.39 P4 脚本迁移线三坑:spring-boot 离线打包不刷新上游 jar / FULL_AUTO 不等于零外部依赖 / bindField 须随 facade 动词表注入 [NEW 2026-06-11]
|
||||
|
||||
- **现象一(打包陷阱)**:改了 platform-metadata 后单独 `mvn -o -pl platform-app package`,boot jar 的 `BOOT-INF/lib/platform-metadata-*.jar` 时间戳仍停在改前,新增 facade 动词运行时执行报 `No signature of method: ...bindField()`。
|
||||
- **根因**:spring-boot-maven-plugin 离线 repackage 解析上游模块用了 reactor/缓存的旧产物,单模块 package 不连带重建上游。
|
||||
- **对策**:改上游模块后用反应堆 `mvn -o -pl platform-app -am package` 连带重建上游再起服务;或起服务前 `unzip -l` 核验 `BOOT-INF/lib` 内上游 jar 字节码已含新方法(`javap -p` grep)。
|
||||
- **现象二(FULL_AUTO 语义边界)**:S3 改写器的 FULL_AUTO(497 条)仅指「无残留 S3 UI 动词」,但脚本可能并存 `GetServicesFunction`/`GetDefaultValueFunction`/`Console`/`CustomSearchConditional` 等平台 S2 函数库/领域类调用——这些需 WS3 回迁的 Java 函数库桩(第三章),**不在 31 动词 facade 覆盖内**。
|
||||
- **对策**:facade 集成挑样须按「仅 facade 动词」筛选(本批 612 条 S3 中 296 条 facade-only);端到端全量跑通须先补齐函数库桩(GetServicesFunction 等,迁移手册 §111「WS3 回迁」)。
|
||||
- **现象三(基础 facade 漏注)**:改写器不改 `bindField`(它本就是 S2 形态),但运行时若只注入 31 个「改写目标动词」会漏掉 `bindField`,含 bindField 的 FULL_AUTO 脚本报未定义方法。
|
||||
- **对策**:facade 动词表须把 `bindField`/`getFieldValue`/`setFieldReadOnly`/`showConfirmDialog` 四个**基础辅助函数**(§161)与 31 改写目标动词一并注入,合计 ≥32 个动词闭包。
|
||||
- **影响范围**:P4 脚本批量转换/运行时脚本加载;凡用 facade 闭包注入机制执行存量脚本的环节;改上游模块后的 boot 打包流程。
|
||||
|
||||
## 六、Flowable 升级三坑
|
||||
|
||||
> 来源:eip4-poc WS4 实测,flowable-poc / flowable5-poc 工程(2026-06-10)
|
||||
@@ -666,13 +677,20 @@ com.dsasp.* com.eip4.*
|
||||
| 对拍框架设计(C1)评审 | CTO + 老员工 | 待定 | 待定 |
|
||||
| Flowable 升级三坑与 Runbook 对应 | P3 责任人 | 待定 | 待定 |
|
||||
|
||||
### 9.3 WS3 facade 动词表扩展(待补 P1)
|
||||
### 9.3 WS3 facade 动词表扩展(已交付 P4-2 2026-06-11)
|
||||
|
||||
当前已确认的 4 个基础辅助函数(`getFieldValue` / `bindField` / `setFieldReadOnly` / `showConfirmDialog`)之外,盘点报告 Top S3 API 调用显示需扩展至 ~20 个:
|
||||
|
||||
已知待补:`addButton`×100、`getValue`×68、`getContainerDataSource`×61、`setFilter`×56、`removeAllItems`×29、`group.setReadOnly`×27、`getDisplay`×27、`setVisible`×21、`setCaption`×16……
|
||||
|
||||
P1/P4 阶段由老员工与后端架构逐条补全,补全后回填本节。
|
||||
**[已交付 2026-06-11 / P4-2]** 动词表已扩展并在引擎侧落地,详见 `tools/s3_rewriter/P4脚本迁移执行报告.md`:
|
||||
|
||||
- **改写器目标动词 31 个**(C4 报告 §2.2),运行时实现 `com.eip4.platform.metadata.script.ScriptFacade`,经 PoC 已建的 facade 闭包注入机制(`ScriptingEnginesManager.evaluateGroovy` 的 `Bindings`)注入,**com.dsasp 源码零改、无替换类登记**(ArchUnit「保真层禁止依赖现代层」复跑通过)。
|
||||
- **动词分两类**:①服务端语义(`getFieldValue`/`getFieldDisplay`/`getFieldDataSource`,服务端求值返回);②UI 语义(其余 29 个,捕获为 amis 事件动作指令 JSON `{actionType, componentId, args}`,actionType 取 amis 标准动作名 show/hidden/enabled/disabled/static/setValue/setFilter/setOptions/addOption/toast/…)。连同 4 个基础辅助函数中的 `bindField`,合计 32 个动词闭包注入。
|
||||
- **执行端点**:`POST /api/script/execute`(改写后脚本直接执行)、`POST /api/script/execute-template`(按模板名取客户库真实脚本执行)。
|
||||
- **验证**:单测 17 方法逐动词覆盖(均经真实 Groovy 过保真层引擎,BUILD SUCCESS);集成 6 条真实 FULL_AUTO 改写脚本经 8086 执行产出 amis 指令、协议合规;回归 PoC script-test 通过。
|
||||
|
||||
剩余 `showConfirmDialog`(同步确认框)的异步回调链改造仍属 HARD 人工范畴(85 条),不在 facade 自动覆盖内。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user