Sistema comercial · Produto próprio

Case 03 / 11

ZM Gestão

Sistema comercial para pequenos negócios que reúne vendas, estoque, clientes, financeiro, caixa, ordens de serviço e rotinas operacionais em uma única experiência, com opção local e edição sincronizada em nuvem.

React 19TypeScriptViteIndexedDBNeon PostgreSQL
2capturas reais
2links verificáveis
3métricas com fonte
Sem notaavaliação pública
—localização aplicável

Escopo real

O que este projeto realmente envolveu.

Escopo

Sistema comercial web/PWA com edição local offline-first, edição em nuvem com Neon PostgreSQL/Data API, autenticação Firebase, licenciamento e aplicativo Android.

Papel da ZM

Produto próprio: concepção, UX, desenvolvimento full-stack, modelagem de dados, sincronização, testes, release comercial e operação.

Números verificáveis

Dados que dão contexto ao projeto.

Métricas públicas apontam a fonte. Registros históricos são identificados como histórico e não apresentados como leitura em tempo real.

10+downloads do app Android

Faixa pública exibida pela Google Play em 2026.

Google Play
2modos de operação

Local/offline e nuvem sincronizada.

Neonbackend principal em nuvem

PostgreSQL + Data API, com autenticação Firebase e isolamento de conta por RLS.

7.0versão pública

Versão exibida na ficha oficial da Google Play em setembro de 2026.

Google Play
09/04/2026atualização pública do app

Data exibida pela Google Play.

Google Play

Entrega

O que foi construído, não apenas “um site” ou “um app”.

O escopo abaixo é específico deste projeto e foi extraído da implementação, documentação ou operação real.
01

PDV e vendas

Fluxo de venda, formas de pagamento, histórico, recibos e atualização operacional de estoque.

02

Estoque e clientes

Cadastro, movimentações, alertas, histórico de compras, CRM e rotinas de relacionamento.

03

Financeiro e caixa

Contas, despesas, lucros e caixa reunidos no mesmo ambiente operacional.

04

Ordens de serviço

Orçamento, diagnóstico, peças, acompanhamento e conclusão para negócios que também prestam assistência.

05

Local + nuvem

Uma edição opera offline no dispositivo; outra sincroniza o estado local com Neon PostgreSQL/Data API para uso em múltiplos computadores.

06

Licenciamento e backup

Licenças separadas por edição, segredos fora do repositório e exportação/restauração de dados.

Experiência e operação

Como a solução é usada na prática.

Um case profissional precisa mostrar fluxo, não apenas tecnologia. Estes são caminhos reais previstos ou implementados no produto.

01

Venda → estoque → caixa

Uma venda alimenta o histórico comercial e se conecta às rotinas de estoque e financeiro.

02

Cliente → histórico → cobrança

Cadastro e histórico ficam disponíveis para acompanhamento e contato administrativo.

03

OS → diagnóstico → entrega

Serviços podem ser orçados, diagnosticados, associados a peças e acompanhados até a conclusão.

04

Local → sincronização

A edição cloud mantém dados locais para resposta rápida e sincroniza operações com Neon, usando fila durável e controle de versão para reduzir conflitos entre dispositivos.

Desafio

O problema que o projeto precisava organizar.

Pequenos lojistas frequentemente operam com planilhas e ferramentas separadas. O projeto precisava concentrar operação diária, funcionar mesmo sem internet e ainda oferecer uma versão em nuvem para múltiplos dispositivos sem transformar a implantação em um sistema pesado.

Solução

Como a solução foi estruturada.

O produto foi estruturado em duas edições: uma local, offline-first, e outra em nuvem. PDV, estoque, clientes, contas, caixa, OS, encomendas, usados por comissão e campanhas compartilham uma base operacional, com backup exportável e rotinas de sincronização na edição cloud.

Decisões de projeto

Escolhas que moldaram a solução.

Mais do que listar tecnologia: aqui estão decisões documentadas de produto, experiência, arquitetura ou operação e o motivo de cada uma.
01

Offline-first sem abandonar a nuvem

A operação mantém resposta local e uma edição cloud sincronizada, em vez de depender exclusivamente de conectividade constante para vender ou consultar dados.

Por quê

Negócios pequenos precisam continuar operando mesmo com conexão instável, mas também podem exigir uso em mais de um computador.

02

Neon + Data API com autenticação separada

A persistência cloud principal usa Neon PostgreSQL/Data API, enquanto Firebase Auth identifica o usuário e o isolamento por conta é reforçado no banco.

Por quê

A separação permite evoluir autenticação e persistência sem misturar responsabilidades, além de manter dados comerciais segmentados por conta.

03

Release comercial verificável

Preflight, testes de regressão, backup, licenciamento e validações de sincronização fazem parte do fluxo de publicação.

Por quê

Um sistema que movimenta vendas, estoque e financeiro precisa reduzir regressões antes de cada release, não apenas compilar.

Imagens reais

Interface do próprio projeto.

O portfólio não cria tela cenográfica. Quando existe captura original, ela aparece aqui; quando não existe, a página declara isso em vez de inventar material.
2capturas originais deste projeto
CAPTURAS REAISExplore a interface
01 / 02
Site real do ZM Gestão — tela de seleção entre ZM Gestão e Salão PRO
Tela inicial real do sistema web

Demonstração com imagens existentes e documentadas do projeto, não um vídeo de utilização real ou uma simulação de funcionalidades.

Evolução

Como o projeto foi estruturado.

A cronologia descreve fases reais do trabalho sem inventar datas quando elas não estão documentadas.
01

Operação local

A base offline-first priorizou independência de conexão e armazenamento no próprio dispositivo.

02

Expansão funcional

PDV, estoque, financeiro, OS, encomendas, usados e campanhas passaram a compartilhar a mesma operação.

03

Edição em nuvem

A edição cloud evoluiu para Neon PostgreSQL/Data API como backend principal, com Firebase Auth e isolamento por conta via RLS.

04

Release comercial

Preflight, testes end-to-end, backup, licenciamento e distribuição web/Android passaram a compor o fluxo de entrega.

Engenharia

Funcionalidade, arquitetura e qualidade.

O objetivo é mostrar o que existe por trás da interface: capacidades, decisões de arquitetura e critérios de qualidade.

Capacidades

01PDV e histórico de vendas
02Controle de estoque
03Cadastro e acompanhamento de clientes
04Contas, caixa e visão financeira
05Ordens de serviço com orçamento, diagnóstico e peças
06Encomendas com sinal e saldo
07Usados, troca e comissão
08Campanhas e origem de clientes
09Backup e restauração
10PWA para celular e computador
11Aplicativo Android publicado

Arquitetura

01Frontend web em React + Vite
02Dados locais em IndexedDB
03Edição nuvem com Neon PostgreSQL + Data API
04Outbox durável em IndexedDB e operações versionadas para sincronização
05Firebase Auth com isolamento por conta via RLS/account_id
06Licenciamento separado para edições local e nuvem
07Aplicativo Android distribuído pela Google Play

Resultados e decisões

O que o projeto passou a entregar de forma concreta.

Sem porcentagem inventada de conversão ou “crescimento”. Quando não existe analytics público confiável, o resultado é descrito pelo que foi efetivamente construído, publicado ou documentado.

Dois modos de implantação

O mesmo produto atende cenários que exigem independência de internet e cenários que exigem sincronização.

Persistência cloud consolidada

Neon PostgreSQL/Data API concentra os dados comerciais da edição em nuvem, com autenticação Firebase, isolamento por conta e operações versionadas.

Release verificável

A publicação comercial possui preflight, testes de regressão e validações específicas de sincronização.

Avaliação pública

Sem nota públicaGoogle Play

O app Android ainda não apresenta volume público suficiente de avaliações para uma nota representativa.

Consulta pública: setembro de 2026Conferir fonte

Qualidade

O que vai além da interface.

Um projeto profissional também precisa de validação, segurança, manutenção, contexto de uso e critérios claros para publicação.

01Testes unitários e de regressão
02Playwright para fluxos end-to-end
03Preflight de release comercial
04Backup local exportável e restaurável
05Segredos de licença fora do repositório
06Validações P0 para sincronização e consistência de dados

Tecnologias e práticas

Ferramentas escolhidas conforme a necessidade.

React 19TypeScriptViteIndexedDBNeon PostgreSQLNeon Data APIFirebaseVitestPlaywright

Nota sobre os dados: Downloads e data de atualização são dados públicos da Google Play. A arquitetura foi revalidada no repositório técnico atual do produto em setembro de 2026: Neon PostgreSQL/Data API é o backend principal dos dados comerciais; Firebase mantém a identidade cloud e o isolamento por conta é aplicado por RLS. A área pública exibe seleção do produto e login, enquanto dashboard e dados operacionais exigem autenticação.

Próximo projeto

Quer apresentar seu negócio nesse nível?

A proposta é transformar o trabalho em prova concreta: projeto bem construído, publicado, documentado e apresentável.

Solicitar orçamento no WhatsApp
WhatsApp