docs(M08-B): 记录保洁端基础流程进度

2026-06-25 23:22:03 +08:00
parent 2a4dcd0fd8
commit f7e0c8d063
7 changed files with 105 additions and 13 deletions
@@ -0,0 +1,36 @@
+# 2026-06-25 M08-B 保洁端 API
+
+## App API
+
+- `GET /app-api/cleaning/tasks/hall`
+  - 登录：必需。
+  - 权限：`cleaning.task.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
+  - 查询：`page`、`pageSize`、`status`；默认查询 `WAITING`。
+  - 说明：按保洁员门店范围返回任务大厅。
+
+- `GET /app-api/cleaning/tasks/mine`
+  - 登录：必需。
+  - 权限：`cleaning.task.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
+  - 查询：`page`、`pageSize`、`status`。
+  - 说明：返回当前保洁员已领取任务。
+
+- `POST /app-api/cleaning/tasks/:taskId/claim`
+  - 登录：必需。
+  - 权限：`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
+  - 说明：仅 `WAITING` 且未被领取的任务可接单。
+
+- `POST /app-api/cleaning/tasks/:taskId/start`
+  - 登录：必需。
+  - 权限：`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
+  - 说明：当前保洁员已领取的 `CLAIMED` 任务可开始。
+
+- `POST /app-api/cleaning/tasks/:taskId/submit`
+  - 登录：必需。
+  - 权限：`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`。
+  - Body：`photoUrls: string[]`，`note?: string`。
+  - 说明：当前保洁员进行中的 `STARTED` 任务可提交验收。
+
+- `GET /app-api/cleaning/stats`
+  - 登录：必需。
+  - 权限：`cleaning.task.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
+  - 说明：返回当前保洁员任务状态计数和待结算金额。