feat: 拆分开奖与结算审核流程，新增手动结果录入、重开和派彩审批接口

2026-05-16 18:01:06 +08:00
parent 83046b402d
commit 4f143c7cb1
38 changed files with 1992 additions and 170 deletions
--- a/app/Http/Controllers/Api/V1/Admin/Draw/AdminDrawIndexController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Draw/AdminDrawIndexController.php
@@ -4,6 +4,8 @@ namespace App\Http\Controllers\Api\V1\Admin\Draw;

 use Carbon\Carbon;
 use App\Models\Draw;
+use App\Models\TicketItem;
+use App\Models\TicketOrder;
 use Illuminate\Http\Request;
 use App\Support\AdminApiList;
 use Illuminate\Http\JsonResponse;
@@ -56,6 +58,14 @@ final class AdminDrawIndexController extends Controller
            'current_result_version' => (int) $draw->current_result_version,
            'settle_version' => (int) $draw->settle_version,
            'is_reopened' => (bool) $draw->is_reopened,
+            'total_bet_minor' => (int) TicketOrder::query()->where('draw_id', $draw->id)->sum('total_actual_deduct'),
+            'total_payout_minor' => (int) TicketItem::query()->where('draw_id', $draw->id)->sum('win_amount')
+                + (int) TicketItem::query()->where('draw_id', $draw->id)->sum('jackpot_win_amount'),
+            'profit_loss_minor' => (int) TicketOrder::query()->where('draw_id', $draw->id)->sum('total_actual_deduct')
+                - (
+                    (int) TicketItem::query()->where('draw_id', $draw->id)->sum('win_amount')
+                    + (int) TicketItem::query()->where('draw_id', $draw->id)->sum('jackpot_win_amount')
+                ),
            'updated_at' => $draw->updated_at?->toIso8601String(),
        ];
    }
--- a/app/Http/Controllers/Api/V1/Admin/Draw/DrawCancelController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Draw/DrawCancelController.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Draw;
+
+use App\Models\Draw;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawAdminActionService;
+
+final class DrawCancelController extends Controller
+{
+    public function __construct(
+        private readonly DrawAdminActionService $service,
+    ) {}
+
+    public function __invoke(Draw $draw): JsonResponse
+    {
+        try {
+            $cancelled = $this->service->cancelBeforeResult($draw);
+        } catch (\RuntimeException) {
+            return ApiResponse::error(trans('api.client_error'), ErrorCode::ClientHttpError->value, null, 409);
+        }
+
+        return ApiResponse::success([
+            'draw_no' => $cancelled->draw_no,
+            'status' => $cancelled->status,
+        ]);
+    }
+}
--- a/app/Http/Controllers/Api/V1/Admin/Draw/DrawManualCloseController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Draw/DrawManualCloseController.php
@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Draw;
+
+use App\Models\Draw;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawAdminActionService;
+
+final class DrawManualCloseController extends Controller
+{
+    public function __construct(
+        private readonly DrawAdminActionService $service,
+    ) {}
+
+    public function __invoke(Draw $draw): JsonResponse
+    {
+        try {
+            $closed = $this->service->manualClose($draw);
+        } catch (\RuntimeException) {
+            return ApiResponse::error(trans('api.client_error'), ErrorCode::ClientHttpError->value, null, 409);
+        }
+
+        return ApiResponse::success([
+            'draw_no' => $closed->draw_no,
+            'status' => $closed->status,
+            'close_time' => $closed->close_time?->toIso8601String(),
+        ]);
+    }
+}
--- a/app/Http/Controllers/Api/V1/Admin/Draw/DrawManualResultBatchStoreController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Draw/DrawManualResultBatchStoreController.php
@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Draw;
+
+use App\Models\Draw;
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawManualResultService;
+use App\Http\Requests\Admin\DrawManualResultBatchStoreRequest;
+
+final class DrawManualResultBatchStoreController extends Controller
+{
+    public function __construct(
+        private readonly DrawManualResultService $service,
+    ) {}
+
+    public function __invoke(DrawManualResultBatchStoreRequest $request, Draw $draw): JsonResponse
+    {
+        $admin = $request->user();
+        if (! $admin instanceof AdminUser) {
+            return ApiResponse::error(
+                trans('admin.unauthenticated', [], $request->lotteryLocale()),
+                ErrorCode::AdminUnauthenticated->value,
+                null,
+                401,
+            );
+        }
+
+        try {
+            $batch = $this->service->createPendingBatch($draw, $admin, $request->validated('items'));
+        } catch (\RuntimeException) {
+            return ApiResponse::error(
+                trans('api.client_error', [], $request->lotteryLocale()),
+                ErrorCode::ClientHttpError->value,
+                null,
+                409,
+            );
+        }
+
+        $draw->refresh();
+
+        return ApiResponse::success([
+            'draw_no' => $draw->draw_no,
+            'status' => $draw->status,
+            'batch' => [
+                'id' => (int) $batch->id,
+                'result_version' => (int) $batch->result_version,
+                'source_type' => $batch->source_type,
+                'status' => $batch->status,
+                'items_count' => $batch->items()->count(),
+            ],
+        ]);
+    }
+}
--- a/app/Http/Controllers/Api/V1/Admin/Draw/DrawPlanGenerateController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Draw/DrawPlanGenerateController.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Draw;
+
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawPlannerService;
+
+final class DrawPlanGenerateController extends Controller
+{
+    public function __construct(
+        private readonly DrawPlannerService $planner,
+    ) {}
+
+    public function __invoke(): JsonResponse
+    {
+        return ApiResponse::success($this->planner->ensureBuffer());
+    }
+}
--- a/app/Http/Controllers/Api/V1/Admin/Draw/DrawReopenController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Draw/DrawReopenController.php
@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Draw;
+
+use App\Models\Draw;
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Draw\DrawReopenService;
+use App\Http\Requests\Admin\DrawReopenRequest;
+
+final class DrawReopenController extends Controller
+{
+    public function __construct(
+        private readonly DrawReopenService $service,
+    ) {}
+
+    public function __invoke(DrawReopenRequest $request, Draw $draw): JsonResponse
+    {
+        $admin = $request->user();
+        if (! $admin instanceof AdminUser) {
+            return ApiResponse::error(
+                trans('admin.unauthenticated', [], $request->lotteryLocale()),
+                ErrorCode::AdminUnauthenticated->value,
+                null,
+                401,
+            );
+        }
+        if (! $admin->isSuperAdmin()) {
+            return ApiResponse::error(
+                trans('admin.permission_denied', [], $request->lotteryLocale()),
+                ErrorCode::AdminForbidden->value,
+                ['required_any' => [AdminUser::ROLE_SUPER_ADMIN]],
+                403,
+            );
+        }
+
+        try {
+            $reopened = $this->service->reopenCooldownDraw($draw, $admin, $request->validated('reason') ?? null);
+        } catch (\RuntimeException) {
+            return ApiResponse::error(
+                trans('api.client_error', [], $request->lotteryLocale()),
+                ErrorCode::ClientHttpError->value,
+                null,
+                409,
+            );
+        }
+
+        return ApiResponse::success([
+            'draw_no' => $reopened->draw_no,
+            'status' => $reopened->status,
+            'is_reopened' => (bool) $reopened->is_reopened,
+            'current_result_version' => (int) $reopened->current_result_version,
+            'cooling_end_time' => $reopened->cooling_end_time?->toIso8601String(),
+        ]);
+    }
+}
--- a/app/Http/Controllers/Api/V1/Admin/Draw/DrawRngRunController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Draw/DrawRngRunController.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Draw;
+
+use App\Models\Draw;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use App\Lottery\DrawStatus;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use Illuminate\Support\Facades\DB;
+use App\Services\Draw\DrawRngRunner;
+
+final class DrawRngRunController extends Controller
+{
+    public function __construct(
+        private readonly DrawRngRunner $rng,
+    ) {}
+
+    public function __invoke(Draw $draw): JsonResponse
+    {
+        try {
+            $batch = DB::transaction(function () use ($draw) {
+                /** @var Draw $locked */
+                $locked = Draw::query()->whereKey($draw->id)->lockForUpdate()->firstOrFail();
+                if ($locked->status !== DrawStatus::Closed->value || $locked->resultBatches()->exists()) {
+                    throw new \RuntimeException('draw_not_runnable');
+                }
+
+                return $this->rng->executeLocked($locked);
+            });
+        } catch (\RuntimeException) {
+            return ApiResponse::error(trans('api.client_error'), ErrorCode::ClientHttpError->value, null, 409);
+        }
+
+        $draw->refresh();
+
+        return ApiResponse::success([
+            'draw_no' => $draw->draw_no,
+            'status' => $draw->status,
+            'batch' => [
+                'id' => (int) $batch->id,
+                'result_version' => (int) $batch->result_version,
+                'source_type' => $batch->source_type,
+                'status' => $batch->status,
+                'items_count' => $batch->items()->count(),
+            ],
+        ]);
+    }
+}