platforms/docs/操作日志_配送点订单列表可读信息_20260825.md

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

操作时间：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。

风险评估

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