Escopo

1. Objetivo Geral

Criar uma plataforma completa para o Loyalty Reward Program da Biohelp, composta por:

• Painel Administrativo (Backoffice Biohelp)
  Para operação, auditoria, gestão das parceiras, comissões e regras do programa.
• Painel Individual de Parceira (Partner Portal)
  Para visualização de performance, comissões, rede, saques e acompanhamento dos bônus.
• Integrações com E-commerce + ERP + Gateway de Pagamento
  Para rastreamento de links, cálculo de comissões, elegibilidade, notas fiscais e transferências automáticas.

2. Módulos do Sistema

MÓDULO A — Afiliação & Fluxo de Entrada

2.1. Link de Afiliação / Parceria

• Geração automática de link único por Parceira.
• Rastreio de visitas, cliques e pedidos gerados via link.

2.2. Visitante Anônima no E-commerce

• Detecção do link de origem (parâmetros UTM ou ID único).
• Exibição de tabela dupla de preço:
  • Preço comum
  • Preço Parceira (para quem se cadastrar)

2.3. Fluxo de Inscrição Instantânea

• Visitante escolhe o preço da Parceira → é levada ao cadastro.
• Criação imediata do perfil de Parceira.
• Liberação instantânea do desconto no produto + acesso ao painel.
• Autenticação via:
  • Magic Link por e-mail ou
  • Código temporário (OTP).

MÓDULO B — Fast-Track Commissions

2.4. Cálculo automático

• 50% sobre o CV de todas as vendas dos primeiros 30 dias.
• 30% de CV entre os dias 31–60.
• Regra configurável no painel Admin.

2.5. Visão para parceira

• Timeline com datas de encerramento das janelas de fast-track.
• Lista de pedidos com:
  • Produto
  • CV por item
  • Comissão gerada
  • Status (pendente, confirmado, cancelado)

MÓDULO C — Estrutura de Rede e Níveis

2.6. Regras de Progressão

• A parceira se torna Líder ao atingir:
  • 3 parceiras ativas
  • Cada uma com R$200/mês de CV ativo
• Para se tornar Diretora:
  • 40 parceiras ativas na rede total
  • 5 dessas devem ser Líderes
• Head (regra futura, mas estrutura preparada)

2.7. Visualização da Rede

• Árvore hierárquica com múltiplos níveis.
• Busca por membro da rede.
• Indicadores:
  • Parceiras ativas
  • CV total da rede
  • Quantas líderes a parceira possui na base
  • Profundidade da rede

MÓDULO D — Comissão Perpétua

2.8. Regras (Tabela da Biohelp)

• Porcentagem variável conforme profundidade da rede.
• Configuração no painel admin.
• Cálculo automático diário/horário.

2.9. Painel para Parceira

• CV gerado por nível.
• Gráfico de crescimento da rede.
• Total acumulado por mês.

MÓDULO E — Triple3 e Leadership Bonus

2.10. Triple3

• Marco 1 → 3 parceiras ativas → bônus R$200
• Marco 2 → rede com líderes ativas → bônus R$1.700
• Marco 3 → estrutura maior → bônus R$8.200
• Registro automático e validação por quantidade mínima de CV.

2.11. Leadership Bonus

• Percentual do CV global distribuído entre:
  • Top 1% de cada nível (Líderes, Diretoras, Head)
• Cálculo mensal.
• Ranking dentro do painel da parceira.

MÓDULO F — Saques e Compliance

2.12. Perfil da Parceira

• Cadastro como:
  • Pessoa Física
  • MEI
  • Outro tipo de PJ

2.13. Regras de Saque

Pessoa Física

• Limite máximo por saque.
• Geração automática de RPA via ERP integrado.
• Valor disponível já vem com impostos e taxas deduzidos.

MEI / PJ

• Upload da NFe.
• Validação:
  • CNPJ
  • Valor da nota
  • Natureza da operação
• Liberação para saque após conferência automática.

2.14. Integração Financeira (próxima fase)

• Envio automático de ordens de pagamento via API do banco/PSP.
• Registro de logs e comprovantes.
• Histórico completo de saques.

MÓDULO G — Painel da Parceira

2.15. Dashboard Principal

• Resumo de:
  • Vendas com link direto
  • Comissões Fast-Track
  • Comissões Perpétuas
  • Triple3
  • Leadership Bonus
  • Status (Parceira, Líder, Diretora, Head)
  • CV mensal pessoal e da rede

2.16. Seções completas

• Minhas vendas
• Minha rede
• Minhas indicações
• Meus saques
• Metas do próximo nível
• Materiais de divulgação
• Link de parceira

MÓDULO H — Painel Admin Biohelp

2.17. Gestão de Parceiras

• CRUD de parceiras
• Status (ativa, bloqueada, em auditoria)
• Ver árvore completa
• Histórico de comissões
• CV consolidado

2.18. Gestão de Produtos

• Cadastro de CV por produto
• Edição de CV sem mexer no preço da loja
• Histórico de alterações

2.19. Gestão de Regras de Comissão

• Fast-track
• Tabela de Comissão Perpétua
• Triple3
• Leadership Bonus
• Limite de saque PF
• Configurações fiscais por tipo de pessoa

2.20. Gestão Financeira

• Auditoria de saques
• Integração com ERP (RPA, notas, pagamentos)
• Exportações CSV/Excel
• Relatórios de CV e receita

2.21. Gestão de Materiais

• Upload de PDFs, posts, kits de mídia
• Biblioteca para parceiras

MÓDULO I — Integrações

2.22. ERP

• Emissão de RPA
• Validação de NFe
• Controle financeiro
• Geração de relatórios

2.23. E-commerce

• Shopify
• Registro de cada pedido com:
  • CV
  • Parceira responsável
  • Origem (link rastreado)

2.24. Gateway de Pagamento - próxima fase

• Transferência automática
• Cálculo e dedução de taxas
• Logs

‍