platforms/docs/操作日志_配送点详情字段中文化_20260823.md

操作日志：配送点详情字段中文化

操作时间：2026-08-23 操作类型：新增、修改 影响模块：5176 标准资源详情、合同关联记录、合同动作区

操作前状态

详情组件按响应对象键顺序动态展示字段。合同详情出现 user_account_display_name、user_service_active、bound_at、product_name、product_params 等英文键；合同状态显示数字，JSON 参数在表格中被截断。

具体操作

1. 新增配送端聚合详情契约，固定合同、订单的主字段和关联记录列序。
2. 建立主详情与集合上下文中文标签，未知响应键默认不展示。
3. 将用户名称合并到用户唯一标识行，将设备和操作人名称与唯一标识组合展示。
4. 增加合同状态、合同动作、订单状态、布尔、金额和时间格式化。
5. 为 JSON 参数增加“查看参数”弹层，支持对象、合法 JSON 字符串和历史普通文本。
6. 明确当前设备名称与合同绑定快照的语义区别。
7. 当签约用户不再属于合同气站时，仅保留终止合同操作。
8. 根据修复后页面截图收尾：合同关系字段使用“所属气站、所属配送点”，状态标签改为内容宽度，避免在详情网格中拉伸成整条色块。
9. 补齐合同详情接口的气站、配送点只读名称字段，使三个主体关系统一显示“名称 + 唯一标识复制”，不再把 UUID 当作主要文案。

行为变化

• 变更前：未知英文键直接成为标签，子表列序随响应漂移。
• 变更后：只显示具有中文业务契约的字段；合同气瓶和修订记录使用固定列与完整参数查看器。
• 兼容性：不修改 API 原字段、数据库和原始业务值，仅新增只读名称；未知历史状态或动作仍保留原编码用于排障。
• 视觉变化：状态标签保留状态颜色但紧凑展示；合同关联对象使用业务称呼，不再显示“气站唯一标识、配送点唯一标识”等技术标签。
• 接口变化：合同详情兼容性新增 gas_basic_display_name、delivery_basic_display_name；原 identity 字段、数据库结构和写入协议不变。

验证结果

• npm.cmd run type:check：通过。
• npm.cmd run resource-pages:check：通过，详情 17、新建 9、编辑 5，并覆盖详情白名单、固定列序、关系合并、JSON 查看器和动作限制。
• npm.cmd run contract:check、npm.cmd run profile:check：通过。
• npm.cmd run build：通过，2643 个模块完成生产构建。
• go test ./api/internal/logic/platform/gasorder ./api/internal/logic/delivery：通过。
• 用户提供的修复后截图确认英文辅助键、固定中文列序与 JSON 查看入口已生效，并据此发现和修正状态标签拉伸、关系标签技术化问题。
• 后端已重新构建并恢复监听 12426；旧程序保存在 platform-api.before-contract-relation-display.exe，可回退。

风险评估

• 新后端字段默认隐藏：通过自动检查和维护规范要求先补中文契约，避免内部字段意外暴露。
• 当前设备名称可能变化：页面说明其非历史快照，编码和类型继续作为绑定快照展示。
• 子表字段较多：保留固定列宽和横向滚动，避免压缩导致内容不可读。