# ROADMAP DE DESENVOLVIMENTO - VIRAL SOCIAL PRO 2026
## 12 Modulos Micro-SaaS | Monolito Modular | Plano de Execucao

> **Documento de referencia para o Claude Code** - Sempre que perder contexto, consulte esta pagina.
> Ultima atualizacao: 2026-03-14 (atualizado com IAs locais gratuitas)
> URL: https://viral.chatys.com.br/roadmap-dev

---

# STATUS GERAL DO PROJETO

| Metrica | Valor |
|---------|-------|
| **Total de Modulos** | 12 micro-SaaS |
| **Total de Features** | 603+ funcionalidades |
| **Modulos Concluidos** | 0 de 12 |
| **Features Implementadas** | ~120 (base existente) |
| **Arquitetura** | Monolito Modular (1 projeto, modulos ativaveis) |
| **Stack** | FastAPI + SQLAlchemy + SQLite + Jinja2 + Tailwind + Alpine.js |
| **Repositorio** | github.com/glaukocarvalho/viral-social |
| **Servidor** | Ubuntu, usuario glauko, nginx + SSL |
| **Dominio** | viral.chatys.com.br |

---

# RECURSOS DO SERVIDOR

| Recurso | Valor |
|---------|-------|
| **RAM** | 8 GB (7.8 GB disponivel) |
| **CPU** | AMD EPYC 9354P - 2 cores, x86_64 |
| **Disco** | 96 GB total, 75 GB livre |
| **GPU** | NENHUMA (CPU-only) |
| **OS** | Ubuntu Linux 6.8 |
| **Swap** | 0 (sem swap configurado) |

> **IMPORTANTE:** Todas as IAs locais devem funcionar em CPU com no maximo 4-5GB de RAM
> (os outros 3GB sao para o sistema + FastAPI + banco de dados)

---

# IAs LOCAIS 100% GRATUITAS

> Estrategia: usar IAs locais para TUDO que for possivel, eliminando custos de API.
> Custo total: R$0/mes. Apenas disco e CPU do servidor que ja temos.

## SERVIDOR DE IA: Ollama

**O que e:** Servidor local de modelos de IA com API compativel com OpenAI.
**Por que:** Instala modelos com 1 comando, API REST pronta, leve, CPU-optimizado.

```bash
# Instalacao (1 comando)
curl -fsSL https://ollama.com/install.sh | sh

# API fica em http://localhost:11434
# Compativel com formato OpenAI (facil de integrar)
```

| Configuracao | Valor |
|-------------|-------|
| Porta | 11434 |
| API | OpenAI-compatible |
| Modelos | 100+ disponiveis |
| Atualizacao | `ollama pull modelo` |

---

## 1. LLM - Geracao de Texto, Scripts, Analise

> Substitui: Claude API ($3-15/M tokens), GPT-4 ($2.50-10/M tokens)
> Economia estimada: R$50-200/mes

| Modelo | Parametros | RAM | Velocidade CPU | Qualidade | Licenca | Uso |
|--------|-----------|-----|---------------|-----------|---------|-----|
| **Qwen 2.5 3B Q4** | 3B | ~3 GB | 10-20 tok/s | Muito boa | Apache 2.0 | **PRINCIPAL** |
| **Phi-3 Mini Q4** | 3.8B | ~3 GB | 5-10 tok/s | Excelente raciocinio | MIT | Scripts complexos |
| **Qwen 2.5 1.5B Q4** | 1.5B | ~1.5 GB | 15-25 tok/s | Boa | Apache 2.0 | Tarefas simples |
| **DeepSeek R1 1.5B** | 1.5B | ~2 GB | 10-15 tok/s | Otima logica | MIT | Analise |
| **SmolLM2 1.7B** | 1.7B | ~2 GB | 10-15 tok/s | Supera Qwen 1.5B | Apache 2.0 | Alternativa |

```bash
# Instalar modelo principal
ollama pull qwen2.5:3b

# Testar
ollama run qwen2.5:3b "Gere um roteiro de 30 segundos sobre construcao IA"

# Usar via API (formato OpenAI)
curl http://localhost:11434/v1/chat/completions \
  -d '{"model": "qwen2.5:3b", "messages": [{"role": "user", "content": "Ola"}]}'
```

**Onde usar nos modulos:**
- **ViralScan:** Analise de script (hook/problema/solucao/CTA)
- **TrendRadar:** Resumos de tendencias, previsoes
- **ScriptGenius:** Geracao de roteiros, hooks, CTAs, rewriter
- **ShopIntel:** Analise de reviews, descricoes de produtos
- **SpyCompetitor:** Analise de gap, reverse-engineering
- **DarkFactory:** Roteiros de videos longos
- **EngageBot:** Respostas automaticas a comentarios/DMs
- **ViralAcademy:** AI Growth Coach, recomendacoes

**Qualidade vs APIs pagas:** Modelos 3B sao equivalentes ao GPT-3.5 para tarefas simples (resumos, classificacao, geracao basica). Para analises muito complexas, ficam atras do GPT-4/Claude, mas sao suficientes para 80% dos casos de uso da plataforma.

---

## 2. TTS - Text-to-Speech (Voz Sintetizada)

> Substitui: ElevenLabs ($5-330/mes), Murf.ai, Speechify
> Economia estimada: R$25-150/mes

| Modelo | Tamanho | RAM | Velocidade CPU | Qualidade | Licenca |
|--------|---------|-----|---------------|-----------|---------|
| **Kokoro-82M** | 350 MB | ~2 GB | 3-11x tempo real | **#1 no TTS Arena** | Apache 2.0 |
| **Piper TTS** | 50-200 MB | <1 GB | Tempo real+ | Boa | MIT |
| **MeloTTS** | Pequeno | ~1 GB | Tempo real | Boa multilingual | MIT |

```bash
# Kokoro - MELHOR qualidade (82M parametros, roda em CPU!)
pip install kokoro

# Piper - MAIS leve (roda ate em Raspberry Pi)
pip install piper-tts
```

```python
# Exemplo Kokoro
from kokoro import KokoroPipeline
pipeline = KokoroPipeline(lang_code='p')  # portugues
audio = pipeline("Bem-vindo ao Viral Social Pro!")
# Salva em WAV/MP3

# Exemplo Piper (ultra-leve)
import subprocess
subprocess.run(['piper', '--model', 'pt_BR-faber-medium', '--output_file', 'audio.wav'],
               input='Texto aqui', text=True)
```

**Onde usar nos modulos:**
- **ScriptGenius:** Narrar roteiros gerados
- **DarkFactory:** Narracao de videos longos (dark channels)
- **ViralAcademy:** Audio-aulas do curso

**Kokoro-82M e especial:** Com apenas 82 milhoes de parametros (350MB), ficou em #1 no ranking TTS Arena, batendo modelos muito maiores. Roda 3-11x mais rapido que tempo real em CPU. Qualidade proxima ao ElevenLabs para narracoes.

---

## 3. STT - Speech-to-Text (Transcricao)

> Substitui: Whisper API ($0.006/min), AssemblyAI ($0.12/min), Deepgram
> Economia estimada: R$20-100/mes

| Modelo | Tamanho | RAM | Velocidade CPU | Qualidade | Licenca |
|--------|---------|-----|---------------|-----------|---------|
| **faster-whisper small INT8** | 500 MB | ~2 GB | ~1x tempo real | Muito boa | MIT |
| **faster-whisper base INT8** | 150 MB | ~1 GB | 2-3x tempo real | Boa | MIT |
| **faster-whisper tiny** | 75 MB | ~1 GB | 5x+ tempo real | Basica | MIT |

```bash
pip install faster-whisper
```

```python
from faster_whisper import WhisperModel

# Modelo small = melhor custo-beneficio para nosso servidor
model = WhisperModel("small", device="cpu", compute_type="int8")

# Transcrever video/audio
segments, info = model.transcribe("video_audio.mp3", language="pt")
for segment in segments:
    print(f"[{segment.start:.1f}s - {segment.end:.1f}s] {segment.text}")
```

**Onde usar nos modulos:**
- **ViralScan:** Transcrever audio de videos virais para analise de script
- **ScriptGenius:** Transcrever videos de referencia
- **SpyCompetitor:** Transcrever videos de concorrentes
- **DarkFactory:** QA de narracao gerada

**Velocidade:** 1 minuto de audio ≈ 1 minuto de processamento (modelo small). Para videos curtos (30-60s), e praticamente instantaneo.

---

## 4. Traducao

> Substitui: DeepL API ($5.49/mes + $25/M chars), Google Translate API ($20/M chars)
> Economia estimada: R$25-50/mes

| Ferramenta | RAM | Idiomas | Velocidade | Licenca |
|-----------|-----|---------|-----------|---------|
| **LibreTranslate** | ~4 GB | 30+ (incl. PT) | 100-120 chars/s | AGPL |
| **Argos Translate** | ~2 GB/par | 30+ | Rapida | MIT |
| **NLLB-200 600M** | ~3 GB | 200 idiomas | Boa | CC-BY-NC* |

```bash
# LibreTranslate via Docker (RECOMENDADO - mais facil)
docker run -d -p 5000:5000 libretranslate/libretranslate

# Ou instalar direto
pip install libretranslate
libretranslate --host 0.0.0.0 --port 5000
```

```python
import requests

# API REST simples
response = requests.post("http://localhost:5000/translate", json={
    "q": "This video went viral with 10 million views",
    "source": "en",
    "target": "pt"
})
print(response.json()["translatedText"])
# "Este video viralizou com 10 milhoes de visualizacoes"
```

**Onde usar nos modulos:**
- **ViralScan:** Traduzir titulos/descricoes de videos internacionais
- **TrendRadar:** Traduzir tendencias globais para PT
- **ScriptGenius:** Tradutor de scripts (EN<->PT)
- **ShopIntel:** Traduzir nomes/descricoes de produtos

**Nota:** *NLLB-200 tem licenca nao-comercial. Para uso comercial, usar LibreTranslate (AGPL) ou Argos (MIT).*

---

## 5. Analise de Sentimento / NLP

> Substitui: APIs de NLP pagas, Google NLP API
> Economia estimada: R$10-30/mes

| Ferramenta | RAM | Velocidade | Qualidade | Licenca |
|-----------|-----|-----------|-----------|---------|
| **VADER (NLTK)** | <100 MB | Instantanea | 85% (social media) | MIT |
| **DistilBERT sentiment** | ~500 MB | Rapida | 93% | Apache 2.0 |
| **cardiffnlp/twitter-roberta** | ~500 MB | Rapida | Melhor p/ social | MIT |

```bash
pip install nltk transformers
python -c "import nltk; nltk.download('vader_lexicon')"
```

```python
# VADER - instantaneo, perfeito para comentarios
from nltk.sentiment import SentimentIntensityAnalyzer
sia = SentimentIntensityAnalyzer()

comentarios = [
    "Esse video e incrivel! Amei demais!",
    "Pessimo conteudo, nao recomendo",
    "Video ok, nada demais"
]

for c in comentarios:
    score = sia.polarity_scores(c)
    sentimento = "positivo" if score['compound'] > 0.05 else "negativo" if score['compound'] < -0.05 else "neutro"
    print(f"{sentimento}: {c}")

# DistilBERT - mais preciso
from transformers import pipeline
classifier = pipeline("sentiment-analysis",
                      model="distilbert-base-uncased-finetuned-sst-2-english")
result = classifier("This video is absolutely amazing!")
# [{'label': 'POSITIVE', 'score': 0.9998}]
```

**Onde usar nos modulos:**
- **ViralScan:** Analise de sentimento de comentarios
- **EngageBot:** Classificar comentarios (positivo/negativo/spam)
- **ShopIntel:** Analise de reviews de produtos
- **SpyCompetitor:** Sentimento do publico dos concorrentes

---

## 6. OCR / Visao Computacional

> Substitui: Google Vision API, AWS Textract
> Economia estimada: R$5-20/mes

| Ferramenta | RAM | Qualidade | Idiomas | Licenca |
|-----------|-----|-----------|---------|---------|
| **PaddleOCR** | ~1 GB | Excelente | Multi | Apache 2.0 |
| **Tesseract** | <500 MB | Boa | 100+ | Apache 2.0 |
| **Surya OCR** | ~1-2 GB | Moderna/ML | 90+ | GPL 3.0 |

```bash
pip install paddleocr paddlepaddle
# ou
pip install pytesseract  # + apt install tesseract-ocr
```

```python
# PaddleOCR - melhor qualidade
from paddleocr import PaddleOCR
ocr = PaddleOCR(use_angle_cls=True, lang='pt')
result = ocr.ocr('thumbnail.png')
for line in result[0]:
    print(line[1][0])  # texto detectado

# Tesseract - mais leve
import pytesseract
from PIL import Image
text = pytesseract.image_to_string(Image.open('thumbnail.png'), lang='por')
```

**Onde usar nos modulos:**
- **ViralScan:** Ler texto de thumbnails para analise
- **ScriptGenius:** Extrair texto de thumbnails de referencia
- **SpyCompetitor:** Analisar thumbnails de concorrentes

---

## 7. Embeddings / RAG (Busca Semantica)

> Substitui: OpenAI Embeddings API ($0.02/M tokens)
> Economia estimada: R$5-15/mes

| Modelo | Dimensoes | RAM | Velocidade | Licenca |
|--------|----------|-----|-----------|---------|
| **all-MiniLM-L6-v2** | 384 | ~100 MB | 16ms/embed | Apache 2.0 |
| **E5-small** | 384 | ~130 MB | 16ms | MIT |
| **nomic-embed-text** | 768 | ~270 MB | Rapida | Apache 2.0 |

```bash
pip install sentence-transformers chromadb
```

```python
from sentence_transformers import SentenceTransformer
import chromadb

# Modelo de embeddings (100MB, instantaneo)
model = SentenceTransformer('all-MiniLM-L6-v2')

# ChromaDB como banco vetorial (local, sem servidor)
client = chromadb.PersistentClient(path="data/vectordb")
collection = client.get_or_create_collection("videos")

# Indexar videos
collection.add(
    documents=["tutorial de construcao IA timelapse", "review de produto viral"],
    ids=["vid1", "vid2"]
)

# Buscar similares
results = collection.query(query_texts=["como fazer video de casa IA"], n_results=5)
```

**Onde usar nos modulos:**
- **ViralScan:** Busca semantica de videos similares
- **TrendRadar:** Encontrar tendencias relacionadas
- **ScriptGenius:** Banco de hooks virais com busca inteligente
- **ShopIntel:** Busca semantica de produtos
- **ViralAcademy:** RAG sobre o curso (perguntas e respostas)

---

## 8. Geracao de Imagens (Thumbnails)

> Substitui: Stability AI ($0.002-0.006/img), DALL-E 3 ($0.04-0.12/img)
> **AVISO:** Lento em CPU (5-15 min por imagem). Usar para batch/overnight.

| Ferramenta | RAM | Velocidade CPU | Qualidade | Licenca |
|-----------|-----|---------------|-----------|---------|
| **stable-diffusion.cpp SD 1.5 Q4** | ~2.3 GB | 5-15 min/img | Decente | MIT |
| **FastSDCPU (SD + LCM)** | ~4 GB | 2-5 min/img | Decente | Open |

```bash
# stable-diffusion.cpp (mais leve)
git clone https://github.com/leejet/stable-diffusion.cpp
cd stable-diffusion.cpp && mkdir build && cd build
cmake .. && cmake --build . --config Release
# Baixar modelo SD 1.5 Q4 (~1.7GB)
```

**Estrategia recomendada:**
- Gerar thumbnails em **batch noturno** (ex: 20 thumbnails durante a madrugada)
- Para thumbnails urgentes, usar **Stability AI free tier** (25 creditos gratis)
- Qualidade SD 1.5 e suficiente para thumbnails de redes sociais

**Onde usar:** ScriptGenius (geracao de thumbnails em batch)

---

## 9. Geracao de Musica

> **LIMITADO em CPU.** Funciona para clips curtos (5-10s).

| Ferramenta | RAM | Velocidade CPU | Licenca |
|-----------|-----|---------------|---------|
| **MusicGen Small (300M)** | ~4 GB | 5-10 min / 10s clip | MIT |

```python
# pip install audiocraft
from audiocraft.models import MusicGen
model = MusicGen.get_pretrained('facebook/musicgen-small')
model.set_generation_params(duration=8)  # 8 segundos
wav = model.generate(['upbeat electronic music for social media'])
```

**Estrategia:** Usar para jingles curtos e background music. Para musicas completas, usar **Suno free tier** (10 musicas/dia gratis).

---

## 10. Geracao de Video

> **NAO VIAVEL em CPU sem GPU.** Todos os modelos precisam de 12-24GB VRAM minimo.
> Usar APIs gratuitas: Runway free tier, Pika free tier.

---

## RESUMO: STACK LOCAL GRATUITA COMPLETA

| Categoria | Ferramenta Local | RAM | Substitui | Economia/mes |
|-----------|-----------------|-----|-----------|-------------|
| **LLM** | Ollama + Qwen 2.5 3B | 3 GB | Claude/GPT API | R$50-200 |
| **TTS** | Kokoro-82M | 2 GB | ElevenLabs | R$25-150 |
| **STT** | faster-whisper small | 2 GB | Whisper API | R$20-100 |
| **Traducao** | LibreTranslate | 4 GB | DeepL/Google API | R$25-50 |
| **Sentimento** | VADER + DistilBERT | 0.5 GB | Google NLP API | R$10-30 |
| **OCR** | PaddleOCR | 1 GB | Google Vision API | R$5-20 |
| **Embeddings** | MiniLM + ChromaDB | 0.1 GB | OpenAI Embeddings | R$5-15 |
| **Imagens** | SD.cpp (batch noturno) | 2.3 GB | Stability/DALL-E | R$10-30 |
| **Musica** | MusicGen Small | 4 GB | Suno/Udio | R$5-15 |
| **Video** | ❌ Nao viavel | - | Runway/Pika | usar free tier |
| **TOTAL** | | | | **R$155-610/mes** |

### Uso de RAM (execucao sequencial, NAO simultanea)

> **REGRA:** Rodar apenas 1-2 modelos por vez. Carregar/descarregar conforme necessidade.

| Cenario | RAM usada | Viavel? |
|---------|----------|---------|
| Sistema + FastAPI + SQLite | ~1.5 GB | Base |
| + Ollama (Qwen 3B) | +3 GB = 4.5 GB | SIM |
| + faster-whisper small | +2 GB = 3.5 GB | SIM |
| + Kokoro TTS | +2 GB = 3.5 GB | SIM |
| + VADER/DistilBERT | +0.5 GB = 2 GB | SIM |
| Ollama + whisper ao mesmo tempo | +5 GB = 6.5 GB | APERTADO |
| Tudo ao mesmo tempo | +12 GB = 13.5 GB | NAO! |

**Estrategia de gerenciamento:**
1. Ollama carrega/descarrega modelos automaticamente (idle timeout)
2. faster-whisper: carregar modelo apenas quando transcrever, liberar depois
3. Kokoro: carregar apenas para gerar audio, liberar depois
4. LibreTranslate: rodar via Docker com limite de memoria
5. Considerar adicionar 4-8GB de **swap** em disco para seguranca

```bash
# Criar 4GB de swap (recomendado!)
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
```

### Instalacao Completa (script)

```bash
#!/bin/bash
# Instalar todas as IAs locais do Viral Social Pro

# 1. Ollama (LLM server)
curl -fsSL https://ollama.com/install.sh | sh
ollama pull qwen2.5:3b

# 2. Python packages (dentro do venv)
cd /home/glauko/viral-social
source venv/bin/activate

pip install faster-whisper          # STT
pip install kokoro                  # TTS
pip install nltk                    # Sentimento
pip install sentence-transformers   # Embeddings
pip install chromadb                # Banco vetorial
pip install paddleocr paddlepaddle  # OCR

python -c "import nltk; nltk.download('vader_lexicon')"

# 3. LibreTranslate (Docker)
docker run -d --name libretranslate -p 5000:5000 \
  --memory="2g" libretranslate/libretranslate

# 4. Swap (seguranca)
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
```

### Integracao com FastAPI

```python
# backend/services/local_ai.py - Servico unificado de IA local

import httpx

class LocalAI:
    """Cliente unificado para todas as IAs locais"""

    OLLAMA_URL = "http://localhost:11434"
    TRANSLATE_URL = "http://localhost:5000"

    @staticmethod
    async def chat(prompt: str, model: str = "qwen2.5:3b") -> str:
        """Gerar texto com LLM local (Ollama)"""
        async with httpx.AsyncClient(timeout=120) as client:
            r = await client.post(f"{LocalAI.OLLAMA_URL}/v1/chat/completions",
                json={"model": model, "messages": [{"role": "user", "content": prompt}]})
            return r.json()["choices"][0]["message"]["content"]

    @staticmethod
    def transcribe(audio_path: str) -> str:
        """Transcrever audio com faster-whisper"""
        from faster_whisper import WhisperModel
        model = WhisperModel("small", device="cpu", compute_type="int8")
        segments, _ = model.transcribe(audio_path, language="pt")
        return " ".join(s.text for s in segments)

    @staticmethod
    def text_to_speech(text: str, output_path: str):
        """Gerar audio com Kokoro TTS"""
        from kokoro import KokoroPipeline
        pipeline = KokoroPipeline(lang_code='p')
        audio = pipeline(text)
        audio.save(output_path)

    @staticmethod
    async def translate(text: str, source: str = "en", target: str = "pt") -> str:
        """Traduzir com LibreTranslate"""
        async with httpx.AsyncClient() as client:
            r = await client.post(f"{LocalAI.TRANSLATE_URL}/translate",
                json={"q": text, "source": source, "target": target})
            return r.json()["translatedText"]

    @staticmethod
    def sentiment(text: str) -> dict:
        """Analise de sentimento com VADER"""
        from nltk.sentiment import SentimentIntensityAnalyzer
        sia = SentimentIntensityAnalyzer()
        scores = sia.polarity_scores(text)
        label = "positivo" if scores['compound'] > 0.05 else \
                "negativo" if scores['compound'] < -0.05 else "neutro"
        return {"label": label, "score": scores['compound'], "details": scores}
```

---

# ARQUITETURA: MONOLITO MODULAR

```
viral.chatys.com.br (1 plataforma, 1 servidor, 1 banco)
|
|-- /scan              -> Modulo 1: ViralScan
|-- /trends            -> Modulo 2: TrendRadar
|-- /create            -> Modulo 3: ScriptGenius
|-- /dark-factory      -> Modulo 4: DarkFactory
|-- /shop              -> Modulo 5: ShopIntel
|-- /spy               -> Modulo 6: SpyCompetitor
|-- /schedule          -> Modulo 7: PostPilot
|-- /engage            -> Modulo 8: EngageBot
|-- /crm               -> Modulo 9: CreatorCRM
|-- /automate          -> Modulo 10: AutoFlow
|-- /agency            -> Modulo 11: AgencyHub
|-- /academy           -> Modulo 12: ViralAcademy
|
|-- Cada modulo = ativado/desativado por plano do usuario
|-- Free: 2 modulos | Starter: 4 | Pro: 8 | Agency: todos
```

---

# CRONOGRAMA DE ONDAS

## ONDA 1 (Meses 1-3) - Validacao Rapida
> Prioridade: ALTA | Foco: Funcionalidades que ja temos parcialmente prontas

| # | Modulo | Status | Progresso |
|---|--------|--------|-----------|
| 1 | ViralScan | EM DESENVOLVIMENTO | 70% |
| 5 | ShopIntel | EM DESENVOLVIMENTO | 60% |
| 2 | TrendRadar | EM DESENVOLVIMENTO | 50% |

## ONDA 2 (Meses 4-6) - Criacao
> Prioridade: MEDIA-ALTA | Foco: Geracao de conteudo com IA

| # | Modulo | Status | Progresso |
|---|--------|--------|-----------|
| 3 | ScriptGenius | NAO INICIADO | 0% |
| 6 | SpyCompetitor | EM DESENVOLVIMENTO | 40% |
| 12 | ViralAcademy | EM DESENVOLVIMENTO | 30% |

## ONDA 3 (Meses 7-9) - Automacao
> Prioridade: MEDIA | Foco: Publicacao e engajamento automatizado

| # | Modulo | Status | Progresso |
|---|--------|--------|-----------|
| 7 | PostPilot | NAO INICIADO | 0% |
| 4 | DarkFactory | NAO INICIADO | 0% |
| 8 | EngageBot | NAO INICIADO | 0% |

## ONDA 4 (Meses 10-12) - Escala
> Prioridade: BAIXA | Foco: Enterprise e agencias

| # | Modulo | Status | Progresso |
|---|--------|--------|-----------|
| 10 | AutoFlow | NAO INICIADO | 0% |
| 9 | CreatorCRM | NAO INICIADO | 0% |
| 11 | AgencyHub | NAO INICIADO | 0% |

---

# DETALHAMENTO DOS 12 MODULOS

---

## MODULO 1: ViralScan - Scanner & Descoberta de Conteudo Viral
**Rota:** /scan | **Prioridade:** ALTA | **Status:** 70% | **Onda:** 1

### O que faz
Encontra videos virais em TikTok, YouTube e Instagram com filtros avancados, detecta outliers, analisa scripts e calcula replicabilidade.

### Publico-alvo
Criadores de conteudo, social media managers

### Precos
- Free: 10 buscas/dia
- Starter: R$39/mes
- Pro: R$99/mes

### Features (45 total)

#### JA IMPLEMENTADO (70%)
- [x] Scan por keyword em TikTok e YouTube Shorts
- [x] Scan via TikTok Creative Center (gratis)
- [x] Scan via ScrapeCreators (TikTok + YouTube)
- [x] Filtros: views, viral score, outlier, duracao, data, criador, produto
- [x] Filtro por Categoria (12 opcoes com keyword matching PT+EN)
- [x] Filtro por Estilo (10 opcoes: timelapse, tutorial, review, etc.)
- [x] Quick presets: Mega Viral, Shop Viral, Small Creator, Trending Now, Replicable
- [x] Thumbnail cards (16:9, sem iframe)
- [x] Deteccao de outliers (views vs media do criador)
- [x] Score de replicabilidade (0-100)
- [x] Viral Score v2 (outlier-based, favorece pequenos criadores)
- [x] Auto-scan agendado (APScheduler, 15min, 200 cred/dia)
- [x] Historico de scanner com graficos de uso de API
- [x] Data populator: auto-popula Creators/Trends/Sounds apos scan
- [x] Alternancia search/top + search/keyword
- [x] Anti-block: delay configuravel, limite diario, pausa emergencial

#### FALTA IMPLEMENTAR (30%)
- [ ] Scan por hashtag com volume e tendencia de crescimento
- [ ] Scan por som/musica (videos usando mesma faixa)
- [ ] Scan por efeito/filtro do TikTok
- [ ] Scan geografico por pais/regiao
- [ ] Scan por nicho/categoria (50+ categorias com subcategorias)
- [ ] Deteccao de videos emergentes (< 24h com crescimento acelerado)
- [ ] Engagement velocity analysis
- [ ] Save/share ratio monitoring
- [ ] Filtro por completion rate estimado
- [ ] Filtro por potencial de monetizacao
- [ ] Filtro "blue ocean" (alta demanda, baixa competicao)
- [ ] Transcricao automatica do audio (Whisper API)
- [ ] Analise de script completa: hook, problema, solucao, CTA
- [ ] Analise de thumbnail: cores, texto, composicao
- [ ] Deteccao de musica/som do video
- [ ] Analise de comentarios: sentimento, FAQ, pain points
- [ ] Sugestao de melhoria por IA
- [ ] Hook strength scoring (0-100)
- [ ] Emotional arc mapping
- [ ] Pacing analysis
- [ ] Shareability score
- [ ] Completion rate predictor

### Arquivos principais
- `backend/services/viral_scanner.py` - Scanner principal
- `backend/services/viral_detector.py` - Algoritmo de score
- `backend/services/creator_baseline.py` - Baseline de criadores
- `backend/services/api_usage_tracker.py` - Tracker de uso de API
- `frontend/templates/viral_scanner.html` - Pagina do scanner
- `frontend/templates/scanner_history.html` - Historico

### APIs e IAs utilizadas
- ScrapeCreators: /v1/tiktok/search/keyword, /v1/tiktok/search/top
- TikTok Creative Center (gratis)
- YouTube Data API v3
- **IA Local - Ollama (Qwen 2.5 3B):** Analise de script, classificacao de hooks, sugestao de melhoria
- **IA Local - faster-whisper:** Transcricao automatica de audio dos videos
- **IA Local - VADER:** Analise de sentimento de comentarios
- **IA Local - PaddleOCR:** Leitura de texto em thumbnails
- **IA Local - MiniLM + ChromaDB:** Busca semantica de videos similares

---

## MODULO 2: TrendRadar - Inteligencia de Tendencias em Tempo Real
**Rota:** /trends | **Prioridade:** ALTA | **Status:** 50% | **Onda:** 1

### O que faz
Detecta tendencias emergentes (topics, sons, hashtags, formatos, produtos), preve viralizacao, analisa padroes.

### Publico-alvo
Criadores, marcas, agencias

### Precos
- R$29/mes - R$79/mes - R$199/mes

### Features (52 total)

#### JA IMPLEMENTADO (50%)
- [x] Trends Discovery com trending TikTok + YouTube Shorts
- [x] Auto-refresh a cada 15 minutos
- [x] Limite de 200 creditos/dia
- [x] Sons trending detectados no scanner
- [x] Sound Predictor: emerging/trending/peak/declining
- [x] Trend Lifecycle: classify keywords (emerging/growing/peak/declining)
- [x] Viral Patterns Analyzer: duracao, formatos, hooks, timing
- [x] Viral Probability Calculator: score 0-100
- [x] Engagement Heatmap: 7x24 grid de melhores horarios
- [x] Pagina /trends com dados basicos
- [x] Pagina /sounds com sons trending
- [x] Pagina /hashtags-page com hashtags

#### FALTA IMPLEMENTAR (50%)
- [ ] Trending topics por plataforma e regiao (atualizado a cada hora)
- [ ] Trending efeitos/filtros do TikTok
- [ ] Trending formatos (que tipo de video esta bombando)
- [ ] Trending produtos (viralizando no TikTok Shop)
- [ ] Trending creators (quem esta crescendo mais rapido)
- [ ] Mapa de tendencias global por pais
- [ ] Timeline de tendencia visual (nascimento - pico - declinio)
- [ ] Alerta de tendencia emergente (push/email/telegram)
- [ ] Micro-trend early detection (semanas antes do mainstream)
- [ ] Emotional sentiment virality scoring
- [ ] Content format trend analysis
- [ ] Platform algorithm change detection
- [ ] Niche-specific trend radar
- [ ] Trend saturation warning
- [ ] Predicao por hora (melhor horario para aquele conteudo)
- [ ] Predicao por plataforma (onde tem mais chance)
- [ ] Predicao por formato (duracao ideal, estilo, trilha)
- [ ] Predicao de lifecycle (quanto tempo vai durar)
- [ ] Score de saturacao
- [ ] Predicao de revenue (quanto pode gerar)
- [ ] Completion rate predictor (antes de filmar)
- [ ] Shareability predictor
- [ ] STEPPS Score (Social currency, Triggers, Emotion, etc.)
- [ ] Padroes de musica (BPM/genero vs viralizacao)
- [ ] Padroes de cor
- [ ] Padroes de texto
- [ ] Padroes cross-platform
- [ ] Relatorio semanal de padroes automatizado
- [ ] Biblioteca de sons trending com preview
- [ ] Classificacao de som (genero, mood, BPM, energia)
- [ ] Previsao de pico de som
- [ ] Geracao de musica por prompt (Suno/Udio API)
- [ ] Geracao de musica por referencia
- [ ] Biblioteca de musicas sem copyright

### Arquivos principais
- `backend/services/sound_predictor.py`
- `backend/services/viral_patterns.py`
- `backend/services/trend_lifecycle.py`
- `frontend/templates/trends_discovery.html`
- `frontend/templates/trends.html`
- `frontend/templates/sounds.html`
- `frontend/templates/hashtags.html`

### APIs e IAs utilizadas
- TikTok Creative Center (gratis)
- ScrapeCreators: /v1/tiktok/song, /v1/tiktok/song/videos
- YouTube Data API v3
- **IA Local - Ollama (Qwen 2.5 3B):** Resumos de tendencias, previsoes, analise de padroes
- **IA Local - LibreTranslate:** Traduzir tendencias globais para PT
- **IA Local - MusicGen Small:** Gerar clips de musica trending (batch)

---

## MODULO 3: ScriptGenius - Criacao de Conteudo com IA
**Rota:** /create | **Prioridade:** ALTA | **Status:** 0% | **Onda:** 2

### O que faz
Gera scripts, hooks, CTAs, thumbnails, audio TTS, edicao automatica - tudo com IA.

### Publico-alvo
Criadores, produtoras, dark channels

### Precos
- Free: 5 scripts/mes
- Starter: R$49/mes
- Pro: R$149/mes
- Agency: R$299/mes

### Features (81 total)

#### JA IMPLEMENTADO (0%)
- [x] Script Generator basico (regex-based) no champion_videos.py

#### FALTA IMPLEMENTAR (100%)

**Scripts & Roteiros:**
- [ ] Geracao de roteiro completo a partir de tema/keyword (Claude/GPT API)
- [ ] Templates de roteiro: hook + problema + solucao + CTA (10+ templates)
- [ ] Banco de hooks virais: 1000+ hooks categorizados com score
- [ ] Gerador de hooks: 10 variacoes para o mesmo tema
- [ ] Adaptador de script por plataforma (TikTok 30s, Shorts 60s, Reels 90s)
- [ ] Rewriter de scripts virais (adaptar para seu nicho)
- [ ] Gerador de CTAs otimizados
- [ ] Tradutor de scripts (DeepL/Google API)
- [ ] Analise de legibilidade
- [ ] A/B testing de scripts
- [ ] Retention risk flagging
- [ ] CTA placement optimization
- [ ] Competitor script pattern analysis
- [ ] Tone consistency analysis
- [ ] Storyboard generation

**Geracao de Videos:**
- [ ] Text-to-Video curto (15-60s)
- [ ] Image-to-Video (Runway, Kling, Pika)
- [ ] Video com avatar IA (HeyGen, Synthesia)
- [ ] Video com narracao IA (ElevenLabs + Pictory)
- [ ] Gerador de timelapse IA (Sora, Runway)
- [ ] Batch video generation
- [ ] Content atomization engine (1 video longo - 10 clips)

**Edicao Automatica:**
- [ ] Auto-corte de silencios
- [ ] Auto-legendas (SubMagic/CapCut style)
- [ ] Auto-zoom dinamico
- [ ] Auto-music trending
- [ ] Auto-transicoes
- [ ] Formatacao multi-plataforma (9:16, 16:9, 1:1)
- [ ] Pattern interrupt insertion (a cada 4s, retencao +58%)

**Thumbnails:**
- [ ] Gerador de thumbnails IA (Stability AI)
- [ ] A/B testing de thumbnails
- [ ] Preditor de CTR (0-100%)
- [ ] AI eye-tracking heatmap simulation
- [ ] Mobile-first preview

**Audio & Voz:**
- [ ] Text-to-Speech multi-voz (ElevenLabs, 200+ vozes)
- [ ] Clonagem de voz
- [ ] Geracao de musica IA (Suno, Udio)
- [ ] Separacao de audio (voz, musica, efeitos)
- [ ] Melhorador de audio (ruido, equalizacao)
- [ ] Dobragem automatica (130+ idiomas)

### Arquivos a criar
- `backend/services/script_generator.py`
- `backend/services/thumbnail_generator.py`
- `backend/services/tts_service.py`
- `backend/services/video_editor.py`
- `frontend/templates/create.html`

### IAs Locais (GRATUITAS - substituem APIs pagas)
- **Ollama (Qwen 2.5 3B):** Geracao de roteiros, hooks, CTAs, rewriter - substitui Claude/GPT ($0.05-0.20/script -> R$0)
- **Kokoro-82M:** Text-to-Speech de alta qualidade - substitui ElevenLabs ($5-330/mes -> R$0)
- **faster-whisper:** Transcricao de videos de referencia - substitui Whisper API ($0.006/min -> R$0)
- **SD.cpp (batch noturno):** Geracao de thumbnails - substitui Stability AI ($0.002/img -> R$0)
- **LibreTranslate:** Traducao de scripts EN<->PT - substitui DeepL ($5.49/mes -> R$0)

### APIs pagas (apenas para o que NAO roda local)
- Runway/Kling (video IA): $12-76/mo - **sem alternativa local viavel**

---

## MODULO 4: DarkFactory - Pipeline de Dark Channels & Videos Longos
**Rota:** /dark-factory | **Prioridade:** MEDIA | **Status:** 0% | **Onda:** 3

### O que faz
Pipeline end-to-end automatizada: tema - roteiro - voz - footage - edicao - thumbnail - upload YouTube.

### Publico-alvo
Operadores de dark channels, produtoras faceless

### Precos
- R$99/mes (10 videos)
- R$249/mes (50 videos)
- R$499/mes (ilimitado)

### Features (38 total)
- [ ] Pipeline completa: tema - roteiro - narracao - footage - edicao - publicacao
- [ ] Narracao IA (200+ vozes com emocao)
- [ ] Stock footage automatico (Pexels/Pixabay)
- [ ] Legendas word-by-word, transicoes cinematograficas
- [ ] Batch production (10+ videos/dia)
- [ ] Upload automatico via YouTube API com SEO
- [ ] QA agent (brand guidelines, copyright)
- [ ] Pipeline cost tracking (custo por video: $1-5)
- [ ] 10 nichos suportados com RPM mapeado
- [ ] Human-in-the-loop checkpoints
- [ ] Pipeline branching (1 video longo - multiplos outputs)

### Arquivos a criar
- `backend/services/dark_factory.py`
- `backend/services/footage_selector.py`
- `backend/services/video_assembler.py`
- `backend/services/youtube_uploader.py`
- `frontend/templates/dark_factory.html`

### IAs Locais (GRATUITAS)
- **Ollama (Qwen 2.5 3B ou Phi-3 Mini):** Roteiros longos (5-30 min) - substitui GPT-4/Claude
- **Kokoro-82M:** Narracao completa dos videos - substitui ElevenLabs ($0.50-2.00/video -> R$0)
- **SD.cpp:** Imagens ilustrativas (batch noturno) - substitui Stability AI
- **faster-whisper:** QA de narracao gerada

### APIs gratuitas
- Pexels API (footage): Gratis
- YouTube Data API (upload): Gratis

### APIs pagas (minimo necessario)
- Creatomate/Shotstack (edicao programatica): $0.20-2.00/video - **avaliar ffmpeg local como alternativa**

**Custo por video com IAs locais: ~$0.20-0.50** (vs $1.11-4.42 com APIs pagas)

---

## MODULO 5: ShopIntel - TikTok Shop & Social Commerce Intelligence
**Rota:** /shop | **Prioridade:** ALTA | **Status:** 60% | **Onda:** 1

### O que faz
Analytics completo do TikTok Shop: rankings de produtos/lojas/criadores, espiao de lojas, matcher de afiliados.

### Publico-alvo
Vendedores TikTok Shop, afiliados, e-commerces

### Precos
- R$49/mes - R$149/mes - R$399/mes

### Features (37 total)

#### JA IMPLEMENTADO (60%)
- [x] Ranking de produtos por vendas/receita/crescimento (EchoTik + Apify)
- [x] Ranking de lojas por GMV/pedidos
- [x] Ranking de criadores (analytics BR internos)
- [x] Ranking de videos virais
- [x] Busca de produtos por keyword
- [x] Espiao de lojas (monitorar qualquer loja)
- [x] Detalhe de produto com tendencias
- [x] Cache inteligente (TTL: rankings 6h, search 12h, details 24h)
- [x] Image proxy com cache local
- [x] Tendencias BR (graficos + KPI cards)
- [x] Videos Virais do Shop
- [x] Sync automatico a cada 6h
- [x] Revenue tracking (ProductSnapshot model)
- [x] Categorias BR (moda, beleza, casa, eletronicos, esportes)

#### FALTA IMPLEMENTAR (40%)
- [ ] Deteccao de produto viral (crescimento explosivo)
- [ ] Historico de vendas com grafico ao longo do tempo
- [ ] Analise de reviews (sentimento, reclamacoes, elogios)
- [ ] Product lifecycle analyzer
- [ ] Viral product predictor
- [ ] Category trend heatmap
- [ ] Novos produtos detectados (alerta)
- [ ] Mudanca de preco (alerta)
- [ ] Top criadores da loja (quais afiliados vendem mais)
- [ ] Estimativa de faturamento mensal da loja
- [ ] Affiliate network map (visualizar rede de afiliados)
- [ ] Matcher de afiliados (cruzar videos virais com produtos)
- [ ] Sugestao de produtos por nicho
- [ ] Calculadora de comissao
- [ ] Commission optimizer
- [ ] Template de video de produto
- [ ] Product video generator com IA
- [ ] Script de vendas focado em conversao
- [ ] Live commerce planner
- [ ] Seasonal product predictor

### Arquivos principais
- `backend/services/echotik.py` - Cliente EchoTik API
- `backend/services/echotik_cache.py` - Cache EchoTik
- `backend/services/tiktok_shop_api.py` - Cliente Apify TikTok Shop
- `backend/services/tiktok_shop_cache.py` - Cache Apify
- `frontend/templates/shop.html` - Pagina do Shop

### APIs utilizadas
- EchoTik API (rankings, detalhes)
- Apify PratikDani actors (busca, detalhes)

---

## MODULO 6: SpyCompetitor - Espionagem de Concorrentes
**Rota:** /spy | **Prioridade:** MEDIA | **Status:** 40% | **Onda:** 2

### O que faz
Monitora perfis de concorrentes, snapshots diarios, alertas, gap analysis, estimativa de receita.

### Publico-alvo
Criadores serios, marcas, agencias

### Precos
- R$29/mes (5 perfis) - R$79/mes (20 perfis) - R$199/mes (ilimitado)

### Features (23 total)

#### JA IMPLEMENTADO (40%)
- [x] Adicionar perfis para monitorar (TikTok, YouTube, Instagram)
- [x] Snapshot de metricas (followers, views, posts)
- [x] Grafico de crescimento comparativo
- [x] Pagina /competitors-spy com cards de concorrentes
- [x] Refresh manual de dados
- [x] Growth tracking basico

#### FALTA IMPLEMENTAR (60%)
- [ ] Snapshot DIARIO automatico
- [ ] Alerta de novo video do concorrente
- [ ] Alerta de video viral do concorrente
- [ ] Analise de frequencia de posts
- [ ] Analise de hashtags usadas
- [ ] Analise de sons usados
- [ ] Analise de descricoes/copy
- [ ] Analise de thumbnails
- [ ] Reverse-engineering de viral
- [ ] Gap analysis (temas que eles cobrem e voce nao)
- [ ] Oportunidade de nicho inexplorado
- [ ] Estimativa de receita do concorrente
- [ ] Deteccao de bot/fake followers
- [ ] Share of voice analysis
- [ ] Competitive position dashboard

### Arquivos principais
- `backend/services/competitor_spy.py`
- `frontend/templates/competitors_spy.html`

---

## MODULO 7: PostPilot - Calendario, Agendamento & Publicacao
**Rota:** /schedule | **Prioridade:** MEDIA | **Status:** 0% | **Onda:** 3

### O que faz
Calendario inteligente, agendamento com IA, publicacao automatica multi-plataforma.

### Publico-alvo
Criadores, social media managers, agencias

### Precos
- Free (1 plataforma) - R$29/mes - R$79/mes - R$199/mes

### Features (32 total)
- [ ] Calendario visual drag-and-drop
- [ ] Slots sugeridos por IA (melhores horarios)
- [ ] Publicacao automatica TikTok/YouTube/Instagram
- [ ] Adaptacao automatica de formato/caption/hashtags por plataforma
- [ ] Queue system com intervalos configuraveis
- [ ] Content versioning (1 conteudo - 5+ versoes)
- [ ] First comment scheduling
- [ ] Timezone-aware scheduling
- [ ] Republish automatico de conteudo evergreen
- [ ] Best time posting automatico
- [ ] Templates de calendario por nicho
- [ ] Content conflict detection

### Arquivos a criar
- `backend/services/publisher.py`
- `backend/services/smart_scheduler.py`
- `frontend/templates/post_pilot.html`

### APIs necessarias
- TikTok API (posting)
- YouTube Data API (posting)
- Instagram Graph API (posting)

---

## MODULO 8: EngageBot - Engajamento & DM Automation
**Rota:** /engage | **Prioridade:** BAIXA | **Status:** 0% | **Onda:** 3

### O que faz
Inbox unificado de comentarios, respostas IA, filtro de spam, analise de sentimento, automacao de DMs.

### Publico-alvo
Criadores com volume, marcas, agencias

### Precos
- R$29/mes - R$79/mes - R$199/mes

### Features (21 total)
- [ ] Inbox unificado (todas as plataformas)
- [ ] Resposta automatica com IA (tom do criador)
- [ ] Filtro de spam/hate
- [ ] Analise de sentimento por video
- [ ] FAQ detector (gerar conteudo das perguntas)
- [ ] Pain point detector nos comentarios
- [ ] Welcome DM automatica
- [ ] Keyword trigger DM
- [ ] Funil de vendas via DM
- [ ] Chatbot IA para DMs
- [ ] Comment-to-content pipeline
- [ ] Community health score

### Arquivos a criar
- `backend/services/engage_bot.py`
- `backend/services/comment_analyzer.py`
- `backend/services/dm_automation.py`
- `frontend/templates/engage.html`

---

## MODULO 9: CreatorCRM - Gestao de Influencers & Parcerias
**Rota:** /crm | **Prioridade:** BAIXA | **Status:** 0% | **Onda:** 4

### O que faz
Descoberta de influencers, CRM de parcerias, media kit automatico, revenue dashboard multi-fonte.

### Publico-alvo
Marcas, agencias, e-commerces

### Precos
- R$99/mes - R$299/mes - R$799/mes

### Features (27 total)
- [ ] Busca de influencers por nicho/metrica/localizacao
- [ ] Deteccao de fake followers
- [ ] Score de influencia (0-100)
- [ ] CRM de relacionamentos
- [ ] Pipeline de outreach
- [ ] Briefing generator
- [ ] Payment tracking
- [ ] Campaign ROI attribution
- [ ] Media kit generator automatico
- [ ] Revenue dashboard multi-fonte (AdSense + Shop + Afiliados)
- [ ] Revenue per video forecasting
- [ ] Sponsorship rate calculator

### Arquivos a criar
- `backend/services/creator_crm.py`
- `backend/services/influencer_search.py`
- `backend/services/revenue_dashboard.py`
- `frontend/templates/crm.html`

---

## MODULO 10: AutoFlow - Automacao, Workflows & AI Agents
**Rota:** /automate | **Prioridade:** BAIXA | **Status:** 0% | **Onda:** 4

### O que faz
Workflow builder visual, triggers, AI agents autonomos, content factory.

### Publico-alvo
Power users, agencias, operadores de dark channels

### Precos
- R$79/mes - R$199/mes - R$499/mes

### Features (32 total)
- [ ] Workflow builder visual drag-and-drop
- [ ] Triggers por evento/tempo/condicao
- [ ] 8 AI Agents (Research, Script, Visual, Audio, Editor, QA, Publishing, Analyst)
- [ ] Multi-Agent Orchestrator
- [ ] Content factory (linha de montagem)
- [ ] Batch production com metas e quotas
- [ ] Integracao n8n/Make/Zapier
- [ ] Trend surfing automation (detecta - cria - publica em 2-4h)
- [ ] Pipeline cost tracking per run
- [ ] Agent memory & learning

### Arquivos a criar
- `backend/services/workflow_engine.py`
- `backend/services/ai_agents/`
- `backend/services/content_factory.py`
- `frontend/templates/automate.html`

---

## MODULO 11: AgencyHub - Plataforma White-Label para Agencias
**Rota:** /agency | **Prioridade:** BAIXA | **Status:** 0% | **Onda:** 4

### O que faz
Multi-workspace, white-label, relatorios automaticos, equipe com permissoes.

### Publico-alvo
Agencias de marketing, produtoras

### Precos
- R$299/mes - R$599/mes - R$1.499/mes

### Features (38 total)
- [ ] Multi-workspace (10+ canais)
- [ ] White-label branding completo
- [ ] Relatorios automaticos (diario/semanal/mensal) PDF/Excel
- [ ] Role-based access control
- [ ] Content approval workflows
- [ ] Client onboarding automation
- [ ] SLA monitoring
- [ ] Asset library management
- [ ] Backup automatico
- [ ] LGPD compliance

### Arquivos a criar
- `backend/services/workspace_manager.py`
- `backend/services/report_generator.py`
- `backend/services/rbac.py`
- `frontend/templates/agency.html`

---

## MODULO 12: ViralAcademy - Educacao & Coaching IA
**Rota:** /academy | **Prioridade:** MEDIA | **Status:** 30% | **Onda:** 2

### O que faz
Curso completo de viralizacao, coaching IA personalizado, gamificacao, channel audit.

### Publico-alvo
Criadores iniciantes e intermediarios

### Precos
- R$29/mes (curso)
- R$79/mes (curso + coaching IA)
- R$497 (vitalicio)

### Features (14 total)

#### JA IMPLEMENTADO (30%)
- [x] Curso "Ciencia da Viralizacao" com 24 modulos (/ciencia-viralizacao)
- [x] Pagina com sidebar de navegacao entre modulos
- [x] Conteudo completo em portugues (10K+ palavras)

#### FALTA IMPLEMENTAR (70%)
- [ ] AI Growth Coach personalizado (baseado nos SEUS dados)
- [ ] Channel audit automatico (titulos, thumbnails, SEO, pacing)
- [ ] Upload schedule recommendations
- [ ] Content pillar strategy generation
- [ ] 90-day growth plan generator
- [ ] Performance benchmarking against peers
- [ ] Weekly performance reports com recomendacoes
- [ ] Creator skill assessment
- [ ] Upload streak tracking + badges
- [ ] Achievement badges destravaveis
- [ ] XP and level system
- [ ] Dynamic difficulty challenges
- [ ] Community challenges

### Arquivos principais
- `frontend/templates/ciencia_viralizacao.html`
- `docs/CURSO-CIENCIA-DA-VIRALIZACAO-2026.md`

### Arquivos a criar
- `backend/services/ai_coach.py`
- `backend/services/gamification.py`
- `frontend/templates/academy.html`

---

# PLANO DE PRECOS (BUNDLES)

| Plano | Modulos Incluidos | Preco |
|-------|-------------------|-------|
| **Free** | ViralScan (limitado) + ViralAcademy (1 modulo) | R$0/mes |
| **Starter** (R$49/mes) | ViralScan + TrendRadar + SpyCompetitor + ViralAcademy | R$49/mes |
| **Pro** (R$149/mes) | Todos da Starter + ScriptGenius + ShopIntel + PostPilot + EngageBot | R$149/mes |
| **Agency** (R$399/mes) | Todos os 12 modulos | R$399/mes |
| **Enterprise** | Todos + white-label + custom | R$999+/mes |

### Bundles Especiais
| Bundle | Modulos | Preco |
|--------|---------|-------|
| **Creator Bundle** | ViralScan + TrendRadar + ScriptGenius | R$99/mes |
| **Seller Bundle** | ShopIntel + ViralScan + TrendRadar | R$99/mes |
| **Dark Channel Bundle** | DarkFactory + ScriptGenius + AutoFlow | R$299/mes |

---

# PROJECAO DE RECEITA

| Periodo | Free Users | Pagantes | MRR (R$) | ARR (R$) |
|---------|-----------|----------|----------|----------|
| Mes 3 | 500 | 20 | R$1.960 | R$23.520 |
| Mes 6 | 2.000 | 80 | R$8.720 | R$104.640 |
| Mes 12 | 10.000 | 400 | R$42.600 | R$511.200 |
| Mes 18 | 25.000 | 1.000 | R$109.000 | R$1.308.000 |
| Mes 24 | 50.000 | 2.500 | R$280.000 | R$3.360.000 |

---

# LOG DE DESENVOLVIMENTO

> Registro de cada sessao de desenvolvimento. Atualizar a cada sessao.

### 2026-03-14 - Criacao do Roadmap
- Criado este documento de referencia
- Definidos 12 modulos micro-SaaS
- Definida arquitetura monolito modular
- Definido cronograma de 4 ondas (12 meses)
- Pagina /roadmap-dev criada no site

### Proxima sessao: A DEFINIR
- [ ] Escolher primeiro modulo para completar
- [ ] Definir features prioritarias
- [ ] Comecar implementacao

---

# INSTRUCOES PARA O CLAUDE CODE

> **LEIA ISTO SEMPRE QUE PERDER CONTEXTO**

1. Este documento contem TODO o plano de desenvolvimento do Viral Social Pro
2. Sao 12 modulos micro-SaaS em arquitetura monolito modular
3. Consulte o STATUS de cada modulo para saber o que ja foi feito
4. Consulte FALTA IMPLEMENTAR para saber o que precisa ser feito
5. Siga a ordem das ONDAS (1-4) para priorizar
6. Apos cada sessao de desenvolvimento, ATUALIZE o log e os checkboxes
7. Sempre faca commit + push apos alteracoes
8. O usuario (Glauko) nao e programador - explique em portugues simples
9. Projeto em: /home/glauko/viral-social
10. Servico: sudo systemctl restart viral-social
11. GitHub: glaukocarvalho/viral-social

---

*Documento criado em 14/03/2026 | Atualizar a cada sessao de desenvolvimento*
