feat: 增强奖池与钱包管理功能

更新 AdminJackpotPoolUpdateController 校验规则，禁止传入 current_amount。优化 AdminRiskPoolManualStatusController：更新奖池状态后同步 Redis 状态。在 TransferOrderReconcileController 中新增 completeCredit 方法，用于处理卡住的转账订单对账。调整 TransferOrderListController：优化转账订单处理条件。在 TicketItemsIndexController 中实现支持时区的日期筛选，提升日期处理准确性。扩展 JackpotPool 模型，新增 adjustments 关联关系。改进票据与钱包相关服务中的错误处理和事务管理。
2026-05-26 14:58:41 +08:00
parent 48349e3302
commit c8c90e3e94
45 changed files with 1877 additions and 104 deletions
--- a/app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolAdjustController.php
+++ b/app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolAdjustController.php
@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
+
+use App\Models\JackpotPool;
+use App\Models\AdminUser;
+use App\Lottery\ErrorCode;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Jackpot\JackpotPoolAdjustmentService;
+use App\Http\Requests\Admin\Jackpot\AdminJackpotPoolAdjustRequest;
+use App\Http\Controllers\Api\V1\Admin\Jackpot\Concerns\PresentsJackpotPoolAdjustment;
+
+/**
+ * POST /api/v1/admin/jackpot/pools/{pool}/adjustments — 奖池余额调整（须备注，写流水）。
+ */
+final class AdminJackpotPoolAdjustController extends Controller
+{
+    use PresentsJackpotPoolAdjustment;
+
+    public function __construct(
+        private readonly JackpotPoolAdjustmentService $adjustments,
+    ) {}
+
+    public function __invoke(AdminJackpotPoolAdjustRequest $request, JackpotPool $pool): JsonResponse
+    {
+        $admin = $request->user();
+        if (! $admin instanceof AdminUser) {
+            return ApiResponse::error(
+                trans('admin.unauthenticated', [], $request->lotteryLocale()),
+                ErrorCode::AdminUnauthenticated->value,
+                null,
+                401,
+            );
+        }
+
+        try {
+            $row = $this->adjustments->apply(
+                $pool,
+                $admin,
+                (int) $request->validated('amount_delta'),
+                (string) $request->validated('reason'),
+                $request,
+            );
+        } catch (\RuntimeException $e) {
+            $msg = match ($e->getMessage()) {
+                'adjustment_delta_zero' => trans('jackpot.adjustment_delta_zero', [], $request->lotteryLocale()),
+                'adjustment_reason_required' => trans('jackpot.adjustment_reason_required', [], $request->lotteryLocale()),
+                'adjustment_would_make_balance_negative' => trans('jackpot.adjustment_negative_balance', [], $request->lotteryLocale()),
+                default => trans('api.client_error', [], $request->lotteryLocale()),
+            };
+
+            return ApiResponse::error($msg, ErrorCode::ClientHttpError->value, ['reason' => $e->getMessage()], 422);
+        }
+
+        $pool->refresh();
+
+        return ApiResponse::success([
+            'adjustment' => $this->adjustmentRow($row),
+            'pool' => [
+                'id' => (int) $pool->id,
+                'currency_code' => $pool->currency_code,
+                'current_amount' => (int) $pool->current_amount,
+                'updated_at' => $pool->updated_at?->toIso8601String(),
+            ],
+        ]);
+    }
+}