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
+68
View File
@@ -0,0 +1,68 @@
# Guia de roteiro — regras comuns (todos os formatos)
Fonte única de regras de texto do CenaForge. Vale para **qualquer IA** que escreva roteiro:
o Codex (pelo prompt do painel) e o subagente `cenaforge-story-writer` do Claude leem estes
mesmos arquivos. Leia este e depois o guia do formato da história:
| Formato (`kind` no painel) | Guia |
|---|---|
| `interactive` — interativa, com votação | [ficcao.md](ficcao.md) |
| `linear` — ficção em sequência, sem votação | [ficcao.md](ficcao.md) |
| `documentary` — vídeo único sobre fatos reais | [documental.md](documental.md) |
O formato vem no pedido. Se não vier, está na primeira linha de `stories/<id>/biblia.md`
(`Formato: interativa | linear | documental`). Na dúvida, pergunte em vez de supor.
## Idioma e tom
- Português do Brasil, natural e falado, para público amplo.
- Vídeo vertical (9:16), curto. Narração: ~2,5 palavras por segundo de cena.
- Na narração (o que a voz fala), números por extenso ("cinco", não "5"); no texto na tela,
algarismos. Parágrafos de narração curtos: o áudio é gerado trecho a trecho.
- Sem violência gráfica, sexo ou discurso de ódio. Tensão, humor e curiosidade, sim.
## Onde ler e onde escrever
- Antes de escrever, leia `stories/<id>/` (bíblia e episódios anteriores), se existir. Mantenha
continuidade de nomes, fatos, tom e consequências.
- Escreva **somente** dentro de `stories/<id>/`:
- `biblia.md` — primeira linha `Formato: <formato>`; o resto segue o guia do formato;
- `<file_key>.md` (ex.: `ep01.md`, `ep02-b.md`) — roteiro, no formato do guia;
- `meta.json` — quando o pedido mandar: `{"title": "<até 60 caracteres>", "logline": "<1–2 frases>"}`.
- Nunca edite `config/`, `godot/`, `scripts/`, `panel/`, `.claude/` nem a documentação do projeto.
Não crie cena JSON nem renderize numa tarefa de roteiro.
## Estrutura de vídeo curto
| Bloco | Função |
|---|---|
| Gancho (0–2 s) | imagem forte + texto na tela: afirmação, pergunta ou ação já em andamento |
| Contexto | o mínimo para entender o que está em jogo |
| Escalada | cada beat aumenta tensão, graça ou surpresa; troca visual a cada 2–4 s |
| Pagamento | a resposta, o susto, a risada — ou a escolha (interativa) |
Nunca prometa no gancho o que o vídeo não entrega.
## Limites de texto do contrato JSON (conte os caracteres)
| Campo | Limite |
|---|---|
| `overlay.title` | 1–80 caracteres, uma frase curta; ideal ≤ 30 para caber em 2 linhas |
| `overlay.choiceA` / `choiceB` | 1–48 caracteres (só ficção interativa); ideal ≤ 24 |
| quebra de linha, tabulação | proibidas nesses campos |
## Produção
A cena atual do projeto é limitada (rua com o entregador de moto: andar, frear, parar). Tudo que
o roteiro pedir além disso (outro cenário, personagem, mapa, foto, animação, boca mexendo) vai na
seção **Necessidades de produção**, em vez de fingir que já existe.
## Economia
Seja direto: não reescreva a bíblia inteira a cada episódio, só acrescente o que mudou. Não leia
arquivos fora de `stories/` e de `doc/roteiro/` a menos que o pedido cite um.
## Retorno
Responda em poucas linhas: arquivos escritos, o bloco de overlay (com a contagem de caracteres de
cada campo), as fontes (documental) e as necessidades de produção.
+72
View File
@@ -0,0 +1,72 @@
# Guia de roteiro — documental (formato `documentary`)
Leia antes [comum.md](comum.md). Um **vídeo único**, vertical, sobre um tema real: um lugar, um
fenômeno, um fato histórico, uma curiosidade. Não é série interativa nem ficção. As restrições de
[ficcao.md](ficcao.md) **não valem** aqui.
## Regras
- **Nomes reais:** cite pelo nome cidades, estados, países, lugares, instituições, espécies e
pessoas públicas. É isso que dá credibilidade ao vídeo.
- **Fato com fonte:** confira cada afirmação em fonte confiável (instituição científica, órgão
público, universidade, imprensa reconhecida) e liste as fontes no roteiro. Número incerto vira
"estima-se" ou sai. Fonte que discorda de outra: diga que há divergência.
- **Mito × fato:** se o tema tem lenda famosa, conte a lenda como lenda e mostre o que se sabe.
- **Sem sensacionalismo** que contrarie as fontes. Pessoas privadas não são citadas pelo nome.
- **Duração:** 45–90 s de narração (110–220 palavras), salvo se o pedido indicar outra.
- **Narração por trecho:** cada linha da tabela é um parágrafo curto (1 a 2 frases, até ~35
palavras). O painel gera um áudio por trecho; parágrafo longo deixa a voz sintética estranha.
- **Números na narração por extenso:** "cinco", "trinta e cinco quilômetros", "onze mil anos",
"cinquenta e cinco por hectare". A voz lê melhor. Na coluna **Texto na tela**, use algarismos
("35 km de Itanhaém"), que é o que o público lê rápido. O painel ainda converte o que escapar.
- **Ritmo:** gancho forte nos 2 primeiros segundos; um fato surpreendente a cada 10–15 s; fecho com
convite a seguir ou comentar. Sem votação, sem opções A/B.
## `biblia.md` — ficha de pauta
```markdown
Formato: documental
# <tema>
## Ângulo (a pergunta que o vídeo responde)
## Público e tom
## Fatos confirmados
| Fato | Fonte (instituição) | Link |
## Mitos a desmentir (o que se diz × o que as fontes dizem)
## Referências visuais (lugares, mapas, espécies, imagens de arquivo)
```
## Como o vídeo é montado (painel → página do vídeo → Montagem)
Cada trecho vira um áudio próprio (voz escolhida, texto falado editável) e um visual escolhido
pelo admin: **imagem** (com zoom lento), **clipe de vídeo**, **cena 3D do Godot** (vídeo já
renderizado) ou **cartela de texto**; dá para misturar no mesmo vídeo. A coluna "Imagem / B-roll"
é a orientação para escolher esse visual: descreva o que deve aparecer, de forma que dê para achar
em banco livre (Wikimedia Commons, Pexels…) ou fotografar. Animação 2D no Godot ainda não existe.
## Vídeo todo em 3D (estilo "Tudo em 3D" da montagem)
Quando o pedido for um vídeo em 3D, cada trecho vira uma cena 3D do Godot (biblioteca em
`godot/library/`, guia `doc/godot/cenas.md`), e fotos reais aparecem num **cartão** por cima.
- Na coluna **Imagem / B-roll**, descreva a TOMADA 3D: lugar, personagem, ação e câmera
(ex.: "Lancha balançando no mar agitado à noite, câmera baixa perto da água").
- Quando uma foto real precisar aparecer, marque `[foto: termos de busca]`
(ex.: `[foto: Bothrops insularis]`). Use nomes específicos: o nome científico ou o nome do lugar.
- Personagem (pessoa real de notícia): descreva roupa, idade aproximada e ação. A cena 3D é
estilizada e respeitosa, sem caricatura.
- Liste em **Necessidades de produção** as cenas 3D que ainda não existem na biblioteca
(ex.: "cena 3D: lancha naufragando perto da ilha à noite"). É a lista de trabalho do agente
da tarefa "Cena no Godot".
## Formato do roteiro (`ep01.md`)
```markdown
# <título do vídeo>
Duração alvo: <N> s · Formato: documental (vídeo único)
## Gancho (0–2 s)
## Roteiro cena a cena
| t (s) | Imagem / B-roll | Texto na tela | Narração |
## Texto de capa / overlay.title (até 80 caracteres, ideal ≤ 30)
## Fontes (título, instituição, link e o fato que cada uma sustenta)
## Necessidades de produção (cenário, imagens, mapas, animações que a cena atual ainda não faz)
```
+47
View File
@@ -0,0 +1,47 @@
# Guia de roteiro — ficção (formatos `interactive` e `linear`)
Leia antes [comum.md](comum.md). Histórias animadas curtas, publicadas um episódio por vez
(~12 s cada). Na **interativa**, o público escolhe nos comentários o que acontece no próximo
episódio. Na **linear**, os episódios seguem em sequência, sem votação.
## Restrições do produto (não negociáveis)
- Sem nomes de cidade, bairro real, clube, empresa ou marca. Use bairro fictício de aparência
brasileira e apps e lojas com nomes inventados e genéricos.
- Sem pessoas reais.
- **Interativa:** cada episódio termina numa decisão clara entre ações concretas e diferentes
(2 a 4 opções, conforme a história). Nada de opção "certa" óbvia: todas precisam ter custo e graça.
- **Linear:** cada episódio termina num gancho para o próximo, sem escolha do público.
- Episódio de série abre com recapitulação em 1 frase, para quem chegou agora.
## `biblia.md`
```markdown
Formato: interativa | linear
# <título>
## Premissa
## Personagens (nome, traço, objetivo)
## Lugar
## Tom
## Regras do mundo
## Arco previsto
```
## Formato de `<file_key>.md`
```markdown
# Episódio NN — <título interno>
Duração alvo: 12 s · Escolha anterior: <letra e o que foi> (ou "início")
## Resumo (2–3 frases)
## Cena a cena
| t (s) | Imagem | Narração / diálogo |
## Chamada final
## Campos de overlay (copiar para o JSON)
{"title": "...", "choiceA": "A — ...", "choiceB": "B — ..."}
## Consequência de cada escolha (semente do próximo episódio)
## Necessidades de produção (o que a cena atual ainda não faz)
```
Na linear, os campos de overlay têm só `title`, e a seção de consequências vira "Gancho para o
próximo episódio". As opções seguem o formato `A — <ação>`, `B — <ação>`.