40 lines
2.6 KiB
Markdown
40 lines
2.6 KiB
Markdown
# 操作日志：配送订单详情关联可读展示
|
||
|
||
操作时间：2026-08-15
|
||
|
||
操作类型：修改
|
||
|
||
影响模块：平台总后台、配送订单详情、分配记录
|
||
|
||
## 操作前状态
|
||
|
||
订单详情突出系统唯一标识，订单号位于后续动态字段中；除配送合同外，气站、用户、配送点、工作人员和创建方主要显示裸唯一标识。分配记录使用通用字段推断，缺少关联名称，并可能显示 `assigner_identity`、`assigner_name` 等英文表头。
|
||
|
||
## 具体操作
|
||
|
||
- 订单详情接口增加创建方、服务用户、气站、配送点和配送人员的只读名称字段。
|
||
- 分配历史增加气站、配送点和配送人员名称，不修改不可变事实表。
|
||
- 订单号、请求流水号和订单状态提前展示，系统唯一标识改称“系统唯一标识”。
|
||
- 分配记录固定为六个中文业务列，不再追加未知响应字段。
|
||
- 订单明细和状态记录同步改为固定业务列，移除英文 `active` 表头及多余技术标识；历史 `order created` 展示为“订单创建”，新记录直接写入中文原因。
|
||
- 关联名称和建单操作人姓名快照为主文案，稳定唯一标识继续提供复制能力；重复的操作人姓名字段不再单独展示。
|
||
|
||
## 操作后状态
|
||
|
||
业务人员可通过订单号和中文业务名称识别订单及分配历史；技术标识仍可复制。分配记录不再泄漏英文接口键名或内部主键。
|
||
|
||
## 验证结果
|
||
|
||
- 后端配送订单专项测试、全量 `go test ./...`、`go vet ./...` 和主程序构建通过。
|
||
- 前端配送订单可读显示静态检查、设备参数回归检查和 TypeScript 类型检查通过。
|
||
- 前端生产构建通过，Vite 成功构建 2621 个模块。
|
||
- 本地后端已保留旧版本备份并重启；12426 端口恢复监听，健康接口返回 `platform-api / ok`。
|
||
- 内置浏览器重新登录并访问目标详情后完成真实数据渲染：订单号位于首项，创建方、服务用户、气站、配送点、配送人员和建单操作人均显示名称与可复制标识；分配记录显示六个中文业务列，整页无横向溢出。
|
||
- 浏览器验收发现的订单明细 `active` 英文列和状态记录技术列已继续收口为固定中文业务列，并由静态检查、类型检查和生产构建覆盖。
|
||
|
||
## 风险评估
|
||
|
||
- 新字段仅用于管理端只读展示，原 JSON 字段和客户端兼容性保持不变。
|
||
- 名称取自当前关联档案，档案改名后详情随之变化；分配时间、原因和关联标识仍保持历史事实。
|
||
- 关联档案被删除或不可读取时显示“记录已失效”，不伪造历史名称。
|