完善配送订单列表可读信息

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

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