feat: 新增玩家管理与转账对账相关功能

1.  新增完整的后台玩家管理CRUD接口，包括列表、创建、详情、更新、删除
2.  新增转账订单冲正和人工处理功能，支持待对账订单状态变更
3.  扩展钱包流水和转账订单的状态支持，新增reversed、manually_processed等状态
4.  新增玩家API数据统一输出类，标准化玩家信息返回格式

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

@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Player;
+
+use App\Models\Player;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+/** DELETE /api/v1/admin/players/{player} */
+final class AdminPlayerDestroyController extends Controller
+{
+    public function __invoke(Request $request, Player $player): JsonResponse
+    {
+        $hasWallets = Player::query()
+            ->whereKey($player->getKey())
+            ->whereHas('wallets', static fn (HasMany $q) => $q->whereRaw('balance != 0'))
+            ->exists();
+
+        if ($hasWallets) {
+            return ApiResponse::error(
+                '该玩家钱包仍有余额，请先清空后再删除',
+                ErrorCode::ValidationFailed->value,
+                null,
+                422,
+            );
+        }
+
+        $hasTickets = Player::query()
+            ->whereKey($player->getKey())
+            ->whereHas('ticketOrders')
+            ->exists();
+
+        if ($hasTickets) {
+            return ApiResponse::error(
+                '该玩家存在注单记录，无法删除',
+                ErrorCode::ValidationFailed->value,
+                null,
+                422,
+            );
+        }
+
+        $player->wallets()->delete();
+        $player->delete();
+
+        return ApiResponse::success(['deleted' => true]);
+    }
+}

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

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Player;
+
+use App\Models\Player;
+use Illuminate\Http\Request;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\AdminApiList;
+use App\Support\PlayerApiPresenter;
+
+/** GET /api/v1/admin/players */
+final class AdminPlayerIndexController extends Controller
+{
+    public function __invoke(Request $request): JsonResponse
+    {
+        $p = AdminApiList::readPaging($request);
+        $keyword = trim((string) $request->query('keyword', ''));
+        $status = $request->query('status');
+
+        $q = Player::query()
+            ->with(['wallets' => static fn ($wq) => $wq->orderBy('wallet_type')->orderBy('currency_code')])
+            ->orderByDesc('id');
+
+        if ($keyword !== '') {
+            $term = '%'.addcslashes($keyword, '%_\\').'%';
+            $q->where(static function ($sub) use ($term): void {
+                $sub->where('site_player_id', 'like', $term)
+                    ->orWhere('username', 'like', $term)
+                    ->orWhere('nickname', 'like', $term);
+            });
+        }
+
+        if ($status !== null && $status !== '') {
+            $q->where('status', (int) $status);
+        }
+
+        $paginator = $q->paginate($p['perPage'], ['*'], 'page', $p['page']);
+
+        return AdminApiList::json($paginator, fn (Player $player): array => PlayerApiPresenter::listItem($player));
+    }
+}

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

@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Player;
+
+use App\Models\Player;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+
+/** GET /api/v1/admin/players/{player} */
+final class AdminPlayerShowController extends Controller
+{
+    public function __invoke(Player $player): JsonResponse
+    {
+        return ApiResponse::success(PlayerApiPresenter::listItem($player));
+    }
+}

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

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Player;
+
+use App\Models\Player;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\PlayerApiPresenter;
+use App\Http\Requests\Admin\AdminPlayerStoreRequest;
+
+/** POST /api/v1/admin/players */
+final class AdminPlayerStoreController extends Controller
+{
+    public function __invoke(AdminPlayerStoreRequest $request): JsonResponse
+    {
+        $exists = Player::query()
+            ->where('site_code', $request->validated('site_code'))
+            ->where('site_player_id', $request->validated('site_player_id'))
+            ->exists();
+
+        if ($exists) {
+            return ApiResponse::error(
+                '该主站玩家已在彩票平台注册',
+                ErrorCode::ValidationFailed->value,
+                null,
+                422,
+            );
+        }
+
+        $player = Player::query()->create([
+            'site_code' => $request->validated('site_code'),
+            'site_player_id' => $request->validated('site_player_id'),
+            'username' => $request->validated('username'),
+            'nickname' => $request->validated('nickname'),
+            'default_currency' => $request->validated('default_currency', 'NPR'),
+            'status' => $request->validated('status', 0),
+        ]);
+
+        return ApiResponse::success(PlayerApiPresenter::listItem($player), 201);
+    }
+}

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

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Player;
+
+use App\Models\Player;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Support\PlayerApiPresenter;
+use App\Http\Requests\Admin\AdminPlayerUpdateRequest;
+
+/** PUT /api/v1/admin/players/{player} */
+final class AdminPlayerUpdateController extends Controller
+{
+    public function __invoke(AdminPlayerUpdateRequest $request, Player $player): JsonResponse
+    {
+        $data = $request->validated();
+
+        if (isset($data['status'])) {
+            $data['status'] = (int) $data['status'];
+        }
+
+        $player->fill(array_filter($data, static fn ($v) => $v !== ''));
+        $player->save();
+
+        return ApiResponse::success(PlayerApiPresenter::listItem($player));
+    }
+}