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
parent 4da9ecfe7d
commit 5b68f4fa38
51 changed files with 2698 additions and 42 deletions
@@ -0,0 +1,60 @@
+<?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);
+    }
+}