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

更新 AdminJackpotPoolUpdateController 校验规则,禁止传入 current_amount。
优化 AdminRiskPoolManualStatusController:更新奖池状态后同步 Redis 状态。
在 TransferOrderReconcileController 中新增 completeCredit 方法,用于处理卡住的转账订单对账。
调整 TransferOrderListController:优化转账订单处理条件。
在 TicketItemsIndexController 中实现支持时区的日期筛选,提升日期处理准确性。
扩展 JackpotPool 模型,新增 adjustments 关联关系。
改进票据与钱包相关服务中的错误处理和事务管理。
This commit is contained in:
2026-05-26 14:58:41 +08:00
parent 48349e3302
commit c8c90e3e94
45 changed files with 1877 additions and 104 deletions

View File

@@ -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(),
],
]);
}
}

View File

@@ -0,0 +1,43 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
use App\Models\JackpotPool;
use App\Support\ApiResponse;
use App\Models\JackpotPoolAdjustment;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
use App\Support\PaginationTrait;
use Illuminate\Http\Request;
use App\Http\Controllers\Api\V1\Admin\Jackpot\Concerns\PresentsJackpotPoolAdjustment;
/**
* GET /api/v1/admin/jackpot/pools/{pool}/adjustments 奖池余额调整流水。
*/
final class AdminJackpotPoolAdjustmentIndexController extends Controller
{
use PaginationTrait;
use PresentsJackpotPoolAdjustment;
public function __invoke(Request $request, JackpotPool $pool): JsonResponse
{
$perPage = $this->perPage($request, 'per_page', 10, 100);
$page = $this->page($request);
$paginator = JackpotPoolAdjustment::query()
->where('jackpot_pool_id', $pool->id)
->with('adminUser:id,username,name')
->orderByDesc('id')
->paginate($perPage, ['*'], 'page', $page);
return ApiResponse::success([
'items' => $paginator->getCollection()
->map(fn (JackpotPoolAdjustment $row) => $this->adjustmentRow($row))
->values()
->all(),
'total' => $paginator->total(),
'page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
]);
}
}

View File

@@ -16,7 +16,7 @@ final class AdminJackpotPoolUpdateController extends Controller
public function __invoke(Request $request, JackpotPool $pool): JsonResponse
{
$data = $request->validate([
'current_amount' => 'sometimes|integer|min:0',
'current_amount' => 'prohibited',
'contribution_rate' => 'sometimes|numeric|min:0|max:1',
'trigger_threshold' => 'sometimes|integer|min:0',
'payout_rate' => 'sometimes|numeric|min:0|max:1',

View File

@@ -0,0 +1,25 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Jackpot\Concerns;
use App\Models\JackpotPoolAdjustment;
trait PresentsJackpotPoolAdjustment
{
/** @return array<string, mixed> */
private function adjustmentRow(JackpotPoolAdjustment $row): array
{
return [
'id' => (int) $row->id,
'adjustment_no' => $row->adjustment_no,
'jackpot_pool_id' => (int) $row->jackpot_pool_id,
'admin_user_id' => (int) $row->admin_user_id,
'admin_username' => $row->adminUser?->username,
'amount_delta' => (int) $row->amount_delta,
'balance_before' => (int) $row->balance_before,
'balance_after' => (int) $row->balance_after,
'reason' => $row->reason,
'created_at' => $row->created_at?->toIso8601String(),
];
}
}