platforms/docs/项目文档_配送合同关联信息展示_v1.1.md

配送合同关联信息展示项目文档 v1.1

项目概述

本版本修复平台总后台通用资源详情页在字段未直接列入资源表单配置时回显英文键名的问题。配送合同及其合同气瓶关联记录根据数据库模型语义展示中文字段名称，底层数据库字段、接口字段和原始值保持兼容。

主要功能

• 通用详情页使用平台资源中文字段字典作为只读字段的兜底名称。
• 配送合同状态按模型常量显示为草稿、待处理、生效中、已过期或已终止。
• 合同气瓶关联表按快照语义显示“气瓶编码”“气瓶类型名称”“气瓶规格参数”等名称。
• 同名字段仍可在其他业务上下文使用原有名称，例如商城的 product_code 继续显示“商品编码”。

目录与核心文件

platforms/
├── frontend/platform_admin/
│   ├── src/api/resources.ts                       # 全局字段中文名称配置
│   ├── src/api/resource-display.ts                # 详情字段与状态值格式化
│   ├── src/views/resource/ResourceDetailContent.vue # 聚合详情表格展示
│   └── scripts/check-resource-pages.mjs           # 静态回归检查
└── docs/                                           # 项目文档与操作日志

核心规则

1. 显式资源字段配置优先于全局字段名称。
2. 聚合子表的上下文名称优先级最高，避免同名字段在不同业务中被错误翻译。
3. 合同状态显示映射为：0=草稿、10=待处理、11=生效中、12=已过期、13=已终止。
4. 未知状态显示为“未知（原始值）”，避免隐藏异常数据。
5. 本次仅修改展示层，不修改数据库、Go 模型和 API 响应结构。

维护指南

• 新增普通只读字段时，优先在 resources.ts 的全局字段字典补充中文名称。
• 同一字段在聚合子表中具有特殊语义时，在 resource-display.ts 中增加“父资源.集合名”上下文覆盖。
• 修改详情字段解析后运行 npm run resource-pages:check、npm run type:check 和 npm run build。

变更记录

• v1.1（2026-08-12）：增加通用字段中文兜底、合同状态中文化和合同气瓶上下文字段名称。