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.
Rotina de portaria/gestão, liberada para os perfis Gerente de Biometria, Gerente e Administrador.
Onde gerenciar
A gestão é feita na página Reservas de espaço (rota /physical-space-reservations), acessível pelo item de menu "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.
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 só podem ser reservados pelos perfis Gerente de Biometria ou Administrador.
- 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 — 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).
Quem pode acessar
A página Reservas de espaço é liberada para os perfis Gerente de Biometria, Gerente e Administrador.