34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# 项目文档：配送订单状态展示优化 v1.0
|
|
|
|
## 1. 项目概述
|
|
|
|
平台总后台的配送订单详情和状态记录统一展示中文业务状态，并为异常前状态及未分配工作人员提供明确文案，避免管理员直接理解数字编码或无语义占位符。
|
|
|
|
## 2. 状态字典
|
|
|
|
- `0`：草稿，仅用于首条状态记录的原状态。
|
|
- `16`：已创建。
|
|
- `18`：已分配。
|
|
- `19`：充装中。
|
|
- `20`：已就绪。
|
|
- `21`：异常。
|
|
- `22`：已取消。
|
|
- `23`：已完成。
|
|
- `33`：配送中。
|
|
- `34`：待确认。
|
|
|
|
## 3. 核心行为
|
|
|
|
- 订单当前状态、状态记录原状态和新状态使用同一中文状态字典。
|
|
- `previous_order_status=0` 是“没有异常前状态”的哨兵值，单独显示为“无”，不显示为“草稿”。
|
|
- 工作人员唯一标识为空时显示“暂未分配”。
|
|
- 唯一标识继续使用公共组件展示末尾 12 位，支持悬浮查看和点击复制完整值。
|
|
|
|
## 4. 接口兼容性
|
|
|
|
本次仅修改前端展示，不修改数据库字段、后端状态机、接口字段和值域。
|
|
|
|
## 5. 维护指南
|
|
|
|
配送订单新增状态时，应先更新服务端状态常量与状态机规则，再同步更新 `gasorderStatusLabel` 和专项展示检查。
|