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,88 @@
+<?php
+
+namespace Modules\Booking\Models;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Modules\Booking\Database\Factories\BookingFactory;
+use Modules\Booking\Enums\BookingChannel;
+use Modules\Booking\Enums\BookingStatus;
+use Modules\Catalog\Models\DepartureTimeSlot;
+use Modules\Routing\Models\EvRoute;
+
+class Booking extends Model
+{
+    /** @use HasFactory<BookingFactory> */
+    use HasFactory;
+
+    /**
+     * @var list<string>
+     */
+    protected $fillable = [
+        'booking_ref',
+        'user_id',
+        'openid',
+        'ev_route_id',
+        'departure_time_slot_id',
+        'travel_date',
+        'passenger_name',
+        'passenger_phone',
+        'pickup_address',
+        'pickup_lat',
+        'pickup_lng',
+        'dropoff_address',
+        'dropoff_lat',
+        'dropoff_lng',
+        'price',
+        'status',
+        'is_round_trip',
+        'return_travel_date',
+        'created_by_channel',
+        'driver_name',
+        'driver_phone',
+        'car_plate_number',
+        'car_model',
+    ];
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'travel_date' => 'date',
+            'pickup_lat' => 'decimal:7',
+            'pickup_lng' => 'decimal:7',
+            'dropoff_lat' => 'decimal:7',
+            'dropoff_lng' => 'decimal:7',
+            'price' => 'decimal:2',
+            'status' => BookingStatus::class,
+            'is_round_trip' => 'boolean',
+            'return_travel_date' => 'date',
+            'created_by_channel' => BookingChannel::class,
+        ];
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function route(): BelongsTo
+    {
+        return $this->belongsTo(EvRoute::class, 'ev_route_id');
+    }
+
+    public function timeSlot(): BelongsTo
+    {
+        return $this->belongsTo(DepartureTimeSlot::class, 'departure_time_slot_id');
+    }
+
+    public function vehicleOptions(): HasMany
+    {
+        return $this->hasMany(BookingVehicleOption::class);
+    }
+}
@@ -0,0 +1,48 @@
+<?php
+
+namespace Modules\Booking\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Modules\Booking\Database\Factories\BookingVehicleOptionFactory;
+use Modules\Shared\Enums\VehicleOption;
+
+/**
+ * One Vehicle Option line on a Booking (e.g. "back_seat x2"). A booking can
+ * have more than one of these — see domain.md §2.
+ */
+class BookingVehicleOption extends Model
+{
+    /** @use HasFactory<BookingVehicleOptionFactory> */
+    use HasFactory;
+
+    /**
+     * @var list<string>
+     */
+    protected $fillable = [
+        'booking_id',
+        'vehicle_option',
+        'passenger_count',
+        'unit_price',
+        'line_total',
+    ];
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'vehicle_option' => VehicleOption::class,
+            'passenger_count' => 'integer',
+            'unit_price' => 'decimal:2',
+            'line_total' => 'decimal:2',
+        ];
+    }
+
+    public function booking(): BelongsTo
+    {
+        return $this->belongsTo(Booking::class);
+    }
+}