From 277d8fc69dba220c7b591bfc92d0ba0726406725 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 14:23:10 +0800
Subject: [PATCH] ui(platform-orders): add batch governance links in bmpa error
 block

---
 .../admin/platform_orders/index.blade.php     | 40 ++++++++-
 ...tchGovernanceLinksWhenRunIdPresentTest.php | 83 +++++++++++++++++++
 2 files changed, 122 insertions(+), 1 deletion(-)
 create mode 100644 tests/Feature/AdminPlatformOrderIndexBmpaErrorBlockShouldRenderBatchGovernanceLinksWhenRunIdPresentTest.php

diff --git a/resources/views/admin/platform_orders/index.blade.php b/resources/views/admin/platform_orders/index.blade.php
index cc02ae0..7436cc4 100644
--- a/resources/views/admin/platform_orders/index.blade.php
+++ b/resources/views/admin/platform_orders/index.blade.php
@@ -1431,14 +1431,52 @@
                         @endif
 
                         @if($bmpaErrMsg !== '')
+                            @php
+                                $bmpaRunIdRow = (string) (data_get($order->meta, 'batch_mark_paid_and_activate.run_id') ?? '');
+
+                                $bmpaGoFailedUrl = $buildQuickFilterUrl([
+                                    'bmpa_failed_only' => '1',
+                                    'page' => null,
+                                ]);
+
+                                $bmpaGoBatchFailedUrl = '';
+                                if ($bmpaRunIdRow !== '') {
+                                    $bmpaGoBatchFailedUrl = $buildQuickFilterUrl([
+                                        'batch_bmpa_run_id' => $bmpaRunIdRow,
+                                        'bmpa_failed_only' => '1',
+                                        'page' => null,
+                                    ]);
+                                }
+
+                                $bmpaGoBatchReasonUrl = '';
+                                if ($bmpaRunIdRow !== '' && ! $bmpaErrTooLong) {
+                                    $bmpaGoBatchReasonUrl = $buildQuickFilterUrl([
+                                        'batch_bmpa_run_id' => $bmpaRunIdRow,
+                                        'bmpa_failed_only' => '1',
+                                        'bmpa_error_keyword' => $bmpaErrMsg,
+                                        'page' => null,
+                                    ]);
+                                }
+                            @endphp
                             <div class="mt-6">
                                 <span class="muted muted-xs">BMPA：</span>
                                 @if($bmpaErrTooLong)
                                     <span class="muted text-danger" title="{{ $bmpaErrMsg }}">{{ mb_substr($bmpaErrMsg, 0, $SYNC_FAILED_REASON_TRUNCATE_LEN) }}</span>
                                     <div class="muted text-danger muted-xs">原因过长，请复制到筛选框</div>
-                                    <a class="link" href="{!! $safeFullUrlWithQuery(['bmpa_failed_only' => '1', 'page' => null]) !!}">进入批量标记支付失败集合</a>
+
+                                    @if($bmpaGoBatchFailedUrl !== '')
+                                        <div class="muted muted-xs">治理：<a class="link" href="{!! $bmpaGoBatchFailedUrl !!}">进入本批次 BMPA 失败集合</a></div>
+                                    @else
+                                        <div class="muted muted-xs">治理：<a class="link" href="{!! $bmpaGoFailedUrl !!}">进入 BMPA 失败集合</a></div>
+                                    @endif
                                 @else
                                     <a class="link text-danger" href="{!! $safeFullUrlWithQuery(['bmpa_error_keyword' => $bmpaErrMsg, 'page' => null]) !!}">{{ mb_substr($bmpaErrMsg, 0, $SYNC_FAILED_REASON_TRUNCATE_LEN) }}</a>
+
+                                    @if($bmpaGoBatchReasonUrl !== '')
+                                        <div class="muted muted-xs">治理：<a class="link" href="{!! $bmpaGoBatchReasonUrl !!}">本批次按原因筛选</a></div>
+                                    @elseif($bmpaGoBatchFailedUrl !== '')
+                                        <div class="muted muted-xs">治理：<a class="link" href="{!! $bmpaGoBatchFailedUrl !!}">进入本批次 BMPA 失败集合</a></div>
+                                    @endif
                                 @endif
                             </div>
                         @endif
diff --git a/tests/Feature/AdminPlatformOrderIndexBmpaErrorBlockShouldRenderBatchGovernanceLinksWhenRunIdPresentTest.php b/tests/Feature/AdminPlatformOrderIndexBmpaErrorBlockShouldRenderBatchGovernanceLinksWhenRunIdPresentTest.php
new file mode 100644
index 0000000..0428c57
--- /dev/null
+++ b/tests/Feature/AdminPlatformOrderIndexBmpaErrorBlockShouldRenderBatchGovernanceLinksWhenRunIdPresentTest.php
@@ -0,0 +1,83 @@
+<?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 AdminPlatformOrderIndexBmpaErrorBlockShouldRenderBatchGovernanceLinksWhenRunIdPresentTest 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_bmpa_error_block_should_render_batch_governance_links_when_run_id_present(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'po_bmpa_error_block_batch_gov_links_plan',
+            'name' => 'BMPA 错误块批次治理链接渲染测试套餐',
+            'billing_cycle' => 'monthly',
+            'price' => 10,
+            'list_price' => 10,
+            'status' => 'active',
+            'sort' => 10,
+            'published_at' => now(),
+        ]);
+
+        PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'order_no' => 'PO_BMPA_ERR_BLOCK_GOV_0001',
+            '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()->subMinutes(10),
+            'meta' => [
+                'batch_mark_paid_and_activate' => [
+                    'at' => now()->toDateTimeString(),
+                    'admin_id' => 1,
+                    'scope' => 'filtered',
+                    'mode' => 'sync',
+                    'run_id' => 'BMPA_TEST_ERR_BLOCK_0001',
+                ],
+                'batch_mark_paid_and_activate_error' => [
+                    'message' => '模拟失败：回执金额不一致',
+                    'at' => now()->toDateTimeString(),
+                    'admin_id' => 1,
+                    'scope' => 'filtered',
+                    'run_id' => 'BMPA_TEST_ERR_BLOCK_0001',
+                ],
+            ],
+        ]);
+
+        $html = $this->get('/admin/platform-orders')
+            ->assertOk()
+            ->getContent();
+
+        // 需要包含：本批次按原因筛选（batch_bmpa_run_id + bmpa_failed_only + bmpa_error_keyword）
+        $this->assertStringContainsString('batch_bmpa_run_id=BMPA_TEST_ERR_BLOCK_0001', $html);
+        $this->assertStringContainsString('bmpa_failed_only=1', $html);
+        $this->assertStringContainsString('bmpa_error_keyword=', $html);
+        $this->assertStringContainsString(urlencode('模拟失败：回执金额不一致'), $html);
+    }
+}