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.

# 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

# 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

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

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

# 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

pip install faster-whisper

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*

# 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

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

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

# 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

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

# 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

pip install sentence-transformers chromadb

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

# 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

# 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

# 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)

#!/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

# 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