From 283cc6349a2abfe9c6b071c8fa0f5b464ddca112 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:31:29 +0800
Subject: [PATCH] =?UTF-8?q?refactor(dashboard):=20=E5=8F=A3=E5=BE=84?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E=E6=8A=BD=E4=B8=BAmetric=5Fexplain=E7=BB=84?=
 =?UTF-8?q?=E4=BB=B6=E5=87=8F=E5=B0=91=E9=87=8D=E5=A4=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/components/metric_explain.blade.php | 13 +++++++++++++
 resources/views/admin/dashboard.blade.php     | 19 +++++++++++++++++--
 2 files changed, 30 insertions(+), 2 deletions(-)
 create mode 100644 resources/views/admin/components/metric_explain.blade.php

diff --git a/resources/views/admin/components/metric_explain.blade.php b/resources/views/admin/components/metric_explain.blade.php
new file mode 100644
index 0000000..5df2875
--- /dev/null
+++ b/resources/views/admin/components/metric_explain.blade.php
@@ -0,0 +1,13 @@
+@php
+    $items = $items ?? [];
+    $title = $title ?? '口径说明';
+@endphp
+
+@if(is_array($items) && count($items) > 0)
+    <div class="muted muted-xs">
+        <strong>{{ $title }}：</strong>
+        @foreach($items as $i => $text)
+            <span>{{ $text }}@if($i < count($items) - 1)；@endif</span>
+        @endforeach
+    </div>
+@endif
diff --git a/resources/views/admin/dashboard.blade.php b/resources/views/admin/dashboard.blade.php
index dca5a50..cea0946 100644
--- a/resources/views/admin/dashboard.blade.php
+++ b/resources/views/admin/dashboard.blade.php
@@ -349,7 +349,13 @@
 
             <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.metric_explain', [
+                    'items' => [
+                        '待支付=unpaid+pending',
+                        '待生效=paid+pending+unsynced',
+                        '可同步=paid+activated+unsynced+非失败（并排除续费缺订阅脏数据）',
+                    ],
+                ])
 
                 @include('admin.components.mini_bar_row', [
                     'class' => 'mt-6',
@@ -390,7 +396,16 @@
 
             <div class="mt-10" data-role="dashboard-po-governance-bars">
                 <div class="muted muted-xs">治理风险占比（相对平台订单总量 {{ $poTotal }}）</div>
-                <div class="muted muted-xs">口径说明：同步失败=meta.subscription_activation_error.message 存在；BMPA失败=meta.batch_mark_paid_and_activate_error.message 存在；无回执=已支付但缺 payment_receipts；对账不一致=回执汇总金额与 paid_amount 不一致；退款不一致=退款汇总与退款状态不一致；续费缺订阅=renewal 但 site_subscription_id 为空。</div>
+                @include('admin.components.metric_explain', [
+                    'items' => [
+                        '同步失败=meta.subscription_activation_error.message 存在',
+                        'BMPA失败=meta.batch_mark_paid_and_activate_error.message 存在',
+                        '无回执=已支付但缺 payment_receipts',
+                        '对账不一致=回执汇总金额与 paid_amount 不一致',
+                        '退款不一致=退款汇总与退款状态不一致',
+                        '续费缺订阅=renewal 但 site_subscription_id 为空',
+                    ],
+                ])
 
                 @include('admin.components.mini_bar_row', [
                     'class' => 'mt-6',