platforms/docs/操作日志_客服工单关联与枚举中文展示修复_20260817.md

客服工单关联与枚举中文展示修复操作日志

操作时间：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。

风险评估

• 仅调整前端字段元数据和展示方式，不改变接口字段、数据库值或现有路由。
• 历史未知编码使用兜底提示，避免被错误翻译。