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, blocked)
- Por campanha
- Por data de cadastro

Detalhes do Membro

Informações completas (nome, email, cupom, externalId)
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

Tiny ERP

API Token
Configuração de seedings (produto padrão, transportadora, forma de pagamento)
Categorias financeiras para controle de custos

Discord

Webhook URL para notificações da equipe
Relatórios semanais automáticos (toda segunda-feira)

Instagram

Status de conexão OAuth
Conta conectada e expiração do token

Resend (Email Transacional)

Emails de reset de senha
Convites para novos membros da equipe
Configuração automática (sem ação necessária do admin)

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

Monitoramento

Ver logs de todas as entregas
Status: delivered, failed, retrying
Retry automático com backoff exponencial

Developers

API Keys

Gerar novas API keys
Ver keys existentes (parcialmente mascaradas)
Revogar keys

Documentação

Links para API reference
Exemplos de integração
Webhooks payload samples

Analytics

Rota: /app/analytics

Métricas detalhadas e relatórios customizados.

Funcionalidades

Seleção de Período

Últimos 7 dias
Últimos 30 dias
Últimos 90 dias
Custom range

Métricas Disponíveis

Crescimento de membros ao longo do tempo
Vendas atribuídas por período
Comissão paga vs pendente
Taxa de conversão
Performance por campanha
Performance por fonte (Guru vs Yampi)

Gráficos

Linha: Tendências ao longo do tempo
Barra: Comparações
Pizza: Distribuições

Creators

Rota: /app/creators

Gerencie creators e influenciadores do seu programa.

Perfis de Creators

Dados pessoais (nome, email, telefone, CPF, chave PIX)
Redes sociais (Instagram, TikTok com contagem de seguidores)
Tipo: creator, ugc_creator, internal
Status: prospecting, negotiating, active, paused, churned
Contrato: commission, barter, fixed, fixed_plus_commission

Funcionalidades

Lista paginada com filtros por status, tier, nicho, programa
Busca por nome, email ou username
Sincronização de cupom com Guru/Yampi
Perfil público via token único

Creator Programs

Rota: /app/creator-programs

Configure programas alternativos de recompensa para creators:

Nome e descrição do programa
Tipo de recompensa (percentual ou fixo)
Valor da recompensa e período de garantia
Limites de valor mínimo e máximo
Configurações específicas por plataforma

Commission Tiers

Rota: /app/commission-tiers

Defina tiers de comissão progressivos baseados em vendas:

Nome e slug do tier (ex: Bronze, Prata, Ouro)
Posição: Ordem hierárquica
Vendas mínimas: Threshold para atingir o tier
Taxa de comissão: Percentual (ex: 10%, 15%, 20%)
Seedings mensais: Máximo de produtos por mês

Creators são automaticamente promovidos quando atingem o threshold de vendas.

Creator Payouts

Rota: /app/creator-payouts

Calcule e gerencie pagamentos de creators:

Agregação de vendas aprovadas por período
Cálculo de comissão com taxa da plataforma
Fluxo de status: draft → pending_invoice → invoice_received → processing → paid
Método de pagamento: PIX manual, PIX Woovi, transferência
Upload de comprovante e tracking de NF