From 96c1a1562d1177be06dd849c2c3fd6bef9c28db2 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 13:34:54 +0800
Subject: [PATCH] ui(platform-orders): add governance links for batch
 activation last_result

---
 .../admin/platform_orders/index.blade.php     | 25 +++++
 ...tResultGovernanceLinksShouldRenderTest.php | 91 +++++++++++++++++++
 2 files changed, 116 insertions(+)
 create mode 100644 tests/Feature/AdminPlatformOrderIndexBatchActivationLastResultGovernanceLinksShouldRenderTest.php

diff --git a/resources/views/admin/platform_orders/index.blade.php b/resources/views/admin/platform_orders/index.blade.php
index e8120ef..03874a8 100644
--- a/resources/views/admin/platform_orders/index.blade.php
+++ b/resources/views/admin/platform_orders/index.blade.php
@@ -1431,6 +1431,31 @@
                                 <a class="link" href="{!! $safeFullUrlWithQuery(['batch_activation_run_id' => $lrRunId, 'page' => null]) !!}">{{ $lrRunId }}</a>
                             </div>
                             <div class="muted muted-xs">结果：成功{{ $lrSuccess }} / 失败{{ $lrFailed }}</div>
+                            @php
+                                // 本批次一键治理入口：快速跳转到“同批次失败集合/按原因筛选”
+                                $lrGoFailedUrl = $buildQuickFilterUrl([
+                                    'batch_activation_run_id' => $lrRunId,
+                                    'sync_status' => 'failed',
+                                    'page' => null,
+                                ]);
+
+                                $lrGoTopReasonUrl = '';
+                                if ($lrTopReason !== '' && mb_strlen($lrTopReason) <= $SYNC_ERROR_KEYWORD_LINK_MAX_LEN) {
+                                    $lrGoTopReasonUrl = $buildQuickFilterUrl([
+                                        'batch_activation_run_id' => $lrRunId,
+                                        'sync_status' => 'failed',
+                                        'sync_error_keyword' => $lrTopReason,
+                                        'page' => null,
+                                    ]);
+                                }
+                            @endphp
+                            <div class="muted muted-xs">治理：
+                                <a class="link" href="{!! $lrGoFailedUrl !!}">本批次失败</a>
+                                @if($lrGoTopReasonUrl !== '')
+                                    <span class="muted">｜</span>
+                                    <a class="link" href="{!! $lrGoTopReasonUrl !!}">按Top原因</a>
+                                @endif
+                            </div>
                             @if($lrTopReason !== '')
                                 <div class="muted muted-xs">Top：{{ mb_substr($lrTopReason, 0, 40) }}（{{ $lrTopReasonCount }}）</div>
                             @endif
diff --git a/tests/Feature/AdminPlatformOrderIndexBatchActivationLastResultGovernanceLinksShouldRenderTest.php b/tests/Feature/AdminPlatformOrderIndexBatchActivationLastResultGovernanceLinksShouldRenderTest.php
new file mode 100644
index 0000000..157f326
--- /dev/null
+++ b/tests/Feature/AdminPlatformOrderIndexBatchActivationLastResultGovernanceLinksShouldRenderTest.php
@@ -0,0 +1,91 @@
+<?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 AdminPlatformOrderIndexBatchActivationLastResultGovernanceLinksShouldRenderTest 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_should_render_governance_links_for_batch_activation_last_result(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'po_batch_activation_last_result_gov_links_plan',
+            'name' => '批量同步 last_result 治理链接渲染测试套餐',
+            '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_BATCH_LAST_RESULT_GOV_LINKS_0001',
+            'order_type' => 'new_purchase',
+            'status' => 'activated',
+            'payment_status' => 'paid',
+            'plan_name' => $plan->name,
+            'billing_cycle' => $plan->billing_cycle,
+            'period_months' => 1,
+            'quantity' => 1,
+            'payable_amount' => 10,
+            'paid_amount' => 10,
+            'placed_at' => now()->subMinutes(10),
+            'paid_at' => now()->subMinutes(9),
+            'activated_at' => now()->subMinutes(8),
+            'meta' => [
+                'batch_activation' => [
+                    'at' => now()->toDateTimeString(),
+                    'admin_id' => 1,
+                    'scope' => 'filtered',
+                    'mode' => 'queue',
+                    'run_id' => 'BAS_TEST_GOV_0001',
+                    'last_result' => [
+                        'run_id' => 'BAS_TEST_GOV_0001',
+                        'success' => 3,
+                        'failed' => 1,
+                        'matched' => 10,
+                        'processed' => 4,
+                        'top_reasons' => [
+                            ['reason' => '模拟失败：订阅同步异常', 'count' => 1],
+                        ],
+                        'at' => now()->toDateTimeString(),
+                    ],
+                ],
+            ],
+        ]);
+
+        $html = $this->get('/admin/platform-orders')
+            ->assertOk()
+            ->getContent();
+
+        // 1) 本批次失败：应带 run_id + sync_status=failed
+        $this->assertStringContainsString('batch_activation_run_id=BAS_TEST_GOV_0001', $html);
+        $this->assertStringContainsString('sync_status=failed', $html);
+
+        // 2) 按Top原因：应带 run_id + sync_status=failed + sync_error_keyword
+        $this->assertStringContainsString('sync_error_keyword=', $html);
+        $this->assertStringContainsString(urlencode('模拟失败：订阅同步异常'), $html);
+    }
+}