Calendario de Reservas
O Calendario de Reservas oferece uma visao grafica de todas as reservas da propriedade, distribuidas no tempo. Em vez de percorrer uma lista de linhas, voce enxerga blocos coloridos que representam estadias — facilitando a identificacao de disponibilidade, conflitos e gaps operacionais em segundos.
Esta pagina cobre os tres modos de visualizacao do modulo de reservas, com foco no calendario e no mapa (timeline por unidade).
Tres Modos de Visualizacao
O modulo de reservas permite alternar entre tres formas de ver os mesmos dados. Cada uma e otimizada para um cenario diferente:
| Modo | Acesso | Melhor para |
|---|---|---|
| Tabela | Icone de lista no canto superior direito | Buscas rapidas, filtragem avancada, operacoes em massa |
| Calendario | Icone de calendario no canto superior direito | Visao temporal por mes, semana ou dia — identificar gaps e picos de ocupacao |
| Mapa (Timeline) | Icone de mapa/planta no canto superior direito | Visao por unidade — ver quem esta em cada quarto e quando ha vagas |
Dica: O modo selecionado e persistido na sessao. Ao voltar para a pagina de reservas, voce retorna ao ultimo modo utilizado.
Calendario — Visao Detalhada
O calendario utiliza a biblioteca FullCalendar e oferece tres niveis de zoom temporal, acessiveis pelos botoes no cabecalho:
Niveis de Visualizacao
| Nivel | O que mostra | Quando usar |
|---|---|---|
| Mes | Grade mensal com blocos de reserva em cada celula de dia | Planejamento de ocupacao, identificar temporadas fracas, visao estrategica |
| Semana | Grade semanal com horarios detalhados | Gerenciar chegadas e saidas da semana, planejar turnos da equipe |
| Dia | Todas as reservas do dia com detalhes expandidos | Operacao do dia, conferir check-ins e check-outs previstos |
Navegacao
- Setas esquerda/direita — avancam ou retrocedem um periodo (mes, semana ou dia, conforme o nivel ativo)
- Botao “Hoje” — retorna imediatamente para a data atual
- Botoes Mes / Semana / Dia — alternam entre os niveis de zoom
Codigo de Cores por Status
Cada bloco de reserva no calendario recebe uma cor de fundo que indica o status atual. Isso permite identificar visualmente a situacao de toda a operacao com um unico olhar.
| Status | Cor | Codigo Hex | Significado |
|---|---|---|---|
| Confirmada | Verde | #10b981 | Reserva garantida, aguardando chegada do hospede |
| Em Estadia (Check-in) | Azul | #3b82f6 | Hospede ja realizou check-in e esta no estabelecimento |
| Pendente | Laranja | #f59e0b | Reserva criada mas ainda nao confirmada (aguardando pagamento ou aprovacao) |
| Cancelada | Vermelho | #ef4444 | Reserva foi cancelada — a unidade esta liberada |
| Check-out | Roxo | #8b5cf6 | Hospede ja saiu, aguardando finalizacao financeira |
| No-show | Cinza | #9ca3af | Hospede nao compareceu na data prevista |
Importante: As reservas canceladas aparecem no calendario por padrao para manter o historico visual. Voce pode oculta-las usando o filtro de status.
Informacoes Exibidas em Cada Bloco
Cada bloco de reserva no calendario exibe:
- Nome do hospede — nome completo do hospede principal
- Identificacao da unidade — numero ou nome do quarto/cama atribuido
Na visao mensal, cada celula de dia exibe no maximo 3 reservas. Se houver mais, um indicador “+N mais” aparece — clique nele para expandir e ver todas as reservas daquele dia.
Dialog de Detalhes
Ao clicar em qualquer bloco de reserva no calendario, um dialog (painel modal) abre com as informacoes completas:
| Campo | Descricao |
|---|---|
| Hospede | Nome completo do hospede principal |
| Status | Badge colorido com o estado atual da reserva |
| Unidade | Quarto ou cama atribuido |
| Valor total | Preco total da estadia (formatado em moeda) |
| Data de entrada | Data e horario previstos para o check-in |
| Data de saida | Data e horario previstos para o check-out |
A partir desse dialog voce pode acessar a pagina completa da reserva ou executar acoes rapidas (check-in, check-out, cancelar), conforme as permissoes do seu papel.
Mapa (Timeline por Unidade)
O modo Mapa apresenta uma visao de timeline horizontal onde cada linha representa uma unidade da propriedade e os blocos de reserva se estendem ao longo do eixo temporal.
Componente ReservationBar
Cada barra de reserva na timeline exibe:
| Elemento | Descricao |
|---|---|
| Nome do hospede | Nome abreviado para familias (ex: “Fam. Silva”) e nome completo para reservas individuais |
| Avatares | Quando ha multiplos hospedes, icones de avatar aparecem empilhados |
| Valor | Valor total da reserva exibido diretamente na barra |
| Icone de status | Checkmark (✓) para confirmadas, triangulo de alerta (⚠) para pendentes |
| Cor de fundo | Segue o mesmo codigo de cores por status descrito acima |
Quando Usar o Mapa
O modo Mapa e ideal para:
- Verificar disponibilidade por unidade — ver exatamente quais quartos estao livres em quais datas
- Identificar gaps entre reservas — espacos vazios entre blocos indicam noites sem ocupacao
- Planejar realocacao — quando um hospede precisa mudar de quarto, a timeline mostra claramente as opcoes
- Visao de planta — entender a ocupacao espacial da propriedade
Quando Usar Cada Visualizacao
| Cenario | Modo Recomendado | Por que |
|---|---|---|
| Conferir check-ins e check-outs do dia | Calendario (Dia) | Mostra todas as movimentacoes previstas com horarios |
| Planejar a ocupacao da semana | Calendario (Semana) | Equilibrio entre detalhe e amplitude temporal |
| Analisar taxa de ocupacao do mes | Calendario (Mes) | Visao panoramica de picos e vales |
| Encontrar quartos disponiveis para nova reserva | Mapa (Timeline) | Mostra gaps por unidade de forma imediata |
| Buscar uma reserva especifica por nome | Tabela | Filtragem por texto e ordenacao por colunas |
| Operar check-ins e check-outs em massa | Tabela | Selecao multipla e acoes em lote |
| Resolver conflito de quarto (overbooking) | Mapa (Timeline) | Visualiza sobreposicoes e alternativas |
| Gerar relatorio de reservas por periodo | Tabela | Exportacao de dados em formato tabular |
Dicas para Operacoes Diarias
-
Comece o turno no modo Dia — veja rapidamente quantas chegadas e saidas estao previstas. Os blocos verdes (confirmadas) sao as proximas a fazer check-in.
-
Use o filtro de status — oculte reservas canceladas e no-shows para focar apenas nas ativas. O calendario fica mais limpo e facil de ler.
-
Alterne para o Mapa ao realocar hospedes — se um quarto precisa entrar em manutencao, a timeline mostra rapidamente quais unidades estao disponiveis para transferencia.
-
Verifique o mes seguinte regularmente — alterne para a visao Mes e avance um mes. Identifique periodos de baixa ocupacao para acoes comerciais (promocoes, tarifas especiais).
-
Clique nos blocos, nao busque na lista — o dialog de detalhes do calendario da acesso rapido as informacoes e acoes sem precisar sair da visao grafica.
-
Atencao ao laranja — blocos laranjas (pendentes) precisam de atencao. Sao reservas que ainda nao foram confirmadas e podem virar cancelamento se nao forem tratadas.
-
“+N mais” merece atencao — se uma celula de dia mostra muitas reservas empilhadas, e sinal de alta ocupacao. Clique para expandir e certifique-se de que nao ha conflitos.
Proximos Passos
- Criar Reserva — registre uma nova reserva diretamente pelo calendario
- Check-in — inicie o check-in a partir do dialog de detalhes
- Check-out — finalize estadias com o fluxo de check-out
- No-show e Cancelamento — gerencie ausencias e cancelamentos
- Grupos de Reservas — trabalhe com reservas de grupo no calendario
- Visao Geral de Reservas — volte para a documentacao completa do modulo