processNext($villageId, $now)) { $count++; } return $count; } /** The village with the oldest due event, for the worker. */ public function nextDueVillage(CarbonImmutable $now): ?int { return GameEvent::whereNull('processed_at') ->where('fire_at', '<=', self::stamp($now)) ->orderBy('fire_at')->orderBy('id') ->value('village_id'); } public function nextFireAt(): ?CarbonImmutable { return GameEvent::whereNull('processed_at')->orderBy('fire_at')->first()?->fire_at; } /** * Give up on an event that keeps failing, so one broken row can't stall the * village forever. It stays in the table with attempts set, for a look later. */ public function recordFailure(int $villageId, CarbonImmutable $now, int $maxAttempts = 3): void { $event = $this->due($villageId, $now)->first(); if (! $event) { return; } $event->increment('attempts'); if ($event->attempts >= $maxAttempts) { $event->update(['processed_at' => $now]); } } private function processNext(int $villageId, CarbonImmutable $now): bool { return DB::transaction(function () use ($villageId, $now) { $village = Village::whereKey($villageId)->lockForUpdate()->first(); $event = $village ? $this->due($villageId, $now)->first() : null; if (! $event) { return false; } $event->update(['processed_at' => $now]); $this->handle($village, $event); $village->save(); return true; }); } private function due(int $villageId, CarbonImmutable $now) { return GameEvent::where('village_id', $villageId) ->whereNull('processed_at') ->where('fire_at', '<=', self::stamp($now)) ->orderBy('fire_at')->orderBy('id'); } private function handle(Village $village, GameEvent $event): void { match ($event->type) { GameEvent::BUILD_ORDER_FINISHED => $this->finishBuildOrder($village, $event), }; } private function finishBuildOrder(Village $village, GameEvent $event): void { $sim = Simulation::of($village); $order = $village->orders->firstWhere('id', $event->subject_id); if (! $order) { return; } $sim->settle($event->fire_at); $sim->finish($order); $sim->startWaitingOrders($event->fire_at); } /** Milliseconds matter: fire_at is datetime(3) and the default binding drops them. */ public static function stamp(CarbonImmutable $at): string { return $at->format('Y-m-d H:i:s.v'); } }