From 053dd40e3a047a5bd6f9868e8d2093d4230e58fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=90=9D=E5=8D=9C?= <dev@saasshop.local>
Date: Wed, 18 Mar 2026 06:21:40 +0800
Subject: [PATCH] Dashboard scanline: reconcile consistent links to payment
 receipts panel

---
 resources/views/admin/dashboard.blade.php     |  2 +
 ...ntShouldLinkToPaymentReceiptsPanelTest.php | 76 +++++++++++++++++++
 2 files changed, 78 insertions(+)
 create mode 100644 tests/Feature/AdminDashboardRecentPlatformOrdersScanlineReconcileConsistentShouldLinkToPaymentReceiptsPanelTest.php

diff --git a/resources/views/admin/dashboard.blade.php b/resources/views/admin/dashboard.blade.php
index cca53b6..1915d9f 100644
--- a/resources/views/admin/dashboard.blade.php
+++ b/resources/views/admin/dashboard.blade.php
@@ -962,6 +962,8 @@
                                 对账：
                                 @if($reconcileStatusText !== '-' && $reconcileStatusText !== '一致')
                                     <a class="link" href="{!! $scanGoReconcileUrl !!}"><strong>{{ $reconcileStatusText }}</strong></a>
+                                @elseif($reconcileStatusText === '一致')
+                                    <a class="link" href="{!! $scanGoPaymentReceiptsUrl !!}"><strong>{{ $reconcileStatusText }}</strong></a>
                                 @else
                                     <strong>{{ $reconcileStatusText }}</strong>
                                 @endif
diff --git a/tests/Feature/AdminDashboardRecentPlatformOrdersScanlineReconcileConsistentShouldLinkToPaymentReceiptsPanelTest.php b/tests/Feature/AdminDashboardRecentPlatformOrdersScanlineReconcileConsistentShouldLinkToPaymentReceiptsPanelTest.php
new file mode 100644
index 0000000..ec4ddf4
--- /dev/null
+++ b/tests/Feature/AdminDashboardRecentPlatformOrdersScanlineReconcileConsistentShouldLinkToPaymentReceiptsPanelTest.php
@@ -0,0 +1,76 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Admin;
+use App\Models\Merchant;
+use App\Models\Plan;
+use App\Models\PlatformOrder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminDashboardRecentPlatformOrdersScanlineReconcileConsistentShouldLinkToPaymentReceiptsPanelTest 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_scanline_reconcile_consistent_should_link_to_payment_receipts_panel(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        // 清理 seed 订单，避免最近订单列表被 seed 污染导致断言不稳定。
+        PlatformOrder::query()->delete();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $platformAdminId = (int) Admin::query()->where('email', 'platform.admin@demo.local')->value('id');
+
+        $plan = Plan::query()->create([
+            'code' => 'dash_recent_order_scanline_reconcile_consistent_plan',
+            '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,
+            'site_subscription_id' => null,
+            'created_by_admin_id' => $platformAdminId ?: null,
+            'order_no' => 'PO_DASH_SCANLINE_RECONCILE_OK_0001',
+            'order_type' => 'new_purchase',
+            'status' => 'pending',
+            'payment_status' => 'paid',
+            'payable_amount' => 10,
+            'paid_amount' => 10,
+            'placed_at' => now(),
+            'paid_at' => now(),
+            'meta' => [
+                // 有回执证据，且对账一致：receipt total == paid
+                'payment_summary' => ['total_amount' => 10],
+            ],
+        ]);
+
+        $res = $this->get('/admin');
+        $res->assertOk();
+
+        $res->assertSee('PO_DASH_SCANLINE_RECONCILE_OK_0001');
+
+        // 对账：一致 应可直达订单详情的支付回执区（#payment-receipts），用于 spot-check。
+        $res->assertSee('对账：', false);
+        $res->assertSee('<strong>一致</strong>', false);
+        $res->assertSee('#payment-receipts', false);
+    }
+}