Files
famous-ly4-ev/app-modules/booking/src/Models/Booking.php
T
Nyan Lin Paing fa908cdcaf
PHP Tests / php-tests (push) Has been cancelled
add notes/remark and refactor round-trip
2026-08-22 21:43:41 +07:00

136 lines
3.8 KiB
PHP

<?php
namespace Modules\Booking\Models;
use App\Models\User;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\SoftDeletes;
use Modules\Booking\Database\Factories\BookingFactory;
use Modules\Booking\Enums\BookingChannel;
use Modules\Booking\Enums\BookingStatus;
use Modules\Catalog\Models\DepartureTimeSlot;
use Modules\Payment\Models\Payment;
use Modules\Routing\Models\EvRoute;
use Spatie\Activitylog\Models\Concerns\LogsActivity;
use Spatie\Activitylog\Support\LogOptions;
class Booking extends Model
{
/** @use HasFactory<BookingFactory> */
use HasFactory, LogsActivity, SoftDeletes;
/**
* Audit trail on status transitions and driver/vehicle assignment only —
* not every column (domain.md §6, §5a; T6.2).
*/
public function getActivitylogOptions(): LogOptions
{
return LogOptions::defaults()
->logOnly(['status', 'driver_name', 'driver_phone', 'car_plate_number', 'car_model'])
->logOnlyDirty()
->dontLogEmptyChanges()
->useLogName('booking');
}
/**
* @var list<string>
*/
protected $fillable = [
'booking_ref',
'user_id',
'openid',
'ev_route_id',
'linked_booking_id',
'is_return_leg',
'departure_time_slot_id',
'travel_date',
'passenger_name',
'passenger_phone',
'notes',
'remark',
'pickup_address',
'pickup_lat',
'pickup_lng',
'dropoff_address',
'dropoff_lat',
'dropoff_lng',
'price',
'status',
'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_return_leg' => 'boolean',
'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');
}
/**
* The other leg of a round trip (outbound <-> return), linked
* bidirectionally by CreateBookingAction. Null for a plain one-way
* booking — see the `isRoundTrip()` accessor (domain.md §2b).
*/
public function linkedBooking(): BelongsTo
{
return $this->belongsTo(Booking::class, 'linked_booking_id');
}
public function timeSlot(): BelongsTo
{
return $this->belongsTo(DepartureTimeSlot::class, 'departure_time_slot_id');
}
public function vehicleOptions(): HasMany
{
return $this->hasMany(BookingVehicleOption::class);
}
public function payments(): HasMany
{
return $this->hasMany(Payment::class);
}
/**
* True when this booking has a linked leg — i.e. it's one half of a
* round trip. Computed, not stored: presence of `linked_booking_id` is
* the single source of truth, so it can't drift out of sync the way a
* separate flag column could (domain.md §2b).
*/
public function isRoundTrip(): Attribute
{
return Attribute::make(
get: fn (): bool => $this->linked_booking_id !== null,
);
}
}