docs: update aftersales README for new serial and labels
This commit is contained in:
@@ -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,` 前缀,解码后 200B–500KB
|
- 签名校验:必须为 `data:image/png;base64,` 或 `data:image/jpeg;base64,` 前缀,解码后 200B–500KB
|
||||||
@@ -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/**: 集成测试(健康检查、登录流程)
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user