Plataforma SaaS white-label de cardápio digital para deliverys
Zairyx é uma plataforma SaaS B2B que entrega sites prontos de cardápio digital para restaurantes, pizzarias e outros negócios de alimentação. O operador escolhe um template, personaliza o visual e publica em minutos, com pedidos integrados a WhatsApp e pagamento via Mercado Pago.
Demo ao vivo: https://www.zairyx.com.br
Este repositório opera em modo privado para proteger templates e IP comercial.
- Clientes pagantes recebem acesso nominal ao repositório privado.
- A permissão padrão recomendada é somente leitura.
- O uso comercial depende de licença e pagamento confirmados.
Fluxo operacional: docs/ACESSO_PRIVADO_REPOSITORIO_PAGO.md Resumo da licença comercial: docs/LICENCA_COMERCIAL_TEMPLATES.md Arquitetura público/privado: docs/ARQUITETURA_REPOS_PUBLICO_PRIVADO.md
| Módulo | Descrição |
|---|---|
| 15 Templates por Nicho | Restaurante, Pizzaria, Lanchonete, Bar, Cafeteria, Açaí, Sushi, Adega, Mercadinho, Padaria, Sorveteria, Açougue, Hortifruti, Pet Shop, Doceria |
| Painel do Operador | Cadastro de produtos, categorias, identidade visual, banner, cores e configurações |
| Pedidos WhatsApp | Pedido online com envio estruturado direto para o WhatsApp do restaurante |
| QR Code por Mesa | Geração de QR Code para atendimento local |
| Checkout Mercado Pago | Integração completa com modo sandbox e produção |
| Sistema de Afiliados | 6 tiers progressivos (Trainee → Sócio), comissões automáticas, PIX obrigatório |
| Suporte com SLA | Tickets de suporte com prioridade, SLA cronometrado e painel admin |
| Penalidades Progressivas | Sistema de strikes com perda automática de clientes sem suporte |
| Painel Admin | Gestão de vendas, afiliados, suporte, logs e métricas |
| Chatbot IA | Atendimento automatizado com Groq (LLaMA 3.3 70B) |
| CDN de Imagens | Upload via Cloudflare R2 com cache distribuído |
| Rate Limiting | Proteção de APIs com Upstash Redis |
| Autenticação | Supabase Auth com email verification, hierarquia admin (owner/admin/viewer) |
| Segurança | RLS em todas as tabelas, SECURITY DEFINER views, search_path hardening |
| Cron Jobs | Verificação diária de SLA, trials e saúde do sistema |
| Camada | Tecnologia |
|---|---|
| Framework | Next.js 16 (App Router) |
| Frontend | React 19, Tailwind CSS 4, Radix UI |
| Backend | Next.js API Routes, Server Actions |
| Banco de Dados | Supabase (PostgreSQL) — 27+ migrations |
| Autenticação | Supabase Auth + middleware customizado |
| Pagamento | Mercado Pago (checkout, webhooks) |
| IA | Groq SDK (LLaMA 3.3 70B) |
| Storage | Cloudflare R2 (S3-compatible) |
| Cache/Rate Limit | Upstash Redis |
| CI/CD | GitHub Actions + Vercel auto-deploy |
| Linguagem | TypeScript 5 (strict) |
app/ → Rotas (pages + API routes)
admin/ → Painel administrativo
api/ → Endpoints REST
auth/ → Fluxo de autenticação
templates/ → Preview e compra de templates
components/ → Componentes React reutilizáveis
lib/ → Utilitários, integrações e config
services/ → Camada de serviços e regras de negócio
modules/ → Módulos isolados (QR Code, WhatsApp)
store/ → Estado global (Zustand)
supabase/migrations/ → 27+ migrations SQL incrementais
types/ → Tipos TypeScript
hooks/ → React hooks customizados
scripts/ → Scripts de automação e testes
# 1. Clone o repositório
git clone https://github.com/TiagoIA-UX/Cardapio-Digital.git
cd Cardapio-Digital
# 2. Instale dependências
npm install
# 3. Configure variáveis de ambiente
npm run setup:local # Cria .env.local a partir do exemplo
# 4. Valide a configuração
npm run doctor
# 5. Inicie o servidor de desenvolvimento
npm run devAcesse http://localhost:3000.
Para checkout com Mercado Pago local: npm run dev:https
| Comando | Descrição |
|---|---|
npm run access:grant |
Monta ou aplica convite ao repo privado |
npm run dev |
Servidor de desenvolvimento |
npm run dev:https |
Dev com HTTPS (Mercado Pago) |
npm run dev:checked |
Valida ambiente + dev |
npm run build |
Build de produção |
npm run doctor |
Verifica variáveis de ambiente |
npm run audit:full |
Build + lint + testes |
npm run ship:all |
Pipeline completo de deploy |
npm test |
Executa testes |
O projeto faz deploy automático na Vercel ao fazer merge em main:
- Rode
npm run audit:full - Valide com
npm run doctor - Crie o PR e faça merge em
main - Vercel faz deploy automático
Produção: https://www.zairyx.com.br
| Doc | Descrição |
|---|---|
| INSTALL.md | Guia de instalação e publicação |
| INSTALL.md | Instalação local e publicação |
| SECURITY.md | Política de segurança |
| CONTRIBUTING.md | Guia de contribuição |
| docs/migrations-guide.md | Guia de migrations |
| docs/GUIA_DESENVOLVEDORES_TESTES_MANUAIS.md | Testes manuais |
| docs/OBJETIVO_PRODUTO.md | Objetivo do produto |
| docs/ | Documentação técnica e operacional |
Encontrou uma vulnerabilidade? Veja SECURITY.md para instruções de reporte responsável.
Este projeto é licenciado sob a Business Source License 1.1 (BSL).
- Uso não-comercial: livre para desenvolvimento, estudo e uso pessoal
- Uso comercial: requer licença comercial — contato: tiago@tiagoia.dev
- Conversão: em 2030-03-19, converte automaticamente para Apache 2.0
Veja LICENSE para os termos completos.
Para concessão comercial prática e acesso ao repositório privado, veja docs/LICENCA_COMERCIAL_TEMPLATES.md.
- Email: tiago@tiagoia.dev
- Site: https://www.zairyx.com.br
Zairyx © 2024-2026 Tiago Aureliano da Rocha