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

2026-08-10 11:14:06 +08:00
parent ce52f07588
commit b08a2cca43
7 changed files with 66 additions and 15 deletions
@@ -28,3 +28,11 @@
 - 管理员设备命令在既有 `qipai_audit_logs` 写入 `DEVICE_COMMAND_REQUESTED`，actor 记录真实管理员/员工/顾客或系统来源，metadata 记录门店、房间、设备、设备类型、命令类型和可选订单。
 - 审计发生在设备命令创建/发布前；命令最终状态继续以 `qipai_iot_commands` 的 `PUBLISHED/ACKED/FAILED/TIMEOUT` 及设备回包为准，不把“已发布”表述为“设备已执行”。
 - WSL MySQL 8.4.10 已实际验证管理员临时开门的 IoT 命令落库、MQTT Mock 发布和操作人审计归因，并完成 136 up、114 verify、130 down 的完整往返。
+
+## 管理员验券与门店经营统计增量
+
+- 无 schema 迁移，复用 `qipai_group_vouchers`、`qipai_group_redemptions`、`qipai_payments`、`qipai_orders`、`qipai_rooms` 与 `qipai_order_user_access`。
+- 在线与手工管理员验券均只保存券码 SHA-256、掩码、操作人、门店、订单、平台结果和幂等请求号；原始券码不落库、不进入记录查询响应。
+- 验券成功沿用事务内团购支付入账，生成 `GROUP_BUY` 成功支付、更新订单实付与状态、消耗房间预占并写订单状态历史；重复请求或重复券不重复入账。
+- 经营统计按租户和门店参数化查询；实收仅取成功支付的 `paid_at` 区间，订单/会员按订单 `created_at` 区间，验券按核销 `created_at` 区间，房态为当前快照。
+- WSL MySQL 8.4.10 已验证管理员验券操作人/门店归因、券码脱敏、订单与成功支付统计、`GROUP_BUY` 渠道聚合，并完成 136 up、114 verify、130 down 的完整往返。