Carregando programação técnica…
—

📋 Grade completa

Todos os técnicos do filtro · consulta e ajuste fino por período (arraste para mover) · 🔧 executado em campo
—
BACKLOG 0 0
Arraste um item para um período da grade para programá-lo.
O que aparece no mapa
—

🗺️ Mapa da regional

Onde está cada técnico e onde a frota está pedindo visita · posição Ituran, atualiza a cada 2 minutos
ONDE ESTÁ CADA TÉCNICO0
—

📥 Central de atendimentos

Tudo que existe — backlog, programado, concluído, cancelado — de qualquer semana. Clique numa linha para abrir.
AtendimentoTipoClienteMáquinaFilialTécnicoDataStatusOrigem
Campanha atinge um conjunto de máquinas (recall, atualização, inspeção de lote). Ela não vai para o backlog: ao ativar, as séries entram no grupo 📢 Campanhas da fila O que programar, na 🧩 Semana, igual às revisões PMP — junte com a revisão quando a máquina também tem uma pendente (mesma visita, um clique). O atendimento só nasce quando você ancora e programa.

📢 Campanhas de campo

Recall, atualização ou inspeção de lote — as séries entram no grupo 📢 Campanhas da fila da 🧩 Semana
A classificação (A/B/C/Ajudante) e as habilitações geram alertas na programação — nunca bloqueiam. O telefone é usado no envio manual da agenda por WhatsApp.

👷 Técnicos

Classificação, habilitações e veículo alimentam os alertas da programação — nada bloqueia, tudo avisa
TécnicoFilialClasseTelefonePlaca 📡VeículoHabilitaçõesAtivo
⚙️ Configuração

Tipos de atendimento

Tipo é dado, não código: cor, duração padrão e regras vivem aqui — indisponibilidades (folga, férias…) também são tipos. Clique numa linha para editar.
TipoDuração padrãoEspecialidade mín.Campo (desloc.)Indisponib.Exige máquinaExige clienteAtivo

📅 Dias da semana

Quais dias aparecem na grade e quais são de trabalho normal.

Os outros dias aparecem sombreados: só programação manual.
Como isso funciona
Define quais colunas aparecem na programação. Sábado e domingo podem ficar visíveis para encaixe manual.

🎯 Motor — o que é urgente

Quando uma revisão vira candidata e em que ordem ela aparece.

Padrão Komatsu: ±100h. Dentro dela a revisão está "na janela".
Leitura mais velha que isso vira "⏳ pedir leitura".
Como o motor decide
Quem vira candidata: máquina com horímetro, posição e contrato, cujo próximo marco (de 500 em 500h a partir da última revisão registrada) esteja vencido, dentro da tolerância, ou que entre na tolerância em até 7 dias pela média de h/dia dela (carona).
O ➕ de um período olha primeiro o que já está na grade: serviço no mesmo dia → oferece quem está no raio dele; dia vazio mas semana com região aberta → oferece quem está no raio dessa região; nada aberto → sai da filial, por urgência + custo de estrada.
Mesmo cliente (mesmo CNPJ) fura o raio. Backlog com localização entra na mesma régua, no grupo 🚗 Aproveitar a viagem.
A lógica completa está em _DOCS/prog-tecnica-motor-logica.md.

🛣️ Motor — estrada

Quanto a distância pesa, e quanto cabe num dia de campo.

O que entra junto no mesmo dia.
Horas de horímetro que valem 1h de viagem. 0 = só urgência.
—
Como a estrada entra na conta
O motor usa rota real de estrada (km e minutos) — da filial até a máquina e, desde 19/09, também do serviço já ancorado até a candidata. A linha reta ficou só como pré-filtro.
O tempo de ida+volta é descontado da jornada: revisão de 500h ocupa 3h, de marco cheio (1.000, 2.000…) ocupa 6h. Se a estrada come o resto do dia, a sugestão ganha o selo 🚗.
Peso da estrada: com 40, uma máquina 5× mais perto e 100h menos vencida passa na frente. Abaixo de ~28 a distância quase não muda a ordem.
🛣️ Chave de rotas: gratuita em openrouteservice.org, cadastrada no Cloudflare Pages → Settings → Environment variables como ORS_API_KEY (secret). O resultado fica em cache por 30 dias. Sem a chave, tudo funciona em linha reta ×1,3.

🌙 Pernoite

Quando vale ficar na região em vez de voltar todo dia.

0 = nunca pernoitar por acúmulo.
Como isso funciona
Além da viagem que não cabe na jornada, o módulo propõe ficar na região quando há trabalho para vários dias ali e a ida é longa — voltar para casa todo dia pagaria a estrada N vezes. O gatilho é: ida de pelo menos X horas e trabalho para pelo menos 2 dias ali.

🔧 Relatórios do Namoa

O que conta como revisão executada em campo.

Separe por ";".
Como isso funciona
O relatório de campo só confirma a revisão se o nome do formulário contiver um destes termos (separe por ";"). Hoje só ~32% dos relatórios são preventivas — o resto é corretiva, diagnóstico, inspeção, garantia, entrega técnica. Sem esse filtro, qualquer visita à máquina seria lida como revisão feita.
O mecânico nem sempre preenche o relatório no mesmo dia. O sistema procura de 1 dia antes até N dias depois da data programada, e mostra a defasagem.

📬 Avisos por e-mail

Quem recebe é configurado em cada tipo de atendimento.

Enquanto estiver ligado, nenhum aviso chega ao vendedor ou às caixas de área: o e-mail vem para você com a lista de quem receberia. Desligue só depois de conferir o conteúdo.
Como isso funciona
Quem recebe é configurado por tipo de atendimento (Tipos → editar → "Quem é avisado") — a entrega técnica avisa o vendedor, a garantia avisa quem responde por ela. Sem evento marcado, o tipo não manda nada.
O e-mail sai da sua conta, então quem receber responde para você. Nada é enviado sozinho: só quando alguém programa, conclui, cancela ou marca não realizado na tela.
⚠️ Evite marcar "foi programado" em tipos de alto volume (a revisão de PMP entra às dezenas).

🚗 Estrada e pernoite

Quando o Hub pergunta "bate-volta ou pernoite" ao programar serviço distante, e com que horários ele calcula.

Ida menor que isso: a estrada é só parte do dia, sem pergunta. Padrão 1,5.
Soma ao tempo da rota (trânsito, estrada de terra, portaria). Padrão 0 — ajuste com os relatórios do Namoa.
Horas decimais: 8 = 08:00 · 13,5 = 13:30 · 18 = 18:00. Se a volta passa do fim da jornada + esta tolerância, o Hub recomenda pernoite.

Prazo-alvo por tipo de atendimento

Entrega técnica: até quantas horas de operação da máquina. Preparação: dias úteis após o faturamento. Demais tipos: dias corridos da criação (vazio = sem prazo). A fila mostra quanto falta para estourar e passa o estourado na frente.

📎 Mensagem ao técnico (WhatsApp)

Texto da aba 📎 Técnico do atendimento. A descrição, o local, o contato e os links entram sozinhos.

A mensagem começa com "Olá {primeiro nome}!" e esta frase.
Vai no fim de toda mensagem.

🤝 Confirmação do cliente

A faixa colorida nos blocos e a barra "X de Y confirmados".

Liga a faixa colorida nos blocos e a barra "X de Y confirmados". Desligue se não quiser essa cobrança na tela.
Padrão 1: na véspera, quem não respondeu fica laranja ⏰. Não altera nada gravado — é só o alerta na tela, e some sozinho se você remarcar.
Campos que o sistema troca sozinho: {contato} {cliente} {tipo} {maquina} {data} {periodo} {tecnico}.
Como isso funciona
Fase A — envio manual. O botão 🤝 monta a mensagem e abre o WhatsApp no seu celular/desktop; o bloco fica aguardando resposta. Quando o cliente responder, marque 👍 ou 🚫 no atendimento. Nada é enviado automaticamente e nenhum atendimento cai sozinho.
Telefone do cliente: a aba 🤝 Cliente do atendimento lista os contatos do cadastro do CRM, os usados em atendimentos anteriores e o telefone do Linx. Contato novo é gravado no CRM e reaproveitado nos próximos.
Mudou o dia, caiu a confirmação: arrastar ou reprogramar um atendimento já confirmado zera o status (com aviso), porque o cliente confirmou aquela data. O evento fica na linha do tempo.
—
Buscar de novo
Semana
Ir para

Monte uma raia por vez — clique para abrir a de qualquer técnico

—
—
Clique no ➕ de um período: a Programação inteligente sugere quem entra ali.
📍 Rota da semana Confirmado Aguardando cliente

📋 O que programar

—
—