docs(M08-C): 回填管理员房态运营首段

2026-08-10 10:08:26 +08:00
parent b70ada06a8
commit 8b2156cdd5
7 changed files with 53 additions and 6 deletions
@@ -0,0 +1,9 @@
+# 2026-08-10 M08-C 管理员/员工小程序 API
+
+| 方法 | 路径 | 权限 | 结果 |
+|---|---|---|---|
+| GET | `/app-api/management/stores` | `store.operation.read/write`、`tenant.manage` 或平台管理员 | 返回当前账号授权范围内门店。 |
+| GET | `/app-api/management/stores/:storeId/rooms` | 读权限且门店在授权范围 | 返回包含停用房间在内的完整配置/运营房态。 |
+| PATCH | `/app-api/management/rooms/:id/status` | 写权限且门店在授权范围 | 调整配置状态或运营状态并写审计；STAFF 只读账号返回 403。 |
+
+房态请求体必须包含 `storeId`、非空 `reason`，并至少包含 `configurationStatus` 或 `operationalStatus` 之一。接口继续使用统一 Bearer 会话与服务端门店范围，不信任前端隐藏按钮。