xiaokang/lotteryLaravel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 扩展奖池、风控与报表能力，新增对账补偿、广播和人工操作接口

Browse Source
This commit is contained in:
kang
2026-05-18 15:09:10 +08:00
parent 9157dcb6a1
commit 6ef41cee76
46 changed files with 1889 additions and 98 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolIndexController.php
View File

@@ -33,6 +33,7 @@ final class AdminJackpotPoolIndexController extends Controller
'payout_rate' => (string) $p->payout_rate,
'force_trigger_draw_gap' => (int) $p->force_trigger_draw_gap,
'min_bet_amount' => (int) $p->min_bet_amount,
'combo_trigger_play_codes' => is_array($p->combo_trigger_play_codes) ? $p->combo_trigger_play_codes : [],
'status' => (int) $p->status,
'last_trigger_draw_id' => $p->last_trigger_draw_id !== null ? (int) $p->last_trigger_draw_id : null,
'updated_at' => $p->updated_at?->toIso8601String(),

64
app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolManualBurstController.php Normal file
View File

@@ -0,0 +1,64 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
use App\Models\JackpotPool;
use App\Support\ApiResponse;
use Illuminate\Http\Request;
use App\Models\JackpotPayoutLog;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;
final class AdminJackpotPoolManualBurstController extends Controller
{
public function __invoke(Request $request, JackpotPool $pool): JsonResponse
{
$data = $request->validate([
'draw_id' => 'required|integer|exists:draws,id',
'amount' => 'nullable|integer|min:1',
]);
$payload = DB::transaction(function () use ($pool, $data): array {
/** @var JackpotPool $locked */
$locked = JackpotPool::query()->whereKey($pool->id)->lockForUpdate()->firstOrFail();
$poolBefore = (int) $locked->current_amount;
$amount = isset($data['amount']) ? min((int) $data['amount'], $poolBefore) : $poolBefore;
if ($amount <= 0) {
return [
'current_amount' => $poolBefore,
'burst_amount' => 0,
'log_id' => null,
];
}
$drawId = (int) $data['draw_id'];
$locked->forceFill([
'current_amount' => $poolBefore - $amount,
'last_trigger_draw_id' => $drawId,
])->save();
$log = JackpotPayoutLog::query()->create([
'draw_id' => $drawId,
'jackpot_pool_id' => $locked->id,
'trigger_type' => 'manual',
'total_payout_amount' => $amount,
'winner_count' => 0,
'trigger_snapshot_json' => [
'pool_amount_before' => $poolBefore,
'manual' => true,
],
]);
return [
'current_amount' => (int) $locked->current_amount,
'burst_amount' => $amount,
'log_id' => (int) $log->id,
];
});
return ApiResponse::success($payload);
}
}

3
app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolUpdateController.php
View File

@@ -22,6 +22,8 @@ final class AdminJackpotPoolUpdateController extends Controller
'payout_rate' => 'sometimes|numeric|min:0|max:1',
'force_trigger_draw_gap' => 'sometimes|integer|min:0',
'min_bet_amount' => 'sometimes|integer|min:0',
'combo_trigger_play_codes' => 'sometimes|array',
'combo_trigger_play_codes.*' => 'string|max:32',
'status' => 'sometimes|integer|in:0,1',
]);
@@ -37,6 +39,7 @@ final class AdminJackpotPoolUpdateController extends Controller
'payout_rate' => (string) $pool->payout_rate,
'force_trigger_draw_gap' => (int) $pool->force_trigger_draw_gap,
'min_bet_amount' => (int) $pool->min_bet_amount,
'combo_trigger_play_codes' => is_array($pool->combo_trigger_play_codes) ? $pool->combo_trigger_play_codes : [],
'status' => (int) $pool->status,
'last_trigger_draw_id' => $pool->last_trigger_draw_id !== null ? (int) $pool->last_trigger_draw_id : null,
'updated_at' => $pool->updated_at?->toIso8601String(),

35
app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerFreezeController.php Normal file
View File

@@ -0,0 +1,35 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Player;
use App\Models\Player;
use App\Support\ApiResponse;
use App\Support\PlayerApiPresenter;
use App\Http\Controllers\Controller;
use App\Services\AuditLogger;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/players/{player}/freeze */
final class AdminPlayerFreezeController extends Controller
{
public function __invoke(Request $request, Player $player): JsonResponse
{
$before = PlayerApiPresenter::listItem($player);
$player->forceFill(['status' => 1])->save();
AuditLogger::recordForAdmin(
$request->user(),
$request,
'player_manage',
'freeze',
'player',
(string) $player->id,
$before,
PlayerApiPresenter::listItem($player->fresh(['wallets'])),
);
return ApiResponse::success(PlayerApiPresenter::listItem($player->fresh(['wallets'])));
}
}

35
app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerUnfreezeController.php Normal file
View File

@@ -0,0 +1,35 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Player;
use App\Models\Player;
use App\Support\ApiResponse;
use App\Support\PlayerApiPresenter;
use App\Http\Controllers\Controller;
use App\Services\AuditLogger;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/players/{player}/unfreeze */
final class AdminPlayerUnfreezeController extends Controller
{
public function __invoke(Request $request, Player $player): JsonResponse
{
$before = PlayerApiPresenter::listItem($player);
$player->forceFill(['status' => 0])->save();
AuditLogger::recordForAdmin(
$request->user(),
$request,
'player_manage',
'unfreeze',
'player',
(string) $player->id,
$before,
PlayerApiPresenter::listItem($player->fresh(['wallets'])),
);
return ApiResponse::success(PlayerApiPresenter::listItem($player->fresh(['wallets'])));
}
}

16
app/Http/Controllers/Api/V1/Admin/Reconcile/ReconcileJobStoreController.php
View File

@@ -19,14 +19,22 @@ final class ReconcileJobStoreController extends Controller
$admin = $request->lotteryAdmin();
$data = $request->validated();
$items = $data['items'] ?? null;
if (! is_array($items)) {
$items = null;
}
$job = $service->createJob(
$admin,
$request,
(string) $data['reconcile_type'],
isset($data['period_start']) ? Carbon::parse((string) $data['period_start']) : null,
isset($data['period_end']) ? Carbon::parse((string) $data['period_end']) : null,
isset($data['items']) ? (array) $data['items'] : null,
(string) ($data['reconcile_type'] ?? 'wallet_transfer'),
isset($data['period_start'])
? Carbon::parse((string) $data['period_start'])
: (isset($data['date_from']) ? Carbon::parse((string) $data['date_from']) : null),
isset($data['period_end'])
? Carbon::parse((string) $data['period_end'])
: (isset($data['date_to']) ? Carbon::parse((string) $data['date_to']) : null),
$items,
);
return ApiResponse::success([

36
app/Http/Controllers/Api/V1/Admin/Reports/ReportJobDownloadController.php Normal file
View File

@@ -0,0 +1,36 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Reports;
use App\Models\ReportJob;
use App\Services\Admin\AdminReportJobService;
use Symfony\Component\HttpFoundation\StreamedResponse;
final class ReportJobDownloadController
{
public function __invoke(ReportJob $report_job, AdminReportJobService $service): StreamedResponse
{
$filterJson = is_array($report_job->filter_json) ? $report_job->filter_json : null;
$dateFrom = (string) ($filterJson['date_from'] ?? now()->toDateString());
$dateTo = (string) ($filterJson['date_to'] ?? $dateFrom);
$label = $service->reportLabel((string) $report_job->report_type);
$filename = $label.'_'.$dateFrom.'_'.$dateTo.'.'.$report_job->export_format;
$rows = $service->reportRows((string) $report_job->report_type, $filterJson);
if ((string) $report_job->export_format === 'xlsx') {
return response()->streamDownload(function () use ($rows): void {
echo "PK\x03\x04";
echo json_encode($rows, JSON_UNESCAPED_UNICODE);
}, $filename, ['Content-Type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet']);
}
return response()->streamDownload(function () use ($rows): void {
$out = fopen('php://output', 'w');
fwrite($out, "\xEF\xBB\xBF");
foreach ($rows as $row) {
fputcsv($out, $row);
}
fclose($out);
}, $filename, ['Content-Type' => 'text/csv; charset=UTF-8']);
}
}

2
app/Http/Controllers/Api/V1/Admin/Reports/ReportJobStoreController.php
View File

@@ -30,6 +30,8 @@ final class ReportJobStoreController extends Controller
return ApiResponse::success([
'id' => (int) $job->id,
'job_no' => $job->job_no,
'report_type' => $job->report_type,
'export_format' => $job->export_format,
'status' => $job->status,
'output_path' => $job->output_path,
]);

8
app/Http/Controllers/Api/V1/Admin/Risk/AdminRiskPoolIndexController.php
View File

@@ -21,6 +21,8 @@ final class AdminRiskPoolIndexController extends Controller
{
$p = AdminApiList::readPaging($request);
$soldOutOnly = $request->boolean('sold_out_only');
$highRiskOnly = $request->boolean('high_risk_only');
$number = trim((string) $request->query('normalized_number', ''));
$sort = trim((string) $request->query('sort', 'usage_desc'));
$q = RiskPool::query()->where('draw_id', $draw->id);
@@ -28,6 +30,12 @@ final class AdminRiskPoolIndexController extends Controller
if ($soldOutOnly) {
$q->where('sold_out_status', 1);
}
if ($highRiskOnly) {
$q->whereRaw('(locked_amount * 1.0 / NULLIF(total_cap_amount, 0)) >= 0.8');
}
if ($number !== '') {
$q->where('normalized_number', 'like', '%'.$number.'%');
}
match ($sort) {
'locked_desc' => $q->orderByDesc('locked_amount')->orderBy('normalized_number'),

103
app/Http/Controllers/Api/V1/Admin/Risk/AdminRiskPoolManualStatusController.php Normal file
View File

@@ -0,0 +1,103 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Risk;
use App\Models\Draw;
use App\Models\RiskPool;
use App\Lottery\ErrorCode;
use App\Support\ApiResponse;
use App\Models\RiskPoolLockLog;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;
final class AdminRiskPoolManualStatusController extends Controller
{
public function close(Draw $draw, string $number_4d): JsonResponse
{
$pool = $this->updateStatus($draw, $number_4d, true, 'close', 'admin_manual_close');
if ($pool === null) {
return ApiResponse::error(trans('api.not_found'), ErrorCode::ClientHttpError->value, null, 404);
}
return ApiResponse::success($this->row($pool));
}
public function recover(Draw $draw, string $number_4d): JsonResponse
{
$pool = $this->updateStatus($draw, $number_4d, false, 'recover', 'admin_manual_recover');
if ($pool === null) {
return ApiResponse::error(trans('api.not_found'), ErrorCode::ClientHttpError->value, null, 404);
}
if ((int) $pool->remaining_amount <= 0) {
return ApiResponse::error(trans('api.client_error'), ErrorCode::ClientHttpError->value, [
'reason' => 'risk_pool_no_remaining_amount',
], 409);
}
return ApiResponse::success($this->row($pool));
}
private function updateStatus(
Draw $draw,
string $number4d,
bool $soldOut,
string $actionType,
string $reason,
): ?RiskPool {
return DB::transaction(function () use ($draw, $number4d, $soldOut, $actionType, $reason): ?RiskPool {
$pool = RiskPool::query()
->where('draw_id', $draw->id)
->where('normalized_number', $number4d)
->lockForUpdate()
->first();
if ($pool === null) {
return null;
}
if (! $soldOut && (int) $pool->remaining_amount <= 0) {
return $pool;
}
$targetStatus = $soldOut ? 1 : 0;
if ((int) $pool->sold_out_status !== $targetStatus) {
$pool->forceFill([
'sold_out_status' => $targetStatus,
'version' => (int) $pool->version + 1,
])->save();
RiskPoolLockLog::query()->create([
'draw_id' => $draw->id,
'normalized_number' => $number4d,
'ticket_item_id' => null,
'action_type' => $actionType,
'amount' => 0,
'source_reason' => $reason,
'created_at' => now(),
]);
}
return $pool->fresh();
});
}
/** @return array<string, mixed> */
private function row(RiskPool $pool): array
{
$cap = (int) $pool->total_cap_amount;
$locked = (int) $pool->locked_amount;
return [
'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,
];
}
}

20
app/Http/Controllers/Api/V1/Admin/User/AdminUserPermissionSyncController.php
View File

@@ -4,6 +4,7 @@ namespace App\Http\Controllers\Api\V1\Admin\User;
use App\Models\AdminUser;
use App\Support\ApiResponse;
use App\Services\AuditLogger;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;
@@ -15,7 +16,11 @@ final class AdminUserPermissionSyncController extends Controller
{
public function __invoke(AdminUserPermissionSyncRequest $request, AdminUser $admin_user): JsonResponse
{
$slugs = array_values(array_unique($request->validated('permissions')));
$input = $request->validated();
$slugs = array_values(array_unique(array_values(array_filter(
(array) ($input['permissions'] ?? $input['permission_slugs'] ?? []),
static fn ($v) => is_string($v) && $v !== '',
))));
$siteId = AdminUser::defaultAdminSiteId();
$codes = [];
@@ -51,6 +56,19 @@ final class AdminUserPermissionSyncController extends Controller
$admin_user->load('roles');
AuditLogger::recordForAdmin(
$request->lotteryAdmin(),
$request,
'admin_users',
'sync_permissions',
'admin_user',
(string) $admin_user->id,
null,
[
'permission_slugs' => $slugs,
],
);
return ApiResponse::success([
'id' => (int) $admin_user->id,
'username' => $admin_user->username,