完善客服工单详情空状态与关联展示

docs/操作日志_客服工单详情空状态与关联展示修复_20260817.md

@@ -0,0 +1,47 @@
+# 客服工单详情空状态与关联展示修复操作日志
+
+操作时间：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`。
+- 本地浏览器已确认应用可访问且无启动错误；独立测试浏览器未复用用户外部浏览器登录态，因此详情真实数据渲染仍需在已登录页面刷新确认。
+
+## 风险评估
+
+- 不修改数据库、接口字段或工单状态流转，仅调整前端展示元数据。
+- 关系失效时仍保留唯一标识复制能力，便于排障。

docs/项目文档_平台资源中文展示统一_v1.0.md

@@ -81,3 +81,4 @@ frontend/platform_admin/
 - v1.16：财务对账渠道统一显示余额支付、支付宝、微信支付；账单日期按 `YYYY-MM-DD` 展示，不再回显时间和时区。
 - v1.17：内容类型统一显示公告、协议，发布状态统一显示草稿、已发布；新建和编辑改用中文下拉并保留未知值提示。
 - v1.18：客服工单用户统一展示可读名称并保留标识复制；分类与优先级统一显示中文，新建和编辑改用中文下拉并保留未知值提示。
+- v1.19：客服工单详情的气站、配送点和处理人员统一展示关系名称；未分派、未开始、未完成及未提交结果等空值改用明确业务状态，不再显示裸 `-`。