teqo-backup/src/collections/GoogleCalendarSync.ts
Francisco Solla 7629a505e0 feat(C115): edição pelo Google Calendar volta para o Teqo (motor bidirecional + webhook push)
- runSyncPass bidirecional: regra do relógio decide direção (Google mais novo
  aplica título/horário; Teqo re-asserta), cancelamento via showDeleted +
  snapshot lastSeenEventIds, registro no updates feed
- webhook público /campanha/agenda/google-webhook/[secret] fail-closed
  (secret + X-Goog headers constant-time), canal lazy sem cron (ensure em
  toda passada, renovação com id novo + stop do antigo)
- migration hand-written (campos de canal/snapshot em googleCalendarSync);
  mutationKind dedicado libera título via Google sem quebrar slug canônico
- UI: seção 'Edições pelo Google' no dialog + autor 'Google Calendar' no feed
- testes: unit (reverse mapping, validação webhook), int (motor bidirecional
  com stub, 10 cenários), e2e (webhook 404 fail-closed)
2026-08-11 22:38:53 -03:00

171 lines
4.9 KiB
TypeScript

import type { CollectionConfig } from 'payload'
import {
canCreateGoogleCalendarSync,
canDeleteGoogleCalendarSync,
canReadGoogleCalendarSync,
canSetGoogleCalendarSyncConfigField,
canSetGoogleCalendarSyncDisabled,
canSetGoogleCalendarSyncSystemField,
canUpdateGoogleCalendarSync,
} from '@/utilities/access/googleCalendarSync'
import { googleCalendarSyncConfigHook } from '@/utilities/googleCalendarSyncHooks'
/**
* C114 — configuration and state of the campaign→Google calendar mirror
* (one row in practice, created/edited by Payload admin in ops). The service
* account private key never lives here — it is `GOOGLE_CALENDAR_SERVICE_ACCOUNT_KEY`
* in the environment. Changing `calendarId` (or re-enabling) re-runs the full
* reconciliation automatically via `googleCalendarSyncConfigHook` (D7).
*/
export const GoogleCalendarSync: CollectionConfig = {
slug: 'googleCalendarSync',
labels: {
singular: 'Sincronização Google Agenda',
plural: 'Sincronização Google Agenda',
},
admin: {
group: 'Campanha',
useAsTitle: 'calendarId',
defaultColumns: ['calendarId', 'lastSyncedAt', 'lastSuccessAt', 'lastError'],
},
access: {
create: canCreateGoogleCalendarSync,
read: canReadGoogleCalendarSync,
update: canUpdateGoogleCalendarSync,
delete: canDeleteGoogleCalendarSync,
},
hooks: {
afterChange: [googleCalendarSyncConfigHook],
},
fields: [
{
name: 'calendarId',
type: 'text',
label: 'ID do calendário (Google)',
index: true,
access: {
create: canSetGoogleCalendarSyncConfigField,
update: canSetGoogleCalendarSyncConfigField,
},
admin: {
description:
'O calendarId do calendário "Agenda da Campanha" na conta Google da campanha (ex.: c_…@group.calendar.google.com). O calendário precisa estar público no link e a service account com permissão de edição.',
},
},
{
name: 'disabledAt',
type: 'date',
label: 'Desativado em',
index: true,
access: {
create: canSetGoogleCalendarSyncDisabled,
update: canSetGoogleCalendarSyncDisabled,
},
admin: {
readOnly: true,
description: 'Enquanto preenchido, o Teqo não escreve no Google.',
},
},
{
name: 'lastSyncedAt',
type: 'date',
label: 'Última sincronização',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'lastSuccessAt',
type: 'date',
label: 'Última sincronização com sucesso',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'lastErrorAt',
type: 'date',
label: 'Último erro',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'lastError',
type: 'textarea',
label: 'Mensagem do último erro',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'pushChannelId',
type: 'text',
label: 'ID do canal de notificação (Google)',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'pushChannelResourceId',
type: 'text',
label: 'Resource ID do canal (Google)',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'pushChannelExpiresAt',
type: 'date',
label: 'Canal de notificação expira em',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'pushChannelSecret',
type: 'text',
label: 'Segredo do webhook (URL)',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'pushChannelError',
type: 'textarea',
label: 'Erro do canal de notificação',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
{
name: 'lastSeenEventIds',
type: 'json',
label: 'Eventos vistos na última sincronização',
admin: { readOnly: true },
access: {
create: canSetGoogleCalendarSyncSystemField,
update: canSetGoogleCalendarSyncSystemField,
},
},
],
}