platform orders: add bmpa failed reason top links and retry shortcut

resources/views/admin/platform_orders/index.blade.php

@@ -281,6 +281,49 @@
             <div class="muted">暂无失败原因聚合数据</div>
         @endif
     </div>
+
+    <div class="card">
+        <h3>批量标记支付并生效失败原因 TOP5</h3>
+        @php $bmpaFailedReasonStats = $bmpaFailedReasonStats ?? []; @endphp
+        @if(count($bmpaFailedReasonStats) > 0)
+            <div class="muted mt-6">
+                @foreach($bmpaFailedReasonStats as $item)
+                    @php
+                        $reason = (string) ($item['reason'] ?? '');
+                        $count = (int) ($item['count'] ?? 0);
+                    @endphp
+                    <div>
+                        @if($reason !== '' && $reason !== '（空）')
+                            @php
+                                $reasonText = mb_substr($reason, 0, $SYNC_FAILED_REASON_TRUNCATE_LEN);
+                                $reasonTooLong = mb_strlen($reason) > $SYNC_ERROR_KEYWORD_LINK_MAX_LEN;
+                            @endphp
+
+                            @if($reasonTooLong)
+                                <span class="muted" title="{{ $reason }}">{{ $reasonText }}</span>
+                                <span class="muted">（{{ $count }}）</span>
+                                <span class="muted">｜</span>
+                                <span class="muted">原因过长，请复制到筛选框</span>
+                                <span class="muted">｜</span>
+                                <a class="link" href="{{ request()->fullUrlWithQuery(['bmpa_error_keyword' => null, 'page' => null]) }}">进入失败集合</a>
+                            @else
+                                <a class="link" title="{{ $reason }}" href="{!! request()->fullUrlWithQuery(['bmpa_error_keyword' => $reason, 'page' => null]) !!}">{{ $reasonText }}</a>
+                                <span class="muted">（{{ $count }}）</span>
+                                <span class="muted">｜</span>
+                                <a class="link" href="{!! request()->fullUrlWithQuery(['bmpa_error_keyword' => $reason, 'status' => 'pending', 'payment_status' => 'unpaid', 'page' => null]) !!}">切到可处理集合重试</a>
+                            @endif
+                        @else
+                            <span class="muted">（空原因）</span>
+                            <span class="muted">（{{ $count }}）</span>
+                        @endif
+                    </div>
+                @endforeach
+            </div>
+        @else
+            <div class="muted">暂无失败原因聚合数据</div>
+        @endif
+        <div class="muted muted-xs mt-6">提示：建议先点原因进入失败集合，完成回执/退款治理后，再切到 pending+unpaid 集合重试。</div>
+    </div>
 </div>
 
 <div class="card mb-20">

tests/Feature/AdminPlatformOrderBmpaFailedReasonStatsLinksTest.php

@@ -0,0 +1,78 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Merchant;
+use App\Models\Plan;
+use App\Models\PlatformOrder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminPlatformOrderBmpaFailedReasonStatsLinksTest 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_page_shows_bmpa_failed_reason_stats_and_links(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'bmpa_failed_reason_stats_plan',
+            'name' => 'BMPA 失败原因聚合链接测试套餐',
+            'billing_cycle' => 'monthly',
+            'price' => 10,
+            'list_price' => 10,
+            'status' => 'active',
+            'sort' => 10,
+            'published_at' => now(),
+        ]);
+
+        $reason = '回执总额与应付金额不一致';
+
+        PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'order_no' => 'PO_BMPA_STATS_1',
+            'order_type' => 'new_purchase',
+            'status' => 'pending',
+            'payment_status' => 'unpaid',
+            'plan_name' => $plan->name,
+            'billing_cycle' => $plan->billing_cycle,
+            'period_months' => 1,
+            'quantity' => 1,
+            'payable_amount' => 10,
+            'paid_amount' => 0,
+            'placed_at' => now(),
+            'meta' => [
+                'batch_mark_paid_and_activate_error' => [
+                    'message' => $reason,
+                    'at' => now()->toDateTimeString(),
+                    'admin_id' => 1,
+                ],
+            ],
+        ]);
+
+        $res = $this->get('/admin/platform-orders');
+        $res->assertOk();
+
+        // 卡片标题
+        $res->assertSee('批量标记支付并生效失败原因 TOP5');
+
+        // 点击原因 => 自动带上 bmpa_error_keyword
+        $res->assertSee('/admin/platform-orders?bmpa_error_keyword=' . urlencode($reason), false);
+
+        // 一键切到可处理集合重试 => 透传 pending+unpaid
+        $res->assertSee('bmpa_error_keyword=' . urlencode($reason) . '&status=pending&payment_status=unpaid', false);
+    }
+}