Calendar integration architecture

External calendar sync

Provider-neutral calendar contracts for busy-time blocking, outbound event mapping and sync health. No external API calls are made in this HTML build.

Privacy-first default: external calendars can block staff time using busy-only records without importing private event titles or attendee data.

Connected calendar health

Inbound

Busy-only projection

Connected events block availability without exposing private event content.

Supported

UTC source

External records retain source instants plus a local scheduling projection.

Specified

Outbound

Stable UID

Each booking exports with a stable FG Booking identifier.

fgbooking:BK-1042

Mapping record

Tracks external event ID, revision and last successful sync.

Adapter ready

HTML DEV boundary: this release models sync state and scheduling behaviour only. Real calendar authorization, network calls, subscriptions and webhook verification belong to a future backend adapter and are not claimed here.