feat(admin): site subscription show page with related platform orders

app/Http/Controllers/Admin/SiteSubscriptionController.php

@@ -9,11 +9,44 @@ use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Http\Request;
 use Illuminate\View\View;
 use Symfony\Component\HttpFoundation\StreamedResponse;
+use App\Models\PlatformOrder;
 
 class SiteSubscriptionController extends Controller
 {
     use ResolvesPlatformAdminContext;
 
+    public function show(Request $request, SiteSubscription $subscription): View
+    {
+        $this->ensurePlatformAdmin($request);
+
+        $subscription->loadMissing(['merchant', 'plan']);
+
+        $platformOrders = PlatformOrder::query()
+            ->where('site_subscription_id', $subscription->id)
+            ->latest('id')
+            ->paginate(10)
+            ->withQueryString();
+
+        $endsAt = $subscription->ends_at;
+        $expiryLabel = '无到期';
+        if ($endsAt) {
+            if ($endsAt->lt(now())) {
+                $expiryLabel = '已过期';
+            } elseif ($endsAt->lt(now()->addDays(7))) {
+                $expiryLabel = '7天内到期';
+            } else {
+                $expiryLabel = '未到期';
+            }
+        }
+
+        return view('admin.site_subscriptions.show', [
+            'subscription' => $subscription,
+            'platformOrders' => $platformOrders,
+            'statusLabels' => $this->statusLabels(),
+            'expiryLabel' => $expiryLabel,
+        ]);
+    }
+
     public function export(Request $request): StreamedResponse
     {
         $this->ensurePlatformAdmin($request);

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

@@ -106,7 +106,7 @@
             <tr>
                 <td>{{ $subscription->id }}</td>
                 <td>
-                    <a href="/admin/site-subscriptions?keyword={{ urlencode($subscription->subscription_no) }}">{{ $subscription->subscription_no }}</a>
+                    <a href="/admin/site-subscriptions/{{ $subscription->id }}">{{ $subscription->subscription_no }}</a>
                 </td>
                 <td>
                     @if($subscription->merchant)

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

@@ -0,0 +1,135 @@
+@extends('admin.layouts.app')
+
+@section('title', '订阅详情')
+@section('page_title', '订阅详情')
+
+@section('content')
+<div class="card mb-20">
+    <p class="muted muted-tight">
+        这里是总台视角的订阅详情页，用于运营排查“订阅状态/到期/关联平台订单/同步记录”。
+    </p>
+
+    <div class="grid-4">
+        <div>
+            <div class="muted">订阅号</div>
+            <div class="num-md">{{ $subscription->subscription_no }}</div>
+        </div>
+        <div>
+            <div class="muted">状态</div>
+            <div class="num-md">{{ ($statusLabels[$subscription->status] ?? $subscription->status) }} <span class="muted">({{ $subscription->status }})</span></div>
+        </div>
+        <div>
+            <div class="muted">站点</div>
+            <div class="num-md">{{ $subscription->merchant?->name ?? '未关联站点' }}</div>
+        </div>
+        <div>
+            <div class="muted">套餐</div>
+            <div class="num-md">{{ $subscription->plan_name ?: ($subscription->plan?->name ?? '未设置') }}</div>
+        </div>
+    </div>
+
+    <div class="grid-4 mt-10">
+        <div>
+            <div class="muted">计费周期 / 周期(月)</div>
+            <div class="num-md">{{ $subscription->billing_cycle ?: '-' }} / {{ (int) $subscription->period_months }}</div>
+        </div>
+        <div>
+            <div class="muted">金额</div>
+            <div class="num-md">¥{{ number_format((float) $subscription->amount, 2) }}</div>
+        </div>
+        <div>
+            <div class="muted">开始时间</div>
+            <div class="num-md">{{ optional($subscription->starts_at)->format('Y-m-d H:i:s') ?: '-' }}</div>
+        </div>
+        <div>
+            <div class="muted">到期时间</div>
+            <div class="num-md">{{ optional($subscription->ends_at)->format('Y-m-d H:i:s') ?: '-' }}</div>
+        </div>
+    </div>
+
+    <div class="grid-4 mt-10">
+        <div>
+            <div class="muted">到期状态（按到期时间）</div>
+            <div class="num-md">{{ $expiryLabel }}</div>
+        </div>
+        <div>
+            <div class="muted">试用到期</div>
+            <div class="num-md">{{ optional($subscription->trial_ends_at)->format('Y-m-d H:i:s') ?: '-' }}</div>
+        </div>
+        <div>
+            <div class="muted">生效时间</div>
+            <div class="num-md">{{ optional($subscription->activated_at)->format('Y-m-d H:i:s') ?: '-' }}</div>
+        </div>
+        <div>
+            <div class="muted">取消时间</div>
+            <div class="num-md">{{ optional($subscription->cancelled_at)->format('Y-m-d H:i:s') ?: '-' }}</div>
+        </div>
+    </div>
+
+    <div class="mt-10">
+        <a href="/admin/site-subscriptions" class="muted">← 返回订阅列表</a>
+        @if($subscription->subscription_no)
+            <span class="muted">｜</span>
+            <a href="/admin/platform-orders?keyword={{ urlencode($subscription->subscription_no) }}" class="muted">按订阅号查看平台订单</a>
+        @endif
+    </div>
+</div>
+
+<div class="card">
+    <h3>关联平台订单（{{ $platformOrders->total() }}）</h3>
+    <table>
+        <thead>
+        <tr>
+            <th>ID</th>
+            <th>订单号</th>
+            <th>订单状态</th>
+            <th>支付状态</th>
+            <th>应付/已付</th>
+            <th>下单时间</th>
+            <th>生效时间</th>
+            <th>同步状态</th>
+            <th>操作</th>
+        </tr>
+        </thead>
+        <tbody>
+        @forelse($platformOrders as $order)
+            @php
+                $syncedId = (int) data_get($order->meta, 'subscription_activation.subscription_id', 0);
+                $syncErr = (string) (data_get($order->meta, 'subscription_activation_error.message') ?? '');
+                if ($syncedId > 0) {
+                    $syncStatus = '已同步';
+                } elseif ($syncErr !== '') {
+                    $syncStatus = '同步失败';
+                } else {
+                    $syncStatus = '未同步';
+                }
+            @endphp
+            <tr>
+                <td>{{ $order->id }}</td>
+                <td><a href="/admin/platform-orders/{{ $order->id }}">{{ $order->order_no }}</a></td>
+                <td>{{ $order->status }}</td>
+                <td>{{ $order->payment_status }}</td>
+                <td>¥{{ number_format((float) $order->payable_amount, 2) }} / ¥{{ number_format((float) $order->paid_amount, 2) }}</td>
+                <td>{{ optional($order->placed_at)->format('Y-m-d H:i:s') ?: '-' }}</td>
+                <td>{{ optional($order->activated_at)->format('Y-m-d H:i:s') ?: '-' }}</td>
+                <td>
+                    {{ $syncStatus }}
+                    @if($syncStatus === '同步失败')
+                        <span class="muted">（{{ mb_substr($syncErr, 0, 30) }}）</span>
+                    @endif
+                </td>
+                <td>
+                    <a href="/admin/platform-orders/{{ $order->id }}">详情</a>
+                </td>
+            </tr>
+        @empty
+            <tr>
+                <td colspan="9" class="muted">暂无关联平台订单。</td>
+            </tr>
+        @endforelse
+        </tbody>
+    </table>
+
+    <div class="pagination-wrap">{{ $platformOrders->links() }}</div>
+</div>
+@endsection

routes/web.php

@@ -109,6 +109,7 @@ Route::prefix('admin')->group(function () {
 
         Route::get('/site-subscriptions', [SiteSubscriptionController::class, 'index']);
         Route::get('/site-subscriptions/export', [SiteSubscriptionController::class, 'export']);
+        Route::get('/site-subscriptions/{subscription}', [SiteSubscriptionController::class, 'show']);
 
         Route::get('/plans', [PlanController::class, 'index']);
         Route::get('/plans/export', [PlanController::class, 'export']);

tests/Feature/AdminSiteSubscriptionShowTest.php

@@ -0,0 +1,119 @@
+<?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 AdminSiteSubscriptionShowTest 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_admin_can_open_site_subscription_show_page(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'sub_show_test',
+            'name' => '订阅详情测试套餐',
+            'billing_cycle' => 'monthly',
+            'price' => 88,
+            'list_price' => 88,
+            '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' => 'SUB_SHOW_0001',
+            'plan_name' => $plan->name,
+            'billing_cycle' => 'monthly',
+            'period_months' => 1,
+            'amount' => 88,
+            'starts_at' => now()->subDays(2),
+            'ends_at' => now()->addDays(20),
+            'activated_at' => now()->subDays(2),
+        ]);
+
+        PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'site_subscription_id' => $sub->id,
+            'created_by_admin_id' => 1,
+            'order_no' => 'PO_SUB_SHOW_0001',
+            'order_type' => 'subscription',
+            'status' => 'activated',
+            'payment_status' => 'paid',
+            'plan_name' => $plan->name,
+            'billing_cycle' => 'monthly',
+            'period_months' => 1,
+            'quantity' => 1,
+            'list_amount' => 88,
+            'discount_amount' => 0,
+            'payable_amount' => 88,
+            'paid_amount' => 88,
+            'placed_at' => now()->subDay(),
+            'paid_at' => now()->subDay(),
+            'activated_at' => now()->subDay(),
+            'meta' => [
+                'subscription_activation' => [
+                    'subscription_id' => $sub->id,
+                    'synced_at' => now()->subDay()->toDateTimeString(),
+                    'admin_id' => 1,
+                ],
+            ],
+        ]);
+
+        $this->get('/admin/site-subscriptions/' . $sub->id)
+            ->assertOk()
+            ->assertSee('订阅详情')
+            ->assertSee('SUB_SHOW_0001')
+            ->assertSee('关联平台订单')
+            ->assertSee('PO_SUB_SHOW_0001');
+    }
+
+    public function test_guest_cannot_open_site_subscription_show_page(): void
+    {
+        $merchant = Merchant::query()->create([
+            'name' => '访客测试站点',
+            'slug' => 'guest-test',
+            'status' => 'active',
+        ]);
+
+        $sub = SiteSubscription::query()->create([
+            'merchant_id' => $merchant->id,
+            'status' => 'activated',
+            'source' => 'manual',
+            'subscription_no' => 'SUB_GUEST_0001',
+            'plan_name' => '访客测试套餐',
+            'billing_cycle' => 'monthly',
+            'period_months' => 1,
+            'amount' => 88,
+            'starts_at' => now()->subDay(),
+            'ends_at' => now()->addDays(29),
+            'activated_at' => now()->subDay(),
+        ]);
+
+        $this->get('/admin/site-subscriptions/' . $sub->id)
+            ->assertRedirect('/admin/login');
+    }
+}