Mapa de Rotas

/master                         → Painel master (protegido por MASTER_TOKEN)
/empresa/{slug}/dashboard       → Dashboard da barbearia
/empresa/{slug}/agenda          → Agenda visual por barbeiro
/empresa/{slug}/agendamentos    → Lista de agendamentos
/empresa/{slug}/clientes        → CRM de clientes
/empresa/{slug}/barbeiros       → Gestão de barbeiros e horários
/empresa/{slug}/servicos        → CRUD de serviços
/empresa/{slug}/financeiro      → Cobranças do tenant
/empresa/{slug}/configuracoes   → WhatsApp, dados da empresa
/empresa/{slug}/bloqueada       → Página de acesso bloqueado
/agendar/{slug}                 → Link público (sem login, mobile-first)
/confirmar/{token}              → Confirmar/cancelar presença via token
/api/webhooks/asaas             → Recebe fan-out do Multi-IaSolux

Middleware de Acesso

Roda em TODAS as rotas /empresa/{slug}/* e /agendar/{slug}:

// Status → Ação
trial        → trial_expira_em < NOW? → SET bloqueada → bloquear
               → senão: permitir + injetar BANNER_TRIAL
ativa        → permitir acesso completo
inadimplente → permitir + injetar BANNER_INADIMPLENTE
bloqueada    → redirect /empresa/{slug}/bloqueada
cancelada    → redirect /empresa/{slug}/bloqueada

Estrutura de Diretórios

barbearia-saas/
├── prisma/
│   ├── schema.prisma         ← todas as 13 tabelas
│   └── seed.ts               ← dados de teste
├── src/
│   ├── app/
│   │   ├── master/           ← painel master
│   │   ├── empresa/[slug]/   ← painel tenant
│   │   ├── agendar/[slug]/   ← link público
│   │   ├── confirmar/[token]/← confirmação presença
│   │   └── api/
│   │       ├── webhooks/asaas/ ← recebe fan-out
│   │       └── agente/         ← chat AI
│   ├── components/
│   ├── lib/
│   │   ├── prisma.ts         ← client singleton
│   │   ├── asaas.ts          ← cliente thin para multi-iasolux
│   │   ├── evolution.ts      ← Evolution API client
│   │   └── notificacoes.ts   ← dispatch de notificações
│   └── middleware.ts         ← verificação de status
├── .env.example
└── package.json

EVOLUTION_API_URL=https://sua-evolution-api.com
EVOLUTION_API_KEY=sua-chave-aqui

// Header em todas as chamadas:
{ "apikey": "{EVOLUTION_API_KEY}" }

Endpoints

Formatação de Telefone

// Antes de enviar qualquer mensagem:
1. Remover caracteres não numéricos: replace(/\D/g, '')
2. Adicionar 55 se não começar com 55
3. Validar: deve ter 12 ou 13 dígitos
4. Se inválido: registrar em notificacoes_log (status='falhou') e NÃO enviar

// Exemplos:
"(11) 99999-9999" → "5511999999999" ✅
"11999990001"     → "5511999990001" ✅
"999"             → inválido, log + skip ❌

NOTIFICATION_CHANNEL

NOTIFICATION_CHANNEL=whatsapp  → envia via Evolution API
NOTIFICATION_CHANNEL=email     → envia via SMTP
NOTIFICATION_CHANNEL=both      → tenta ambos
NOTIFICATION_CHANNEL=none      → registra como pendente, NÃO envia — desenvolvimento

MULTI_IASOLUX_URL=https://multi.iasolux.com.br
MULTI_INTERNAL_TOKEN=66efa8cfd3925f9efe67c565b971ad6c441ccb739960ff045f438ceb6481106f
BARBEARIA_WEBHOOK_TOKEN=<token-gerado-ao-registrar-projeto>

// Header em todas as chamadas ao multi:
{ "X-Internal-Token": "{MULTI_INTERNAL_TOKEN}" }

// externalReference — formato padrão do projeto:
"barbearia:{empresa.id}"

Endpoints do Multi

Setup Inicial (1x)

# No servidor 209:
ssh root@209.50.240.142

# Gerar token do projeto barbearia:
openssl rand -hex 32

# Editar /root/multi-iasolux/.env
# Adicionar no JSON de PROJETOS:
"barbearia": {
  "webhook": "https://barbearia.iasolux.com.br/api/webhooks/asaas",
  "token": "<token-gerado-acima>"
}

# Reiniciar:
pm2 restart multi-iasolux  # ou pm2 list pra ver o nome

# Verificar:
curl https://multi.iasolux.com.br/health
# Deve mostrar "barbearia" em projetos_registrados

Fluxo de Webhook

Asaas → POST multi.iasolux.com.br/webhook/asaas
       → multi extrai "barbearia" do externalReference
       → POST barbearia.iasolux.com.br/api/webhooks/asaas
         header: asaas-access-token: {BARBEARIA_WEBHOOK_TOKEN}

// Eventos tratados pelo barbearia:
PAYMENT_RECEIVED     → empresa.status = 'ativa', dias_atraso = 0
PAYMENT_CONFIRMED    → idem
PAYMENT_OVERDUE      → dias_atraso ≤ 5: 'inadimplente' / > 5: 'bloqueada'
PAYMENT_DELETED      → cobranca.status = 'cancelado'
PAYMENT_REFUNDED     → cobranca.status = 'estornado'
SUBSCRIPTION_DELETED → empresa.status = 'cancelada'
outros               → asaas_webhooks_log com processado=false

Documentação gerada em 2026-05-05 · barbearia.iasolux.com.br · iasolux