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:
67
docs/P1/F2-16列渲染报告.md
Normal file
67
docs/P1/F2-16列渲染报告.md
Normal 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` | `未归档` / `待归档` 等 |
|
||||
Reference in New Issue
Block a user