docs(M08-C): 回填保洁与设备运营

This commit is contained in:
Codex
2026-08-10 10:53:26 +08:00
parent 65932a8000
commit 3bfccb8513
7 changed files with 55 additions and 8 deletions
@@ -28,3 +28,15 @@
| GET | `/app-api/management/staff` | `user.read`,并叠加租户与授权门店范围 | 强制仅查询 `userType=STAFF`,返回角色、门店范围、状态、备注及脱敏手机号/最近登录 IP。 |
管理员代下单页改为调用会员检索接口选择目标会员,不再要求手工输入全局用户 ID。列表分页参数继续由服务端夹取为安全整数;MySQL 查询不再绑定 `LIMIT/OFFSET` 占位符,以兼容当前 MySQL 8.4 驱动组合。
## 保洁与设备运营增量
| 方法 | 路径 | 权限 | 结果 |
|---|---|---|---|
| GET | `/app-api/management/cleaning/tasks` | `cleaning.task.read`,并叠加租户与授权门店范围 | 按门店、状态和保洁员查询任务。 |
| GET | `/app-api/management/cleaning/statistics` | 同上 | 返回任务汇总、状态、门店、结算、人员和趋势统计。 |
| POST | `/app-api/management/cleaning/tasks/:taskId/complete``reject``exempt` | `cleaning.task.write`,任务门店在授权范围 | 复用既有验收、驳回补做和免清洁状态机/事件记录。 |
| GET | `/app-api/management/devices``device-topology` | `device.read`,并叠加租户与授权门店范围 | 返回设备在线状态、信号、固件、能力、最近心跳、告警、维护和绑定拓扑。 |
| POST | `/app-api/management/device-control/*` | `device.write`,设备门店在授权范围 | 复用既有控制箱、Sub-1G 和智能插座命令服务;小程序当前接入临时开门、全屋电控和插座开关。 |
管理端设备写操作在命令创建前写入 `DEVICE_COMMAND_REQUESTED` 审计,记录实际账号类型/ID、traceId、门店、房间、设备、命令类型和可选订单;设备离线、未绑定或跨店仍由服务端拒绝。