# LucreShop (Full Documentation Context) > Plataforma SaaS de automação comercial e inteligência de dados para marketing de afiliados nos principais marketplaces do Brasil (Mercado Livre, Shopee, Amazon e Magazine Luiza). --- ## 1. Visão Geral e Proposta de Valor O **LucreShop** é uma plataforma SaaS projetada para que afiliados profissionais, agências e criadores de conteúdo automatizem o processo de captura, conversão, formatação e distribuição de ofertas e cupons promocionais. A plataforma conecta-se com Mercado Livre, Shopee, Amazon e Magazine Luiza, enviando mensagens estruturadas para grupos de WhatsApp, canais de Telegram e Direct do Instagram (Comment-to-DM e Boas-Vindas), além de fornecer lojas vitrines públicas com Server-Side Rendering (SSR), landing pages de captura, painel de análise financeira com calculadora de ROI, Programa de Parceiros (Indique e Ganhe) e emissão de notas fiscais de serviço (NFS-e). --- ## 2. Tabela Oficial de Planos e Preços O LucreShop oferece 5 planos com 3 dias de teste grátis no cadastro sem necessidade de cartão de crédito (`DIAS_PLANO_GRATUITO_DEFAULT = 3`): | Recurso / Limite | Meu Primeiro Grupo | Grupo em Crescimento | Start | Pro (Recomendado) | Elite | | :--- | :--- | :--- | :--- | :--- | :--- | | **Preço Mensal** | **R$ 29,90** | **R$ 59,90** | **R$ 95,00** | **R$ 185,00** | **R$ 530,00** | | **Instâncias WhatsApp** | 1 número | 1 número | 1 número | 2 números | 5 números | | **Grupos/Canais WhatsApp** | 1 grupo | Até 3 grupos | Até 8 grupos | Até 10 por número (20 total) | Até 20 por número (100 total) | | **Instâncias Telegram** | 1 canal | 1 canal | 2 canais | 2 canais | 2 canais | | **Vitrines de Lojas** | 1 loja | 1 loja | 1 loja | 2 lojas (segmentação) | 4 lojas | | **Landing Pages** | 1 LP | **3 LPs** | **5 LPs** | **5 LPs** | **10 LPs** | | **Instagram Comment & Welcome DM** | 1 regra | **3 regras** | **10 regras** | **🚀 ILIMITADO (`-1`)** | **🚀 ILIMITADO (`-1`)** | | **Espelhamentos (Monitoramentos)** | 1 ativo | **3 ativos** | **5 ativos** | **🚀 ILIMITADO (`-1`)** | **🚀 ILIMITADO (`-1`)** | | **Bots de Nicho** | 1 ativo | **3 ativos** | **5 ativos** | **10 ativos** | **10 ativos** | | **Campanhas de Envio** | 1 ativa | **3 ativas** | **5 ativas** | **10 ativas** | **10 ativas** | | **Links Inteligentes WhatsApp** | 1 link | **3 links** | **5 links** | **10 links** | **10 links** | | **Análise Financeira & ROI** | Calculadora geral | Calculadora geral | ROI por canal | ROI detalhado por grupo | ROI multi-operações | | **Relatório Shopee** | Relatório completo | Relatório completo | Relatório completo | Relatório completo | Relatório completo | | **Programa de Parceiros** | Inclusão de afiliados | Inclusão de afiliados | Inclusão de afiliados | Inclusão de afiliados | Inclusão de afiliados | | **Marketplaces Integrados** | ML, Shopee, Amazon, Magalu | ML, Shopee, Amazon, Magalu | ML, Shopee, Amazon, Magalu | ML, Shopee, Amazon, Magalu | ML, Shopee, Amazon, Magalu | | **Diferenciais** | Relatórios de cliques e WhatsApp | Relatórios de cliques e WhatsApp | Integração Pixel/GTM, Rotação de link, Rastreio DDD | Tudo do Start, Instagram e Espelhamento Ilimitados, 2 Lojas | Tudo do Pro, 100 Grupos WhatsApp, Automação corporativa | | **Suporte** | Suporte Padrão | Suporte Padrão | Suporte via WhatsApp | Suporte via WhatsApp | Suporte Prioritário dedicado | --- ## 3. Módulos e Funcionalidades ### 1. Painel Geral & Onboarding Dashboard em tempo real consolidando métricas de campanhas, bots, espelhamentos, links, instâncias ativas e total de membros monitorados, com checklist de configuração passo a passo para novos usuários. ### 2. Busca de Produtos e Curadoria Multiloja Hub de curadoria com conexão à API oficial da Shopee (filtros por comissão, marca, preço), fila de seleção local com botão de embaralhar (Shuffle) e importação massiva de planilhas CSV com hidratação assíncrona de fotos em lotes de 50 produtos. ### 3. Campanhas de Envio Automático & Cooldown Anti-Spam Automação de postagens programadas para WhatsApp e Telegram com horários de início/fim, dias da semana, cooldown de segurança (tempo de espera entre envios), embaralhamento Fisher-Yates de itens pendentes e travas transacionais no PostgreSQL. ### 4. Backfill de Fila em Lote Envio rápido de dezenas de ofertas selecionadas diretamente para filas de campanhas ativas aplicando templates customizados de copy e links comissionados. ### 5. Bots de Nicho 100% Autônomos Robôs autônomos que filtram ofertas raspadas por categorias (Eletrodomésticos, Smartphones, Beleza, Moda, Pet, Casa) e publicam automaticamente nos canais respeitando um cache anti-duplicidade (`sentOfferCacheDocumentIds`). ### 6. Espelhamento / Monitoramento de Grupos com Google Gemini (ILIMITADO no Pro/Elite) Monitoramento em tempo real de canais de referência sem teto de limite nos planos Pro e Elite. Clona mensagens recebidas via `lucreshop-robo-copy`, converte os links para o código de afiliado do usuário e utiliza o modelo Google Gemini para reescrever a copy por completo de forma atrativa e persuasiva. ### 7. Landing Pages de Alta Conversão com Quiz Gate Páginas de captura otimizadas para tráfego pago com editor visual, efeitos de animação no botão CTA, Quiz interativo para qualificar leads, injeção de Facebook Pixel / GTM e cookies de proteção anti-inflação de visualizações. ### 8. Automação Instagram: Comment-to-DM & Boas-Vindas (ILIMITADO no Pro/Elite) Automação oficial conectada via Meta Graph API sem limite de regras nos planos Pro e Elite. Escuta comentários em posts/Reels por palavras-chave ("QUERO", "CUPOM") com resposta pública e envio de DM privada. Envia saudações automáticas para novos seguidores com botões interativos, links diretos e atraso configurável com limite diário anti-bloqueio. ### 9. Shopee Performance & Meta Ads CAPI Módulo avançado de BI para afiliados que rodam anúncios. Conecta compras confirmadas na Shopee com o `fbclid` e envia eventos `Purchase` via servidor para a Meta Conversions API (CAPI), calculando ROAS real e oferecendo IA para otimizar copies de anúncios. ### 10. Monitoramento de Saúde de Destinos Diagnóstico preventivo que detecta instâncias de WhatsApp desconectadas (`INSTANCE_DISCONNECTED`) e grupos inativados antes que os envios falhem. ### 11. Gestão e Criação de Grupos de WhatsApp Criação de novos grupos de WhatsApp diretamente no navegador com permissão "Somente Administradores" (`announcement`), sincronização em 1 clique (`Refresh Groups`) e compressão automática de fotos via HTML Canvas. ### 12. Comunicar (Disparo Manual e Agendamento) Editor rich-text com Live Preview emulando balão real de WhatsApp para envio imediato ou agendamento de avisos e cupons pontuais (isentos do cômputo de limite de campanhas do plano). ### 13. Modelos de Promoção com Tags Dinâmicas Padronização de mensagens de ofertas com substituição dinâmica de `{TITULO_PRODUTO}`, `{PRECO_PRODUTO}`, `{PRECO_ANTIGO}`, `{DESCONTO_PRODUTO}`, `{LINK_PRODUTO}`, `{FRETE_GRATIS}`, `{CUPOM}`, `{MARKETPLACE}` e mockup Galaxy S25 em tempo real. ### 14. Central de Cupons (Coupon Hub) Listagem e distribuição de cupons atualizados das 4 lojas parceiras com banners customizados e envio direto para campanhas. ### 15. Relatório WhatsApp por DDD Mapeamento geográfico demográfico dos membros de grupos com renderização de mapa coroplético do Brasil por densidade de contatos. ### 16. Relatório de Cliques e Performance de Ofertas BI detalhado com métricas de cliques, rankings por canal, produto e marketplace, com filtro de calendário personalizado. ### 17. Relatório Shopee e Auditoria de Conversões Painel de auditoria e reconciliação financeira de pedidos, comissões confirmadas, cancelamentos e devoluções da Shopee por canal de divulgação. ### 18. Análise Financeira & Calculadora de ROI do WhatsApp Módulo dedicado (`/analise-financeira`) alimentado pela API de relatórios (`/reports/whatsapp-financial`). Permite o cadastro de investimentos em tráfego pago e anúncios, cruzamento automático com comissões de e-commerces parceiros e cálculo do CPE (Custo por Entrada de participante no WhatsApp) e ROI % detalhado por grupo e canal. ### 19. Links Inteligentes WhatsApp com Rotação (Overflow) Link único de redirecionamento que transborda o tráfego automaticamente para o próximo grupo da fila quando o primeiro lota, disparando eventos de Pixel e Analytics. ### 20. Link Preview no WhatsApp Envio de postagens com cards visuais interativos Open Graph, incluindo título da prévia customizável por canal. ### 21. Telemetria de Conversão e Rastreamento Offline Captura de UTMs, `gclid`, `fbclid` e cookies `_fbc`/`_fbp` com retenção offline no navegador (`LocalStorage Bridge`) e envio assíncrono para o servidor Spring. ### 22. Loja com Vitrine de Produtos (Multi-Tenant SSR & SEO) Portal completo de ofertas rodando em domínio próprio do afiliado, renderizado via Angular SSR com marcação semântica JSON-LD (`Organization`, `WebSite`, `BreadcrumbList`) para indexação no Google. ### 23. Extensão de Navegador Chrome (LucreShop Link Afiliado) Extensão de navegador em Plasmo/React que detecta produtos no Amazon, Mercado Livre, Magalu e Shopee, extraindo fotos, títulos e cupons e enviando para o painel LucreShop via `window.postMessage`. ### 24. Sistema de Assinaturas e Checkout Stripe Faturamento recorrente automatizado com upgrade proporcional imediato (prorata), downgrade agendado para o fim do ciclo e sincronização bidirecional por Webhooks da Stripe. ### 25. Programa de Parceiros / Indique e Ganhe (Comissões Recorrentes & RPA em PDF) Programa de afiliação integrado ao LucreShop com comissões recorrentes sobre assinaturas ativas geradas pelo link de convite do parceiro, com solicitação de saque via PIX e geração automática de Recibo de Pagamento a Autônomo (RPA) em PDF com cálculo de retenções fiscais legais. ### 26. Módulo Fiscal e Emissão de NFS-e (Nacional e São Paulo) Emissão automatizada de Notas Fiscais de Serviço Eletrônicas para as assinaturas da plataforma LucreShop e comissões extras de intermediação comercial da Shopee com validação prévia de CPF, telefone e endereço via CEP. --- ## 4. Stack Tecnológica - **Linguagens e Frameworks:** Java 21, Spring Boot 3 (WebFlux, Data, Security, AI), TypeScript, Angular 18 (SSR), React 18 (Plasmo Chrome Extension). - **Armazenamento de Dados:** PostgreSQL 16 (Relacional/Transacional com `SKIP LOCKED`), Google Cloud Firestore (Documentos/Tempo Real), Redis (Cache/Sessões), Firebase Storage (Mídia). - **APIs Externas Integradas:** Evolution API / WAHA (WhatsApp), Telegram Bot API, Meta Graph API (Instagram/Facebook CAPI), Stripe API, Shopee Open API, Google Gemini AI (Vertex AI / Spring AI), SEFIN Nacional e Prefeitura de São Paulo (NFS-e).