44 lines
2.0 KiB
Markdown
44 lines
2.0 KiB
Markdown
# 客服工单关联与枚举中文展示修复操作日志
|
||
|
||
操作时间：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`。
|
||
|
||
## 风险评估
|
||
|
||
- 仅调整前端字段元数据和展示方式，不改变接口字段、数据库值或现有路由。
|
||
- 历史未知编码使用兜底提示，避免被错误翻译。
|