From 9323793485b61f38e204170f87a1be0987afdbc0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=90=9D=E5=8D=9C?= <dev@saasshop.local>
Date: Sat, 14 Mar 2026 00:48:18 +0000
Subject: [PATCH] =?UTF-8?q?=E8=AE=A2=E9=98=85=E8=AF=A6=E6=83=85=EF=BC=9A?=
 =?UTF-8?q?=E6=89=B9=E9=87=8F=E5=90=8C=E6=AD=A5=E6=8C=89=E9=92=AE=E5=89=8D?=
 =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E6=B2=BB=E7=90=86=E6=8F=90=E7=A4=BA=E5=9D=97?=
 =?UTF-8?q?=EF=BC=88=E5=AF=B9=E8=B4=A6/=E9=80=80=E6=AC=BE=E5=BC=82?=
 =?UTF-8?q?=E5=B8=B8=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/site_subscriptions/show.blade.php   | 37 +++++++
 ...riptionShowBatchSyncGovernanceHintTest.php | 99 +++++++++++++++++++
 2 files changed, 136 insertions(+)
 create mode 100644 tests/Feature/AdminSiteSubscriptionShowBatchSyncGovernanceHintTest.php

diff --git a/resources/views/admin/site_subscriptions/show.blade.php b/resources/views/admin/site_subscriptions/show.blade.php
index 51ea8a0..e1c1d45 100644
--- a/resources/views/admin/site_subscriptions/show.blade.php
+++ b/resources/views/admin/site_subscriptions/show.blade.php
@@ -152,6 +152,43 @@
     </div>
 
     <div class="mt-10" id="syncable-batch">
+        @php
+            $reconcileMismatchOrders = (int) ($summaryStats['reconcile_mismatch_orders'] ?? 0);
+            $refundInconsistentOrders = (int) ($summaryStats['refund_inconsistent_orders'] ?? 0);
+        @endphp
+
+        @if($reconcileMismatchOrders > 0 || $refundInconsistentOrders > 0)
+            <div class="card governance-block" style="margin-bottom:10px;">
+                <div class="muted text-danger governance-block-title"><strong>批量同步治理提示</strong></div>
+                <div class="muted governance-block-body">
+                    当前订阅下存在
+                    @if($reconcileMismatchOrders > 0)
+                        <a class="link" href="{!! $makePlatformOrderUrl(['site_subscription_id' => $subscription->id, 'reconcile_mismatch' => '1']) !!}">对账不一致</a>
+                        <span class="muted">（{{ $reconcileMismatchOrders }}）</span>
+                    @endif
+                    @if($reconcileMismatchOrders > 0 && $refundInconsistentOrders > 0)
+                        <span class="muted">与</span>
+                    @endif
+                    @if($refundInconsistentOrders > 0)
+                        <a class="link" href="{!! $makePlatformOrderUrl(['site_subscription_id' => $subscription->id, 'refund_inconsistent' => '1']) !!}">退款不一致</a>
+                        <span class="muted">（{{ $refundInconsistentOrders }}）</span>
+                    @endif
+                    订单。建议先逐单治理金额/状态口径（补回执/核对退款/修正状态），再批量同步订阅。
+
+                    @if($reconcileMismatchOrders > 0)
+                        <div style="margin-top:6px;">
+                            <a class="link" href="{!! $makePlatformOrderUrl(['site_subscription_id' => $subscription->id, 'reconcile_mismatch' => '1']) !!}">进入对账不一致订单列表</a>
+                        </div>
+                    @endif
+                    @if($refundInconsistentOrders > 0)
+                        <div style="margin-top:6px;">
+                            <a class="link" href="{!! $makePlatformOrderUrl(['site_subscription_id' => $subscription->id, 'refund_inconsistent' => '1']) !!}">进入退款不一致订单列表</a>
+                        </div>
+                    @endif
+                </div>
+            </div>
+        @endif
+
         <form method="post" action="/admin/platform-orders/batch-activate-subscriptions" onsubmit="return confirm('确认批量同步该订阅下“可同步”的订单？（仅处理：已支付+已生效+未同步）');">
             @csrf
             <input type="hidden" name="scope" value="filtered">
diff --git a/tests/Feature/AdminSiteSubscriptionShowBatchSyncGovernanceHintTest.php b/tests/Feature/AdminSiteSubscriptionShowBatchSyncGovernanceHintTest.php
new file mode 100644
index 0000000..948bb7b
--- /dev/null
+++ b/tests/Feature/AdminSiteSubscriptionShowBatchSyncGovernanceHintTest.php
@@ -0,0 +1,99 @@
+<?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 AdminSiteSubscriptionShowBatchSyncGovernanceHintTest 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_show_should_render_batch_sync_governance_hint_when_mismatch_orders_exist(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'sub_show_batch_sync_gov_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' => 'SUB_BATCH_SYNC_GOV_0001',
+            'plan_name' => $plan->name,
+            'billing_cycle' => $plan->billing_cycle,
+            'period_months' => 1,
+            'amount' => 10,
+            'starts_at' => now(),
+            'ends_at' => now()->addMonth(),
+        ]);
+
+        // 构造一条对账不一致订单（receipt_total=9, paid_amount=10），让订阅详情页出现治理提示
+        PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'site_subscription_id' => $sub->id,
+            'order_no' => 'PO_SUB_BATCH_SYNC_GOV_RECON_0001',
+            'order_type' => 'renewal',
+            '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(),
+            'paid_at' => now(),
+            'activated_at' => now(),
+            'meta' => [
+                'payment_summary' => [
+                    'count' => 1,
+                    'total_amount' => 9,
+                ],
+                'payment_receipts' => [
+                    [
+                        'type' => 'bank_transfer',
+                        'channel' => 'offline',
+                        'amount' => 9,
+                        'paid_at' => now()->toDateTimeString(),
+                        'created_at' => now()->toDateTimeString(),
+                        'admin_id' => 1,
+                    ],
+                ],
+            ],
+        ]);
+
+        $res = $this->get('/admin/site-subscriptions/' . $sub->id);
+        $res->assertOk();
+
+        $res->assertSee('批量同步治理提示', false);
+        $res->assertSee('对账不一致', false);
+        $res->assertSee('进入对账不一致订单列表', false);
+    }
+}