Codex
32 lines
2.5 KiB
Markdown
32 lines
2.5 KiB
Markdown
# 2026-08-10 M08-D 后台运营总览 API
|
|
|
|
| 方法 | 路径 | 权限 | 结果 |
|
|
|---|---|---|---|
|
|
| GET | `/admin-api/statistics` | `store.operation.read` 且门店在授权范围，或租户/平台管理权限 | 与小程序管理端共享同一统计仓储，返回最长 93 天的订单、成功实收、会员、房态、支付渠道、每日收入和验券汇总。 |
|
|
| GET | `/admin-api/stores` | 既有门店读权限与数据范围 | 运营总览只展示当前账号有权查看的门店，用于统计门店选择。 |
|
|
|
|
后台 API 基地址仍固定为 `/admin-api`。新增别名不复制统计逻辑，不降低鉴权；实收只累计 `SUCCEEDED` 支付，房态为查询时快照，订单和验券按各自创建时间口径。
|
|
|
|
## 门店与房间管理增量
|
|
|
|
| 方法 | 路径 | 变更 |
|
|
|---|---|---|
|
|
| GET | `/admin-api/stores` | 增加 `businessHours`、`wifiConfigured`、经纬度、联系电话、Wi-Fi SSID、通知地址和排序；不返回 Wi-Fi 密码。 |
|
|
| POST/PUT | `/admin-api/stores[/:id]` | `wifiPassword` 改为可省略；创建时省略写入空值，更新时省略使用 `COALESCE` 保持原密码。 |
|
|
| GET/POST/PUT/PATCH/DELETE | `/admin-api/stores/:storeId/rooms`、`/admin-api/rooms/**` | Vue 后台接入既有房间列表、创建、编辑、状态、停用时段和归档接口，权限契约不变。 |
|
|
|
|
## 订单运营增量
|
|
|
|
| 方法 | 路径 | 变更 |
|
|
|---|---|---|
|
|
| GET | `/admin-api/orders` | 新增后台别名，支持 `page`、`pageSize`、`status`、`storeId`，复用订单仓储的租户和授权门店范围。 |
|
|
| GET | `/admin-api/orders/:orderId` | 新增后台详情别名，返回服务端金额、时段、门店/房间和最近支付摘要。 |
|
|
| GET | `/admin-api/orders/:orderId/history` | 新增后台状态流水别名，复用经理数据范围校验。 |
|
|
| POST | `/admin-api/orders/:orderId/actions|note|adjust-time|renew|change-room` | Vue 后台接入既有受控写接口；服务端继续校验状态机、金额、时段冲突、权限和幂等。 |
|
|
|
|
## 资金运营增量
|
|
|
|
- 无新后端路由；Vue 后台接入既有 `/admin-api/pay/refund`、`/pay/reconciliation`、`/pay/collection-account`、`/pay/profit-share-receiver`、`/pay/profit-share-policy` 和 `/pay/profit-shares`。
|
|
- 收款账户与接收方凭据只提交环境引用；列表继续只返回商户号、脱敏标识和授权状态，不返回私钥或真实接收方账户。
|
|
- 客户端生成一次性幂等键，但退款金额、可退余额、分账比例、授权与生产 Mock 门禁继续完全由服务端判定。
|