Skip to content

Operação do navegador e da conta Flow ​

Estado: procedimento planejado; nenhuma sessão foi criada neste projeto.

Sessão e segredos ​

O operador mantém FLOW_GOOGLE_EMAIL e FLOW_GOOGLE_PASSWORD em um .env privado, como solicitado. São dados de bootstrap opcionais: login do Google pode exigir MFA, verificação de dispositivo ou interação manual. O serviço nunca armazena códigos MFA nem automatiza CAPTCHA. Depois do login, o Chromium usa um perfil persistente em /data/browser-profile; esse volume contém cookies e deve ter acesso apenas ao processo do worker. O perfil não entra em git, backup genérico, logs ou artefatos de erro.

Arquivos de trabalho e downloads transitórios ficam em /data/artifacts, separados do perfil. O serviço remove sobras de execuções anteriores na inicialização e apaga a pasta de cada job ao terminá-lo ou falhar. Qualquer evidência diagnóstica que precise durar além do job deve usar armazenamento próprio com retenção automática limitada; não fica na pasta temporária.

Em produção, atpares-infra adicionará o container à rede privada atpares, com secrets/shorts.env fora do repositório e volume próprio para o perfil. O worker inicia com um usuário sem privilégios, limite de concorrência 1 e health check. A porta interna não será publicada no Caddy. A conexão para bootstrap manual pode ser um display temporário acessível apenas por túnel SSH; nunca expor VNC/DevTools à internet. A implementação deve testar o método de bootstrap no ambiente real antes de depender dele.

GET /api/health/live informa que o processo roda. GET /api/health/ready informa se browser, volume e comunicação com API estão prontos. GET /api/health/session informa apenas authenticated | needs_login | unknown; não retorna email, cookies ou página capturada. A API trata needs_login como intervenção do operador, sem tornar a publicação pronta.

Adaptador da interface ​

Separar a lógica de negócio do driver da UI:

text
JobRunner -> FlowAdapter -> Playwright/Chromium -> Google Flow
         -> DownloadVerifier -> UploadClient -> API/S3

FlowAdapter deve expor operações pequenas: ensureSession, openOrCreateProject, addReferences, generateScene, findScene, assembleSequence, exportSequence, readVisibleCredits e close. Ele interage somente com a interface pública renderizada. Seletores usam rótulos, papéis e estrutura estável; cada passo confirma o resultado esperado antes de prosseguir. Localização do Google em português ou inglês é uma variável de ambiente fixada para a sessão. Mudanças inesperadas geram UI_CHANGED.

Após cada ação que consome créditos, o worker registra no job o índice da cena, o modelo, duração, número de saídas e custo exibido. Se a UI não mostrar custo com confiança, pausa antes de clicar em gerar. Nenhum retry automático reaperta o botão de geração sem reconciliar o histórico visível. Consultas, downloads e montagem podem ter retry com backoff; geração paga não.

O Scenebuilder documenta ordenação, corte e download da sequência. O worker confere a sequência visualmente por metadados e espera o arquivo terminar de baixar. Um clipe curto isolado não satisfaz um job que pede Short completo. Se texto falado, música ou legenda fizerem parte do briefing e o Flow não os entregar no MP4, o candidato vai para revisão com observação; não é aprovado automaticamente.

Recuperação e observabilidade ​

  • Um job em execução mantém lease curto renovado por heartbeat. Expiração detecta queda do processo, mas não autoriza gastar créditos de novo.
  • Persistir no banco IDs do projeto/cena quando observáveis e no worker um manifesto local por job com passos concluídos; o banco continua soberano.
  • Em UI_CHANGED, guardar screenshot e trecho de DOM redigidos em diretório privado com retenção curta. O artefato nunca contém senha, cookies, URL assinada, token de serviço ou tela de login.
  • Métricas: duração por etapa, jobs por estado, falhas por código, clipes por job, créditos observados, downloads válidos e tempo até aprovação. Não registrar o prompt inteiro em métricas.
  • Alertar quando a sessão expirar, o browser travar, um job exceder o tempo previsto ou o custo observado alcançar o orçamento.

Verificações antes da operação ​

  1. Confirmar que a conta está elegível para Flow na região e que a função necessária está disponível no plano Pro.
  2. Conferir condições de uso e instruções aplicáveis à automação da interface. Se houver restrição incompatível, manter somente exportação/importação manual.
  3. Testar login interativo e persistência da sessão no container real.
  4. Rodar primeiro uma navegação sem clicar em geração paga; depois um job de orçamento mínimo autorizado pelo operador.
  5. Conferir MP4, áudio, verticalidade, sequência, conteúdo e publicação em ambiente de teste antes de habilitar produção.

Documentação Google: Scenebuilder, geração, créditos, termos gerais.