# NOVO PROJETO — PLATAFORMA DE MOBILIZAÇÃO E MÉTRICAS DE LIDERANÇAS

Quero criar um sistema totalmente novo, independente de qualquer outro projeto.

NÃO existe código anterior para aproveitar.

NÃO existe banco de dados anterior para aproveitar.

NÃO assuma que já existe integração com WhatsApp, Evolution API, Laravel ou qualquer outra infraestrutura.

O projeto deve ser estruturado do zero.

Neste primeiro momento, NÃO quero que você programe.

Quero que você analise a ideia abaixo, transforme em uma especificação técnica e crie um roteiro completo de desenvolvimento em fases.

---

# CONCEITO DO SISTEMA

O objetivo é criar uma plataforma para medir a capacidade de mobilização de diferentes lideranças através de grupos de WhatsApp.

O sistema NÃO tem como objetivo medir votos, prever votos ou identificar intenção de voto.

O objetivo é medir dados objetivos de mobilização:

* quantas pessoas uma liderança consegue trazer;

* quantas efetivamente entram no grupo;

* quantas permanecem;

* quanto tempo permanecem;

* quantas interagem com conteúdos enviados;

* quanto a base cresce;

* como a base se comporta ao longo do tempo.

A ideia é transformar uma afirmação subjetiva:

"Eu tenho 300 pessoas comigo."

em dados mensuráveis:

"Esta liderança trouxe 300 pessoas, 270 permanecem no grupo e sua base apresenta determinado nível de interação com os conteúdos."

---

# FLUXO PRINCIPAL

Cada liderança será cadastrada no sistema.

Exemplo:

Liderança:

João da Silva

O sistema gera um link exclusivo:

[https://dominio.com/l/joao](https://dominio.com/l/joao)

Outra liderança terá outro link:

[https://dominio.com/l/maria](https://dominio.com/l/maria)

Quando uma pessoa clicar no link:

1. O sistema registra o acesso.

2. Identifica qual liderança originou aquele acesso.

3. Registra data e hora.

4. Redireciona a pessoa para o convite do grupo do WhatsApp.

5. Quando possível, o sistema relaciona posteriormente a entrada dessa pessoa no grupo à liderança responsável pela indicação.

O objetivo é conseguir atribuir a origem das entradas.

---

# GRUPOS DE WHATSAPP

O sistema deverá trabalhar com grupos de WhatsApp.

Precisamos estudar a integração utilizando:

**Evolution API 2.3.7**

Mas NÃO assuma que a integração já existe.

A integração deverá ser projetada do zero.

Antes de implementar, analise a documentação e as possibilidades reais da Evolution API 2.3.7 para:

* grupos;

* participantes;

* entrada de participantes;

* saída de participantes;

* eventos;

* webhooks;

* envio de mensagens;

* identificação de grupo;

* sincronização de participantes.

Não invente endpoints ou eventos.

Caso determinada informação não possa ser obtida pela Evolution API, documente a limitação e proponha uma alternativa tecnicamente viável.

---

# RETENÇÃO

O sistema precisa acompanhar a permanência da base.

Exemplo:

Uma liderança indicou 100 pessoas.

Depois de 7 dias:

92 continuam no grupo.

Retenção de 7 dias:

92%.

Depois de 30 dias:

84 continuam.

Retenção de 30 dias:

84%.

Depois de 60 dias:

79 continuam.

Retenção de 60 dias:

79%.

O sistema precisa manter histórico suficiente para calcular essas métricas.

Não guardar apenas a quantidade atual.

Precisamos saber:

* quando entrou;

* quando saiu;

* se continua;

* período de permanência.

---

# ENVIO DE CONTEÚDOS

O sistema deverá permitir que um administrador envie conteúdos para os grupos.

Pode ser:

* texto;

* imagem;

* vídeo;

* documento;

* link.

Cada conteúdo poderá possuir um link rastreável.

Exemplo:

[https://dominio.com/r/abc123](https://dominio.com/r/abc123)

Quando alguém clicar:

1. registrar o clique;

2. registrar qual conteúdo foi acessado;

3. registrar data/hora;

4. registrar o grupo/campanha relacionado;

5. quando tecnicamente possível, relacionar a métrica à liderança de origem.

O objetivo principal é medir a mobilização da base.

---

# MÉTRICAS

O sistema deverá apresentar métricas por liderança.

Exemplo:

### Liderança João

Pessoas indicadas:

327

Pessoas atualmente no grupo:

291

Retenção:

89%

Cliques em conteúdos:

120

Crescimento da base:

+47 no período

---

# MÉTRICAS GERAIS

O dashboard geral deverá apresentar:

* quantidade de lideranças;

* total de pessoas indicadas;

* total de entradas;

* total de participantes atuais;

* total de saídas;

* retenção média;

* crescimento da base;

* quantidade de conteúdos enviados;

* quantidade de cliques;

* taxa de interação;

* evolução ao longo do tempo.

---

# RANKING DE LIDERANÇAS

Criar um ranking comparativo.

Exemplo:

| Posição | Liderança | Base | Retenção | Mobilização |

| ------- | --------- | ---: | -------: | ----------: |

| 1       | João      |  327 |      89% |          92 |

| 2       | Maria     |  241 |      84% |          87 |

| 3       | Carlos    |  189 |      91% |          85 |

O ranking deve ser baseado em indicadores mensuráveis.

NÃO apresentar isso como ranking de votos.

O conceito deve ser:

**Índice de Mobilização da Liderança.**

---

# ÍNDICE DE MOBILIZAÇÃO

Quero que você proponha uma metodologia para calcular esse índice.

Antes de criar qualquer fórmula, explique:

* quais indicadores serão utilizados;

* peso de cada indicador;

* como normalizar os dados;

* como evitar favorecer simplesmente quem possui a maior quantidade de pessoas;

* como considerar retenção;

* como considerar crescimento;

* como considerar interação com conteúdos.

A fórmula precisa ser justificável e configurável.

O índice deve representar somente:

**capacidade de mobilização observada dentro da plataforma.**

Não deve representar:

* votos;

* intenção de voto;

* apoio eleitoral;

* previsão de resultado eleitoral.

---

# DASHBOARD

Quero uma interface moderna, profissional e visual.

A plataforma deve parecer um produto de tecnologia, não uma simples tela administrativa.

Dashboard principal:

### Cards

* Lideranças

* Pessoas mobilizadas

* Participantes atuais

* Retenção média

* Conteúdos enviados

* Interações

### Gráficos

* evolução da base;

* crescimento por liderança;

* retenção;

* interação;

* desempenho dos conteúdos.

### Ranking

Ranking visual das lideranças.

### Alertas

Exemplos:

"João ganhou 47 novos participantes nos últimos 7 dias."

"Maria apresentou queda de retenção."

"Conteúdo X teve maior taxa de interação."

---

# PERFIL DA LIDERANÇA

Cada liderança deverá possuir uma página detalhada.

Exemplo:

## João da Silva

### Base

327 pessoas indicadas

291 atualmente no grupo

36 saídas

### Retenção

7 dias: 94%

30 dias: 89%

60 dias: 82%

### Mobilização

Conteúdos enviados: 24

Cliques: 1.248

Taxa de interação: XX%

### Evolução

Mostrar gráfico da evolução da base.

### Conteúdos

Mostrar os conteúdos que tiveram maior interação.

### Histórico

Mostrar crescimento e perdas ao longo do tempo.

---

# RELATÓRIOS

Criar possibilidade de gerar relatórios.

Exemplo:

**Relatório semanal**

Período:

01/08/2026 até 07/08/2026

Resumo:

* novas pessoas;

* saídas;

* retenção;

* crescimento;

* conteúdos enviados;

* interações;

* evolução das lideranças.

Também estudar possibilidade de exportação para:

* PDF;

* Excel/CSV.

---

# ARQUITETURA

O projeto deve ser pensado desde o início para crescer.

Inicialmente:

aproximadamente 10 lideranças.

Mas posteriormente poderá chegar a:

100;

500;

1.000 ou mais.

Não criar uma arquitetura que funcione somente para poucos usuários.

Avaliar:

* filas;

* jobs;

* cache;

* processamento assíncrono;

* banco de dados indexado;

* webhooks;

* processamento de eventos;

* agregação de métricas.

Eventos recebidos da Evolution API devem ser processados de maneira idempotente.

Se o mesmo evento for recebido duas vezes, não poderá duplicar os registros.

---

# PRIVACIDADE E LGPD

O sistema deve trabalhar com minimização de dados.

Não coletar dados pessoais desnecessários.

Quando for necessário utilizar identificadores de WhatsApp para conciliar entradas e participantes, analisar a melhor estratégia técnica para:

* hash;

* criptografia;

* identificadores internos;

* controle de acesso;

* retenção de dados.

As métricas devem priorizar dados agregados.

---

# TECNOLOGIA

Você deve propor a stack mais adequada para este projeto.

Tenho preferência por:

Backend:

Laravel/PHP

Processamento:

Python quando realmente fizer sentido.

Banco:

MySQL ou PostgreSQL, escolhendo o mais adequado.

Frontend:

proponha a melhor opção considerando desenvolvimento rápido, manutenção e dashboard moderno.

WhatsApp:

Evolution API 2.3.7.

Mas NÃO considere essas tecnologias obrigatórias se houver uma justificativa técnica melhor.

Explique as escolhas.

---

# PRIMEIRA ETAPA — NÃO PROGRAMAR

Neste primeiro momento, quero somente planejamento.

Faça uma análise completa da ideia e entregue:

## 1. Arquitetura geral

Mostre como os componentes conversarão.

## 2. Fluxo completo

Desde:

Liderança cadastrada

↓

Link exclusivo

↓

Pessoa acessa

↓

Sistema registra origem

↓

WhatsApp

↓

Entrada no grupo

↓

Evento da Evolution API

↓

Registro da entrada

↓

Acompanhamento de permanência

↓

Envio de conteúdo

↓

Clique/interação

↓

Métricas

↓

Índice de mobilização

↓

Dashboard

↓

Relatório

## 3. Modelo de banco

Proponha todas as tabelas necessárias.

Para cada tabela informe:

* nome;

* finalidade;

* campos;

* tipos;

* índices;

* relacionamentos.

## 4. API

Liste os endpoints necessários.

## 5. Webhooks

Liste os eventos necessários da Evolution API.

## 6. Jobs e filas

Defina quais processos devem ser assíncronos.

## 7. Segurança

Defina autenticação, autorização e proteção dos links.

## 8. LGPD

Defina quais dados realmente precisam ser armazenados.

## 9. Dashboard

Descreva todas as telas.

## 10. Índice de mobilização

Proponha a metodologia e fórmula.

## 11. Roadmap

Divida o desenvolvimento em fases pequenas.

Sugestão:

FASE 1 — Estrutura inicial

FASE 2 — Banco de dados

FASE 3 — Cadastro de lideranças

FASE 4 — Links exclusivos

FASE 5 — Integração Evolution API

FASE 6 — Grupos e participantes

FASE 7 — Histórico e retenção

FASE 8 — Sistema de conteúdos

FASE 9 — Links rastreáveis

FASE 10 — Métricas

FASE 11 — Índice de mobilização

FASE 12 — Dashboard

FASE 13 — Relatórios

FASE 14 — Testes

FASE 15 — Produção

Pode alterar essas fases se encontrar uma organização melhor.

---

# REGRA FUNDAMENTAL

NÃO escreva código agora.

NÃO crie arquivos agora.

NÃO execute migrations agora.

NÃO instale dependências agora.

Primeiro quero somente o planejamento técnico completo.

Depois que eu analisar e aprovar o roteiro, vamos desenvolver uma fase por vez.

Em cada fase:

1. explicar o que será desenvolvido;

2. criar/alterar somente o necessário;

3. testar;

4. informar arquivos alterados;

5. informar como validar;

6. verificar segurança e possíveis problemas;

7. somente depois aguardar autorização para próxima fase.

Este é um projeto NOVO e INDEPENDENTE.

Não faça referência a outros sistemas ou projetos existentes.

Comece agora pela análise da arquitetura e pelo roteiro técnico.