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

2.8 KiB
Raw Blame History

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