50 lines
2.3 KiB
Markdown
50 lines
2.3 KiB
Markdown
# 操作日志：气站客服工单枚举规范化
|
||
|
||
操作时间：2026-08-22
|
||
操作类型：修改
|
||
影响模块：气站管理系统、客服工单创建与编辑接口
|
||
|
||
## 操作前状态
|
||
|
||
- 气站端工单分类和优先级使用自由文本输入，用户无法知道标准填写内容。
|
||
- 服务端仅校验字段非空和长度，可写入任意分类或优先级字符串。
|
||
- 列表和详情可能直接显示技术编码。
|
||
|
||
## 具体操作
|
||
|
||
- 工单分类改为配送、安装、维修、安检、复检、客服咨询六项中文下拉，不设置默认值。
|
||
- 优先级改为低、普通、高、紧急四项中文下拉，默认选择普通。
|
||
- 已知编码在新建、编辑、列表和详情统一显示中文；未知历史值保留原编码提示。
|
||
- 气站工单创建和编辑接口增加枚举白名单，拒绝未定义编码。
|
||
- 增加后端单元测试和前端静态契约检查。
|
||
|
||
## 操作后状态
|
||
|
||
- 用户通过明确的中文选项填写工单，不再猜测技术编码。
|
||
- 绕过页面提交非法分类或优先级时，气站接口返回参数错误。
|
||
- 5173、配送点端、用户客户端及工单状态流程保持不变。
|
||
|
||
## 代码变更
|
||
|
||
- `frontend/gas_admin/src/api/resources.ts`：定义客服工单分类和优先级字段。
|
||
- `frontend/gas_admin/scripts/check-backend-contract.mjs`：增加客服工单枚举回归检查。
|
||
- `backend/api/internal/logic/gas/ticket_values.go`：定义气站工单枚举白名单。
|
||
- `backend/api/internal/logic/gas/ticket.go`：在创建和编辑入口校验枚举。
|
||
- `backend/api/internal/logic/gas/ticket_values_test.go`：验证合法值和非法值边界。
|
||
- `docs/06-气站管理系统需求.md`：同步工单枚举规则。
|
||
- `docs/项目文档_气站标准资源全页管理_v1.0.md`：更新气站资源变更记录。
|
||
|
||
## 验证结果
|
||
|
||
- 后端全量测试 `go test ./...`：通过。
|
||
- 气站端契约检查：通过，20 个资源一致。
|
||
- 气站端独立页面检查：通过，详情 20 类、新建 11 类、编辑 8 类。
|
||
- 修改文件代码检查：通过。
|
||
- 气站端类型检查和生产构建：通过。
|
||
|
||
## 风险评估
|
||
|
||
- 现有标准编码保持兼容，不修改数据库字段或历史记录。
|
||
- 历史未知编码仍可读取和展示，但再次编辑时必须选择标准值。
|
||
- 白名单仅作用于气站工单创建和编辑接口，不改变其他客户端分类范围。
|