# 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/`) | 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//episodes/`) | 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/`) | 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//biblia.md`, `stories//epNN.md` | | Cena renderizável | `config/-epNN.json` | | Assets da história | `stories//assets///` (arquivo + `asset.json`) | | Biblioteca de assets | `assets/library///` | | Vídeos | `output/runs/` (gerados pelo lançador `pnpm render`) | | Vertentes de um episódio | `stories//.md` (ex.: `ep02-b.md`), opções em `.choices.json`, cena em `config/-.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//`) 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 `. - **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 `. O repositório não é Git, por isso `--skip-git-repo-check`. "Continuar conversa" usa `codex exec resume ` 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.