Compare commits

..

2 Commits

Author SHA1 Message Date
d78de96530 Merge docs/report-bclass-chart-backlog: B 类图表 backlog + 报表收尾纪要
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:08:37 +08:00
3a04b869fe docs(report): B 类图表验证结论=暂缓为独立 ECharts 小特性 + 收尾纪要
design §7 记录 B 类图表验证:ischart=true 仅 4 张且 reportfile 全空——不是 JOR/jfreechart,
是老客户端从图表数据流(POST 写流,GET 被拒)画的 ECharts,当前降级成加载不出数据的破表。
faithful 迁移=独立特性(POST 图表端点 + 流结果→amis chart option,但图表类型/系列映射在老客户端、
每张形状不同难通用、出图保真须完整客户库),仅 4 张低优先,待产品定夺口径。用户拍板暂缓。
§6 遗留同步:中文字体保真 + PDF/Excel 下载入口已收尾(均真镜像/真验)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:08:37 +08:00

View File

@@ -49,4 +49,13 @@ EIP3 `ReportExporter` 的真实通道(`jor/jatools/server/ReportExporter.java`):
- **认证根因修(关键)** `EngineContextBinder`:工程 picker「选不到」的真因**不是**转换器/页面结构,而是**认证 admin 的引擎身份没被识别成超管**——JWT 注入 `CURRENTUSER="ADMIN"`(5 字符),引擎跳过行级数据过滤的判定是 exact `ctx.get(CURRENTUSER).equals(LoggedInUser.ADMIN)`,而该常量是 CHAR(36) 补白的 `"ADMIN"+31 空格`,5 字符 ≠ 36 字符 → admin 被当普通用户走数据权限 → `PM_PROJECT` 无规则 → `PrivilegeException` →「暂无该数据源的查询权限」(无 token 的 curl 走 ADMIN 默认上下文,故误以为后端正常)。修=`bind()` 把系统管理员(userId trim=ADMIN,或 account 精确小写='admin',与全站 `requireAdmin` 同口径,不放宽大小写防变体账号提权)的 CURRENTUSER 归一为引擎规范 36 字符 `LoggedInUser.ADMIN`,引擎识别超管→跳过过滤。各 `requireAdmin` 门控均 `trim().equalsIgnoreCase`,对补白形式同样判真,不破鉴权门。
- **live 验收**(8093 新 jar + 真库 + Playwright):工程 picker 列出全部 1672 工程→选中值落定→「搜索」→ crud 携 `PROJECTID` 调 frame→iframe `src=…?format=html&PROJECTID=…`→渲出 JOR 套打「在建项目收付款信息表」(单位/中标价/合同价/序号/工程名称/累计收款付款…);菜单 tab 内非独立页。339 报表页已批量重转重导 eip3.sys_page_schema(328 viewer 更新 + 9 表格不变)。
- **评审**:独立 code-reviewer + security-reviewer;按建议收口 templateId 路径编码、`/render` 端点 page/perPage 行为保持不变(分流到 frame)、account 判定与 requireAdmin 对齐大小写敏感(防变体账号提权)。
- **遗留**:headless 中文字体保真(版式通,需装字体)、PDF/Excel 下载入口、B 类图表(JOR jfreechart 已在 lib 随版式出图)、`<Url>` 钻取链接改 EIP4 路由、完整客户库数据对账。
- **已收尾**:headless 中文字体保真(生产镜像装 `fontconfig+fonts-wqy-zenhei+fonts-dejavu-core`,docker 真镜像渲染验证零豆腐块,字体嵌入子集可移植);PDF/Excel 下载入口(查看器 `filter.actions`/`headerToolbar` 加导出按钮 → `/api/report/render?format=pdf|xls`,端点回 `Content-Disposition: attachment`+RFC5987 中文文件名,浏览器+curl 真验下载保真)。
## 7. B 类图表报表 backlog(2026-06-25 验证暂缓,独立小特性)
**验证结论(暂缓,非 jfreechart)**:`ischart=true` 报表仅 **4 张**(项目考勤图表-前十/单个、未签合同率前十、供应商价格分析土建),且**全部 `<reportfile>` 为空** —— EIP3 图表**不是 JOR/jfreechart 套打**(lib 的 jfreechart 只服务于内嵌在 JOR 版式里的图,这 4 张都没有),而是**老客户端从图表数据流画的 ECharts**。
- 图表数据流(如 `GB_ATTENDANCEINFO_PRJCHART`)被分类为**写服务流、GET 被拒**;POST 返结构化图数据 `{PRJNAMELIST:[类目], NOWLIST/COUNTLIST/ALLLIST:[系列], …标量}`(dev 库无源数据 → 全空)。
- 当前转换器把这 4 张走「图表→数据表」降级,crud 指向 `/api/flow/..._PRJCHART` 的 **GET**(被拒)→ 实为一张加载不出数据的破表。
- **faithful 迁移所需(独立特性)**:①能 POST 取数的图表端点;②把流结果映射成 amis `chart`(ECharts option)——但**图表类型/系列映射在老客户端代码里**(模板 XML 只有 `ischart`+`selectservice`+display,无图表定义),且**每张形状不同**,难用一套通用启发式覆盖;③出图保真还须**完整客户库**(dev 缺源数据)。仅 4 张、低优先,需产品定夺图表口径后再做。
- **仍剩余**:`<Url>reportviewer.jsp` 钻取链接改 EIP4 路由、完整客户库数据对账(eip4dev 部分库,源表/视图缺→渲布局但空数据,非引擎问题)。