Simulador de Cenários de Roteirização - Fretado & Mobilidade

📘 Manual de Instruções — Roteirizador Multiciclos

1) Objetivo

O roteirizador cria rotas otimizadas para ida e volta entre residências dos colaboradores e o depósito (operação), respeitando capacidade do modal, janelas de horário e regras de multi ciclo com encaixe de modais.

2) Bases necessárias

• Pessoas (CSV/Excel): deve conter latitude, longitude e preferencialmente nome. Colunas típicas (não obrigatório usar os mesmos nomes): Nome, Latitude, Longitude, Tipo (FIXO | PART TIME), Ciclo (AM1 | AM2/PM | SD).
• Operações (CSV/Excel): deve conter latitude, longitude e Código Operação. A coluna do código é detectada automaticamente ou selecionável.

3) Parâmetros principais

• Tipo de operação: somente ida (coleta → depósito) ou ida e volta (depósito ↔ casas).
• Velocidade média fallback: usada apenas quando o motor de vias reais não estiver disponível.
• Máx. horas por roteiro (ida e volta): o sistema divide rotas se a soma operacional ida + volta exceder este limite.
• Tempo máximo por colaborador em rota (ida ou volta): limite individual por trecho. O sistema quebra/reotimiza rotas para evitar que uma pessoa ultrapasse o tempo configurado na ida ou na volta.
• Catálogo de veículos: capacidade (lugares), custo fixo mensal (base) e custo por km (R$).

4) Multi ciclo & encaixe

• Habilite multi ciclo para combinar AM1, AM2/PM e SD quando houver encaixe.
• Regra do encaixe: a entrada do ciclo posterior deve ser 30 min antes da saída do ciclo anterior (AM1→PM, PM→SD, AM1→SD).
• Quando o encaixe existir, os campos de saída do ciclo anterior e entrada do ciclo posterior ficam com fundo verde.
• Sem horário (entrada/saída = 00:00) ⇒ colaborador não é roteirizado.
• PART TIME com horário diferente do FIXO em qualquer ciclo ⇒ cria rotas exclusivas para PART TIME nesse ciclo.

5) Cálculo de custo (resumo)

Por rota, escolhe-se o modal com menor custo final respeitando a capacidade.

• Variável: custo_por_km × km_dia × dias_úteis
• Fixo (padrão): não há rateio do custo fixo entre ciclos.
• Com encaixe: o mesmo veículo pode ser reaproveitado no ciclo seguinte mesmo que o modal originalmente dimensionado para a rota seguinte fosse menor. O pareamento exige motor OSRM ativo, capacidade suficiente do veículo anterior e proximidade/tempo operacional compatível entre o fim da rota anterior e o início da próxima. A rota pareada não recebe novo custo fixo.
• Sem encaixe: cada ciclo precisa de sua própria frota: variável + (fixo_modal × quantidade_de_ciclos). Para dois ciclos, equivale a fixo_modal × 2.
• Excedente de frota: rotas sem pareamento real recebem novo custo fixo. O sistema não usa mais zeragem global por número de rota.
• Preço final: aplica margem (%) e impostos (%).

6) Lógica de tempo por pessoa

• Ida: a coleta começa pelo colaborador mais distante da operação e termina no colaborador mais próximo, reduzindo o tempo embarcado de quem mora mais perto.
• Volta: a entrega começa pelo colaborador mais próximo da operação e segue até o mais distante.
• Relato: no gráfico Top 10, ao clicar em uma barra, a pessoa é destacada nos mapas, e o tooltip mostra o tempo específico do mapa: ida no mapa de ida e volta no mapa de volta.

7) Pontos de encontro (opcional)

• Informe raios (m) para ida e/ou volta. O sistema busca um ponto que cubra o maior número de pessoas e reencaminha as coordenadas dos cobertos para este ponto.
• Comparativo COM × SEM ponto de encontro é mostrado com km, tempo e custo.

8) Exportação

Clique em Exportar Excel para salvar os indicadores principais do cenário atual, incluindo a aba Encaixes_Detalhados com as rotas que tiveram reaproveitamento real de veículo e a aba Troca_Operacao com a auditoria AS IS x TO BE da operação de destino.

🛈 Caso deseje consultar as Lat e Lon no Google Maps, basta copiá-las da planilha e colá-las no campo de busca.

9) Boas práticas

• Garanta coordenadas válidas nas bases (latitude/longitude).
• Use a seleção múltipla de operações quando fizer sentido (e o recurso de reatribuição para depósito mais próximo, se habilitado).
• Use o Motor de distância/tempo em “Vias reais — OSRM/OpenStreetMap” para calcular distâncias pela malha viária real. O modo considera ruas, avenidas, estradas, sentidos de via e velocidades médias estimadas do grafo OSM.
• Para operação oficial em escala, use endpoint OSRM interno/contratado. O endpoint público é adequado para protótipo, mas pode ter limite, latência ou bloqueio corporativo.
• Revise a velocidade média apenas como fallback, quando o roteamento por vias reais não estiver disponível.