feat(M08-B): 增加保洁验收和指派管理
This commit is contained in:
@@ -46,3 +46,35 @@
|
||||
- 登录:必需。
|
||||
- 权限:`cleaning.task.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- 说明:返回当前保洁员任务状态计数和待结算金额。
|
||||
|
||||
## Admin API
|
||||
|
||||
- `GET /admin-api/cleaning/tasks`
|
||||
- 登录:必需。
|
||||
- 权限:`cleaning.task.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- 查询:`page`、`pageSize`、`status`。
|
||||
- 说明:按管理员门店范围查询保洁任务。
|
||||
|
||||
- `POST /admin-api/cleaning/tasks/:taskId/assign`
|
||||
- 登录:必需。
|
||||
- 权限:`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- Body:`cleanerUserId: string`,`note?: string`。
|
||||
- 说明:仅可将任务指派给具备 `CLEANER` 角色且拥有该门店范围的有效用户。
|
||||
|
||||
- `POST /admin-api/cleaning/tasks/:taskId/complete`
|
||||
- 登录:必需。
|
||||
- 权限:`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- Body:`note?: string`。
|
||||
- 说明:将 `SUBMITTED` 任务验收为 `COMPLETED`,并进入待结算候选。
|
||||
|
||||
- `POST /admin-api/cleaning/tasks/:taskId/reject`
|
||||
- 登录:必需。
|
||||
- 权限:`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- Body:`reason: string`。
|
||||
- 说明:将 `SUBMITTED` 任务驳回为 `REJECTED`,保洁端可查看原因并补做。
|
||||
|
||||
- `GET /admin-api/cleaning/settlement-candidates`
|
||||
- 登录:必需。
|
||||
- 权限:`cleaning.task.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- 查询:`page`、`pageSize`。
|
||||
- 说明:返回 `COMPLETED` 且 `settled_at IS NULL` 的待结算保洁任务。
|
||||
|
||||
Reference in New Issue
Block a user