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