🏠 Overview › 🧩 Components ›🧩 Calendar Provider Gateway

Calendar Provider Gateway

Component Detail

Infrastructure medium complexity mobilebackend
0
Dependencies
0
Dependents
0
Entities
0
Integrations

Description

Abstraction layer over the iOS EventKit and Google Calendar APIs that exposes a unified interface for reading, writing, and watching calendar events. Hides provider-specific authentication, pagination, and event-shape differences from the rest of the application.

Feature: Calendar Sync

calendar-provider-gateway

Sources & reasoning

HLF workshop calls out calendar sync alongside scenario-based push for follow-up. No MVP/Phase 2 mention, so it slots into Fase 3 Growth & Engagement per §5's recommended phase ordering for tenant-specific enhancements.

  • Oppfølging av likepersoner: 40 % var ikke fornøyd med oppfølgingen i spørreundersøkelse. Scenariobaserte push-meldinger og kalendersynkronisering.

Responsibilities

  • Authenticate against iOS Calendar (EventKit) and Google Calendar OAuth
  • Fetch events within a date range across enabled calendars
  • Create, update, and delete events in the user's selected calendar
  • Normalize provider event payloads into a common CalendarEvent shape
  • Surface provider errors and rate-limit responses with retry guidance

Interfaces

authenticate(provider): ProviderSession
listCalendars(session): Calendar[]
fetchEvents(session, calendarId, range): CalendarEvent[]
createEvent(session, calendarId, event): CalendarEventRef
deleteEvent(session, calendarId, eventId): void