​

Google Calendar

​

Consentimento separado

Continuar com Google
└── openid, email e profile

Conectar Google Calendar
└── scopes necessários para calendário

​

Fonte da verdade

• Disponibilidade.
• Holds.
• Conflitos.
• Criação do appointment.
• Reagendamento.
• Cancelamento.
• Status e histórico.

Appointment confirmado na Orquena
        ↓
Outbox transacional
        ↓
Worker de sincronização
        ↓
Evento no Google Calendar

​

Onboarding

[ Conectar Google Calendar ]
[ Pular por enquanto ]

​

Direção inicial

Orquena → Google Calendar

​

Operações iniciais

• Criar evento quando o appointment é confirmado.
• Atualizar evento em reagendamento.
• Atualizar ou remover evento em cancelamento conforme a política escolhida.
• Preservar vínculo entre appointment e evento externo.
• Exibir falhas e permitir retry.
• Registrar a última sincronização bem-sucedida.

​

Dados da conexão

GoogleCalendarConnection
├── organizationId
├── authorizedByUserId
├── googleAccountEmail
├── encryptedRefreshTokenReference
├── grantedScopes
├── status
├── connectedAt
└── lastSuccessfulSyncAt

CalendarBinding
├── organizationId
├── professionalId?
├── googleCalendarId
├── syncDirection
└── status

​

Estados

PENDING_AUTHORIZATION
CONNECTED
DEGRADED
REAUTHORIZATION_REQUIRED
DISCONNECTED
ERROR

• Conta conectada.
• Calendário escolhido.
• Última sincronização.
• Eventos pendentes.
• Falhas.
• Ação de reconectar.

​

Mapeamento de evento

• Nome do serviço.
• Profissional.
• Horário inicial e final.
• Identificador opaco da Orquena.
• Local do atendimento.
• Notas permitidas pela política de privacidade.

​

Idempotência

ExternalCalendarEventMapping
├── appointmentId
├── calendarBindingId
├── externalEventId
├── externalVersion?
├── lastOperation
├── syncStatus
└── lastSyncedAt

​

Reautorização

• O appointment continua válido na Orquena.
• A operação fica pendente ou falha de forma visível.
• A organização recebe uma notificação.
• Um usuário autorizado pode reconectar.
• O sistema não solicita credenciais Google por formulário próprio.

​

Segurança

• Scopes mínimos para a funcionalidade escolhida.
• Redirect URIs allowlisted.
• OAuth state e proteção contra replay.
• Client secret somente no backend.
• Refresh token criptografado.
• Logs sem tokens ou conteúdo sensível.
• Permissão de integração por organização.
• Revogação auditada.

​

Fora da primeira versão

• Ler Gmail.
• Enviar emails pela conta Gmail do cliente.
• Sincronização bidirecional.
• Bloquear horários da Orquena com base em qualquer evento externo sem regra explícita.
• Vários providers de calendário no mesmo onboarding.
• Importação completa de eventos históricos.

​

Fonte canônica

docs/prds/onboarding-inbox-ai-v1.md
plugins/providers/calendar-google/README.md