feat(M04-C): 完成续费换房与订单调整

2026-06-20 14:05:31 +08:00
parent 4122db45ec
commit 089d34877b
20 changed files with 940 additions and 20 deletions
@@ -0,0 +1,10 @@
+# M04-C 订单调整 API
+
+- `GET /app-api/orders/:orderId/cancellation-quote`：按门店提前取消分钟数和费率返回取消费、可退金额；退款执行留给 M05/M07。
+- `POST /admin-api/orders/:orderId/renew`：按当前价或原锁定单价续费，并重新检查后续时段。
+- `POST /admin-api/orders/:orderId/change-room`：事务内换房并计算基础房价差额。
+- `POST /admin-api/orders/:orderId/adjust-time`：管理员增减订单时间。
+- `POST /admin-api/orders/:orderId/note`：记录管理员备注。
+- `POST /admin-api/orders/reserve-on-behalf`：管理员在门店数据范围内代下单。
+
+所有调整金额均由服务端计算，客户端提交金额字段会被严格拒绝。每个调整使用订单 + traceId 幂等，并记录前后值、原因、操作者和审计日志。
@@ -0,0 +1,9 @@
+# M04-C 订单调整数据库变更
+
+- 迁移版本：`2026062013`
+- 门店新增取消提前量和取消费率配置。
+- 订单新增累计调整金额和管理员备注。
+- 新增 `qipai_order_adjustments`，记录续费、换房、调时和备注的前后值、差额、操作者、来源、原因与 traceId。
+- `(tenant_id, order_id, trace_id)` 唯一约束保证人工调整幂等。
+
+续费、换房和调时均在事务内锁定订单与相关房间，检查禁用时段和重叠预占；失败时订单、预占和金额全部回滚。