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

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
     {