Visão geral do sistema
O PromoDash organiza o trabalho do afiliado em camadas que se conectam. O diagrama resume como organização (tenant), lojas de origem, minha loja, produto, cupom, categoria, integração, canais, webhooks e IA (Promi) se relacionam:
Peças principais
Organização (workspace)
Tudo pertence a uma organização. Usuários podem participar de várias organizações e alternar entre elas no header.
Loja de origem
Representa o marketplace onde a oferta existe (Amazon, Mercado Livre, Magalu, Awin, etc.). Guarda domínio, tipo de integração e credenciais para:
- Extrair nome, preço e imagem a partir da URL (OAuth no Mercado Livre, scrape ou API conforme o tipo)
- Gerar o link de afiliado quando o marketplace suporta integração automática (Amazon, Shopee, Awin, etc.)
Marketplaces como Mercado Livre e Magazine Luiza não geram link de afiliado no PromoDash — o afiliado informa o link manualmente no produto.
Minha loja (loja / perfil público)
É o seu perfil de afiliado: nome, slug, cores, SEO e vitrine online. Os visitantes veem seus produtos em {SHOWCASE_BASE}/{slug}.
Produto
Une loja de origem + minha loja + dados comerciais (preço, mensagem, cupom, categoria) e define se vai para vitrine e para quais canais.
Integração e canal
- Integração: conexão com a API da rede (ex.: WhatsApp via Evolution)
- Canal: destino específico (grupo WhatsApp, etc.) ligado a uma integração
Cupom e categoria
Opcionais. Cupons podem ser restritos a certas lojas de origem. Categorias organizam a vitrine e filtros.
Webhooks
Notificações HTTP quando recursos mudam (produto criado, loja atualizada, etc.) — ideal para automações externas.
Promi (IA)
Assistente com OpenAI para gerar mensagens de promoção (planos Pro+).
Resumo do painel (/dashboard)
- KPIs de produtos, cupons expirando, webhooks e origens conectadas
- Gráficos por período (7 / 30 / 90 dias)
- Tabela dos últimos produtos e atalhos: novo produto, webhook, cupons