platforms/docs/项目文档_配送点订单列表可读信息_v1.0.md

项目文档：配送点订单列表可读信息 v1.0

1. 项目概述

5176 配送点管理端订单列表复用 5173 的受控展示规则，在当前配送点数据范围内显示订单收货地址快照和合同气瓶摘要。数据库、订单创建协议及通用敏感字段保护规则保持不变。

2. 核心实现

backend/api/internal/logic/
├── delivery/order.go                         # 先限定当前配送点，再构造订单列表响应
└── platform/gasorder/order_list_display.go  # 统一生成地址和气瓶可读摘要
frontend/delivery_admin/src/
├── api/resources.ts                         # 声明列表派生展示字段
└── views/shared/ResourceListPage.vue        # 渲染只读摘要和详情入口

3. 展示规则

• 收货地址显示订单创建时保存的地址快照；空快照显示“未填写”。
• 合同气瓶显示第一只气瓶的当前智能气阀名称和下单时类型快照；多只气瓶追加“等 N 个”。
• 合同气瓶摘要可进入订单详情查看完整明细。
• 地址和气瓶摘要均为只读派生字段，不参与新建或业务动作提交。

4. 安全边界

• 配送端必须先按当前登录账号所属配送点筛选订单，再调用共享展示构造器。
• 地址恢复只作用于已经鉴权、已经完成配送点范围过滤的订单分页结果。
• 气瓶摘要只按当前页订单主键批量查询，不接受前端提供任意订单主键。
• 通用资源响应的地址、经纬度保护规则不变。

5. 验证

go test ./api/internal/logic/delivery ./api/internal/logic/platform/gasorder
npm.cmd run type:check
npm.cmd run resource-pages:check
npm.cmd run build

6. 变更记录

• v1.0（2026-08-25）：修复配送点订单列表收货地址和合同气瓶显示为横线的问题。