3 KiB
Botão "Conectar com o Google" na agenda substitui a configuração manual da service account (2026-09-12): ativar o espelho Google Calendar (C114/C115) exigia cerimônia de engenharia — criar service account no GCP, baixar JSON, base64 numa env e compartilhar o calendário; agora candidato ou coordenação clica Conectar com o Google no diálogo do espelho e autoriza uma única concessão (Authorization Code + access_type=offline + prompt=consent) para o calendário da campanha. O refresh token é gravado na própria collection googleCalendarSync (5 campos oauth*, oauthRefreshToken com read: false — inalcançável por qualquer caminho de usuário, como o segredo do webhook); a migration 20260912_052226_add_google_calendar_oauth_connection é aditiva/nullable e o schema continua com push: false. O motor resolve a credencial por readGoogleCalendarAuth (OAuth vence quando há token + client env; service account segue fallback intacto) e o client ganhou a união GoogleCalendarAuth (refresh_token grant) mantendo os 6 métodos e o retry de 401. A conexão tem exatamente três estados derivados (conectado | erro | não configurado): invalid_grant vira error com reconexão em um clique (GoogleCalendarAuthError → oauthErrorPatchFor, pinado em unit), e o sucesso limpa o erro — falha do Google nunca corrompe o Teqo. O handshake usa escopos mínimos (calendar.events + calendar.calendarlist.readonly, validados na concessão para o consent granular não conectar sem permissão de escrita), state HMAC-SHA256 single-use de 10min amarrado ao usuário (cookie campaign-google-oauth-state, padrão WebAuthn), callback GET fora do (app) com redirect sempre na URL pública (getCampaignInviteBaseURL() — nada de localhost atrás do túnel) e re-checagem do papel fresco. Desconectar limpa a conexão no Teqo e orienta revogar o app no Google. UI: card de conexão no GoogleCalendarSyncDialog (Conectar/Reconectar/Desconectar; advisor vê sem botões; leader lockdown intocado) com o runbook antigo só quando o client OAuth não está configurado no servidor. Duas envs novas (GOOGLE_CALENDAR_OAUTH_CLIENT_ID/_SECRET) documentadas no .env.example e no runbook docs/ops/teqo-1313-deploy.md (criar o OAuth client Web application, registrar os redirect URIs e publicar o app unverified para o token não expirar em 7 dias) — pré-requisito de deploy: setá-las em ~/stack/teqo-1313.env. Verificação: unit full 2716 passed, int full 722 passed (os specs da família Google agora serializam por advisory lock — a collection é singleton e a corrida entre arquivos paralelos sumiu), e2e campaignAgendaGoogleSync 9/9 local incluindo o botão de consent, typecheck/lint/format/knip/cycles verdes. Débitos deferidos com gatilho no impl plan (docs/plans/c149-conectar-google-oauth-impl.md): extrair o cookie assinado compartilhado no 4º site, cifrar o refresh token em repouso se compliance exigir, e a constraint única do singleton para o C150.