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

feat: 添加结算功能，更新 TicketItem 模型以支持最新结算详情，增强 DrawTickService 以自动处理结算，更新 TicketWalletService 以支持派彩入账，扩展 API 路由以管理结算批次和奖池

Browse Source
This commit is contained in:
kang
2026-05-11 15:34:34 +08:00
parent 6a55fa9592
commit 19003f5041
50 changed files with 3604 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
app/Http/Controllers/Api/V1/Admin/Draw/DrawSettlementRunController.php Normal file
View File

@@ -0,0 +1,46 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Draw;
use App\Http\Controllers\Controller;
use App\Lottery\ErrorCode;
use App\Models\AdminUser;
use App\Models\Draw;
use App\Services\Settlement\SettlementOrchestrator;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/**
* POST /api/v1/admin/draws/{draw}/settlement/run — 对 `settling` 期号执行结算（可关自动结算时手工触发）。
*/
final class DrawSettlementRunController extends Controller
{
public function __construct(
private readonly SettlementOrchestrator $orchestrator,
) {}
public function __invoke(Request $request, Draw $draw): JsonResponse
{
$admin = $request->user();
if (! $admin instanceof AdminUser) {
return ApiResponse::error(
trans('admin.unauthenticated', [], $request->lotteryLocale()),
ErrorCode::AdminUnauthenticated->value,
null,
401,
);
}
$ran = $this->orchestrator->trySettleDraw($draw);
$draw->refresh();
return ApiResponse::success([
'ran' => $ran,
'draw_no' => $draw->draw_no,
'status' => $draw->status,
'settle_version' => (int) $draw->settle_version,
]);
}
}

54
app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotContributionIndexController.php Normal file
View File

@@ -0,0 +1,54 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
use App\Http\Controllers\Controller;
use App\Models\JackpotContribution;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/**
* GET /api/v1/admin/jackpot/contributions — Jackpot 蓄水流水。
*/
final class AdminJackpotContributionIndexController extends Controller
{
public function __invoke(Request $request): JsonResponse
{
$perPage = min(max((int) $request->integer('per_page', 25), 1), 100);
$page = max((int) $request->integer('page', 1), 1);
$drawNo = trim((string) $request->query('draw_no', ''));
$q = JackpotContribution::query()
->with(['draw:id,draw_no', 'pool:id,currency_code', 'player:id,username,site_player_id', 'ticketItem:id,ticket_no'])
->orderByDesc('id');
if ($drawNo !== '') {
$q->whereHas('draw', fn ($d) => $d->where('draw_no', 'like', '%'.$drawNo.'%'));
}
$paginator = $q->paginate($perPage, ['*'], 'page', $page);
return ApiResponse::success([
'items' => collect($paginator->items())->map(fn (JackpotContribution $r) => [
'id' => (int) $r->id,
'draw_id' => (int) $r->draw_id,
'draw_no' => $r->draw?->draw_no,
'jackpot_pool_id' => (int) $r->jackpot_pool_id,
'currency_code' => $r->pool?->currency_code,
'player_id' => (int) $r->player_id,
'player_username' => $r->player?->username,
'ticket_item_id' => $r->ticket_item_id !== null ? (int) $r->ticket_item_id : null,
'ticket_no' => $r->ticketItem?->ticket_no,
'contribution_amount' => (int) $r->contribution_amount,
'created_at' => $r->created_at?->toIso8601String(),
])->all(),
'meta' => [
'current_page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
'total' => $paginator->total(),
'last_page' => $paginator->lastPage(),
],
]);
}
}

53
app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPayoutLogIndexController.php Normal file
View File

@@ -0,0 +1,53 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
use App\Http\Controllers\Controller;
use App\Models\JackpotPayoutLog;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/**
* GET /api/v1/admin/jackpot/payout-logs — Jackpot 派彩（爆池）记录。
*/
final class AdminJackpotPayoutLogIndexController extends Controller
{
public function __invoke(Request $request): JsonResponse
{
$perPage = min(max((int) $request->integer('per_page', 25), 1), 100);
$page = max((int) $request->integer('page', 1), 1);
$drawNo = trim((string) $request->query('draw_no', ''));
$q = JackpotPayoutLog::query()
->with(['draw:id,draw_no', 'pool:id,currency_code'])
->orderByDesc('id');
if ($drawNo !== '') {
$q->whereHas('draw', fn ($d) => $d->where('draw_no', 'like', '%'.$drawNo.'%'));
}
$paginator = $q->paginate($perPage, ['*'], 'page', $page);
return ApiResponse::success([
'items' => collect($paginator->items())->map(fn (JackpotPayoutLog $r) => [
'id' => (int) $r->id,
'draw_id' => (int) $r->draw_id,
'draw_no' => $r->draw?->draw_no,
'jackpot_pool_id' => (int) $r->jackpot_pool_id,
'currency_code' => $r->pool?->currency_code,
'trigger_type' => $r->trigger_type,
'total_payout_amount' => (int) $r->total_payout_amount,
'winner_count' => (int) $r->winner_count,
'trigger_snapshot_json' => $r->trigger_snapshot_json,
'created_at' => $r->created_at?->toIso8601String(),
])->all(),
'meta' => [
'current_page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
'total' => $paginator->total(),
'last_page' => $paginator->lastPage(),
],
]);
}
}

41
app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolIndexController.php Normal file
View File

@@ -0,0 +1,41 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
use App\Http\Controllers\Controller;
use App\Models\JackpotPool;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
/**
* GET /api/v1/admin/jackpot/pools — Jackpot 奖池配置列表。
*/
final class AdminJackpotPoolIndexController extends Controller
{
public function __invoke(): JsonResponse
{
$rows = JackpotPool::query()->orderBy('currency_code')->get();
return ApiResponse::success([
'items' => $rows->map(fn (JackpotPool $p) => $this->row($p))->values()->all(),
]);
}
/** @return array<string, mixed> */
private function row(JackpotPool $p): array
{
return [
'id' => (int) $p->id,
'currency_code' => $p->currency_code,
'current_amount' => (int) $p->current_amount,
'contribution_rate' => (string) $p->contribution_rate,
'trigger_threshold' => (int) $p->trigger_threshold,
'payout_rate' => (string) $p->payout_rate,
'force_trigger_draw_gap' => (int) $p->force_trigger_draw_gap,
'min_bet_amount' => (int) $p->min_bet_amount,
'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(),
];
}
}

45
app/Http/Controllers/Api/V1/Admin/Jackpot/AdminJackpotPoolUpdateController.php Normal file
View File

@@ -0,0 +1,45 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Jackpot;
use App\Http\Controllers\Controller;
use App\Models\JackpotPool;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/**
* PUT /api/v1/admin/jackpot/pools/{pool} — 更新奖池运营参数（蓄水比例、阈值等）。
*/
final class AdminJackpotPoolUpdateController extends Controller
{
public function __invoke(Request $request, JackpotPool $pool): JsonResponse
{
$data = $request->validate([
'current_amount' => 'sometimes|integer|min:0',
'contribution_rate' => 'sometimes|numeric|min:0|max:1',
'trigger_threshold' => 'sometimes|integer|min:0',
'payout_rate' => 'sometimes|numeric|min:0|max:1',
'force_trigger_draw_gap' => 'sometimes|integer|min:0',
'min_bet_amount' => 'sometimes|integer|min:0',
'status' => 'sometimes|integer|in:0,1',
]);
$pool->fill($data);
$pool->save();
return ApiResponse::success([
'id' => (int) $pool->id,
'currency_code' => $pool->currency_code,
'current_amount' => (int) $pool->current_amount,
'contribution_rate' => (string) $pool->contribution_rate,
'trigger_threshold' => (int) $pool->trigger_threshold,
'payout_rate' => (string) $pool->payout_rate,
'force_trigger_draw_gap' => (int) $pool->force_trigger_draw_gap,
'min_bet_amount' => (int) $pool->min_bet_amount,
'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(),
]);
}
}

61
app/Http/Controllers/Api/V1/Admin/Settlement/AdminSettlementBatchDetailsController.php Normal file
View File

@@ -0,0 +1,61 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Settlement;
use App\Http\Controllers\Controller;
use App\Models\SettlementBatch;
use App\Models\TicketSettlementDetail;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/**
* GET /api/v1/admin/settlement-batches/{batch}/details — 该批次下注单结算明细分页。
*/
final class AdminSettlementBatchDetailsController extends Controller
{
public function __invoke(Request $request, SettlementBatch $batch): JsonResponse
{
$perPage = min(max((int) $request->integer('per_page', 25), 1), 100);
$page = max((int) $request->integer('page', 1), 1);
$paginator = TicketSettlementDetail::query()
->where('settlement_batch_id', $batch->id)
->with([
'ticketItem:id,ticket_no,play_code,player_id',
'ticketItem.player:id,username,site_player_id',
])
->orderBy('id')
->paginate($perPage, ['*'], 'page', $page);
return ApiResponse::success([
'batch_id' => (int) $batch->id,
'items' => collect($paginator->items())->map(function ($row) {
/** @var TicketSettlementDetail $row */
$item = $row->ticketItem;
$player = $item?->player;
return [
'id' => (int) $row->id,
'ticket_item_id' => (int) $row->ticket_item_id,
'ticket_no' => $item?->ticket_no,
'play_code' => $item?->play_code,
'player_id' => $item?->player_id,
'player_username' => $player?->username,
'site_player_id' => $player?->site_player_id,
'matched_prize_tier' => $row->matched_prize_tier,
'win_amount' => (int) $row->win_amount,
'jackpot_allocation_amount' => (int) $row->jackpot_allocation_amount,
'match_detail_json' => $row->match_detail_json,
'created_at' => $row->created_at?->toIso8601String(),
];
})->all(),
'meta' => [
'current_page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
'total' => $paginator->total(),
'last_page' => $paginator->lastPage(),
],
]);
}
}

67
app/Http/Controllers/Api/V1/Admin/Settlement/AdminSettlementBatchIndexController.php Normal file
View File

@@ -0,0 +1,67 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Settlement;
use App\Http\Controllers\Controller;
use App\Models\SettlementBatch;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/**
* GET /api/v1/admin/settlement-batches — 结算批次分页列表。
*/
final class AdminSettlementBatchIndexController extends Controller
{
public function __invoke(Request $request): JsonResponse
{
$perPage = min(max((int) $request->integer('per_page', 25), 1), 100);
$page = max((int) $request->integer('page', 1), 1);
$drawNo = trim((string) $request->query('draw_no', ''));
$status = trim((string) $request->query('status', ''));
$q = SettlementBatch::query()
->with(['draw:id,draw_no'])
->orderByDesc('id');
if ($drawNo !== '') {
$q->whereHas('draw', fn ($d) => $d->where('draw_no', 'like', '%'.$drawNo.'%'));
}
if ($status !== '') {
$q->where('status', $status);
}
$paginator = $q->paginate($perPage, ['*'], 'page', $page);
return ApiResponse::success([
'items' => collect($paginator->items())->map(fn (SettlementBatch $b) => $this->row($b))->all(),
'meta' => [
'current_page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
'total' => $paginator->total(),
'last_page' => $paginator->lastPage(),
],
]);
}
/** @return array<string, mixed> */
private function row(SettlementBatch $b): array
{
return [
'id' => (int) $b->id,
'draw_id' => (int) $b->draw_id,
'draw_no' => $b->draw?->draw_no,
'result_batch_id' => (int) $b->result_batch_id,
'settle_version' => (int) $b->settle_version,
'status' => $b->status,
'total_ticket_count' => (int) $b->total_ticket_count,
'total_win_count' => (int) $b->total_win_count,
'total_payout_amount' => (int) $b->total_payout_amount,
'total_jackpot_payout_amount' => (int) $b->total_jackpot_payout_amount,
'started_at' => $b->started_at?->toIso8601String(),
'finished_at' => $b->finished_at?->toIso8601String(),
'created_at' => $b->created_at?->toIso8601String(),
];
}
}

38
app/Http/Controllers/Api/V1/Admin/Settlement/AdminSettlementBatchShowController.php Normal file
View File

@@ -0,0 +1,38 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Settlement;
use App\Http\Controllers\Controller;
use App\Models\SettlementBatch;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
/**
* GET /api/v1/admin/settlement-batches/{batch} — 单批次摘要。
*/
final class AdminSettlementBatchShowController extends Controller
{
public function __invoke(SettlementBatch $batch): JsonResponse
{
$batch->load(['draw:id,draw_no,business_date,status', 'resultBatch:id,result_version,status']);
return ApiResponse::success([
'id' => (int) $batch->id,
'draw_id' => (int) $batch->draw_id,
'draw_no' => $batch->draw?->draw_no,
'draw_status' => $batch->draw?->status,
'result_batch_id' => (int) $batch->result_batch_id,
'result_batch_version' => $batch->resultBatch?->result_version,
'result_batch_status' => $batch->resultBatch?->status,
'settle_version' => (int) $batch->settle_version,
'status' => $batch->status,
'total_ticket_count' => (int) $batch->total_ticket_count,
'total_win_count' => (int) $batch->total_win_count,
'total_payout_amount' => (int) $batch->total_payout_amount,
'total_jackpot_payout_amount' => (int) $batch->total_jackpot_payout_amount,
'started_at' => $batch->started_at?->toIso8601String(),
'finished_at' => $batch->finished_at?->toIso8601String(),
'created_at' => $batch->created_at?->toIso8601String(),
]);
}
}