heqiapp/platforms

Files

czl231 deea31d79e 修复合同详情字段中文显示

通用详情页复用中文字段字典，并为合同气瓶快照补充上下文名称。
合同状态按模型常量显示中文，数据库字段和 API 保持不变。
已通过资源页面检查、类型检查和生产构建。

2026-08-12 19:49:41 +08:00

2.4 KiB

Raw Blame History

合同详情字段中文化操作日志

操作时间：2026-08-12

操作类型：修改、扩展

影响模块：平台总后台通用资源详情页、配送合同详情页

操作前状态

通用详情页只从当前资源的表单字段配置中查找中文名称。接口返回但未列入表单配置的只读字段会直接显示英文键名；聚合子表也没有携带业务上下文，导致合同状态显示为 contract_status 11，合同气瓶快照显示英文表头。

具体操作

让通用详情字段名称解析复用现有全局中文字段字典。
为合同气瓶聚合集合增加基于模型语义的上下文字段名称。
根据后端合同状态常量增加前端只读显示映射。
聚合表格传入集合名称，确保上下文规则可以生效。
在标准资源页面静态检查中增加中文字段与合同状态映射断言。

行为变化

变更前：未显式配置的详情字段回显英文键名，合同状态 11 显示为数字。
变更后：字段名使用中文兜底；合同状态 11 显示为“生效中”；合同气瓶字段按气瓶快照语义展示。
数据库字段、API 字段、状态原始值及业务操作判断均未改变。

代码变更

frontend/platform_admin/src/api/resources.ts：导出全局中文字段名称查询，并补充快照字段名称。
frontend/platform_admin/src/api/resource-display.ts：增加合同气瓶上下文字段名称和合同状态显示映射。
frontend/platform_admin/src/views/resource/ResourceDetailContent.vue：聚合表头传入集合上下文。
frontend/platform_admin/scripts/check-resource-pages.mjs：增加静态回归断言。

验证结果

npm run resource-pages:check：通过，覆盖详情 46 类、新建 25 类、编辑 23 类。
npm run type:check：通过。
npm run build：通过，Vite 成功构建 2615 个模块。
页面自动打开后被重定向到登录页；应用内浏览器没有现有登录会话，因此未执行登录后的视觉检查。

风险评估

修改仅影响前端显示，不改变接口兼容性和业务状态判断。
上下文覆盖仅作用于 gasorder_contract.products，不会把商城商品编码误改为气瓶编码。
后续增加新的聚合详情集合时，仍需补充对应的上下文字段名称，否则无法准确区分同名字段的业务语义。