41 lines
1.9 KiB
Markdown
41 lines
1.9 KiB
Markdown
# 操作日志：配送点订单列表可读信息
|
||
|
||
操作时间：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`。
|
||
|
||
## 风险评估
|
||
|
||
- 地址属于敏感数据：仅对当前配送点已授权订单恢复快照，不影响公共接口。
|
||
- 气瓶当前名称可能随设备档案改名变化；类型和编码仍使用订单快照。
|
||
- 完整气瓶信息继续以订单详情为准，列表只提供紧凑摘要。
|