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

配送订单状态展示优化操作日志

操作时间：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 个警告；本次未扩大范围处理。

风险评估

• 改动仅影响展示层，不改变状态值、接口或业务流转。
• 状态字典集中维护；未知状态保留数字值以便排查，不会被错误映射。