Configuração

Variáveis de Ambiente

Backend

Variável	Descrição	Padrão
MONGODB_URI	String de conexão MongoDB	mongodb://localhost:27017/meu-restaurante
JWT_SECRET	Chave para assinatura de tokens JWT	-
PORT	Porta do servidor	3000
FRONTEND_URL	URL do frontend para CORS	http://localhost:5173

Frontend

Variável	Descrição	Padrão
VITE_API_URL	URL base da API	http://localhost:3000/api

Stone Payment Gateway

Configure as variáveis abaixo no backend/.env para ativar o processamento de cartão via terminal Stone:

Variável	Descrição
STONE_CLIENT_ID	Client ID OAuth2 da Stone
STONE_CLIENT_SECRET	Client Secret OAuth2 da Stone
STONE_WEBHOOK_SECRET	Segredo HMAC-SHA256 para validar webhooks recebidos da Stone
STONE_SANDBOX	true para ambiente sandbox, false para produção

Quando STONE_SANDBOX=true, o StoneService aponta automaticamente para as URLs de sandbox da Stone.

Se STONE_CLIENT_ID não estiver definido, o sistema cai de volta para o modo mock (resposta síncrona approved) sem erros.

Configuração de Tenants

Cada tenant pode ser configurado com:

• Nome: Nome do restaurante
• Slug: Identificador único na URL (ex: demo)
• Cores: Cor primária e secundária
• Plano: Tipo de assinatura

Configuração de Usuários

Papéis

Papel	Descrição
superadmin	Acesso a todos os tenants e configurações globais
admin	Acesso completo a um tenant específico
staff	Acesso às funções operacionais (filial, cozinha)
customer	Cliente sem acesso ao painel admin

Configuração de Filial

Modos de Serviço

• Mesa: Para atendimento no local com associação de mesa
• Balcão: Para atendimento rápido no balcão
• Auto-atendimento: Para quiosques de autoatendimento

Próximos Passos

• Primeiros Passos