Patient flow & scheduling

The front-desk surface. Patient registration, appointment booking, availability management, and the today’s-board worklist all live under /admin/patient-flow, /admin/scheduling, and /admin/availability.

Today’s board

/admin/patient-flow — the daily front-desk view. Filterable by provider and status (scheduled / arrived / in-room / checked-out / no-show). Action menu per patient: arrive, room, check out, mark no-show. Hover surfaces last visit, balance owed, eligibility status.

Appointment book

/admin/scheduling — calendar grid by provider. Drag a slot to create an Appointment, drop on a patient to assign. Slot length + in-house availability templates live under /admin/availability (weekly schedule editor; per-provider).

Online booking (public)

Anonymous patients book through /book/{practice-slug}. The form:

Pick a slot from your published availability.
Submit demographics + insurance + reason for visit.
Request lands in a confirm-or-reject worklist at /admin/booking-requests — no real Appointment is materialised until a staff member confirms.

This isolates the public internet from the Appointment resource. The unauthenticated endpoint is rate-limited and audited; no write path to live data ever exposes outward.

Waitlist

/admin/waitlist — patients who couldn’t get a slot. When a cancellation opens, the system surfaces waitlisted patients matching the provider + day-part preferences.

Providers + availability

/admin/providers — clinician roster with NPI, taxonomy codes, license states, schedule defaults.

/admin/availability — weekly template per provider: start / end minutes per day, slot length, time-off blocks. Used by both the appointment book and the public booking widget.

Recall + broadcasts

/admin/recall-panel — care-gap recall list (patients due for annual physical, A1C f/u, mammogram, etc.). Broadcast a campaign (email + SMS) by cohort with HIPAA-safe templates from /admin/broadcast. Audit log of sent → opened → responded per patient.

FHIR plumbing

Every Appointment, Patient, and Schedule write is a real FHIR R4 resource — not a separate scheduling table. Lets a downstream analytics tool consume the same data without a custom export.