Commit Graph

10 Commits

Author SHA1 Message Date
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
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
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
3646c06d5d 修复 B1 JUEL 致命缺陷:resolveBindings 触 FlowScriptBindings.entrySet UOE(dogfooding 实证)
逐流写 QA dogfooding + 上一提交的 gracefulFlowError 栈日志联合暴露:JuelScriptEngine.resolveBindings
用 SimpleBindings.putAll 合并入参 bindings,而真实服务流传入的是保真层 FlowScriptBindings——其
entrySet/keySet/putAll/size/values 抛 UnsupportedOperationException(仅 get/put/containsKey 实现,
架构设计§1 早记)。致【所有带 conditionExpression 的 EL 写流】在转移求值(${isSave} 等)时崩。
B2 差分用 SimpleBindings(entrySet 正常)故漏检;线性流(通知 OA_NOTICEMANAGE_ADD,无条件转移)
恰好不触发,致先前误判端到端已通。

修:废 resolveBindings 的 putAll 复制;BindingsELResolver 改持 ENGINE/GLOBAL 两层 Bindings,
顶层变量惰性 lookup 仅用 containsKey()+get()(FlowScriptBindings 支持的方法),不复制不遍历。
新增回归测试 (g):FlowScriptBindingsLike(entrySet/putAll 抛 UOE)下 ${x+1}/${isSave}/${x>3}/${nope}
均正确求值。platform-app 9 测试全绿(B2 差分 1376 等价仍不回归)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 00:26:44 +08:00
c721bdebd6 B2 JUEL 跨流回归:新 jakarta.el 与老 activiti JUEL 语义等价差分(真实语料)
B1 后带 conditionExpression 的 EL 写流从「抛 Can't find scripting engine」变「真求值」,
需证新引擎求值与老 activiti JUEL 语义等价(否则条件转移结果偏移会静默污染所有 EL 写流)。
- 真实语料:dev DB SYS_SERVICEFLOW 抽取 153 个去重 conditionExpression(XML 实体解码),
  落 test resource。特征:全 ${...}、无算术(数值提升风险 moot)、无 #{}、
  布尔/比较/null·空串/方法调用(.length/.booleanValue/.get_ID)/三元
- 差分:老 activiti JuelScriptEngineFactory(activiti-engine-5.14.jar 经独立 URLClassLoader
  隔离加载,绝不进 app 运行时)vs 新 JuelScriptEngine;153 表达式 × 9 binding 场景 = 1377 次比对
- 结果:完全等价 1376 / 真实偏移 0 / 已知良性差异 1——${isCover.booleanValue()==false} 当
  isCover=null 时老抛 NPE 中断、新对 null base 宽松返 false。真实流该变量恒由上游脚本赋值(非null)
  或被 !=null/||/三元短路守卫,不在执行路径;新行为亦更稳(不中断)。已白名单该差异类+单独记录,
  断言无其它偏移
- platform-app 全量 8 测试绿(差分+接缝+ArchUnit 共存,无 ServiceLoader 干扰)

activiti jar 缺失则整测 assumeTrue 跳过(本地差分门,不入 CI 强约束)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 23:41:16 +08:00
72e4c6d0e6 遗留① JUEL:platform-app 接入 jakarta.el 实现的 juel JSR-223 引擎
写路径提交前置:带 initExpression/条件转移的 EL 写流原本因运行时无名为 "juel" 的
引擎抛 "Can't find scripting engine for 'juel'" → status:1。

- 新增 com.eip4.platform.app.script.juel JSR-223 工厂+引擎(getNames=["juel"]),
  EL 后端用已在 classpath 的 jakarta.el(tomcat-embed-el,经 spring-boot-starter-web 传递),
  不引 activiti-engine / de.odysseus.juel,零改保真层 com.dsasp.*
- META-INF/services 注册 → ScriptingEnginesManager 既有惰性注册(getEngineByName("juel"))自动拾取
- BindingsELResolver 对 base==null 顶层标识符强制 setPropertyResolved,对齐 activiti JUEL
  宽松语义(未绑定→null 不抛;jakarta.el 默认会抛 PropertyNotFoundException)
- 接缝单测 6 例(含端到端 ScriptingEnginesManager.evaluate(...,"juel",...))+ ArchUnit 全绿

注:B2 跨流回归(EL 求值语义差异:数值提升 Long/Double、真实 bean 缺 getter、#{} 延迟表达式)待专项。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 22:59:14 +08:00
6cc7b3fb61 P2-3: 横切服务桩换 framework 真实现(文件/日志/消息)
保真层原样移植三块横切服务,删除对应桩,bean 名/包名/签名不动:

- 文件 com.dsasp.server.file.*:FileServiceImpl(bean fileService)真实现,
  存储后端经替换类 FTPClientTemplate(保包名/类名/签名,FTP→本地盘,
  根目录 eip4.file.root 配置化默认 ./data/files,resolveSafe 防 ../ 逃逸);
  BASE64Decoder→java.util.Base64、ant zip→java.util.zip、commons-codec→MessageDigest。
- 日志 com.dsasp.server.log.*:SystemLogManagerImpl/DataOperatorLogger/
  DataLogRecorderImpl + 异步调度(DataLogManager/ProcessLogThread/ProcessSysLogThread)
  原样移植,落 SYS_LOG/SYS_DATA_LOG/SYS_DATA_LOGITEM(后者 insert-only 无审计列,§5.1)。
- 消息 com.dsasp.server.mail.*:SystemEmailServiceImpl + SystemEmail/SystemEmailService
  移植;SMTP 配置缺省时降级 no-op + WARN,不阻塞启动(§5.38)。

装配/配置/自举/验证:
- LegacyXmlWiring 等价补齐三处 jdbcTemplate setter + MainApp.destPath 注入(§4.1);
- application.yml 加 eip4.file.root;bootstrap-xservice.sql 自举四张横切表 + LOGLEVEL;
- 删除 StubFileService/StubSystemLogManager/StubDataOperatorLog(StubProjectSwitchService
  属 viewframework 域非本任务范畴,保留);
- 单测 12 + 本地 DB 集成 4,全模块 mvn clean test 绿(含 ArchUnit);8087 启动验证毕已 kill。

报告:platform-auth/P2横切服务实测报告.md;坑入 docs/迁移手册.md §3.1/§3.2/§5.36-5.38。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 14:06:31 +08:00
f0500647be feat(metadata): 服务流执行 REST 门面 FlowController + 本地自举 + 单测
P1-2 第二步:报表方案 D 类——79 个 selectservice 服务流的统一 REST 化入口。

FlowController(com.eip4.platform.metadata.web):
  GET  /api/flow/{id}?k=v   query 参数 → 服务流入参 map(查询/报表类)
  POST /api/flow/{id} body  JSON body  → 服务流入参 map(参数多/带结构)
  统一封装 {status,msg,data};响应递归归一化(GeneralPOJO→平面行、
  listSelect 结果 {listresult,pagecount}→amis {items,total})。OpenAPI 注解。
  REST 入口读写时机:引擎不区分读写,P1 不在门面做引擎级读写闸,由调用方按
  「流定义 XML 审阅」确认查询/报表类后放行;风险与 P2 三层防护待办写入注释与报告。

适配(P1 服务流脚本编译):SecureGroovyScriptEngineFactory 的 DEFAULTIMPORTSLIST
移除两条 Vaadin 客户端 UI 默认导入(client.groovy.TestService、
com.dsasp.client.viewframework.component.MainComponent)——它们逐脚本注入,
classpath 缺失会使每个服务流脚本编译失败;与服务端取数无关,原值登记于注释供 diff。

LegacyXmlWiring:补 FlowServiceImpl.setJdbcTemplate(等价原 XML <property> 注入)。

本地自举:platform-parity bootstrap-flow.sql(幂等)——在 eip4m0 上建 SYS_SERVICEFLOW
+ 自描述元数据 + 最小查询流 EIP4M0_USERGROUP_SEARCH,参照 parity bootstrap 思路,
无客户库副本时引擎可独立跑通。

单测 18 例:FlowModelParseTest(9,XML 解析/参数绑定/默认流生成/往返序列化)+
FlowControllerTest(8,mock 引擎,GET/POST 参数透传 + 响应归一化)+
FlowExecuteLocalIT(1,@SpringBootTest local profile,自举 SQL + 真实引擎执行 +
二次一致;eip4m0 不可达则 assumeTrue 跳过)。全绿。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 12:01:15 +08:00
c2b3c5004f docs: 技术文档随仓库——架构设计/迁移手册/C3基线/C5报告迁入 docs/
文档分层:随代码演进的技术文档入 git(团队 clone 可得、有版本与评审);
决策档案与含商务内容的治理文档留工作区 docs/(不随仓库分发,外包 clone 不携带)。
全部交叉引用已更新(README×2/实测报告×2/登记表/pom/ArchUnit 注释)

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

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