feat(platform-orders): 列表/导出退款统计优先读 refund_summary（含测试）

app/Http/Controllers/Admin/PlatformOrderController.php

@@ -682,8 +682,9 @@ class PlatformOrderController extends Controller
                     $latestReceipt = $receiptCount > 0 ? end($receipts) : null;
 
                     $refunds = (array) (data_get($order->meta, 'refund_receipts', []) ?? []);
-                    $refundCount = count($refunds);
+                    $refundSummaryCount = data_get($order->meta, 'refund_summary.count');
-                    $latestRefund = $refundCount > 0 ? end($refunds) : null;
+                    $refundCount = $refundSummaryCount !== null ? (int) $refundSummaryCount : count($refunds);
+                    $latestRefund = count($refunds) > 0 ? end($refunds) : null;
 
                     $row = [
                         $order->id,
@@ -715,7 +716,12 @@ class PlatformOrderController extends Controller
                         (string) (data_get($latestRefund, 'refunded_at') ?? ''),
                         (float) (data_get($latestRefund, 'amount') ?? 0),
                         (string) (data_get($latestRefund, 'channel') ?? ''),
-                        (function () use ($refunds) {
+                        (function () use ($order, $refunds) {
+                            $summaryTotal = data_get($order->meta, 'refund_summary.total_amount');
+                            if ($summaryTotal !== null) {
+                                return (float) $summaryTotal;
+                            }
+
                             $total = 0.0;
                             foreach ($refunds as $r) {
                                 $total += (float) (data_get($r, 'amount') ?? 0);

resources/views/admin/platform_orders/index.blade.php

@@ -585,7 +585,8 @@
                 <td>
                     @php
                         $refunds = (array) (data_get($order->meta, 'refund_receipts', []) ?? []);
-                        $refundCount = count($refunds);
+                        $refundSummaryCount = data_get($order->meta, 'refund_summary.count');
+                        $refundCount = $refundSummaryCount !== null ? (int) $refundSummaryCount : count($refunds);
                     @endphp
                     @if($refundCount > 0)
                         <a href="/admin/platform-orders/{{ $order->id }}" class="muted">{{ $refundCount }}</a>
@@ -595,9 +596,14 @@
                 </td>
                 <td>
                     @php
-                        $refundTotal = 0.0;
+                        $refundSummaryTotal = data_get($order->meta, 'refund_summary.total_amount');
-                        foreach ($refunds as $r) {
+                        if ($refundSummaryTotal !== null) {
-                            $refundTotal += (float) (data_get($r, 'amount') ?? 0);
+                            $refundTotal = (float) $refundSummaryTotal;
+                        } else {
+                            $refundTotal = 0.0;
+                            foreach ($refunds as $r) {
+                                $refundTotal += (float) (data_get($r, 'amount') ?? 0);
+                            }
                         }
                     @endphp
                     @if($refundTotal > 0)

tests/Feature/AdminPlatformOrderRefundSummaryRowColumnsTest.php

@@ -0,0 +1,72 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Merchant;
+use App\Models\Plan;
+use App\Models\PlatformOrder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminPlatformOrderRefundSummaryRowColumnsTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function loginAsPlatformAdmin(): void
+    {
+        $this->seed();
+
+        $this->post('/admin/login', [
+            'email' => 'platform.admin@demo.local',
+            'password' => 'Platform@123456',
+        ])->assertRedirect('/admin');
+    }
+
+    public function test_platform_orders_row_refund_count_and_total_prefer_refund_summary(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'refund_row_summary_test',
+            'name' => '退款行级摘要测试套餐',
+            'billing_cycle' => 'monthly',
+            'price' => 10,
+            'list_price' => 10,
+            'status' => 'active',
+            'sort' => 10,
+            'published_at' => now(),
+        ]);
+
+        PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'order_no' => 'PO_REFUND_ROW_SUMMARY_0001',
+            'order_type' => 'new_purchase',
+            'status' => 'activated',
+            'payment_status' => 'partially_refunded',
+            'plan_name' => $plan->name,
+            'billing_cycle' => $plan->billing_cycle,
+            'period_months' => 1,
+            'quantity' => 1,
+            'payable_amount' => 10,
+            'paid_amount' => 10,
+            'placed_at' => now(),
+            'paid_at' => now(),
+            'activated_at' => now(),
+            'meta' => [
+                // 故意不给 refund_receipts，验证列表能从 refund_summary 读到
+                'refund_summary' => [
+                    'count' => 2,
+                    'total_amount' => 3.50,
+                ],
+            ],
+        ]);
+
+        $this->get('/admin/platform-orders')
+            ->assertOk()
+            ->assertSee('PO_REFUND_ROW_SUMMARY_0001')
+            ->assertSee('2')
+            ->assertSee('¥3.50');
+    }
+}