Estudo de caso · 2026 · antes chamado CogniVault

Vardão Central

O sistema que a Vardão Máquinas, revenda autorizada Husqvarna em Limeira, usa todos os dias no balcão, no comercial, no financeiro e no estoque. Comecei por um catálogo de peças para o balcão, e hoje ele assume o trabalho do ERP antigo da loja.

Ver o sistema no ar (com login) Falar comigo
Balcão do Vardão Central: busca pelo modelo 143RII com três peças no orçamento ao lado.

O problema

No balcão, o cliente está na frente do atendente. Para responder "qual é a peça e quanto custa", era preciso abrir um catálogo em PDF, achar a posição no desenho, conferir o preço numa planilha, ver se a peça estava na prateleira e montar o orçamento à mão. Um código errado vira devolução.

Fora do balcão, as vendas, o financeiro e os clientes ficavam num ERP antigo, separado de tudo. Quem queria saber quanto a loja vendeu no mês ou que cliente estava parado precisava juntar informações de lugares diferentes.

O que eu construí

Balcão

Busca por código, peça, modelo ou PNC; vista explodida oficial com a posição clicável; preço da lista e prateleira; orçamento em PDF e WhatsApp. Teclado primeiro: o atendente trabalha com pressa.

Comercial

CRM com quadro de negociações e filtros rápidos, ranking de clientes, cross selling, reativação de clientes parados e a tabela de preços das máquinas.

Financeiro

Lançamento de vendas, compras e despesas, DRE, fluxo de caixa, capital de giro, curva ABC e fechamento de caixa.

Estoque

Itens a pedir, faltas, prateleiras e encomendas de peças para o cliente, com o sinal que ele já pagou.

Início por perfil

Cada pessoa abre o sistema no Início do seu papel, com o que importa para o dia dela, e o botão principal muda conforme o papel: "Lançar venda" ou "Novo orçamento".

A migração do ERP, conferida ao centavo

A loja não podia perder nenhum número na troca. A regra era simples: os mesmos resultados do ERP antigo, ou melhores.

Regras que o produto não quebra

Nunca chutar o código

Código digitado devolve só o código exato e a substituição oficial da fabricante. A IA só escolhe dentro de uma lista fechada de peças da máquina.

O cliente nunca recebe o código

PDF, WhatsApp e impressão saem sem o código da peça, para o cliente não cotar em outra revenda com o nosso número.

Mudança de dado é explícita

Importar preço, estoque ou vendas mostra um relatório antes de gravar e guarda como desfazer.

Número é número

Parcelas em centavos inteiros e datas no fuso da loja, travadas por teste.

Telas

Prints feitos numa loja simulada, com dados de demonstração. Nenhum dado real da loja aparece aqui.

Decisões e o que aprendi

O teste verde que mentia

Uma rotina que apaga orçamentos com mais de 1 ano tinha teste e passava. Em produção, nunca rodava: a linha que a ligava estava dentro do bloco de nova tentativa da fila. Descobri olhando o banco. Hoje há um teste só para essa ligação, provado desfazendo a correção e vendo o teste reprovar.

"Hoje" terminava ontem

O servidor roda em UTC e a loja em UTC-3: o filtro "até hoje" cortava antes da meia-noite da loja e o dono não via os orçamentos do próprio dia. Toda conta de dia agora usa o fuso da loja, travada por teste.

Recusar é melhor que errar

O leitor de catálogos em PDF prefere recusar um arquivo duvidoso, dizendo o motivo, a gravar um código errado que estragaria a busca inteira.

O servidor ao lado do banco

O banco fica em São Paulo e o servidor da API ficava nos Estados Unidos: cada consulta ia e voltava, cerca de 210 ms por vez. Preparei as telas do dia a dia para serem atendidas por uma função em São Paulo, ao lado do banco, e deixei no servidor principal só o que é pesado, como PDFs e importações. Dá para voltar atrás com uma variável.

Comparar com o sistema antigo, não com a minha cabeça

Na migração, eu não confiei nas regras que eu achava que o ERP tinha. Rodei o próprio ERP como referência, e foi isso que achou o que estava escondido.

Qualidade em números

1.400+testes no back-end
600+testes no front-end
70testes de ponta a ponta no navegador
1.107comparações com o ERP antigo
91migrations do banco, versionadas
49modelos de dados

Contagens feitas nos arquivos do projeto em 30/10/2026.

Tecnologias