Da guarita ao portão em 3h41, contra 8h01 no processo manual
O desafio era o tempo de permanência do motorista dentro da unidade. O caminhão chegava sem hora marcada, esperava a conferência de documento na guarita, entrava numa fila sem ordem declarada e percorria pesagem, coleta de amostra, descarga ou carregamento e emissão de nota com cada área sendo acionada por telefone.
Permanência média
3h41
contra 8h01 da linha de base manual
Redução
54%
4h19 economizadas por caminhão
Capacidade adicional
+6
caminhões por dia, mesma estrutura
Horas de pátio liberadas
1.344
somadas no período analisado
Visitas finalizadas
311
no período consultado
Permanência P50 / P90
3h35 / 4h47
metade e nove em cada dez sairam em menos
Automação documental
86%
resolvidos por leitura e regras, sem toque humano
Aderência ao agendamento
80%
chegaram dentro da janela combinada
Leitura de 12/08/2026, janela de 30 dias, sobre a operação de demonstração da unidade da Bahia. Os números da aplicação continuam se movendo — veja como cada um é calculado.
Escopo
Cada hipótese virou código executável
O desafio trazia seis hipóteses. Nenhuma ficou como intenção: todas têm uma tela ou um endpoint que você consegue exercitar agora.
| Hipótese | O que existe rodando |
|---|---|
| Pré-cadastro digital | Portal da transportadora com cadastro de empresa, motorista e veículo, e um semáforo de aptidão que diz se aquele conjunto pode entrar na planta. |
| Validação por OCR | Porta de OCR com dois provedores, um determinístico e um modelo de visão, e um motor de quatorze regras que decide entre aprovar sozinho, mandar para conferência humana ou reprovar com motivo legível em português. |
| Agendamento inteligente | Sugestão de janelas em blocos de trinta minutos, respeitando expediente e capacidade real por recurso — balança, docas, amostragem — com o score da escolha explicado. |
| Orquestração com SLA | Máquina de estados da visita, roteiro por sentido de operação, SLA por etapa e travas de negócio: não fecha pesagem sem peso, não libera análise sem laudo. |
| Monitoramento em tempo real | Torre de controle por eventos enviados pelo servidor, fila do pátio priorizada, ocupação de recursos e um aplicativo do motorista com previsão de saída. |
| Integração com balança e ERP | Endpoint de leitura da balança que deduz a qual visita e a qual pesagem o peso pertence, e caixa de saída com a mensagem exata que o ERP receberia. |
Metodologia
Como cada número é calculado
Esta seção existe porque um indicador sem memória de cálculo não serve para decidir investimento.
Permanência
A visita registra o instante do check-in e o instante em que a última etapa do roteiro é concluída. A permanência é a diferença entre os dois, em minutos. Nada é estimado, nada e arredondado para cima.
Duração por etapa
Cada etapa conta desde o momento em que a anterior terminou, e não desde o clique em iniciar. Isso garante que a soma das etapas cubra integralmente a permanência, sem intervalos órfãos: o tempo em que o caminhão ficou parado esperando alguém chamar aparece na etapa em que ele esperou. E justamente esse o desperdício que a prova de conceito precisa expor.
Linha de base
A comparação usa os tempos do processo manual descrito no desafio: 487 minutos para uma descarga e 474 para um carregamento. O total não é uma média fixa — é ponderado pelo mix real de operações de entrada e saída do período consultado.
Capacidade adicional
Quantos caminhões a mais cabem por dia sem obra:
posições × horas × 60 × (1/permanência_atual − 1/permanência_base),
nunca negativa. A prova de conceito assume três posições de atendimento e
catorze horas de operação por dia.
Gargalo
Para cada etapa, a média de max(0, duração − SLA) sobre as
visitas finalizadas. O ranking mostra onde cortar um minuto rende mais no
lead time total — hoje, descarga e carregamento.
Arquitetura
Decisões que sustentam o número
- Domínio puro no centro. Roteiro, máquina de estados, SLA, fila, agendador, regras documentais e indicadores vivem em código sem entrada e saída, exercitado por 305 testes. Trocar banco ou provedor de OCR não toca na regra.
- Vocabulário único entre as pontas. Contratos e schemas compartilhados entre a API e a interface: renomear um campo quebra a compilação dos dois lados na hora, em vez de virar bug em produção.
- O mesmo SQL em teste e em produção. Em desenvolvimento sobe um PostgreSQL embutido compilado para WebAssembly, dentro do próprio processo; publicado, e o Postgres gerenciado. O que muda é apenas o driver, o que elimina a família de bugs que só aparece depois do deploy.
- Uma única função sem servidor. A API inteira e montada a partir da mesma fábrica que os testes de integração usam, e a interface vai para CDN. A torre de controle recebe eventos por streaming, com o fluxo se encerrando sozinho antes do teto de execução e reabrindo no navegador.
- Trilha de eventos apenas para acréscimo. Rastreabilidade ponta a ponta: todo indicador pode ser reconstruído a partir dos eventos.
Roteiro
Cinco minutos para avaliar sozinho
A ordem abaixo mostra o mecanismo, e não apenas as telas. Comece pelo fim.
Indicadores
Veja o resultado antes da explicação: permanência contra linha de base, capacidade ganha e o ranking de gargalos.
Portal, seção 2
Envie o documento de exemplo e leia o veredito. Depois troque a validade da habilitação para uma data passada: a recusa vem com motivo, antes de o caminhão sair da transportadora.
Portal, seção 3
Peça as melhores janelas para uma ordem aberta. Cada sugestão mostra a ocupação projetada do recurso gargalo e o porquê daquela escolha.
Operação
Faça o check-in com o código e avance as etapas. Tente concluir a pesagem sem registrar o peso: a plataforma recusa.
Torre de controle
Acompanhe o mesmo caminhão ao vivo: quem está atrasado, quem é o próximo da fila e quanto de cada recurso está ocupado.
App do motorista
Abra pela senha do caminhão: etapa atual, cronômetro e previsão de saída. E a resposta direta ao "espera horas sem previsibilidade".
Limites
O que esta prova de conceito não validou
Estão aqui de propósito. Um caso que só mostra o que funcionou não ajuda a decidir o piloto.
- Sem autenticação e sem perfis de acesso. As quatro superfícies convivem num aplicativo só para que a jornada inteira possa ser percorrida numa avaliação. Em produção, cada uma vira um aplicativo com seu próprio controle.
- Sem isolamento físico por unidade. O esquema já carrega a unidade em tudo que importa, mas uma segunda planta compartilharia o mesmo banco.
- ERP e balança em modo simulado, por design. A plataforma monta e registra exatamente a mensagem que seria enviada, e expõe o contrato de leitura da balança. Isso permite fechar o contrato de integração com o time de TI antes de investir na interface real.
- Dados de demonstração gerados. O histórico e construído percorrendo a máquina de estados de verdade com um relógio sintético. E coerente, mas não e medição de campo: a linha de base real precisa ser coletada nas primeiras semanas do piloto.
- Notificação registrada, não enviada. A mensagem ao motorista entra na caixa de saída; o envio por mensageria e trabalho de integração.
Próximo passo
Percorra antes de acreditar
A aplicação está aberta, sem login. Se algo não aguentar o seu teste, o lugar de descobrir isso e agora.