Platform orders index: add subscription governance quick links

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

@@ -121,6 +121,29 @@
             <div class="mt-10">
                 <a href="{!! $renewCreateUrl !!}" class="btn btn-sm">为该订阅创建续费订单</a>
             </div>
+
+            <div class="mt-10">
+                <div class="muted muted-xs">订阅治理入口：</div>
+                @php
+                    // 锁定订阅场景下的治理快捷入口：保留 site_subscription_id，上下文字段按需覆盖/清空。
+                    $subSyncableUrl = $safeFullUrlWithQuery([
+                        'syncable_only' => '1',
+                        'sync_status' => null,
+                        'fail_only' => null,
+                        'page' => null,
+                    ]);
+
+                    $subSyncFailedUrl = $safeFullUrlWithQuery([
+                        'sync_status' => 'failed',
+                        'syncable_only' => null,
+                        'page' => null,
+                    ]);
+                @endphp
+                <div class="mt-6 actions gap-10">
+                    <a class="btn btn-secondary btn-sm" href="{!! $subSyncableUrl !!}">查看可同步（该订阅）</a>
+                    <a class="btn btn-secondary btn-sm" href="{!! $subSyncFailedUrl !!}">查看同步失败（该订阅）</a>
+                </div>
+            </div>
         </div>
     @endif
 </div>

tests/Feature/AdminPlatformOrderIndexSubscriptionGovernanceQuickLinksTest.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Merchant;
+use App\Models\Plan;
+use App\Models\SiteSubscription;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Arr;
+use Tests\TestCase;
+
+class AdminPlatformOrderIndexSubscriptionGovernanceQuickLinksTest 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_index_should_render_subscription_governance_quick_links_when_subscription_locked(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'po_index_sub_govern_quick_plan',
+            'name' => '平台订单订阅治理快捷入口测试套餐',
+            'billing_cycle' => 'monthly',
+            'price' => 10,
+            'list_price' => 10,
+            'status' => 'active',
+            'sort' => 10,
+            'published_at' => now(),
+        ]);
+
+        $sub = SiteSubscription::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'status' => 'activated',
+            'source' => 'manual',
+            'subscription_no' => 'SS_SUB_GOV_QUICK_0001',
+            'plan_name' => $plan->name,
+            'billing_cycle' => $plan->billing_cycle,
+            'period_months' => 1,
+            'amount' => 10,
+            'starts_at' => now()->subDay(),
+            'ends_at' => now()->addMonth(),
+            'activated_at' => now()->subDay(),
+        ]);
+
+        $res = $this->get('/admin/platform-orders?site_subscription_id=' . $sub->id);
+        $res->assertOk();
+
+        $res->assertSee('订阅治理入口：', false);
+
+        $syncableUrl = '/admin/platform-orders?' . Arr::query([
+            'site_subscription_id' => $sub->id,
+            'syncable_only' => '1',
+        ]);
+
+        $failedUrl = '/admin/platform-orders?' . Arr::query([
+            'site_subscription_id' => $sub->id,
+            'sync_status' => 'failed',
+        ]);
+
+        $res->assertSee($syncableUrl, false);
+        $res->assertSee($failedUrl, false);
+    }
+}