48 lines
3.1 KiB
Markdown
48 lines
3.1 KiB
Markdown
# 操作日志：气站客服工单详情展示对齐
|
||
|
||
操作时间：2026-08-22
|
||
操作类型：修改
|
||
影响模块：气站管理后台客服工单详情、气站客服工单详情接口
|
||
|
||
## 操作前状态
|
||
|
||
- 5176 客服工单资源只声明用户、工单号、分类和优先级，详情页其余字段依赖通用回退，出现裸 `-`、内部字段名称以及“预约时间”缺失。
|
||
- 已有关联标识的工单详情没有随记录返回可读名称，详情页需要额外加载关系资源，服务气站关系在气站端没有可用的全局查询入口。
|
||
|
||
## 具体操作
|
||
|
||
- 将 5176 客服工单详情字段结构、顺序、中文名称和业务空状态与 5173 对齐。
|
||
- 补回“预约时间”，空值显示“未预约”；将“地址/说明/检修结果”等通用名称改为“上门地址/问题描述/处理结果”。
|
||
- 配送点、处理人员和服务气站在详情接口中按工单已保存的关系主键附加可读名称，并继续返回可复制的业务标识。
|
||
- 详情页仅对存在值且没有服务端可读名称的关系执行补载，空关系不发起无意义请求。
|
||
- 保留既有页面规则：辅助字段只在详情页展示，新建和编辑仍只处理用户、工单号、分类和优先级。
|
||
|
||
## 操作后状态
|
||
|
||
- 5176 客服工单详情与 5173 使用一致的字段结构和业务用语。
|
||
- 未分配、未预约、未开始、未完成等状态可直接理解，不再显示无语义的裸 `-`。
|
||
- 本次不修改工单存储数据，不回填历史归属，不改变创建、编辑、归档和状态流程。
|
||
|
||
## 代码变更
|
||
|
||
- `frontend/gas_admin/src/api/resources.ts`：新增完整客服工单详情字段契约。
|
||
- `frontend/gas_admin/src/views/resource/load-resource-record-relations.ts`：收敛详情关系预加载范围。
|
||
- `frontend/gas_admin/scripts/check-backend-contract.mjs`：增加详情字段和关系加载回归检查。
|
||
- `backend/api/internal/logic/gas/ticket.go`：详情响应附加当前工单关系的可读名称。
|
||
- `docs/06-气站管理系统需求.md`：补充详情展示、空状态与历史数据边界。
|
||
|
||
## 验证结果
|
||
|
||
- `pnpm contract:check` 通过，20 个资源契约一致。
|
||
- `pnpm resource-pages:check` 通过，详情 20 类、新建 11 类、编辑 8 类。
|
||
- `pnpm type:check` 与 `pnpm build` 通过。
|
||
- 本次前端修改文件定向 Biome 检查无新增错误；`resource-display.ts` 仍有 1 条既有 `hasOwnProperty` 风格警告，全量 lint 的既有警告未在本次扩展范围内处理。
|
||
- `go test ./...`（`backend/api`）通过，新增详情 SQL 测试验证气站范围、四类关系名称连接和展示别名。
|
||
- 本地页面热更新后不再出现“预约时间缺少中文名称”的启动错误；未登录浏览器被重定向到登录页，因此未代替用户登录验证受保护详情数据。
|
||
|
||
## 风险评估
|
||
|
||
- 详情接口新增只读展示字段，原有字段和接口路径保持兼容。
|
||
- 关系名称严格从工单已保存主键读取，不用当前服务关系推断或覆盖历史归属。
|
||
- 历史工单未保存关系主键时仍保持空值，仅以明确文案说明当前状态。
|