Files
eip4-platform/docs/P1/F2-16列渲染报告.md
zhengwr 2d8a16eef6 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>
2026-06-12 00:30:35 +08:00

68 lines
2.8 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.
# 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` | `未归档` / `待归档` 等 |