Appointments Feature
Complete appointment system — booking, queue management, status lifecycle, and notifications.
Updated June 2026 6 min read
The Appointments feature is the operational backbone of The Care Nexus...
Booking Constraints
- A patient cannot book the same doctor twice in the same time slot
- A slot is only available if it exists in schedule and is unbooked
- Patients can only book doctors linked to a clinic
- Appointments can be booked up to 30 days in advance
- Same-day booking is allowed if slot is in the future
Status Machine
| From | To | Who triggers |
|---|---|---|
| pending | confirmed | Doctor |
| pending | cancelled | Patient or Doctor |
| confirmed | in-progress | Doctor |
| confirmed | cancelled | Patient or Doctor |
| in-progress | completed | Doctor |
Notification Triggers
- Booking → doctor gets real-time notification
- Confirmation → patient notified
- 24h reminder → email + push notification
- 1h reminder → second alert
Appointment type field
Each appointment has a type field: in-person or follow-up.