docs: update aftersales README for new serial and labels

This commit is contained in:
Frudrax Cheng
2026-05-28 09:15:35 +08:00
parent da02be0a4f
commit 539eae3bdc
+6 -5
View File
@@ -310,13 +310,14 @@ swag init -g main.go
| PATCH | `/api/aftersales/:serialNumber` | 更新工单(仅负责人或管理员)| 是 | 管理员/技术员 | | PATCH | `/api/aftersales/:serialNumber` | 更新工单(仅负责人或管理员)| 是 | 管理员/技术员 |
| POST | `/api/aftersales/:serialNumber/qrcode` | 生成工单二维码 | 是 | 管理员/技术员 | | POST | `/api/aftersales/:serialNumber/qrcode` | 生成工单二维码 | 是 | 管理员/技术员 |
| POST | `/api/aftersales/:serialNumber/submit` | 提交客户确认 | 是 | 管理员/技术员 | | POST | `/api/aftersales/:serialNumber/submit` | 提交客户确认 | 是 | 管理员/技术员 |
| POST | `/api/aftersales/:serialNumber/reassign` | 重新分配技术员 | 是 | 管理员 | | POST | `/api/aftersales/:serialNumber/reassign` | 工单分配(重新分配技术员 | 是 | 管理员 |
| POST | `/api/aftersales/:serialNumber/force-close` | 强制关闭工单 | 是 | 管理员 | | POST | `/api/aftersales/:serialNumber/force-close` | 强制关闭工单 | 是 | 管理员 |
| DELETE | `/api/aftersales/:serialNumber` | 删除工单 | 是 | 管理员 | | DELETE | `/api/aftersales/:serialNumber` | 删除工单 | 是 | 管理员 |
**售后工单特点**: **售后工单特点**:
- 工单号格式: `zjbf-sh-YYMMNN`(年份后 2 位 + 月份 2 位 + 当月序号至少 2 位,例:`zjbf-sh-260501` - 服务类型枚举:`software`(软件故障)、`hardware`(硬件故障)、`maintenance`(售后维保
- 序号按月重置,软删除工单不释放编号(避免回收造成混淆 - 工单号格式: `zjbf-sh-YYMMDDNN`(年份后 2 位 + 月份 2 位 + 日期 2 位 + 当天序号至少 2 位,例:`zjbf-sh-26052801`
- 序号按天重置,软删除工单不释放编号(避免回收造成混淆)
- 二维码扫码后客户在网页签名(canvas)后点「已授权」确认;选择「未授权」需填写退回原因 - 二维码扫码后客户在网页签名(canvas)后点「已授权」确认;选择「未授权」需填写退回原因
- 签名以 PNG dataURL 形式持久化到工单(`signature` 字段),管理员详情页可查看留底 - 签名以 PNG dataURL 形式持久化到工单(`signature` 字段),管理员详情页可查看留底
- 签名校验:必须为 `data:image/png;base64,``data:image/jpeg;base64,` 前缀,解码后 200B500KB - 签名校验:必须为 `data:image/png;base64,``data:image/jpeg;base64,` 前缀,解码后 200B500KB
@@ -336,7 +337,7 @@ swag init -g main.go
| DELETE | `/api/users/:id` | 删除用户 | 是 | 管理员 | | DELETE | `/api/users/:id` | 删除用户 | 是 | 管理员 |
**用户角色**: **用户角色**:
- `admin`:完整权限,包括用户管理、强制关闭工单、重新分配技术员、删除工单 - `admin`:完整权限,包括用户管理、强制关闭工单、工单分配(重新分配技术员、删除工单
- `technician`:可创建/编辑自己负责的售后工单,可使用 `assignable` 查询同事 - `technician`:可创建/编辑自己负责的售后工单,可使用 `assignable` 查询同事
- `user`:保留角色(暂未实际启用) - `user`:保留角色(暂未实际启用)
@@ -374,7 +375,7 @@ go tool cover -html=coverage.out
- 序列号管理测试(生成、查询、更新、吊销、分页列表) - 序列号管理测试(生成、查询、更新、吊销、分页列表)
- 员工赋码测试(生成、查询、更新、吊销、二维码生成) - 员工赋码测试(生成、查询、更新、吊销、二维码生成)
- 企业统计测试(统计概览) - 企业统计测试(统计概览)
- 售后工单测试(YYMMNN 序号生成、状态机、客户确认手机号校验、强制关闭) - 售后工单测试(YYMMDDNN 序号生成、状态机、客户确认手机号校验、强制关闭)
- 用户管理测试(重复用户名、自降级保护、最后管理员保护、密码重置) - 用户管理测试(重复用户名、自降级保护、最后管理员保护、密码重置)
- **tests/**: 集成测试(健康检查、登录流程) - **tests/**: 集成测试(健康检查、登录流程)