Samurai: gestão de oficina de motos
Meu papel
Projeto sob medida para a Samurai: fiz sozinho o produto, o desenvolvimento e a operação, com 206 commits de janeiro a setembro de 2026.
Construí um sistema web mobile-first, pensado para o tablet na bancada. A moto entra com cliente, dados do veículo e fotos; o orçamento é montado na hora, com as fotos, e vira entrada com um clique. Cada serviço tem status e fotos de progresso, e a ordem de serviço sai em PDF com as fotos de entrada e saída e a assinatura. Também há frete calculado por CEP, relatórios com exportação para Excel e gestão de usuários com histórico de atividades. O front é React + TypeScript + Vite; o backend é Supabase (Postgres com RLS, Storage e Edge Functions), com deploy na Vercel e o código organizado em domínio, casos de uso e infraestrutura.
Antes
Orçamentos e controle de serviços sem um sistema próprio e sem registro do estado da moto na entrada, o que abria espaço para alegações de peças faltando ou quebradas.
O problema
Uma oficina de alinhamento de motos precisava controlar entradas, orçamentos e serviços em andamento num só lugar, com prova do estado de cada moto e números confiáveis do negócio. Sem registro de como a moto chegava, não havia como responder quando um cliente alegava uma peça faltando ou quebrada.
A solução
Construí um sistema web mobile-first, pensado para o tablet na bancada. A moto entra com cliente, dados do veículo e fotos; o orçamento é montado na hora, com as fotos, e vira entrada com um clique. Cada serviço tem status e fotos de progresso, e a ordem de serviço sai em PDF com as fotos de entrada e saída e a assinatura. Também há frete calculado por CEP, relatórios com exportação para Excel e gestão de usuários com histórico de atividades. O front é React + TypeScript + Vite; o backend é Supabase (Postgres com RLS, Storage e Edge Functions), com deploy na Vercel e o código organizado em domínio, casos de uso e infraestrutura.
Decisões e trade-offs
Fotos comprimidas no navegador antes do envio e guardadas em duas versões, miniatura e original, com cache longo, para caber no plano do Supabase. Paginação e busca feitas no servidor em vez de carregar tudo na tela. Regras de acesso por linha (RLS) no próprio banco. Casos de uso cobertos por testes, com mutation testing.
Os resultados
O sistema está em produção desde o início de 2026, com 365 ordens de serviço e 255 clientes cadastrados. Segundo o dono, o orçamento montado na hora, no tablet e com as fotos da moto, ajudou a fechar contrato com mais de um cliente, e as fotos de entrada e saída na ordem de serviço quase acabaram com as alegações de peças faltando ou quebradas. Em agosto, otimizei o tráfego de fotos e de consultas, e o tráfego de saída do Supabase caiu de 7 GB para 400 MB por mês, o que deixa o sistema dentro do plano.
Depoimento
O sistema mudou a forma como a Samurai trabalha. Nos workshops com outras oficinas, quase todo mundo ainda usa papel e caneta; eu abro o sistema no tablet e tenho tudo na mão, em qualquer lugar. Já fechei com mais de um cliente porque viram o orçamento sendo montado na hora, com as fotos da moto. E como agora registramos fotos na entrada e na saída, e elas vão na ordem de serviço, quase acabaram as discussões sobre peça faltando ou que chegou quebrada.
Heitor Asaeda, Dono da Samurai
Resultados em números
- 365ordens de serviço emitidas
- 7 GB → 400 MBtráfego de saída do Supabase por mês
- 255clientes na base
- Entrada + saídafotos em cada ordem de serviço
- 38arquivos de teste