支付通路

yelaymaths_api/prisma/migrations/20260930120000_add_order_terminal/migration.sql

@@ -0,0 +1,3 @@
+-- 下单设备：由小程序上报 wx.getDeviceInfo().platform。
+-- 用途是判断这笔单的支付渠道（iOS 走 Apple 支付，只能用户自己找 App Store 退）。
+ALTER TABLE `orders` ADD COLUMN `terminal` VARCHAR(16) NULL;

yelaymaths_api/prisma/migrations/20260930130000_add_refund_request/migration.sql

@@ -0,0 +1,19 @@
+-- 退款申请：iOS 用户向 Apple 申请退款后，平台发来的退款问询落库，供后台查看
+CREATE TABLE `refund_requests` (
+    `id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
+    `pay_order_id` VARCHAR(64) NOT NULL,
+    `order_id` INTEGER UNSIGNED NULL,
+    `reason` VARCHAR(255) NULL,
+    `provide_status` VARCHAR(4) NULL,
+    `our_result` TINYINT NOT NULL,
+    `our_evidence` VARCHAR(255) NULL,
+    `query_count` INTEGER UNSIGNED NOT NULL DEFAULT 1,
+    `created_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+    `updated_at` DATETIME(3) NOT NULL,
+
+    UNIQUE INDEX `refund_requests_pay_order_id_key`(`pay_order_id`),
+    INDEX `refund_requests_created_at_idx`(`created_at`),
+    PRIMARY KEY (`id`)
+) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+
+ALTER TABLE `refund_requests` ADD CONSTRAINT `refund_requests_order_id_fkey` FOREIGN KEY (`order_id`) REFERENCES `orders`(`id`) ON DELETE SET NULL ON UPDATE CASCADE;

yelaymaths_api/prisma/migrations/20260930140000_add_order_refund_consent/migration.sql

@@ -0,0 +1,3 @@
+-- 管理员「同意退款」标记。iOS 退款问询时，标了的订单直接放过。
+-- 是事前授权：标记必须发生在苹果下一次问询之前。
+ALTER TABLE `orders` ADD COLUMN `refund_consent_at` DATETIME(3) NULL;

yelaymaths_api/prisma/migrations/20260930150000_add_order_refund_requested/migration.sql

@@ -0,0 +1,3 @@
+-- 已向微信发起退款的时间。退款是异步的，微信退完才推 xpay_refund_notify 回写「已退款」，
+-- 中间靠这一列显示「退款中」，避免管理员重复点退款。
+ALTER TABLE `orders` ADD COLUMN `refund_requested_at` DATETIME(3) NULL;