ui(component): metric_explain默认折叠(details)避免Dashboard口径说明撑满

resources/views/admin/components/metric_explain.blade.php

@@ -1,13 +1,25 @@
 @php
     $items = $items ?? [];
     $title = $title ?? '口径说明';
+    $collapsible = (bool) ($collapsible ?? true);
 @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>
+    @if($collapsible)
+        <details class="muted muted-xs" data-role="metric-explain" style="margin-top:4px;">
+            <summary style="cursor:pointer; user-select:none;"><strong>{{ $title }}：</strong><span class="muted">（点击展开）</span></summary>
+            <div class="mt-6">
+                @foreach($items as $i => $text)
+                    <span>{{ $text }}@if($i < count($items) - 1)；@endif</span>
+                @endforeach
+            </div>
+        </details>
+    @else
+        <div class="muted muted-xs" data-role="metric-explain" style="margin-top:4px;">
+            <strong>{{ $title }}：</strong>
+            @foreach($items as $i => $text)
+                <span>{{ $text }}@if($i < count($items) - 1)；@endif</span>
+            @endforeach
+        </div>
+    @endif
 @endif

tests/Feature/AdminMetricExplainComponentShouldUseDetailsByDefaultTest.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Tests\Feature;
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminMetricExplainComponentShouldUseDetailsByDefaultTest 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_metric_explain_as_details(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $res = $this->get('/admin');
+
+        $res->assertOk();
+        // 组件默认应使用 details 折叠，避免口径说明撑满页面。
+        $res->assertSee('data-role="metric-explain"', false);
+        $res->assertSee('<details', false);
+        $res->assertSee('点击展开');
+    }
+}