Files
famous-ly4-ev/app-modules/booking/src/Services/BookingRefGenerator.php
T
Nyan Lin Paing 5b68f4fa38 Add Booking module: model, create/read/cancel API, Filament resource (T4.1-T4.7)
- Booking model with booking_vehicle_options line items (supports mixing
  vehicle options like front_seat + back_seat in one booking), price
  snapshot, status machine, and driver/car assignment fields
- BookingService: front-seat max, disabled-option toggles, duplicate-option
  and whole-vehicle-exclusivity guards
- CreateBookingAction, CancelBookingAction, AssignDriverAction
- BookingRefGenerator: sequential EVB-AAAAA1-style refs via row lock
- POST/GET/cancel booking API endpoints (Sanctum, ownership + admin policy)
- BookingPlugin + Filament BookingResource: list, detail view, Cancel and
  Assign Driver actions (shared between table and detail page)
- domain.md updated for multi-vehicle-option bookings (§2) and driver/
  vehicle assignment (§5a)
2026-08-08 21:43:15 +07:00

61 lines
1.7 KiB
PHP

<?php
namespace Modules\Booking\Services;
use Modules\Booking\Models\Booking;
class BookingRefGenerator
{
private const PREFIX = 'EVB';
private const CHARS = '123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';
/**
* Must be called inside the same DB::transaction() as the booking insert
* — the row lock on the latest booking is what keeps concurrent callers
* from generating the same ref, and it only holds for the transaction's
* lifetime.
*/
public function generate(): string
{
// Lock the latest row so concurrent transactions can't read the same ref.
$latest = Booking::lockForUpdate()->orderByDesc('id')->value('booking_ref');
// If the latest ref doesn't match the expected format, start the sequence fresh.
if ($latest && preg_match('/^[A-Z]+-[A-Z0-9]+$/', $latest)) {
return $this->incrementRef($latest);
}
return self::PREFIX.'-AAAAA1';
}
private function incrementRef(string $ref): string
{
preg_match('/^(.*)-([A-Z0-9]+)$/', $ref, $matches);
$prefix = $matches[1];
$suffix = str_split($matches[2]);
$base = strlen(self::CHARS);
$i = count($suffix) - 1;
$carry = true;
while ($i >= 0 && $carry) {
$idx = strpos(self::CHARS, $suffix[$i]);
if ($idx + 1 < $base) {
$suffix[$i] = self::CHARS[$idx + 1];
$carry = false;
} else {
$suffix[$i] = self::CHARS[0];
}
$i--;
}
if ($carry) {
array_unshift($suffix, self::CHARS[0]);
}
return $prefix.'-'.implode('', $suffix);
}
}