panda/qipai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(M08-C): 完成管理员小程序模块

Browse Source
This commit is contained in:
Codex
2026-08-10 11:14:06 +08:00
parent ce52f07588
commit b08a2cca43
7 changed files with 66 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/api-changelog/2026-08-10-M08-C-management.md
+11
View File
@@ -40,3 +40,14 @@
| POST | `/app-api/management/device-control/*` | `device.write`，设备门店在授权范围 | 复用既有控制箱、Sub-1G 和智能插座命令服务；小程序当前接入临时开门、全屋电控和插座开关。 |
管理端设备写操作在命令创建前写入 `DEVICE_COMMAND_REQUESTED` 审计，记录实际账号类型/ID、traceId、门店、房间、设备、命令类型和可选订单；设备离线、未绑定或跨店仍由服务端拒绝。
## 管理员验券与门店经营统计增量
| 方法 | 路径 | 权限 | 结果 |
|---|---|---|---|
| POST | `/app-api/management/group-vouchers/redeem` | `store.operation.write` 且订单门店在授权范围，或租户/平台管理权限 | 对待支付订单执行在线团购验券；应付金额始终由服务端订单推导，支持 `clientRequestId` 幂等。 |
| POST | `/app-api/management/group-vouchers/redeem-manual` | 同上 | 显式人工确认验券；提交金额必须精确等于服务端未付金额，并记录操作人和备注。 |
| GET | `/app-api/management/third-party/records` | 登录管理账号并受租户/授权门店范围约束 | 按 `storeId/provider/status` 查询直订与核销记录，只返回券码掩码、操作人、结果和时间。 |
| GET | `/app-api/management/statistics` | `store.operation.read` 且门店在授权范围，或租户/平台管理权限 | 查询最长 93 天的订单、会员、成功收款渠道、每日收入、当前房态和验券统计。 |
经营统计中的实收金额只累计 `qipai_payments.status=SUCCEEDED` 且 `paid_at` 落在区间内的记录；订单数和预订金额按订单 `created_at` 口径统计，当前房态为查询时快照。小程序提供近 7/30/90 日切换、扫码/手输券码、待支付订单选择与最近脱敏核销记录。