完善气站客服工单详情展示
This commit is contained in:
@@ -138,6 +138,9 @@
|
||||
- 不得读取或操作其他气站用户的工单。
|
||||
- 不新增重复工单模型,统一复用 `cs_ticket`。
|
||||
- 工单分类使用配送、安装、维修、安检、复检、客服咨询六项必选枚举,不设置默认分类;优先级使用低、普通、高、紧急四项必选枚举,默认普通。前端显示中文,接口保存统一编码,气站接口拒绝未定义枚举。
|
||||
- 工单详情结构与平台总后台保持一致,完整展示用户、工单号、分类、优先级、配送点、处理人员、服务气站、最近操作人标识、问题描述、请求流水号、上门地址、预约时间、开始时间、完成时间和处理结果;关系字段优先展示可读名称并保留业务标识复制。
|
||||
- 尚未产生的详情数据不得统一显示裸 `-`:应分别显示“尚未分配配送点”“尚未分配处理人员”“尚未关联服务气站”“暂无操作记录”“未填写问题描述”“未记录请求流水号”“未填写上门地址”“未预约”“尚未开始处理”“尚未完成”和“尚未提交处理结果”。这些辅助字段只在详情页展示,不扩展气站端新建和编辑表单。
|
||||
- 详情展示对齐不得根据用户当前服务关系回填历史工单,也不得修改工单创建、归属或状态流程;历史记录缺少数据时只展示可信的业务空状态。
|
||||
|
||||
### 4.9 邀请注册
|
||||
|
||||
|
||||
47
docs/操作日志_气站客服工单详情展示对齐_20260822.md
Normal file
47
docs/操作日志_气站客服工单详情展示对齐_20260822.md
Normal file
@@ -0,0 +1,47 @@
|
||||
# 操作日志:气站客服工单详情展示对齐
|
||||
|
||||
操作时间: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 测试验证气站范围、四类关系名称连接和展示别名。
|
||||
- 本地页面热更新后不再出现“预约时间缺少中文名称”的启动错误;未登录浏览器被重定向到登录页,因此未代替用户登录验证受保护详情数据。
|
||||
|
||||
## 风险评估
|
||||
|
||||
- 详情接口新增只读展示字段,原有字段和接口路径保持兼容。
|
||||
- 关系名称严格从工单已保存主键读取,不用当前服务关系推断或覆盖历史归属。
|
||||
- 历史工单未保存关系主键时仍保持空值,仅以明确文案说明当前状态。
|
||||
@@ -64,6 +64,7 @@ platforms/
|
||||
- 工作人员资质按来源角色校验;订单分配只加载配送人员。
|
||||
- 工作人员和用户头像使用 5173 同款账户摘要、选择预览和保存流程,并通过气站数据范围内的受控接口读取;`file_uri` 仍保持普通字段。
|
||||
- 支付与退款资源使用后端真实名称 `payment_order`、`payment_refund`。
|
||||
- 客服工单详情完整沿用 5173 的字段结构和顺序,包含预约时间,并为未分配、未预约、未开始、未完成等情况提供业务空状态;关系名称按工单已保存主键解析,不回填历史数据。
|
||||
|
||||
### 4.4 只读详情接口
|
||||
|
||||
@@ -77,6 +78,7 @@ platforms/
|
||||
- 同步气站资源契约和独立页面覆盖检查。
|
||||
- 为工作人员与用户补充受气站范围保护的头像读取接口,并避免普通资料编辑误清空头像。
|
||||
- 客服工单分类和优先级改用中文下拉,优先级默认普通,并由气站接口校验统一枚举。
|
||||
- 客服工单详情字段、关系名称和空状态与 5173 对齐;辅助处理字段保持详情专用,不扩展新建和编辑表单。
|
||||
- 未修改数据库模型、状态机、金额规则或现有写接口。
|
||||
|
||||
## 6. 维护指南
|
||||
|
||||
Reference in New Issue
Block a user