优化配送订单状态中文展示

docs/操作日志_配送订单状态展示优化_20260815.md

@@ -0,0 +1,49 @@
+# 配送订单状态展示优化操作日志
+
+操作时间：2026-08-15
+
+操作类型：修改
+
+影响模块：平台总后台、气体配送订单详情
+
+## 操作前状态
+
+- 订单详情中的异常前订单状态直接显示数字 `0`。
+- 状态记录中的原状态和新状态直接显示数字编码。
+- 尚未分配订单的工作人员唯一标识显示通用占位符 `-`。
+
+## 具体操作
+
+- 新增配送订单状态中文展示字典，并应用于当前状态、异常前状态和状态记录。
+- 按字段语义将 `previous_order_status=0` 显示为“无”，保留 `from_status=0` 的“草稿”含义。
+- 将空工作人员唯一标识显示为“暂未分配”。
+- 新增配送订单状态展示专项检查。
+
+## 操作后状态
+
+- 管理员无需理解数字编码即可阅读订单状态和流转历史。
+- 非异常订单与尚未分配订单具有明确空值文案。
+- 接口、数据库和订单状态机保持不变。
+
+## 代码变更
+
+- `frontend/platform_admin/src/api/resource-display.ts`：增加配送订单状态和空值展示规则。
+- `frontend/platform_admin/scripts/check-gasorder-status-display.mjs`：增加专项静态检查。
+- `frontend/platform_admin/package.json`：注册专项检查命令。
+- `docs/项目文档_配送订单状态展示优化_v1.0.md`：记录状态字典和维护规则。
+
+## 验证结果
+
+- `npm.cmd run gasorder-status-display:check`：通过。
+- `npm.cmd run gasorder-list-display:check`：通过，既有订单可读展示未回退。
+- `npm.cmd run type:check`：通过。
+- `npm.cmd run contract:check`：通过，48 个资源契约一致。
+- `npm.cmd run build`：通过，TypeScript 编译和 Vite 生产构建成功。
+- `git diff --check`：通过，未发现空白符错误。
+- 变更文件专项 Biome lint：通过，仅报告 `resource-display.ts` 原有的 `hasOwnProperty` 建议级警告。
+- 全量 `npm.cmd run lint`：未通过，仓库既有文件仍有 2 个错误和 176 个警告；本次未扩大范围处理。
+
+## 风险评估
+
+- 改动仅影响展示层，不改变状态值、接口或业务流转。
+- 状态字典集中维护；未知状态保留数字值以便排查，不会被错误映射。

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

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