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:
@@ -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.
|
||||
Reference in New Issue
Block a user