Skip to content

Plano de implementação ​

Este documento define ordem e critérios de aceite. A implementação começou no atpares-shorts; nenhuma mudança foi implantada no Atpares em produção.

Decisão atual: manter o trabalho isolado em atpares-shorts para testar e refinar o uso do Flow. As fases de API Atpares, painel e deploy descritas abaixo ficam suspensas. A assinatura Pro cobre apenas o uso da interface Flow; a integração com API de vídeo paga foi descartada por custo. O operador pode continuar usando o gerador Flow manualmente para os poucos Shorts complexos.

Progresso em 30/09/2026 ​

  • Repositório inicializado e documentação centralizada no atpares-docs.
  • Núcleo NestJS/TypeScript no padrão do atpares-api, com módulo, controllers, guard, DTO validado, API interna autenticada, fila de um job por vez, cliente de eventos da API Atpares e perfil persistente do Chromium.
  • Sonda de sessão e parada em needs_operator antes de gerar mídia paga.
  • Limpeza automática de artefatos transitórios ao iniciar e no encerramento de cada job, com teste; o perfil autenticado fica separado.
  • Ainda pendentes: inspeção autenticada do Flow, automação das cenas, Scenebuilder/download, upload S3, rotas e banco da API, painel e deploy.
  • Prova de login em container: a página atual redireciona para flow.google.com/about; ao entrar pelo botão do Flow, o Google recusou o Chromium headless como navegador potencialmente inseguro. Um teste headed com display virtual não concluiu e foi encerrado. Não há sessão autenticada nem validação da interface de criação; o acesso precisa de intervenção do operador e nova prova de viabilidade antes de usar créditos.

0. Prova de viabilidade ​

  • Confirmar condições aplicáveis à automação e recursos atuais da conta Pro.
  • Provar que um perfil Chromium autenticado sobrevive ao reinício do container.
  • Fazer navegação somente leitura pelo Flow com Playwright e verificar seletores de projeto, geração, Scenebuilder e download.
  • Gerar uma única sequência de teste dentro de orçamento explícito, baixar MP4 e medir custo/tempo reais. Nenhuma etapa exige senha no código.

Aceite: o operador consegue renovar a sessão, o worker identifica desafios sem contorná-los, e há um MP4 local íntegro com custo observado.

1. Núcleo do serviço ​

Criar atpares-shorts em NestJS/TypeScript, com módulos de configuração, cliente da API Atpares, fila de execução, FlowAdapter, verificador de download, envio ao S3 e health. Configurar 1 job ativo por perfil, cancelamento cooperativo, timeouts por etapa e logs redigidos. O pacote começa sem endpoint público e sem acesso direto ao banco.

Aceite: um job fictício percorre contrato e estado sem abrir o Flow; restart, duplicação de mensagem e falha de rede não criam execução duplicada.

2. API Atpares ​

  • Migração para videoEngine, videoOrigin, currentVideoJobId, video_jobs e video_assets.
  • CRUD de jobs com autenticação do proprietário, idempotência e transições atômicas. Dispatcher e lease duráveis. Allowlist de projetos e tetos agregados de créditos da conta operadora.
  • Rotas internas com token de serviço; tickets S3 de GET/PUT curtos; validação de mídia no servidor e aprovação humana.
  • Adaptar PublicationsService.run para não iniciar Remotion quando o motor for flow_web. O endpoint antigo de Remotion rejeita o motor Flow.
  • Invalidar o vídeo aprovado ao trocar o motor ou alterar conteúdo incluído no briefing, guardando o arquivo anterior no histórico.
  • Reusar videoKey e MediaPublisherService para publicação social.
  • Política inicial da automação semanal: ela não gera Flow sozinha e não publica short_video sem vídeo aprovado.

Aceite: o pipeline Remotion existente continua funcionando; candidatos Flow inválidos ou obsoletos nunca alteram videoKey nem são publicados.

3. Painel Atpares ​

Adicionar escolha Flow/Remotion, apresentação do orçamento por job, botão de iniciar, estado persistido, prévia, aprovação, cancelamento, retomada de sessão e importação manual do MP4. A interface explica quando a sessão do Google precisa de intervenção e mostra custo observado. Um Short Flow aprovado aparece na prévia e no fluxo de publicação já existentes.

Aceite: o usuário vê o estado correto após recarregar a página e não pode aprovar vídeo de uma revisão antiga ou publicação já enviada.

4. Infraestrutura e operação ​

atpares-infra adiciona container privado, volume do perfil e secrets fora do git. Deploy separado de atpares-shorts sincroniza o código e atualiza somente o serviço novo. Definir retenção de downloads e artefatos, health checks, alertas e recuperação de sessão. Um flag na API desliga novos jobs Flow sem alterar Remotion ou arquivos já aprovados.

Aceite: reiniciar API, Redis ou worker durante um job preserva estado; lease expirado não repete geração paga; a publicação atual permanece disponível.

5. Piloto e expansão ​

Executar um Short real com roteiro, referências, quatro cenas, sequência final, áudio e revisão humana. Comparar duração, créditos, taxa de correção e trabalho manual contra o Remotion. Só após esse piloto avaliar geração automática para pautas selecionadas e segunda conta/perfil; cada conta exigirá isolamento de fila, sessão e orçamento.

Aceite: vídeo aprovado chega ao mesmo publicador de Instagram/Facebook e a origem aparece no histórico. O SynthID permanece no arquivo.

Decisões que precisam ser medidas na prova ​

TemaHipótese inicialEvidência necessária
Login GoogleSessão persistente com renovação manualReinício e expiração real
Flow em containerChromium com display virtualNavegação e download no VPS
CustosUI exibe custo antes de gerarCaptura durante o piloto
Áudio/voz/legendaPrompt pode orientar a geraçãoInspeção humana do MP4
Vídeo exportadoScenebuilder baixa sequência completaArquivo local e ffprobe
TamanhoUpload direto S3 evita passar MP4 pelo painelTeste do arquivo real

Se uma hipótese falhar, atualizar estes documentos antes de adaptar o código.