platforms/docs/项目文档_配送订单状态展示优化_v1.0.md

项目文档：配送订单状态展示优化 v1.0

1. 项目概述

平台总后台的配送订单详情和状态记录统一展示中文业务状态，并为异常前状态及未分配工作人员提供明确文案，避免管理员直接理解数字编码或无语义占位符。

2. 状态字典

• 0：草稿，仅用于首条状态记录的原状态。
• 16：已创建。
• 18：已分配。
• 19：充装中。
• 20：已就绪。
• 21：异常。
• 22：已取消。
• 23：已完成。
• 33：配送中。
• 34：待确认。

3. 核心行为

• 订单当前状态、状态记录原状态和新状态使用同一中文状态字典。
• previous_order_status=0 是“没有异常前状态”的哨兵值，单独显示为“无”，不显示为“草稿”。
• 工作人员唯一标识为空时显示“暂未分配”。
• 唯一标识继续使用公共组件展示末尾 12 位，支持悬浮查看和点击复制完整值。

4. 接口兼容性

本次仅修改前端展示，不修改数据库字段、后端状态机、接口字段和值域。

5. 维护指南

配送订单新增状态时，应先更新服务端状态常量与状态机规则，再同步更新 gasorderStatusLabel 和专项展示检查。