docs(M08-B): 记录保洁多人协作进度
This commit is contained in:
@@ -102,3 +102,21 @@
|
||||
- 权限:`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- Body:`note?: string`。
|
||||
- 说明:将 `DRAFT` 结算单确认成 `CONFIRMED`,后续真实支付/发放仍待继续。
|
||||
## 2026-06-26 多保洁员协作增量
|
||||
|
||||
- `GET /admin-api/cleaning/tasks/:taskId/members`
|
||||
- 登录:必须。
|
||||
- 权限:`cleaning.task.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- 说明:返回任务有效保洁成员,包含 `LEAD` 负责人和 `ASSIST` 协作者、成员分账金额与结算时间。
|
||||
- `POST /admin-api/cleaning/tasks/:taskId/members`
|
||||
- 登录:必须。
|
||||
- 权限:`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- Body:`cleanerUserId: string`,`rewardCents: number`,`note?: string`。
|
||||
- 说明:添加或更新协作者分账金额;协作者必须为有效 `CLEANER` 且拥有任务门店范围;协作者金额总和不能超过任务奖励。
|
||||
- `POST /admin-api/cleaning/tasks/:taskId/members/:cleanerUserId/remove`
|
||||
- 登录:必须。
|
||||
- 权限:`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
|
||||
- Body:`note?: string`。
|
||||
- 说明:移除未结算协作者并把剩余奖励回算到负责人;负责人不可通过该接口移除。
|
||||
- `POST /admin-api/cleaning/settlements`
|
||||
- 追加说明:多人协作任务按 `qipai_cleaning_task_members.reward_cents` 分别为每个保洁员生成结算明细;所有有效成员均完成结算后任务才整体转为 `SETTLED`。
|
||||
|
||||
Reference in New Issue
Block a user