docs(M08-C): 回填保洁与设备运营
This commit is contained in:
@@ -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、门店、房间、设备、命令类型和可选订单;设备离线、未绑定或跨店仍由服务端拒绝。
|
||||
|
||||
Reference in New Issue
Block a user