Fretamento - Agenda da Frota

O que é

A Agenda da Frota é a visualização em linha do tempo (estilo Gantt) da sua frota própria: cada linha é um veículo ativo, cada coluna é um dia, e os blocos coloridos mostram o que está ocupando aquele veículo naquele período. Ao contrário da listagem em tabela, aqui você enxerga de uma vez só a ocupação de todos os veículos lado a lado, o que facilita decidir qual veículo está livre para um novo serviço ou identificar rapidamente onde há sobreposição de datas.

Você normalmente chega nesta tela ao alternar para Agenda a partir da listagem de Fretamentos, ou direto pela sidebar em Fretamento > Fretamentos seguido do toggle de visualização. É o ponto de partida para montar a escala da semana ou do mês, realocar um fretamento de veículo por arrastar e soltar, e cruzar visualmente fretamentos com as excursões próprias que também usam a frota.

Como usar

1. Vá em Fretamento > Fretamentos no sidebar e clique em Agenda, no grupo de três botões no canto superior direito (ao lado de Lista e Mês).
2. Escolha o tamanho da janela de visualização em 7 dias, 15 dias, 30 dias, 60 dias ou 90 dias, no grupo de botões à direita da barra de navegação.
3. Use as setas para avançar ou voltar um período inteiro, ou clique em Hoje para voltar direto ao período que começa no dia atual. A quantidade de dias escolhida é preservada ao navegar.
4. Cada linha traz o modelo, a placa e a capacidade do veículo, na coluna fixa à esquerda. Ao lado, os blocos mostram os serviços que ocupam aquele veículo no período.
5. Clique em qualquer célula vazia de uma linha para abrir o formulário de novo fretamento já com aquele veículo e aquela data preenchidos.
6. Clique em um bloco (fretamento ou excursão) para abrir a janela de detalhe rápido, com período, veículo, rota ou destino, passageiros e valores. O botão Ver fretamento ou Ver excursão leva para a ficha completa.
7. Para trocar um fretamento de veículo, arraste o bloco para a linha do veículo desejado e solte. A página recarrega em seguida com o veículo atualizado.
8. Para cadastrar um fretamento novo sem clicar numa célula específica, use o botão Novo fretamento (botão flutuante laranja, canto superior direito).

O que você precisa saber antes

• A agenda só mostra veículos da frota própria, ativos. Veículos marcados como inativos ou pertencentes a transportadoras terceirizadas nunca aparecem aqui, mesmo que tenham fretamentos vinculados. Para ver esses fretamentos, use a visualização Lista.
• Excursões só entram na agenda se usarem um veículo da sua frota própria. Uma excursão que contratou ônibus de terceiro não aparece nesta tela, mesmo que esteja acontecendo no mesmo período.
• Arrastar e soltar um bloco muda de fato o veículo do fretamento no banco, na hora, mesmo que isso gere conflito de agenda. O sistema avisa com um toast amarelo "Veículo realocado, mas há conflito de agenda nas datas", mas não bloqueia a troca. Cabe a você olhar o aviso e corrigir se for o caso.
• Fretamentos concluídos ou cancelados não podem ser realocados por arrastar e soltar; a tentativa retorna erro e nada muda.
• Só fretamentos podem ser arrastados. Blocos roxos de excursão são fixos na agenda: para trocar o veículo de uma excursão, é preciso ir até a ficha da excursão, na aba Logística.
• Conflito de agenda é calculado sobre as datas reais do serviço, não sobre o que aparece recortado na tela. Dois serviços conflitam quando o início de um acontece antes ou no mesmo dia do fim do outro, e vice-versa, no mesmo veículo.
• A barrinha laranja no topo de um dia indica que o veículo tem um contrato mensal recorrente ativo naquele dia da semana. Ela é só um aviso: você ainda consegue criar um fretamento eventual para o mesmo dia, mas a agenda vai contar isso como conflito.
• O círculo com a chave inglesa avisa manutenção planejada (fica vermelho quando está atrasada), mas não bloqueia o veículo nem impede criar um fretamento naquele dia.
• Esta tela não tem filtro de status ou de veículo específico: ela sempre mostra todos os veículos ativos e todos os fretamentos não cancelados do período. Para filtrar, use a visualização Lista.

Casos especiais

Nenhum veículo cadastrado

Se a frota própria estiver vazia, a linha do tempo é substituída por um aviso "Nenhum veículo cadastrado" com o botão Cadastrar veículo, que leva ao formulário de cadastro de veículo.

Período muito largo (60 ou 90 dias)

Com janelas maiores, a linha do tempo fica larga e pede rolagem horizontal. O cabeçalho de dias e a coluna de veículos permanecem fixos na tela enquanto você rola, para você não perder a referência de qual veículo está vendo.

Vários serviços sobrepostos no mesmo veículo

Quando mais de um fretamento ou excursão ocupa o mesmo veículo em datas que se cruzam, os blocos são empilhados em "raias" dentro da própria linha, sem se sobrepor visualmente, e a linha inteira ganha fundo avermelhado com o aviso "conflito" ao lado da placa.

Erros comuns e como resolver

• "Não foi possível realocar." (toast vermelho ao soltar um bloco) - Causa: falha de rede ou de sessão durante a troca de veículo. Solução: recarregue a página e tente arrastar novamente.
• "Fretamentos concluídos ou cancelados não podem ser realocados." - Causa: você tentou arrastar um bloco cujo fretamento já está com status Concluído ou Cancelado. Solução: se precisar mudar o veículo, edite o fretamento diretamente pela ficha (isso só é possível quando o status permitir).
• "Veículo realocado, mas há conflito de agenda nas datas." (toast amarelo) - Não é bem um erro: a troca foi feita, mas o novo veículo já tem outro serviço sobreposto ao período. Solução: verifique a linha do veículo na agenda e resolva movendo um dos dois serviços.

Onde encontrar

• URL: /admin/fretamento/calendario
• Caminho no menu: Fretamento > Fretamentos, depois o botão Agenda no cabeçalho da listagem
• Permissão necessária: ver os fretamentos (e criar fretamentos para usar as células vazias e o botão Novo fretamento)
• Módulo necessário: Fretamento

Veja também

Ainda não há outros artigos publicados no módulo Fretamento. A visualização em Lista e a visualização em Mês, acessíveis pelo mesmo grupo de botões desta tela, ainda não têm artigo próprio.