Plataforma SaaS para operação e gestão de restaurantes, com foco em pedidos, mesas, comandas, cozinha, estoque, integrações e governança operacional em um fluxo único.
O ChefOps foi construído para restaurantes que precisam reduzir ruído operacional e ganhar clareza entre atendimento, cozinha, cobrança, delivery e gestão. A aplicação combina experiência pública para pedidos, área operacional interna, integração com pagamentos e recursos de administração em uma base única.
Hoje o produto cobre:
- cardápio público com slug por estabelecimento
- pedidos online e fluxo de checkout
- gestão de mesas e comandas
- KDS para cozinha
- controle de estoque e baixa automática por ficha técnica
- produtos, categorias, extras e itens de menu
- entregadores, configuração de entrega e operação de delivery
- notificações e integrações com WhatsApp
- integração com Mercado Pago
- onboarding, gestão de usuários e controle por plano
- área administrativa para tenants e métricas
- pedidos online e presenciais no mesmo ecossistema
- acompanhamento de status de pedidos e atendimento
- fluxo de mesas, sessões e comandas
- gestão operacional de cozinha via KDS
- acompanhamento de vendas e indicadores operacionais
- produtos, categorias, extras e combinações
- cardápio público por slug
- estrutura para ficha técnica e insumos
- recursos para controle de disponibilidade e composição
- controle de saldo e movimentações
- alertas de estoque
- fechamento operacional
- baixa automática com base em ficha técnica
- Mercado Pago para checkout e contas conectadas
- notificações via WhatsApp usando Twilio
- configuração de webhook e fluxo de retorno
- controle por planos (
Basic,Standard,Premium) - limites por tenant
- RBAC por função
- área administrativa para visão multi-tenant
- trilha de auditoria administrativa
- Next.js 16 com App Router
- React 19
- TypeScript 5
- Supabase para autenticação e dados
- TanStack Query para data fetching no front-end
- Zod para validação
- React Hook Form
- Tailwind CSS 4
- Vitest para testes
- ESLint 9 para lint
chefops/
├── app/ # Rotas do App Router, páginas e APIs
│ ├── (auth)/ # Login e cadastro
│ ├── (dashboard)/ # Área operacional interna
│ ├── [slug]/menu/ # Cardápio público por estabelecimento
│ ├── admin/ # Administração central
│ └── api/ # Endpoints server-side
├── components/ # UI primitives e componentes compartilhados
├── features/ # Domínios funcionais do produto
├── lib/ # Regras de negócio, integrações e utilitários
├── public/ # Assets públicos, ícones e manifest
├── tests/ # Testes unitários, integração e regressão
└── .github/workflows/ # CI, segurança e análise estática
- landing page institucional em
app/page.tsx - cardápio público em
app/[slug]/menu - checkout e pedidos públicos via APIs em
app/api/public
- dashboard em
app/(dashboard)/dashboard - pedidos em
app/(dashboard)/pedidos - mesas em
app/(dashboard)/mesas - comandas em
app/(dashboard)/comandas - estoque em
app/(dashboard)/estoque - entregadores em
app/(dashboard)/entregadores - integrações em
app/(dashboard)/integracoes - planos em
app/(dashboard)/planos
- visão administrativa central em
app/admin - tenants, histórico e saúde operacional em
app/api/admin
Usado para:
- autenticação
- acesso server-side e client-side
- administração via service role
Implementações principais:
Usado para:
- pagamentos
- webhooks
- OAuth para contas por tenant
- sessões de checkout
Implementações principais:
Usado para:
- notificações operacionais
- verificação de telefone
Implementações principais:
As variáveis abaixo refletem o estado atual do código. Para ambiente local, recomenda-se criar um arquivo .env.local.
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
NEXT_PUBLIC_APP_URL=
PAYMENT_ACCOUNT_ENCRYPTION_KEY=MERCADO_PAGO_ACCESS_TOKEN=
MERCADO_PAGO_WEBHOOK_SECRET=
MERCADO_PAGO_CLIENT_ID=
MERCADO_PAGO_CLIENT_SECRET=
MERCADO_PAGO_OAUTH_REDIRECT_URI=TWILIO_ACCOUNT_SID=
TWILIO_AUTH_TOKEN=
TWILIO_WHATSAPP_FROM=- Node.js 20+
- npm 10+
npm cinpm run devAplicação local:
npm run dev
npm run build
npm run start
npm run lint
npm run typecheck
npm run test
npm run test:coverage
npm run test:unit
npm run test:integration
npm run test:regression
npm run audit:prodO repositório já possui esteiras de validação e segurança em /.github/workflows/ci.yml e /.github/workflows/codeql.yml.
Quality Gate- lint
- testes
- build
Dependency Audit- auditoria de dependências de produção
Secrets Scan- detecção de segredos com Gitleaks
Filesystem Vulnerability Scan- análise de vulnerabilidades com Trivy
Analyze- análise estática via CodeQL
A suíte está organizada em três níveis:
Execução recomendada:
npm run test
npm run test:coverageO projeto possui manifest e ícones preparados para instalação:
O deploy atual é feito na Vercel, com validação de CI nas branches develop e main.
Fluxo recomendado:
- desenvolvimento em
feature/* - merge para
develop - validação de CI
- PR de
developparamain - nova validação de CI
- deploy de produção pela Vercel a partir de
main
feature/*para desenvolvimentodeveloppara integraçãomainpara release e produção
Próximos tópicos que combinam com o estado atual do projeto:
- maturidade de onboarding por tenant
- melhoria de métricas operacionais e comerciais
- evolução de planos e billing
- maior governança administrativa
- documentação de arquitetura e runbooks operacionais
Versão atual do package.json:
0.1.0
O estado atual do produto já representa uma base sólida de operação, com cobertura ampla de fluxo funcional, integração contínua configurada e posicionamento claro para evolução incremental.