Files
MateuusandClaude Opus 5.5 84f30bbc2d 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>
2026-11-17 16:35:09 -03:00

88 lines
7.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.