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