48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
# 配送订单列表可读信息优化操作日志
|
||
|
||
操作时间：2026-08-14
|
||
操作类型：修改
|
||
影响模块：平台总后台、气体配送订单列表
|
||
|
||
## 操作前状态
|
||
|
||
- 创建方列直接显示唯一标识，管理员无法快速识别实际创建主体。
|
||
- 收货地址已写入订单快照，但经过通用位置保护后列表显示为 `-`。
|
||
- 合同气瓶是订单明细集合，通用列表没有生成可读摘要。
|
||
|
||
## 具体操作
|
||
|
||
- 为平台配送订单列表增加专用只读响应，批量解析用户、工作人员、配送站和气站的当前名称。
|
||
- 在全局位置保护执行后，仅为已鉴权的平台订单列表恢复订单自身的收货地址快照。
|
||
- 批量读取订单当前有效气瓶，生成“智能气阀名称（设备类型）”摘要；多只设备显示“等 N 个”。
|
||
- 前端列表字段支持读取专用展示字段，合同气瓶摘要可直接进入订单详情。
|
||
- 未扩展模糊搜索，未修改数据库结构和订单持久化字段。
|
||
|
||
## 操作后状态
|
||
|
||
- 创建方以当前可读名称展示；关联记录失效时显示“记录已失效”，并保留唯一标识复制入口。
|
||
- 收货地址显示订单创建时保存的地址快照，空值显示“未填写”，长文本沿用表格悬浮全文能力。
|
||
- 合同气瓶显示紧凑摘要，点击后可在详情页查看全部气瓶记录。
|
||
- 创建方可读名称的渲染优先于通用唯一标识分支，名称旁保留独立复制入口；失效记录显示“记录已失效”。
|
||
- 配送合同在订单列表和详情中统一显示“标题（合同编号）”，并保留合同唯一标识复制入口。
|
||
|
||
## 代码变更
|
||
|
||
- `backend/api/internal/logic/platform/gasorder/order_list_display.go`
|
||
- `backend/api/internal/logic/platform/gasorder/order_list_display_test.go`
|
||
- `backend/api/internal/logic/platform/gasorder/gasorder.go`
|
||
- `frontend/platform_admin/src/api/resources.ts`
|
||
- `frontend/platform_admin/src/views/shared/CrudListPage.vue`
|
||
|
||
## 验证结果
|
||
|
||
- 后端平台配送订单专项测试通过。
|
||
- 平台总后台 TypeScript 类型检查与生产构建通过。
|
||
- 配送订单列表与详情可读显示专项静态检查通过。
|
||
|
||
## 风险评估
|
||
|
||
- 创建方展示的是关联档案当前名称，档案改名后列表名称会同步变化；订单的创建方唯一标识保持不变。
|
||
- 地址恢复仅位于平台管理端订单列表专用接口，不修改通用敏感字段保护规则。
|
||
- 气瓶摘要只统计订单当前有效明细，完整历史仍以订单详情为准。
|