50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
# 配送订单状态展示优化操作日志
|
||
|
||
操作时间：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 个警告；本次未扩大范围处理。
|
||
|
||
## 风险评估
|
||
|
||
- 改动仅影响展示层，不改变状态值、接口或业务流转。
|
||
- 状态字典集中维护；未知状态保留数字值以便排查，不会被错误映射。
|