Vellumdocs

Pipeline

As etapas que levam roteiro e narração até o vídeo, na ordem em que o motor as executa.

#As etapas

  1. Efeitos sonorosNormaliza os efeitos sonoros usados na trilha.
  2. Narração geradaSó quando a geração pede voz sintética: gera o áudio a partir do roteiro.
  3. TranscriçãoO reconhecimento de fala (faster-whisper) marca o tempo de cada palavra ouvida.
  4. AlinhamentoCasa o roteiro com as palavras ouvidas. Precisa cobrir pelo menos 90% do roteiro.
  5. Cenas, beats e legendasDivide o roteiro em cenas, subdivide em trechos de cerca de 4 s cortados nas pausas e monta as legendas.
  6. Diretor semânticoA IA lê o roteiro inteiro e decide, cena a cena, o que mostrar. Resultado validado e guardado em cache.
  7. Bíblia visualJunta as decisões do diretor com a galeria do nicho e lista as imagens que faltam.
  8. NarrativaAgrupa cenas em páginas e decide os desenhos e as relações de cada página.
  9. ComposiçãoDecide posição, tamanho, tempo de desenho e as rotas das setas.
  10. ContornosCalcula o caminho que a mão percorre em cada imagem.
  11. Cobertura de imagensLista o que falta. Imagem obrigatória faltando para a geração aqui.
  12. Relatório de ediçãoConfere as regras de qualidade. Erro bloqueante para a geração aqui.
  13. RenderDesenha o vídeo com o Remotion, seguindo o plano sem tomar decisões.

#O contrato: o plano do vídeo

Toda decisão criativa termina num único arquivo, src/generated/video-plan.json. O render só lê esse plano: ele não decide nada, não chama IA e funciona sem internet depois que as imagens e os caches existem.

Decisão no planner, nunca no render

Se algo está errado na tela, a correção é na etapa que decidiu aquilo (diretor, narrativa ou composição), não no componente que desenha.

#Onde cada coisa é decidida

ProblemaCamada responsável
Mostrou a coisa erradaDiretor semântico ou galeria
Apareceu cedo ou tarde demaisAlinhamento, anchors ou planner
Posição, tamanho, repetição ou setaComposição
Traço, mão, reveal da imagemRender
Texto no idioma erradoArquivos de tradução ou prompt do diretor
Imagem faltandoGaleria e cobertura

#Entradas e saídas por idioma

TipoCaminho
Entradainput/<idioma>/roteiro.txt e narracao.* (ou narracao-gerada.wav)
Cachecache/<idioma>/ (transcrição, análise, relatórios)
Planosrc/generated/video-plan.json (sempre o último idioma preparado)
VídeoPasta de saída, por idioma (no app, por nicho e canal)

#Prévia de 60 segundos

A prévia prepara o plano completo e limita só o render ao primeiro minuto. Por isso métricas, decisões e problemas são os mesmos do vídeo completo, e a cobertura só exige as imagens que aparecem nesse minuto.

#Cache e custo

O que mudaO que é refeito
Áudio, roteiro ou parâmetros do reconhecimento de falaTranscrição
Roteiro, cenas, galeria, perfil do nicho, estilo do vídeo, modelo ou instruções do diretorAnálise do diretor (paga)
Só composição ou renderNada pago: transcrição e análise vêm do cache

Quando uma imagem pedida pelo diretor é importada com a descrição compatível, o motor tenta atualizar a decisão pendente sem pagar uma leitura completa do roteiro.