237 lines
9.8 KiB
Plaintext
237 lines
9.8 KiB
Plaintext
// AK-P16a (P16) Calendar-Sync (Google) — aligned to ENTITY-MODEL Domäne 9
|
|
// (M25-calendar-sync). v1 = Google only; Outlook/Microsoft → v2 (the provider
|
|
// enum + adapter interface stay provider-agnostic).
|
|
//
|
|
// AD-21: self-contained schema. `tenantId` / `userId` are BARE String scalars
|
|
// (no `@relation` to Tenant/User) → zero merge-conflict surface against
|
|
// core.prisma/accounts.prisma. Intra-module relations (Connection → Event /
|
|
// Mapping / Cursor / WebhookEvent / Conflict) stay inside this file.
|
|
//
|
|
// Connection is PER-USER (not per-tenant): each user connects their own Google
|
|
// account. OAuth refresh/access tokens are stored ENVELOPE-ENCRYPTED via the
|
|
// per-tenant DEK seam (AD-8, packages/db/src/crypto/tenant-envelope.server.ts),
|
|
// never plain. The Apps-Engine `App` catalog (appsEngine.prisma) is referenced
|
|
// READ-ONLY through the bare `dataConnectionId` scalar — calendar owns its own
|
|
// per-user connection lifecycle (RLS here is tenant- AND owner-scoped in code).
|
|
//
|
|
// RLS ships separately in prisma/rls/calendar-isolation.sql (deferred cutover
|
|
// like the other modules). On the feature branch: `prisma db push` only — the
|
|
// merge migration is created at main-merge (AD-21). Leak-protection (DoD 3):
|
|
// external event contents are owner-only; availability exposes busy slots only.
|
|
|
|
/// Calendar provider. v1 = google; microsoft → v2 (interface stays agnostic).
|
|
enum CalendarProvider {
|
|
google
|
|
}
|
|
|
|
/// Sync direction of a connection (M25 Block D). Default bidirectional.
|
|
enum CalendarSyncDirection {
|
|
bidirectional
|
|
hivegrid_to_external_only
|
|
external_to_hivegrid_only
|
|
}
|
|
|
|
/// Lifecycle status of a calendar connection (M25 Block A/C).
|
|
enum CalendarConnectionStatus {
|
|
active
|
|
paused
|
|
error
|
|
revoked
|
|
}
|
|
|
|
/// Whether an event originates in HiveGrid or is a read-only external mirror.
|
|
enum CalendarEventSource {
|
|
hivegrid_internal
|
|
external_synced
|
|
}
|
|
|
|
/// Worker processing state of an inbound webhook notification (M25 Block E).
|
|
enum CalendarWebhookProcessingStatus {
|
|
pending
|
|
processing
|
|
completed
|
|
failed
|
|
skipped
|
|
}
|
|
|
|
/// How a sync conflict was resolved (M25 Block F — Last-Write-Wins variants).
|
|
enum CalendarConflictResolution {
|
|
external_won
|
|
hivegrid_won
|
|
external_deleted
|
|
hivegrid_deleted
|
|
}
|
|
|
|
/// A user's connection to an external calendar provider. PER-USER, tenant-scoped
|
|
/// for isolation. The OAuth tokens are AES-256-GCM per-tenant-DEK envelopes
|
|
/// (AD-8); never selected into a list view-model. `dataConnectionId` is an
|
|
/// OPTIONAL read-only reference to the Apps-Engine DataConnection catalog entry
|
|
/// (bare scalar, AD-21) — calendar runs autonomously if the catalog row is absent.
|
|
model CalendarConnection {
|
|
id String @id @default(cuid())
|
|
createdAt DateTime @default(now())
|
|
updatedAt DateTime @updatedAt
|
|
tenantId String
|
|
userId String
|
|
provider CalendarProvider @default(google)
|
|
// User-visible account identity (for the connection card).
|
|
externalAccountEmail String
|
|
externalAccountId String
|
|
// Sensitive: per-tenant envelope ciphertext (AD-8). Never serialised to a VM.
|
|
oauthRefreshTokenCiphertext String?
|
|
oauthAccessTokenCiphertext String?
|
|
oauthAccessTokenExpiresAt DateTime?
|
|
// Granted OAuth scopes; a reduction by the user triggers a Klartext re-connect.
|
|
oauthScopes String[]
|
|
// Provider push-subscription handle (Google channel.id) + renewal anchor.
|
|
webhookSubscriptionId String?
|
|
webhookSubscriptionExpiresAt DateTime?
|
|
// JSON list of selected external calendars to sync (default: primary).
|
|
selectedCalendars Json @default("[]")
|
|
syncDirection CalendarSyncDirection @default(bidirectional)
|
|
status CalendarConnectionStatus @default(active)
|
|
lastSyncAt DateTime?
|
|
// Klartext failure detail when status = error (M002).
|
|
lastErrorText String?
|
|
// Read-only Apps-Engine catalog reference (AD-21 bare scalar, optional).
|
|
dataConnectionId String?
|
|
isDemoData Boolean @default(false)
|
|
archivedAt DateTime?
|
|
|
|
events CalendarEvent[]
|
|
mappings CalendarEventMapping[]
|
|
syncCursors CalendarSyncCursor[]
|
|
webhookEvents CalendarWebhookEvent[]
|
|
conflicts CalendarConflict[]
|
|
|
|
@@unique([tenantId, userId, provider, externalAccountId])
|
|
@@index([tenantId, userId, status, archivedAt])
|
|
@@index([tenantId, webhookSubscriptionExpiresAt])
|
|
}
|
|
|
|
/// Cache of external events + HiveGrid-internal events. Tenant- and owner-scoped.
|
|
/// External events are owner-only (leak-protection, DoD 3); availability reads
|
|
/// only `isBusyForAvailability` busy intervals, never titles. `internalEntityLink`
|
|
/// is a polymorphic JSON pointer to a Booking/Projekt/Plantafel entity.
|
|
model CalendarEvent {
|
|
id String @id @default(cuid())
|
|
createdAt DateTime @default(now())
|
|
updatedAt DateTime @updatedAt
|
|
tenantId String
|
|
userId String
|
|
connectionId String?
|
|
source CalendarEventSource
|
|
provider CalendarProvider?
|
|
externalEventId String?
|
|
externalCalendarId String?
|
|
title String?
|
|
description String?
|
|
location String?
|
|
startsAt DateTime
|
|
endsAt DateTime
|
|
isAllDay Boolean @default(false)
|
|
timeZone String?
|
|
recurrenceRule String?
|
|
attendees Json @default("[]")
|
|
// Provider concurrency token (Google etag) for conflict detection.
|
|
etag String?
|
|
lastModifiedExternal DateTime?
|
|
isBusyForAvailability Boolean @default(true)
|
|
internalEntityLink Json?
|
|
// Monotonic HiveGrid-side version for optimistic locking (M25 Block F).
|
|
versionToken Int @default(0)
|
|
isDemoData Boolean @default(false)
|
|
archivedAt DateTime?
|
|
|
|
connection CalendarConnection? @relation(fields: [connectionId], references: [id], onDelete: SetNull)
|
|
mappings CalendarEventMapping[]
|
|
|
|
@@unique([tenantId, userId, provider, externalEventId])
|
|
@@index([tenantId, userId, startsAt])
|
|
@@index([tenantId, userId, lastModifiedExternal(sort: Desc)])
|
|
@@index([tenantId, source, archivedAt])
|
|
}
|
|
|
|
/// Links a HiveGrid-internal event to its external mirror(s). One internal event
|
|
/// can map to several providers/calendars (e.g. Google + Microsoft in v2).
|
|
model CalendarEventMapping {
|
|
id String @id @default(cuid())
|
|
createdAt DateTime @default(now())
|
|
updatedAt DateTime @updatedAt
|
|
tenantId String
|
|
internalEventId String
|
|
externalEventId String
|
|
provider CalendarProvider
|
|
externalCalendarId String
|
|
connectionId String
|
|
lastSyncedAt DateTime?
|
|
lastKnownExternalEtag String?
|
|
lastKnownInternalVersionToken Int?
|
|
|
|
internalEvent CalendarEvent @relation(fields: [internalEventId], references: [id], onDelete: Cascade)
|
|
connection CalendarConnection @relation(fields: [connectionId], references: [id], onDelete: Cascade)
|
|
|
|
@@unique([internalEventId, provider, externalCalendarId])
|
|
@@index([tenantId, connectionId])
|
|
}
|
|
|
|
/// Per-connection-per-calendar delta cursor (Google syncToken). Drives the
|
|
/// incremental external→HiveGrid sync (M25 Block D/E).
|
|
model CalendarSyncCursor {
|
|
id String @id @default(cuid())
|
|
createdAt DateTime @default(now())
|
|
updatedAt DateTime @updatedAt
|
|
tenantId String
|
|
connectionId String
|
|
externalCalendarId String
|
|
cursorToken String?
|
|
lastFullSyncAt DateTime?
|
|
|
|
connection CalendarConnection @relation(fields: [connectionId], references: [id], onDelete: Cascade)
|
|
|
|
@@unique([connectionId, externalCalendarId])
|
|
@@index([tenantId, connectionId])
|
|
}
|
|
|
|
/// Persisted inbound webhook notification (idempotency + retry, M25 Block E).
|
|
/// A fast 200 is returned to the provider; a worker drains `pending` rows.
|
|
model CalendarWebhookEvent {
|
|
id String @id @default(cuid())
|
|
receivedAt DateTime @default(now())
|
|
tenantId String
|
|
connectionId String
|
|
provider CalendarProvider
|
|
notificationPayload Json
|
|
processingStatus CalendarWebhookProcessingStatus @default(pending)
|
|
processingErrorText String?
|
|
processedAt DateTime?
|
|
// Provider-specific resource state (Google X-Goog-Resource-State).
|
|
externalResourceState String?
|
|
|
|
connection CalendarConnection @relation(fields: [connectionId], references: [id], onDelete: Cascade)
|
|
|
|
@@index([tenantId, processingStatus, receivedAt])
|
|
@@index([tenantId, connectionId])
|
|
}
|
|
|
|
/// A resolved sync conflict (DoD 4). The connection-detail view shows the latest
|
|
/// 50 with a Klartext description + how it was resolved (Last-Write-Wins).
|
|
model CalendarConflict {
|
|
id String @id @default(cuid())
|
|
createdAt DateTime @default(now())
|
|
tenantId String
|
|
connectionId String
|
|
userId String
|
|
internalEventId String?
|
|
externalEventId String?
|
|
resolution CalendarConflictResolution
|
|
// Klartext description shown in the conflict log (M002/M003 key + rendered text).
|
|
descriptionText String
|
|
isDemoData Boolean @default(false)
|
|
|
|
connection CalendarConnection @relation(fields: [connectionId], references: [id], onDelete: Cascade)
|
|
|
|
@@index([tenantId, connectionId, createdAt(sort: Desc)])
|
|
@@index([tenantId, userId])
|
|
}
|