feat: complete reservation lifecycle

tests/Feature/AvailabilityServiceTest.php

@@ -7,6 +7,7 @@ use App\Domain\Reservations\Models\Reservation;
 use App\Domain\Reservations\Services\AvailabilityService;
 use App\Models\User;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use Inertia\Testing\AssertableInertia as Assert;
 
 uses(RefreshDatabase::class);
 
@@ -45,3 +46,99 @@ it('recusa ativos atribuídos ou não requisitáveis', function () {
     expect($service->isAvailable($assigned, ...$period))->toBeFalse()
         ->and($service->isAvailable($notRequestable, ...$period))->toBeFalse();
 });
+
+it('produz uma consulta de equipamentos livres para um período', function () {
+    $free = SnipeAsset::factory()->create();
+    $busy = SnipeAsset::factory()->create();
+    $touching = SnipeAsset::factory()->create();
+    $blocked = SnipeAsset::factory()->create();
+    $user = User::factory()->create();
+
+    foreach ([$busy, $touching] as $index => $asset) {
+        $reservation = Reservation::create([
+            'reference' => "REQ-QUERY-00{$index}",
+            'requester_id' => $user->id,
+            'purpose' => 'Reserva existente para testar disponibilidade.',
+            'usage_location' => 'Estúdio',
+            'starts_at' => '2026-09-10 09:00:00',
+            'ends_at' => '2026-09-10 11:00:00',
+            'status' => ReservationStatus::Approved,
+        ]);
+        $reservation->items()->create([
+            'snipe_asset_id' => $asset->id,
+            'starts_at' => '2026-09-10 09:00:00',
+            'ends_at' => '2026-09-10 11:00:00',
+            'status' => ReservationItemStatus::Reserved,
+        ]);
+    }
+    $blocked->blocks()->create([
+        'starts_at' => '2026-09-10 10:45:00',
+        'ends_at' => '2026-09-10 11:30:00',
+        'reason' => 'Manutenção preventiva programada.',
+        'created_by' => $user->id,
+    ]);
+
+    $ids = app(AvailabilityService::class)
+        ->availableAssets(
+            new DateTimeImmutable('2026-09-10 10:30:00'),
+            new DateTimeImmutable('2026-09-10 12:00:00'),
+        )
+        ->pluck('id');
+
+    expect($ids)->toContain($free->id)
+        ->not->toContain($busy->id, $touching->id, $blocked->id);
+
+    $boundaryIds = app(AvailabilityService::class)
+        ->availableAssets(
+            new DateTimeImmutable('2026-09-10 11:00:00'),
+            new DateTimeImmutable('2026-09-10 12:00:00'),
+        )
+        ->pluck('id');
+
+    expect($boundaryIds)->toContain($free->id, $busy->id, $touching->id)
+        ->not->toContain($blocked->id);
+});
+
+it('filtra o catálogo pelo período solicitado', function () {
+    $user = User::factory()->create();
+    $free = SnipeAsset::factory()->create();
+    $busy = SnipeAsset::factory()->create();
+    $reservation = Reservation::create([
+        'reference' => 'REQ-CATALOG-001',
+        'requester_id' => $user->id,
+        'purpose' => 'Reserva existente para testar o catálogo público.',
+        'usage_location' => 'Estúdio',
+        'starts_at' => '2026-09-10 09:00:00',
+        'ends_at' => '2026-09-10 11:00:00',
+        'status' => ReservationStatus::Approved,
+    ]);
+    $reservation->items()->create([
+        'snipe_asset_id' => $busy->id,
+        'starts_at' => '2026-09-10 09:00:00',
+        'ends_at' => '2026-09-10 11:00:00',
+        'status' => ReservationItemStatus::Reserved,
+    ]);
+
+    $query = http_build_query([
+        'starts_at' => '2026-09-10T10:00',
+        'ends_at' => '2026-09-10T12:00',
+    ]);
+
+    $this->actingAs($user)
+        ->get("/equipamentos?{$query}")
+        ->assertOk()
+        ->assertInertia(fn (Assert $page) => $page
+            ->component('assets/index')
+            ->where('periodSelected', true)
+            ->has('assets.data', 1)
+            ->where('assets.data.0.id', $free->id));
+
+    $this->get("/requisicoes/nova?asset={$busy->id}&{$query}")
+        ->assertOk()
+        ->assertInertia(fn (Assert $page) => $page
+            ->component('reservations/create')
+            ->where('periodSelected', true)
+            ->where('selectedAssetId', 0)
+            ->has('assets', 1)
+            ->where('assets.0.id', $free->id));
+});

tests/Feature/ReservationCalendarTest.php

@@ -0,0 +1,51 @@
+<?php
+
+use App\Domain\Reservations\Enums\ReservationStatus;
+use App\Domain\Reservations\Models\Reservation;
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Inertia\Testing\AssertableInertia as Assert;
+
+uses(RefreshDatabase::class);
+
+it('mostra no calendário apenas as requisições do utilizador que intersectam o mês', function () {
+    $user = User::factory()->create();
+    $other = User::factory()->create();
+
+    Reservation::create([
+        'reference' => 'REQ-CALENDAR-001',
+        'requester_id' => $user->id,
+        'purpose' => 'Reserva que atravessa o início do mês consultado.',
+        'usage_location' => 'Auditório',
+        'starts_at' => '2026-08-31 22:00:00',
+        'ends_at' => '2026-09-01 10:00:00',
+        'status' => ReservationStatus::Approved,
+    ]);
+    Reservation::create([
+        'reference' => 'REQ-CALENDAR-OUTSIDE',
+        'requester_id' => $user->id,
+        'purpose' => 'Reserva fora do mês que está a ser consultado.',
+        'usage_location' => 'Estúdio',
+        'starts_at' => '2026-10-02 09:00:00',
+        'ends_at' => '2026-10-02 11:00:00',
+        'status' => ReservationStatus::PendingApproval,
+    ]);
+    Reservation::create([
+        'reference' => 'REQ-CALENDAR-OTHER',
+        'requester_id' => $other->id,
+        'purpose' => 'Reserva pertencente a um utilizador diferente.',
+        'usage_location' => 'Sala 2',
+        'starts_at' => '2026-09-10 09:00:00',
+        'ends_at' => '2026-09-10 11:00:00',
+        'status' => ReservationStatus::Approved,
+    ]);
+
+    $this->actingAs($user)
+        ->get('/requisicoes/calendario?month=2026-09')
+        ->assertOk()
+        ->assertInertia(fn (Assert $page) => $page
+            ->component('reservations/calendar')
+            ->where('month', '2026-09')
+            ->has('reservations', 1)
+            ->where('reservations.0.reference', 'REQ-CALENDAR-001'));
+});

tests/Feature/ReservationCancellationTest.php

@@ -0,0 +1,95 @@
+<?php
+
+use App\Domain\Inventory\Models\SnipeAsset;
+use App\Domain\Reservations\Enums\ReservationItemStatus;
+use App\Domain\Reservations\Enums\ReservationStatus;
+use App\Domain\Reservations\Models\Reservation;
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+
+uses(RefreshDatabase::class);
+
+it('permite ao requisitante cancelar e liberta os equipamentos com auditoria', function () {
+    $user = User::factory()->create();
+    $asset = SnipeAsset::factory()->create();
+    $reservation = Reservation::create([
+        'reference' => 'REQ-CANCEL-001',
+        'requester_id' => $user->id,
+        'purpose' => 'Captação de uma sessão para arquivo institucional.',
+        'usage_location' => 'Auditório',
+        'starts_at' => now()->addDays(3),
+        'ends_at' => now()->addDays(3)->addHours(2),
+        'status' => ReservationStatus::PendingApproval,
+        'approval_deadline' => now()->addDay(),
+    ]);
+    $item = $reservation->items()->create([
+        'snipe_asset_id' => $asset->id,
+        'starts_at' => $reservation->starts_at,
+        'ends_at' => $reservation->ends_at,
+        'status' => ReservationItemStatus::Held,
+    ]);
+
+    $this->actingAs($user)
+        ->post("/requisicoes/{$reservation->uuid}/cancelar", [
+            'reason' => 'A sessão foi adiada pela organização.',
+        ])
+        ->assertRedirect()
+        ->assertSessionHas('success');
+
+    expect($reservation->fresh()->status)->toBe(ReservationStatus::Cancelled)
+        ->and($item->fresh()->status)->toBe(ReservationItemStatus::Cancelled);
+    $this->assertDatabaseHas('reservations', [
+        'id' => $reservation->id,
+        'cancelled_by' => $user->id,
+        'cancellation_reason' => 'A sessão foi adiada pela organização.',
+    ]);
+    $this->assertDatabaseHas('audit_logs', [
+        'event' => 'reservation.cancelled',
+        'actor_id' => $user->id,
+        'auditable_id' => $reservation->id,
+    ]);
+});
+
+it('impede outro utilizador de cancelar a requisição', function () {
+    $owner = User::factory()->create();
+    $reservation = Reservation::create([
+        'reference' => 'REQ-CANCEL-002',
+        'requester_id' => $owner->id,
+        'purpose' => 'Apoio técnico a uma atividade previamente agendada.',
+        'usage_location' => 'Sala 4',
+        'starts_at' => now()->addDays(3),
+        'ends_at' => now()->addDays(3)->addHour(),
+        'status' => ReservationStatus::PendingApproval,
+    ]);
+
+    $this->actingAs(User::factory()->create())
+        ->post("/requisicoes/{$reservation->uuid}/cancelar", [
+            'reason' => 'Tentativa por outro utilizador.',
+        ])
+        ->assertForbidden();
+
+    expect($reservation->fresh()->status)->toBe(ReservationStatus::PendingApproval);
+});
+
+it('não cancela uma requisição num estado terminal', function () {
+    $user = User::factory()->create();
+    $reservation = Reservation::create([
+        'reference' => 'REQ-CANCEL-003',
+        'requester_id' => $user->id,
+        'purpose' => 'Pedido já concluído e sem operações pendentes.',
+        'usage_location' => 'Biblioteca',
+        'starts_at' => now()->subDays(3),
+        'ends_at' => now()->subDays(3)->addHour(),
+        'status' => ReservationStatus::Completed,
+    ]);
+
+    $this->actingAs($user)
+        ->from('/requisicoes')
+        ->post("/requisicoes/{$reservation->uuid}/cancelar", [
+            'reason' => 'Já não preciso deste equipamento.',
+        ])
+        ->assertRedirect('/requisicoes')
+        ->assertSessionHasErrors('reason');
+
+    expect($reservation->fresh()->status)->toBe(ReservationStatus::Completed);
+});

tests/Feature/ReservationExpirationTest.php

@@ -0,0 +1,53 @@
+<?php
+
+use App\Domain\Inventory\Models\SnipeAsset;
+use App\Domain\Reservations\Enums\ReservationItemStatus;
+use App\Domain\Reservations\Enums\ReservationStatus;
+use App\Domain\Reservations\Models\Reservation;
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+
+uses(RefreshDatabase::class);
+
+it('expira apenas pré-reservas cujo prazo terminou e liberta os equipamentos', function () {
+    $user = User::factory()->create();
+    $due = Reservation::create([
+        'reference' => 'REQ-EXPIRE-001',
+        'requester_id' => $user->id,
+        'purpose' => 'Pedido sem decisão dentro do prazo previsto.',
+        'usage_location' => 'Auditório',
+        'starts_at' => now()->addDays(2),
+        'ends_at' => now()->addDays(2)->addHours(2),
+        'status' => ReservationStatus::PendingApproval,
+        'approval_deadline' => now()->subMinute(),
+    ]);
+    $dueItem = $due->items()->create([
+        'snipe_asset_id' => SnipeAsset::factory()->create()->id,
+        'starts_at' => $due->starts_at,
+        'ends_at' => $due->ends_at,
+        'status' => ReservationItemStatus::Held,
+    ]);
+    $future = Reservation::create([
+        'reference' => 'REQ-EXPIRE-002',
+        'requester_id' => $user->id,
+        'purpose' => 'Pedido ainda dentro do prazo de decisão definido.',
+        'usage_location' => 'Estúdio',
+        'starts_at' => now()->addDays(4),
+        'ends_at' => now()->addDays(4)->addHour(),
+        'status' => ReservationStatus::AwaitingInformation,
+        'approval_deadline' => now()->addHour(),
+    ]);
+
+    $this->artisan('reservations:expire')
+        ->expectsOutput('1 pré-reserva(s) expirada(s).')
+        ->assertSuccessful();
+
+    expect($due->fresh()->status)->toBe(ReservationStatus::Expired)
+        ->and($dueItem->fresh()->status)->toBe(ReservationItemStatus::Cancelled)
+        ->and($future->fresh()->status)->toBe(ReservationStatus::AwaitingInformation);
+    $this->assertDatabaseHas('audit_logs', [
+        'event' => 'reservation.expired',
+        'actor_id' => null,
+        'auditable_id' => $due->id,
+    ]);
+});