docs: 进度总览更新报表保真层 JOR 重宿主 + 安全/OOM 收口(§11 + A3 升 🟢)
Some checks failed
ci / build-test-parity (push) Has been cancelled

A3 报表系统由 🟠 升 🟢:套打 JOR 重宿主已完成 + 保真层安全/OOM 收口已完成;
新增 §11 记三批合入(e6c73a4/dccca17/d697885)的 SQLi门/IDOR/XXE/并发·字节·超时·
结果集封顶/CVE替换/只读数据源,含关键验证与仍开口项;§0 一句话进度补一行。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-26 08:42:48 +08:00
parent 0ee919b89e
commit ccb179d84a

View File

@@ -15,6 +15,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
- **A 兼容线**:通用模板 1363 基本可用;153 定制视图中 framework 推进过半、**业务 106 未动(最大块)**。
- **B 新能力线本期里程碑突破**:「人走五环建新功能」低代码平台 **v1 全链交付并合入 origin/main 两仓**;设计器选型(amis-editor)拍板且 **DesignerPage 全闭环上线**(解除历史 P1 头号阻塞);AI 确定性(非 LLM)五环生产线**已合 main**。
- **安全基线(§10.1 四项 P0 + 评审追加 2 孪生 + Groovy 沙箱)2026-06-25 全数收口并 push**(platform `eba9ce1` / web `2a37251`),可达 RCE/越权/fail-open 已闭。
- **报表保真层(套打 JOR)2026-06-25/26 重宿主 + 安全/OOM 收口全数完成并 push origin/main**(§11):SQLi 门 / IDOR 授权 / XXE / 并发·字节·超时·结果集封顶 / CVE 依赖替换 / 报表只读数据源;11 类 73 单测 + live e2e + 安全对抗复审,三批 merge `e6c73a4`/`dccca17`/`d697885`。
- 项目仍在 **dev 环境**,生产上线工程化(A10)未起步。
---
@@ -58,7 +59,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
| **A0** | 通用模板 1363(转换器) | 🟢 | 基本可用。P0 三项(日历 type5 / 树 type3 / 组合 type6)源码 `598f4f9` 已实现,后续多轮全量重转重导已执行,运行库大概率已生效(**需复核**);残 P1 = 19 页缺 EDITFORM 映射 + onselected/filter/enableButton 脚本挂回 |
| **A1** | 153 定制视图(framework 47 + 业务 106) | 🟠 | framework 除用户管理(parity,`bf7bb25/0d6fab4/17c449c`)外多项已移植(审批历史 / 我发起 / 脚本编辑器 / 工作日历 / treegrid),按 Java 类去重约 38 待写单元;**业务 106(源码 EIP-3.0 仓 3.1G)基本没动 = 最大块**;终判 158.75 人日卡 S1 止损评审 |
| **A2** | 流程审批优化 | 🟢 | ApprovalDrawer / WfTemplate 驱动审批 / 审批历史抽屉 / 监控按钮(撤回/结束/高级,早已 live)+ **2026-06-26 审批闭环批补齐**:协办(assist)/转阅(circulated)动作、BPMN 流程图查看(bpmn-js)、会签(BPMN 多实例,scriptUser 候选人解析移植)、会签进度「已会签 N/M」、**xerces 击穿修复**(report 古董 xerces 击穿全部 WfTemplate 解析,已钉 JDK 解析器)。均单测+live。仅剩**客户 BPMN 真实流转(前置①外部)**与**流程定义 Modeler(=B3)**。详见 `docs/plans/2026-06-25-审批闭环-实施计划.md`(main `c95eaee`) |
| **A3** | 报表系统(339) | 🟠 | 基本列表;套打 JOR(45) / 图表 ECharts / 打印 / 报表菜单树路由 降级,需独立立项(与 B6 同根) |
| **A3** | 报表系统(339) | 🟢 | **套打 JOR 重宿主已完成**(复用客户预编译引擎 headless 渲染,328/339 type=200 为报表查看器 crud,`/api/report/render` 三格式 HTML/PDF/XLS + iframe 保真,push `53f3c25`)+ **保真层安全/OOM 收口已完成**(见 §11,三批 merge)。残:中文字体保真细化 / 钻取链接 / 完整客户库逐张对账;图表 ECharts、报表设计器 B6 仍未起步 |
| **A4** | 附件系统 | 🟠 | 双态组件已上线;缺图片预览、老附件物理文件迁移(下载 403)、DOCUMENT 全生命周期 |
| **A5** | 消息 & 邮件 | 🟠 | 短消息发送 + 消息详情已移植;webmail(IMAP/SMTP)独立子系统未起步;已读联动未接 |
| **A6** | 数据导入/导出 | 🔴 | 数据导入配置端点 `DataImportConfigController` 已落(c9e4d35);整体 FTP+Excel 导入管线 / Excel 导出未成体系 |
@@ -243,4 +244,22 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
---
## 11. 报表保真层(套打 JOR)重宿主 + 安全/OOM 收口(2026-06-25/26)
真实报表 = jatools JOR 套打模板(633 个),**重宿主非重建**:复用客户预编译引擎在无界面环境 headless 渲染为 HTML/PDF/XLS。Phase 1-3(渲染服务 + `/api/report/render` 三格式 + `/api/report/frame` amis 信封 + 转换器对 type=200 产报表查看器 crud,铺全 339)已完成并 push(origin/main `53f3c25`)。其上做了一轮**安全 / 性能 / OOM 审计与收口**(8 维度审计 + 安全 reviewer 对抗复审,TDD + 真库 live e2e),分三批合入 origin/main:
| 批次 | 内容 | merge |
|---|---|---|
| 1 | SQLi 参数门(模板引用名白名单 + 字符白名单值校验 + 身份/数据域注入)/ IDOR 对象级菜单授权 / XXE(字节级拒 DOCTYPE,防 BOM/UTF-16 绕过)/ 渲染并发闸(429) / 产物字节上限(413) / DB `statement_timeout`+`socketTimeout` / 错误响应通用化 | `e6c73a4` |
| 2 | 残留收口:结果集 `maxResultBuffer` 驱动层封顶(防 `TYPE_SCROLL_INSENSITIVE` 全量物化 OOM)+ 多值 `IN (${LIST})` 逗号放行 | `dccca17` |
| 3 | CVE 依赖替换(commons-collections 3.0→3.2.2 / log4j 1.2.8→reload4j 1.2.25,引擎 jar 不可改但依赖可换)+ 报表只读数据源(`eip4.report.db.*`,未配回落主源,向后兼容)+ 只读账号 GRANT/巡检 SQL | `d697885` |
**审计头号风险**:报表 SQL 的 `${PARAM}` 经 jatools `evalTemplate` **字符串拼接**进 SQL 后 `prepareStatement` 执行(无占位符绑定)→ 全参数 SQL 注入。引擎为预编译 jar 不可改,故全部在包装层收口(`ReportParamGuard` 等 11 个类、73 单测)。
**关键验证**:数值上下文注入 `?PROJECTID=0 union select…` → 400;IDOR 非超管越权 → 403、超管 bypass → 200;`maxResultBuffer` 经独立 JDBC 探针在同款 `TYPE_SCROLL_INSENSITIVE` 路径实证超限即抛非 OOM;CVE 替换后依赖树/运行时 classpath 实证生效、live HTML/PDF=200 无 ClassNotFound。
**仍开口(引擎/部署层)**:凭据外泄不可在渲染层修(模板 `<Connection>` 经同一 `property("DBPassword")` 解析口令,巡检脚本实测当前 326 模板 0 处泄露)→ 真 containment = 只读 DB 账号(脚本已交付 `platform-report/docs/security/`,待运维执行并配 `eip4.report.db.*`);结果集 OOM 对多并发非完全封顶(`maxResultBuffer` 是单查询上限×并发数);裸 `DriverManager` 连接池化未做;`bsh`(jatools fork)/`itext`(只生成不解析 PDF)/`xerces 2.6.2`(XXE 已被前置 DOCTYPE 拒绝兜住) 三 CVE 件不可换,已记录理由。
---
*本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。架构改进待办见 §10(2026-06-24 并入,取代已删除的《EIP4 架构分析与改进建议》)。*