refactor：拆分 API 路由与请求校验，统一 final 类和代码风格

app/Console/Commands/LotteryDrawTickCommand.php

@@ -2,10 +2,10 @@
 
 namespace App\Console\Commands;
 
-use App\Services\Draw\DrawTickService;
 use Illuminate\Console\Command;
+use App\Services\Draw\DrawTickService;
 
-class LotteryDrawTickCommand extends Command
+final class LotteryDrawTickCommand extends Command
 {
     protected $signature = 'lottery:draw-tick';
 

app/Console/Commands/LotteryHallCountdownCommand.php

@@ -2,10 +2,10 @@
 
 namespace App\Console\Commands;
 
-use App\Services\Draw\LotteryHallRealtimeBroadcaster;
 use Illuminate\Console\Command;
+use App\Services\Draw\LotteryHallRealtimeBroadcaster;
 
-class LotteryHallCountdownCommand extends Command
+final class LotteryHallCountdownCommand extends Command
 {
     protected $signature = 'lottery:hall-countdown';
 

app/Events/DrawCountdownBroadcast.php

@@ -3,13 +3,13 @@
 namespace App\Events;
 
 use Illuminate\Broadcasting\Channel;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Broadcasting\InteractsWithSockets;
 use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
-use Illuminate\Foundation\Events\Dispatchable;
-use Illuminate\Queue\SerializesModels;
 
 /** 界面文档 §2.1：`draw.countdown` */
-class DrawCountdownBroadcast implements ShouldBroadcastNow
+final class DrawCountdownBroadcast implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 

app/Events/DrawResultPublishedBroadcast.php

@@ -3,13 +3,13 @@
 namespace App\Events;
 
 use Illuminate\Broadcasting\Channel;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Broadcasting\InteractsWithSockets;
 use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
-use Illuminate\Foundation\Events\Dispatchable;
-use Illuminate\Queue\SerializesModels;
 
 /** 界面文档 §2.1：`result.published` */
-class DrawResultPublishedBroadcast implements ShouldBroadcastNow
+final class DrawResultPublishedBroadcast implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 

app/Events/DrawStatusChangeBroadcast.php

@@ -3,13 +3,13 @@
 namespace App\Events;
 
 use Illuminate\Broadcasting\Channel;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Broadcasting\InteractsWithSockets;
 use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
-use Illuminate\Foundation\Events\Dispatchable;
-use Illuminate\Queue\SerializesModels;
 
 /** 界面文档 §2.1：`draw.status_change` */
-class DrawStatusChangeBroadcast implements ShouldBroadcastNow
+final class DrawStatusChangeBroadcast implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 

app/Exceptions/PlayerAuthenticationException.php

@@ -2,8 +2,8 @@
 
 namespace App\Exceptions;
 
-use App\Lottery\ErrorCode;
 use RuntimeException;
+use App\Lottery\ErrorCode;
 
 /**
  * 玩家端 Bearer 鉴权失败时抛出，由 EnsurePlayerApi 捕获并转为 JSON。

app/Exceptions/WalletOperationException.php

@@ -2,9 +2,9 @@
 
 namespace App\Exceptions;
 
+use RuntimeException;
 use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
-use RuntimeException;
 
 /**
  * 玩家钱包划转等业务失败时抛出，由控制器捕获并转为 {@see ApiResponse} JSON。

app/Http/Controllers/Api/V1/Admin/Audit/AuditLogIndexController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Audit;
 
-use App\Http\Controllers\Controller;
 use App\Models\AuditLog;
+use Illuminate\Http\Request;
 use App\Support\AdminApiList;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/audit-logs — 运营/客服查询审计留痕。

app/Http/Controllers/Api/V1/Admin/Auth/CaptchaController.php

@@ -2,9 +2,9 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Auth;
 
-use App\Services\AdminCaptchaService;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Services\AdminCaptchaService;
 
 /**
  * GET /api/v1/admin/auth/captcha

app/Http/Controllers/Api/V1/Admin/Auth/LoginController.php

@@ -2,38 +2,28 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Auth;
 
-use App\Lottery\ErrorCode;
 use App\Models\AdminUser;
-use App\Services\AdminCaptchaService;
+use App\Lottery\ErrorCode;
+use Illuminate\Support\Str;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
 use Illuminate\Support\Facades\Hash;
-use Illuminate\Support\Str;
+use App\Services\AdminCaptchaService;
+use App\Http\Requests\Admin\AdminLoginRequest;
 
 /**
  * POST /api/v1/admin/auth/login
  *
  * Body: account（登录账号，与 username 对应，ASCII 仅存小写比对）、password、captcha_key、captcha_code。
  */
-final class LoginController
+final class LoginController extends Controller
 {
-    public function __invoke(Request $request, AdminCaptchaService $captcha): JsonResponse
+    public function __invoke(AdminLoginRequest $request, AdminCaptchaService $captcha): JsonResponse
     {
         $locale = $request->lotteryLocale();
 
-        /** @var array{account:string,password:string,captcha_key:string,captcha_code:string} $data */
-        $data = validator($request->all(), [
-            'account' => ['required', 'string', 'min:2', 'max:64', 'regex:/^[a-zA-Z0-9._-]+$/u'],
-            'password' => ['required', 'string', 'max:256'],
-            'captcha_key' => ['required', 'string', 'uuid'],
-            'captcha_code' => ['required', 'string', 'max:32'],
-        ], [], [
-            'account' => 'account',
-            'password' => 'password',
-            'captcha_key' => 'captcha_key',
-            'captcha_code' => 'captcha_code',
-        ])->validate();
+        $data = $request->validated();
 
         if (! $captcha->verify($data['captcha_key'], $data['captcha_code'])) {
             return ApiResponse::error(

app/Http/Controllers/Api/V1/Admin/Config/OddsItemsReplaceController.php

@@ -2,17 +2,17 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ConfigVersionStatus;
-use App\Lottery\ErrorCode;
 use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
 use App\Models\OddsVersion;
-use App\Services\Config\OddsStreamService;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Validation\Rule;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Lottery\ConfigVersionStatus;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\OddsStreamService;
 
 /** PUT /api/v1/admin/config/odds-versions/{id}/items */
 final class OddsItemsReplaceController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/OddsVersionIndexController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
 use App\Models\OddsVersion;
-use App\Services\Config\OddsStreamService;
-use App\Support\AdminApiList;
-use App\Support\AdminConfigPresenter;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\OddsStreamService;
 
 /** GET /api/v1/admin/config/odds-versions */
 final class OddsVersionIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/OddsVersionPublishController.php

@@ -2,16 +2,16 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Models\OddsVersion;
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Lottery\ConfigVersionStatus;
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
-use App\Models\OddsVersion;
-use App\Services\Config\OddsStreamService;
 use App\Support\AdminConfigPresenter;
-use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Services\Config\OddsStreamService;
 
 /** POST /api/v1/admin/config/odds-versions/{id}/publish */
 final class OddsVersionPublishController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/OddsVersionShowController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
 use App\Models\OddsVersion;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
 
 /** GET /api/v1/admin/config/odds-versions/{id} */
 final class OddsVersionShowController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/OddsVersionStoreController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Services\Config\OddsStreamService;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\OddsStreamService;
 
 /** POST /api/v1/admin/config/odds-versions */
 final class OddsVersionStoreController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/PlayConfigItemsReplaceController.php

@@ -2,17 +2,17 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ConfigVersionStatus;
-use App\Lottery\ErrorCode;
 use App\Models\AdminUser;
-use App\Models\PlayConfigVersion;
-use App\Services\Config\PlayConfigStreamService;
-use App\Support\AdminConfigPresenter;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Validation\Rule;
+use App\Models\PlayConfigVersion;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Lottery\ConfigVersionStatus;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\PlayConfigStreamService;
 
 /** PUT /api/v1/admin/config/play-versions/{id}/items */
 final class PlayConfigItemsReplaceController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionIndexController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
-use App\Models\PlayConfigVersion;
-use App\Services\Config\PlayConfigStreamService;
-use App\Support\AdminApiList;
-use App\Support\AdminConfigPresenter;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use App\Models\PlayConfigVersion;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\PlayConfigStreamService;
 
 /** GET /api/v1/admin/config/play-versions */
 final class PlayConfigVersionIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionPublishController.php

@@ -2,16 +2,16 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use App\Models\PlayConfigVersion;
+use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Lottery\ConfigVersionStatus;
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
-use App\Models\PlayConfigVersion;
-use App\Services\Config\PlayConfigStreamService;
 use App\Support\AdminConfigPresenter;
-use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Services\Config\PlayConfigStreamService;
 
 /** POST /api/v1/admin/config/play-versions/{id}/publish */
 final class PlayConfigVersionPublishController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionShowController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
-use App\Models\PlayConfigVersion;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
+use App\Models\PlayConfigVersion;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
 
 /** GET /api/v1/admin/config/play-versions/{id} */
 final class PlayConfigVersionShowController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionStoreController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Services\Config\PlayConfigStreamService;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\PlayConfigStreamService;
 
 /** POST /api/v1/admin/config/play-versions — 新建草稿（默认克隆当前 active，若无则按 play_types 生成）。 */
 final class PlayConfigVersionStoreController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/RiskCapItemsReplaceController.php

@@ -2,16 +2,16 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use App\Models\RiskCapVersion;
+use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Lottery\ConfigVersionStatus;
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
-use App\Models\RiskCapVersion;
-use App\Services\Config\RiskCapStreamService;
 use App\Support\AdminConfigPresenter;
-use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Services\Config\RiskCapStreamService;
 
 /** PUT /api/v1/admin/config/risk-cap-versions/{id}/items */
 final class RiskCapItemsReplaceController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionIndexController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
-use App\Models\RiskCapVersion;
-use App\Services\Config\RiskCapStreamService;
-use App\Support\AdminApiList;
-use App\Support\AdminConfigPresenter;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use App\Models\RiskCapVersion;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\RiskCapStreamService;
 
 /** GET /api/v1/admin/config/risk-cap-versions */
 final class RiskCapVersionIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionPublishController.php

@@ -2,16 +2,16 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use App\Models\RiskCapVersion;
+use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Lottery\ConfigVersionStatus;
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
-use App\Models\RiskCapVersion;
-use App\Services\Config\RiskCapStreamService;
 use App\Support\AdminConfigPresenter;
-use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Services\Config\RiskCapStreamService;
 
 /** POST /api/v1/admin/config/risk-cap-versions/{id}/publish */
 final class RiskCapVersionPublishController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionShowController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
-use App\Models\RiskCapVersion;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
+use App\Models\RiskCapVersion;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
 
 /** GET /api/v1/admin/config/risk-cap-versions/{id} */
 final class RiskCapVersionShowController extends Controller

app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionStoreController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Config;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Services\Config\RiskCapStreamService;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
+use App\Services\Config\RiskCapStreamService;
 
 /** POST /api/v1/admin/config/risk-cap-versions */
 final class RiskCapVersionStoreController extends Controller

app/Http/Controllers/Api/V1/Admin/Dashboard/AdminDashboardController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Dashboard;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ErrorCode;
 use App\Models\AdminUser;
-use App\Services\Admin\AdminDashboardSnapshotBuilder;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Admin\AdminDashboardSnapshotBuilder;
 
 /**
  * GET /api/v1/admin/dashboard — 首页仪表盘聚合数据（需登录；按权限返回子块）。

app/Http/Controllers/Api/V1/Admin/Draw/AdminDrawFinanceSummaryController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Draw;
 
-use App\Http\Controllers\Controller;
 use App\Models\Draw;
-use App\Models\SettlementBatch;
 use App\Models\TicketItem;
 use App\Models\TicketOrder;
 use App\Support\ApiResponse;
+use App\Models\SettlementBatch;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/draws/{draw}/finance-summary — 单期投注/派彩汇总（客服/财务视角，PRD §15.4）。

app/Http/Controllers/Api/V1/Admin/Draw/AdminDrawIndexController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Draw;
 
-use App\Http\Controllers\Controller;
-use App\Models\Draw;
-use App\Support\AdminApiList;
 use Carbon\Carbon;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
-use Illuminate\Http\JsonResponse;
+use App\Models\Draw;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /**
  * GET /api/v1/admin/draws — 期号列表。

app/Http/Controllers/Api/V1/Admin/Draw/AdminDrawResultBatchesIndexController.php

@@ -2,12 +2,12 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Draw;
 
-use App\Http\Controllers\Controller;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
 use App\Support\ApiResponse;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/draws/{draw}/result-batches — 开奖批次与号码（审核/结果核对）。

app/Http/Controllers/Api/V1/Admin/Draw/AdminDrawShowController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Draw;
 
+use Carbon\Carbon;
+use App\Models\Draw;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Lottery\DrawResultBatchStatus;
-use App\Models\Draw;
 use App\Services\Draw\DrawHallSnapshotBuilder;
-use App\Support\ApiResponse;
-use Carbon\Carbon;
-use Illuminate\Http\JsonResponse;
 
 /**
  * GET /api/v1/admin/draws/{draw} — 当期状态明细（后台查看 DB 为准 + 大厅展示态预览）。

app/Http/Controllers/Api/V1/Admin/Draw/DrawResultBatchPublishController.php

@@ -2,20 +2,20 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Draw;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Services\Draw\DrawPublishService;
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Models\DrawResultBatch;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawPublishService;
 
 /**
  * POST /api/v1/admin/draws/{draw}/result-batches/{batch}/publish — 人工审核发布 RNG 批次。
  */
-class DrawResultBatchPublishController extends Controller
+final class DrawResultBatchPublishController extends Controller
 {
     public function __construct(
         private readonly DrawPublishService $publishService,

app/Http/Controllers/Api/V1/Admin/Draw/DrawSettlementRunController.php

@@ -2,14 +2,14 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Draw;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
 use App\Models\Draw;
-use App\Services\Settlement\SettlementOrchestrator;
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Settlement\SettlementOrchestrator;
 
 /**
  * POST /api/v1/admin/draws/{draw}/settlement/run — 对 `settling` 期号执行结算（可关自动结算时手工触发）。

app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotContributionIndexController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
 
-use App\Http\Controllers\Controller;
-use App\Models\JackpotContribution;
+use Illuminate\Http\Request;
 use App\Support\AdminApiList;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Models\JackpotContribution;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/jackpot/contributions — Jackpot 蓄水流水。

app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPayoutLogIndexController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
 
-use App\Http\Controllers\Controller;
-use App\Models\JackpotPayoutLog;
-use App\Support\AdminApiList;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use App\Models\JackpotPayoutLog;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/jackpot/payout-logs — Jackpot 派彩（爆池）记录。

app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolIndexController.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
 
-use App\Http\Controllers\Controller;
 use App\Models\JackpotPool;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/jackpot/pools — Jackpot 奖池配置列表。

app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolUpdateController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
 
-use App\Http\Controllers\Controller;
 use App\Models\JackpotPool;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * PUT /api/v1/admin/jackpot/pools/{pool} — 更新奖池运营参数（蓄水比例、阈值等）。

app/Http/Controllers/Api/V1/Admin/PingController.php

@@ -2,15 +2,15 @@
 
 namespace App\Http\Controllers\Api\V1\Admin;
 
-use App\Http\Controllers\Controller;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * Bearer Token 必填（{@see EnsureAdminApi} + Sanctum）；确认 `/api/v1/admin` 鉴权链路可达。
  * 路由：GET /api/v1/admin/ping
  */
-class PingController extends Controller
+final class PingController extends Controller
 {
     public function __invoke(): JsonResponse
     {

app/Http/Controllers/Api/V1/Admin/PlayTypeIndexController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin;
 
-use App\Http\Controllers\Controller;
 use App\Models\PlayType;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
 
 /** GET /api/v1/admin/play-types */
 final class PlayTypeIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/PlayTypePatchController.php

@@ -2,12 +2,12 @@
 
 namespace App\Http\Controllers\Api\V1\Admin;
 
-use App\Http\Controllers\Controller;
 use App\Models\PlayType;
-use App\Support\AdminConfigPresenter;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminConfigPresenter;
 
 /** PATCH /api/v1/admin/play-types/{play_code} — 主目录层开关与展示名（不等同于版本化 items）。 */
 final class PlayTypePatchController extends Controller

app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerTicketItemsIndexController.php

@@ -2,12 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Player;
 
-use App\Http\Controllers\Controller;
 use App\Models\Player;
 use App\Models\TicketItem;
 use App\Support\ApiResponse;
+use App\Support\PaginationTrait;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Admin\AdminPlayerTicketItemsRequest;
 
 /**
  * GET /api/v1/admin/players/{player}/ticket-items — 客服/财务按玩家查注单（PRD §15.4）。
@@ -16,17 +17,16 @@ use Illuminate\Http\Request;
  */
 final class AdminPlayerTicketItemsIndexController extends Controller
 {
-    public function __invoke(Request $request, Player $player): JsonResponse
-    {
-        $validated = validator($request->query(), [
-            'page' => ['sometimes', 'integer', 'min:1'],
-            'per_page' => ['sometimes', 'integer', 'min:1', 'max:50'],
-            'draw_no' => ['sometimes', 'nullable', 'string', 'max:32'],
-        ])->validate();
+    use PaginationTrait;
 
-        $perPage = max(1, min(50, (int) ($validated['per_page'] ?? 20)));
-        $page = max(1, (int) ($validated['page'] ?? 1));
-        $drawNo = isset($validated['draw_no']) ? trim((string) $validated['draw_no']) : '';
+    public function __invoke(AdminPlayerTicketItemsRequest $request, Player $player): JsonResponse
+    {
+        $perPage = $this->perPage($request, 'per_page', 20, 50);
+        $page = $this->page($request);
+        $drawNo = $request->validated('draw_no');
+        if (is_string($drawNo)) {
+            $drawNo = trim($drawNo);
+        }
 
         $query = TicketItem::query()
             ->where('ticket_items.player_id', $player->id)

app/Http/Controllers/Api/V1/Admin/Player/PlayerWalletShowController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Player;
 
-use App\Http\Controllers\Controller;
 use App\Models\Player;
 use App\Models\PlayerWallet;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * 后台：按玩家查询钱包余额（`player_wallets` 全币种）。

app/Http/Controllers/Api/V1/Admin/Reconcile/ReconcileItemIndexController.php

@@ -2,12 +2,12 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Reconcile;
 
-use App\Http\Controllers\Controller;
-use App\Models\ReconcileItem;
 use App\Models\ReconcileJob;
+use Illuminate\Http\Request;
+use App\Models\ReconcileItem;
 use App\Support\AdminApiList;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
 
 /** GET /api/v1/admin/reconcile-jobs/{reconcile_job}/items */
 final class ReconcileItemIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/Reconcile/ReconcileJobIndexController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Reconcile;
 
-use App\Http\Controllers\Controller;
 use App\Models\ReconcileJob;
+use Illuminate\Http\Request;
 use App\Support\AdminApiList;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
 
 /** GET /api/v1/admin/reconcile-jobs */
 final class ReconcileJobIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/Reconcile/ReconcileJobShowController.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Reconcile;
 
-use App\Http\Controllers\Controller;
 use App\Models\ReconcileJob;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /** GET /api/v1/admin/reconcile-jobs/{reconcile_job} */
 final class ReconcileJobShowController extends Controller

app/Http/Controllers/Api/V1/Admin/Reconcile/ReconcileJobStoreController.php

@@ -2,32 +2,23 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Reconcile;
 
-use App\Http\Controllers\Controller;
-use App\Models\AdminUser;
-use App\Services\Admin\AdminReconcileJobService;
-use App\Support\ApiResponse;
 use Carbon\Carbon;
+use App\Models\AdminUser;
+use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Services\Admin\AdminReconcileJobService;
+use App\Http\Requests\Admin\ReconcileJobStoreRequest;
 
 /** POST /api/v1/admin/reconcile-jobs */
 final class ReconcileJobStoreController extends Controller
 {
-    public function __invoke(Request $request, AdminReconcileJobService $service): JsonResponse
+    public function __invoke(ReconcileJobStoreRequest $request, AdminReconcileJobService $service): JsonResponse
     {
         /** @var AdminUser $admin */
         $admin = $request->lotteryAdmin();
 
-        $data = validator($request->all(), [
-            'reconcile_type' => ['required', 'string', 'max:32'],
-            'period_start' => ['nullable', 'date'],
-            'period_end' => ['nullable', 'date', 'after_or_equal:period_start'],
-            'items' => ['nullable', 'array', 'max:5000'],
-            'items.*.side_a_ref' => ['nullable', 'string', 'max:128'],
-            'items.*.side_b_ref' => ['nullable', 'string', 'max:128'],
-            'items.*.difference_amount' => ['nullable', 'integer'],
-            'items.*.status' => ['nullable', 'string', 'max:32'],
-        ])->validate();
+        $data = $request->validated();
 
         $job = $service->createJob(
             $admin,

app/Http/Controllers/Api/V1/Admin/Reports/ReportJobIndexController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Reports;
 
-use App\Http\Controllers\Controller;
 use App\Models\ReportJob;
+use Illuminate\Http\Request;
 use App\Support\AdminApiList;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
 
 /** GET /api/v1/admin/report-jobs */
 final class ReportJobIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/Reports/ReportJobShowController.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Reports;
 
-use App\Http\Controllers\Controller;
 use App\Models\ReportJob;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /** GET /api/v1/admin/report-jobs/{report_job} */
 final class ReportJobShowController extends Controller

app/Http/Controllers/Api/V1/Admin/Reports/ReportJobStoreController.php

@@ -2,26 +2,22 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Reports;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Services\Admin\AdminReportJobService;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Services\Admin\AdminReportJobService;
+use App\Http\Requests\Admin\ReportJobStoreRequest;
 
 /** POST /api/v1/admin/report-jobs */
 final class ReportJobStoreController extends Controller
 {
-    public function __invoke(Request $request, AdminReportJobService $service): JsonResponse
+    public function __invoke(ReportJobStoreRequest $request, AdminReportJobService $service): JsonResponse
     {
         /** @var AdminUser $admin */
         $admin = $request->lotteryAdmin();
 
-        $data = validator($request->all(), [
-            'report_type' => ['required', 'string', 'max:64'],
-            'export_format' => ['sometimes', 'string', 'in:csv,xlsx'],
-            'filter_json' => ['nullable', 'array'],
-        ])->validate();
+        $data = $request->validated();
 
         $job = $service->enqueue(
             $admin,

app/Http/Controllers/Api/V1/Admin/Risk/AdminRiskPoolIndexController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Risk;
 
-use App\Http\Controllers\Controller;
 use App\Models\Draw;
 use App\Models\RiskPool;
-use App\Support\AdminApiList;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /**
  * GET /api/v1/admin/draws/{draw}/risk-pools — 按期号分页查询赔付池事实（售罄筛选、排序）。

app/Http/Controllers/Api/V1/Admin/Risk/AdminRiskPoolLockLogIndexController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Risk;
 
-use App\Http\Controllers\Controller;
 use App\Models\Draw;
-use App\Models\RiskPoolLockLog;
-use App\Support\AdminApiList;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use App\Models\RiskPoolLockLog;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /**
  * GET /api/v1/admin/draws/{draw}/risk-pool-lock-logs — 风险池占用/释放流水（审计与监控）。

app/Http/Controllers/Api/V1/Admin/Risk/AdminRiskPoolShowController.php

@@ -21,7 +21,12 @@ final class AdminRiskPoolShowController extends Controller
     public function __invoke(Request $request, Draw $draw, string $number_4d): JsonResponse
     {
         if (preg_match('/^[0-9]{4}$/', $number_4d) !== 1) {
-            return ApiResponse::error('normalized_number 须为 4 位数字', ErrorCode::ValidationFailed->value, null, 422);
+            return ApiResponse::error(
+                trans('api.validation_failed', [], $request->lotteryLocale()),
+                ErrorCode::ValidationFailed->value,
+                null,
+                422,
+            );
         }
 
         $pool = RiskPool::query()
@@ -30,7 +35,12 @@ final class AdminRiskPoolShowController extends Controller
             ->first();
 
         if ($pool === null) {
-            return ApiResponse::error('该期尚无此号码的风险池记录', ErrorCode::NotFound->value, null, 404);
+            return ApiResponse::error(
+                trans('api.not_found', [], $request->lotteryLocale()),
+                ErrorCode::NotFound->value,
+                null,
+                404,
+            );
         }
 
         $p = AdminApiList::readPaging($request, 20, AdminApiList::MAX_PER_PAGE);

app/Http/Controllers/Api/V1/Admin/Settlement/AdminSettlementBatchDetailsController.php

@@ -2,12 +2,12 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Settlement;
 
-use App\Http\Controllers\Controller;
-use App\Models\SettlementBatch;
-use App\Models\TicketSettlementDetail;
-use App\Support\AdminApiList;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use App\Models\SettlementBatch;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Models\TicketSettlementDetail;
 
 /**
  * GET /api/v1/admin/settlement-batches/{batch}/details — 该批次下注单结算明细分页。

app/Http/Controllers/Api/V1/Admin/Settlement/AdminSettlementBatchIndexController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Settlement;
 
-use App\Http\Controllers\Controller;
-use App\Models\SettlementBatch;
-use App\Support\AdminApiList;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use App\Models\SettlementBatch;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/settlement-batches — 结算批次分页列表。

app/Http/Controllers/Api/V1/Admin/Settlement/AdminSettlementBatchShowController.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Settlement;
 
-use App\Http\Controllers\Controller;
-use App\Models\SettlementBatch;
 use App\Support\ApiResponse;
+use App\Models\SettlementBatch;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * GET /api/v1/admin/settlement-batches/{batch} — 单批次摘要。

app/Http/Controllers/Api/V1/Admin/User/AdminPermissionCatalogController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminRole;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\DB;
+use App\Http\Controllers\Controller;
 
 /** GET /api/v1/admin/admin-user-permission-catalog */
 final class AdminPermissionCatalogController extends Controller

app/Http/Controllers/Api/V1/Admin/User/AdminUserDestroyController.php

@@ -2,14 +2,14 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ErrorCode;
 use App\Models\AdminUser;
-use App\Services\AuditLogger;
-use App\Support\AdminUserApiPresenter;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Services\AuditLogger;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminUserApiPresenter;
 
 /** DELETE /api/v1/admin/admin-users/{admin_user} */
 final class AdminUserDestroyController extends Controller

app/Http/Controllers/Api/V1/Admin/User/AdminUserIndexController.php

@@ -2,12 +2,12 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Support\AdminApiList;
-use App\Support\AdminUserApiPresenter;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\AdminApiList;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminUserApiPresenter;
 
 /** GET /api/v1/admin/admin-users */
 final class AdminUserIndexController extends Controller

app/Http/Controllers/Api/V1/Admin/User/AdminUserPermissionSyncController.php

@@ -2,27 +2,20 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Support\AdminPermissionBridge;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
-use Illuminate\Validation\Rule;
+use App\Http\Controllers\Controller;
+use App\Support\AdminPermissionBridge;
+use App\Http\Requests\Admin\AdminUserPermissionSyncRequest;
 
 /** PUT /api/v1/admin/admin-users/{admin_user}/permissions */
 final class AdminUserPermissionSyncController extends Controller
 {
-    public function __invoke(Request $request, AdminUser $admin_user): JsonResponse
+    public function __invoke(AdminUserPermissionSyncRequest $request, AdminUser $admin_user): JsonResponse
     {
-        /** @var array{permission_slugs:list<string>} $data */
-        $data = validator($request->all(), [
-            'permission_slugs' => ['required', 'array'],
-            'permission_slugs.*' => ['string', 'max:128', 'distinct', Rule::in(AdminPermissionBridge::allLegacySlugs())],
-        ])->validate();
-
-        $slugs = array_values(array_unique($data['permission_slugs']));
+        $slugs = array_values(array_unique($request->validated('permissions')));
         $siteId = AdminUser::defaultAdminSiteId();
 
         $codes = [];

app/Http/Controllers/Api/V1/Admin/User/AdminUserRoleSyncController.php

@@ -2,25 +2,18 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
-use Illuminate\Validation\Rule;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Admin\AdminUserRoleSyncRequest;
 
 /** PUT /api/v1/admin/admin-users/{admin_user}/roles */
 final class AdminUserRoleSyncController extends Controller
 {
-    public function __invoke(Request $request, AdminUser $admin_user): JsonResponse
+    public function __invoke(AdminUserRoleSyncRequest $request, AdminUser $admin_user): JsonResponse
     {
-        /** @var array{role_slugs:list<string>} $data */
-        $data = validator($request->all(), [
-            'role_slugs' => ['required', 'array'],
-            'role_slugs.*' => ['string', 'max:64', 'distinct', Rule::exists('admin_roles', 'slug')],
-        ])->validate();
-
-        $slugs = array_values(array_unique($data['role_slugs']));
+        $slugs = array_values(array_unique($request->validated('role_slugs')));
         $admin_user->syncRoleSlugsForDefaultSite($slugs);
 
         $admin_user->load('roles');

app/Http/Controllers/Api/V1/Admin/User/AdminUserShowController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Support\AdminUserApiPresenter;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminUserApiPresenter;
 
 /** GET /api/v1/admin/admin-users/{admin_user} */
 final class AdminUserShowController extends Controller

app/Http/Controllers/Api/V1/Admin/User/AdminUserStoreController.php

@@ -2,55 +2,40 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Services\AuditLogger;
-use App\Support\AdminUserApiPresenter;
 use App\Support\ApiResponse;
+use App\Services\AuditLogger;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Str;
+use App\Http\Controllers\Controller;
+use App\Support\AdminUserApiPresenter;
+use App\Http\Requests\Admin\AdminUserStoreRequest;
 
-/** POST /api/v1/admin/admin-users */
+/**
+ * 管理员用户创建。
+ *
+ * POST /api/v1/admin/admin-users
+ */
 final class AdminUserStoreController extends Controller
 {
-    public function __invoke(Request $request): JsonResponse
+    public function __invoke(AdminUserStoreRequest $request): JsonResponse
     {
         /** @var AdminUser $actor */
         $actor = $request->lotteryAdmin();
 
-        $payload = $request->all();
-        if (isset($payload['username']) && is_string($payload['username'])) {
-            $payload['username'] = Str::lower(trim($payload['username']));
-        }
-        if (array_key_exists('email', $payload) && $payload['email'] === '') {
-            $payload['email'] = null;
-        }
-
-        $data = validator($payload, [
-            'username' => ['required', 'string', 'min:2', 'max:64', 'regex:/^[a-zA-Z0-9._-]+$/u', 'unique:admin_users,username'],
-            'nickname' => ['required', 'string', 'max:128'],
-            'email' => ['nullable', 'string', 'email', 'max:255'],
-            'password' => ['required', 'string', 'min:8', 'max:256'],
-            'status' => ['sometimes', 'integer', 'in:0,1'],
-            'role_slugs' => ['required', 'array', 'min:1'],
-            'role_slugs.*' => ['string', 'max:64', 'distinct', 'exists:admin_roles,slug'],
-        ])->validate();
-
-        $email = is_string($data['email'] ?? null) && trim($data['email']) !== ''
-            ? trim($data['email'])
+        $email = is_string($request->validated('email'))
+            ? trim($request->validated('email'))
             : null;
 
-        $roleSlugs = array_values(array_unique($data['role_slugs']));
+        $roleSlugs = array_values(array_unique($request->validated('role_slugs')));
 
-        $user = DB::transaction(function () use ($data, $email, $roleSlugs): AdminUser {
+        $user = DB::transaction(function () use ($request, $email, $roleSlugs): AdminUser {
             $created = AdminUser::query()->create([
-                'username' => $data['username'],
-                'name' => $data['nickname'],
+                'username' => $request->validated('username'),
+                'name' => $request->validated('nickname'),
                 'email' => $email,
-                'password' => $data['password'],
-                'status' => array_key_exists('status', $data) ? (int) $data['status'] : 0,
+                'password' => $request->validated('password'),
+                'status' => $request->validated('status', 0),
             ]);
             $created->syncRoleSlugsForDefaultSite($roleSlugs);
 

app/Http/Controllers/Api/V1/Admin/User/AdminUserUpdateController.php

@@ -2,19 +2,18 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\User;
 
-use App\Http\Controllers\Controller;
 use App\Models\AdminUser;
-use App\Services\AuditLogger;
-use App\Support\AdminUserApiPresenter;
 use App\Support\ApiResponse;
+use App\Services\AuditLogger;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
-use Illuminate\Validation\Rule;
+use App\Http\Controllers\Controller;
+use App\Support\AdminUserApiPresenter;
+use App\Http\Requests\Admin\AdminUserUpdateRequest;
 
 /** PUT /api/v1/admin/admin-users/{admin_user} */
 final class AdminUserUpdateController extends Controller
 {
-    public function __invoke(Request $request, AdminUser $admin_user): JsonResponse
+    public function __invoke(AdminUserUpdateRequest $request, AdminUser $admin_user): JsonResponse
     {
         /** @var AdminUser $actor */
         $actor = $request->lotteryAdmin();
@@ -22,18 +21,7 @@ final class AdminUserUpdateController extends Controller
         $admin_user->load('roles');
         $before = AdminUserApiPresenter::listItem($admin_user);
 
-        $payload = $request->all();
-        if (array_key_exists('email', $payload) && $payload['email'] === '') {
-            $payload['email'] = null;
-        }
-
-        /** @var array{nickname?:string,email?:?string,password?:?string,status?:int} $data */
-        $data = validator($payload, [
-            'nickname' => ['sometimes', 'string', 'max:128'],
-            'email' => ['sometimes', 'nullable', 'string', 'email', 'max:255', Rule::unique('admin_users', 'email')->ignore($admin_user->id)],
-            'password' => ['sometimes', 'nullable', 'string', 'min:8', 'max:256'],
-            'status' => ['sometimes', 'integer', Rule::in([0, 1])],
-        ])->validate();
+        $data = $request->validated();
 
         $updates = [];
         if (array_key_exists('nickname', $data)) {

app/Http/Controllers/Api/V1/Admin/Wallet/TransferOrderListController.php

@@ -2,11 +2,12 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Wallet;
 
-use App\Http\Controllers\Controller;
-use App\Models\TransferOrder;
 use App\Support\ApiResponse;
+use App\Models\TransferOrder;
+use App\Support\PaginationTrait;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Admin\TransferOrderListRequest;
 
 /**
  * 后台：转账单列表（主站 ↔ 彩票 {@see transfer_orders}）。
@@ -25,26 +26,16 @@ use Illuminate\Http\Request;
  */
 final class TransferOrderListController extends Controller
 {
+    use PaginationTrait;
+
     private const ALLOWED_STATUS = ['processing', 'success', 'failed', 'pending_reconcile'];
 
-    public function __invoke(Request $request): JsonResponse
+    public function __invoke(TransferOrderListRequest $request): JsonResponse
     {
-        $validated = validator($request->query(), [
-            'page' => ['sometimes', 'integer', 'min:1'],
-            'per_page' => ['sometimes', 'integer', 'min:1', 'max:100'],
-            'size' => ['sometimes', 'integer', 'min:1', 'max:100'],
-            'player_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
-            'player_account' => ['sometimes', 'nullable', 'string', 'max:128'],
-            'transfer_no' => ['sometimes', 'nullable', 'string', 'max:96'],
-            'external_ref_no' => ['sometimes', 'nullable', 'string', 'max:96'],
-            'created_from' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
-            'created_to' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
-            'status' => ['sometimes', 'nullable', 'string', 'max:256'],
-        ])->validate();
+        $validated = $request->validated();
 
-        $perPage = (int) ($validated['per_page'] ?? $validated['size'] ?? 20);
-        $perPage = min(100, max(1, $perPage));
-        $page = max(1, (int) ($validated['page'] ?? 1));
+        $perPage = $this->perPage($request, 'per_page', 20, 100);
+        $page = $this->page($request);
 
         $query = TransferOrder::query()
             ->with(['player:id,site_code,site_player_id,username,nickname'])

app/Http/Controllers/Api/V1/Admin/Wallet/WalletTransactionListController.php

@@ -2,11 +2,12 @@
 
 namespace App\Http\Controllers\Api\V1\Admin\Wallet;
 
-use App\Http\Controllers\Controller;
 use App\Models\WalletTxn;
 use App\Support\ApiResponse;
+use App\Support\PaginationTrait;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Admin\WalletTransactionListRequest;
 
 /**
  * 后台：彩票钱包流水列表 {@see wallet_txns}。
@@ -25,27 +26,16 @@ use Illuminate\Http\Request;
  */
 final class WalletTransactionListController extends Controller
 {
+    use PaginationTrait;
+
     private const ALLOWED_STATUS = ['posted', 'pending_reconcile'];
 
-    public function __invoke(Request $request): JsonResponse
+    public function __invoke(WalletTransactionListRequest $request): JsonResponse
     {
-        $validated = validator($request->query(), [
-            'page' => ['sometimes', 'integer', 'min:1'],
-            'per_page' => ['sometimes', 'integer', 'min:1', 'max:100'],
-            'size' => ['sometimes', 'integer', 'min:1', 'max:100'],
-            'player_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
-            'player_account' => ['sometimes', 'nullable', 'string', 'max:128'],
-            'txn_no' => ['sometimes', 'nullable', 'string', 'max:96'],
-            'external_ref_no' => ['sometimes', 'nullable', 'string', 'max:96'],
-            'created_from' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
-            'created_to' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
-            'biz_type' => ['sometimes', 'nullable', 'string', 'max:64'],
-            'status' => ['sometimes', 'nullable', 'string', 'max:128'],
-        ])->validate();
+        $validated = $request->validated();
 
-        $perPage = (int) ($validated['per_page'] ?? $validated['size'] ?? 20);
-        $perPage = min(100, max(1, $perPage));
-        $page = max(1, (int) ($validated['page'] ?? 1));
+        $perPage = $this->perPage($request, 'per_page', 20, 100);
+        $page = $this->page($request);
 
         $query = WalletTxn::query()
             ->with(['player:id,site_code,site_player_id,username,nickname'])

app/Http/Controllers/Api/V1/Draw/DrawCurrentController.php

@@ -2,16 +2,16 @@
 
 namespace App\Http\Controllers\Api\V1\Draw;
 
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Services\Draw\DrawHallSnapshotBuilder;
-use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
 
 /**
  * 下注大厅：`GET /api/v1/draw/current`。
  */
-class DrawCurrentController extends Controller
+final class DrawCurrentController extends Controller
 {
     public function __construct(
         private readonly DrawHallSnapshotBuilder $snapshot,

app/Http/Controllers/Api/V1/Draw/DrawResultShowController.php

@@ -2,18 +2,18 @@
 
 namespace App\Http\Controllers\Api\V1\Draw;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ErrorCode;
 use App\Models\Draw;
-use App\Services\Draw\DrawResultViewService;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawResultViewService;
 
 /**
  * `GET /api/v1/draw/results/{draw_no}` — 单期详情（便于玩家端[< >]切换）。
  */
-class DrawResultShowController extends Controller
+final class DrawResultShowController extends Controller
 {
     public function __construct(
         private readonly DrawResultViewService $viewer,

app/Http/Controllers/Api/V1/Draw/DrawResultsIndexController.php

@@ -2,29 +2,32 @@
 
 namespace App\Http\Controllers\Api\V1\Draw;
 
+use App\Models\Draw;
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use App\Models\DrawResultBatch;
+use App\Support\PaginationTrait;
+use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Lottery\DrawResultBatchStatus;
-use App\Models\Draw;
-use App\Models\DrawResultBatch;
 use App\Services\Draw\DrawResultViewService;
-use App\Support\ApiResponse;
 use Illuminate\Contracts\Pagination\LengthAwarePaginator;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
 
 /**
  * `GET /api/v1/draw/results` — 已发布开奖往期（公开；对齐 PRD `/api/v1/results`）。
  */
-class DrawResultsIndexController extends Controller
+final class DrawResultsIndexController extends Controller
 {
+    use PaginationTrait;
+
     public function __construct(
         private readonly DrawResultViewService $viewer,
     ) {}
 
     public function __invoke(Request $request): JsonResponse
     {
-        $perPage = max(1, min(50, (int) $request->query('size', $request->query('per_page', 15))));
-        $page = max(1, (int) $request->query('page', 1));
+        $perPage = $this->perPage($request, 'size', 15, 50);
+        $page = $this->page($request);
         /** @var string|null $bizDate query `business_date` 或旧的 `date` */
         $bizDate = $request->query('business_date') ?? $request->query('date');
 

app/Http/Controllers/Api/V1/HealthController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1;
 
-use App\Http\Controllers\Controller;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
-class HealthController extends Controller
+final class HealthController extends Controller
 {
     /**
      * 健康检查（Next / 网关探活）。路径：GET /api/v1/health

app/Http/Controllers/Api/V1/Jackpot/JackpotSummaryController.php

@@ -2,16 +2,16 @@
 
 namespace App\Http\Controllers\Api\V1\Jackpot;
 
-use App\Http\Controllers\Controller;
 use App\Models\JackpotPool;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * `GET /api/v1/jackpot/summary` — 当前奖池水位（公开；玩家端开奖区展示）。
  */
-class JackpotSummaryController extends Controller
+final class JackpotSummaryController extends Controller
 {
     public function __invoke(Request $request): JsonResponse
     {

app/Http/Controllers/Api/V1/Play/PlayEffectiveCatalogController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Play;
 
-use App\Http\Controllers\Controller;
 use App\Lottery\ErrorCode;
-use App\Services\Config\EffectivePlayCatalogService;
 use App\Support\ApiResponse;
-use Illuminate\Database\Eloquent\ModelNotFoundException;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Config\EffectivePlayCatalogService;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
 
 /**
  * GET /api/v1/play/effective — 当前生效的玩法目录 + 赔率 + 封顶（公开，无需登录）。

app/Http/Controllers/Api/V1/Player/MeController.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Controllers\Api\V1\Player;
 
-use App\Http\Controllers\Controller;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * 鉴权自检：返回当前 Token 对应的玩家公开字段（不含密码）。
@@ -15,7 +15,7 @@ use Illuminate\Http\Request;
  * 补充字段与 PRD「识别玩家」及前端引导一致：`locale` 为当次 API 实际使用的语言（与 `NegotiateLotteryLocale` 一致）；
  * 时间类为 ISO 8601 字符串，便于 H5 展示与排错。
  */
-class MeController extends Controller
+final class MeController extends Controller
 {
     public function __invoke(Request $request): JsonResponse
     {

app/Http/Controllers/Api/V1/Player/PingController.php

@@ -2,15 +2,15 @@
 
 namespace App\Http\Controllers\Api\V1\Player;
 
-use App\Http\Controllers\Controller;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * 无需登录：仅供网关/前端确认「玩家 API 前缀」可达。
  * 路由：GET /api/v1/player/ping
  */
-class PingController extends Controller
+final class PingController extends Controller
 {
     public function __invoke(): JsonResponse
     {

app/Http/Controllers/Api/V1/Ticket/TicketDrawMyMatchController.php

@@ -2,20 +2,20 @@
 
 namespace App\Http\Controllers\Api\V1\Ticket;
 
-use App\Http\Controllers\Controller;
 use App\Models\Draw;
 use App\Models\Player;
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Draw\DrawResultViewService;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Models\TicketCombination;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawResultViewService;
 
 /**
  * `GET /api/v1/ticket/draws/{draw_no}/my-match` — 当期本人号码与已发布开奖 23 格的交集（用于开奖页高亮）。
  */
-class TicketDrawMyMatchController extends Controller
+final class TicketDrawMyMatchController extends Controller
 {
     public function __construct(
         private readonly DrawResultViewService $drawResultView,

app/Http/Controllers/Api/V1/Ticket/TicketItemShowController.php

@@ -2,19 +2,19 @@
 
 namespace App\Http\Controllers\Api\V1\Ticket;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ErrorCode;
 use App\Models\Player;
+use App\Lottery\ErrorCode;
 use App\Models\TicketItem;
-use App\Services\Draw\DrawResultViewService;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawResultViewService;
 
 /**
  * `GET /api/v1/ticket/items/{ticket_no}` — 注单详情（单注项 + 组合 + 结算摘要）。
  */
-class TicketItemShowController extends Controller
+final class TicketItemShowController extends Controller
 {
     public function __construct(
         private readonly DrawResultViewService $drawResultView,

app/Http/Controllers/Api/V1/Ticket/TicketItemsIndexController.php

@@ -2,25 +2,28 @@
 
 namespace App\Http\Controllers\Api\V1\Ticket;
 
-use App\Http\Controllers\Controller;
 use App\Models\Player;
 use App\Models\TicketItem;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\PaginationTrait;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * `GET /api/v1/ticket/items` — 我的注单（注项列表，支持 `draw_no` 筛选）。
  */
-class TicketItemsIndexController extends Controller
+final class TicketItemsIndexController extends Controller
 {
+    use PaginationTrait;
+
     public function __invoke(Request $request): JsonResponse
     {
         /** @var Player $player */
         $player = $request->attributes->get('lottery_player');
 
-        $perPage = max(1, min(50, (int) $request->query('per_page', 20)));
-        $page = max(1, (int) $request->query('page', 1));
+        $perPage = $this->perPage($request, 'per_page', 20, 50);
+        $page = $this->page($request);
         $drawNo = $request->query('draw_no');
 
         $query = TicketItem::query()

app/Http/Controllers/Api/V1/Ticket/TicketPlaceController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Http\Controllers\Controller;
-use App\Http\Requests\Ticket\TicketPlaceRequest;
-use App\Services\Ticket\TicketPlacementService;
 use App\Support\ApiResponse;
 use App\Support\LotteryMessage;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Exceptions\TicketOperationException;
+use App\Services\Ticket\TicketPlacementService;
+use App\Http\Requests\Ticket\TicketPlaceRequest;
 
 final class TicketPlaceController extends Controller
 {

app/Http/Controllers/Api/V1/Ticket/TicketPreviewController.php

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Http\Controllers\Controller;
-use App\Http\Requests\Ticket\TicketPreviewRequest;
-use App\Services\Ticket\TicketPreviewService;
 use App\Support\ApiResponse;
 use App\Support\LotteryMessage;
 use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Exceptions\TicketOperationException;
+use App\Services\Ticket\TicketPreviewService;
+use App\Http\Requests\Ticket\TicketPreviewRequest;
 
 final class TicketPreviewController extends Controller
 {

app/Http/Controllers/Api/V1/Wallet/WalletBalanceController.php

@@ -2,13 +2,14 @@
 
 namespace App\Http\Controllers\Api\V1\Wallet;
 
-use App\Http\Controllers\Controller;
-use App\Lottery\ErrorCode;
 use App\Models\Player;
+use App\Lottery\ErrorCode;
 use App\Models\PlayerWallet;
 use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use App\Support\CurrencyResolver;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * 【玩家】查询彩票侧钱包余额。
@@ -22,7 +23,7 @@ use Illuminate\Http\Request;
  * - `available_balance`：`balance - frozen_balance`，表示当前可用于下注的整数最小货币单位（不为负）
  * - `main_balance`：主站钱包余额占位，接入主站 API 后再返回实数；当前固定 `null`
  */
-class WalletBalanceController extends Controller
+final class WalletBalanceController extends Controller
 {
     private const WALLET_TYPE_LOTTERY = 'lottery';
 
@@ -68,16 +69,9 @@ class WalletBalanceController extends Controller
      */
     private function resolveCurrencyCode(Request $request, Player $player): string|JsonResponse
     {
-        $raw = $request->query('currency');
-        if (is_string($raw) && $raw !== '') {
-            $code = strtoupper(substr(trim($raw), 0, 16));
-        } else {
-            $fallback = $player->default_currency ?? config('lottery.default_currency', 'NPR');
-            $code = strtoupper(substr(trim((string) $fallback), 0, 16));
-        }
+        $code = CurrencyResolver::resolve($request, $player, 'currency');
 
-        // 币种码：字母数字，长度 1–16，与 migrations 字段一致
-        if (! preg_match('/^[A-Z0-9]{1,16}$/', $code)) {
+        if (! CurrencyResolver::isValid($code)) {
             return ApiResponse::error(
                 __('wallet.invalid_currency'),
                 ErrorCode::WalletInvalidCurrency->value,

app/Http/Controllers/Api/V1/Wallet/WalletLogsController.php

@@ -2,21 +2,24 @@
 
 namespace App\Http\Controllers\Api\V1\Wallet;
 
-use App\Http\Controllers\Controller;
-use App\Models\TransferOrder;
 use App\Models\WalletTxn;
-use App\Support\ApiResponse;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
 use Illuminate\Support\Str;
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use App\Models\TransferOrder;
+use App\Support\PaginationTrait;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
 
 /**
  * PRD §10.1.1：`GET /api/v1/wallet/logs` — 钱包流水。
  *
  * Query：`page`、`size`（每页条数，默认 20）、`type`（逗号分隔：transfer_in,transfer_out,bet,prize,refund）
  */
-class WalletLogsController extends Controller
+final class WalletLogsController extends Controller
 {
+    use PaginationTrait;
+
     /** PRD 对外类型 → 本地 biz_type */
     private const TYPE_TO_BIZ = [
         'transfer_in' => ['transfer_in'],
@@ -31,8 +34,8 @@ class WalletLogsController extends Controller
         $player = $request->lotteryPlayer();
         abort_if($player === null, 500, 'lottery_player missing');
 
-        $perPage = min(100, max(1, (int) $request->query('size', $request->query('per_page', 20))));
-        $page = max(1, (int) $request->query('page', 1));
+        $perPage = $this->perPage($request, 'size', 20, 100);
+        $page = $this->page($request);
 
         $pendingPayload = $this->pendingReconcilePayload((int) $player->id);
 

app/Http/Controllers/Api/V1/Wallet/WalletTransferInController.php

@@ -2,23 +2,23 @@
 
 namespace App\Http\Controllers\Api\V1\Wallet;
 
-use App\Exceptions\WalletOperationException;
-use App\Http\Controllers\Controller;
-use App\Http\Requests\Wallet\WalletTransferRequest;
-use App\Lottery\ErrorCode;
 use App\Models\Player;
-use App\Services\Wallet\LotteryTransferService;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
 use App\Support\LotteryMessage;
+use App\Support\CurrencyResolver;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Exceptions\WalletOperationException;
+use App\Services\Wallet\LotteryTransferService;
+use App\Http\Requests\Wallet\WalletTransferRequest;
 
 /**
  * 转入：主站扣款 → 彩票钱包加款。
  *
  * `POST /api/v1/wallet/transfer-in` ，body JSON：`amount`（最小货币单位整数）, `idempotent_key`, `currency`（可选）
  */
-class WalletTransferInController extends Controller
+final class WalletTransferInController extends Controller
 {
     public function __construct(
         private readonly LotteryTransferService $transferService,
@@ -53,17 +53,11 @@ class WalletTransferInController extends Controller
         return ApiResponse::success($data);
     }
 
-    private function resolveCurrencyCode(Request $request, Player $player): string|JsonResponse
+    private function resolveCurrencyCode(WalletTransferRequest $request, Player $player): string|JsonResponse
     {
-        $raw = $request->input('currency');
-        if (is_string($raw) && $raw !== '') {
-            $code = strtoupper(substr(trim($raw), 0, 16));
-        } else {
-            $fallback = $player->default_currency ?? config('lottery.default_currency', 'NPR');
-            $code = strtoupper(substr(trim((string) $fallback), 0, 16));
-        }
+        $code = CurrencyResolver::resolve($request, $player, 'currency');
 
-        if (! preg_match('/^[A-Z0-9]{1,16}$/', $code)) {
+        if (! CurrencyResolver::isValid($code)) {
             return ApiResponse::error(
                 __('wallet.invalid_currency'),
                 ErrorCode::WalletInvalidCurrency->value,

app/Http/Controllers/Api/V1/Wallet/WalletTransferOutController.php

@@ -2,23 +2,23 @@
 
 namespace App\Http\Controllers\Api\V1\Wallet;
 
-use App\Exceptions\WalletOperationException;
-use App\Http\Controllers\Controller;
-use App\Http\Requests\Wallet\WalletTransferRequest;
-use App\Lottery\ErrorCode;
 use App\Models\Player;
-use App\Services\Wallet\LotteryTransferService;
+use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
 use App\Support\LotteryMessage;
+use App\Support\CurrencyResolver;
 use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Exceptions\WalletOperationException;
+use App\Services\Wallet\LotteryTransferService;
+use App\Http\Requests\Wallet\WalletTransferRequest;
 
 /**
  * 转出：彩票钱包扣款 → 主站加款；主站失败则冲正彩票余额。
  *
  * `POST /api/v1/wallet/transfer-out`
  */
-class WalletTransferOutController extends Controller
+final class WalletTransferOutController extends Controller
 {
     public function __construct(
         private readonly LotteryTransferService $transferService,
@@ -53,17 +53,11 @@ class WalletTransferOutController extends Controller
         return ApiResponse::success($data);
     }
 
-    private function resolveCurrencyCode(Request $request, Player $player): string|JsonResponse
+    private function resolveCurrencyCode(WalletTransferRequest $request, Player $player): string|JsonResponse
     {
-        $raw = $request->input('currency');
-        if (is_string($raw) && $raw !== '') {
-            $code = strtoupper(substr(trim($raw), 0, 16));
-        } else {
-            $fallback = $player->default_currency ?? config('lottery.default_currency', 'NPR');
-            $code = strtoupper(substr(trim((string) $fallback), 0, 16));
-        }
+        $code = CurrencyResolver::resolve($request, $player, 'currency');
 
-        if (! preg_match('/^[A-Z0-9]{1,16}$/', $code)) {
+        if (! CurrencyResolver::isValid($code)) {
             return ApiResponse::error(
                 __('wallet.invalid_currency'),
                 ErrorCode::WalletInvalidCurrency->value,

app/Http/Middleware/EnsureAdminApi.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Middleware;
 
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
-use App\Support\ApiResponse;
 use Closure;
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
 use Illuminate\Http\Request;
 use Symfony\Component\HttpFoundation\Response;
 
@@ -13,7 +13,7 @@ use Symfony\Component\HttpFoundation\Response;
  * 后台 API：`auth:sanctum` 之后执行，校验为 {@link AdminUser} 且未禁用；
  * 上下文可通过 `$request->lotteryAdmin()` 读取。
  */
-class EnsureAdminApi
+final class EnsureAdminApi
 {
     public function handle(Request $request, Closure $next): Response
     {

app/Http/Middleware/EnsureAdminPermission.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Middleware;
 
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
-use App\Support\ApiResponse;
 use Closure;
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
 use Illuminate\Http\Request;
 use Symfony\Component\HttpFoundation\Response;
 
@@ -13,7 +13,7 @@ use Symfony\Component\HttpFoundation\Response;
  * 后台 RBAC：在 {@see EnsureAdminApi} 之后校验 `prd.*` 等功能权限 slug（与 {@see AdminUser::hasAdminPermission} 一致）。
  * 路由参数支持 `slug` 或 `slug1|slug2`（满足其一即可）。
  */
-class EnsureAdminPermission
+final class EnsureAdminPermission
 {
     public function handle(Request $request, Closure $next, string $permissionSlugs): Response
     {

app/Http/Middleware/EnsurePlayerApi.php

@@ -2,14 +2,14 @@
 
 namespace App\Http\Middleware;
 
-use App\Exceptions\PlayerAuthenticationException;
-use App\Lottery\ErrorCode;
-use App\Services\PlayerTokenResolver;
-use App\Support\ApiResponse;
-use App\Support\LotteryMessage;
 use Closure;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
 use Illuminate\Http\Request;
+use App\Support\LotteryMessage;
+use App\Services\PlayerTokenResolver;
 use Symfony\Component\HttpFoundation\Response;
+use App\Exceptions\PlayerAuthenticationException;
 
 /**
  * 【玩家端 API 鉴权中间件】
@@ -20,7 +20,7 @@ use Symfony\Component\HttpFoundation\Response;
  *
  * PlayerAuthenticationException 的 getMessage() 仅作开发与日志用语，可与 API msg 语种不一致。
  */
-class EnsurePlayerApi
+final class EnsurePlayerApi
 {
     public function handle(Request $request, Closure $next): Response
     {

app/Http/Middleware/NegotiateLotteryLocale.php

@@ -2,9 +2,9 @@
 
 namespace App\Http\Middleware;
 
-use App\Support\LotteryLocale;
 use Closure;
 use Illuminate\Http\Request;
+use App\Support\LotteryLocale;
 use Symfony\Component\HttpFoundation\Response;
 
 /**
@@ -20,7 +20,7 @@ use Symfony\Component\HttpFoundation\Response;
  *
  * 【与异常 JSON】{@see LotteryLocale} 与 middleware 同源，在未命中路由、`lottery_locale` 未写入时仍可从 Header 推导。
  */
-class NegotiateLotteryLocale
+final class NegotiateLotteryLocale
 {
     public function handle(Request $request, Closure $next): Response
     {

app/Http/Requests/Admin/AdminLoginRequest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 管理员登录请求。
+ *
+ * @see LoginController
+ */
+final class AdminLoginRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'account' => ['required', 'string', 'min:2', 'max:64', 'regex:/^[a-zA-Z0-9._-]+$/u'],
+            'password' => ['required', 'string', 'max:256'],
+            'captcha_key' => ['required', 'string', 'uuid'],
+            'captcha_code' => ['required', 'string', 'max:32'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function attributes(): array
+    {
+        return [
+            'account' => 'account',
+            'password' => 'password',
+            'captcha_key' => 'captcha_key',
+            'captcha_code' => 'captcha_code',
+        ];
+    }
+}

app/Http/Requests/Admin/AdminPlayerTicketItemsRequest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 管理员查看玩家注单列表请求。
+ *
+ * @see AdminPlayerTicketItemsIndexController
+ */
+final class AdminPlayerTicketItemsRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'page' => ['sometimes', 'integer', 'min:1'],
+            'per_page' => ['sometimes', 'integer', 'min:1', 'max:50'],
+            'draw_no' => ['sometimes', 'nullable', 'string', 'max:32'],
+        ];
+    }
+}

app/Http/Requests/Admin/AdminUserPermissionSyncRequest.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 管理员用户权限同步请求。
+ *
+ * @see AdminUserPermissionSyncController
+ */
+final class AdminUserPermissionSyncRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'permissions' => ['required', 'array'],
+            'permissions.*' => ['string', 'max:128'],
+        ];
+    }
+}

app/Http/Requests/Admin/AdminUserRoleSyncRequest.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 管理员用户角色同步请求。
+ *
+ * @see AdminUserRoleSyncController
+ */
+final class AdminUserRoleSyncRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'role_slugs' => ['required', 'array', 'min:1'],
+            'role_slugs.*' => ['string', 'max:64', 'distinct', 'exists:admin_roles,slug'],
+        ];
+    }
+}

app/Http/Requests/Admin/AdminUserStoreRequest.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Support\Str;
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 管理员用户创建请求。
+ *
+ * @see AdminUserStoreController
+ */
+final class AdminUserStoreRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Prepare the data for validation.
+     */
+    protected function prepareForValidation(): void
+    {
+        $username = $this->input('username');
+        if (is_string($username)) {
+            $this->merge([
+                'username' => Str::lower(trim($username)),
+            ]);
+        }
+
+        if ($this->input('email') === '') {
+            $this->merge([
+                'email' => null,
+            ]);
+        }
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'username' => ['required', 'string', 'min:2', 'max:64', 'regex:/^[a-zA-Z0-9._-]+$/u', 'unique:admin_users,username'],
+            'nickname' => ['required', 'string', 'max:128'],
+            'email' => ['nullable', 'string', 'email', 'max:255'],
+            'password' => ['required', 'string', 'min:8', 'max:256'],
+            'status' => ['sometimes', 'integer', 'in:0,1'],
+            'role_slugs' => ['required', 'array', 'min:1'],
+            'role_slugs.*' => ['string', 'max:64', 'distinct', 'exists:admin_roles,slug'],
+        ];
+    }
+}

app/Http/Requests/Admin/AdminUserUpdateRequest.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Validation\Rule;
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 管理员用户更新请求。
+ *
+ * @see AdminUserUpdateController
+ */
+final class AdminUserUpdateRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    protected function prepareForValidation(): void
+    {
+        if ($this->input('email') === '') {
+            $this->merge(['email' => null]);
+        }
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        $adminUser = $this->route('admin_user');
+
+        return [
+            'nickname' => ['sometimes', 'string', 'max:128'],
+            'email' => ['sometimes', 'nullable', 'string', 'email', 'max:255', Rule::unique('admin_users', 'email')->ignore($adminUser?->id)],
+            'password' => ['sometimes', 'nullable', 'string', 'min:8', 'max:256'],
+            'status' => ['sometimes', 'integer', Rule::in([0, 1])],
+        ];
+    }
+}

app/Http/Requests/Admin/ReconcileJobStoreRequest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 对账任务创建请求。
+ *
+ * @see ReconcileJobStoreController
+ */
+final class ReconcileJobStoreRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'date_from' => ['required', 'date_format:Y-m-d'],
+            'date_to' => ['required', 'date_format:Y-m-d', 'after_or_equal:date_from'],
+            'player_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
+        ];
+    }
+}

app/Http/Requests/Admin/ReportJobStoreRequest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 报表任务创建请求。
+ *
+ * @see ReportJobStoreController
+ */
+final class ReportJobStoreRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'report_type' => ['required', 'string', 'max:64'],
+            'parameters' => ['sometimes', 'array'],
+            'parameters.date_from' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
+            'parameters.date_to' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
+        ];
+    }
+}

app/Http/Requests/Admin/TransferOrderListRequest.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 转账单列表查询请求。
+ *
+ * @see TransferOrderListController
+ */
+final class TransferOrderListRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'page' => ['sometimes', 'integer', 'min:1'],
+            'per_page' => ['sometimes', 'integer', 'min:1', 'max:100'],
+            'size' => ['sometimes', 'integer', 'min:1', 'max:100'],
+            'player_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
+            'player_account' => ['sometimes', 'nullable', 'string', 'max:128'],
+            'transfer_no' => ['sometimes', 'nullable', 'string', 'max:96'],
+            'external_ref_no' => ['sometimes', 'nullable', 'string', 'max:96'],
+            'created_from' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
+            'created_to' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
+            'status' => ['sometimes', 'nullable', 'string', 'max:256'],
+        ];
+    }
+}

app/Http/Requests/Admin/WalletTransactionListRequest.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 钱包流水列表查询请求。
+ *
+ * @see WalletTransactionListController
+ */
+final class WalletTransactionListRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, mixed>>
+     */
+    public function rules(): array
+    {
+        return [
+            'page' => ['sometimes', 'integer', 'min:1'],
+            'per_page' => ['sometimes', 'integer', 'min:1', 'max:100'],
+            'size' => ['sometimes', 'integer', 'min:1', 'max:100'],
+            'player_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
+            'player_account' => ['sometimes', 'nullable', 'string', 'max:128'],
+            'txn_no' => ['sometimes', 'nullable', 'string', 'max:96'],
+            'external_ref_no' => ['sometimes', 'nullable', 'string', 'max:96'],
+            'created_from' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
+            'created_to' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
+            'biz_type' => ['sometimes', 'nullable', 'string', 'max:64'],
+            'status' => ['sometimes', 'nullable', 'string', 'max:128'],
+        ];
+    }
+}

app/Http/Requests/Ticket/TicketPlaceRequest.php

@@ -2,7 +2,7 @@
 
 namespace App\Http\Requests\Ticket;
 
-class TicketPlaceRequest extends TicketPreviewRequest
+final class TicketPlaceRequest extends TicketPreviewRequest
 {
     /**
      * @return array<string, mixed>

app/Http/Requests/Ticket/TicketPreviewRequest.php

@@ -4,7 +4,7 @@ namespace App\Http\Requests\Ticket;
 
 use Illuminate\Foundation\Http\FormRequest;
 
-class TicketPreviewRequest extends FormRequest
+final class TicketPreviewRequest extends FormRequest
 {
     public function authorize(): bool
     {

app/Http/Requests/Wallet/WalletTransferRequest.php

@@ -7,7 +7,7 @@ use Illuminate\Foundation\Http\FormRequest;
 /**
  * 转入 / 转出共用请求体：最小货币单位金额、幂等键、可选币种。
  */
-class WalletTransferRequest extends FormRequest
+final class WalletTransferRequest extends FormRequest
 {
     public function authorize(): bool
     {

app/Models/AdminMenu.php

@@ -4,7 +4,7 @@ namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
 
-class AdminMenu extends Model
+final class AdminMenu extends Model
 {
     protected $table = 'admin_menus';
 }

app/Models/AdminMenuAction.php

@@ -5,7 +5,7 @@ namespace App\Models;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
-class AdminMenuAction extends Model
+final class AdminMenuAction extends Model
 {
     protected $table = 'admin_menu_actions';
 

app/Models/AdminRole.php

@@ -2,18 +2,18 @@
 
 namespace App\Models;
 
+use Illuminate\Support\Facades\DB;
 use App\Support\AdminPermissionBridge;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
-use Illuminate\Support\Facades\DB;
 
-class AdminRole extends Model
+final class AdminRole extends Model
 {
     protected $table = 'admin_roles';
 
     protected static function booted(): void
     {
-        static::creating(function (AdminRole $role): void {
+        self::creating(function (AdminRole $role): void {
             if (($role->code ?? '') === '' && is_string($role->slug) && $role->slug !== '') {
                 $role->code = $role->slug;
             }

app/Models/AdminUser.php

@@ -2,14 +2,14 @@
 
 namespace App\Models;
 
-use App\Support\AdminPermissionBridge;
-use Illuminate\Database\Eloquent\Relations\BelongsToMany;
-use Illuminate\Foundation\Auth\User as Authenticatable;
-use Illuminate\Notifications\Notifiable;
-use Illuminate\Support\Facades\DB;
 use Laravel\Sanctum\HasApiTokens;
+use Illuminate\Support\Facades\DB;
+use App\Support\AdminPermissionBridge;
+use Illuminate\Notifications\Notifiable;
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 
-class AdminUser extends Authenticatable
+final class AdminUser extends Authenticatable
 {
     use HasApiTokens;
     use Notifiable;

app/Models/AuditLog.php

@@ -6,7 +6,7 @@ use App\Services\AuditLogger;
 use Illuminate\Database\Eloquent\Model;
 
 /** 运维/后台动作留痕表 audit_logs（写入请走 {@see AuditLogger}）。 */
-class AuditLog extends Model
+final class AuditLog extends Model
 {
     public const UPDATED_AT = null;
 

app/Models/Currency.php

@@ -5,7 +5,7 @@ namespace App\Models;
 use Illuminate\Database\Eloquent\Model;
 
 /** 币种枚举表 {@see currencies} */
-class Currency extends Model
+final class Currency extends Model
 {
     protected $fillable = [
         'code',

app/Models/Draw.php

@@ -7,7 +7,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
 /** 彩票期号 {@see draws} */
-class Draw extends Model
+final class Draw extends Model
 {
     protected $fillable = [
         'draw_no',

app/Models/DrawResultBatch.php

@@ -4,11 +4,11 @@ namespace App\Models;
 
 use App\Lottery\DrawResultBatchStatus;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 开奖结果批次（含 RNG 种子摘要、审核人） {@see draw_result_batches} */
-class DrawResultBatch extends Model
+final class DrawResultBatch extends Model
 {
     public $timestamps = true;
 

app/Models/DrawResultItem.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 单条中奖号码行（与界面文档奖项分区对应） {@see draw_result_items} */
-class DrawResultItem extends Model
+final class DrawResultItem extends Model
 {
     public const UPDATED_AT = null;
 

app/Models/JackpotContribution.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 单注对 Jackpot 的蓄水 {@see jackpot_contributions} */
-class JackpotContribution extends Model
+final class JackpotContribution extends Model
 {
     protected $fillable = [
         'jackpot_pool_id',

app/Models/JackpotPayoutLog.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** Jackpot 爆池派发记录 {@see jackpot_payout_logs} */
-class JackpotPayoutLog extends Model
+final class JackpotPayoutLog extends Model
 {
     public const UPDATED_AT = null;
 

app/Models/JackpotPool.php

@@ -3,11 +3,11 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** Jackpot 奖池配置与当前水位 {@see jackpot_pools} */
-class JackpotPool extends Model
+final class JackpotPool extends Model
 {
     protected $fillable = [
         'currency_code',

app/Models/LotterySetting.php

@@ -6,7 +6,7 @@ use App\Services\LotterySettings;
 use Illuminate\Database\Eloquent\Model;
 
 /** 运行期 KV 配置行，对应表 lottery_settings（读业务请优先用 {@see LotterySettings}）。 */
-class LotterySetting extends Model
+final class LotterySetting extends Model
 {
     protected $fillable = [
         'setting_key',

app/Models/OddsItem.php

@@ -10,7 +10,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
  *
  * `odds_value`：整数，**赔率乘数 × 10000**（例如 19500 表示 1.9500 倍）。
  */
-class OddsItem extends Model
+final class OddsItem extends Model
 {
     protected $fillable = [
         'version_id',

app/Models/OddsVersion.php

@@ -4,11 +4,11 @@ namespace App\Models;
 
 use App\Lottery\ConfigVersionStatus;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** {@see odds_versions} */
-class OddsVersion extends Model
+final class OddsVersion extends Model
 {
     protected $fillable = [
         'version_no',
@@ -29,7 +29,7 @@ class OddsVersion extends Model
 
     protected static function booted(): void
     {
-        static::saving(function (OddsVersion $m): void {
+        self::saving(function (OddsVersion $m): void {
             if ($m->status === null || $m->status === '') {
                 $m->status = ConfigVersionStatus::Draft->value;
             }

app/Models/PlayConfigItem.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** {@see play_config_items} — 与 {@see PlayType::play_code} 对齐。 */
-class PlayConfigItem extends Model
+final class PlayConfigItem extends Model
 {
     protected $fillable = [
         'version_id',

app/Models/PlayConfigVersion.php

@@ -4,11 +4,11 @@ namespace App\Models;
 
 use App\Lottery\ConfigVersionStatus;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** {@see play_config_versions} */
-class PlayConfigVersion extends Model
+final class PlayConfigVersion extends Model
 {
     protected $fillable = [
         'version_no',
@@ -29,7 +29,7 @@ class PlayConfigVersion extends Model
 
     protected static function booted(): void
     {
-        static::saving(function (PlayConfigVersion $m): void {
+        self::saving(function (PlayConfigVersion $m): void {
             if ($m->status === null || $m->status === '') {
                 $m->status = ConfigVersionStatus::Draft->value;
             }

app/Models/PlayType.php

@@ -5,7 +5,7 @@ namespace App\Models;
 use Illuminate\Database\Eloquent\Model;
 
 /** 玩法主数据目录 {@see play_types}（与版本化配置 items 通过 play_code 关联）。 */
-class PlayType extends Model
+final class PlayType extends Model
 {
     protected $fillable = [
         'play_code',

app/Models/Player.php

@@ -8,7 +8,7 @@ use Illuminate\Database\Eloquent\Relations\HasMany;
 /**
  * 主站玩家在本地映射账号（表 players），与 SSO JWT 中 site_code + site_player_id 对应。
  */
-class Player extends Model
+final class Player extends Model
 {
     protected $fillable = [
         'site_code',

app/Models/PlayerWallet.php

@@ -8,7 +8,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
 /**
  * 彩票侧余额（表 player_wallets），按 player + wallet_type + currency 唯一。
  */
-class PlayerWallet extends Model
+final class PlayerWallet extends Model
 {
     protected $fillable = [
         'player_id',

app/Models/ReconcileItem.php

@@ -5,7 +5,7 @@ namespace App\Models;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
-class ReconcileItem extends Model
+final class ReconcileItem extends Model
 {
     protected $table = 'reconcile_items';
 

app/Models/ReconcileJob.php

@@ -3,10 +3,10 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
-class ReconcileJob extends Model
+final class ReconcileJob extends Model
 {
     protected $table = 'reconcile_jobs';
 

app/Models/ReportJob.php

@@ -5,7 +5,7 @@ namespace App\Models;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
-class ReportJob extends Model
+final class ReportJob extends Model
 {
     protected $table = 'report_jobs';
 

app/Models/RiskCapItem.php

@@ -10,7 +10,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
  *
  * `cap_amount`：与钱包一致的最小货币单位（整数）。
  */
-class RiskCapItem extends Model
+final class RiskCapItem extends Model
 {
     protected $fillable = [
         'version_id',

app/Models/RiskCapVersion.php

@@ -4,11 +4,11 @@ namespace App\Models;
 
 use App\Lottery\ConfigVersionStatus;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** {@see risk_cap_versions} */
-class RiskCapVersion extends Model
+final class RiskCapVersion extends Model
 {
     protected $fillable = [
         'version_no',
@@ -29,7 +29,7 @@ class RiskCapVersion extends Model
 
     protected static function booted(): void
     {
-        static::saving(function (RiskCapVersion $m): void {
+        self::saving(function (RiskCapVersion $m): void {
             if ($m->status === null || $m->status === '') {
                 $m->status = ConfigVersionStatus::Draft->value;
             }

app/Models/RiskPool.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 赔付池事实表 {@see risk_pools} */
-class RiskPool extends Model
+final class RiskPool extends Model
 {
     protected $fillable = [
         'draw_id',

app/Models/RiskPoolLockLog.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 风险池占用日志 {@see risk_pool_lock_logs} */
-class RiskPoolLockLog extends Model
+final class RiskPoolLockLog extends Model
 {
     public $timestamps = false;
 

app/Models/SettlementBatch.php

@@ -4,11 +4,11 @@ namespace App\Models;
 
 use App\Lottery\SettlementBatchStatus;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 单期单次结算批次 {@see settlement_batches} */
-class SettlementBatch extends Model
+final class SettlementBatch extends Model
 {
     protected $fillable = [
         'draw_id',

app/Models/TicketCombination.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 注项展开组合 {@see ticket_combinations} */
-class TicketCombination extends Model
+final class TicketCombination extends Model
 {
     public $timestamps = false;
 

app/Models/TicketItem.php

@@ -3,12 +3,12 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasOne;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 注项明细 {@see ticket_items} */
-class TicketItem extends Model
+final class TicketItem extends Model
 {
     protected $fillable = [
         'ticket_no',

app/Models/TicketOrder.php

@@ -3,11 +3,11 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 下注订单头 {@see ticket_orders} */
-class TicketOrder extends Model
+final class TicketOrder extends Model
 {
     protected $fillable = [
         'order_no',

app/Models/TicketSettlementDetail.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 注单项结算明细 {@see ticket_settlement_details} */
-class TicketSettlementDetail extends Model
+final class TicketSettlementDetail extends Model
 {
     protected $fillable = [
         'settlement_batch_id',

app/Models/TransferOrder.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 主站 ↔ 彩票划转订单 {@see transfer_orders} */
-class TransferOrder extends Model
+final class TransferOrder extends Model
 {
     protected $fillable = [
         'transfer_no',

app/Models/WalletTxn.php

@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /** 彩票钱包流水 {@see wallet_txns} */
-class WalletTxn extends Model
+final class WalletTxn extends Model
 {
     protected $fillable = [
         'txn_no',

app/Providers/AppServiceProvider.php

@@ -2,17 +2,17 @@
 
 namespace App\Providers;
 
-use App\Models\AdminUser;
 use App\Models\Player;
-use App\Services\Wallet\HttpMainSiteWalletGateway;
-use App\Services\Wallet\MainSiteWalletGateway;
-use App\Services\Wallet\StubMainSiteWalletGateway;
-use Illuminate\Cache\RateLimiting\Limit;
+use App\Models\AdminUser;
 use Illuminate\Http\Request;
-use Illuminate\Support\Facades\RateLimiter;
 use Illuminate\Support\ServiceProvider;
+use Illuminate\Cache\RateLimiting\Limit;
+use Illuminate\Support\Facades\RateLimiter;
+use App\Services\Wallet\MainSiteWalletGateway;
+use App\Services\Wallet\HttpMainSiteWalletGateway;
+use App\Services\Wallet\StubMainSiteWalletGateway;
 
-class AppServiceProvider extends ServiceProvider
+final class AppServiceProvider extends ServiceProvider
 {
     /**
      * Register any application services.

app/Services/Admin/AdminDashboardSnapshotBuilder.php

@@ -2,16 +2,16 @@
 
 namespace App\Services\Admin;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Models\AdminUser;
+use Carbon\Carbon;
 use App\Models\Draw;
 use App\Models\RiskPool;
-use App\Models\SettlementBatch;
+use App\Models\AdminUser;
 use App\Models\TicketItem;
 use App\Models\TicketOrder;
 use App\Models\TransferOrder;
+use App\Models\SettlementBatch;
+use App\Lottery\DrawResultBatchStatus;
 use App\Services\Draw\DrawHallSnapshotBuilder;
-use Carbon\Carbon;
 
 /**
  * 后台首页仪表盘：聚合大厅快照、当期财务、期号面板、风控摘要、异常转账计数。

app/Services/Admin/AdminReconcileJobService.php

@@ -2,14 +2,14 @@
 
 namespace App\Services\Admin;
 
-use App\Models\AdminUser;
-use App\Models\ReconcileItem;
-use App\Models\ReconcileJob;
-use App\Services\AuditLogger;
 use Carbon\Carbon;
-use Illuminate\Http\Request;
-use Illuminate\Support\Facades\DB;
+use App\Models\AdminUser;
 use Illuminate\Support\Str;
+use App\Models\ReconcileJob;
+use Illuminate\Http\Request;
+use App\Models\ReconcileItem;
+use App\Services\AuditLogger;
+use Illuminate\Support\Facades\DB;
 
 /**
  * 对账任务：落库 `reconcile_jobs` / `reconcile_items`（阶段 7；差异引擎可后续替换）。

app/Services/Admin/AdminReportJobService.php

@@ -4,10 +4,10 @@ namespace App\Services\Admin;
 
 use App\Models\AdminUser;
 use App\Models\ReportJob;
-use App\Services\AuditLogger;
-use Illuminate\Http\Request;
-use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
+use Illuminate\Http\Request;
+use App\Services\AuditLogger;
+use Illuminate\Support\Facades\DB;
 
 /**
  * 报表导出任务：落库 `report_jobs`（阶段 7；异步生成可后续接队列）。

app/Services/AdminCaptchaService.php

@@ -2,13 +2,13 @@
 
 namespace App\Services;
 
-use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Str;
+use Illuminate\Support\Facades\Cache;
 
 /**
  * 后台登录图形验证码：SVG 产出 + Cache 短时保存答案摘要（单行文本，便于前台用 img[src=data:...] 展示）。
  */
-class AdminCaptchaService
+final class AdminCaptchaService
 {
     private const PREFIX = 'admin_captcha:';
 

app/Services/AuditLogger.php

@@ -2,9 +2,9 @@
 
 namespace App\Services;
 
-use App\Models\AdminUser;
-use App\Models\AuditLog;
 use App\Models\Player;
+use App\Models\AuditLog;
+use App\Models\AdminUser;
 use Illuminate\Http\Request;
 
 /**

app/Services/Config/EffectivePlayCatalogService.php

@@ -2,16 +2,16 @@
 
 namespace App\Services\Config;
 
-use App\Lottery\ConfigVersionStatus;
 use App\Models\Currency;
 use App\Models\OddsItem;
-use App\Models\OddsVersion;
-use App\Models\PlayConfigItem;
-use App\Models\PlayConfigVersion;
 use App\Models\PlayType;
+use App\Models\OddsVersion;
 use App\Models\RiskCapItem;
+use App\Models\PlayConfigItem;
 use App\Models\RiskCapVersion;
+use App\Models\PlayConfigVersion;
 use Illuminate\Support\Collection;
+use App\Lottery\ConfigVersionStatus;
 
 /**
  * 玩家端：当前生效的玩法目录 + 三套版本快照（只读）。

app/Services/Config/OddsStreamService.php

@@ -2,17 +2,17 @@
 
 namespace App\Services\Config;
 
-use App\Lottery\ConfigVersionStatus;
-use App\Models\AdminUser;
 use App\Models\Currency;
 use App\Models\OddsItem;
-use App\Models\OddsVersion;
 use App\Models\PlayType;
-use App\Services\AuditLogger;
-use App\Support\OddsStandardScopes;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use App\Models\AdminUser;
+use App\Models\OddsVersion;
 use Illuminate\Http\Request;
+use App\Services\AuditLogger;
 use Illuminate\Support\Facades\DB;
+use App\Support\OddsStandardScopes;
+use App\Lottery\ConfigVersionStatus;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /** 后台：赔率版本（{@see odds_versions} / {@see odds_items}） */
 final class OddsStreamService

app/Services/Config/PlayConfigStreamService.php

@@ -2,15 +2,15 @@
 
 namespace App\Services\Config;
 
-use App\Lottery\ConfigVersionStatus;
+use App\Models\PlayType;
 use App\Models\AdminUser;
+use Illuminate\Http\Request;
+use App\Services\AuditLogger;
 use App\Models\PlayConfigItem;
 use App\Models\PlayConfigVersion;
-use App\Models\PlayType;
-use App\Services\AuditLogger;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
-use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
+use App\Lottery\ConfigVersionStatus;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /** 后台：玩法配置版本（{@see play_config_versions} / {@see play_config_items}） */
 final class PlayConfigStreamService

app/Services/Config/RiskCapStreamService.php

@@ -2,14 +2,14 @@
 
 namespace App\Services\Config;
 
-use App\Lottery\ConfigVersionStatus;
 use App\Models\AdminUser;
 use App\Models\RiskCapItem;
-use App\Models\RiskCapVersion;
-use App\Services\AuditLogger;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Illuminate\Http\Request;
+use App\Services\AuditLogger;
+use App\Models\RiskCapVersion;
 use Illuminate\Support\Facades\DB;
+use App\Lottery\ConfigVersionStatus;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /** 后台：风控封顶版本（{@see risk_cap_versions} / {@see risk_cap_items}） */
 final class RiskCapStreamService

app/Services/Draw/DrawHallSnapshotBuilder.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Draw;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
-use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
 use Carbon\Carbon;
+use App\Models\Draw;
+use App\Lottery\DrawStatus;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Lottery\DrawResultBatchStatus;
 
 /**
  * `GET draw/current` 与大厅 WS 快照共用数据结构。

app/Services/Draw/DrawPlannerService.php

@@ -2,11 +2,11 @@
 
 namespace App\Services\Draw;
 
-use App\Lottery\DrawStatus;
-use App\Models\Draw;
 use Carbon\Carbon;
-use Illuminate\Database\QueryException;
+use App\Models\Draw;
+use App\Lottery\DrawStatus;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Database\QueryException;
 
 /**
  * 按计划生成未来的 `draws` 行（期号、时间表）。

app/Services/Draw/DrawPublishService.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Draw;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
-use App\Models\AdminUser;
 use App\Models\Draw;
+use App\Models\AdminUser;
+use App\Lottery\DrawStatus;
 use App\Models\DrawResultBatch;
 use Illuminate\Support\Facades\DB;
+use App\Lottery\DrawResultBatchStatus;
 
 /**
  * 人工审核通过后发布结果；或 RNG 自动生成路径内联调用同一事务字段更新。

app/Services/Draw/DrawResultViewService.php

@@ -2,13 +2,13 @@
 
 namespace App\Services\Draw;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
+use App\Lottery\DrawStatus;
 use App\Models\DrawResultItem;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use App\Models\DrawResultBatch;
 use Illuminate\Support\Collection;
+use App\Lottery\DrawResultBatchStatus;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /**
  * 将已发布的 {@see DrawResultItem} 聚合成前端/文档约定结构。

app/Services/Draw/DrawRngRunner.php

@@ -2,14 +2,14 @@
 
 namespace App\Services\Draw;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawResultSourceType;
-use App\Lottery\DrawStatus;
-use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
 use Carbon\Carbon;
+use App\Models\Draw;
+use App\Lottery\DrawStatus;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
 use Illuminate\Support\Facades\DB;
+use App\Lottery\DrawResultSourceType;
+use App\Lottery\DrawResultBatchStatus;
 
 /**
  * 按配置执行 RNG，写入 {@see DrawResultBatch} / {@see DrawResultItem}。

app/Services/Draw/DrawTickService.php

@@ -2,11 +2,11 @@
 
 namespace App\Services\Draw;
 
-use App\Lottery\DrawStatus;
+use Carbon\Carbon;
 use App\Models\Draw;
+use App\Lottery\DrawStatus;
 use App\Services\LotterySettings;
 use App\Services\Settlement\SettlementOrchestrator;
-use Carbon\Carbon;
 
 /**
  * 每分钟调度：期号状态推进 → RNG（若到期号）→ 冷静期结束时进入结算态 → 补齐未来缓冲。

app/Services/Draw/LotteryHallRealtimeBroadcaster.php

@@ -3,8 +3,8 @@
 namespace App\Services\Draw;
 
 use App\Events\DrawCountdownBroadcast;
-use App\Events\DrawResultPublishedBroadcast;
 use App\Events\DrawStatusChangeBroadcast;
+use App\Events\DrawResultPublishedBroadcast;
 
 /**
  * 对齐界面文档 §2.1：`draw.countdown`、`draw.status_change`、`result.published`（频道 `lottery-hall`）。

app/Services/Jackpot/JackpotBurstAllocator.php

@@ -2,11 +2,11 @@
 
 namespace App\Services\Jackpot;
 
-use App\Lottery\DrawStatus;
 use App\Models\Draw;
-use App\Models\JackpotPayoutLog;
-use App\Models\JackpotPool;
 use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
+use App\Models\JackpotPool;
+use App\Models\JackpotPayoutLog;
 use Illuminate\Support\Collection;
 
 /**

app/Services/Jackpot/JackpotContributionService.php

@@ -3,9 +3,9 @@
 namespace App\Services\Jackpot;
 
 use App\Models\Draw;
-use App\Models\JackpotContribution;
-use App\Models\JackpotPool;
 use App\Models\TicketItem;
+use App\Models\JackpotPool;
+use App\Models\JackpotContribution;
 
 /**
  * 产品文档 §5.11.1：每笔有效注单按比例蓄水（在下注成功路径调用，非结算）。

app/Services/PlayerTokenResolver.php

@@ -2,13 +2,13 @@
 
 namespace App\Services;
 
-use App\Exceptions\PlayerAuthenticationException;
-use App\Lottery\ErrorCode;
-use App\Models\Player;
 use Firebase\JWT\JWT;
 use Firebase\JWT\Key;
-use Illuminate\Database\QueryException;
+use App\Models\Player;
+use App\Lottery\ErrorCode;
 use Illuminate\Http\Request;
+use Illuminate\Database\QueryException;
+use App\Exceptions\PlayerAuthenticationException;
 
 /**
  * 从请求头解析玩家身份，返回已落库的 {@see Player}。

app/Services/Settlement/Contracts/SettlementPlayMatcher.php

@@ -2,10 +2,10 @@
 
 namespace App\Services\Settlement\Contracts;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\PublishedDrawResultBoard;
+use App\Models\TicketCombination;
 use Illuminate\Support\Collection;
+use App\Services\Settlement\PublishedDrawResultBoard;
 
 interface SettlementPlayMatcher
 {

app/Services/Settlement/Matchers/BigSpreadSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /**
  * Big / 包号展开类：命中 23 档中**最优档**计奖（产品文档 Big / iBox / mBox / Box）。

app/Services/Settlement/Matchers/FirstPrizeComboSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /**
  * head / tail / odd / even / digit_big / digit_small：展开组合中若有与**头奖 4D** 完全一致则中奖（赔率档 first）。

app/Services/Settlement/Matchers/NoopSettlementMatcher.php

@@ -3,9 +3,9 @@
 namespace App\Services\Settlement\Matchers;
 
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
-use App\Services\Settlement\PublishedDrawResultBoard;
 use Illuminate\Support\Collection;
+use App\Services\Settlement\PublishedDrawResultBoard;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /**
  * 阶段 6 首轮未实现的玩法：不派奖（后续补位置类、单双等匹配器）。

app/Services/Settlement/Matchers/Pos2AbcSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /** pos_2abc：后二位命中头/二/三任意一档。 */
 final class Pos2AbcSettlementMatcher implements SettlementPlayMatcher

app/Services/Settlement/Matchers/Pos2TierSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /** pos_2a / pos_2b / pos_2c：后二位命中对应档。 */
 final class Pos2TierSettlementMatcher implements SettlementPlayMatcher

app/Services/Settlement/Matchers/Pos3AbcSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /** pos_3abc：后三位命中头/二/三任意一档；取最优档赔率。 */
 final class Pos3AbcSettlementMatcher implements SettlementPlayMatcher

app/Services/Settlement/Matchers/Pos3TierSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /** pos_3a / pos_3b / pos_3c：后三位命中对应档。头奖命中时 `matched_prize_tier` 为 first（Jackpot 口径）。 */
 final class Pos3TierSettlementMatcher implements SettlementPlayMatcher

app/Services/Settlement/Matchers/Pos4ExactTierSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /** pos_4a / pos_4b / pos_4c：与对应档完整 4D 一致。 */
 final class Pos4ExactTierSettlementMatcher implements SettlementPlayMatcher

app/Services/Settlement/Matchers/Pos4ListTierSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /** pos_4d（特别奖）/ pos_4e（安慰奖）：命中任意一组即中奖。 */
 final class Pos4ListTierSettlementMatcher implements SettlementPlayMatcher

app/Services/Settlement/Matchers/SmallSpreadSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /**
  * Small：仅头 / 二 / 三奖（产品文档 Small）。

app/Services/Settlement/Matchers/StraightLikeSettlementMatcher.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Settlement\Matchers;
 
-use App\Models\TicketCombination;
 use App\Models\TicketItem;
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
+use App\Models\TicketCombination;
+use Illuminate\Support\Collection;
 use App\Services\Settlement\OddsSnapshotReader;
 use App\Services\Settlement\PublishedDrawResultBoard;
-use Illuminate\Support\Collection;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 
 /**
  * 直选类：仅与**头奖**号码完全一致中奖（产品文档 Straight / 头奖口径）。

app/Services/Settlement/SettlementMatcherRegistry.php

@@ -2,18 +2,18 @@
 
 namespace App\Services\Settlement;
 
-use App\Services\Settlement\Contracts\SettlementPlayMatcher;
-use App\Services\Settlement\Matchers\BigSpreadSettlementMatcher;
-use App\Services\Settlement\Matchers\FirstPrizeComboSettlementMatcher;
 use App\Services\Settlement\Matchers\NoopSettlementMatcher;
+use App\Services\Settlement\Contracts\SettlementPlayMatcher;
 use App\Services\Settlement\Matchers\Pos2AbcSettlementMatcher;
-use App\Services\Settlement\Matchers\Pos2TierSettlementMatcher;
 use App\Services\Settlement\Matchers\Pos3AbcSettlementMatcher;
+use App\Services\Settlement\Matchers\Pos2TierSettlementMatcher;
 use App\Services\Settlement\Matchers\Pos3TierSettlementMatcher;
-use App\Services\Settlement\Matchers\Pos4ExactTierSettlementMatcher;
-use App\Services\Settlement\Matchers\Pos4ListTierSettlementMatcher;
+use App\Services\Settlement\Matchers\BigSpreadSettlementMatcher;
 use App\Services\Settlement\Matchers\SmallSpreadSettlementMatcher;
+use App\Services\Settlement\Matchers\Pos4ListTierSettlementMatcher;
 use App\Services\Settlement\Matchers\StraightLikeSettlementMatcher;
+use App\Services\Settlement\Matchers\Pos4ExactTierSettlementMatcher;
+use App\Services\Settlement\Matchers\FirstPrizeComboSettlementMatcher;
 
 final class SettlementMatcherRegistry
 {

app/Services/Settlement/SettlementOrchestrator.php

@@ -2,22 +2,22 @@
 
 namespace App\Services\Settlement;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
-use App\Lottery\SettlementBatchStatus;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
-use App\Models\JackpotPool;
 use App\Models\Player;
-use App\Models\SettlementBatch;
 use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
+use App\Models\JackpotPool;
 use App\Models\TicketOrder;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Models\SettlementBatch;
+use Illuminate\Support\Facades\DB;
+use App\Lottery\DrawResultBatchStatus;
+use App\Lottery\SettlementBatchStatus;
 use App\Models\TicketSettlementDetail;
-use App\Services\Jackpot\JackpotBurstAllocator;
 use App\Services\Ticket\RiskPoolService;
 use App\Services\Ticket\TicketWalletService;
-use Illuminate\Support\Facades\DB;
+use App\Services\Jackpot\JackpotBurstAllocator;
 
 /**
  * 阶段 6：对已发布开奖、处于 `settling` 的期号执行结算（匹配 → 回水派彩调整 → Jackpot 爆池分配 → 明细 → 风险池释放 → 入账）。

app/Services/Ticket/NumberNormalizer.php

@@ -2,8 +2,8 @@
 
 namespace App\Services\Ticket;
 
-use App\Exceptions\TicketOperationException;
 use App\Lottery\ErrorCode;
+use App\Exceptions\TicketOperationException;
 
 final class NumberNormalizer
 {

app/Services/Ticket/PlayCatalogResolver.php

@@ -2,17 +2,17 @@
 
 namespace App\Services\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Lottery\ConfigVersionStatus;
-use App\Lottery\ErrorCode;
 use App\Models\OddsItem;
-use App\Models\OddsVersion;
-use App\Models\PlayConfigItem;
-use App\Models\PlayConfigVersion;
 use App\Models\PlayType;
+use App\Lottery\ErrorCode;
+use App\Models\OddsVersion;
 use App\Models\RiskCapItem;
+use App\Models\PlayConfigItem;
 use App\Models\RiskCapVersion;
+use App\Models\PlayConfigVersion;
 use Illuminate\Support\Collection;
+use App\Lottery\ConfigVersionStatus;
+use App\Exceptions\TicketOperationException;
 
 final class PlayCatalogResolver
 {

app/Services/Ticket/PlayRuleEngine.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Lottery\ErrorCode;
 use App\Models\OddsItem;
-use App\Models\PlayConfigItem;
 use App\Models\PlayType;
+use App\Lottery\ErrorCode;
+use App\Models\PlayConfigItem;
 use Illuminate\Support\Collection;
+use App\Exceptions\TicketOperationException;
 
 final class PlayRuleEngine
 {

app/Services/Ticket/RiskPoolService.php

@@ -2,11 +2,11 @@
 
 namespace App\Services\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Lottery\ErrorCode;
 use App\Models\RiskPool;
-use App\Models\RiskPoolLockLog;
+use App\Lottery\ErrorCode;
 use App\Models\TicketItem;
+use App\Models\RiskPoolLockLog;
+use App\Exceptions\TicketOperationException;
 
 final class RiskPoolService
 {

app/Services/Ticket/TicketPlacementService.php

@@ -2,16 +2,16 @@
 
 namespace App\Services\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Lottery\DrawStatus;
-use App\Lottery\ErrorCode;
 use App\Models\Draw;
 use App\Models\Player;
-use App\Models\TicketCombination;
+use App\Lottery\ErrorCode;
 use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
 use App\Models\TicketOrder;
-use App\Services\Jackpot\JackpotContributionService;
+use App\Models\TicketCombination;
 use Illuminate\Support\Facades\DB;
+use App\Exceptions\TicketOperationException;
+use App\Services\Jackpot\JackpotContributionService;
 
 final class TicketPlacementService
 {

app/Services/Ticket/TicketPreviewService.php

@@ -2,10 +2,10 @@
 
 namespace App\Services\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Lottery\DrawStatus;
-use App\Lottery\ErrorCode;
 use App\Models\Draw;
+use App\Lottery\ErrorCode;
+use App\Lottery\DrawStatus;
+use App\Exceptions\TicketOperationException;
 
 final class TicketPreviewService
 {

app/Services/Ticket/TicketWalletService.php

@@ -2,12 +2,12 @@
 
 namespace App\Services\Ticket;
 
-use App\Exceptions\TicketOperationException;
-use App\Lottery\ErrorCode;
 use App\Models\Player;
-use App\Models\PlayerWallet;
-use App\Models\TicketOrder;
 use App\Models\WalletTxn;
+use App\Lottery\ErrorCode;
+use App\Models\TicketOrder;
+use App\Models\PlayerWallet;
+use App\Exceptions\TicketOperationException;
 
 final class TicketWalletService
 {

app/Services/Wallet/HttpMainSiteWalletGateway.php

@@ -3,8 +3,8 @@
 namespace App\Services\Wallet;
 
 use App\Models\Player;
-use GuzzleHttp\Exception\ConnectException;
 use Illuminate\Support\Facades\Http;
+use GuzzleHttp\Exception\ConnectException;
 
 /**
  * 通过 HTTP 调用主站钱包 API（路径见 config lottery.main_site.wallet_*_path）。

app/Services/Wallet/LotteryTransferService.php

@@ -2,17 +2,17 @@
 
 namespace App\Services\Wallet;
 
-use App\Exceptions\WalletOperationException;
-use App\Lottery\ErrorCode;
-use App\Models\Currency;
 use App\Models\Player;
+use App\Models\Currency;
+use App\Models\WalletTxn;
+use App\Lottery\ErrorCode;
+use Illuminate\Support\Str;
 use App\Models\PlayerWallet;
 use App\Models\TransferOrder;
-use App\Models\WalletTxn;
 use App\Services\LotterySettings;
-use Illuminate\Database\QueryException;
 use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Str;
+use Illuminate\Database\QueryException;
+use App\Exceptions\WalletOperationException;
 
 /**
  * 主站 ↔ 彩票钱包：转入 / 转出（幂等键 + 流水 + 订单）。

app/Support/AdminApiList.php

@@ -2,9 +2,9 @@
 
 namespace App\Support;
 
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
-use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /**
  * 后台标准列表：`items` + `meta`（current_page / per_page / total / last_page）。

app/Support/AdminConfigPresenter.php

@@ -3,12 +3,12 @@
 namespace App\Support;
 
 use App\Models\OddsItem;
-use App\Models\OddsVersion;
-use App\Models\PlayConfigItem;
-use App\Models\PlayConfigVersion;
 use App\Models\PlayType;
+use App\Models\OddsVersion;
 use App\Models\RiskCapItem;
+use App\Models\PlayConfigItem;
 use App\Models\RiskCapVersion;
+use App\Models\PlayConfigVersion;
 
 /** 后台 API：阶段 4 运营配置序列化（与其它 Admin*Controller 手写数组风格一致）。 */
 final class AdminConfigPresenter

app/Support/AdminMessage.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Support;
+
+use App\Lottery\ErrorCode;
+use Illuminate\Http\Request;
+
+/**
+ * 【管理后台业务文案翻译辅助类】
+ *
+ * 从 lang/{locale}/admin.php 等语言包取字符串，供 JSON 里「msg」字段使用。
+ * 与 LotteryMessage 对应，专门处理管理端错误消息。
+ */
+final class AdminMessage
+{
+    /**
+     * 取通用管理后台错误的用户可见文案（lang/{locale}/admin.php）。
+     *
+     * @param string $key 语言包键名，如 'unauthenticated', 'permission_denied'
+     */
+    public static function get(Request $request, string $key): string
+    {
+        $fallback = (string) config('lottery.locales.fallback', 'en');
+        $locale = (string) ($request->attributes->get('lottery_locale') ?? LotteryLocale::resolve($request));
+
+        $fullKey = 'admin.'.$key;
+        $msg = trans($fullKey, [], $locale);
+
+        if ($msg !== $fullKey) {
+            return $msg;
+        }
+
+        return trans($fullKey, [], $fallback);
+    }
+
+    /**
+     * 取错误码对应的用户可见文案。
+     *
+     * @param int $code {@see ErrorCode} 管理端段（8110–8114）
+     */
+    public static function errorCode(Request $request, int $code): string
+    {
+        $fallback = (string) config('lottery.locales.fallback', 'en');
+        $locale = (string) ($request->attributes->get('lottery_locale') ?? LotteryLocale::resolve($request));
+        $key = 'admin.'.$code;
+
+        $msg = trans($key, [], $locale);
+        if ($msg !== $key) {
+            return $msg;
+        }
+
+        return trans($key, [], $fallback);
+    }
+}

app/Support/ApiResponse.php

@@ -2,12 +2,13 @@
 
 namespace App\Support;
 
+use App\Lottery\ErrorCode;
 use Illuminate\Http\JsonResponse;
 
 /**
  * 对外 API 统一 JSON 结构：{ code, msg, data }。
  *
- * - `code=0` 即 {@see \App\Lottery\ErrorCode::Success}；非 0 见 `ErrorCode` 与 docs/04 §10。
+ * - `code=0` 即 {@see ErrorCode::Success}；非 0 见 `ErrorCode` 与 docs/04 §10。
  * - error() 的 HTTP 状态可与 code 独立（如鉴权失败 401 + code 8001）。
  */
 final class ApiResponse

app/Support/CurrencyResolver.php

@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Support;
+
+use App\Models\Player;
+use Illuminate\Http\Request;
+
+/**
+ * 币种码解析工具。
+ *
+ * 统一处理 Query/Body 中的 currency 参数，支持回退到玩家默认币种或全局配置。
+ */
+final class CurrencyResolver
+{
+    /**
+     * 从请求或玩家/配置回退解析币种码。
+     *
+     * @param  Request  $request  请求对象
+     * @param  Player|null  $player  玩家对象（用于回退）
+     * @param  string  $key  参数名（默认 currency）
+     * @param  string|null  $default  默认币种码（不传则使用 player->default_currency 或 config）
+     */
+    public static function resolve(
+        Request $request,
+        ?Player $player = null,
+        string $key = 'currency',
+        ?string $default = null,
+    ): string {
+        $raw = $request->input($key) ?? $request->query($key);
+
+        if (is_string($raw) && $raw !== '') {
+            $code = strtoupper(substr(trim($raw), 0, 16));
+        } else {
+            $fallback = $default
+                ?? $player?->default_currency
+                ?? config('lottery.default_currency', 'NPR');
+            $code = strtoupper(substr(trim((string) $fallback), 0, 16));
+        }
+
+        return $code;
+    }
+
+    /**
+     * 验证币种码格式是否合法。
+     *
+     * 合法格式：1-16 位字母数字，全大写。
+     */
+    public static function isValid(string $code): bool
+    {
+        return preg_match('/^[A-Z0-9]{1,16}$/', $code) === 1;
+    }
+
+    /**
+     * 解析并验证币种码，无效时返回 null。
+     */
+    public static function resolveOrNull(
+        Request $request,
+        ?Player $player = null,
+        string $key = 'currency',
+        ?string $default = null,
+    ): ?string {
+        $code = self::resolve($request, $player, $key, $default);
+
+        return self::isValid($code) ? $code : null;
+    }
+}

app/Support/OddsStandardScopes.php

@@ -4,8 +4,8 @@ namespace App\Support;
 
 use App\Models\Currency;
 use App\Models\OddsItem;
-use App\Models\OddsVersion;
 use App\Models\PlayType;
+use App\Models\OddsVersion;
 use Illuminate\Support\Facades\DB;
 
 /**

app/Support/PaginationTrait.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Support;
+
+use Illuminate\Http\Request;
+
+/**
+ * 分页请求参数解析 trait。
+ *
+ * 统一处理 `page`、`per_page`/`size` 参数的合法化。
+ */
+trait PaginationTrait
+{
+    /**
+     * 解析并限制每页条数。
+     *
+     * @param  Request  $request  请求对象
+     * @param  string  $key  参数名（默认 per_page）
+     * @param  int  $default  默认值
+     * @param  int  $max  最大值上限
+     */
+    protected function perPage(Request $request, string $key = 'per_page', int $default = 20, int $max = 50): int
+    {
+        $value = (int) $request->query($key, $request->query('size', $default));
+
+        return max(1, min($max, $value));
+    }
+
+    /**
+     * 解析当前页码（强制至少为 1）。
+     */
+    protected function page(Request $request, string $key = 'page', int $default = 1): int
+    {
+        return max(1, (int) $request->query($key, $default));
+    }
+
+    /**
+     * 解析分页元数据数组。
+     *
+     * @return array{page: int, per_page: int}
+     */
+    protected function paginationMeta(Request $request, int $defaultPerPage = 20, int $maxPerPage = 50): array
+    {
+        return [
+            'page' => $this->page($request),
+            'per_page' => $this->perPage($request, 'per_page', $defaultPerPage, $maxPerPage),
+        ];
+    }
+}

bootstrap/app.php

@@ -9,21 +9,21 @@
 |--------------------------------------------------------------------------
 */
 
-use App\Http\Middleware\EnsureAdminApi;
-use App\Http\Middleware\EnsureAdminPermission;
-use App\Http\Middleware\EnsurePlayerApi;
-use App\Http\Middleware\NegotiateLotteryLocale;
 use App\Lottery\ErrorCode;
 use App\Support\ApiResponse;
+use Illuminate\Http\Request;
 use App\Support\LotteryLocale;
-use Illuminate\Auth\AuthenticationException;
-use Illuminate\Console\Scheduling\Schedule;
-use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Illuminate\Foundation\Application;
+use App\Http\Middleware\EnsureAdminApi;
+use App\Http\Middleware\EnsurePlayerApi;
+use Illuminate\Console\Scheduling\Schedule;
+use Illuminate\Auth\AuthenticationException;
+use App\Http\Middleware\EnsureAdminPermission;
+use Illuminate\Validation\ValidationException;
+use App\Http\Middleware\NegotiateLotteryLocale;
 use Illuminate\Foundation\Configuration\Exceptions;
 use Illuminate\Foundation\Configuration\Middleware;
-use Illuminate\Http\Request;
-use Illuminate\Validation\ValidationException;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Symfony\Component\HttpKernel\Exception\HttpException;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;

config/app.php

@@ -1,7 +1,6 @@
 <?php
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Application Name
@@ -122,5 +121,4 @@ return [
         'driver' => env('APP_MAINTENANCE_DRIVER', 'file'),
         'store' => env('APP_MAINTENANCE_STORE', 'database'),
     ],
-
 ];

config/auth.php

@@ -3,7 +3,6 @@
 use App\Models\AdminUser;
 
 return [
-
     'defaults' => [
         'guard' => env('AUTH_GUARD', 'web'),
         'passwords' => env('AUTH_PASSWORD_BROKER', 'admin_users'),
@@ -37,5 +36,4 @@ return [
     ],
 
     'password_timeout' => env('AUTH_PASSWORD_TIMEOUT', 10800),
-
 ];

config/broadcasting.php

@@ -1,7 +1,6 @@
 <?php
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Broadcaster
@@ -29,7 +28,6 @@ return [
     */
 
     'connections' => [
-
         'reverb' => [
             'driver' => 'reverb',
             'key' => env('REVERB_APP_KEY'),
@@ -76,7 +74,5 @@ return [
         'null' => [
             'driver' => 'null',
         ],
-
     ],
-
 ];

config/cache.php

@@ -3,7 +3,6 @@
 use Illuminate\Support\Str;
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Cache Store
@@ -33,7 +32,6 @@ return [
     */
 
     'stores' => [
-
         'array' => [
             'driver' => 'array',
             'serialize' => false,
@@ -98,7 +96,6 @@ return [
                 'array',
             ],
         ],
-
     ],
 
     /*
@@ -126,5 +123,4 @@ return [
     */
 
     'serializable_classes' => false,
-
 ];

config/database.php

@@ -1,10 +1,9 @@
 <?php
 
-use Illuminate\Support\Str;
 use Pdo\Mysql;
+use Illuminate\Support\Str;
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Database Connection Name
@@ -31,7 +30,6 @@ return [
     */
 
     'connections' => [
-
         'sqlite' => [
             'driver' => 'sqlite',
             'url' => env('DB_URL'),
@@ -113,7 +111,6 @@ return [
             // 'encrypt' => env('DB_ENCRYPT', 'yes'),
             // 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'),
         ],
-
     ],
 
     /*
@@ -144,7 +141,6 @@ return [
     */
 
     'redis' => [
-
         'client' => env('REDIS_CLIENT', 'phpredis'),
 
         'options' => [
@@ -178,7 +174,5 @@ return [
             'backoff_base' => env('REDIS_BACKOFF_BASE', 100),
             'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),
         ],
-
     ],
-
 ];

config/filesystems.php

@@ -1,7 +1,6 @@
 <?php
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Filesystem Disk
@@ -29,7 +28,6 @@ return [
     */
 
     'disks' => [
-
         'local' => [
             'driver' => 'local',
             'root' => storage_path('app/private'),
@@ -59,7 +57,6 @@ return [
             'throw' => false,
             'report' => false,
         ],
-
     ],
 
     /*
@@ -76,5 +73,4 @@ return [
     'links' => [
         public_path('storage') => storage_path('app/public'),
     ],
-
 ];

config/logging.php

@@ -6,7 +6,6 @@ use Monolog\Handler\SyslogUdpHandler;
 use Monolog\Processor\PsrLogMessageProcessor;
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Log Channel
@@ -51,7 +50,6 @@ return [
     */
 
     'channels' => [
-
         'stack' => [
             'driver' => 'stack',
             'channels' => explode(',', (string) env('LOG_STACK', 'single')),
@@ -126,7 +124,5 @@ return [
         'emergency' => [
             'path' => storage_path('logs/laravel.log'),
         ],
-
     ],
-
 ];

config/lottery.php

@@ -9,7 +9,6 @@
  */
 
 return [
-
     'locales' => [
         'supported' => ['zh', 'en', 'ne'],
         'fallback' => 'en',
@@ -80,5 +79,4 @@ return [
         /** 结果发布后的冷静期（分钟），{@see draws.cooling_end_time} */
         'cooldown_minutes' => max(0, (int) env('LOTTERY_DRAW_COOLDOWN_MINUTES', 15)),
     ],
-
 ];

config/mail.php

@@ -1,7 +1,6 @@
 <?php
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Mailer
@@ -36,7 +35,6 @@ return [
     */
 
     'mailers' => [
-
         'smtp' => [
             'transport' => 'smtp',
             'scheme' => env('MAIL_SCHEME'),
@@ -96,7 +94,6 @@ return [
             ],
             'retry_after' => 60,
         ],
-
     ],
 
     /*
@@ -114,5 +111,4 @@ return [
         'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
         'name' => env('MAIL_FROM_NAME', env('APP_NAME', 'Laravel')),
     ],
-
 ];

config/queue.php

@@ -1,7 +1,6 @@
 <?php
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Queue Connection Name
@@ -30,7 +29,6 @@ return [
     */
 
     'connections' => [
-
         'sync' => [
             'driver' => 'sync',
         ],
@@ -88,7 +86,6 @@ return [
                 'deferred',
             ],
         ],
-
     ],
 
     /*
@@ -125,5 +122,4 @@ return [
         'database' => env('DB_CONNECTION', 'sqlite'),
         'table' => 'failed_jobs',
     ],
-
 ];

config/reverb.php

@@ -1,7 +1,6 @@
 <?php
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Reverb Server
@@ -27,7 +26,6 @@ return [
     */
 
     'servers' => [
-
         'reverb' => [
             'host' => env('REVERB_SERVER_HOST', '0.0.0.0'),
             'port' => env('REVERB_SERVER_PORT', 8080),
@@ -53,7 +51,6 @@ return [
             'pulse_ingest_interval' => env('REVERB_PULSE_INGEST_INTERVAL', 15),
             'telescope_ingest_interval' => env('REVERB_TELESCOPE_INGEST_INTERVAL', 15),
         ],
-
     ],
 
     /*
@@ -68,7 +65,6 @@ return [
     */
 
     'apps' => [
-
         'provider' => 'config',
 
         'apps' => [
@@ -96,7 +92,5 @@ return [
                 ],
             ],
         ],
-
     ],
-
 ];

config/sanctum.php

@@ -1,12 +1,11 @@
 <?php
 
-use Illuminate\Cookie\Middleware\EncryptCookies;
-use Illuminate\Foundation\Http\Middleware\ValidateCsrfToken;
-use Laravel\Sanctum\Http\Middleware\AuthenticateSession;
 use Laravel\Sanctum\Sanctum;
+use Illuminate\Cookie\Middleware\EncryptCookies;
+use Laravel\Sanctum\Http\Middleware\AuthenticateSession;
+use Illuminate\Foundation\Http\Middleware\ValidateCsrfToken;
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Stateful Domains
@@ -83,5 +82,4 @@ return [
         'encrypt_cookies' => EncryptCookies::class,
         'validate_csrf_token' => ValidateCsrfToken::class,
     ],
-
 ];

config/services.php

@@ -1,7 +1,6 @@
 <?php
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Third Party Services
@@ -34,5 +33,4 @@ return [
             'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'),
         ],
     ],
-
 ];

config/session.php

@@ -3,7 +3,6 @@
 use Illuminate\Support\Str;
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Session Driver
@@ -229,5 +228,4 @@ return [
     */
 
     'serialization' => 'json',
-
 ];

database/migrations/0001_01_01_000000_create_users_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/0001_01_01_000001_create_cache_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/0001_01_01_000002_create_jobs_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100000_create_currencies_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100001_create_players_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100002_create_admin_users_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100003_create_admin_roles_and_permissions_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100004_create_player_wallets_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100005_create_wallet_txns_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100006_create_transfer_orders_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100007_create_draws_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100008_create_draw_result_batches_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_100009_create_draw_result_items_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_120000_drop_laravel_default_users_and_password_reset_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 /**
  * 默认 User 登录未使用：业务玩家为 players，后台为 admin_users。

database/migrations/2026_05_08_130000_create_play_types_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130001_create_play_config_versions_and_items_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130002_create_odds_versions_and_items_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130003_create_risk_cap_versions_and_items_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130004_create_ticket_orders_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130005_create_ticket_items_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130006_create_ticket_combinations_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130007_create_risk_pools_and_lock_logs_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130008_create_settlement_and_jackpot_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_130009_create_report_audit_reconcile_tables.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_08_140000_create_lottery_settings_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 /**
  * 【任务 3 · 配置中心】键值运行时配置。

database/migrations/2026_05_09_023835_create_personal_access_tokens_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_09_120000_add_username_and_nullable_email_to_admin_users.php

@@ -1,10 +1,10 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Str;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Schema;
-use Illuminate\Support\Str;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_09_120000_migrate_draw_status_to_domain_dict.php

@@ -1,7 +1,7 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Database\Migrations\Migration;
 
 /**
  * 将旧版期号状态值迁移为《04-领域字典》约定。

database/migrations/2026_05_11_120000_add_admin_user_id_to_reconcile_jobs_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_11_173000_create_admin_user_permissions_table.php

@@ -1,8 +1,8 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/migrations/2026_05_13_100000_rebuild_admin_authorization_system.php

@@ -1,10 +1,10 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 return new class extends Migration
 {

database/seeders/AdminRbacAndUserSeeder.php

@@ -4,16 +4,16 @@ namespace Database\Seeders;
 
 use App\Models\AdminRole;
 use App\Models\AdminUser;
-use App\Support\AdminPermissionBridge;
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
+use App\Support\AdminPermissionBridge;
 
 /**
  * 后台 RBAC：与 {@see AdminUser::ROLE_SUPER_ADMIN} 及 `config/admin_permissions.php` 对齐。
  *
  * 演示账号 **admin** / **123456**（仅限非 production）。
  */
-class AdminRbacAndUserSeeder extends Seeder
+final class AdminRbacAndUserSeeder extends Seeder
 {
     /** @param  list<string>  $legacySlugs */
     private function syncRoleMenuActions(AdminRole $role, array $legacySlugs): void

database/seeders/CurrencySeeder.php

@@ -8,7 +8,7 @@ use Illuminate\Support\Facades\DB;
 /**
  * 写入 `currencies`，与 `docs/04`、`LOTTERY_DEFAULT_CURRENCY` 对齐。
  */
-class CurrencySeeder extends Seeder
+final class CurrencySeeder extends Seeder
 {
     public function run(): void
     {

database/seeders/DashboardHallFixtureSeeder.php

@@ -2,19 +2,19 @@
 
 namespace Database\Seeders;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
+use Carbon\Carbon;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
 use App\Models\Player;
 use App\Models\RiskPool;
 use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
 use App\Models\TicketOrder;
 use App\Models\TransferOrder;
-use App\Services\Draw\DrawHallSnapshotBuilder;
-use Carbon\Carbon;
+use App\Models\DrawResultBatch;
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
+use App\Lottery\DrawResultBatchStatus;
+use App\Services\Draw\DrawHallSnapshotBuilder;
 
 /**
  * 【仪表盘 / 大厅当期】向 **当前大厅 resolve 指向的期号** 写入丰富演示数据（财务、风控、开奖批次、异常转账）。
@@ -25,7 +25,7 @@ use Illuminate\Support\Facades\DB;
  * php artisan db:seed --class="Database\\Seeders\\DashboardHallFixtureSeeder"
  * ```
  */
-class DashboardHallFixtureSeeder extends Seeder
+final class DashboardHallFixtureSeeder extends Seeder
 {
     public function run(): void
     {

database/seeders/DashboardSecondaryScenariosSeeder.php

@@ -2,18 +2,18 @@
 
 namespace Database\Seeders;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
-use App\Lottery\SettlementBatchStatus;
-use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
-use App\Models\RiskPool;
-use App\Models\SettlementBatch;
-use App\Services\Draw\DrawPrizeLayout;
 use Carbon\Carbon;
+use App\Models\Draw;
+use App\Models\RiskPool;
+use App\Lottery\DrawStatus;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Models\SettlementBatch;
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
+use App\Lottery\DrawResultBatchStatus;
+use App\Lottery\SettlementBatchStatus;
+use App\Services\Draw\DrawPrizeLayout;
 
 /**
  * 【多场景演示】额外写入几条 **非大厅当期** 的期号与数据，便于列表、开奖结果、结算摘要等联调。
@@ -25,7 +25,7 @@ use Illuminate\Support\Facades\DB;
  * php artisan db:seed --class="Database\\Seeders\\DashboardSecondaryScenariosSeeder"
  * ```
  */
-class DashboardSecondaryScenariosSeeder extends Seeder
+final class DashboardSecondaryScenariosSeeder extends Seeder
 {
     public function run(): void
     {

database/seeders/DatabaseSeeder.php

@@ -2,10 +2,10 @@
 
 namespace Database\Seeders;
 
-use Illuminate\Database\Console\Seeds\WithoutModelEvents;
 use Illuminate\Database\Seeder;
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
 
-class DatabaseSeeder extends Seeder
+final class DatabaseSeeder extends Seeder
 {
     use WithoutModelEvents;
 

database/seeders/DevPlayerAndWalletSeeder.php

@@ -12,7 +12,7 @@ use Illuminate\Database\Seeder;
  *
  * fixed site_code + site_player_id 便于之后在 JWT / 脚本里对上号（非生产数据）。
  */
-class DevPlayerAndWalletSeeder extends Seeder
+final class DevPlayerAndWalletSeeder extends Seeder
 {
     public function run(): void
     {

database/seeders/DrawDemoSeeder.php

@@ -2,14 +2,14 @@
 
 namespace Database\Seeders;
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
-use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
-use App\Services\Draw\DrawPrizeLayout;
 use Carbon\Carbon;
+use App\Models\Draw;
+use App\Lottery\DrawStatus;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
 use Illuminate\Database\Seeder;
+use App\Lottery\DrawResultBatchStatus;
+use App\Services\Draw\DrawPrizeLayout;
 
 /**
  * 【本地演示】写入若干条 `draws` + 一条带完整 23 组开奖，便于前端大厅 / 开奖结果联调。
@@ -22,7 +22,7 @@ use Illuminate\Database\Seeder;
  * php artisan db:seed --class="Database\\Seeders\\DrawDemoSeeder"
  * ```
  */
-class DrawDemoSeeder extends Seeder
+final class DrawDemoSeeder extends Seeder
 {
     public function run(): void
     {

database/seeders/LotterySettingsSeeder.php

@@ -2,13 +2,13 @@
 
 namespace Database\Seeders;
 
-use App\Services\LotterySettings;
 use Illuminate\Database\Seeder;
+use App\Services\LotterySettings;
 
 /**
  * 【配置中心】示例键；后续由运营后台维护同表即可。
  */
-class LotterySettingsSeeder extends Seeder
+final class LotterySettingsSeeder extends Seeder
 {
     public function run(): void
     {

database/seeders/OddsPrizeScopesBackfillSeeder.php

@@ -3,13 +3,13 @@
 namespace Database\Seeders;
 
 use App\Models\OddsVersion;
-use App\Support\OddsStandardScopes;
 use Illuminate\Database\Seeder;
+use App\Support\OddsStandardScopes;
 
 /**
  * 为历史 odds_versions 补全 §5.5 五档 prize_scope（幂等，可重复执行）。
  */
-class OddsPrizeScopesBackfillSeeder extends Seeder
+final class OddsPrizeScopesBackfillSeeder extends Seeder
 {
     public function run(): void
     {

database/seeders/OperationalConfigV1Seeder.php

@@ -2,24 +2,24 @@
 
 namespace Database\Seeders;
 
-use App\Lottery\ConfigVersionStatus;
 use App\Models\OddsItem;
-use App\Models\OddsVersion;
-use App\Models\PlayConfigItem;
-use App\Models\PlayConfigVersion;
 use App\Models\PlayType;
+use App\Models\OddsVersion;
 use App\Models\RiskCapItem;
+use App\Models\PlayConfigItem;
 use App\Models\RiskCapVersion;
-use App\Support\OddsStandardScopes;
 use Illuminate\Database\Seeder;
+use App\Models\PlayConfigVersion;
 use Illuminate\Support\Facades\DB;
+use App\Support\OddsStandardScopes;
+use App\Lottery\ConfigVersionStatus;
 
 /**
  * 阶段 4：写入首套 **active** 玩法配置 / 赔率 / 风控封顶版本（依赖 {@see PlayTypeSeeder}、{@see CurrencySeeder}）。
  *
  * 幂等：仅当三套版本均已有 active 行时跳过；否则只补缺失的一类（避免「仅有 play active 时整段被跳过」导致 /play/effective 不可用）。
  */
-class OperationalConfigV1Seeder extends Seeder
+final class OperationalConfigV1Seeder extends Seeder
 {
     public function run(): void
     {

database/seeders/PlayTypeSeeder.php

@@ -5,7 +5,7 @@ namespace Database\Seeders;
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
 
-class PlayTypeSeeder extends Seeder
+final class PlayTypeSeeder extends Seeder
 {
     public function run(): void
     {

pint.json

@@ -0,0 +1,29 @@
+{
+    "preset": "laravel",
+    "rules": {
+        "declare_strict_types": false,
+        "final_class": true,
+        "final_public_method_for_abstract_class": true,
+        "ordered_imports": {
+            "sort_algorithm": "length"
+        },
+        "no_extra_blank_lines": {
+            "tokens": [
+                "attribute",
+                "break",
+                "case",
+                "continue",
+                "curly_brace_block",
+                "default",
+                "extra",
+                "parenthesis_brace_block",
+                "return",
+                "square_brace_block",
+                "switch",
+                "throw",
+                "use",
+                "use_trait"
+            ]
+        }
+    }
+}

public/index.php

@@ -1,7 +1,7 @@
 <?php
 
-use Illuminate\Foundation\Application;
 use Illuminate\Http\Request;
+use Illuminate\Foundation\Application;
 
 define('LARAVEL_START', microtime(true));
 

routes/api.php

@@ -1,79 +1,5 @@
 <?php
 
-use App\Http\Controllers\Api\V1\Admin\Audit\AuditLogIndexController;
-use App\Http\Controllers\Api\V1\Admin\Auth\CaptchaController;
-use App\Http\Controllers\Api\V1\Admin\Auth\LoginController;
-use App\Http\Controllers\Api\V1\Admin\Config\OddsItemsReplaceController;
-use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionIndexController;
-use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionPublishController;
-use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionShowController;
-use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionStoreController;
-use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigItemsReplaceController;
-use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionIndexController;
-use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionPublishController;
-use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionShowController;
-use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionStoreController;
-use App\Http\Controllers\Api\V1\Admin\Config\RiskCapItemsReplaceController;
-use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionIndexController;
-use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionPublishController;
-use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionShowController;
-use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionStoreController;
-use App\Http\Controllers\Api\V1\Admin\Dashboard\AdminDashboardController;
-use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawFinanceSummaryController;
-use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawIndexController;
-use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawResultBatchesIndexController;
-use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawShowController;
-use App\Http\Controllers\Api\V1\Admin\Draw\DrawResultBatchPublishController;
-use App\Http\Controllers\Api\V1\Admin\Draw\DrawSettlementRunController;
-use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotContributionIndexController;
-use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotPayoutLogIndexController;
-use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotPoolIndexController;
-use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotPoolUpdateController;
-use App\Http\Controllers\Api\V1\Admin\PingController as AdminPingController;
-use App\Http\Controllers\Api\V1\Admin\Player\AdminPlayerTicketItemsIndexController;
-use App\Http\Controllers\Api\V1\Admin\Player\PlayerWalletShowController;
-use App\Http\Controllers\Api\V1\Admin\PlayTypeIndexController;
-use App\Http\Controllers\Api\V1\Admin\PlayTypePatchController;
-use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileItemIndexController;
-use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileJobIndexController;
-use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileJobShowController;
-use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileJobStoreController;
-use App\Http\Controllers\Api\V1\Admin\Reports\ReportJobIndexController;
-use App\Http\Controllers\Api\V1\Admin\Reports\ReportJobShowController;
-use App\Http\Controllers\Api\V1\Admin\Reports\ReportJobStoreController;
-use App\Http\Controllers\Api\V1\Admin\Risk\AdminRiskPoolIndexController;
-use App\Http\Controllers\Api\V1\Admin\Risk\AdminRiskPoolLockLogIndexController;
-use App\Http\Controllers\Api\V1\Admin\Risk\AdminRiskPoolShowController;
-use App\Http\Controllers\Api\V1\Admin\Settlement\AdminSettlementBatchDetailsController;
-use App\Http\Controllers\Api\V1\Admin\Settlement\AdminSettlementBatchIndexController;
-use App\Http\Controllers\Api\V1\Admin\Settlement\AdminSettlementBatchShowController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminPermissionCatalogController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminUserDestroyController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminUserIndexController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminUserPermissionSyncController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminUserRoleSyncController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminUserShowController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminUserStoreController;
-use App\Http\Controllers\Api\V1\Admin\User\AdminUserUpdateController;
-use App\Http\Controllers\Api\V1\Admin\Wallet\TransferOrderListController;
-use App\Http\Controllers\Api\V1\Admin\Wallet\WalletTransactionListController;
-use App\Http\Controllers\Api\V1\Draw\DrawCurrentController;
-use App\Http\Controllers\Api\V1\Draw\DrawResultShowController;
-use App\Http\Controllers\Api\V1\Draw\DrawResultsIndexController;
-use App\Http\Controllers\Api\V1\HealthController;
-use App\Http\Controllers\Api\V1\Jackpot\JackpotSummaryController;
-use App\Http\Controllers\Api\V1\Play\PlayEffectiveCatalogController;
-use App\Http\Controllers\Api\V1\Player\MeController;
-use App\Http\Controllers\Api\V1\Player\PingController as PlayerPingController;
-use App\Http\Controllers\Api\V1\Ticket\TicketDrawMyMatchController;
-use App\Http\Controllers\Api\V1\Ticket\TicketItemShowController;
-use App\Http\Controllers\Api\V1\Ticket\TicketItemsIndexController;
-use App\Http\Controllers\Api\V1\Ticket\TicketPlaceController;
-use App\Http\Controllers\Api\V1\Ticket\TicketPreviewController;
-use App\Http\Controllers\Api\V1\Wallet\WalletBalanceController;
-use App\Http\Controllers\Api\V1\Wallet\WalletLogsController;
-use App\Http\Controllers\Api\V1\Wallet\WalletTransferInController;
-use App\Http\Controllers\Api\V1\Wallet\WalletTransferOutController;
 use Illuminate\Support\Facades\Route;
 
 /*
@@ -81,255 +7,42 @@ use Illuminate\Support\Facades\Route;
 */
 
 Route::prefix('v1')->group(function (): void {
-    // 名称：服务健康检查
-    Route::get('health', HealthController::class)->name('api.v1.health');
+    // 公开路由（无需登录）
+    require __DIR__.'/api/v1/public.php';
 
-    // 名称：当前期号（下注大厅倒计时；无需登录）
-    Route::get('draw/current', DrawCurrentController::class)->name('api.v1.draw.current');
-    // 名称：已发布开奖往期 / 单期（公开）
-    Route::get('draw/results', DrawResultsIndexController::class)->name('api.v1.draw.results');
-    Route::get('draw/results/{draw_no}', DrawResultShowController::class)
-        ->where('draw_no', '[0-9]{8}-[0-9]{3}')
-        ->name('api.v1.draw.results.show');
-
-    Route::get('jackpot/summary', JackpotSummaryController::class)->name('api.v1.jackpot.summary');
-
-    // 名称：生效玩法 / 赔率 / 封顶目录（阶段 4；公开）
-    Route::get('play/effective', PlayEffectiveCatalogController::class)->name('api.v1.play.effective');
-
-    Route::prefix('player')
-        ->name('api.v1.player.')
-        ->group(function (): void {
-            // 名称：玩家端连通性探测
-            Route::get('ping', PlayerPingController::class)->name('ping');
-        });
-
-    Route::middleware('lottery.player')->group(function (): void {
-        Route::prefix('player')
-            ->name('api.v1.player.')
-            ->group(function (): void {
-                // 名称：当前登录玩家信息
-                Route::get('me', MeController::class)->name('me');
-            });
-
-        Route::prefix('wallet')
-            ->name('api.v1.wallet.')
-            ->group(function (): void {
-                // 名称：彩票钱包余额查询
-                Route::get('balance', WalletBalanceController::class)->name('balance');
-                // 名称：钱包流水（PRD §10.1.1）
-                Route::get('logs', WalletLogsController::class)->name('logs');
-                // 名称：主站 → 彩票 转入
-                Route::post('transfer-in', WalletTransferInController::class)->name('transfer-in');
-                // 名称：彩票 → 主站 转出
-                Route::post('transfer-out', WalletTransferOutController::class)->name('transfer-out');
-            });
-
-        Route::prefix('ticket')
-            ->name('api.v1.ticket.')
-            ->group(function (): void {
-                Route::post('preview', TicketPreviewController::class)->name('preview');
-                Route::post('place', TicketPlaceController::class)->name('place');
-                Route::get('items', TicketItemsIndexController::class)->name('items.index');
-                Route::get('items/{ticket_no}', TicketItemShowController::class)
-                    ->where('ticket_no', 'TK[0-9]+')
-                    ->name('items.show');
-                Route::get('draws/{draw_no}/my-match', TicketDrawMyMatchController::class)
-                    ->where('draw_no', '[0-9]{8}-[0-9]{3}')
-                    ->name('draws.my-match');
-            });
-    });
+    // 玩家端路由（需 lottery.player）
+    require __DIR__.'/api/v1/player.php';
 
+    // 管理端路由（需 auth:sanctum + lottery.admin）
     Route::prefix('admin')
         ->name('api.v1.admin.')
+        ->middleware(['auth:sanctum', 'lottery.admin'])
         ->group(function (): void {
-            Route::middleware('throttle:admin-auth-captcha')
-                ->get('auth/captcha', CaptchaController::class)
-                ->name('auth.captcha');
+            // 认证路由（无需 Token，单独限流）
+            require __DIR__.'/api/v1/admin/auth.php';
 
-            Route::middleware('throttle:admin-auth-login')
-                ->post('auth/login', LoginController::class)
-                ->name('auth.login');
+            // 核心路由
+            require __DIR__.'/api/v1/admin/core.php';
 
-            Route::middleware(['auth:sanctum', 'lottery.admin'])->group(function (): void {
-                // 名称：后台接口连通性探测（需 Bearer Token；不校验细粒度 RBAC）
-                Route::get('ping', AdminPingController::class)->name('ping');
+            // 钱包/对账
+            require __DIR__.'/api/v1/admin/wallet.php';
 
-                /** 首页仪表盘：聚合大厅 + 当期财务/风控/待办计数（细粒度权限在控制器内按块判断） */
-                Route::get('dashboard', AdminDashboardController::class)->name('dashboard');
+            // 玩家管理
+            require __DIR__.'/api/v1/admin/player.php';
 
-                /** §8 钱包对账：超管可管、风控查看、财务可管、客服单用户 */
-                Route::middleware('admin.permission:prd.wallet_reconcile.manage|prd.wallet_reconcile.view|prd.wallet_reconcile.view_cs')->group(function (): void {
-                    Route::get('wallet/transfer-orders', TransferOrderListController::class)
-                        ->name('wallet.transfer-orders');
-                    Route::get('wallet/transactions', WalletTransactionListController::class)
-                        ->name('wallet.transactions');
-                });
+            // 开奖/风控/结算
+            require __DIR__.'/api/v1/admin/draw.php';
 
-                /** §8 用户管理：财务查看 / 客服单用户 / 超管可管 */
-                Route::middleware('admin.permission:prd.users.manage|prd.users.view_finance|prd.users.view_cs')->group(function (): void {
-                    Route::get('players/{player}/wallets', PlayerWalletShowController::class)
-                        ->name('players.wallets');
-                    /** §15.4 客服/财务：按玩家查注单 */
-                    Route::get('players/{player}/ticket-items', AdminPlayerTicketItemsIndexController::class)
-                        ->name('players.ticket-items.index');
-                });
+            // 奖池
+            require __DIR__.'/api/v1/admin/jackpot.php';
 
-                /** §8 开奖结果·查看 + 风控占用监控（与开奖/风险域一致） */
-                Route::middleware('admin.permission:prd.draw_result.manage|prd.draw_result.view')->group(function (): void {
-                    Route::get('draws', AdminDrawIndexController::class)->name('draws.index');
-                    Route::get('draws/{draw}', AdminDrawShowController::class)->name('draws.show');
-                    /** §15.4 单期投注/派彩汇总（与结算批次对照） */
-                    Route::get('draws/{draw}/finance-summary', AdminDrawFinanceSummaryController::class)
-                        ->name('draws.finance-summary');
-                    Route::get('draws/{draw}/result-batches', AdminDrawResultBatchesIndexController::class)
-                        ->name('draws.result-batches.index');
-                    Route::get('draws/{draw}/risk-pools/{number_4d}', AdminRiskPoolShowController::class)
-                        ->where('number_4d', '[0-9]{4}')
-                        ->name('draws.risk-pools.show');
-                    Route::get('draws/{draw}/risk-pool-lock-logs', AdminRiskPoolLockLogIndexController::class)
-                        ->name('draws.risk-pool-lock-logs.index');
-                    Route::get('draws/{draw}/risk-pools', AdminRiskPoolIndexController::class)
-                        ->name('draws.risk-pools.index');
-                });
+            // 配置
+            require __DIR__.'/api/v1/admin/config.php';
 
-                /** §8 开奖结果录入（发布批次） */
-                Route::middleware('admin.permission:prd.draw_result.manage')->group(function (): void {
-                    Route::post(
-                        'draws/{draw}/result-batches/{batch}/publish',
-                        DrawResultBatchPublishController::class,
-                    )->name('draws.result-batches.publish');
-                });
+            // 报表
+            require __DIR__.'/api/v1/admin/report.php';
 
-                /** §8 派彩确认：超管执行 + 风控审核 */
-                Route::middleware('admin.permission:prd.payout.manage|prd.payout.review')->group(function (): void {
-                    Route::post('draws/{draw}/settlement/run', DrawSettlementRunController::class)
-                        ->name('draws.settlement.run');
-                });
-
-                Route::middleware('admin.permission:prd.payout.manage|prd.payout.review|prd.payout.view')->group(function (): void {
-                    Route::get('settlement-batches', AdminSettlementBatchIndexController::class)
-                        ->name('settlement-batches.index');
-                    Route::get('settlement-batches/{batch}', AdminSettlementBatchShowController::class)
-                        ->name('settlement-batches.show');
-                    Route::get('settlement-batches/{batch}/details', AdminSettlementBatchDetailsController::class)
-                        ->name('settlement-batches.details');
-                });
-
-                Route::middleware('admin.permission:prd.jackpot.manage|prd.jackpot.view')->group(function (): void {
-                    Route::get('jackpot/pools', AdminJackpotPoolIndexController::class)->name('jackpot.pools.index');
-                    Route::get('jackpot/payout-logs', AdminJackpotPayoutLogIndexController::class)
-                        ->name('jackpot.payout-logs.index');
-                    Route::get('jackpot/contributions', AdminJackpotContributionIndexController::class)
-                        ->name('jackpot.contributions.index');
-                });
-
-                Route::middleware('admin.permission:prd.jackpot.manage')->group(function (): void {
-                    Route::put('jackpot/pools/{pool}', AdminJackpotPoolUpdateController::class)->name('jackpot.pools.update');
-                });
-
-                /** §8 玩法/玩法版本只读：财务不可（不含 rebate.view） */
-                Route::middleware('admin.permission:prd.play_switch.manage|prd.odds.manage')->group(function (): void {
-                    Route::get('play-types', PlayTypeIndexController::class)->name('play-types.index');
-                    Route::prefix('config')->name('config.')->group(function (): void {
-                        Route::get('play-versions', PlayConfigVersionIndexController::class)->name('play-versions.index');
-                        Route::get('play-versions/{id}', PlayConfigVersionShowController::class)
-                            ->whereNumber('id')
-                            ->name('play-versions.show');
-                    });
-                });
-
-                /** §8 赔率/回水只读：财务仅 rebate.view，不可单独看玩法版本 */
-                Route::middleware('admin.permission:prd.odds.manage|prd.rebate.manage|prd.rebate.view')->group(function (): void {
-                    Route::prefix('config')->name('config.')->group(function (): void {
-                        Route::get('odds-versions', OddsVersionIndexController::class)->name('odds-versions.index');
-                        Route::get('odds-versions/{id}', OddsVersionShowController::class)
-                            ->whereNumber('id')
-                            ->name('odds-versions.show');
-                    });
-                });
-
-                /** §8 封顶只读 */
-                Route::middleware('admin.permission:prd.risk_cap.manage|prd.risk_cap.view')->group(function (): void {
-                    Route::prefix('config')->name('config.')->group(function (): void {
-                        Route::get('risk-cap-versions', RiskCapVersionIndexController::class)->name('risk-cap-versions.index');
-                        Route::get('risk-cap-versions/{id}', RiskCapVersionShowController::class)
-                            ->whereNumber('id')
-                            ->name('risk-cap-versions.show');
-                    });
-                });
-
-                /** §8 玩法/赔率/封顶/回水/Jackpot 配置写 */
-                Route::middleware('admin.permission:prd.play_switch.manage|prd.odds.manage|prd.risk_cap.manage|prd.rebate.manage|prd.jackpot.manage')->group(function (): void {
-                    Route::patch('play-types/{play_code}', PlayTypePatchController::class)
-                        ->where('play_code', '[a-z0-9_]+')
-                        ->name('play-types.patch');
-                    Route::prefix('config')->name('config.')->group(function (): void {
-                        Route::post('play-versions', PlayConfigVersionStoreController::class)->name('play-versions.store');
-                        Route::put('play-versions/{id}/items', PlayConfigItemsReplaceController::class)
-                            ->whereNumber('id')
-                            ->name('play-versions.items.replace');
-                        Route::post('play-versions/{id}/publish', PlayConfigVersionPublishController::class)
-                            ->whereNumber('id')
-                            ->name('play-versions.publish');
-
-                        Route::post('odds-versions', OddsVersionStoreController::class)->name('odds-versions.store');
-                        Route::put('odds-versions/{id}/items', OddsItemsReplaceController::class)
-                            ->whereNumber('id')
-                            ->name('odds-versions.items.replace');
-                        Route::post('odds-versions/{id}/publish', OddsVersionPublishController::class)
-                            ->whereNumber('id')
-                            ->name('odds-versions.publish');
-
-                        Route::post('risk-cap-versions', RiskCapVersionStoreController::class)->name('risk-cap-versions.store');
-                        Route::put('risk-cap-versions/{id}/items', RiskCapItemsReplaceController::class)
-                            ->whereNumber('id')
-                            ->name('risk-cap-versions.items.replace');
-                        Route::post('risk-cap-versions/{id}/publish', RiskCapVersionPublishController::class)
-                            ->whereNumber('id')
-                            ->name('risk-cap-versions.publish');
-                    });
-                });
-
-                /** §8 审计日志：超管全部 / 风控自身 / 财务资金；客服无 */
-                Route::middleware('admin.permission:prd.audit.all|prd.audit.self|prd.audit.finance')->group(function (): void {
-                    Route::get('audit-logs', AuditLogIndexController::class)->name('audit-logs.index');
-                });
-
-                /** §8 报表 */
-                Route::middleware('admin.permission:prd.report.all|prd.report.risk|prd.report.finance|prd.report.player')->group(function (): void {
-                    Route::get('report-jobs', ReportJobIndexController::class)->name('report-jobs.index');
-                    Route::post('report-jobs', ReportJobStoreController::class)->name('report-jobs.store');
-                    Route::get('report-jobs/{report_job}', ReportJobShowController::class)
-                        ->name('report-jobs.show');
-                });
-
-                /** §8 钱包对账任务：查看含客服单用户；创建任务仅可管理（超管/财务） */
-                Route::middleware('admin.permission:prd.wallet_reconcile.manage|prd.wallet_reconcile.view|prd.wallet_reconcile.view_cs')->group(function (): void {
-                    Route::get('reconcile-jobs', ReconcileJobIndexController::class)->name('reconcile-jobs.index');
-                    Route::get('reconcile-jobs/{reconcile_job}', ReconcileJobShowController::class)
-                        ->name('reconcile-jobs.show');
-                    Route::get('reconcile-jobs/{reconcile_job}/items', ReconcileItemIndexController::class)
-                        ->name('reconcile-jobs.items.index');
-                });
-                Route::middleware('admin.permission:prd.wallet_reconcile.manage')->group(function (): void {
-                    Route::post('reconcile-jobs', ReconcileJobStoreController::class)->name('reconcile-jobs.store');
-                });
-
-                /** 后台账号与权限分配：仅可管理账户执行。 */
-                Route::middleware('admin.permission:prd.admin_user.manage')->group(function (): void {
-                    Route::get('admin-users', AdminUserIndexController::class)->name('admin-users.index');
-                    Route::post('admin-users', AdminUserStoreController::class)->name('admin-users.store');
-                    Route::get('admin-users/{admin_user}', AdminUserShowController::class)->name('admin-users.show');
-                    Route::put('admin-users/{admin_user}', AdminUserUpdateController::class)->name('admin-users.update');
-                    Route::delete('admin-users/{admin_user}', AdminUserDestroyController::class)->name('admin-users.destroy');
-                    Route::get('admin-user-permission-catalog', AdminPermissionCatalogController::class)
-                        ->name('admin-users.permission-catalog');
-                    Route::put('admin-users/{admin_user}/permissions', AdminUserPermissionSyncController::class)
-                        ->name('admin-users.permissions.sync');
-                    Route::put('admin-users/{admin_user}/roles', AdminUserRoleSyncController::class)
-                        ->name('admin-users.roles.sync');
-                });
-            });
+            // 管理员账号
+            require __DIR__.'/api/v1/admin/user.php';
         });
 });

routes/api/v1/admin/auth.php

@@ -0,0 +1,16 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\Auth\LoginController;
+use App\Http\Controllers\Api\V1\Admin\Auth\CaptchaController;
+
+/**
+ * 管理员认证路由（无需 Token，需验证码/限流）。
+ */
+Route::middleware('throttle:admin-auth-captcha')
+    ->get('auth/captcha', CaptchaController::class)
+    ->name('api.v1.admin.auth.captcha');
+
+Route::middleware('throttle:admin-auth-login')
+    ->post('auth/login', LoginController::class)
+    ->name('api.v1.admin.auth.login');

routes/api/v1/admin/config.php

@@ -0,0 +1,107 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\PlayTypeIndexController;
+use App\Http\Controllers\Api\V1\Admin\PlayTypePatchController;
+use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionShowController;
+use App\Http\Controllers\Api\V1\Admin\Config\OddsItemsReplaceController;
+use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionIndexController;
+use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionStoreController;
+use App\Http\Controllers\Api\V1\Admin\Config\OddsVersionPublishController;
+use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionShowController;
+use App\Http\Controllers\Api\V1\Admin\Config\RiskCapItemsReplaceController;
+use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionIndexController;
+use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionStoreController;
+use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionShowController;
+use App\Http\Controllers\Api\V1\Admin\Config\RiskCapVersionPublishController;
+use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigItemsReplaceController;
+use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionIndexController;
+use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionStoreController;
+use App\Http\Controllers\Api\V1\Admin\Config\PlayConfigVersionPublishController;
+
+/**
+ * 管理员配置管理路由（玩法/赔率/封顶）。
+ */
+
+// 玩法类型只读
+Route::middleware('admin.permission:prd.play_switch.manage|prd.odds.manage')
+    ->get('play-types', PlayTypeIndexController::class)
+    ->name('api.v1.admin.play-types.index');
+
+// 玩法版本只读
+Route::middleware('admin.permission:prd.play_switch.manage|prd.odds.manage')
+    ->prefix('config')
+    ->name('api.v1.admin.config.')
+    ->group(function (): void {
+        Route::get('play-versions', PlayConfigVersionIndexController::class)
+            ->name('play-versions.index');
+        Route::get('play-versions/{id}', PlayConfigVersionShowController::class)
+            ->whereNumber('id')
+            ->name('play-versions.show');
+    });
+
+// 赔率/回水只读
+Route::middleware('admin.permission:prd.odds.manage|prd.rebate.manage|prd.rebate.view')
+    ->prefix('config')
+    ->name('api.v1.admin.config.')
+    ->group(function (): void {
+        Route::get('odds-versions', OddsVersionIndexController::class)
+            ->name('odds-versions.index');
+        Route::get('odds-versions/{id}', OddsVersionShowController::class)
+            ->whereNumber('id')
+            ->name('odds-versions.show');
+    });
+
+// 封顶只读
+Route::middleware('admin.permission:prd.risk_cap.manage|prd.risk_cap.view')
+    ->prefix('config')
+    ->name('api.v1.admin.config.')
+    ->group(function (): void {
+        Route::get('risk-cap-versions', RiskCapVersionIndexController::class)
+            ->name('risk-cap-versions.index');
+        Route::get('risk-cap-versions/{id}', RiskCapVersionShowController::class)
+            ->whereNumber('id')
+            ->name('risk-cap-versions.show');
+    });
+
+// 玩法/赔率/封顶/Jackpot 配置写入
+Route::middleware('admin.permission:prd.play_switch.manage|prd.odds.manage|prd.risk_cap.manage|prd.rebate.manage|prd.jackpot.manage')
+    ->group(function (): void {
+        Route::patch('play-types/{play_code}', PlayTypePatchController::class)
+            ->where('play_code', '[a-z0-9_]+')
+            ->name('api.v1.admin.play-types.patch');
+
+        Route::prefix('config')
+            ->name('api.v1.admin.config.')
+            ->group(function (): void {
+                // 玩法版本写入
+                Route::post('play-versions', PlayConfigVersionStoreController::class)
+                    ->name('play-versions.store');
+                Route::put('play-versions/{id}/items', PlayConfigItemsReplaceController::class)
+                    ->whereNumber('id')
+                    ->name('play-versions.items.replace');
+                Route::post('play-versions/{id}/publish', PlayConfigVersionPublishController::class)
+                    ->whereNumber('id')
+                    ->name('play-versions.publish');
+
+                // 赔率版本写入
+                Route::post('odds-versions', OddsVersionStoreController::class)
+                    ->name('odds-versions.store');
+                Route::put('odds-versions/{id}/items', OddsItemsReplaceController::class)
+                    ->whereNumber('id')
+                    ->name('odds-versions.items.replace');
+                Route::post('odds-versions/{id}/publish', OddsVersionPublishController::class)
+                    ->whereNumber('id')
+                    ->name('odds-versions.publish');
+
+                // 封顶版本写入
+                Route::post('risk-cap-versions', RiskCapVersionStoreController::class)
+                    ->name('risk-cap-versions.store');
+                Route::put('risk-cap-versions/{id}/items', RiskCapItemsReplaceController::class)
+                    ->whereNumber('id')
+                    ->name('risk-cap-versions.items.replace');
+                Route::post('risk-cap-versions/{id}/publish', RiskCapVersionPublishController::class)
+                    ->whereNumber('id')
+                    ->name('risk-cap-versions.publish');
+            });
+    });

routes/api/v1/admin/core.php

@@ -0,0 +1,21 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\Audit\AuditLogIndexController;
+use App\Http\Controllers\Api\V1\Admin\Dashboard\AdminDashboardController;
+use App\Http\Controllers\Api\V1\Admin\PingController as AdminPingController;
+
+/**
+ * 管理员核心路由（需 auth:sanctum + lottery.admin）。
+ */
+
+// 连通性探测
+Route::get('ping', AdminPingController::class)->name('api.v1.admin.ping');
+
+// 首页仪表盘
+Route::get('dashboard', AdminDashboardController::class)->name('api.v1.admin.dashboard');
+
+// 审计日志
+Route::middleware('admin.permission:prd.audit.all|prd.audit.self|prd.audit.finance')
+    ->get('audit-logs', AuditLogIndexController::class)
+    ->name('api.v1.admin.audit-logs.index');

routes/api/v1/admin/draw.php

@@ -0,0 +1,60 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawShowController;
+use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawIndexController;
+use App\Http\Controllers\Api\V1\Admin\Draw\DrawSettlementRunController;
+use App\Http\Controllers\Api\V1\Admin\Risk\AdminRiskPoolShowController;
+use App\Http\Controllers\Api\V1\Admin\Risk\AdminRiskPoolIndexController;
+use App\Http\Controllers\Api\V1\Admin\Draw\DrawResultBatchPublishController;
+use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawFinanceSummaryController;
+use App\Http\Controllers\Api\V1\Admin\Risk\AdminRiskPoolLockLogIndexController;
+use App\Http\Controllers\Api\V1\Admin\Draw\AdminDrawResultBatchesIndexController;
+use App\Http\Controllers\Api\V1\Admin\Settlement\AdminSettlementBatchShowController;
+use App\Http\Controllers\Api\V1\Admin\Settlement\AdminSettlementBatchIndexController;
+use App\Http\Controllers\Api\V1\Admin\Settlement\AdminSettlementBatchDetailsController;
+
+/**
+ * 管理员开奖/风控/结算路由。
+ */
+
+// 开奖结果查看 + 风控监控
+Route::middleware('admin.permission:prd.draw_result.manage|prd.draw_result.view')
+    ->group(function (): void {
+        Route::get('draws', AdminDrawIndexController::class)
+            ->name('api.v1.admin.draws.index');
+        Route::get('draws/{draw}', AdminDrawShowController::class)
+            ->name('api.v1.admin.draws.show');
+        Route::get('draws/{draw}/finance-summary', AdminDrawFinanceSummaryController::class)
+            ->name('api.v1.admin.draws.finance-summary');
+        Route::get('draws/{draw}/result-batches', AdminDrawResultBatchesIndexController::class)
+            ->name('api.v1.admin.draws.result-batches.index');
+        Route::get('draws/{draw}/risk-pools/{number_4d}', AdminRiskPoolShowController::class)
+            ->where('number_4d', '[0-9]{4}')
+            ->name('api.v1.admin.draws.risk-pools.show');
+        Route::get('draws/{draw}/risk-pool-lock-logs', AdminRiskPoolLockLogIndexController::class)
+            ->name('api.v1.admin.draws.risk-pool-lock-logs.index');
+        Route::get('draws/{draw}/risk-pools', AdminRiskPoolIndexController::class)
+            ->name('api.v1.admin.draws.risk-pools.index');
+    });
+
+// 开奖结果录入（发布批次）
+Route::middleware('admin.permission:prd.draw_result.manage')
+    ->post('draws/{draw}/result-batches/{batch}/publish', DrawResultBatchPublishController::class)
+    ->name('api.v1.admin.draws.result-batches.publish');
+
+// 派彩确认
+Route::middleware('admin.permission:prd.payout.manage|prd.payout.review')
+    ->post('draws/{draw}/settlement/run', DrawSettlementRunController::class)
+    ->name('api.v1.admin.draws.settlement.run');
+
+// 结算批次查看
+Route::middleware('admin.permission:prd.payout.manage|prd.payout.review|prd.payout.view')
+    ->group(function (): void {
+        Route::get('settlement-batches', AdminSettlementBatchIndexController::class)
+            ->name('api.v1.admin.settlement-batches.index');
+        Route::get('settlement-batches/{batch}', AdminSettlementBatchShowController::class)
+            ->name('api.v1.admin.settlement-batches.show');
+        Route::get('settlement-batches/{batch}/details', AdminSettlementBatchDetailsController::class)
+            ->name('api.v1.admin.settlement-batches.details');
+    });

routes/api/v1/admin/jackpot.php

@@ -0,0 +1,27 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotPoolIndexController;
+use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotPoolUpdateController;
+use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotPayoutLogIndexController;
+use App\Http\Controllers\Api\V1\Admin\Jackpot\AdminJackpotContributionIndexController;
+
+/**
+ * 管理员奖池管理路由。
+ */
+
+// 奖池查看
+Route::middleware('admin.permission:prd.jackpot.manage|prd.jackpot.view')
+    ->group(function (): void {
+        Route::get('jackpot/pools', AdminJackpotPoolIndexController::class)
+            ->name('api.v1.admin.jackpot.pools.index');
+        Route::get('jackpot/payout-logs', AdminJackpotPayoutLogIndexController::class)
+            ->name('api.v1.admin.jackpot.payout-logs.index');
+        Route::get('jackpot/contributions', AdminJackpotContributionIndexController::class)
+            ->name('api.v1.admin.jackpot.contributions.index');
+    });
+
+// 奖池修改（仅管理权限）
+Route::middleware('admin.permission:prd.jackpot.manage')
+    ->put('jackpot/pools/{pool}', AdminJackpotPoolUpdateController::class)
+    ->name('api.v1.admin.jackpot.pools.update');

routes/api/v1/admin/player.php

@@ -0,0 +1,16 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\Player\PlayerWalletShowController;
+use App\Http\Controllers\Api\V1\Admin\Player\AdminPlayerTicketItemsIndexController;
+
+/**
+ * 管理员玩家管理路由。
+ */
+Route::middleware('admin.permission:prd.users.manage|prd.users.view_finance|prd.users.view_cs')
+    ->group(function (): void {
+        Route::get('players/{player}/wallets', PlayerWalletShowController::class)
+            ->name('api.v1.admin.players.wallets');
+        Route::get('players/{player}/ticket-items', AdminPlayerTicketItemsIndexController::class)
+            ->name('api.v1.admin.players.ticket-items.index');
+    });

routes/api/v1/admin/report.php

@@ -0,0 +1,19 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\Reports\ReportJobShowController;
+use App\Http\Controllers\Api\V1\Admin\Reports\ReportJobIndexController;
+use App\Http\Controllers\Api\V1\Admin\Reports\ReportJobStoreController;
+
+/**
+ * 管理员报表路由。
+ */
+Route::middleware('admin.permission:prd.report.all|prd.report.risk|prd.report.finance|prd.report.player')
+    ->group(function (): void {
+        Route::get('report-jobs', ReportJobIndexController::class)
+            ->name('api.v1.admin.report-jobs.index');
+        Route::post('report-jobs', ReportJobStoreController::class)
+            ->name('api.v1.admin.report-jobs.store');
+        Route::get('report-jobs/{report_job}', ReportJobShowController::class)
+            ->name('api.v1.admin.report-jobs.show');
+    });

routes/api/v1/admin/user.php

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\User\AdminUserShowController;
+use App\Http\Controllers\Api\V1\Admin\User\AdminUserIndexController;
+use App\Http\Controllers\Api\V1\Admin\User\AdminUserStoreController;
+use App\Http\Controllers\Api\V1\Admin\User\AdminUserUpdateController;
+use App\Http\Controllers\Api\V1\Admin\User\AdminUserDestroyController;
+use App\Http\Controllers\Api\V1\Admin\User\AdminUserRoleSyncController;
+use App\Http\Controllers\Api\V1\Admin\User\AdminPermissionCatalogController;
+use App\Http\Controllers\Api\V1\Admin\User\AdminUserPermissionSyncController;
+
+/**
+ * 管理员账号与权限管理路由。
+ */
+Route::middleware('admin.permission:prd.admin_user.manage')
+    ->group(function (): void {
+        Route::get('admin-users', AdminUserIndexController::class)
+            ->name('api.v1.admin.admin-users.index');
+        Route::post('admin-users', AdminUserStoreController::class)
+            ->name('api.v1.admin.admin-users.store');
+        Route::get('admin-users/{admin_user}', AdminUserShowController::class)
+            ->name('api.v1.admin.admin-users.show');
+        Route::put('admin-users/{admin_user}', AdminUserUpdateController::class)
+            ->name('api.v1.admin.admin-users.update');
+        Route::delete('admin-users/{admin_user}', AdminUserDestroyController::class)
+            ->name('api.v1.admin.admin-users.destroy');
+        Route::get('admin-user-permission-catalog', AdminPermissionCatalogController::class)
+            ->name('api.v1.admin.admin-users.permission-catalog');
+        Route::put('admin-users/{admin_user}/permissions', AdminUserPermissionSyncController::class)
+            ->name('api.v1.admin.admin-users.permissions.sync');
+        Route::put('admin-users/{admin_user}/roles', AdminUserRoleSyncController::class)
+            ->name('api.v1.admin.admin-users.roles.sync');
+    });

routes/api/v1/admin/wallet.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Admin\Wallet\TransferOrderListController;
+use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileJobShowController;
+use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileJobIndexController;
+use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileJobStoreController;
+use App\Http\Controllers\Api\V1\Admin\Reconcile\ReconcileItemIndexController;
+use App\Http\Controllers\Api\V1\Admin\Wallet\WalletTransactionListController;
+
+/**
+ * 管理员钱包/对账路由。
+ */
+
+// 钱包对账查看
+Route::middleware('admin.permission:prd.wallet_reconcile.manage|prd.wallet_reconcile.view|prd.wallet_reconcile.view_cs')
+    ->group(function (): void {
+        Route::get('wallet/transfer-orders', TransferOrderListController::class)
+            ->name('api.v1.admin.wallet.transfer-orders');
+        Route::get('wallet/transactions', WalletTransactionListController::class)
+            ->name('api.v1.admin.wallet.transactions');
+
+        // 对账任务查看
+        Route::get('reconcile-jobs', ReconcileJobIndexController::class)
+            ->name('api.v1.admin.reconcile-jobs.index');
+        Route::get('reconcile-jobs/{reconcile_job}', ReconcileJobShowController::class)
+            ->name('api.v1.admin.reconcile-jobs.show');
+        Route::get('reconcile-jobs/{reconcile_job}/items', ReconcileItemIndexController::class)
+            ->name('api.v1.admin.reconcile-jobs.items.index');
+    });
+
+// 对账任务创建（仅管理权限）
+Route::middleware('admin.permission:prd.wallet_reconcile.manage')
+    ->post('reconcile-jobs', ReconcileJobStoreController::class)
+    ->name('api.v1.admin.reconcile-jobs.store');

routes/api/v1/player.php

@@ -0,0 +1,50 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\Player\MeController;
+use App\Http\Controllers\Api\V1\Wallet\WalletLogsController;
+use App\Http\Controllers\Api\V1\Ticket\TicketPlaceController;
+use App\Http\Controllers\Api\V1\Ticket\TicketPreviewController;
+use App\Http\Controllers\Api\V1\Wallet\WalletBalanceController;
+use App\Http\Controllers\Api\V1\Ticket\TicketItemShowController;
+use App\Http\Controllers\Api\V1\Ticket\TicketItemsIndexController;
+use App\Http\Controllers\Api\V1\Wallet\WalletTransferInController;
+use App\Http\Controllers\Api\V1\Ticket\TicketDrawMyMatchController;
+use App\Http\Controllers\Api\V1\Wallet\WalletTransferOutController;
+
+/**
+ * 玩家端路由（需 middleware lottery.player）。
+ */
+Route::middleware('lottery.player')->group(function (): void {
+    // 当前登录玩家信息
+    Route::prefix('player')
+        ->name('api.v1.player.')
+        ->group(function (): void {
+            Route::get('me', MeController::class)->name('me');
+        });
+
+    // 钱包
+    Route::prefix('wallet')
+        ->name('api.v1.wallet.')
+        ->group(function (): void {
+            Route::get('balance', WalletBalanceController::class)->name('balance');
+            Route::get('logs', WalletLogsController::class)->name('logs');
+            Route::post('transfer-in', WalletTransferInController::class)->name('transfer-in');
+            Route::post('transfer-out', WalletTransferOutController::class)->name('transfer-out');
+        });
+
+    // 注单
+    Route::prefix('ticket')
+        ->name('api.v1.ticket.')
+        ->group(function (): void {
+            Route::post('preview', TicketPreviewController::class)->name('preview');
+            Route::post('place', TicketPlaceController::class)->name('place');
+            Route::get('items', TicketItemsIndexController::class)->name('items.index');
+            Route::get('items/{ticket_no}', TicketItemShowController::class)
+                ->where('ticket_no', 'TK[0-9]+')
+                ->name('items.show');
+            Route::get('draws/{draw_no}/my-match', TicketDrawMyMatchController::class)
+                ->where('draw_no', '[0-9]{8}-[0-9]{3}')
+                ->name('draws.my-match');
+        });
+});

routes/api/v1/public.php

@@ -0,0 +1,37 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\V1\HealthController;
+use App\Http\Controllers\Api\V1\Draw\DrawCurrentController;
+use App\Http\Controllers\Api\V1\Draw\DrawResultShowController;
+use App\Http\Controllers\Api\V1\Draw\DrawResultsIndexController;
+use App\Http\Controllers\Api\V1\Jackpot\JackpotSummaryController;
+use App\Http\Controllers\Api\V1\Play\PlayEffectiveCatalogController;
+use App\Http\Controllers\Api\V1\Player\PingController as PlayerPingController;
+
+/**
+ * 公开路由（无需登录）。
+ */
+
+// 健康检查
+Route::get('health', HealthController::class)->name('api.v1.health');
+
+// 开奖相关（公开）
+Route::get('draw/current', DrawCurrentController::class)->name('api.v1.draw.current');
+Route::get('draw/results', DrawResultsIndexController::class)->name('api.v1.draw.results');
+Route::get('draw/results/{draw_no}', DrawResultShowController::class)
+    ->where('draw_no', '[0-9]{8}-[0-9]{3}')
+    ->name('api.v1.draw.results.show');
+
+// 奖池水位（公开）
+Route::get('jackpot/summary', JackpotSummaryController::class)->name('api.v1.jackpot.summary');
+
+// 玩法目录（公开）
+Route::get('play/effective', PlayEffectiveCatalogController::class)->name('api.v1.play.effective');
+
+// 玩家端连通性探测
+Route::prefix('player')
+    ->name('api.v1.player.')
+    ->group(function (): void {
+        Route::get('ping', PlayerPingController::class)->name('ping');
+    });

tests/Feature/AdminAuthLoginTest.php

@@ -1,10 +1,10 @@
 <?php
 
-use App\Lottery\ErrorCode;
 use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use Illuminate\Support\Str;
 use App\Services\AdminCaptchaService;
 use Illuminate\Foundation\Testing\RefreshDatabase;
-use Illuminate\Support\Str;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminCsFinanceApisTest.php

@@ -1,12 +1,12 @@
 <?php
 
-use App\Models\AdminUser;
 use App\Models\Draw;
 use App\Models\Player;
+use App\Models\AdminUser;
 use App\Models\TicketItem;
 use App\Models\TicketOrder;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Hash;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminDashboardApiTest.php

@@ -1,10 +1,10 @@
 <?php
 
-use App\Models\AdminUser;
 use App\Models\Draw;
 use App\Models\RiskPool;
-use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Models\AdminUser;
 use Illuminate\Support\Facades\Hash;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminDrawApiTest.php

@@ -1,13 +1,13 @@
 <?php
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Models\AdminUser;
-use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
 use Carbon\Carbon;
-use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Models\Draw;
+use App\Models\AdminUser;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
 use Illuminate\Support\Facades\Hash;
+use App\Lottery\DrawResultBatchStatus;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminPhase15OperationsTest.php

@@ -1,16 +1,16 @@
 <?php
 
-use App\Lottery\ErrorCode;
+use App\Models\AuditLog;
 use App\Models\AdminRole;
 use App\Models\AdminUser;
-use App\Models\AuditLog;
-use App\Models\ReconcileJob;
 use App\Models\ReportJob;
+use App\Lottery\ErrorCode;
+use App\Models\ReconcileJob;
 use App\Services\AuditLogger;
-use App\Support\AdminPermissionBridge;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Hash;
+use App\Support\AdminPermissionBridge;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminRiskPoolApiTest.php

@@ -1,11 +1,11 @@
 <?php
 
-use App\Models\AdminUser;
 use App\Models\Draw;
 use App\Models\RiskPool;
+use App\Models\AdminUser;
 use App\Models\RiskPoolLockLog;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Hash;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminSettlementJackpotApiTest.php

@@ -2,8 +2,8 @@
 
 use App\Models\AdminUser;
 use App\Models\JackpotPool;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Hash;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminUserPermissionApiTest.php

@@ -1,12 +1,12 @@
 <?php
 
-use App\Lottery\ErrorCode;
 use App\Models\AdminRole;
 use App\Models\AdminUser;
-use App\Support\AdminPermissionBridge;
-use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Lottery\ErrorCode;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Hash;
+use App\Support\AdminPermissionBridge;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AdminWalletApiTest.php

@@ -1,13 +1,13 @@
 <?php
 
-use App\Lottery\ErrorCode;
-use App\Models\AdminUser;
 use App\Models\Player;
+use App\Models\AdminUser;
+use App\Models\WalletTxn;
+use App\Lottery\ErrorCode;
 use App\Models\PlayerWallet;
 use App\Models\TransferOrder;
-use App\Models\WalletTxn;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Hash;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/AuditLoggerTest.php

@@ -1,9 +1,9 @@
 <?php
 
 use App\Models\AuditLog;
+use Illuminate\Http\Request;
 use App\Services\AuditLogger;
 use Illuminate\Foundation\Testing\RefreshDatabase;
-use Illuminate\Http\Request;
 
 uses(RefreshDatabase::class);
 

tests/Feature/DrawPipelineTest.php

@@ -1,20 +1,20 @@
 <?php
 
-use App\Events\DrawCountdownBroadcast;
-use App\Events\DrawStatusChangeBroadcast;
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
-use App\Models\AdminUser;
-use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
-use App\Models\SettlementBatch;
-use App\Services\Draw\DrawPlannerService;
-use App\Services\Draw\DrawTickService;
 use Carbon\Carbon;
-use Illuminate\Foundation\Testing\RefreshDatabase;
-use Illuminate\Support\Facades\Event;
+use App\Models\Draw;
+use App\Models\AdminUser;
+use App\Lottery\DrawStatus;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Models\SettlementBatch;
 use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Facades\Event;
+use App\Events\DrawCountdownBroadcast;
+use App\Lottery\DrawResultBatchStatus;
+use App\Services\Draw\DrawTickService;
+use App\Events\DrawStatusChangeBroadcast;
+use App\Services\Draw\DrawPlannerService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/DrawResultsApiTest.php

@@ -1,10 +1,10 @@
 <?php
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
+use App\Lottery\DrawStatus;
 use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Lottery\DrawResultBatchStatus;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);

tests/Feature/JackpotPlacementSettlementTest.php

@@ -1,24 +1,24 @@
 <?php
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
-use App\Models\JackpotContribution;
-use App\Models\JackpotPayoutLog;
-use App\Models\JackpotPool;
 use App\Models\Player;
-use App\Models\PlayerWallet;
 use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
+use App\Models\JackpotPool;
 use App\Models\TicketOrder;
-use App\Services\Draw\DrawPrizeLayout;
-use App\Services\Settlement\SettlementOrchestrator;
+use App\Models\PlayerWallet;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Models\JackpotPayoutLog;
+use App\Models\JackpotContribution;
 use Database\Seeders\CurrencySeeder;
+use Database\Seeders\PlayTypeSeeder;
+use App\Lottery\DrawResultBatchStatus;
+use App\Services\Draw\DrawPrizeLayout;
 use Database\Seeders\LotterySettingsSeeder;
 use Database\Seeders\OperationalConfigV1Seeder;
-use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Services\Settlement\SettlementOrchestrator;
 
 uses(RefreshDatabase::class);
 

tests/Feature/LotterySettingsTest.php

@@ -2,8 +2,8 @@
 
 use App\Models\LotterySetting;
 use App\Services\LotterySettings;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Cache;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/OddsStandardScopesSyncTest.php

@@ -1,11 +1,11 @@
 <?php
 
-use App\Lottery\ConfigVersionStatus;
 use App\Models\Currency;
 use App\Models\OddsItem;
-use App\Models\OddsVersion;
 use App\Models\PlayType;
+use App\Models\OddsVersion;
 use App\Support\OddsStandardScopes;
+use App\Lottery\ConfigVersionStatus;
 use Database\Seeders\CurrencySeeder;
 use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;

tests/Feature/OperationalConfigAcceptanceTest.php

@@ -10,21 +10,21 @@
  * 运行：php artisan test tests/Feature/OperationalConfigAcceptanceTest.php
  */
 
-use App\Lottery\ConfigVersionStatus;
-use App\Lottery\DrawStatus;
-use App\Models\AdminUser;
-use App\Models\AuditLog;
 use App\Models\Draw;
-use App\Models\OddsVersion;
 use App\Models\Player;
+use App\Models\AuditLog;
 use App\Models\PlayType;
+use App\Models\AdminUser;
+use App\Lottery\DrawStatus;
+use App\Models\OddsVersion;
 use App\Models\RiskCapVersion;
-use Database\Seeders\CurrencySeeder;
-use Database\Seeders\OperationalConfigV1Seeder;
-use Database\Seeders\PlayTypeSeeder;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\DB;
+use App\Lottery\ConfigVersionStatus;
+use Database\Seeders\CurrencySeeder;
+use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Support\Facades\Hash;
+use Database\Seeders\OperationalConfigV1Seeder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/OperationalConfigApiTest.php

@@ -1,14 +1,14 @@
 <?php
 
-use App\Lottery\ConfigVersionStatus;
+use App\Models\PlayType;
 use App\Models\AdminUser;
 use App\Models\PlayConfigVersion;
-use App\Models\PlayType;
+use App\Lottery\ConfigVersionStatus;
 use Database\Seeders\CurrencySeeder;
-use Database\Seeders\OperationalConfigV1Seeder;
 use Database\Seeders\PlayTypeSeeder;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Hash;
+use Database\Seeders\OperationalConfigV1Seeder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/PlayerFoundationTest.php

@@ -1,10 +1,10 @@
 <?php
 
-use App\Lottery\ErrorCode;
-use App\Models\Player;
 use Firebase\JWT\JWT;
-use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Models\Player;
+use App\Lottery\ErrorCode;
 use Symfony\Component\HttpFoundation\Response;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/SettlementMatcherRegistryCompletenessTest.php

@@ -1,10 +1,10 @@
 <?php
 
 use App\Models\PlayType;
-use App\Services\Settlement\Matchers\NoopSettlementMatcher;
-use App\Services\Settlement\SettlementMatcherRegistry;
 use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Services\Settlement\SettlementMatcherRegistry;
+use App\Services\Settlement\Matchers\NoopSettlementMatcher;
 
 uses(RefreshDatabase::class);
 

tests/Feature/SettlementOrchestratorTest.php

@@ -1,23 +1,23 @@
 <?php
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
 use App\Models\Player;
-use App\Models\PlayerWallet;
-use App\Models\SettlementBatch;
-use App\Models\TicketItem;
-use App\Models\TicketOrder;
 use App\Models\WalletTxn;
-use App\Services\Draw\DrawPrizeLayout;
-use App\Services\Settlement\SettlementOrchestrator;
+use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
+use App\Models\TicketOrder;
+use App\Models\PlayerWallet;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Models\SettlementBatch;
 use Database\Seeders\CurrencySeeder;
+use Database\Seeders\PlayTypeSeeder;
+use App\Lottery\DrawResultBatchStatus;
+use App\Services\Draw\DrawPrizeLayout;
 use Database\Seeders\LotterySettingsSeeder;
 use Database\Seeders\OperationalConfigV1Seeder;
-use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Services\Settlement\SettlementOrchestrator;
 
 uses(RefreshDatabase::class);
 

tests/Feature/SettlementPhase145AcceptanceTest.php

@@ -4,31 +4,31 @@
  * §14.5 测试任务 / §14.6 完成标准：玩法命中、未中奖、派彩入彩票钱包、下单失败资金回滚、Jackpot 蓄水与非头奖结算、玩家端可见状态。
  */
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
-use App\Lottery\ErrorCode;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
-use App\Models\JackpotContribution;
-use App\Models\JackpotPayoutLog;
-use App\Models\JackpotPool;
 use App\Models\Player;
-use App\Models\PlayerWallet;
 use App\Models\RiskPool;
-use App\Models\TicketCombination;
-use App\Models\TicketItem;
-use App\Models\TicketOrder;
-use App\Models\TicketSettlementDetail;
 use App\Models\WalletTxn;
-use App\Services\Draw\DrawPrizeLayout;
-use App\Services\Settlement\SettlementOrchestrator;
+use App\Lottery\ErrorCode;
+use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
+use App\Models\JackpotPool;
+use App\Models\TicketOrder;
+use App\Models\PlayerWallet;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
+use App\Models\JackpotPayoutLog;
+use App\Models\TicketCombination;
+use App\Models\JackpotContribution;
 use App\Support\OddsStandardScopes;
 use Database\Seeders\CurrencySeeder;
+use Database\Seeders\PlayTypeSeeder;
+use App\Lottery\DrawResultBatchStatus;
+use App\Models\TicketSettlementDetail;
+use App\Services\Draw\DrawPrizeLayout;
 use Database\Seeders\LotterySettingsSeeder;
 use Database\Seeders\OperationalConfigV1Seeder;
-use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Services\Settlement\SettlementOrchestrator;
 
 uses(RefreshDatabase::class);
 

tests/Feature/TicketBettingApiTest.php

@@ -1,22 +1,22 @@
 <?php
 
-use App\Lottery\ConfigVersionStatus;
-use App\Lottery\DrawStatus;
-use App\Lottery\ErrorCode;
 use App\Models\Draw;
+use App\Models\Player;
+use App\Models\RiskPool;
+use App\Models\WalletTxn;
+use App\Lottery\ErrorCode;
+use App\Models\TicketItem;
+use App\Lottery\DrawStatus;
 use App\Models\OddsVersion;
+use App\Models\TicketOrder;
+use App\Models\PlayerWallet;
 use App\Models\PlayConfigItem;
 use App\Models\PlayConfigVersion;
-use App\Models\Player;
-use App\Models\PlayerWallet;
-use App\Models\RiskPool;
-use App\Models\TicketItem;
-use App\Models\TicketOrder;
-use App\Models\WalletTxn;
+use App\Lottery\ConfigVersionStatus;
 use Database\Seeders\CurrencySeeder;
+use Database\Seeders\PlayTypeSeeder;
 use Database\Seeders\LotterySettingsSeeder;
 use Database\Seeders\OperationalConfigV1Seeder;
-use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);

tests/Feature/TicketItemsApiTest.php

@@ -1,18 +1,18 @@
 <?php
 
-use App\Lottery\DrawResultBatchStatus;
-use App\Lottery\DrawStatus;
 use App\Models\Draw;
-use App\Models\DrawResultBatch;
-use App\Models\DrawResultItem;
-use App\Models\JackpotPool;
 use App\Models\Player;
+use App\Lottery\DrawStatus;
+use App\Models\JackpotPool;
 use App\Models\PlayerWallet;
-use App\Services\Draw\DrawPrizeLayout;
+use App\Models\DrawResultItem;
+use App\Models\DrawResultBatch;
 use Database\Seeders\CurrencySeeder;
+use Database\Seeders\PlayTypeSeeder;
+use App\Lottery\DrawResultBatchStatus;
+use App\Services\Draw\DrawPrizeLayout;
 use Database\Seeders\LotterySettingsSeeder;
 use Database\Seeders\OperationalConfigV1Seeder;
-use Database\Seeders\PlayTypeSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);

tests/Feature/WalletBalanceTest.php

@@ -1,7 +1,7 @@
 <?php
 
-use App\Lottery\ErrorCode;
 use App\Models\Player;
+use App\Lottery\ErrorCode;
 use App\Models\PlayerWallet;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 

tests/Feature/WalletLogsTest.php

@@ -1,13 +1,13 @@
 <?php
 
-use App\Lottery\ErrorCode;
 use App\Models\Player;
-use App\Models\PlayerWallet;
 use App\Models\WalletTxn;
+use App\Lottery\ErrorCode;
+use App\Models\PlayerWallet;
 use Database\Seeders\CurrencySeeder;
+use Illuminate\Support\Facades\Http;
 use Database\Seeders\LotterySettingsSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
-use Illuminate\Support\Facades\Http;
 
 uses(RefreshDatabase::class);
 

tests/Feature/WalletTransferScenariosTest.php

@@ -4,16 +4,16 @@
  * 钱包划转场景：鉴权、幂等、转入/转出成功·失败·处理中（与 PRD / MainSiteWalletGateway 行为对齐）。
  */
 
-use App\Lottery\ErrorCode;
+use Firebase\JWT\JWT;
 use App\Models\Player;
+use App\Models\WalletTxn;
+use App\Lottery\ErrorCode;
 use App\Models\PlayerWallet;
 use App\Models\TransferOrder;
-use App\Models\WalletTxn;
 use Database\Seeders\CurrencySeeder;
-use Database\Seeders\LotterySettingsSeeder;
-use Firebase\JWT\JWT;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Http;
+use Database\Seeders\LotterySettingsSeeder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 uses(RefreshDatabase::class);
 

tests/Feature/WalletTransferTest.php

@@ -1,15 +1,15 @@
 <?php
 
-use App\Lottery\ErrorCode;
 use App\Models\Player;
+use App\Models\WalletTxn;
+use App\Lottery\ErrorCode;
 use App\Models\PlayerWallet;
 use App\Models\TransferOrder;
-use App\Models\WalletTxn;
 use App\Services\LotterySettings;
 use Database\Seeders\CurrencySeeder;
+use Illuminate\Support\Facades\Http;
 use Database\Seeders\LotterySettingsSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
-use Illuminate\Support\Facades\Http;
 
 uses(RefreshDatabase::class);
 

tests/Pest.php

@@ -1,9 +1,9 @@
 <?php
 
-use App\Models\AdminUser;
-use Illuminate\Foundation\Testing\RefreshDatabase;
-use Illuminate\Support\Facades\DB;
 use Tests\TestCase;
+use App\Models\AdminUser;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Foundation\Testing\RefreshDatabase;
 
 /*
 |--------------------------------------------------------------------------