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

232 lines
9.4 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.
# 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