Appearance
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_operatorantes 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_jobsevideo_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.runpara não iniciar Remotion quando o motor forflow_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
videoKeyeMediaPublisherServicepara publicação social. - Política inicial da automação semanal: ela não gera Flow sozinha e não publica
short_videosem 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
| Tema | Hipótese inicial | Evidência necessária |
|---|---|---|
| Login Google | Sessão persistente com renovação manual | Reinício e expiração real |
| Flow em container | Chromium com display virtual | Navegação e download no VPS |
| Custos | UI exibe custo antes de gerar | Captura durante o piloto |
| Áudio/voz/legenda | Prompt pode orientar a geração | Inspeção humana do MP4 |
| Vídeo exportado | Scenebuilder baixa sequência completa | Arquivo local e ffprobe |
| Tamanho | Upload direto S3 evita passar MP4 pelo painel | Teste do arquivo real |
Se uma hipótese falhar, atualizar estes documentos antes de adaptar o código.