From b78b4f0ef2e97068f2e10462b3b628bff0a7501a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=90=9D=E5=8D=9C?= <dev@saasshop.local>
Date: Thu, 19 Mar 2026 00:37:38 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E5=B9=B3=E5=8F=B0=E8=AE=A2?=
 =?UTF-8?q?=E5=8D=95=E5=9B=9E=E6=89=A7=E7=AD=9B=E9=80=89=E6=B2=BB=E7=90=86?=
 =?UTF-8?q?=E6=8F=90=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/platform_orders/index.blade.php     | 13 +++++---
 ...nBroadNoneAndPaidNoReceiptPriorityTest.php | 32 +++++++++++++++++++
 2 files changed, 40 insertions(+), 5 deletions(-)
 create mode 100644 tests/Feature/AdminPlatformOrderFiltersReceiptStatusShouldExplainBroadNoneAndPaidNoReceiptPriorityTest.php

diff --git a/resources/views/admin/platform_orders/index.blade.php b/resources/views/admin/platform_orders/index.blade.php
index a1d4762..75731e4 100644
--- a/resources/views/admin/platform_orders/index.blade.php
+++ b/resources/views/admin/platform_orders/index.blade.php
@@ -415,11 +415,14 @@
             <option value="synced" @selected(($filters['sync_status'] ?? '') === 'synced')>已同步</option>
             <option value="failed" @selected(($filters['sync_status'] ?? '') === 'failed')>同步失败</option>
         </select>
-        <select name="receipt_status">
-            <option value="">全部回执状态</option>
-            <option value="has" @selected(($filters['receipt_status'] ?? '') === 'has')>有回执</option>
-            <option value="none" @selected(($filters['receipt_status'] ?? '') === 'none')>无回执（广义）</option>
-        </select>
+        <div>
+            <select name="receipt_status">
+                <option value="">全部回执状态</option>
+                <option value="has" @selected(($filters['receipt_status'] ?? '') === 'has')>有回执</option>
+                <option value="none" @selected(($filters['receipt_status'] ?? '') === 'none')>无回执（广义）</option>
+            </select>
+            <div class="muted muted-xs mt-6">无回执（广义）会包含未支付订单；收费闭环治理请优先使用“已付无回执”快捷筛选。</div>
+        </div>
         <select name="refund_status">
             <option value="">全部退款状态</option>
             <option value="has" @selected(($filters['refund_status'] ?? '') === 'has')>有退款</option>
diff --git a/tests/Feature/AdminPlatformOrderFiltersReceiptStatusShouldExplainBroadNoneAndPaidNoReceiptPriorityTest.php b/tests/Feature/AdminPlatformOrderFiltersReceiptStatusShouldExplainBroadNoneAndPaidNoReceiptPriorityTest.php
new file mode 100644
index 0000000..b7aecd0
--- /dev/null
+++ b/tests/Feature/AdminPlatformOrderFiltersReceiptStatusShouldExplainBroadNoneAndPaidNoReceiptPriorityTest.php
@@ -0,0 +1,32 @@
+<?php
+
+namespace Tests\Feature;
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminPlatformOrderFiltersReceiptStatusShouldExplainBroadNoneAndPaidNoReceiptPriorityTest 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_filters_should_explain_broad_none_and_paid_no_receipt_priority(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $res = $this->get('/admin/platform-orders');
+        $res->assertOk();
+
+        $html = (string) $res->getContent();
+        $this->assertStringContainsString('无回执（广义）会包含未支付订单；收费闭环治理请优先使用“已付无回执”快捷筛选。', $html);
+    }
+}