feat: complete reservation lifecycle

app/Domain/Reservations/Models/Reservation.php

@@ -4,11 +4,18 @@ namespace App\Domain\Reservations\Models;
 
 use App\Domain\Reservations\Enums\ReservationStatus;
 use App\Models\User;
+use Carbon\CarbonImmutable;
 use Illuminate\Database\Eloquent\Concerns\HasUuids;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
+/**
+ * @property ReservationStatus $status
+ * @property CarbonImmutable $starts_at
+ * @property CarbonImmutable $ends_at
+ * @property CarbonImmutable|null $approval_deadline
+ */
 class Reservation extends Model
 {
     use HasUuids;

app/Domain/Reservations/Services/AvailabilityService.php

@@ -5,9 +5,26 @@ namespace App\Domain\Reservations\Services;
 use App\Domain\Inventory\Models\SnipeAsset;
 use App\Domain\Reservations\Enums\ReservationItemStatus;
 use DateTimeInterface;
+use Illuminate\Database\Eloquent\Builder;
 
 class AvailabilityService
 {
+    /** @return Builder<SnipeAsset> */
+    public function availableAssets(DateTimeInterface $startsAt, DateTimeInterface $endsAt): Builder
+    {
+        return SnipeAsset::query()
+            ->where('active', true)
+            ->where('requestable', true)
+            ->whereNull('assigned_id')
+            ->whereDoesntHave('reservationItems', fn (Builder $query): Builder => $query
+                ->whereIn('status', ReservationItemStatus::blockingValues())
+                ->where('starts_at', '<', $endsAt)
+                ->where('ends_at', '>', $startsAt))
+            ->whereDoesntHave('blocks', fn (Builder $query): Builder => $query
+                ->where('starts_at', '<', $endsAt)
+                ->where('ends_at', '>', $startsAt));
+    }
+
     public function isAvailable(SnipeAsset $asset, DateTimeInterface $startsAt, DateTimeInterface $endsAt): bool
     {
         if (! $asset->active || ! $asset->requestable || $asset->assigned_id !== null) {

app/Domain/Reservations/Services/ReservationService.php

@@ -9,6 +9,7 @@ use App\Domain\Reservations\Enums\ReservationStatus;
 use App\Domain\Reservations\Models\Reservation;
 use App\Models\User;
 use Carbon\CarbonImmutable;
+use Illuminate\Auth\Access\AuthorizationException;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
 use Illuminate\Validation\ValidationException;
@@ -78,6 +79,107 @@ class ReservationService
         }, 3);
     }
 
+    public function cancel(Reservation $reservation, User $actor, string $reason): Reservation
+    {
+        if ($reservation->requester_id !== $actor->id) {
+            throw new AuthorizationException('Apenas o requisitante pode cancelar este pedido.');
+        }
+
+        return DB::transaction(function () use ($reservation, $actor, $reason): Reservation {
+            $lockedReservation = Reservation::query()
+                ->whereKey($reservation->id)
+                ->lockForUpdate()
+                ->firstOrFail();
+
+            if (! $lockedReservation->status->canTransitionTo(ReservationStatus::Cancelled)) {
+                throw ValidationException::withMessages([
+                    'reason' => 'Esta requisição já não pode ser cancelada.',
+                ]);
+            }
+
+            $previousStatus = $lockedReservation->status->value;
+            $lockedReservation->update([
+                'status' => ReservationStatus::Cancelled,
+                'cancelled_by' => $actor->id,
+                'cancelled_at' => now(),
+                'cancellation_reason' => $reason,
+            ]);
+            $lockedReservation->items()
+                ->whereIn('status', ReservationItemStatus::blockingValues())
+                ->update(['status' => ReservationItemStatus::Cancelled]);
+
+            AuditLog::create([
+                'actor_id' => $actor->id,
+                'event' => 'reservation.cancelled',
+                'auditable_type' => $lockedReservation->getMorphClass(),
+                'auditable_id' => $lockedReservation->id,
+                'before' => ['status' => $previousStatus],
+                'after' => [
+                    'status' => ReservationStatus::Cancelled->value,
+                    'cancellation_reason' => $reason,
+                ],
+            ]);
+
+            return $lockedReservation->load('items.asset');
+        }, 3);
+    }
+
+    public function expirePending(int $limit = 100): int
+    {
+        $reservationIds = Reservation::query()
+            ->whereIn('status', [
+                ReservationStatus::PendingApproval,
+                ReservationStatus::AwaitingInformation,
+            ])
+            ->whereNotNull('approval_deadline')
+            ->where('approval_deadline', '<=', now())
+            ->oldest('approval_deadline')
+            ->limit($limit)
+            ->pluck('id');
+
+        $expired = 0;
+
+        foreach ($reservationIds as $reservationId) {
+            $didExpire = DB::transaction(function () use ($reservationId): bool {
+                $reservation = Reservation::query()
+                    ->whereKey($reservationId)
+                    ->lockForUpdate()
+                    ->first();
+
+                if ($reservation === null
+                    || $reservation->approval_deadline === null
+                    || $reservation->approval_deadline->isFuture()
+                    || ! $reservation->status->canTransitionTo(ReservationStatus::Expired)) {
+                    return false;
+                }
+
+                $previousStatus = $reservation->status->value;
+                $reservation->update(['status' => ReservationStatus::Expired]);
+                $reservation->items()
+                    ->whereIn('status', ReservationItemStatus::blockingValues())
+                    ->update(['status' => ReservationItemStatus::Cancelled]);
+
+                AuditLog::create([
+                    'actor_id' => null,
+                    'event' => 'reservation.expired',
+                    'auditable_type' => $reservation->getMorphClass(),
+                    'auditable_id' => $reservation->id,
+                    'before' => ['status' => $previousStatus],
+                    'after' => ['status' => ReservationStatus::Expired->value],
+                    'metadata' => ['approval_deadline' => $reservation->approval_deadline->toIso8601String()],
+                ]);
+
+                return true;
+            }, 3);
+
+            if ($didExpire) {
+                $expired++;
+            }
+        }
+
+        return $expired;
+    }
+
     private function nextReference(): string
     {
         do {