Skip to main content

Criação e gestão de reservas

Este documento descreve a gestão das Reservas de espaço — como listar, filtrar, aprovar e negar solicitações de reserva de espaços físicos.

Perfil indicado

Rotina de portaria/gestão, liberada para os perfis Gerente de Biometria, Gerente e Administrador.

Onde gerenciar​

A gestão é feita na página "/physical-space-reservations" ("Reservas de espaço").

Listar e filtrar​

A tela lista as reservas e permite filtrá-las por:

  • Status: Solicitadas, Confirmadas, Negadas, Canceladas, Abandonadas (por padrão, exibe Solicitadas e Confirmadas).
  • Data: escolha uma data específica ou use "Ver todas as futuras" para listar as reservas a partir da data selecionada.

Cada reserva mostra o espaço, o turno, a data e o usuário. É possível abrir os "Detalhes" de cada uma. A lista é atualizada periodicamente.

Aprovar e negar​

Para reservas com status Solicitadas, aparecem os botões:

  • "Aprovar" — muda o status para Confirmada.
  • "Negar" — muda o status para Negada.
Aceite de termos

Administradores e gerentes de biometria (bem como usuários marcados como staff de reservas) não precisam passar pelo aceite de termos ao criar/gerenciar reservas.

Regras aplicadas pelo backend​

Ao criar/confirmar uma reserva, o backend valida uma série de regras. As principais:

  • Aluguel interno: espaços marcados como somente aluguel interno (only_internal_rent) só podem ser reservados por BIOMETRY_MANAGER ou ADMINISTRATOR.
  • Tipo de acesso: o usuário precisa possuir todos os tipos de acesso exigidos pela categoria do espaço.
  • Inadimplência: o usuário pode ter no máximo 1 documento financeiro em atraso (2 ou mais bloqueiam a reserva).
  • Turno reservável: o turno precisa estar disponível para reserva na data (is_bookable) — usuários com privilégios (staff de reservas, Administrador, Gerente de Biometria) podem contornar essa regra.
  • Coerência do turno: o turno deve pertencer ao espaço selecionado e os horários de início/fim não podem sobrepor outros turnos.
  • Duplicidade: não é permitido ao usuário ter outra reserva equivalente já solicitada/confirmada para o mesmo espaço e turno.

Regras adicionais podem se aplicar conforme a configuração da categoria do espaço (por exemplo, uma única reserva por dia, ou bloqueio de turnos sequenciais).

Restrições de acesso​

  • Rota "/physical-space-reservations" liberada para os perfis BIOMETRY_MANAGER, MANAGER e ADMINISTRATOR, com permissão completa sobre PhysicalSpaceReservation.

Veja também Restrições de acesso e permissões.