zhengwr a19bcdbf67 feat(metadata): 实体加载按 pageId 把引用字段解析为 {_id,_label} 对象 + 保存拍回裸 id
EntityController.load 加可选 ?pageId=:读 view_page(pageId) 字段,把 uitype=SelectDialog/MultiSelectDialog(带 dialogid)字段值解析成 {_id,_label} 对象(multi→对象数组),label 由各字段 dialogid 经 PickerController.resolveValuesToOptions 同源解析(口径=老 DialogDisplayUtil);type=3 树 dialog(转 tree-select 吃裸id)按 isTreeDialog 跳过不转对象防 undefined;_id 去尾补白。pageId 空→行为不变(回归)。PickerController.resolveValuesToOptions 提包级可见供复用(端点行为不变)。FlowInputCoercer.flattenPickerObjects:写流入参里 {_id,...} 形态值拍回裸 _id(去尾补白)——amis picker「载入后不动直接保存」会把整个对象进 payload,后端统一扁平守住提交值=id(零前端改动)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 17:58:42 +08:00

eip4-platform

EIP4 平台正式工程(路线 A'):双层制模块化单体——保真层供奉,现代层生长。 架构依据:docs/架构设计.md(必读);坑位台账:docs/迁移手册.md。

模块

模块 职责 纪律
platform-legacy-core 保真层:移植引擎原样,包名 com.dsasp.* 不动 不重写、不改包名,与 framework 源码 diff 最小;对拍=完成定义
platform-metadata 现代层 REST API/DTO/OpenAPI(com.eip4.*) 新代码须评审+单测
platform-auth 数据权限真实现(C2 已替换桩)+ P2 组织/权限
platform-converter 模板转换器(P4) 可独立 CLI 跑批
platform-flow-gateway P3 占位:Flowable 网关
platform-ai P5 占位:MCP Server
platform-parity C1 对拍框架:录制/重放/RowDiff/自对拍 CLI P1 一级交付物
platform-app Boot 启动器,组装全部模块 ArchUnit 规则在此模块测试里

边界纪律(ArchUnit 强制):com.eip4.* 可调 com.dsasp.*,反向禁止。

三套 profile

profile 数据源 端口 用途
dev(日常开发) localhost:5433/eip4dev(真实数据副本) 8093 日常功能开发/联调,完全本地,无需网络
local(自举) localhost:5433/eip4m0(极简自举集) 8084 CI/对拍/单元测试
默认(验证) 192.168.20.68:5435/eip3(客户库副本) 8084 验收验证/性能基线,5435 收敛为只读基线

eip4dev 刷新:bash tools/local-devdb/build_devdb.sh --drop-target(约 6 分钟) 详见:tools/local-devdb/本地开发库构建报告.md

⚠️ 运行环境(必读):必须 JDK 21,不可用 JDK 26

保真层老引擎的服务流脚本运行时走 JSR-223 调 Groovy 4.0.27(pom.xml 钉定)。 Groovy 4.0.27 不认 JDK 26 的字节码(class major version 70),会在编译脚本时抛 GroovyBugError: Unsupported class file major version 70,导致大批服务流查询 (*_SEARCH_LISTINFO/*_SZWJ 等)直接 500。 项目 maven.compiler.release=21、 生产环境=JDK 21(LTS),故本地开发也必须用 JDK 21。

⚠️ homebrew 默认的 openjdk 现在是 26——不显式指定 JAVA_HOME 会误用 26。 请先 brew install openjdk@21,并始终用 JDK 21 启动。推荐用守卫脚本(自动定位并强制 21):

# 一键启动(强制 JDK 21,自动关停旧实例;默认 platform+flowable 都起)
bash scripts/run-dev.sh both        # 或 platform / flowable
EIP4_PROFILE=local bash scripts/run-dev.sh platform   # 换 profile

# 将来升 JDK:目标是下个 LTS=25(非 LTS 的 26 不用),且须同步升 Groovy + 跑对拍回归。

常用命令

# 所有 mvn/java 命令都须用 JDK 21(见上「运行环境」)
export JAVA_HOME=/opt/homebrew/opt/openjdk@21    # 必须 21;openjdk@21/bin/java 应报 21.x
mvn test                                                    # 全模块测试(含 ArchUnit)

# 启动:推荐 scripts/run-dev.sh(带 JDK 21 守卫);以下 mvn 方式同样要求 JAVA_HOME=21
# dev profile — 日常开发(真实数据副本 eip4dev,端口 8093)
mvn spring-boot:run -pl platform-app -Dspring-boot.run.profiles=dev

# local profile — 自举最小集(CI/对拍,端口 8084)
mvn spring-boot:run -pl platform-app -Dspring-boot.run.profiles=local

# 默认 profile — 客户库副本 5435(验证用)
mvn spring-boot:run -pl platform-app

# 构建/刷新本地开发库 eip4dev(幂等,约 6 分钟)
bash tools/local-devdb/build_devdb.sh --drop-target

# 对拍(详见 platform-parity/C1实测报告.md)
CP="platform-parity/target/classes:$(mvn -q org.apache.maven.plugins:maven-dependency-plugin:build-classpath -pl platform-parity -Dmdep.outputFile=/dev/stdout -o | tail -1)"
java -cp "$CP" com.eip4.platform.parity.selfcheck.ParityCli --all            # 本地全量
java -cp "$CP" com.eip4.platform.parity.selfcheck.ParityCli --privilege      # C2 数据权限样本
# 指向 eip4dev 自对拍:
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"

tools/

  • tools/s3_rewriter/ — C4 S3 脚本正则改写器(真实库自动化率 81.2%,P4 facade 扩容种子);run_eval.py --from-db 连客户库复测
  • tools/loadtest/load_p95.py — C3 压测 harness(零依赖)

本地自举

空库重建:platform-parity/src/main/resources/bootstrap/bootstrap-sys.sql + bootstrap-privilege.sql, 再 ParityCli --seed --all 建 21 个测试实体并灌数。

Description
No description provided
Readme 23 MiB
Languages
Java 77.7%
Groovy 17%
Python 3.8%
Shell 1.3%
JavaScript 0.1%