Files
lotteryLaravel/app/Services/Draw/DrawPublishService.php
kang 48349e3302 feat: Enhance settlement and draw management functionality
- Implement error handling for skipped settlement runs in DrawSettlementRunController, returning appropriate error messages based on draw status.
- Add validation in DrawPublishService to ensure draws are ready for publication, rejecting outdated result batches.
- Update SettlementBatchWorkflowService to revert ticket statuses upon settlement rejection and restore jackpot pool amounts.
- Refactor LotteryTransferService to improve transaction handling for transfer order reconciliation, ensuring idempotency during reversals.
- Add multi-language support for new error messages related to settlement processes.
2026-05-26 14:10:16 +08:00

124 lines
4.4 KiB
PHP

<?php
namespace App\Services\Draw;
use App\Models\Draw;
use App\Models\AdminUser;
use App\Lottery\DrawStatus;
use App\Models\DrawResultBatch;
use Illuminate\Support\Facades\DB;
use App\Services\LotterySettings;
use App\Lottery\DrawResultBatchStatus;
/**
* 人工审核通过后发布结果;或 RNG 自动生成路径内联调用同一事务字段更新。
*/
final class DrawPublishService
{
public function __construct(
private readonly LotteryHallRealtimeBroadcaster $hallRealtime,
private readonly DrawHallSnapshotBuilder $snapshot,
) {}
public function publishManualBatch(DrawResultBatch $batch, AdminUser $admin): Draw
{
$draw = DB::transaction(function () use ($batch, $admin): Draw {
/** @var DrawResultBatch $lockedBatch */
$lockedBatch = DrawResultBatch::query()->whereKey($batch->id)->lockForUpdate()->firstOrFail();
if ($lockedBatch->status !== DrawResultBatchStatus::PendingReview->value) {
throw new \RuntimeException('batch_not_pending_review');
}
/** @var Draw $draw */
$draw = Draw::query()->whereKey($lockedBatch->draw_id)->lockForUpdate()->firstOrFail();
$this->assertDrawReadyToPublish($draw, $lockedBatch);
DrawResultBatch::query()
->where('draw_id', $draw->id)
->where('id', '!=', $lockedBatch->id)
->where('status', DrawResultBatchStatus::Published->value)
->update(['status' => DrawResultBatchStatus::Rejected->value]);
$lockedBatch->forceFill([
'status' => DrawResultBatchStatus::Published->value,
'confirmed_by' => $admin->id,
'confirmed_at' => now(),
])->save();
return $this->applyPublishedToDraw($draw, $lockedBatch);
});
$data = $this->snapshot->build();
$this->hallRealtime->notifyResultPublished($data);
$this->hallRealtime->notifyStatusChange($data);
return $draw;
}
/** RNG 自动生成且无需审核时在同一事务调用 */
public function markPublishedInTransaction(Draw $draw, DrawResultBatch $batch): Draw
{
$batch->forceFill([
'status' => DrawResultBatchStatus::Published->value,
'confirmed_by' => null,
'confirmed_at' => now(),
])->save();
$draw = $this->applyPublishedToDraw($draw, $batch);
DB::afterCommit(function (): void {
$data = app(DrawHallSnapshotBuilder::class)->build();
app(LotteryHallRealtimeBroadcaster::class)->notifyResultPublished($data);
});
return $draw;
}
private function applyPublishedToDraw(Draw $draw, DrawResultBatch $batch): Draw
{
$cooldownMinutes = max(0, (int) LotterySettings::get(
'draw.cooldown_minutes',
(int) config('lottery.draw.cooldown_minutes', 15),
));
if ($cooldownMinutes > 0) {
$draw->forceFill([
'status' => DrawStatus::Cooldown->value,
'current_result_version' => (int) $batch->result_version,
'result_source' => $batch->source_type,
'cooling_end_time' => now()->addMinutes($cooldownMinutes),
])->save();
} else {
$draw->forceFill([
'status' => DrawStatus::Settling->value,
'current_result_version' => (int) $batch->result_version,
'result_source' => $batch->source_type,
'cooling_end_time' => null,
])->save();
}
return $draw->refresh();
}
private function assertDrawReadyToPublish(Draw $draw, DrawResultBatch $batch): void
{
if ($draw->status === DrawStatus::Cancelled->value || $draw->status === DrawStatus::Settled->value) {
throw new \RuntimeException('draw_not_ready_to_publish');
}
if ((int) $batch->result_version < (int) $draw->current_result_version) {
throw new \RuntimeException('batch_result_version_stale');
}
$allowed = [
DrawStatus::Closed->value,
DrawStatus::Review->value,
DrawStatus::Cooldown->value,
DrawStatus::Settling->value,
];
if (! in_array($draw->status, $allowed, true)) {
throw new \RuntimeException('draw_not_ready_to_publish');
}
}
}