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

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