🍽️ Gestão — ERP para Restaurantes

Sistema completo de gestão de restaurantes: multiestoque, pedidos, cardápio e dashboard BI em tempo real,
com integrações nativas de Mercado Pago (PIX) e iFood.

---

🎯 Sobre o projeto

Restaurante pequeno costuma operar com três sistemas que não conversam entre si: um para o caixa, um para o delivery e uma planilha para o estoque. O resultado é ruptura de insumo no meio do serviço e nenhuma visibilidade de margem.

Este ERP unifica esses fluxos: o pedido entra (no salão ou pelo iFood), baixa o insumo no estoque correspondente, registra o pagamento (inclusive PIX) e alimenta o dashboard de indicadores na mesma transação.

✨ Funcionalidades

• 📦 Multiestoque — controle independente por local (cozinha, bar, depósito) com baixa automática por pedido
• 🧾 Pedidos — abertura, acompanhamento de status e fechamento de contas
• 📋 Cardápio — cadastro de produtos, categorias, preços e vínculo com insumos
• 📊 Dashboard BI — indicadores em tempo real de faturamento, ticket médio e giro de estoque
• 💳 Mercado Pago (PIX) — geração de cobrança e confirmação de pagamento
• 🛵 iFood — recebimento e sincronização de pedidos do delivery
• 🔐 Autenticação JWT — sessões seguras com controle de acesso

🏗️ Arquitetura

gestao/
├── api/            # Back-end: Node.js + Express + TypeScript + Prisma
├── client/         # Front-end: Vite + React + TypeScript + CSS Modules
└── render.yaml     # Infraestrutura como código para deploy no Render

O front-end e a API são aplicações independentes que se comunicam por HTTP, o que permite escalar ou substituir cada lado isoladamente. O Prisma centraliza o schema e as migrations, mantendo o banco versionado junto com o código.

🚀 Como executar

Pré-requisitos

• Node.js 18 ou superior
• PostgreSQL 14 ou superior

Instalação

git clone https://github.com/RobertoBuiatti/Gest-o.git
cd Gest-o

# dependências da raiz, da API e do cliente
npm install
cd api && npm install
cd ../client && npm install

Banco de dados

cd api
cp .env.example .env
npx prisma migrate dev

Desenvolvimento

npm run dev

🔑 Variáveis de ambiente

Crie o arquivo api/.env a partir do .env.example:

Variável	Descrição
DATABASE_URL	String de conexão do PostgreSQL
JWT_SECRET	Chave usada para assinar os tokens de sessão
MERCADOPAGO_ACCESS_TOKEN	Token de acesso do Mercado Pago
IFOOD_CLIENT_ID	Client ID da aplicação no iFood
IFOOD_CLIENT_SECRET	Client secret da aplicação no iFood

⚠️ Nunca versione o arquivo .env. As credenciais acima são sensíveis e devem ficar apenas no ambiente de execução.

🧱 Stack

Camada	Tecnologias
Back-end	Node.js, Express, TypeScript, Prisma
Front-end	Vite, React, TypeScript, CSS Modules
Banco de dados	PostgreSQL
Integrações	Mercado Pago (PIX), iFood
Deploy	Render (render.yaml)

🗺️ Próximos passos

• Emissão de NFC-e
• App para o garçom lançar pedidos na mesa
• Relatórios de CMV por prato

📄 Licença

Distribuído sob a licença MIT.

👤 Autor

Roberto Buiatti — GitHub · LinkedIn