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>
This commit is contained in:
2026-06-12 04:42:08 +08:00
parent 1f8de4adc6
commit fe539a88fb
2 changed files with 378 additions and 147 deletions

231
docs/P1/F3-1报表报告.md Normal file
View File

@@ -0,0 +1,231 @@
# 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