# 客服工单详情空状态与关联展示修复操作日志

操作时间：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`。
- 本地浏览器已确认应用可访问且无启动错误；独立测试浏览器未复用用户外部浏览器登录态，因此详情真实数据渲染仍需在已登录页面刷新确认。

## 风险评估

- 不修改数据库、接口字段或工单状态流转，仅调整前端展示元数据。
- 关系失效时仍保留唯一标识复制能力，便于排障。