From 97710f43d97a5bb2d790e4d5dafea2bacfeb7b80 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 00:06:45 +0800
Subject: [PATCH] dashboard: recent platform orders show no-receipt hint and
 fix link

---
 resources/views/admin/dashboard.blade.php     | 16 ++++-
 ...sPaidButNoReceiptShouldShowFixLinkTest.php | 64 +++++++++++++++++++
 2 files changed, 79 insertions(+), 1 deletion(-)
 create mode 100644 tests/Feature/AdminDashboardRecentPlatformOrdersPaidButNoReceiptShouldShowFixLinkTest.php

diff --git a/resources/views/admin/dashboard.blade.php b/resources/views/admin/dashboard.blade.php
index d09e5d6..e71a836 100644
--- a/resources/views/admin/dashboard.blade.php
+++ b/resources/views/admin/dashboard.blade.php
@@ -229,11 +229,25 @@
                 @php
                     $poShowUrl = \App\Support\BackUrl::withBack('/admin/platform-orders/' . $po->id, $selfWithoutBack);
                 @endphp
+                @php
+                    $hasReceiptEvidence = (data_get($po->meta, 'payment_summary.total_amount') !== null)
+                        || (data_get($po->meta, 'payment_receipts.0.amount') !== null);
+                    $fixReceiptUrl = \App\Support\BackUrl::withBackAndFragment('/admin/platform-orders/' . $po->id, $selfWithoutBack, 'add-payment-receipt');
+                @endphp
                 <tr>
                     <td><a class="link" href="{!! $poShowUrl !!}">{{ $po->order_no }}</a></td>
                     <td>{{ $po->orderTypeLabel() }}</td>
                     <td>¥{{ number_format((float) $po->payable_amount, 2) }}</td>
-                    <td>{{ $po->payment_status }}</td>
+                    <td>
+                        {{ $po->payment_status }}
+                        @if((string) $po->payment_status === 'paid' && ! $hasReceiptEvidence)
+                            <div class="muted text-danger muted-xs row-warn">
+                                <span class="row-warn-prefix">无回执</span>
+                                <span class="muted">｜</span>
+                                <a class="link" href="{!! $fixReceiptUrl !!}">去补回执</a>
+                            </div>
+                        @endif
+                    </td>
                     <td>{{ $po->status }}</td>
                 </tr>
             @empty
diff --git a/tests/Feature/AdminDashboardRecentPlatformOrdersPaidButNoReceiptShouldShowFixLinkTest.php b/tests/Feature/AdminDashboardRecentPlatformOrdersPaidButNoReceiptShouldShowFixLinkTest.php
new file mode 100644
index 0000000..662d45e
--- /dev/null
+++ b/tests/Feature/AdminDashboardRecentPlatformOrdersPaidButNoReceiptShouldShowFixLinkTest.php
@@ -0,0 +1,64 @@
+<?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 AdminDashboardRecentPlatformOrdersPaidButNoReceiptShouldShowFixLinkTest 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_paid_but_no_receipt_should_show_fix_link(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchantId = (int) Merchant::query()->value('id');
+        $platformAdminId = (int) Admin::query()->where('email', 'platform.admin@demo.local')->value('id');
+
+        // 确保“最近平台订单”卡里有一条已支付但无回执证据的订单
+        $order = PlatformOrder::query()->create([
+            'merchant_id' => $merchantId,
+            'plan_id' => null,
+            'site_subscription_id' => null,
+            'created_by_admin_id' => $platformAdminId ?: null,
+            'order_no' => 'PO_DASH_NO_RECEIPT_0001',
+            'order_type' => 'new_purchase',
+            'status' => 'pending',
+            'payment_status' => 'paid',
+            'payable_amount' => 9,
+            'paid_amount' => 9,
+            // 关键：无 payment_summary / payment_receipts
+            'meta' => [],
+        ]);
+
+        $res = $this->get('/admin');
+        $res->assertOk();
+
+        // 仪表盘应展示“无回执”提示，并给出“去补回执”入口（锚点 add-payment-receipt）
+        $res->assertSee('PO_DASH_NO_RECEIPT_0001');
+        $res->assertSee('无回执', false);
+        $res->assertSee('去补回执', false);
+
+        $fixUrl = '/admin/platform-orders/' . $order->id . '?' . Arr::query([
+            'back' => '/admin',
+        ]) . '#add-payment-receipt';
+
+        $res->assertSee($fixUrl, false);
+        $res->assertDontSee('&amp;back=', false);
+    }
+}