完善客服工单关联与枚举中文展示
This commit is contained in:
43
docs/操作日志_客服工单关联与枚举中文展示修复_20260817.md
Normal file
43
docs/操作日志_客服工单关联与枚举中文展示修复_20260817.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# 客服工单关联与枚举中文展示修复操作日志
|
||||
|
||||
操作时间:2026-08-17
|
||||
操作类型:修改
|
||||
影响模块:平台总后台 / 客服管理 / 客服工单
|
||||
|
||||
## 操作前状态
|
||||
|
||||
- 用户列直接显示内部 UUID,业务人员无法快速识别提交人。
|
||||
- 分类和优先级直接显示 `delivery`、`normal` 等技术编码。
|
||||
- 新建、编辑页面使用自由文本输入,和列表的业务表达不一致。
|
||||
|
||||
## 具体操作
|
||||
|
||||
- 用户字段沿用 `/user_account` 关系接口,列表和详情优先展示用户名称,同时保留系统标识复制能力。
|
||||
- 分类增加配送、安装、维修、安检、复检、客服咨询中文选项。
|
||||
- 优先级增加低、普通、高、紧急中文选项,默认值仍为 `normal`。
|
||||
- 未知历史编码继续展示明确的未知值提示,不修改或丢弃原始值。
|
||||
- 增加静态展示契约检查,防止客服工单退回技术编码直出。
|
||||
|
||||
## 操作后状态
|
||||
|
||||
- 工单列表、详情、新建和编辑使用一致的中文业务名称。
|
||||
- API 与数据库仍使用原编码,公共接口保持向下兼容。
|
||||
|
||||
## 代码变更
|
||||
|
||||
- `frontend/platform_admin/src/api/resources.ts`:补充客服工单用户关系展示、分类和优先级枚举。
|
||||
- `frontend/platform_admin/scripts/check-resource-display-contracts.mjs`:增加客服工单中文展示契约。
|
||||
- `docs/项目文档_平台资源中文展示统一_v1.0.md`:增加 v1.18 变更记录。
|
||||
|
||||
## 验证结果
|
||||
|
||||
- 资源展示契约检查通过:`pnpm resource-display-contracts:check`。
|
||||
- 后端接口契约检查通过:`pnpm contract:check`。
|
||||
- Biome 代码检查通过:`pnpm exec biome lint src/api/resources.ts scripts/check-resource-display-contracts.mjs`。
|
||||
- TypeScript 类型检查通过:`pnpm type:check`。
|
||||
- 前端生产构建通过:`pnpm build`。
|
||||
|
||||
## 风险评估
|
||||
|
||||
- 仅调整前端字段元数据和展示方式,不改变接口字段、数据库值或现有路由。
|
||||
- 历史未知编码使用兜底提示,避免被错误翻译。
|
||||
@@ -80,3 +80,4 @@ frontend/platform_admin/
|
||||
- v1.15:财务结算主体类型改为气站、配送点、工作人员中文枚举,并按类型联动对应主体资源,切换类型时清空旧主体。
|
||||
- v1.16:财务对账渠道统一显示余额支付、支付宝、微信支付;账单日期按 `YYYY-MM-DD` 展示,不再回显时间和时区。
|
||||
- v1.17:内容类型统一显示公告、协议,发布状态统一显示草稿、已发布;新建和编辑改用中文下拉并保留未知值提示。
|
||||
- v1.18:客服工单用户统一展示可读名称并保留标识复制;分类与优先级统一显示中文,新建和编辑改用中文下拉并保留未知值提示。
|
||||
|
||||
Reference in New Issue
Block a user