I1 性能(必修):
- 根因: GET /api/file/list 原查询 WHERE UPPER(tablename)=? AND TRIM(businesskey)=?
AND isactive=1 —— 列被函数包裹(非 sargable),sys_doc 33.8 万行仅 PK 索引
→ 每次附件页渲染 Parallel Seq Scan 全表(amis service 容器每渲必打本端点;
EXPLAIN cost ~18572)。
- 修(FileController.list 查询):
· tablename 列本就全大写(DB 实测 tablename<>upper(tablename) 计数 0),app 侧已
tableName.trim().toUpperCase() → 去 UPPER 改 tablename = ?(sargable)。
· businesskey 不能简单 = trimmed: DB 实测 13000 行存「32 位 UUID + 4 空格 padding
至 36」CHAR 补白遗留(业务 PK 为 character(36)),naive businesskey=trimmed 会
漏列这 13000 行附件 → 保留 trim 语义改 rtrim(businesskey) = ?,配函数式索引使其
sargable。全程 ? 绑定(防注入,无拼接)。
- 索引 DDL: docs/sql/SYS_DOC_INDEX.sql
CREATE INDEX IF NOT EXISTS ix_sys_doc_biz
ON eip3.sys_doc (tablename, rtrim(businesskey)) WHERE isactive = 1;
已应用到 eip4dev(含 COMMENT,幂等)。客户库排切流窗口执行(与现有 docs/sql/* 同放
同风格;P5 Flyway 待办同 SYS_PAGE_SCHEMA.sql)。
- 验证(eip4dev): EXPLAIN Seq Scan(cost 18572) → Index Scan using ix_sys_doc_biz
(cost 8.44, exec 0.038ms); 补白键 OA_NOTICEMANAGE + 横线键 OA_NEWSMANAGE 均命中。
8093 重启含新 jar 后 /api/file/list 两种键风格均正常返附件(含 13000 行补白键场景)。
补测试:
- FileControllerTest #5 注入安全(priority 契约): 恶意 tableName/businessKey 不抛、返空,
ArgumentCaptor 断言走 ? 绑定(SQL 文本为静态参数化语句不含用户串,用户原串作绑定值)。
- TemplateToAmisConverterTest 新增 skip-guard: 表名 ORPHAN_*(SYS_ENTITY 解析不到)→
enrichAttachmentFields 降级守卫生效,附件字段保留原 input-file 不包 service。
- 测试全绿: FileControllerTest 5/5, TemplateToAmisConverterTest 93/93(JDK21)。
M4: buildAttachmentField 加注释说明 service.name 与内层 input-file 同名(DOCUMENT)
仅作布局归位 key,表单值由内层 input-file 绑定,amis 容忍(已浏览器验证)。
I2(已知系统级后续项,本次不修): /api/file/list 及 download 无行级数据权限——任意已认证
用户可枚举任意业务记录附件,与现有 download/flow 同 posture(生产仅认证可访问)。
TODO 注释标于 FileController.list javadoc。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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 个测试实体并灌数。