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>
88 lines
7.0 KiB
Markdown
88 lines
7.0 KiB
Markdown
# 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.
|