scheduling-basics

# Scheduling basics The mental model: - **Event Type** — a definition of "a bookable thing" (30-minute intro call, 45-minute demo). Lives at `/:user/:slug` or `/team/:teamSlug/:slug`. - **Schedule** — a named set of availability rules ("Working Hours", "Evenings"). Weekly intervals plus date-specific overrides. Each user has a default schedule; event types can pick any. - **Booking** — the materialized appointment. Has attendees, references to external systems (Google Calendar event, Zoom meeting), and a stable iCalUID across reschedules. - **Host** — a user assigned to an event type. Hosts have weights and priorities for round-robin. - **Team** — a group of users who can co-host event types. - **Location** — where the meeting happens. Video (built-in, Zoom, Meet, Teams), phone, in-person, or custom link. ## Workflows and routing forms - **Workflow** — trigger + ordered steps. "Email attendee 1h before event." - **Routing Form** — pre-booking form with rules that route to the right event type based on answers. Like ChiliPiper. ## Public URLs - `/:user` — user profile with event type list - `/:user/:slug` — Booker for a personal event type - `/:user/:slug/embed` — chromeless for iframe embedding - `/team/:teamSlug` — team profile - `/team/:teamSlug/:slug` — Booker for team event type (round-robin or collective) - `/d/:hash/:slug` — private hashed-link Booker - `/booking/:uid` — booking detail / manage - `/reschedule/:uid` — reschedule Booker - `/forms/:formId` — public routing form ## Common tasks | User request | Action(s) | |---|---| | "Create a 30-minute intro meeting" | `create-event-type --title "Intro" --slug intro --length 30` | | "What's my availability tomorrow?" | `check-availability --slug <slug> --from ... --to ...` | | "Cancel my 3pm with Alex" | `list-bookings --status upcoming`, then `cancel-booking --uid ...` | | "Block next Friday" | `add-date-override --scheduleId <id> --date 2026-04-10 --intervals []` | | "Connect Google Calendar" | `connect-calendar --kind google_calendar --redirectUri ...` | | "Make a team event rotating between Alice and Bob" | `create-event-type --schedulingType round-robin --teamId ...`, then `set-event-type-hosts` |