支付通路

yelaymaths_api/prisma/schema.prisma

@@ -241,6 +241,15 @@ model Order {
   status       Int       @db.TinyInt
   /// 固定 0（正式环境）
   env          Int       @default(0) @db.TinyInt
+  /// 下单设备，由小程序上报 wx.getDeviceInfo().platform：ios / android / windows / devtools...
+  /// 平台按设备路由支付渠道（iOS 走 Apple 支付），所以它决定这笔单能不能主动退款
+  terminal     String?   @db.VarChar(16)
+  /// 管理员已同意退款的时间。iOS 用户申请退款时苹果会发问询，看到这一列非空就直接放过。
+  /// 这是「事前授权」：必须在下一次问询到达前标记，标记之后用户再去 App Store 申请才有效。
+  refund_consent_at DateTime? @map("refund_consent_at")
+  /// 已向微信发起退款的时间。退款是异步的——微信退完才推 xpay_refund_notify 回写「已退款」，
+  /// 中间这段时间靠它显示「退款中」，避免重复点退款。
+  refund_requested_at DateTime? @map("refund_requested_at")
   /// 微信平台单号，发货幂等依据
   wx_order_id  String?   @unique @map("wx_order_id") @db.VarChar(64)
   /// 下单时透传字段，发货通知原样带回
@@ -253,11 +262,44 @@ model Order {
   user   User   @relation(fields: [user_id], references: [id])
   course Course @relation(fields: [course_id], references: [id])
 
+  refund_requests RefundRequest[]
+
   @@index([user_id, created_at])
   @@index([status, created_at])
   @@map("orders")
 }
 
+/// 退款申请。
+///
+/// Apple 支付不允许开发者主动退款，用户得去 App Store 申请；申请后 Apple 会向我们发
+/// 退款问询（xpay_subscribe_ios_refund_query_notify），必须 3 秒内表态，所以决策是自动的。
+/// 这张表把每次问询和我们的答复记下来，供后台查看。
+/// 微信支付渠道（安卓等）没有用户申请入口，所以这里基本只有 iOS 会产生记录。
+model RefundRequest {
+  id             Int      @id @default(autoincrement()) @db.UnsignedInt
+  /// 问询里的支付订单号。平台会重复问询，用它做幂等
+  pay_order_id   String   @unique @map("pay_order_id") @db.VarChar(64)
+  /// 匹配到的本地订单；查不到时为空
+  order_id       Int?     @map("order_id") @db.UnsignedInt
+  /// 用户申请退款的原因
+  reason         String?  @db.VarChar(255)
+  /// 推送里的发货状态：0 未发货 / 1 已发货 / 2 发货中
+  provide_status String?  @map("provide_status") @db.VarChar(4)
+  /// 我们的答复：0 建议退款 / 1 拒绝退款
+  our_result     Int      @map("our_result") @db.TinyInt
+  /// 答复依据，写给人看
+  our_evidence   String?  @map("our_evidence") @db.VarChar(255)
+  /// 平台重复问询的次数
+  query_count    Int      @default(1) @map("query_count") @db.UnsignedInt
+  created_at     DateTime @default(now()) @map("created_at")
+  updated_at     DateTime @updatedAt @map("updated_at")
+
+  order Order? @relation(fields: [order_id], references: [id])
+
+  @@index([created_at])
+  @@map("refund_requests")
+}
+
 /// 发货推送原始记录，用于幂等、重放与排查
 model PaymentNotifyLog {
   id           Int      @id @default(autoincrement()) @db.UnsignedInt
@@ -306,4 +348,3 @@ model AdminUser {
 
   @@map("admin_users")
 }
-