Files
eip4-platform/docs/P1/F3-1报表报告.md
zhengwr fe539a88fb F3-1: 重批337个type200入库(98.2%闸一)+报表报告
report 337/337 闸一全通,总量1516/1489(98.2%)与基线持平,onEvent 380个。
eip4dev+eip4m0各更新901条sys_page_schema。30样本验证30/30通过,
3个分组报表XML→schema人工核对结论写入报告。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 04:42:08 +08:00

9.4 KiB
Raw Blame History

F3-1 报表渲染体验验证与修缮报告

任务范围

  • 修转换器 report 族查询区:业务列过滤规则 + 单测
  • 重批 337 个 type200 模板入库
  • 30 样本语义验证
  • 3 个含分组/合计的报表 XML→schema 人工核对
  • 新增 report.spec.ts(5 个代表性断言)+ 全套 e2e 终验

一、查询区修复说明(F3-1)

问题

report 族转换器 convertReport() 调用 buildSearchFilter() 时未过滤主键列, 导致 114 个 type200 报表的查询区暴露 designName="主键" 的字段(如 PM_PUB_SAFETYEDUCATION_ID、HR_WELFAREPAY_ID 等), 用户在查询区看到「主键」下拉选择器,无业务意义且影响体验。

修改

文件:platform-converter/src/main/java/com/eip4/platform/converter/TemplateToAmisConverter.java

buildSearchFilter() 新增重载,增加 skipKeyFields 参数:

boolean skipKeyFields = true  →  report 路径启用,crud/form 路径保持 false(不影响已有逻辑)

主键判断规则(OR 任一成立即跳过):

  1. designName="主键" 或 label="主键" —— 老引擎设计器明确标注主键
  2. 字段名以 _ID 结尾且长度 ≥ 10 —— 典型 UUID 外键列(如 HR_WELFAREPAY_ID), 长度门槛排除业务缩写(ORGID=5、DEPART_ID=9,均不触发)

新增跳过后行为:

  • 所有字段均被过滤 → filter=null(不渲染空查询区)
  • 部分字段被过滤 → 只保留业务字段
  • crud/form 路径不受影响(skipKeyFields=false)

新增单测(TemplateToAmisConverterTest.java,5 个):

用例 断言
f3_1_report查询区过滤designName主键 designName=主键 → 跳过,台账记录 F3-1
f3_1_report查询区过滤长_ID结尾字段 GB_PROJECTINFO_ID(长16) → 跳过
f3_1_report查询区保留短ORGID类字段 ORGID(长5) → 保留
f3_1_report查询区全是主键时filter为null 全主键 → filter=null
f3_1_crud查询区不过滤主键字段 crud 路径主键不过滤

另修复既有测试 crud_selectDialog降级为select 的断言(assertEquals→startsWith,F2-9 加了查询参数后未同步)。


二、批量重批结果

总量: 1516
闸一(schema)通过: 1489 (98.2%)  ← 与基线持平
onEvent 脚本钩子挂载: 380 个模板
分级: PARTIAL=1230  SUCCESS=259  FAILED=27
各根元素:
  report: 337/337/100.0%  ← 全部闸一通过
  crud: 956/956/100.0%
  form: 70/70/100.0%
  group: 20/20/100.0%
  tree: 106/106/100.0%

入库:eip4dev.eip3.sys_page_schema + eip4m0.public.sys_page_schema 各更新 901 条。


三、30 样本语义验证结果

全部通过(30/30)。按断言维度:

# 报表名称 状态 列数 查询字段数 合计列 备注
1 项目安全费用投入明细 PASS 6 6 APPLYMONEY issummer=true 正确转 summaryFields
2 (分)公司质量指标报表 PASS 48 0 — 宽报表,主键唯一查询列已被过滤
3 项目部质量目标报表 PASS 40 0 — 同上
4 开票申请表单(非项目-工业设备用) PASS 38 0 —
5 内部奖罚打印表单 PASS 37 0 —
6 项目开票申请表单 PASS 31 0 —
7 工种到位情况统计表 PASS 29 2 — START/END 日期
8 物资合同评审表-明辉定制 PASS 28 0 —
9 项目外经证开具申请打印表单 PASS 25 0 —
10 物资采购合同报表 PASS 21 3 — PROJECTID/CONTRACTID/PROJECTNAME
11 派车单 PASS 18 0 —
12 (设计项目)项目报销申请打印 PASS 18 0 —
13 施工日志报表 PASS 16 2 — DIARYDATE1/DIARYDATE2
14 预算材料清单 PASS 15 1 — PROJECTID
15 任务二维码 PASS 14 5 —
16 社保明细表-五建定制 PASS 14 3 — PROJECTID/YEAR/MONTH
17 项目分包信息统计表 PASS 14 3 — BEGINDATE/ENDDATE/REGISTER
18 项目社保统计表-五建定制 PASS 14 3 — YEAR/MONTH/PROJECTID
19 安全日志打印 PASS 13 2 — DIARYDATE1/DIARYDATE2
20 打印进项税抵扣调整 PASS 13 0 —
21 收发存明细 PASS 13 7 — STORE_ID/GOODS_NAME/...
22 绩效报表 PASS 13 5 —
23 面试考评报表 PASS 13 2 — RECRUITPLAN/SEARCHEVALAVG
24 项目劳务合同明细表 PASS 13 0 —
25 企业证书复印件/电子档使用登记报表 PASS 10 4 — EC_NAME/USETYPE/DEPART_ID/REGISTERDATE
26 公司危险源报表 PASS 10 1 — DANGERID
27 公司污染源报表 PASS 10 1 — POLLUTIONID
28 分公司在建项目收付款汇总表 PASS 10 2 — ORGID/USERID
29 分公司竣工项目收付款汇总表 PASS 10 2 — ORGID/USERID
30 在建项目收付款信息表 PASS 10 1 — PROJECTID

排除说明:抽样均取有 selectservice 且 col_count ≥ 3 的报表,底表缺失(500 错误)的 74 个排除在外(属 #29 数据问题)。


四、3 个分组/合计报表 XML→schema 转换人工核对

核对对象选取标准

含 issummer="true"(合计行)或多列宽报表含分类汇总查询语义。


核对1:项目安全费用投入明细(3eedc061)

XML display 段关键配置:

APPLYMONEY: ismoney="true" issummer="true"   → 金额合计列
APPLYDATE:  (无 ismoney/issummer)
PM_SAFETYFEEAPPLY_ID: iskeycolumn="true" hidden="true"

期望 schema:

  • columns 中 APPLYMONEY → type:number, precision:2(ismoney=true 命中)
  • summaryFields: ["APPLYMONEY"](issummer=true 命中)
  • PM_SAFETYFEEAPPLY_ID → toggled:false(display hidden=true 命中)

实际 schema(API 验证):

  • APPLYMONEY: type:number, precision:2 ✓
  • summaryFields: ["APPLYMONEY"] ✓
  • PM_SAFETYFEEAPPLY_ID: toggled:false ✓
  • filter: 6 个业务字段,无主键 ✓

结论:转换正确


核对2:工种到位情况统计表(b9546a6b)

XML display 段关键配置:

29 列,GB_PRJ_WORKER_ID: iskeycolumn(不含ismoney/issummer)
search: START/END 两个 PopupDateField 日期字段

期望 schema:

  • 29 列全部转出
  • GB_PRJ_WORKER_ID → toggled:false(display hidden 字段折叠)
  • filter: START→input-date, END→input-date

实际 schema:

  • columns: 29 列 ✓
  • GB_PRJ_WORKER_ID: toggled:false ✓
  • filter: [{name:START,type:input-date},{name:END,type:input-date}] ✓

结论:转换正确


核对3:分公司在建项目收付款汇总表(4d9d1ab0)

XML display 段关键配置:

10 列,含 PM_PAYMENTAFFIRM_ID/PM_PAYMENTAPPLY_ID/PM_PROJECT_ID/VIEW_PM_CONTRACT_ID(多个_ID列)
AFFIRMPRICE: 无 ismoney 标注
search: ORGID(SelectDialog), USERID(TextField)

期望 schema:

  • display 10 列全部转出(_ID 列在 columns 里保留,仅 search 过滤主键)
  • filter: ORGID(长5不被主键规则误杀)、USERID
  • AFFIRMPRICE: 无 ismoney 标注 → 未转 type:number(转换缺口)

实际 schema:

  • columns: 10 列 ✓
  • filter: [{name:ORGID,...},{name:USERID,...}] ✓,ORGID 保留 ✓
  • AFFIRMPRICE: type:text(XML 未标注 ismoney=true,转换器按规范未注入 number 类型)

结论:转换正确(符合规范)
转换缺口登记:AFFIRMPRICE 字段语义是金额列但 XML 未标 ismoney=true,导致未生成 number/千分位渲染。 同类问题 PAIDDATE/AFFIRMDATE 未标注 referenceid=DATE,元数据注入 type:date 依赖 SYS_ENTITYATTRIBUTE, 若实体元数据与 XML 不同步则日期列不显示格式化。→ 登记为 F3 遗留缺口(小缺口,源头是 XML 元数据缺失,需数据修正)。


五、e2e 终验

report.spec.ts(新增 5 个断言)

用例 断言要点 结果
项目安全费用投入明细 summaryFields 含 APPLYMONEY + 查询区无主键 + 渲染 PASS
工种到位情况统计表 columns=29 + START/END 日期查询区 + 渲染 PASS
分公司在建项目收付款汇总表 ORGID/USERID 保留 + 无主键泄露 + 渲染 PASS
企业证书登记报表 4 业务字段含 DEPART_ID(短) + 渲染 PASS
任务二维码 5 查询字段 + TASKID(短) 不触发过滤 + 渲染 PASS

全套 e2e

74 passed(原基线 68 + 新增 5 report + 已有 f2-16 等)
1 failed(designer.spec.ts:227 - 预先存在,非本次引入)

截图存 e2e/artifacts/f3-1/(5 张)。


六、遗留缺口登记(F3 评审用)

# 缺口描述 影响范围 优先级
F3-G1 display 段金额列未标 ismoney=true,转换器无法注入 number/千分位 部分报表(如 AFFIRMPRICE) 低(数据问题,需 XML 修正)
F3-G2 display 段日期列 SYS_ENTITYATTRIBUTE 元数据与 XML 不同步,date/datetime 渲染未注入 部分报表 低
F3-G3 74 个底表缺失报表 500 错误(#29 数据问题) 74 个 type200 排除本任务

七、提交记录

见 git log:

  • F3-1: report族查询区过滤主键列+单测 — platform-converter
  • F3-1: 重批337个type200入库(98.2%闸一) — platform-converter 转换产物
  • F3-1: report.spec.ts 5个断言+截图 — eip4-web