Black Bar
Sistema completo para um open bar de eventos: orçamento com rede neural local, operação offline e lucro por festa.
- Tipo
- Sistema web sob medida
- Status
- Pronto para produção
- Ano
- 2026
- Cliente
- Serviço de open bar de eventos (interior de Minas Gerais)
- Papel
- Desenvolvimento de ponta a ponta
Código-fonte privado. Este estudo de caso apresenta as principais funcionalidades, a interface e a arquitetura em alto nível.
Visão geral
O que é este projeto.
Do pedido de orçamento ao lucro do evento. O sistema atende o visitante, o administrador e a equipe no celular — inclusive sem sinal — e sugere preço e consumo com redes neurais que rodam no próprio servidor.
Contexto
Um serviço de open bar do interior de Minas orçava cada festa no olho, comprava insumo por estimativa, perdia copo sem saber e escalava a equipe por WhatsApp. O dono era a única memória do negócio. Muitos eventos acontecem em sítios sem sinal de celular.
Objetivo
Fazer o orçamento em minutos com base no que o próprio bar já cobrou, mostrar onde está o lucro, saber quanto levar para cada festa e continuar funcionando no celular da equipe sem internet.
O problema
Preços incoerentes entre eventos parecidos, margem imprevisível, compra de insumo por estimativa, vidro sem conferência e nenhum lugar único da informação.
A solução
Três faces no mesmo sistema: um site público que recebe o pedido com proteção contra spam; um painel administrativo que calcula equipe, deslocamento, insumos e piso, sugere o preço com uma rede neural treinada no histórico e gera PDF com aceite online; e um painel da equipe instalável no celular, que funciona offline. O aceite cria sozinho o evento, as parcelas e o checklist. A rede nunca decide sozinha: só entra se vencer a heurística, e o peso cresce com o histórico.
- Erro da rede de preço
- 52% menor que a mediana
- Erro da rede de consumo
- 53% menor que a média
- Testes de backend
- 652
- Casos E2E
- 139
Funcionalidades
O que o sistema faz.
Do cadastro simples ao que exige regra, transação e recuperação de falha.
- Pedido de orçamento público, idempotente e protegido contra spam
- Cálculo determinístico de equipe, deslocamento, insumos e piso mínimo
- Sugestão de preço por pessoa com justificativa baseada em comparáveis reais
- Proposta em PDF e aceite online, sem o cliente criar conta
- Criação transacional de evento, parcelas e checklist no aceite
- Painel da equipe instalável, com receita, checklist e retorno offline
- Previsão de consumo por insumo com margem de segurança por grupo
- Conferência de vidro e cobrança da quebra
- Módulos ligáveis — o dono adota o sistema aos poucos
- Localizar, exportar, corrigir e anonimizar dados do titular (LGPD)
Interface
As telas do sistema.
Capturas reais do sistema em funcionamento. Clique para ampliar.
Dashboard operacional
O que precisa de atenção hoje, com link para resolver: solicitações novas, propostas aguardando, eventos confirmados e estoque abaixo do mínimo.
Revisão do orçamento
Memória de cálculo aberta — equipe, deslocamento, insumos e piso — ao lado da sugestão da rede neural com justificativa. A aprovação respeita o piso mínimo.
Proposta e aceite online
O cliente compara as versões Padrão e Premium e aceita sem criar conta. O aceite cria evento, parcelas e checklist numa transação.
Site público
Fotos, textos e números de vitrine saem do painel: o dono edita a página sem tocar em código.
Pedido de orçamento
Formulário em etapas, sem mostrar preço, idempotente — vinte envios simultâneos do mesmo pedido geram uma solicitação só.
Fechamento do evento
Lucro apurado por festa e as pendências que impedem concluir, em vez de um botão que fecha em cima de conta aberta.
Previsão de insumos
A carga sugerida vem da rede de consumo treinada no histórico, com margem de segurança por grupo de item.
Conferência de vidro
Saída, retorno e cobrança da quebra — o buraco que o negócio não enxergava antes.
Análises e precisão da IA
Leitura do mês em frases, os dois modelos medidos contra a heurística, funil de conversão e lucro.
Módulos ligáveis
23 funcionalidades que o dono liga quando quiser; as essenciais ficam travadas. Foi assim que ele adotou o sistema aos poucos.
Lista de compras
Eventos do período menos o que já existe no estoque, com histórico de preço por insumo.
Colinha da equipe (offline)
Doses e marcas do tier do evento no celular do barman — funciona em sítio sem sinal, que é onde a festa costuma acontecer.
Convites da equipe
Aceitar ou recusar com o cachê à vista, substituindo a escala por WhatsApp.
Por trás da aplicação
Como isso funciona por dentro.
A parte que o visitante não vê na tela: camadas, autenticação, dados, integração e operação.
Autenticação e papéis
Login único que redireciona para o painel certo. Administrador, equipe e visitante veem superfícies diferentes.
REST APIs em camadas
Rotas → serviços → Prisma. Nenhuma regra de negócio mora na rota, então o agendador diário reusa o mesmo caminho da tela.
Redes neurais locais
MLP 14→8→1 para preço e uma segunda rede para consumo, ambas no servidor, com semente fixa e comportamento auditável.
Offline com fila
PWA da equipe. Só falha de rede fica na fila; erro de negócio esvazia e mostra o motivo.
Concorrência
Aceite único por solicitação, estoque por delta, lotes transacionais e chaves de idempotência.
Docker e operação
Compose com API, site, banco e migrations. Nginx, backup verificado e rotinas diárias com trava de execução única.
Arquitetura
As camadas, de cima para baixo.
Representação em alto nível — sem expor detalhe de infraestrutura.
Visitante e cliente
Site público e link da proposta
Painel admin e PWA da equipe
React, Vite, TanStack Query
API REST
Node.js, Express, TypeScript
Regras de negócio
Serviços + redes neurais locais
MySQL
Transações, travas e integridade
Fluxo
Como o processo acontece.
- 01
Pedido
Visitante preenche o formulário sem ver preço
- 02
Cálculo
Motor determinístico + sugestão da rede neural
- 03
Aprovação
Administrador ajusta, respeitando o piso
- 04
Proposta
PDF e link público com versões Padrão e Premium
- 05
Aceite
Cria evento, parcelas e checklist numa transação
- 06
Operação
Equipe no celular, inclusive sem sinal
- 07
Fechamento
Retorno de insumos, vidro e lucro consolidado
Stack
Tecnologias utilizadas.
Frontend
- React
- Vite
- TanStack Query
- Tailwind CSS
- PWA
Backend
- Node.js
- Express
- TypeScript
- Prisma
- Zod
Banco de dados
- MySQL
Infraestrutura
- Docker
- Nginx
- GitHub Actions
Inteligência Artificial
- MLP local em TypeScript
Qualidade
- Playwright
- Vitest
Destaques técnicos
Decisões que sustentam o sistema.
- Duas MLPs escritas do zero em TypeScript, sem API externa de IA
- A rede de preço só entra se vencer a mediana dos comparáveis na validação cruzada
- Peso da rede cresce de 20% para no máximo 85% — nunca 100%
- Fila offline idempotente: reenviar não baixa o estoque duas vezes
- Concorrência tratada como requisito, com testes de corrida reais
- 20 envios simultâneos do mesmo pedido resultam em 1 solicitação
- Paginação por cursor, sem N+1, comparada a um oráculo nos testes
- 652 testes de backend e 139 casos E2E em 5 navegadores, sem retry
Quer algo assim para o seu processo?
Me conte como funciona hoje. Respondo com uma leitura do problema e um caminho possível.