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

通用详情页复用中文字段字典,并为合同气瓶快照补充上下文名称。
合同状态按模型常量显示中文,数据库字段和 API 保持不变。
已通过资源页面检查、类型检查和生产构建。
This commit is contained in:
czl231
2026-08-12 19:49:41 +08:00
parent 3cad8fd0ba
commit deea31d79e
6 changed files with 154 additions and 6 deletions

View File

@@ -0,0 +1,46 @@
# 合同详情字段中文化操作日志
操作时间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`,不会把商城商品编码误改为气瓶编码。
- 后续增加新的聚合详情集合时,仍需补充对应的上下文字段名称,否则无法准确区分同名字段的业务语义。