Pular para conteúdo

BI Comercial — Processador XLS

cobertura unit+int cobertura +e2e

O BI Comercial substitui um processo manual de planilhas da OnPetro por um serviço que recebe os arquivos Excel do comercial de combustíveis — vendas, margens, metas e cadastros de postos, TRRs e clientes —, reconhece sozinho o tipo de cada arquivo, valida, arquiva 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 — e saber de antemão qual relatório era qual — vira um envio autenticado que se identifica e se processa sozinho, notifica o resultado e guarda a trilha do que entrou. São sete relatórios diferentes ao longo do mês (relatório 18, margem consolidada, margem-dia, meta, meta por vendedor, postos e TRR), e o operador não informa nada além do próprio arquivo. O resultado fica pronto para auditoria e para os relatórios de quem opera o comercial, com os dados sincronizados para os aplicativos do time em campo.

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

O que já foi entregue:

  • Recepção autenticada de planilhas Excel comerciais com detecção automática de tipo e processamento assíncrono.
  • Reprocessar um período sem gerar tráfego nem churn desnecessário para os aplicativos móveis.
  • Garantia, no CI, de que o processador Java produz o mesmo banco que o legado Python para cada família de planilha.
  • Arquivamento dos arquivos recebidos em storage dedicado, fora do banco de dados.
  • Reset seguro e auditável da replicação PowerSync, disparável por API ou por um clique na tela admin.
  • Acesso às telas internas restrito a contas @xadm.com.br, sem tocar na auth Bearer da API.
  • Configurações compartilhadas entre servidor e aplicativo, ajustáveis sem novo deploy.
  • Stack uma major atrás modernizada e contrato de erro da API em RFC 7807, 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.