# 操作日志：配送点订单列表可读信息

操作时间：2026-08-25
操作类型：扩展、修改
影响模块：5176 配送订单列表、配送订单列表接口

## 操作前状态

- 收货地址快照经过通用位置保护后，列表显示为 `-`。
- 合同气瓶属于订单明细集合，通用列表响应没有可读摘要。
- 5173 已有受控地址恢复和气瓶摘要，但 5176 仍使用通用列表函数。

## 具体操作

1. 把 5173 已有订单列表展示构造过程封装为共享函数。
2. 配送端先限定当前配送点订单，再调用共享函数生成安全响应。
3. 前端字段声明读取 `address` 和 `contract_products_summary` 派生字段。
4. 合同气瓶摘要增加订单详情入口，空值统一显示“未填写”。
5. 增加静态契约检查，防止以后退回裸关联字段或横线展示。

## 行为变化

- 变更前：收货地址和合同气瓶均显示 `-`。
- 变更后：地址显示订单快照；气瓶显示可读摘要并可进入订单详情。
- 兼容性：不修改数据库、创建订单请求和既有路由，只扩展已鉴权列表响应。

## 验证结果

- `go test ./api/internal/logic/delivery ./api/internal/logic/platform/gasorder`：通过。
- `npm.cmd run type:check`：通过。
- `npm.cmd run resource-pages:check`：通过，详情 17、新建 9、编辑 5。
- `npm.cmd run contract:check`：通过，18 个资源。
- `npm.cmd run build`：通过，2648 个模块完成生产构建。
- 后端已重新构建并恢复监听 `12426`，旧程序已备份为 `platform-api.before-order-list-20260825-232713.exe`。

## 风险评估

- 地址属于敏感数据：仅对当前配送点已授权订单恢复快照，不影响公共接口。
- 气瓶当前名称可能随设备档案改名变化；类型和编码仍使用订单快照。
- 完整气瓶信息继续以订单详情为准，列表只提供紧凑摘要。