Instalação

Este guia passo a passo vai ajudá-lo a configurar o ambiente de desenvolvimento para o Meu Restaurante.

Pré-requisitos

• Node.js 22+
• MongoDB 6+ (local ou Atlas)
• Redis 7+ (obrigatório — usado pelo BullMQ e cache de sessão)
• npm

Clone do Repositório

git clone https://github.com/seu-repo/meu-restaurante.git
cd meu-restaurante

Backend

Instalação

cd backend
npm install

Configuração

1. Copie o arquivo de exemplo:

cp .env.example .env

2. Configure as variáveis de ambiente:

# Obrigatório
MONGODB_URI=mongodb://localhost:27017/meu-restaurante
JWT_SECRET=sua-chave-secreta-aqui
APP_SECRET=chave-aleatoria-32-chars        # openssl rand -base64 32
FRONTEND_URL=http://localhost:5173

# Redis (obrigatório — BullMQ + cache)
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=sua-senha-redis

# Opcional
PORT=3000

Iniciar o Backend

npm run start:dev

O backend estará disponível em http://localhost:3000

Frontend (React)

Instalação

cd ../frontend-react
npm install

Configuração

1. Copie o arquivo de exemplo:

cp .env.example .env

2. Configure a URL da API:

VITE_API_URL=http://localhost:3000/api

Iniciar o Frontend

npm run dev

O frontend estará disponível em http://localhost:5173

Seed de Dados

Para criar dados de demonstração:

cd backend
npm run seed

Isso criará um usuário superadmin (superadmin@saas.com) e um tenant demo com dados de exemplo.

As senhas são geradas aleatoriamente a cada execução e impressas uma única vez no stdout — salve-as imediatamente.

Próximos Passos

• Configuração
• Primeiros Passos