CenaForge: primeira versão pública

Gerador de vídeos narrativos (Godot + FFmpeg), painel Next.js, serviço de voz,
Clipador de lives e Publicador para YouTube, TikTok e Instagram.

Inclui a leitura das visualizações dos posts para o Dashboard e o botão
"Publicar no <rede>" nos cartões das publicações.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 16:35:09 -03:00
co-authored by Claude Opus 5.5
commit 84f30bbc2d
484 changed files with 74826 additions and 0 deletions
@@ -0,0 +1,48 @@
# 8 — Agenda (aprovação → agendamento → publicação → métricas)
**Objetivo:** nada sai sem aprovação; o que é aprovado sai no melhor horário da conta certa; o resultado volta
para a pauta.
**Saída:** peça aprovada, com data/hora e conta(s) por rede, publicada e acompanhada.
## Fluxo
1. **Aprovação humana (obrigatória, decisão do usuário).**
- Corte: fila do Clipador (`ready` → `approved`/`rejected`). Aprovar cria as publicações nas redes dos canais
ligados à fonte; com **aprovação automática** ligada no canal, cortes novos são aprovados sozinhos. O painel marca
`published` no Clipador quando todas as redes confirmarem.
- História: o episódio é aprovado pelo usuário depois do render final (prévia + final conferidos).
2. **Destino:** conta(s) pela página **Contas** (conta ↔ histórias, conta ↔ canais do Clipador).
3. **Janela:** horários sugeridos para o Brasil em [platforms.md](platforms.md) até haver dados próprios; depois,
o horário em que o público da conta está online (analytics da rede).
4. **Frequência (ponto de partida):** Shorts 3–5/semana com constância; Reels 1 bom/dia > 3 medianos; espalhar
cortes do mesmo canal ao longo do dia/semana em vez de despejar tudo junto; misturar conteúdo próprio
(histórias) com cortes.
5. **Publicação:** automática pelo painel (desde 17/11/2026). O canal de publicação define a **aprovação**
(manual ou automática para cortes; episódio sempre pelo botão "Aprovar para publicar") e **quando sai** (na hora
ou no próximo horário bom, com limite por dia por rede). Cada rede conecta por **API oficial** ou **sessão logada**,
à escolha do usuário. Acompanhe em **Publicações** (`/publishing`); só conta como publicado com link/ID da rede.
O painel precisa estar aberto e o Publicador rodando (`pnpm dev`). Limites por rede em [platforms.md](platforms.md);
plano técnico em `doc/publicacao/PLANO.md`.
6. **Interativa:** ao publicar, registrar a votação; ao fechar (`closeDecision` no painel) a vencedora vira
principal e o próximo nível é preparado — a agenda do próximo episódio nasce aqui.
7. **Métricas (24 h, 72 h, 7 dias):** retenção aos 3 s, % que assistiu até o fim, compartilhamentos/salvamentos
por alcance, comentários (votos), seguidores ganhos; série: % da parte 1 que viu a parte 2. O dashboard do
painel ainda usa **métricas simuladas** — não trate como reais.
8. **Volta para a pauta:** o que funcionou vira regra da conta; o que falhou vira hipótese para testar (uma
variável por vez: gancho, duração, capa, horário).
## Calendário
Use a tabela da ficha ([../templates/ficha.md](../templates/ficha.md)) ou, para uma semana, uma linha por peça:
`data | hora | rede | conta | peça | status (aprovado/agendado/publicado) | link`.
## Pronto quando
- [ ] aprovado pelo usuário (registro de quem/quando);
- [ ] conta e rede de destino; data/hora definidas;
- [ ] título, legenda, capa e rótulo de IA da etapa 6–7 anexados;
- [ ] (após publicar) link registrado e lembrete de leitura de métricas em 24 h / 7 dias.
**Lacunas:** sem métricas reais (o dashboard ainda usa simuladas); envio real ainda não validado com conta de
verdade em todas as redes. Não diga que algo foi "agendado" ou "publicado" se só foi aprovado — confira o estado em
**Publicações**.