Painel Administrativo

O Rafobase inclui um painel administrativo web completo para gerenciar todos os aspectos do seu programa de indicação. Construído com React 19, TanStack Router e shadcn/ui, oferece uma interface moderna e responsiva.

O painel está disponível em http://localhost:5173 em desenvolvimento ou na URL configurada em produção.

🔐 Acesso

Acesse o painel usando suas credenciais de administrador:

Navegue até a URL do painel
Faça login com email e senha
Aproveite acesso completo a todas as funcionalidades

A autenticação é gerenciada pelo Better Auth com sessões seguras via cookies HTTP-only.

📊 Páginas Principais

Dashboard

Rota: /app/dashboard

O dashboard oferece uma visão geral completa do seu programa de indicação:

Métricas em Tempo Real

Total de Membros: Número de membros ativos no programa
Indicações Totais: Contagem de todas as vendas atribuídas
Comissão Total: Valor total creditado em R$
Taxa de Conversão: Percentual de membros que geraram indicações

Gráficos Interativos

Vendas por Período: Gráfico de linha mostrando tendências
Crescimento de Membros: Acompanhe o crescimento da base
Performance de Campanhas: Compare diferentes campanhas
Top Performers: Lista dos membros com mais indicações

Atividades Recentes

Feed em tempo real das últimas ações no sistema.

Membros

Rota: /app/members

Gerencie todos os membros do seu programa de indicação.

Funcionalidades

Lista de Membros

Tabela paginada com todos os membros
Ordenação por qualquer coluna (nome, email, data de cadastro, total de indicações)
Filtros avançados:
- Por nome ou email (busca)
- Por status (active, inactive, banned)
- Por campanha
- Por data de cadastro

Detalhes do Membro

Informações completas (nome, email, cupom, external_id)
Saldo da carteira (pending + available)
Histórico de indicações
Histórico de transações da carteira
Estatísticas (total indicações, conversão, comissão total)

Ações

✏️ Editar dados do membro
🚫 Banir membro (previne novas indicações)
💰 Ver detalhes da carteira
📊 Ver network de indicações

Campanhas

Rota: /app/campaigns

Configure e gerencie campanhas de recompensa.

Criar/Editar Campanha

Configurações Básicas

Nome: Identificação da campanha
Descrição: Detalhes para referência interna

Regras de Recompensa

Tipo de Recompensa:
- percentage: Percentual sobre o valor da venda (ex: 10%)
- fixed: Valor fixo em R$ (ex: R$ 50,00)
Valor da Recompensa: Quantia ou percentual
Período de Garantia: Dias antes do crédito ficar disponível (ex: 7 dias)

Anti-Fraude

Detectar Auto-Indicação: Rejeita se indicador = indicado (mesmo email)
Auto-Refund: Estorna automaticamente vendas fraudulentas

Status

✅ Ativa: Aceita novas indicações
⏸️ Inativa: Não aceita novas indicações

Estatísticas da Campanha

Total de membros vinculados
Total de indicações geradas
Comissão total paga
Taxa de aprovação vs rejeição

Indicações

Rota: /app/referrals

Acompanhe todas as vendas atribuídas por indicação.

Lista de Indicações

Colunas

Cupom usado
Membro que indicou
Valor da venda
Comissão calculada
Status (pending, approved, rejected, available, paid)
Fonte (Guru, Yampi, Manual)
Data

Filtros

Por status
Por fonte (plataforma)
Por membro
Por data
Busca por cupom ou order ID

Ações

👁️ Ver detalhes completos da venda
✅ Aprovar manualmente (se pending)
❌ Rejeitar manualmente
📄 Ver metadata da transação original

Visualização de Rede

Rota: /app/referrals/network

Visualize graficamente a rede de indicações usando um grafo interativo.

Esta é uma das funcionalidades mais poderosas do painel! Veja visualmente quem está indicando quem.

Recursos

Grafo Interativo (React Flow)

Nós: Cada nó representa um membro
- Tamanho do nó = número de indicações
- Cor = performance (verde = alto, amarelo = médio, cinza = baixo)
Edges: Linhas conectando indicador → indicado
Auto-Layout: Organização automática usando algoritmo Dagre
Zoom & Pan: Navegue livremente pelo grafo
Tooltips: Passe o mouse para ver detalhes

Filtros

Mínimo de Indicações: Exibir apenas membros com X+ indicações
Status: Filtrar por status de indicações (approved, pending, etc.)

Performance

Virtualização para redes com 1000+ membros
Carregamento otimizado

Ver mais: Visualização de Rede de Indicações

Settings

Rota: /app/settings

Configure todos os aspectos da plataforma.

General

Configurações básicas do merchant (nome, timezone, moeda).

Integrations

Guru

API Key
Marketplace (GO, Magister, Experience)
Webhook Secret
Status da conexão

Yampi

API Key
Webhook Secret
Status da conexão

Klaviyo

API Key
Status da integração
Eventos habilitados

Webhooks Outbound

Configure webhooks para enviar eventos para ferramentas externas (Zapier, n8n, CRM).

Adicionar Endpoint

URL do webhook
Eventos para enviar (selecione múltiplos):
- member.created, member.updated
- referral.created, referral.approved, referral.rejected
- wallet.credit, wallet.debit
- payout.requested
Secret para assinatura
Testar delivery