platforms/docs/操作日志_配送订单详情关联可读展示_20260815.md

操作日志：配送订单详情关联可读展示

操作时间：2026-08-15

操作类型：修改

影响模块：平台总后台、配送订单详情、分配记录

操作前状态

订单详情突出系统唯一标识，订单号位于后续动态字段中；除配送合同外，气站、用户、配送点、工作人员和创建方主要显示裸唯一标识。分配记录使用通用字段推断，缺少关联名称，并可能显示 assigner_identity、assigner_name 等英文表头。

具体操作

• 订单详情接口增加创建方、服务用户、气站、配送点和配送人员的只读名称字段。
• 分配历史增加气站、配送点和配送人员名称，不修改不可变事实表。
• 订单号、请求流水号和订单状态提前展示，系统唯一标识改称“系统唯一标识”。
• 分配记录固定为六个中文业务列，不再追加未知响应字段。
• 订单明细和状态记录同步改为固定业务列，移除英文 active 表头及多余技术标识；历史 order created 展示为“订单创建”，新记录直接写入中文原因。
• 关联名称和建单操作人姓名快照为主文案，稳定唯一标识继续提供复制能力；重复的操作人姓名字段不再单独展示。

操作后状态

业务人员可通过订单号和中文业务名称识别订单及分配历史；技术标识仍可复制。分配记录不再泄漏英文接口键名或内部主键。

验证结果

• 后端配送订单专项测试、全量 go test ./...、go vet ./... 和主程序构建通过。
• 前端配送订单可读显示静态检查、设备参数回归检查和 TypeScript 类型检查通过。
• 前端生产构建通过，Vite 成功构建 2621 个模块。
• 本地后端已保留旧版本备份并重启；12426 端口恢复监听，健康接口返回 platform-api / ok。
• 内置浏览器重新登录并访问目标详情后完成真实数据渲染：订单号位于首项，创建方、服务用户、气站、配送点、配送人员和建单操作人均显示名称与可复制标识；分配记录显示六个中文业务列，整页无横向溢出。
• 浏览器验收发现的订单明细 active 英文列和状态记录技术列已继续收口为固定中文业务列，并由静态检查、类型检查和生产构建覆盖。

风险评估

• 新字段仅用于管理端只读展示，原 JSON 字段和客户端兼容性保持不变。
• 名称取自当前关联档案，档案改名后详情随之变化；分配时间、原因和关联标识仍保持历史事实。
• 关联档案被删除或不可读取时显示“记录已失效”，不伪造历史名称。