crewli/api/app/Models/ShiftAssignment.php

<?php

declare(strict_types=1);

namespace App\Models;

use App\Enums\CancellationSource;
use App\Enums\ShiftAssignmentStatus;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Concerns\HasUlids;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\SoftDeletes;

final class ShiftAssignment extends Model
{
    use HasFactory;
    use HasUlids;
    use SoftDeletes;

    protected $fillable = [
        'shift_id',
        'person_id',
        'time_slot_id',
        'status',
        'auto_approved',
        'assigned_by',
        'assigned_at',
        'approved_by',
        'approved_at',
        'rejection_reason',
        'cancelled_by',
        'cancellation_source',
        'cancelled_at',
        'hours_expected',
        'hours_completed',
        'checked_in_at',
        'checked_out_at',
    ];

    protected function casts(): array
    {
        return [
            'status' => ShiftAssignmentStatus::class,
            'cancellation_source' => CancellationSource::class,
            'auto_approved' => 'boolean',
            'assigned_at' => 'datetime',
            'approved_at' => 'datetime',
            'cancelled_at' => 'datetime',
            'checked_in_at' => 'datetime',
            'checked_out_at' => 'datetime',
            'hours_expected' => 'decimal:2',
            'hours_completed' => 'decimal:2',
        ];
    }

    public function shift(): BelongsTo
    {
        return $this->belongsTo(Shift::class);
    }

    public function person(): BelongsTo
    {
        return $this->belongsTo(Person::class);
    }

    public function timeSlot(): BelongsTo
    {
        return $this->belongsTo(TimeSlot::class);
    }

    public function assignedByUser(): BelongsTo
    {
        return $this->belongsTo(User::class, 'assigned_by');
    }

    public function approvedByUser(): BelongsTo
    {
        return $this->belongsTo(User::class, 'approved_by');
    }

    public function cancelledByUser(): BelongsTo
    {
        return $this->belongsTo(User::class, 'cancelled_by');
    }

    public function scopeActive(Builder $query): Builder
    {
        return $query->whereIn('status', [
            ShiftAssignmentStatus::PENDING_APPROVAL,
            ShiftAssignmentStatus::APPROVED,
        ]);
    }

    public function scopeForStatus(Builder $query, ShiftAssignmentStatus $status): Builder
    {
        return $query->where('status', $status);
    }

    public function isCancellable(): bool
    {
        return $this->status->canTransitionTo(ShiftAssignmentStatus::CANCELLED);
    }

    public function isApprovable(): bool
    {
        return $this->status->canTransitionTo(ShiftAssignmentStatus::APPROVED);
    }
}