Dashboard-Automatizase/docs/prd/epic-3-google-calendar-oauth.md
2025-10-05 21:17:43 -03:00

2.1 KiB

Epic 3: Google Calendar OAuth Integration

Epic Goal

Permitir que usuários autorizem integração com Google Calendar através de OAuth gerenciado pelo n8n, exibindo status de conexão de forma clara. Epic completa funcionalidade de integrações do portal.

Epic Status

  • Status: Not Started
  • Priority: P1 (High)
  • Effort Estimate: 1-2 days
  • Dependencies: Epic 1 (precisa de dashboard básico)

Value Proposition

Este epic adiciona a segunda integração principal do portal:

  • Autorização OAuth do Google Calendar via n8n
  • Status visual de conexão (conectado/não conectado)
  • Possibilidade de re-autenticar com email diferente
  • Gerenciamento de credenciais centralizado no n8n

User Stories

Story 3.1: Criar Card/Botão OAuth do Google Calendar

Link: story-3-1-criar-card-google-calendar.md

Story 3.2: Implementar Callback e Atualização de Status OAuth

Link: story-3-2-callback-oauth.md

Story 3.3: Exibir Status de Conexão do Google Calendar

Link: story-3-3-exibir-status-calendar.md

Technical Notes

  • OAuth flow completamente gerenciado pelo n8n
  • Portal apenas redireciona para n8n e recebe callback
  • Status armazenado em portal.integrations no Supabase
  • Link OAuth apontando para N8N_OAUTH_URL

Acceptance Criteria (Epic Level)

  1. Card Google Calendar exibido no dashboard
  2. Botão "Conectar Google Calendar" redireciona para n8n OAuth
  3. n8n processa OAuth e redireciona de volta ao portal
  4. Status de conexão exibido corretamente (conectado/não conectado)
  5. Usuário pode re-autenticar com email diferente
  6. Interface responsiva e consistente com resto do portal

Definition of Done

  • Todas as 3 stories completadas
  • Code review realizado
  • Testes manuais com n8n OAuth executados
  • Teste de re-autenticação executado
  • Interface responsiva testada
  • Documentação de integração n8n adicionada ao README