Comércio · PWA de gestão com sincronização
Yanzim
Sistema de vendas, estoque e fiado para tabacaria e lanchonete, instalável no celular e que continua vendendo sem internet.
- Cliente
- Sedinha Tabacaria e Lanchonete, comércio de balcão que vende muito no fiado
- Onde
- Brasil · uso no balcão da loja
- Tecnologia
- HTML · CSS · JavaScript · PHP 8 · PDO · MySQL · Service Worker · PWA
- Situação
- Acesso restrito · yanzim.nexialabs.com.br
- Desenvolvimento
- André Gomes · NexiaLabs
Em resumo
Yanzim é o sistema de vendas, estoque e controle de fiado da Sedinha Tabacaria e Lanchonete, feito por André Gomes, da NexiaLabs. Funciona como aplicativo instalável no celular e no computador, grava cada venda primeiro no aparelho e depois sincroniza com um banco MySQL na hospedagem. Foi escrito em HTML, CSS e JavaScript puro, com uma API em PHP 8.
O cliente
A Sedinha é uma tabacaria com lanchonete que atende no balcão, com clientes de bairro que compram para pagar depois. O controle do fiado, do estoque e do caixa dependia de anotação e memória. O dono usa o celular durante o dia e o computador da loja em outros momentos. A internet do ponto oscila, então qualquer sistema que travasse sem sinal pararia a venda.
O desafio
O sistema precisava registrar uma venda em segundos, inclusive no fiado parcelado, e saber quem deve quanto e desde quando. Precisava funcionar sem internet e mesmo assim mostrar os mesmos dados no celular e no computador. Também não podia exigir servidor de aplicação nem mensalidade extra, porque roda numa hospedagem compartilhada comum. E as parcelas tinham que fechar exatamente com o total da venda, sem centavo sobrando.
O que foi construído
André construiu um aplicativo web instalável que trabalha primeiro no aparelho e depois no servidor. Cada venda é gravada na hora no navegador e entra numa fila que sobe para o MySQL assim que há conexão, e de minuto em minuto o app busca o que mudou no outro aparelho. O PDV aceita dinheiro, pix, débito, crédito e fiado com entrada e até seis parcelas, e avisa quando a venda passa do limite do cliente. Cobranças e comprovantes saem prontos para o WhatsApp. A primeira versão guardava tudo só no navegador, e a regra de negócio foi isolada num único arquivo justamente para permitir trocar o armazenamento por uma API sem mexer nas telas.
O que o sistema faz
- Painel com vendas do dia, fiado a receber, parcelas em atraso, gráfico de 14 dias e produtos com estoque baixo.
- PDV com busca, filtro por categoria, desconto, item avulso e cinco formas de pagamento.
- Fiado com entrada, até seis parcelas, aviso de limite estourado e recebimento total ou parcial.
- Pagamento único do cliente distribuído automaticamente nas parcelas mais antigas.
- Cobrança e comprovante prontos para enviar pelo WhatsApp.
- Caixa com entradas automáticas das vendas e lançamentos manuais de despesa e retirada.
- Relatórios de faturamento, lucro bruto, margem, ticket médio e produtos mais vendidos, com exportação em CSV.
- Login com senha conferida no servidor, sessão de trinta dias e backup em arquivo.
// Para quem avalia o código: arquitetura e decisões.
Por dentro
A frente é HTML, CSS e JavaScript puro, sem framework e sem etapa de build, servida como arquivos estáticos na hospedagem compartilhada da Hostinger. Toda a regra de negócio fica em store.js, que guarda os dados no armazenamento local do navegador; um módulo de nuvem envia as alterações para uma API em PHP 8 com PDO e MySQL, com uma única porta de entrada. No banco, a tabela de registros guarda cada item com dois carimbos de hora, o do aparelho para resolver conflito e o do servidor para saber o que falta baixar, e exclusão viaja como marca de apagado. Um service worker com estratégia de rede primeiro deixa o app abrir sem sinal.
Decisões técnicas
- Gravar primeiro no aparelho e sincronizar depois, para a venda nunca travar quando a internet cai.
- Sincronizar por registro com carimbo do cliente e do servidor, para dois aparelhos editarem coisas diferentes sem um apagar o outro.
- Calcular parcelas em centavos, para a soma das parcelas sempre fechar com o total da venda.
- Senha com bcrypt, cookie httponly e samesite strict, trava de dez minutos após oito erros e cabeçalho próprio exigido em toda gravação.
Seu negócio parece com esse?
Serve para mercearia, tabacaria, lanchonete ou qualquer comércio de balcão que vende fiado e precisa saber quem deve, sem depender de caderno.
Perguntas frequentes
Quem desenvolveu Yanzim?
Yanzim foi desenvolvido por André Gomes Andrade, desenvolvedor full stack de Carlos Chagas, Minas Gerais, pela NexiaLabs, do planejamento à publicação.
Onde fica o cliente de Yanzim?
Sedinha Tabacaria e Lanchonete, comércio de balcão que vende muito no fiado. Brasil · uso no balcão da loja.
Com quais tecnologias Yanzim foi feito?
Yanzim usa HTML, CSS, JavaScript, PHP 8, PDO, MySQL, Service Worker e PWA.
Dá para fazer um projeto parecido para o meu negócio?
Dá. Cada projeto é feito sob medida, com código e acessos no nome do cliente. O primeiro passo é uma conversa pelo WhatsApp +55 (33) 98465 6356 para entender o que você precisa.
Outros projetos de comércio
Duvale Conveniência
Site e apps da Duvale: o cliente pede pelo app e paga na entrega, e a equipe faz os checklists do turno pelo celular.
Loja de conveniência em Carlos Chagas
Ver o projeto
Acesso restritoEspaço Pets
Sistema de petshop com agenda de banho e tosa, caixa com fiado e link para o tutor marcar horário sozinho.
Petshop de banho e tosa com venda de produtos no balcão
Ver o projeto
Hōma e Lojinha
Loja de roupa autoral com pedido pelo WhatsApp e um sistema de ateliê que cuida de produção, estoque e revendedores.
Homa Confecções, ateliê de roupa autoral no Extremo Sul da Bahia que vende direto e por revendedores
Ver o projeto