订单与支付

创建会员购买订单。价格由服务端硬编码，与第 08 章 plans 一致：包月 49 / 包季 139 / 包年 299 元。

{
  "orderNo": "MO1757133600000",      // "MO" + System.currentTimeMillis()
  "userId": 1,
  "type": "MONTHLY",                 // 枚举名字符串
  "months": 1,                        // MONTHLY→1 / QUARTERLY→3 / YEARLY→12
  "amount": 49.00,                    // BigDecimal；49 / 139 / 299
  "currency": "CNY",
  "periodQuota": 5000,               // monthlyQuota × months
  "createdAt": "2026-09-06T10:00:00",
  "expiresAt": "2026-09-06T10:30:00"  // createdAt + 30 分钟
}

创建成功后立即投递 RocketMQ 延迟消息（orderCancelProducer.sendCancel，延迟级别 16 = 30 分钟）； 消息投递失败仅记日志不阻断下单（兜底：查询接口侧同样有过期转 CANCELLED 逻辑）。

按订单号查询订单详情（收银台展示用）。订单不存在抛 IllegalArgumentException("订单不存在") → HTTP 400。

{
  "orderNo": "MO1757133600000",
  "userId": 1, "accountId": "1",
  "accountName": "小明",              // 用户昵称，昵称为空时取用户名
  "type": "MONTHLY", "months": 1,
  "amount": 49.00, "currency": "CNY",
  "status": "PENDING",               // PENDING / PAID / CANCELLED / REFUNDED
  "periodQuota": 5000,
  "paidAt": null, "startAt": null, "endAt": null,
  "createdAt": "2026-09-06T10:00:00",
  "expiresAt": "2026-09-06T10:30:00"
}

查询当前登录用户的全部订单，按创建时间倒序。请求无参数，用户身份取自 UserContext。

{
  "data": [
    { "orderNo": "MO1757133600000", "userId": "1",
      "type": "MONTHLY", "months": 1,
      "amount": 49.00, "currency": "CNY",
      "status": "PAID", "paidAt": "2026-09-06T10:02:11",
      "createdAt": "2026-09-06T10:00:00",
      "expiresAt": "2026-09-06T10:30:00" }
  ]
}

直接支付（模拟渠道）：校验订单可支付后立即生成 SUCCESS 支付记录并发放权益。适合集成方自建收银台、无真实渠道对接的场景。

ensureOrderPayableOrThrow(order)          // 非 PENDING→409；已过期→转 CANCELLED→409
paymentNo = "PR" + System.currentTimeMillis()
创建 PaymentRecord(status=SUCCESS, transactionNo="TXN-"+UUID)
finalizeSuccessPayment(...)               // 订单 PAID + 权益发放

扫码预下单：创建 INITIATED 状态的支付记录后，向支付渠道请求二维码链接。整体为事务拆分设计——落库与渠道 HTTP 调用分离，避免长时间占用数据库连接（HikariCP）。

字段与 PayRequest 完全一致：orderNo / provider / method。

// 第一段事务：校验 + 落 INITIATED 支付记录
preparePrepayRecord(order, provider, method)
// 第二段（事务外）：调用渠道预下单
channelRegistry.get(provider).prepayQr(order, method, paymentNo)
  → 成功：记录 mockMode 标记
  → 异常：markPrepayFailed(record, message)（支付记录置 FAILED，向上抛错）

{
  "orderNo": "MO1757133600000",
  "paymentNo": "PR1757133610000",
  "codeUrl": "https://qr.alipay.com/...",   // 二维码内容，前端渲染成二维码
  "expiresAt": "2026-09-06T10:30:00",        // min(订单过期时间, 渠道二维码过期时间)
  "provider": "支付宝",
  "method": "支付宝二维码"
}

支付结果确认（扫码场景轮询用）。幂等：已成功的支付记录直接返回成功响应，不重复发权益。

{ "paymentNo": "PR1757133610000" }。记录不存在抛 IllegalArgumentException("支付记录不存在") → HTTP 400。

record.status == SUCCESS   → 幂等返回（不再查单、不再发权益）
record.mockMode == true    → 模拟渠道确认：直接置 SUCCESS + 发权益
record 真实渠道            → 查单分流：
    provider == ALIPAY → alipayChannelService.queryTrade(paymentNo)
                         （pay.alipay.enabled=false 时渠道服务为 null，仅返回当前状态）
    其他 provider      → 暂不支持查单，仅返回当前状态
查单未成功               → 返回当前（待支付）响应，客户端继续轮询

查单确认成功同样走 markSuccessAndFinalize：置 SUCCESS + transactionNo + paidAt， PaymentRecord 带 @Version 乐观锁——并发确认时后写方更新行数为 0， 直接判定为「已被并发请求收尾」，幂等跳过。

支付宝服务器异步回调入口。响应不经过统一包装——方法签名为 void notify(HttpServletRequest, HttpServletResponse)，直接向响应流写出支付宝要求的 success / failure 文本。

支付记录状态 INITIATED → 记录 notifyPayload → markSuccessAndFinalize → 写 success
支付记录状态 SUCCESS   → 幂等跳过（重复通知）                    → 写 success
其他状态（FAILED 等）  → 记 warn 日志，不处理                    → 不写 success（支付宝会重试）

正常链路 PENDING → PAID；30 分钟超时 PENDING → CANCELLED。

// 终态保护：订单已 CANCELLED / REFUNDED 时仅告警、跳过发放（不复活已取消订单）
firstPayment = (paymentCount == 0)
order.status = PAID；paidAt = now；paymentCount += 1
order.startAt = now；endAt = now.plusMonths(months)
membershipService.subscribe(userId, type)             // 开通会员 + 周期配额
if (firstPayment && bonusPoints > 0) {
    pointsService.add(userId, bonus, ...)             // 仅首笔支付赠点，失败仅告警
}

💡 渠道注册表 PaymentChannelRegistry 按 provider 分发到对应渠道实现； 当前内置支付宝渠道（受 pay.alipay.enabled 开关控制），其余渠道在 Mock 模式下可用。