From ca1c25e18de75387697bda8bc56630fc32a6150c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=90=9D=E5=8D=9C?= <dev@saasshop.local>
Date: Tue, 10 Mar 2026 20:58:08 +0000
Subject: [PATCH] =?UTF-8?q?feat(platform-orders):=20=E5=A2=9E=E5=8A=A0?=
 =?UTF-8?q?=E5=AF=B9=E8=B4=A6=E4=B8=8D=E4=B8=80=E8=87=B4=E7=AD=9B=E9=80=89?=
 =?UTF-8?q?=EF=BC=88=E5=9B=9E=E6=89=A7=E6=80=BB=E9=A2=9D=E2=89=A0=E5=B7=B2?=
 =?UTF-8?q?=E4=BB=98=E9=87=91=E9=A2=9D=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Admin/PlatformOrderController.php         |  19 ++++
 .../admin/platform_orders/index.blade.php     |   9 ++
 ...atformOrderReconcileMismatchFilterTest.php | 102 ++++++++++++++++++
 tests/Feature/AdminPlatformOrderTest.php      |   1 +
 4 files changed, 131 insertions(+)
 create mode 100644 tests/Feature/AdminPlatformOrderReconcileMismatchFilterTest.php

diff --git a/app/Http/Controllers/Admin/PlatformOrderController.php b/app/Http/Controllers/Admin/PlatformOrderController.php
index 1c3ce10..ca25f0b 100644
--- a/app/Http/Controllers/Admin/PlatformOrderController.php
+++ b/app/Http/Controllers/Admin/PlatformOrderController.php
@@ -136,6 +136,8 @@ class PlatformOrderController extends Controller
             'batch_synced_24h' => (string) $request->query('batch_synced_24h', ''),
             // 只看最近 24 小时批量“仅标记为已生效”过的订单（可治理追踪）
             'batch_mark_activated_24h' => (string) $request->query('batch_mark_activated_24h', ''),
+            // 只看“对账不一致”的订单（粗版）：meta.payment_summary.total_amount 与 paid_amount 不一致
+            'reconcile_mismatch' => (string) $request->query('reconcile_mismatch', ''),
         ];
 
 
@@ -558,6 +560,8 @@ class PlatformOrderController extends Controller
             'batch_synced_24h' => (string) $request->query('batch_synced_24h', ''),
             // 只看最近 24 小时批量“仅标记为已生效”过的订单（可治理追踪）
             'batch_mark_activated_24h' => (string) $request->query('batch_mark_activated_24h', ''),
+            // 只看“对账不一致”的订单（粗版）：meta.payment_summary.total_amount 与 paid_amount 不一致
+            'reconcile_mismatch' => (string) $request->query('reconcile_mismatch', ''),
         ];
 
 
@@ -1062,6 +1066,21 @@ class PlatformOrderController extends Controller
                 } else {
                     $builder->whereRaw("JSON_UNQUOTE(JSON_EXTRACT(meta, '$.batch_mark_activated.at')) >= ?", [$since]);
                 }
+            })
+            ->when(($filters['reconcile_mismatch'] ?? '') !== '', function (Builder $builder) {
+                // 只看“对账不一致”的订单（粗版）：支付回执总额（优先 payment_summary.total_amount）与订单 paid_amount 不一致
+                // 注意：该筛选需要读取 JSON 字段，MySQL/SQLite 写法略有差异。
+                $driver = $builder->getQuery()->getConnection()->getDriverName();
+
+                if ($driver === 'sqlite') {
+                    // sqlite 下 JSON_EXTRACT 直接返回标量（数值或字符串），这里用“按分”取整避免浮点误差导致 0.01 边界不稳定
+                    $builder->whereRaw("JSON_EXTRACT(meta, '$.payment_summary.total_amount') IS NOT NULL")
+                        ->whereRaw("ABS(ROUND(CAST(JSON_EXTRACT(meta, '$.payment_summary.total_amount') AS REAL) * 100) - ROUND(paid_amount * 100)) >= 1");
+                } else {
+                    // MySQL 下 JSON_EXTRACT 返回 JSON，需要 JSON_UNQUOTE 再 cast；同样按分取整避免浮点误差
+                    $builder->whereRaw("JSON_EXTRACT(meta, '$.payment_summary.total_amount') IS NOT NULL")
+                        ->whereRaw("ABS(ROUND(CAST(JSON_UNQUOTE(JSON_EXTRACT(meta, '$.payment_summary.total_amount')) AS DECIMAL(12,2)) * 100) - ROUND(paid_amount * 100)) >= 1");
+                }
             });
     }
 
diff --git a/resources/views/admin/platform_orders/index.blade.php b/resources/views/admin/platform_orders/index.blade.php
index 52152a2..07d6512 100644
--- a/resources/views/admin/platform_orders/index.blade.php
+++ b/resources/views/admin/platform_orders/index.blade.php
@@ -82,6 +82,10 @@
             <input type="checkbox" name="batch_mark_activated_24h" value="1" @checked(($filters['batch_mark_activated_24h'] ?? '') === '1')>
             <span>最近24小时批量生效过</span>
         </label>
+        <label class="form-inline-row">
+            <input type="checkbox" name="reconcile_mismatch" value="1" @checked(($filters['reconcile_mismatch'] ?? '') === '1')>
+            <span>只看对账不一致（回执总额≠已付金额）</span>
+        </label>
         <input type="text" name="keyword" placeholder="关键词：订单号/站点/订阅号" value="{{ $filters['keyword'] ?? '' }}">
         <div>
             <button type="submit">应用筛选</button>
@@ -176,6 +180,7 @@
         <input type="hidden" name="batch_synced_24h" value="{{ $filters['batch_synced_24h'] ?? '' }}">
         <input type="hidden" name="batch_mark_activated_24h" value="{{ $filters['batch_mark_activated_24h'] ?? '' }}">
         <input type="hidden" name="keyword" value="{{ $filters['keyword'] ?? '' }}">
+        <input type="hidden" name="reconcile_mismatch" value="{{ $filters['reconcile_mismatch'] ?? '' }}">
 
         <label class="form-inline-row mb-8">
             <input type="checkbox" name="include_meta" value="1">
@@ -200,6 +205,7 @@
         <input type="hidden" name="batch_synced_24h" value="{{ $filters['batch_synced_24h'] ?? '' }}">
         <input type="hidden" name="batch_mark_activated_24h" value="{{ $filters['batch_mark_activated_24h'] ?? '' }}">
         <input type="hidden" name="keyword" value="{{ $filters['keyword'] ?? '' }}">
+        <input type="hidden" name="reconcile_mismatch" value="{{ $filters['reconcile_mismatch'] ?? '' }}">
 
         <label class="muted form-inline-row mb-8">
             <span>本次最多处理</span>
@@ -226,6 +232,7 @@
         <input type="hidden" name="batch_synced_24h" value="{{ $filters['batch_synced_24h'] ?? '' }}">
         <input type="hidden" name="batch_mark_activated_24h" value="{{ $filters['batch_mark_activated_24h'] ?? '' }}">
         <input type="hidden" name="keyword" value="{{ $filters['keyword'] ?? '' }}">
+        <input type="hidden" name="reconcile_mismatch" value="{{ $filters['reconcile_mismatch'] ?? '' }}">
         <label class="muted form-inline-row mb-8">
             <span>确认输入</span>
             <input type="text" name="confirm" placeholder="YES" class="w-140">
@@ -251,6 +258,7 @@
         <input type="hidden" name="synced_only" value="{{ $filters['synced_only'] ?? '' }}">
         <input type="hidden" name="sync_status" value="{{ $filters['sync_status'] ?? '' }}">
         <input type="hidden" name="keyword" value="{{ $filters['keyword'] ?? '' }}">
+        <input type="hidden" name="reconcile_mismatch" value="{{ $filters['reconcile_mismatch'] ?? '' }}">
 
         <label class="muted form-inline-row mb-8">
             <span>本次最多处理</span>
@@ -293,6 +301,7 @@
         <input type="hidden" name="batch_synced_24h" value="{{ $filters['batch_synced_24h'] ?? '' }}">
         <input type="hidden" name="batch_mark_activated_24h" value="{{ $filters['batch_mark_activated_24h'] ?? '' }}">
         <input type="hidden" name="keyword" value="{{ $filters['keyword'] ?? '' }}">
+        <input type="hidden" name="reconcile_mismatch" value="{{ $filters['reconcile_mismatch'] ?? '' }}">
         <button type="submit">清除当前筛选范围的失败标记</button>
     </form>
 
diff --git a/tests/Feature/AdminPlatformOrderReconcileMismatchFilterTest.php b/tests/Feature/AdminPlatformOrderReconcileMismatchFilterTest.php
new file mode 100644
index 0000000..1878436
--- /dev/null
+++ b/tests/Feature/AdminPlatformOrderReconcileMismatchFilterTest.php
@@ -0,0 +1,102 @@
+<?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 AdminPlatformOrderReconcileMismatchFilterTest 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_can_filter_reconcile_mismatch(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $merchant = Merchant::query()->firstOrFail();
+        $plan = Plan::query()->create([
+            'code' => 'reconcile_mismatch_test',
+            'name' => '对账不一致筛选测试套餐',
+            'billing_cycle' => 'monthly',
+            'price' => 10,
+            'list_price' => 10,
+            'status' => 'active',
+            'sort' => 10,
+            'published_at' => now(),
+        ]);
+
+        // 不一致：paid_amount=10，但 payment_summary.total_amount=9.99
+        PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'order_no' => 'PO_RECON_MISMATCH_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(),
+            'paid_at' => now(),
+            'activated_at' => now(),
+            'meta' => [
+                'payment_summary' => [
+                    'count' => 1,
+                    'total_amount' => 9.99,
+                    'last_at' => now()->toDateTimeString(),
+                    'last_amount' => 9.99,
+                    'last_channel' => 'bank',
+                ],
+            ],
+        ]);
+
+        // 一致：paid_amount=10，payment_summary.total_amount=10
+        PlatformOrder::query()->create([
+            'merchant_id' => $merchant->id,
+            'plan_id' => $plan->id,
+            'order_no' => 'PO_RECON_MATCH_0002',
+            '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(),
+            'paid_at' => now(),
+            'activated_at' => now(),
+            'meta' => [
+                'payment_summary' => [
+                    'count' => 1,
+                    'total_amount' => 10.00,
+                    'last_at' => now()->toDateTimeString(),
+                    'last_amount' => 10.00,
+                    'last_channel' => 'bank',
+                ],
+            ],
+        ]);
+
+        $this->get('/admin/platform-orders?reconcile_mismatch=1')
+            ->assertOk()
+            ->assertSee('PO_RECON_MISMATCH_0001')
+            ->assertDontSee('PO_RECON_MATCH_0002');
+    }
+}
diff --git a/tests/Feature/AdminPlatformOrderTest.php b/tests/Feature/AdminPlatformOrderTest.php
index d4e9bdf..75d707b 100644
--- a/tests/Feature/AdminPlatformOrderTest.php
+++ b/tests/Feature/AdminPlatformOrderTest.php
@@ -41,6 +41,7 @@ class AdminPlatformOrderTest extends TestCase
             ->assertSee('退款总额')
             ->assertSee('有回执订单 / 回执总额')
             ->assertSee('对账差额')
+            ->assertSee('只看对账不一致')
             ->assertSee('快捷筛选')
             ->assertSee('待支付')
             ->assertSee('待生效')