feat: 添加新的错误码以支持投注功能，更新数据库填充器以增强玩法和赔率配置，扩展 API 路由以支持风险池管理

2026-05-11 11:52:23 +08:00
parent 067c2b39f5
commit 058f596f34
29 changed files with 2300 additions and 122 deletions
--- a/app/Http/Controllers/Api/V1/Admin/Risk/AdminRiskPoolShowController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Risk/AdminRiskPoolShowController.php
@@ -0,0 +1,89 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Risk;
+
+use App\Http\Controllers\Controller;
+use App\Lottery\ErrorCode;
+use App\Models\Draw;
+use App\Models\RiskPool;
+use App\Models\RiskPoolLockLog;
+use App\Support\ApiResponse;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+/**
+ * GET /api/v1/admin/draws/{draw}/risk-pools/{number_4d} — 单号码风险池详情 + 占用流水。
+ */
+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);
+        }
+
+        $pool = RiskPool::query()
+            ->where('draw_id', $draw->id)
+            ->where('normalized_number', $number_4d)
+            ->first();
+
+        if ($pool === null) {
+            return ApiResponse::error('该期尚无此号码的风险池记录', ErrorCode::NotFound->value, null, 404);
+        }
+
+        $perPage = min(max((int) $request->integer('per_page', 20), 1), 100);
+
+        /** @var LengthAwarePaginator $paginator */
+        $paginator = RiskPoolLockLog::query()
+            ->where('draw_id', $draw->id)
+            ->where('normalized_number', $number_4d)
+            ->with(['ticketItem:id,ticket_no,play_code,player_id'])
+            ->orderByDesc('created_at')
+            ->orderByDesc('id')
+            ->paginate($perPage);
+
+        $cap = (int) $pool->total_cap_amount;
+        $locked = (int) $pool->locked_amount;
+
+        return ApiResponse::success([
+            'draw_id' => (int) $draw->id,
+            'draw_no' => $draw->draw_no,
+            'pool' => [
+                'normalized_number' => $pool->normalized_number,
+                'total_cap_amount' => $cap,
+                'locked_amount' => $locked,
+                'remaining_amount' => (int) $pool->remaining_amount,
+                'sold_out_status' => (int) $pool->sold_out_status,
+                'is_sold_out' => (int) $pool->sold_out_status === 1,
+                'usage_ratio' => $cap > 0 ? round($locked / $cap, 6) : null,
+                'version' => (int) $pool->version,
+            ],
+            'logs' => [
+                'items' => collect($paginator->items())->map(fn (RiskPoolLockLog $log) => $this->logRow($log))->all(),
+                'meta' => [
+                    'current_page' => $paginator->currentPage(),
+                    'per_page' => $paginator->perPage(),
+                    'total' => $paginator->total(),
+                    'last_page' => $paginator->lastPage(),
+                ],
+            ],
+        ]);
+    }
+
+    /** @return array<string, mixed> */
+    private function logRow(RiskPoolLockLog $log): array
+    {
+        return [
+            'id' => (int) $log->id,
+            'action_type' => $log->action_type,
+            'amount' => (int) $log->amount,
+            'source_reason' => $log->source_reason,
+            'ticket_item_id' => $log->ticket_item_id,
+            'ticket_no' => $log->ticketItem?->ticket_no,
+            'play_code' => $log->ticketItem?->play_code,
+            'player_id' => $log->ticketItem?->player_id,
+            'created_at' => $log->created_at?->toIso8601String(),
+        ];
+    }
+}