BI Transporte — Processador XLS

O BI Transporte substitui um processo manual de planilhas da Vantroba por um serviço que recebe os arquivos Excel de transporte, valida e arquiva automaticamente o faturamento e o movimento da frota, e mantém um histórico rastreável de cada envio. Reenviar a mesma planilha não duplica nada, e os dados ficam disponíveis para consulta no aplicativo e nas telas web.

Na prática: o que antes dependia de alguém rodar um script à mão vira um envio autenticado que se processa sozinho, notifica o resultado e guarda a trilha do que entrou — pronto para auditoria e para os relatórios de quem opera o transporte.

→ Documentação Completa — o sistema inteiro, de cima a baixo.

O que já foi entregue:

• Recebimento e processamento automático das planilhas de transporte, com histórico rastreável de cada envio.
• Reprocessar um período sem gerar tráfego nem churn desnecessário para os aplicativos móveis.
• Arquivamento dos arquivos recebidos em storage dedicado, fora do banco de dados.
• Identificação de veículo e frota nos lançamentos, preservando correções manuais de cadastro.
• Reset seguro e auditável da replicação quando o estado replicado precisa ser zerado.
• Configurações compartilhadas entre servidor e aplicativo, ajustáveis sem novo deploy.
• Acesso às telas internas restrito a contas @xadm.com.br.
• Stack uma major atrás modernizada e código alinhado às práticas do framework, sem mudar comportamento observável.

---

Atalhos

• Etapas do Projeto — o desenho dos subsistemas e fluxos.
• Decisões — o porquê de cada escolha técnica (ADRs).
• Operação — runbooks: deploy, resetar replicação, login Google.
• Dev / API — contrato da API REST e referência técnica.
• Manual — passo a passo para o usuário/suporte.
• Público — manual e referência da API expostos (docs/public/).
• Glossário do projeto — vocabulário do domínio.