feat: 添加 Laravel Reverb 支持，更新 .env.example 文件以配置 WebSocket，增强彩票调度功能，更新 API 路由以支持期号管理与结果发布

2026-05-09 17:40:49 +08:00
parent 781cf10928
commit aeaf124096
42 changed files with 3886 additions and 5 deletions
--- a/app/Http/Controllers/Api/V1/Draw/DrawResultsIndexController.php
+++ b/app/Http/Controllers/Api/V1/Draw/DrawResultsIndexController.php
@@ -0,0 +1,62 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Draw;
+
+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
+{
+    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));
+        /** @var string|null $bizDate query `business_date` 或旧的 `date` */
+        $bizDate = $request->query('business_date') ?? $request->query('date');
+
+        $query = Draw::query()
+            ->whereIn('status', DrawResultViewService::publishedDrawStatuses())
+            ->where('current_result_version', '>', 0)
+            ->whereNotNull('draw_time')
+            ->whereExists(function ($sub): void {
+                $sub->selectRaw('1')
+                    ->from((new DrawResultBatch)->getTable())
+                    ->whereColumn('draw_id', 'draws.id')
+                    ->whereColumn('result_version', 'draws.current_result_version')
+                    ->where('status', DrawResultBatchStatus::Published->value);
+            });
+
+        if (is_string($bizDate) && preg_match('/^\d{4}-\d{2}-\d{2}$/', $bizDate)) {
+            $query->whereDate('business_date', $bizDate);
+        }
+
+        /** @var LengthAwarePaginator<int, Draw> $paginator */
+        $paginator = $query
+            ->orderByDesc('draw_time')
+            ->paginate(perPage: $perPage, columns: ['*'], pageName: 'page', page: $page);
+
+        $decorated = $this->viewer->decoratePaginator($paginator);
+
+        return ApiResponse::success([
+            'items' => $decorated->items(),
+            'total' => $decorated->total(),
+            'page' => $decorated->currentPage(),
+            'per_page' => $decorated->perPage(),
+            'last_page' => $decorated->lastPage(),
+        ]);
+    }
+}