feat(admin): 续费缺订阅治理闭环（订单手工绑定订阅）

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

@@ -457,6 +457,16 @@
                             <a class="btn btn-secondary btn-sm" href="{!! $missingSubHelpUrlForRelationBlock !!}">去订阅管理查找订阅</a>
                         @endif
                     </div>
+
+                    <div class="mt-10">
+                        <form method="post" action="/admin/platform-orders/{{ $order->id }}/attach-subscription" class="inline-form" onsubmit="return confirm('确认将该订单绑定到所选订阅？该操作会写入审计留痕（meta.audit）');">
+                            @csrf
+                            <label class="muted" for="attach_site_subscription_id">绑定订阅ID</label>
+                            <input id="attach_site_subscription_id" name="site_subscription_id" type="number" min="1" class="input input-sm" placeholder="输入订阅ID" required>
+                            <button class="btn btn-primary btn-sm" type="submit">绑定订阅</button>
+                        </form>
+                        <div class="muted muted-xs mt-6">口径：仅用于“续费缺订阅”治理；系统将校验订阅的站点/套餐必须与当前订单一致，避免串单。</div>
+                    </div>
                 </div>
             </div>
         @endif

tests/Feature/AdminPlatformOrderAttachSubscriptionShouldWorkTest.php

@@ -0,0 +1,87 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Merchant;
+use App\Models\Plan;
+use App\Models\PlatformOrder;
+use App\Models\SiteSubscription;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminPlatformOrderAttachSubscriptionShouldWorkTest 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_attach_subscription_should_bind_subscription_for_renewal_missing_subscription_order(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+
+        $plan = Plan::query()->create([
+            'code' => 'po_attach_sub_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' => 'active',
+            'source' => 'manual',
+            'subscription_no' => 'SS_ATTACH_SUB_0001',
+            'plan_name' => $plan->name,
+            'billing_cycle' => $plan->billing_cycle,
+            'period_months' => 1,
+            'amount' => 10,
+            'starts_at' => now()->subDays(1),
+            'ends_at' => now()->addDays(10),
+            'snapshot' => [],
+            'meta' => [],
+        ]);
+
+        $order = PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'order_no' => 'PO_ATTACH_SUB_0001',
+            'order_type' => 'renewal',
+            'site_subscription_id' => null,
+            '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' => [],
+        ]);
+
+        $this->post('/admin/platform-orders/' . $order->id . '/attach-subscription', [
+            'site_subscription_id' => $sub->id,
+        ])->assertRedirect();
+
+        $order->refresh();
+
+        $this->assertSame($sub->id, (int) $order->site_subscription_id);
+        $this->assertSame('attach_subscription', (string) data_get($order->meta, 'audit.0.action'));
+        $this->assertSame($sub->id, (int) data_get($order->meta, 'audit.0.subscription_id'));
+    }
+}