From e9cd69766286f0b7e29b038504304621c9718f5f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=90=9D=E5=8D=9C?= <dev@saasshop.local>
Date: Mon, 16 Mar 2026 14:02:59 +0800
Subject: [PATCH] feat(admin-dashboard): show refund inconsistent hint in
 recent orders

---
 resources/views/admin/dashboard.blade.php     | 10 +++
 ...rsRefundInconsistentShouldShowHintTest.php | 70 +++++++++++++++++++
 2 files changed, 80 insertions(+)
 create mode 100644 tests/Feature/AdminDashboardRecentPlatformOrdersRefundInconsistentShouldShowHintTest.php

diff --git a/resources/views/admin/dashboard.blade.php b/resources/views/admin/dashboard.blade.php
index 1c9aea3..468d3fb 100644
--- a/resources/views/admin/dashboard.blade.php
+++ b/resources/views/admin/dashboard.blade.php
@@ -358,6 +358,16 @@
                                 <a class="link" href="{!! $reconcileMismatchUrl !!}">进入集合</a>
                             </div>
                         @endif
+                        @if($po->isRefundInconsistent())
+                            @php
+                                $refundInconsistentUrl = \App\Support\BackUrl::withBack('/admin/platform-orders?refund_inconsistent=1', $selfWithoutBack);
+                            @endphp
+                            <div class="muted text-danger muted-xs row-warn" data-role="recent-order-refund-inconsistent-hint">
+                                <span class="row-warn-prefix">退款不一致</span>
+                                <span class="muted">｜</span>
+                                <a class="link" href="{!! $refundInconsistentUrl !!}">进入集合</a>
+                            </div>
+                        @endif
                     </td>
                 </tr>
             @empty
diff --git a/tests/Feature/AdminDashboardRecentPlatformOrdersRefundInconsistentShouldShowHintTest.php b/tests/Feature/AdminDashboardRecentPlatformOrdersRefundInconsistentShouldShowHintTest.php
new file mode 100644
index 0000000..4c5bf07
--- /dev/null
+++ b/tests/Feature/AdminDashboardRecentPlatformOrdersRefundInconsistentShouldShowHintTest.php
@@ -0,0 +1,70 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Admin;
+use App\Models\Merchant;
+use App\Models\PlatformOrder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Arr;
+use Tests\TestCase;
+
+class AdminDashboardRecentPlatformOrdersRefundInconsistentShouldShowHintTest 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_dashboard_recent_platform_orders_refund_inconsistent_should_show_hint(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchantId = (int) Merchant::query()->value('id');
+        $platformAdminId = (int) Admin::query()->where('email', 'platform.admin@demo.local')->value('id');
+
+        // 构造一条“已退款但退款总额不足（refund_total + tol < paid）”的订单
+        // tol 默认 0.01，因此 paid=9, refund_total=8 => 必定不一致。
+        $order = PlatformOrder::query()->create([
+            'merchant_id' => $merchantId,
+            'plan_id' => null,
+            'site_subscription_id' => null,
+            'created_by_admin_id' => $platformAdminId ?: null,
+            'order_no' => 'PO_DASH_REFUND_INCONSIST_0001',
+            'order_type' => 'new_purchase',
+            'status' => 'pending',
+            'payment_status' => 'refunded',
+            'payable_amount' => 9,
+            'paid_amount' => 9,
+            'meta' => [
+                'refund_summary' => [
+                    'total_amount' => 8,
+                ],
+            ],
+        ]);
+
+        $this->assertTrue($order->isRefundInconsistent(), '预期测试订单应命中 isRefundInconsistent()');
+
+        $res = $this->get('/admin');
+        $res->assertOk();
+
+        $res->assertSee('PO_DASH_REFUND_INCONSIST_0001');
+        $res->assertSee('退款不一致', false);
+
+        $url = '/admin/platform-orders?' . Arr::query([
+            'refund_inconsistent' => '1',
+            'back' => '/admin',
+        ]);
+        $res->assertSee($url, false);
+
+        // 不应出现 &amp;back=，避免回跳断链
+        $res->assertDontSee('&amp;back=', false);
+    }
+}