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 @@
收费主链漏斗(相对平台订单总量 {{ $poTotal }})
+
口径说明:待支付=unpaid+pending;待生效=paid+pending+unsynced;可同步=paid+activated+unsynced+非失败(并排除续费缺订阅脏数据)。
@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 @@
+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+非失败');
+ }
+}