44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# 项目文档：配送点订单列表可读信息 v1.0
|
||
|
||
## 1. 项目概述
|
||
|
||
5176 配送点管理端订单列表复用 5173 的受控展示规则，在当前配送点数据范围内显示订单收货地址快照和合同气瓶摘要。数据库、订单创建协议及通用敏感字段保护规则保持不变。
|
||
|
||
## 2. 核心实现
|
||
|
||
```text
|
||
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. 验证
|
||
|
||
```text
|
||
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）：修复配送点订单列表收货地址和合同气瓶显示为横线的问题。
|