2.8 KiB
2.8 KiB
客服工单详情空状态与关联展示修复操作日志
操作时间：2026-08-17 操作类型：修改 影响模块：平台总后台 / 客服管理 / 客服工单详情
操作前状态
- 待受理工单的配送点、处理人员、服务气站、开始时间、完成时间和处理结果统一显示
-，无法区分未分派、未开始和未完成等业务阶段。 - 配送点、气站和工作人员使用技术标识字段名，存在值时不能优先展示业务名称。
- 问题描述、请求流水号和最近操作记录缺失时缺少明确说明。
具体操作
- 配送点、处理人员和服务气站改为只在详情使用的关系字段，优先展示关联名称并保留唯一标识复制。
- 处理人员关系显式允许安装、配送和运维三类工单执行人员，满足工作人员关系加载器的安全过滤要求。
- 为未分派、未关联、未预约、未开始、未完成及未提交处理结果设置独立中文空状态。
- 增加
listHidden字段能力，详情辅助字段不扩张原有客服工单列表列数。 - 新增详情字段从客服工单新建页面隐藏，编辑协议仍只提交原有四个允许字段。
- 增加静态展示契约，防止空状态重新退化为裸占位符。
操作后状态
- 待受理工单详情能准确表达当前处理阶段。
- 原列表结构、新建字段、编辑字段及后端接口保持不变。
代码变更
frontend/platform_admin/src/api/resources.ts：补充客服工单详情关系字段及业务空状态。frontend/platform_admin/src/views/shared/resource-list-field-display.ts：支持详情专用字段从列表隐藏。frontend/platform_admin/src/api/resource-page-rules.ts：隐藏新建页面中的流程只读字段。frontend/platform_admin/scripts/check-resource-display-contracts.mjs：增加客服工单详情空状态契约。docs/项目文档_平台资源中文展示统一_v1.0.md：增加 v1.19 变更记录。
验证结果
- 资源展示契约检查通过：
pnpm resource-display-contracts:check。 - 后端接口契约检查通过：
pnpm contract:check。 - Biome 代码检查通过：
pnpm exec biome lint src/api/resources.ts src/api/resource-page-rules.ts src/views/shared/resource-list-field-display.ts scripts/check-resource-display-contracts.mjs。 - TypeScript 类型检查通过：
pnpm type:check。 - 前端生产构建通过：
pnpm build。 - 本地浏览器已确认应用可访问且无启动错误；独立测试浏览器未复用用户外部浏览器登录态，因此详情真实数据渲染仍需在已登录页面刷新确认。
风险评估
- 不修改数据库、接口字段或工单状态流转，仅调整前端展示元数据。
- 关系失效时仍保留唯一标识复制能力，便于排障。