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
+87
View File
@@ -0,0 +1,87 @@
# Painel CenaForge
Painel local (Next.js 16.4 + React 19 + TypeScript + Tailwind 4) para trabalhar com
**várias histórias**, cada uma com seus **episódios**, **assets** e **votação A/B** nos
comentários, e para mandar pedidos aos agentes de código (**Claude Code** e **Codex**) pela CLI,
como no VS Code.
```sh
pnpm install # na raiz do repositório
pnpm panel # http://127.0.0.1:4500
```
Só escuta em `127.0.0.1`. Não há login: é uma ferramenta local.
## O que tem
| Página | Para quê |
|---|---|
| **Dashboard** (`/dashboard`) | Totais e desempenho por rede, conta, história e episódio (melhores e piores), views por dia, filtro por conta. Enquanto não há integração com as redes, os números são **simulados** (selo visível; gerar/apagar). |
| **Histórias** (`/`) | Criar e listar histórias: interativa (o público escolhe entre 2–4 vertentes por episódio, "Vertentes por decisão"), linear ou documental (vídeo único sobre fatos reais, com nomes reais e fontes). Regras de roteiro de cada formato: `doc/roteiro/`. Excluir (lixeira no cartão ou no topo da história): os arquivos vão para `data/trash/`. |
| **História** (`/stories/<id>`) | Abas **Episódios** (estágios, assets, envio), **Fluxo** (árvore estilo n8n: início, vertentes candidatas/escolhidas/descartadas, "Preparar vertentes" com a IA) e **Canais de publicação** que publicam a história. |
| **Canais de publicação** (`/accounts`) | Cada canal agrupa perfis de YouTube, TikTok e Instagram, conectados por API oficial ou sessão logada, e se liga a histórias e a fontes do Clipador; regras de aprovação e horário por canal. |
| **Publicações** (`/publishing`) | Fila de publicação: aguardando aprovação, agendadas, publicando, publicadas e com problema. |
| **Configurações** (`/settings`) | Pausar publicações, horários bons por rede, apps das redes (Client ID/Secret) e navegador do modo sessão. |
| **Episódio** (`/stories/<id>/episodes/<n>`) | Roteiro, cena (chamada e opções), render prévia/final com player, comentários, apuração e fechamento da votação, criação do próximo episódio a partir da escolha vencedora. |
| **Assets** (`/assets`) | Biblioteca compartilhada e assets exclusivos de cada história; envio e promoção para a biblioteca. |
| **Vozes** (`/voices`) | Estado do serviço de voz (GPU/CPU e motivo), ouvir cada voz com velocidade, adicionar/remover voz de personagem (RVC: `.pth` + `.index`, origem e licença obrigatórias), testar legenda (texto, frases ou palavras; baixa `.srt`) e configurações (dispositivo, Whisper, RVC). Fala com `voice/` (127.0.0.1:4510) por `/api/voice/*`; detalhes em [voice/README.md](../voice/README.md). |
| **Editor de corte** (`/clipper/edit/<id>`) | Tela cheia (sem o menu lateral), aberto pelo botão "Editar" do cartão do corte no Clipador. O corte chega com o projeto que a IA montou (gancho, legenda pop, zoom no pico, silêncios). Você ajusta o trecho pela transcrição ou pela timeline, legenda animada, textos, zoom, narração, música e capa, e exporta. Detalhes em [clipper/README.md](../clipper/README.md#editor-de-cortes-clipperedit-id). |
| **Agente** (`/agent`) | Pedido para Claude ou Codex, com tarefa (livre, roteiro, cena), modelo e contexto (história/episódio). Saída ao vivo, custo, cancelar, continuar a conversa, histórico. |
## Onde ficam os dados
| O quê | Onde |
|---|---|
| Metadados e estado (histórias, episódios, renders, assets, comentários, decisões, execuções de agente) | `data/cenaforge.db` (SQLite via `node:sqlite`, embutido no Node 24; ignorado pelo Git) |
| Logs de agentes e renders | `data/logs/` |
| Roteiros | `stories/<história>/biblia.md`, `stories/<história>/epNN.md` |
| Cena renderizável | `config/<história>-epNN.json` |
| Assets da história | `stories/<história>/assets/<tipo>/<asset-id>/` (arquivo + `asset.json`) |
| Biblioteca de assets | `assets/library/<tipo>/<asset-id>/` |
| Vídeos | `output/runs/` (gerados pelo lançador `pnpm render`) |
| Vertentes de um episódio | `stories/<história>/<file_key>.md` (ex.: `ep02-b.md`), opções em `<file_key>.choices.json`, cena em `config/<história>-<file_key>.json` |
| Backups antes de migrar o banco | `data/backups/` |
| Configuração da voz | `voice/.env` (chave, porta, dispositivo, Whisper, RVC) |
| Pesos de voz e vozes de personagem | `data/voice/models/` (Piper, Whisper, `rvc/<id>/`) e `data/voice/user-voices.json` |
## Agentes (Claude / Codex)
- O painel chama a CLI no servidor com `cwd` = raiz do repositório e o pedido como argumento,
sem shell e com a entrada padrão fechada.
- **Claude**: `claude -p … --output-format stream-json --verbose --permission-mode acceptEdits
--allowedTools …`. Edição automática só dentro do projeto. Bash só para os comandos liberados
em `src/lib/agents.ts` (`CLAUDE_ALLOWED_TOOLS`): render, verify, testes, typecheck, doctor e
scripts da skill. "Continuar conversa" usa `--resume <sessão>`.
- **Codex** (codex-cli 0.169.0, `npm install -g @openai/codex@0.169.0` e `codex login`):
`codex exec --json --skip-git-repo-check --sandbox workspace-write -C <raiz>`. O repositório não
é Git, por isso `--skip-git-repo-check`. "Continuar conversa" usa `codex exec resume <sessão>`
com `-c sandbox_mode="workspace-write"`, porque a retomada não aceita `--sandbox`/`-C`.
No Windows o npm instala `codex.cmd`, e o painel executa o `codex.js` do pacote pelo Node.
O Codex informa tokens, não custo em US$. O Codex lê o `AGENTS.md` da raiz, que remete ao `CLAUDE.md`.
- Um agente por vez; cancelar encerra a árvore de processos.
- Modelo: escolhido no console e no "Nova história com IA". A lista do Codex vem do cache da
própria CLI (`~/.codex/models_cache.json`), e o padrão é o `model` do `~/.codex/config.toml`. No
Claude, as tarefas **cena** e **vertentes** usam Sonnet 5.5 por padrão; as demais usam o padrão da CLI.
O custo de cada execução aparece no histórico (o Codex informa tokens, não US$).
- **Comentários do público nunca entram no prompt.** Só a escolha A/B já fechada.
## Votação
Regra (`src/lib/decisions.ts`):
- 1 voto por conta, e vale o último voto explícito.
- Só conta comentário que começa com A ou B ("A", "opção B", "B!", "voto no A").
- Comentário que cita as duas opções é ambíguo e não conta.
- Empate ou zero votos exigem decisão manual com justificativa.
Fechar a votação grava uma fotografia imutável (`decisions.snapshot_json`), e o próximo episódio
herda a escolha vencedora. Por enquanto, os comentários são colados no painel
(`autor: texto`); a integração com o Instagram é fase futura.
## Limitações atuais
- A cena Godot ainda usa só o cenário de rua e o entregador provisório. Assets enviados ficam
catalogados, mas **ainda não são carregados pela Godot**: é o próximo passo, com o nó
adaptador de GLB.
- Sem testes automatizados do painel nesta versão. A lógica foi testada por script (ver
`doc/TEST_RESULT.md`).
- Porta **4500**. Convenção do projeto: serviços locais do CenaForge usam a faixa 4500–4599, para não conflitar com outros projetos da máquina.