Calendário - Visão Consolidada

O que é

O Calendário é uma agenda única que reúne, em um só lugar, todos os compromissos com data que circulam pela operação: excursões publicadas, embarques, contas a pagar, aniversários de clientes, tarefas de CRM, jornadas (quando você opera nesse modo) e eventos pessoais que o usuário cadastra à mão. Cada origem é tratada como um feed independente, com cor própria e botão de liga/desliga, para que cada usuário monte a visão que faz sentido para o seu papel.

O usuário costuma chegar aqui no início do dia ou da semana para planejar o que vai fazer: checar quais viagens estão próximas, ver os aniversários do mês para acionar campanhas relacionais, conferir contas a pagar antes do vencimento e bloquear horários para reuniões internas. O calendário também é o atalho preferido quando alguém pergunta "que dia eu tenho isso?" sem precisar abrir cada módulo separadamente.

Como usar

1. Vá em Calendário no menu lateral. A tela abre direto na visualização padrão definida nas configurações (mês, semana, dia ou agenda).
2. Para escolher o que aparece na agenda, clique em Mostrar (botão branco com ícone de olho, ao lado do botão Novo evento). O número dentro do balão azul mostra quantos feeds estão ligados naquele momento.
3. No painel que abre, marque ou desmarque cada feed na lista. Use Ligar todos ou Desligar no topo do painel para acionar todos de uma vez. Quando houver alterações, confirme em Salvar (ou descarte em Cancelar); fechar o painel clicando fora também salva automaticamente.
4. Para criar um evento próprio, clique em Novo evento (botão azul à esquerda da toolbar) ou no botão flutuante verde no canto inferior direito quando estiver no celular. Preencha:
   • Adicionar título - campo grande no topo do modal (obrigatório).
   • Data e hora - uma data, hora de início e hora de fim. Marque Dia inteiro para ocultar os horários.
   • Tipo - botões coloridos logo abaixo. A cor escolhida pinta o evento na agenda.
   • Vínculos - botões com ícone de "+" para anexar Cliente, Excursão ou Reserva ao evento. Use o campo de busca que aparece para localizar o registro.
   • Adicionar local e Adicionar descrição - opcionais.
5. Conclua em Salvar. O evento aparece imediatamente na grade com a cor escolhida.
6. Para abrir um item já existente, clique sobre ele na grade. Eventos automáticos (excursões, contas a pagar, aniversários, tarefas) abrem um preview com os dados principais e um botão Abrir página que leva ao registro de origem. Eventos próprios abrem o modal de edição com os botões Excluir, Cancelar e Salvar no rodapé.
7. Para ajustar como o calendário se comporta, clique na engrenagem no canto direito da toolbar para abrir Configurações do calendário (ver "Casos especiais" abaixo).

Casos especiais

Ajustar a visualização padrão e o horário comercial

No modal Configurações do calendário (engrenagem na toolbar) a aba Geral permite escolher a Visualização padrão (Mês, Semana, Dia ou Agenda), o Início da semana (Domingo ou Segunda-feira) e marcar Mostrar fins de semana. Em Padrões para eventos próprios é possível definir a Duração padrão (minutos) dos novos eventos, a Visibilidade padrão (Privado, Time ou Todos da sua empresa) e o Horário comercial · início e Horário comercial · fim, que destacam visualmente o expediente nas visões de semana e dia. Confirme em Salvar no rodapé do modal.

Configurar feeds específicos

Ainda no modal de configurações, a seção Configurações por feed traz ajustes finos:

• Aniversários · apenas clientes ativos - quando ligado, oculta aniversários de clientes inativos.
• Contas a pagar · alertar com X dias de antecedência - a conta aparece na agenda esse número de dias antes do vencimento (use 0 para mostrar só no dia).

Vincular um evento próprio a cliente, excursão ou reserva

No modal de evento, a linha Vínculos (ícone de elo) mostra os tipos disponíveis para o usuário, conforme as permissões dele (ver os clientes, ver as viagens, ver as reservas). Clique no tipo desejado, digite no campo de busca e selecione o registro. O vínculo aparece como uma "tag" azul; para remover, clique no "x" ao lado do nome. Vínculos servem para documentar o motivo do evento e abrir o registro direto a partir da agenda.

Janela máxima de consulta

A grade carrega eventos sob demanda à medida que o usuário muda de mês ou de visualização. A janela única não pode passar de 90 dias - visões maiores que isso retornam o aviso "Intervalo máximo de consulta é 90 dias.". Use a navegação mês a mês em vez de tentar visualizar um intervalo muito longo.

Edição limitada a eventos próprios

Apenas o usuário que criou um evento próprio consegue editá-lo ou excluí-lo. Eventos vindos de feeds automáticos (excursões, contas, aniversários, tarefas) não são editáveis pela agenda - o calendário apenas reflete o que está cadastrado no módulo de origem.

Erros comuns e como resolver

• "Intervalo máximo de consulta é 90 dias." - Causa: a visualização escolhida cobre mais de 90 dias seguidos. Solução: troque para visão Mês, Semana ou Dia e navegue manualmente pelos meses.
• Página retorna "404" ao tentar abrir o Calendário - Causa: a sua empresa está com calendario_ativo desligado. Solução: ative o módulo em Configurações > Empresa ou peça para o Proprietário ativar.
• Página retorna "403" - Causa: o usuário não tem a permissão calendario.view. Solução: peça ao Proprietário/Gerente para conceder a permissão no perfil do usuário.
• Um feed esperado não aparece no botão Mostrar - Causa: o feed exige um módulo não contratado ou uma permissão que o usuário não tem (por exemplo, CRM ou Gestão Financeira); pode também estar oculto porque você opera em um modo diferente (excursões vs jornadas). Solução: revise os módulos ativos, as permissões do perfil e o modo de operação da sua empresa.
• "Módulo não habilitado." / "Sem permissão." ao tentar vincular cliente, excursão ou reserva no modal de evento - Causa: o usuário tenta usar um tipo de vínculo para o qual não tem permissão ou cujo módulo está inativo. Solução: peça liberação ou escolha um tipo de vínculo permitido.

Onde encontrar

• URL: /admin/calendario
• Caminho no menu: Calendário (item de topo na barra lateral)
• Permissão necessária: calendario.view
• Pré-requisito da sua empresa: módulo Calendário ativo em Configurações > Empresa
• Módulo necessário: nenhum (alguns feeds individuais podem exigir módulos como CRM, Gestão Financeira ou Ingressos)

Veja também

• Visão Geral do Dashboard
• Visão Geral das Excursões