Files
eip4-platform/README.md
zhengwr d3986031d2 dev 运行环境固化为 JDK 21 + 守卫启动脚本(防误用 JDK 26 致 Groovy 崩)
QA 全量巡检发现:dev 平台默认跑 homebrew openjdk(现为 26),致保真层服务流的
Groovy 4.0.27 在运行时解析 JDK 26 类(major 70)崩(GroovyBugError),35+ 命名查询流 500。
根因与 F2-13「报表 500」同族(那次修了编译目标 release=21,但运行时 JDK 仍可能是 26)。

- scripts/run-dev.sh:一键启动 platform/flowable,强制定位并校验 JDK 21(brew openjdk@21),
  非 21 拒启;轮询等端口释放再起,防多实例/旧 JDK 残留。
- README:新增「运行环境必读:必须 JDK 21」,纠正过时的 openjdk@17 示例。
- 架构设计.md:运行时 JDK 17 → 21,补「不可用 JDK 26 / 升 JDK 须同步升 Groovy、目标 25」红线。

实测:platform(8093)+ flowable(8089)均切到 openjdk@21,登录/待办/服务流查询正常;
此前 JDK 26 下 500 的 PM_LABORCOMPANY_SEARCH_LISTINFO 等恢复返数据。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 20:09:49 +08:00

89 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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):**
```bash
# 一键启动(强制 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 + 跑对拍回归。
```
## 常用命令
```bash
# 所有 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 个测试实体并灌数。