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>
398 lines
26 KiB
Markdown
398 lines
26 KiB
Markdown
# Prompt de implementação — prova de conceito de vídeo em Godot
|
||
|
||
> Copie este documento para `doc/PROMPT_TESTE_VIDEO_GODOT.md` na pasta do projeto e peça ao Claude Code: **“Leia esse documento e implemente o teste de vídeo de ponta a ponta. Execute e valide o resultado quando o ambiente permitir.”**
|
||
>
|
||
> Este arquivo é uma especificação para implementação. Não significa que o projeto ou o vídeo já tenham sido implementados ou testados.
|
||
|
||
## 1. Sua missão
|
||
|
||
Atue como desenvolvedor responsável por implementar e executar uma prova de conceito local de produção de vídeos narrativos com Godot. Não entregue apenas arquitetura ou pseudocódigo. Crie os arquivos, execute os comandos disponíveis, corrija erros e entregue um MP4 reproduzível, se houver Godot e FFmpeg utilizáveis neste computador.
|
||
|
||
O objetivo imediato é provar que uma cena descrita por dados pode ser montada, animada e renderizada automaticamente. **O vídeo vem antes do painel.**
|
||
|
||
Não implementar agora Next.js, API Fastify, banco, Redis, autenticação, multiempresa, Electron, integração Instagram, integração Meshy, agentes ou skills. Essas ideias estão documentadas no final para evolução posterior. Não deixar esse futuro bloquear a prova de conceito.
|
||
|
||
Nome de trabalho opcional: CenaForge. Esse nome não foi aprovado definitivamente nem teve disponibilidade de marca/domínio verificada. Trabalhe na pasta atual fornecida pelo usuário; não crie uma pasta extra com esse nome se já estiver na raiz do projeto.
|
||
|
||
## 2. Contexto e decisões já tomadas
|
||
|
||
- O produto futuro produzirá histórias animadas, uma história por vez, divididas em episódios com decisões do público.
|
||
- A direção visual inicial mistura personagens e objetos próximos em 3D com fachadas distantes em imagens planas.
|
||
- Godot será o motor de cena neste teste.
|
||
- O primeiro plano mostra um motoboy andando de moto numa rua, observado por uma câmera em terceira pessoa, atrás e acima dele.
|
||
- A rua não deve ter nome de cidade, clube, empresa ou referências geográficas que restrinjam o público. Usar um bairro fictício de aparência brasileira.
|
||
- O usuário já tem Applio e outros projetos de narração no PC. **Não instalar, modificar nem integrar esses projetos agora.**
|
||
- A prova pode funcionar sem voz. Se houver um áudio que o usuário fornecer explicitamente, aceitar esse arquivo como entrada opcional.
|
||
- Não é necessário modelo do Meshy para começar. Construir modelos provisórios com primitivas é parte da implementação, e não motivo para interromper o trabalho.
|
||
- A aparência deve ser simples, mas legível: moto identificável, entregador com capacete e caixa de entrega, rua, calçadas, casas e horizonte.
|
||
|
||
## 3. Resultado esperado
|
||
|
||
Entregar uma cena vertical de **12 segundos a 30 FPS**:
|
||
|
||
1. Entre 0 e 1 segundo, câmera já enquadra a moto e o entregador, ambos visíveis.
|
||
2. Entre 1 e 9 segundos, a moto avança pela rua; a câmera acompanha por trás, com movimento estável.
|
||
3. Entre 9 e 10 segundos, a moto desacelera suavemente até parar.
|
||
4. Entre 10 e 12 segundos, surge uma chamada simples: “Uma entrega inesperada.” e duas opções visuais: “A — Aceitar” e “B — Continuar a rota”.
|
||
|
||
Essa chamada demonstra o formato futuro; **não implementar votação real**. O movimento e a mudança de enquadramento são o núcleo do teste.
|
||
|
||
Saídas:
|
||
|
||
- Prévia em 540 × 960, 30 FPS, MP4.
|
||
- Perfil final configurável em 1080 × 1920, 30 FPS. Renderizar primeiro a prévia e só depois tentar o perfil final.
|
||
- Arquivo de cena JSON utilizado em cada execução.
|
||
- Relatório do render com versões das ferramentas, tempo gasto, resolução, quadros produzidos e resultado de verificação.
|
||
- Imagens de conferência de momentos diferentes do vídeo.
|
||
|
||
Não prometer qualidade fotorrealista ou desempenho específico. O teste avalia a lógica e a viabilidade do fluxo.
|
||
|
||
## 4. Inspeção do ambiente antes de implementar
|
||
|
||
Leia instruções locais e preserve arquivos existentes. Descubra:
|
||
|
||
1. Sistema operacional e shell disponíveis.
|
||
2. Caminho e versão da Godot, usando `--version` e `--help`.
|
||
3. Caminhos de FFmpeg e FFprobe, consultando as versões.
|
||
4. Node.js e gerenciador de pacotes disponíveis, apenas para um lançador opcional.
|
||
5. Se há sessão gráfica e acesso à GPU para renderizar.
|
||
6. Espaço disponível no diretório de saída.
|
||
|
||
Alvo principal: Windows, mas manter os caminhos e comandos compatíveis com Linux quando possível. Não presumir que um executável do Windows pode ser chamado como binário Linux, nem depender de WSL para renderização.
|
||
|
||
Preferir uma versão estável da Godot 4 instalada, com GDScript. Não exigir a edição .NET. Consultar a documentação correspondente à versão instalada, fixar a versão testada no README e não atualizar instalações existentes sem necessidade.
|
||
|
||
Se um executável não estiver no PATH, aceitar variáveis `GODOT_BIN`, `FFMPEG_BIN` e `FFPROBE_BIN`. Não procurar indiscriminadamente por arquivos pessoais. Não baixar programas de fontes não oficiais.
|
||
|
||
Se o ambiente não permitir execução gráfica ou faltar dependência, continuar criando o projeto e executar as verificações possíveis. Informar exatamente o que não foi executado; nunca apresentar um arquivo vazio ou uma simulação como render real.
|
||
|
||
## 5. Estrutura mínima de arquivos
|
||
|
||
Criar na raiz do projeto:
|
||
|
||
| Caminho | Finalidade |
|
||
|---|---|
|
||
| `README.md` | Instalação, comandos, resultado e limitações |
|
||
| `doc/PROMPT_TESTE_VIDEO_GODOT.md` | Esta especificação |
|
||
| `doc/TEST_RESULT.md` | Evidências reais do teste e próximos passos |
|
||
| `godot/project.godot` | Projeto do motor |
|
||
| `godot/scenes/main.tscn` | Cena principal |
|
||
| `godot/scripts/main.gd` | Inicialização e orquestração |
|
||
| `godot/scripts/scene_config.gd` | Leitura e validação do JSON |
|
||
| `godot/scripts/street_builder.gd` | Rua, casas e cenário |
|
||
| `godot/scripts/rider_builder.gd` | Moto e entregador provisórios |
|
||
| `godot/scripts/timeline_controller.gd` | Tempo, deslocamento e eventos |
|
||
| `godot/scripts/camera_controller.gd` | Enquadramento por tempo |
|
||
| `godot/scripts/overlay_controller.gd` | Textos finais |
|
||
| `godot/assets/backgrounds/` | Imagens de fachadas/fundo |
|
||
| `godot/assets/models/` | GLBs opcionais futuros |
|
||
| `config/demo-street.json` | Cena de teste padrão |
|
||
| `config/demo-street-variant.json` | Segunda configuração para provar reutilização |
|
||
| `scripts/` | Comandos de importação, render e conversão |
|
||
| `output/` | Execuções locais, ignoradas pelo Git |
|
||
|
||
Separar responsabilidades sem criar uma arquitetura genérica excessiva. Se juntar dois scripts tornar a prova mais simples, isso é aceitável, desde que a configuração continue independente do motor.
|
||
|
||
Incluir `.gitignore` para `.godot`, `node_modules`, resultados de render, arquivos temporários, segredos e arquivos locais de áudio. Não ignorar cenas, scripts ou metadados de importação que a versão utilizada exija versionar.
|
||
|
||
## 6. Configuração de cena
|
||
|
||
Criar um contrato JSON pequeno, com versão. Este é o formato proposto; implementá-lo de verdade, adaptando nomes somente se o README e os exemplos forem atualizados juntos:
|
||
|
||
```json
|
||
{
|
||
"schemaVersion": 1,
|
||
"id": "demo-street",
|
||
"seed": 42,
|
||
"video": {
|
||
"width": 540,
|
||
"height": 960,
|
||
"fps": 30,
|
||
"durationSeconds": 12
|
||
},
|
||
"world": {
|
||
"streetLengthMeters": 100,
|
||
"roadWidthMeters": 8,
|
||
"nearHousesPerSide": 6,
|
||
"backgroundMode": "cards",
|
||
"lightingPreset": "warm_day"
|
||
},
|
||
"rider": {
|
||
"assetId": "placeholder-rider",
|
||
"bikeColor": "#D95437",
|
||
"startPosition": [0, 0, 0],
|
||
"travelMeters": 32
|
||
},
|
||
"motion": {
|
||
"startSeconds": 1,
|
||
"brakeStartSeconds": 9,
|
||
"stopSeconds": 10
|
||
},
|
||
"camera": {
|
||
"preset": "third_person_follow",
|
||
"offset": [0, 3.2, 6.5],
|
||
"lookAtOffset": [0, 1.2, -2],
|
||
"fovDegrees": 55
|
||
},
|
||
"overlay": {
|
||
"startSeconds": 10,
|
||
"title": "Uma entrega inesperada.",
|
||
"choiceA": "A — Aceitar",
|
||
"choiceB": "B — Continuar a rota"
|
||
},
|
||
"audio": {
|
||
"enabled": false,
|
||
"file": null,
|
||
"offsetSeconds": 0
|
||
}
|
||
}
|
||
```
|
||
|
||
Convenção do nosso projeto: Y é altura, a moto percorre o eixo -Z e a câmera está atrás em +Z. Isso é uma decisão desta cena, não uma suposição sobre a orientação de todo modelo importado. Conversões de GLB serão tratadas num nó adaptador.
|
||
|
||
Validar campos obrigatórios, tipos, números finitos, cores, intervalos de tempo e limites razoáveis antes de começar. Exigir que início < frenagem < parada ≤ duração e que FPS e resolução sejam positivos. Rejeitar versões desconhecidas e configurações inválidas com mensagem útil. Não aceitar código GDScript ou comandos shell dentro do JSON.
|
||
|
||
Argumentos próprios da aplicação devem ficar após `--` na linha de comando da Godot e ser lidos via `OS.get_cmdline_user_args()`. Expor no mínimo `--config` e, se necessário, um diretório de trabalho/resultado. Resolver caminhos relativos contra uma base documentada, nunca conforme um diretório de execução imprevisível.
|
||
|
||
## 7. Cenário e qualidade visual
|
||
|
||
### Rua
|
||
|
||
- Piso cinza com faixas discretas e calçadas em ambos os lados.
|
||
- Rua comprida o bastante para o percurso inteiro, sem revelar o fim do cenário.
|
||
- Casas próximas com volumes simples, telhados, portas e janelas que conservem perspectiva ao passar.
|
||
- Variação determinística de cor e altura baseada na seed.
|
||
- Alguns postes ou elementos repetidos para evidenciar deslocamento e profundidade.
|
||
- Não criar cidade aberta, tráfego, pedestres, navegação ou colisão física complexa.
|
||
|
||
### Moto e personagem
|
||
|
||
- Construir moto com duas rodas, quadro, banco, guidão e caixa de entrega.
|
||
- Entregador sentado, com tronco, braços, pernas e capacete construídos de primitivas.
|
||
- Ajustar as mãos para perto do guidão e os pés para perto dos apoios.
|
||
- Rodas devem girar de acordo com distância percorrida e raio; o motor não pode deslizar a moto com rodas paradas durante todo o plano.
|
||
- Inclinação e vibração, se usadas, devem ser sutis e determinísticas.
|
||
- É aceitável começar sem esqueleto e sem animação facial. Não exigir Mixamo, Meshy ou download pago.
|
||
|
||
### Casas distantes como imagens
|
||
|
||
- Criar ao menos uma camada distante com fachadas em textura sobre planos ou Sprite3D com billboard desabilitado.
|
||
- Gerar texturas simples localmente ou usar imagens de licença adequada já disponíveis; não depender de busca de assets para finalizar.
|
||
- Manter os planos orientados como fachadas fixas. Não fazer casas girarem para encarar a câmera.
|
||
- Posicionar fora do trecho pelo qual a moto passa de perto durante os 12 segundos.
|
||
- Evitar transparência excessiva, sobreposição e bordas recortadas chamativas.
|
||
- Não implementar troca dinâmica de LOD neste teste. Escolher 3D ou plano previamente por localização e enquadramento.
|
||
- Se houver comparação de desempenho, medir. Não afirmar ganho apenas porque o objeto é um sprite.
|
||
|
||
### Luz e câmera
|
||
|
||
- Usar iluminação simples, ambiente coerente e sombras nos objetos próximos, conforme suporte do renderizador.
|
||
- Começar com um perfil de render leve; documentar se foi usado Compatibility, Mobile ou Forward+ e por quê.
|
||
- Não exigir volumetria, iluminação global pesada ou texturas grandes.
|
||
- A câmera acompanha o protagonista sem entrar em casas, atravessar o chão ou cortar o capacete.
|
||
- Preservar uma área inferior para as opções e margens laterais confortáveis na composição vertical.
|
||
- HUD/textos em CanvasLayer ou estrutura equivalente; fonte legível e contraste adequado.
|
||
|
||
## 8. Tempo determinístico e movimento
|
||
|
||
O estado visual precisa ser controlado pelo tempo da cena, não pelo relógio real do sistema.
|
||
|
||
Implementar uma função central equivalente a `evaluate_at_time(t)` que calcule posição da moto, rotação das rodas, câmera e visibilidade do overlay. Em render, usar o relógio de frames controlado e verificar a correspondência com FPS. Em prévia, permitir avanço normal e reinício.
|
||
|
||
Não basear a posição em chamadas de tempo de parede. Evitar física de veículo para esse plano: o movimento é cinematográfico e pode ser calculado diretamente.
|
||
|
||
Definir uma curva de distância com aceleração e frenagem contínuas. A moto começa na posição configurada, atinge exatamente `travelMeters` no instante de parada e permanece ali. Não usar uma interpolação que provoque salto entre fases. A roda gira pela distância acumulada, usando ângulo = distância / raio, com eixo e sinal adequados ao modelo.
|
||
|
||
O estado deve ser igual ao avaliar o mesmo instante em duas execuções na mesma configuração. Não exigir identidade binária de pixels entre GPUs/renderizadores distintos.
|
||
|
||
Configuração alternativa: mudar cor da moto, distância, câmera e texto final apenas no JSON. Renderizar uma segunda prévia curta ou completa para provar que a cena não está inteiramente fixada no código.
|
||
|
||
## 9. Renderização e exportação
|
||
|
||
Godot oferece Movie Maker para renderização offline. Usar sua saída de sequência PNG e WAV quando disponível na versão instalada, e converter para MP4 com FFmpeg. Confirmar flags e nomes de arquivos reais antes de automatizar. Não supor que gravar a janela ou usar OBS é necessário. A integração de captura deve seguir a documentação oficial indicada nas referências.
|
||
|
||
Separar preparação/importação de renderização. O modo headless pode servir para tarefas sem imagem; **não presumir que ele oferece renderização 3D válida**. O render precisa de um backend gráfico funcional. Um comando pode abrir uma janela e ainda ser totalmente automatizado.
|
||
|
||
Modelo conceitual de chamada, a adaptar e testar com o executável instalado:
|
||
|
||
```text
|
||
godot --path godot --write-movie <saida>/frame.png --fixed-fps 30 -- --config <cena.json>
|
||
```
|
||
|
||
Usar encerramento normal da cena após o número esperado de quadros; não matar o processo no sucesso. Verificar a relação entre inicialização, primeiro frame e último frame para não incluir telas vazias. Usar timeout somente como proteção contra travamento.
|
||
|
||
Uma sequência de 12 segundos a 30 FPS deve produzir 360 quadros úteis. Confirmar o padrão numérico efetivo, o índice inicial e a duração final. Não confiar em uma mensagem de log como única prova.
|
||
|
||
Exemplo de conversão, somente depois de descobrir o padrão real dos PNGs:
|
||
|
||
```text
|
||
ffmpeg -framerate 30 -start_number <indice_inicial> -i <padrao_real_dos_pngs> -c:v libx264 -pix_fmt yuv420p -movflags +faststart -an <saida.mp4>
|
||
```
|
||
|
||
O exemplo sem áudio é suficiente para esta fase. Se `libx264` não estiver disponível, diagnosticar os encoders instalados e documentar a alternativa; não prometer uma opção inexistente.
|
||
|
||
Criar pastas de execução únicas, sem sobrescrever o último sucesso. Gravar `scene.json`, `render.log`, `report.json`, o MP4 e frames de inspeção dentro da pasta. Não servir credenciais, caminhos pessoais ou logs inteiros para nenhum serviço externo.
|
||
|
||
## 10. Áudio opcional e Applio
|
||
|
||
O áudio local será integrado depois. Não instalar TTS, não baixar modelos de voz, não configurar Applio e não assumir que ele oferece uma API específica.
|
||
|
||
Se implementar a entrada opcional agora:
|
||
|
||
- Aceitar somente arquivo indicado pelo usuário e validar sua existência.
|
||
- Obter duração via FFprobe.
|
||
- Compor áudio no FFmpeg, fora da Godot, para reduzir complexidade.
|
||
- Respeitar `offsetSeconds`, preencher silêncio quando necessário e limitar a saída à duração da cena.
|
||
- Se o áudio for maior, emitir um aviso claro de corte ou pedir ajuste de duração; não mudar a duração silenciosamente.
|
||
- Não usar `-shortest` de modo a truncar o vídeo quando o áudio acabar cedo.
|
||
- Codificar AAC quando adequado ao MP4 e preservar o arquivo de entrada.
|
||
|
||
Sem arquivo fornecido, o resultado é um vídeo silencioso válido. Não gerar narração falsa nem afirmar integração com o Applio.
|
||
|
||
## 11. Lançador local e TypeScript
|
||
|
||
Primeiro faça a Godot gerar a cena e o render. Depois, se Node já estiver disponível, crie um lançador TypeScript enxuto para unificar o comando. Essa camada é conveniente, mas não deve virar backend ou painel nesta fase.
|
||
|
||
Comandos desejados, que só devem aparecer no README se realmente implementados:
|
||
|
||
- `pnpm doctor`: checa executáveis, versões e diretórios.
|
||
- `pnpm preview`: abre a cena padrão na Godot.
|
||
- `pnpm render -- --config config/demo-street.json --profile preview`: gera a prévia.
|
||
- `pnpm render -- --config config/demo-street.json --profile final`: gera o perfil final.
|
||
- `pnpm verify -- --file <arquivo.mp4>`: verifica propriedades do vídeo.
|
||
|
||
Pode usar npm se já for o padrão do repositório. Fixar dependências e manter lockfile. Preferir TypeScript com `tsx` para os scripts se isso reduzir configuração.
|
||
|
||
O lançador deve usar criação de processo com lista de argumentos, sem concatenar comandos a partir do JSON e sem `shell: true` desnecessário. Suportar espaços nos caminhos. Capturar stdout/stderr, devolver exit code correto e distinguir renderização de conversão. Um processo de FFmpeg com erro não pode resultar em status de sucesso.
|
||
|
||
Executar só um render por vez. Não implementar fila distribuída. Se o usuário cancelar, encerrar subprocessos e marcar a execução como incompleta, preservando o último render válido.
|
||
|
||
## 12. Critérios de aceite
|
||
|
||
### Funcionais
|
||
|
||
- [ ] Projeto abre na Godot sem erros de parsing.
|
||
- [ ] A configuração externa é lida e validada.
|
||
- [ ] A cena contém moto, entregador, rua, casas 3D e fundo em planos.
|
||
- [ ] Câmera acompanha por trás durante o deslocamento.
|
||
- [ ] Moto avança e desacelera sem saltos visíveis.
|
||
- [ ] Rodas giram enquanto há deslocamento.
|
||
- [ ] Overlay aparece no período configurado.
|
||
- [ ] A prévia gera MP4 real, reproduzível e não vazio.
|
||
- [ ] FFprobe confirma codec, dimensões, FPS e duração com tolerância de até um frame para a duração planejada.
|
||
- [ ] Uma segunda configuração muda a cena sem editar scripts.
|
||
- [ ] O projeto funciona sem API paga, Meshy, Applio e Instagram.
|
||
|
||
### Verificação visual
|
||
|
||
Extrair e examinar quadros próximos de 0,5 s, 4 s, 8 s e 11 s. Abrir também o vídeo quando houver ferramenta disponível. Conferir:
|
||
|
||
- Nada de vídeo preto, câmera dentro de geometria ou texturas ausentes.
|
||
- Personagem reconhecível e devidamente apoiado na moto.
|
||
- Mudança de perspectiva dos objetos próximos.
|
||
- Fundo sem rotação artificial nem aparecimento de bordas dos planos.
|
||
- Sem z-fighting importante ou recortes nos textos.
|
||
- Overlay legível em tamanho reduzido.
|
||
- Luz e cores consistentes durante a tomada.
|
||
|
||
Se não houver meio de inspecionar imagens, declarar “validação visual pendente”, mesmo que o FFprobe passe.
|
||
|
||
### Testes pequenos e úteis
|
||
|
||
Testar rejeição de JSON inválido, intervalos de tempo impossíveis e arquivo de áudio inexistente. Testar posição inicial/final e estabilidade da avaliação temporal. Verificar falhas de subprocessos no lançador, se ele existir. Não construir uma suíte enorme para funções triviais.
|
||
|
||
Não fazer promessas de duração de render antes de medir. Registrar resolução, renderizador, versão da Godot, hardware disponível e tempo total observado.
|
||
|
||
## 13. Sequência de implementação
|
||
|
||
1. Inspecionar ambiente e registrar versões.
|
||
2. Criar projeto mínimo Godot com piso, luz, câmera e um objeto visível.
|
||
3. Criar rua, moto e entregador provisórios.
|
||
4. Implementar JSON e controle temporal.
|
||
5. Acrescentar casas próximas e fachadas distantes.
|
||
6. Renderizar uma amostra de 2 segundos para validar captura e conversão.
|
||
7. Gerar a prévia completa de 12 segundos.
|
||
8. Inspecionar quadros e corrigir enquadramento/movimento.
|
||
9. Testar a variante JSON.
|
||
10. Adicionar lançador TypeScript se isso for viável sem expandir o escopo.
|
||
11. Tentar perfil final e registrar resultado, sem bloquear a entrega da prévia se faltar recurso.
|
||
12. Atualizar README e `doc/TEST_RESULT.md` com evidências reais.
|
||
|
||
Quando o vídeo estiver funcionando, parar e entregar. Não iniciar o painel automaticamente.
|
||
|
||
## 14. Como entregar ao usuário
|
||
|
||
Informar de forma objetiva:
|
||
|
||
1. O que foi implementado.
|
||
2. Caminho do MP4 e da configuração.
|
||
3. Comando exato para reproduzir o render.
|
||
4. Quais testes foram executados e resultados.
|
||
5. Quais partes continuam provisórias.
|
||
6. Dependências faltantes, se houver.
|
||
|
||
Não dizer “funciona” apenas porque o código foi escrito. Distinguir código criado, validação estática, projeto iniciado, MP4 gerado e inspeção visual.
|
||
|
||
## 15. Evolução futura — contexto, não tarefas desta entrega
|
||
|
||
### Painel e execução
|
||
|
||
Depois de validar o vídeo: painel Next.js + React + TypeScript + Tailwind, API Node/TypeScript (Fastify é a preferência inicial), contratos de cena compartilhados e executor local que chama Godot/FFmpeg. O navegador não deve tentar abrir executáveis arbitrários diretamente. Na primeira versão, tudo poderá rodar como projeto local, sem instalador.
|
||
|
||
O painel futuramente terá projetos, histórias, episódios, catálogo, planejamento de cenas, prévia, render e histórico. O estado de jobs deve persistir antes de introduzir agendamento. Banco e fila serão escolhidos conforme escala; MySQL e Redis são opções conhecidas do usuário, não requisitos desta prova.
|
||
|
||
Electron, instalador, distribuição comercial, tenancy e cobrança são posteriores. Não adicioná-los agora. Manter apenas limites claros entre configuração, renderizador e interface.
|
||
|
||
### IA e catálogo
|
||
|
||
O futuro planejador recebe história e catálogo de recursos e retorna dados de cena validados. Não recebe autoridade irrestrita para gerar e executar scripts arbitrários. Um adaptador de IA pode usar API ou integração oficialmente suportada por ferramentas locais; validar autenticação, limites e condições de cada fornecedor antes de prometer conexão por CLI.
|
||
|
||
O catálogo acumula personagens, objetos, cenários, animações e planos reutilizáveis. Cada recurso deverá ter ID, versão, caminho, tipo, escala, orientação, licença/origem e capacidades. Uma porta estática é diferente de uma porta que abre; um personagem com animação de andar não está automaticamente preparado para pilotar moto.
|
||
|
||
Identificar recursos disponíveis, que precisam de adaptação e ausentes. Fixar versões por episódio. Meshy poderá produzir GLBs no futuro; testar malha, materiais, esqueleto e animações antes de registrar como recurso utilizável. Rig corporal não garante lip sync ou atuação facial.
|
||
|
||
### Narração
|
||
|
||
Integrar posteriormente os projetos de áudio locais existentes, incluindo o fluxo com Applio, conforme suas interfaces reais. Usar duração efetiva da narração para planejar cenas. Não supor que o Applio isoladamente recebe texto e devolve fala sem conhecer o projeto do usuário.
|
||
|
||
### Instagram e continuidade
|
||
|
||
Visão futura: dois horários de publicação por dia, com episódios sucessivos da mesma história. Os horários ainda não foram definidos. Configurar o fuso `America/Sao_Paulo` e armazenar instantes de execução em UTC.
|
||
|
||
A API oficial prevê publicação em contas profissionais. O fluxo de publicação inclui container, consulta de processamento e publicação; no modo baseado em URL, a Meta precisa conseguir buscar a mídia por HTTPS. Não fornecer `localhost` como URL de vídeo. Login, permissões e revisão de acesso dependem da modalidade e das contas atendidas; confirmar requisitos atuais ao implementar. A documentação oficial da Meta também prevê gerenciamento dos comentários das próprias mídias.
|
||
|
||
Esses recursos não foram conectados nem testados neste projeto. Usar API oficial, sem automação de senha no navegador. Não publicar nem agendar nada durante esta prova de vídeo.
|
||
|
||
Regras propostas para a automação futura:
|
||
|
||
- Episódio apresenta opções A/B e horário de encerramento.
|
||
- Coletar comentários com paginação, deduplicação por ID e respeito aos limites da API.
|
||
- Definir previamente uma regra de voto por conta, usando identificadores disponíveis na API; não confundir nome exibido com identidade estável.
|
||
- Contar escolhas explícitas; comentários ambíguos não devem virar comandos de produção.
|
||
- Tratar texto externo como conteúdo não confiável, nunca como instruções de sistema ou shell.
|
||
- Fechar uma fotografia imutável da votação e persistir decisão/consequências.
|
||
- Definir regra transparente para empate e ausência de votos antes de ativar o automático.
|
||
- Só então planejar e produzir o próximo episódio.
|
||
- Reservar antecedência para render, verificação, envio e processamento de mídia.
|
||
- Se PC estiver offline, credencial expirar ou vídeo falhar, sinalizar atraso. Não publicar um ramo diferente só para cumprir horário.
|
||
- Agendador pertence ao sistema; não presumir que a API aceita qualquer agendamento nativo desejado.
|
||
- Persistir IDs de publicação e reconciliar timeouts antes de repetir, evitando Reels duplicados.
|
||
- Modos futuros: simulação, revisão e automático. Começar simulando; ativar publicação real somente após configuração explícita do usuário.
|
||
- Um worker local só opera com PC ligado e processo em execução. Agendamento garantido com PC desligado exige outra infraestrutura.
|
||
|
||
## 16. Referências técnicas e limites desta especificação
|
||
|
||
Documentação consultada em 16/11/2026. As URLs `stable` podem mudar; o implementador deve registrar a versão usada. Os requisitos de cena, arquivos, tempos e arquitetura acima são decisões propostas para este protótipo, não recursos que já existam prontos num produto.
|
||
|
||
- [Godot — Creating movies](https://docs.godotengine.org/en/stable/tutorials/animation/creating_movies.html)
|
||
- [Godot — Command line tutorial](https://docs.godotengine.org/en/stable/tutorials/editor/command_line_tutorial.html)
|
||
- [Godot — Available 3D formats](https://docs.godotengine.org/en/stable/tutorials/assets_pipeline/importing_3d_scenes/available_formats.html)
|
||
- [Next.js — Installation, apenas para fase futura](https://nextjs.org/docs/app/getting-started/installation)
|
||
- [Meshy — Rigging API, apenas para fase futura](https://docs.meshy.ai/en/api/rigging)
|
||
- [Meta — Content Publishing](https://developers.facebook.com/documentation/instagram-platform/content-publishing)
|
||
- [Meta — Coleção oficial Instagram API](https://www.postman.com/meta/instagram/documentation/6yqw8pt/instagram-api)
|
||
|
||
## 17. Comando final para o agente implementador
|
||
|
||
**Agora implemente a prova de conceito descrita. Comece pelo vídeo, use modelos provisórios e não espere integrações externas. Faça escolhas simples dentro deste escopo e registre-as. Valide o resultado real antes de afirmar sucesso. Entregue o MP4, os arquivos do projeto e os comandos de reprodução. Não implemente painel, SaaS ou publicação no Instagram nesta fase.**
|