From 78424a213d0d4464276c499d82d9e2f350b77e35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=90=9D=E5=8D=9C?= <dev@saasshop.local>
Date: Tue, 17 Mar 2026 19:19:41 +0800
Subject: [PATCH] =?UTF-8?q?docs(dashboard):=20=E5=B9=B3=E5=8F=B0=E8=AE=A2?=
 =?UTF-8?q?=E5=8D=95=E6=BC=8F=E6=96=97=E5=A2=9E=E5=8A=A0=E5=8F=A3=E5=BE=84?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E=E5=B9=B6=E5=8A=A0=E6=8A=A4=E6=A0=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 resources/views/admin/dashboard.blade.php     |  1 +
 ...ormOrderFunnelShouldExplainMetricsTest.php | 34 +++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 tests/Feature/AdminDashboardPlatformOrderFunnelShouldExplainMetricsTest.php

diff --git a/resources/views/admin/dashboard.blade.php b/resources/views/admin/dashboard.blade.php
index a50949e..e46b547 100644
--- a/resources/views/admin/dashboard.blade.php
+++ b/resources/views/admin/dashboard.blade.php
@@ -349,6 +349,7 @@
 
             <div class="mt-10" data-role="dashboard-po-funnel-bars">
                 <div class="muted muted-xs">收费主链漏斗（相对平台订单总量 {{ $poTotal }}）</div>
+                <div class="muted muted-xs">口径说明：待支付=unpaid+pending；待生效=paid+pending+unsynced；可同步=paid+activated+unsynced+非失败（并排除续费缺订阅脏数据）。</div>
 
                 @include('admin.components.mini_bar_row', [
                     'class' => 'mt-6',
diff --git a/tests/Feature/AdminDashboardPlatformOrderFunnelShouldExplainMetricsTest.php b/tests/Feature/AdminDashboardPlatformOrderFunnelShouldExplainMetricsTest.php
new file mode 100644
index 0000000..c14dbca
--- /dev/null
+++ b/tests/Feature/AdminDashboardPlatformOrderFunnelShouldExplainMetricsTest.php
@@ -0,0 +1,34 @@
+<?php
+
+namespace Tests\Feature;
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminDashboardPlatformOrderFunnelShouldExplainMetricsTest 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_should_render_platform_order_funnel_explanation_text(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $res = $this->get('/admin');
+
+        $res->assertOk();
+        $res->assertSee('口径说明');
+        $res->assertSee('待支付=unpaid+pending');
+        $res->assertSee('待生效=paid+pending+unsynced');
+        $res->assertSee('可同步=paid+activated+unsynced+非失败');
+    }
+}