F2-16: 转换器列级渲染映射——枚举/日期/布尔列显示人话

TemplateToAmisConverter.buildColumns() 按 entityId 查询
SYS_ENTITYATTRIBUTE 元数据,注入 amis 列渲染配置:
- DATE → type=date(YYYY-MM-DD)
- TIME → type=datetime(YYYY-MM-DD HH:mm)
- ENUMERATE/STATUS → type=mapping,枚举翻译表从 SYS_ENUMERATE 嵌入
- BOOLEAN → type=mapping({0:否,1:是,false:否,true:是})

覆盖:3147 列命中(12138 总列),875 个模板;
重批 1516 条,闸一 98.2% 不变;单测 33/33;e2e 35/35。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-12 00:30:35 +08:00
parent ea6fc747d8
commit 2d8a16eef6
4 changed files with 1248 additions and 877 deletions

View File

@@ -0,0 +1,67 @@
# F2-16 转换器列级渲染映射报告
## 目标
让所有列表页(crud)的枚举/日期/布尔列在 amis 前端以人话显示,消除裸 ISO 串、裸数字、裸 false。
## 实现口径
`TemplateToAmisConverter.buildColumns()` 在生成 crud columns 时,按 entityId 查询 `SYS_ENTITYATTRIBUTE.referenceid` + `enumeratetype`,按如下规则注入 amis 列渲染配置:
| referenceid | amis type | 额外配置 |
|---|---|---|
| `DATE` | `date` | format=`YYYY-MM-DD`, inputFormat=`YYYY-MM-DDTHH:mm:ss.SSSZ` |
| `TIME` | `datetime` | format=`YYYY-MM-DD HH:mm`, inputFormat=`YYYY-MM-DDTHH:mm:ss.SSSZ` |
| `ENUMERATE` / `STATUS` | `mapping` | map 从 `SYS_ENUMERATE` 查库嵌入(codevalue→codedes) |
| `BOOLEAN` | `mapping` | map = `{0:否, 1:是, false:否, true:是}` |
| 其他(NVARCHAR/CHAR/INTEGER 等) | 不注入 | 保持原状 |
**ismoney=true 的金额列优先级更高**,不被本规则覆盖。
## Trade-off:枚举 schema 自含
枚举翻译值在转换时(重批时)从 `SYS_ENUMERATE` 查库嵌入 schema,**不引入运行时翻译端点**。
- 优点:schema 自含,前端零依赖,闸一通过率不变。
- 代价:枚举值变更后需重批入库(python3 tools/page-schema-loader/load_page_schema.py 幂等)。
## 覆盖统计
重批后全量 crud 列渲染映射命中统计(1489 个有效产物,12138 列):
| 类型 | 列数 | 说明 |
|---|---|---|
| date(纯日期) | 1149 | YYYY-MM-DD 格式 |
| datetime(日期时间) | 215 | YYYY-MM-DD HH:mm 格式 |
| 枚举 mapping | 1549 | ENUMERATE/STATUS → 中文翻译嵌入 |
| 布尔 mapping | 234 | BOOLEAN → 否/是 |
| **合计命中** | **3147** | 占总列数 25.9% |
| 涉及模板数 | 875 | / |
## 重批核数
```
总量: 1516
闸一(schema)通过: 1489 (98.2%) ← 与 F2-14 前持平
onEvent 脚本钩子挂载: 380 个模板
分级: PARTIAL=1230 SUCCESS=259 FAILED=27
```
闸一通过率保持 98.2%,未因列渲染映射注入引入 schema 校验降级。
## 验证
- 单测:`TemplateToAmisConverterTest` 新增 5 个 F2-16 用例(日期/枚举/布尔/不动/空 entityId),全部通过,合计 33/33。
- 重批:1516 条,闸一 98.2%,总量与 F2-14 持平。
- 入库:eip4dev + eip4m0 各更新 1104 条。
- e2e:35/35 通过(含 F2-16 通知管理页专项)。
- 实证截图:`eip4-web/e2e/artifacts/f2-16/notify-manage-full.png`、`notify-manage-table.png`。
## 典型列验证(通知管理页 e732c4b0)
| 列名 | 修改前 | 修改后 |
|---|---|---|
| SAVETIME(保存时间) | `2026-06-01T10:04:17.431Z` | `2026-06-01 10:04` |
| STATUS(审批状态) | `1` / `2` | `未提交` / `处理中` 等 |
| ISSEND(是否已发送) | `false` | `否` |
| IMPORTANT(重要级别) | `0` / `1` | `一般` / `重要` |
| ISPLACE(归档状态) | `0` / `1` | `未归档` / `待归档` 等 |