项目文档：配送订单详情关联可读展示 v1.0

1. 项目概述

本次调整统一平台总后台配送订单详情的业务识别信息。订单号作为主要业务编号；系统唯一标识保留为辅助复制信息。订单主体和分配历史中的气站、配送点、用户、创建方及配送人员使用当前档案名称展示。

2. 展示规则

场景	主展示	辅助信息
订单主体	订单号	请求流水号、系统唯一标识
配送合同	标题（合同编号）	合同唯一标识
创建方	当前业务名称	创建方唯一标识
服务用户	用户名称或账号	用户唯一标识
履约气站	气站名称	气站唯一标识
当前配送点	配送点名称	配送点唯一标识
当前配送人员	人员姓名	工作人员唯一标识
建单操作人	操作人姓名快照	操作人唯一标识

分配记录固定显示“分配时间、气站、配送点、配送人员、分配人、分配原因”；订单明细固定显示设备名称、编码、类型、参数和成交单价；状态记录固定显示发生时间、原状态、新状态、操作人和原因。关联记录标识、订单标识和服务端内部主键不作为默认表格列，历史 order created 原因统一显示为“订单创建”。

3. 核心文件

backend/api/internal/logic/platform/gasorder/order_list_display.go：批量读取详情关联名称并组装只读响应。
backend/api/internal/logic/platform/gasorder/gasorder.go：订单详情返回可读订单主体和分配历史。
frontend/platform_admin/src/api/resource-display.ts：订单详情及分配记录中文名称。
frontend/platform_admin/src/views/resource/ResourceDetailContent.vue：订单号排序、名称与标识组合显示、固定分配记录列。

4. 接口兼容性

原订单和分配记录字段全部保留，仅新增 *_display_name 只读字段。数据库结构、业务动作参数和订单状态机不变。关联档案不存在时返回“记录已失效”；订单尚未分配配送点或人员时返回“暂未分配”。

5. 维护指南

新增订单聚合子表字段时必须同时声明固定中文列和业务顺序，不允许直接将未知 JSON 键名作为最终表头。新增关联对象时同时提供业务名称和稳定唯一标识，名称用于识别，标识用于复制和接口传输。

2.4 KiB Raw Blame History