How shubhanshujoshi/clinic-appointment-assistant works
CareBot is a clinic appointment assistant with a patient-facing conversation flow and an admin appointment overview. Patients send messages through the chat UI; the chat API interprets booking, discovery, availability, lookup, cancellation, and rescheduling requests, then delegates appointment operations to clinic logic backed by MongoDB. The README also lists FAQ responses, reminder-ready records, and no-show support. Those capabilities are documented, but their implementation details are not fully shown in the sampled source.
Main entry points: clinic.ts Clinic operations · route.ts Chat endpoint · admin/page.tsx Admin dashboard · app/page.tsx Chat interface
Components 17
Patient experience
- Chat interface
app/page.tsx - Admin dashboard
app/admin/page.tsx
Conversation handling
- Chat endpoint
app/api/chat/route.ts - Appointments endpoint
app/api/appointments/route.ts
Clinic operations
- Clinic operations
lib/clinic.ts - Doctor discovery
lib/clinic.ts - Slot availability
lib/clinic.ts - Appointment booking
lib/clinic.ts - Appointment management
lib/clinic.ts - Clinic FAQ
app/api/chat/route.ts - Reminder records
lib/clinic.ts - No-show tracking
app/admin/page.tsx
Persistence
- Database and seeding
lib/db.ts - MongoDB connection
lib/mongodb.ts
Other components
- Patient
- OpenAI service
- MongoDB Atlas
Connections 18
- Patient → Chat interface: messages
app/page.tsx - Chat interface → Chat endpoint: sends requests
app/page.tsx - Chat endpoint → Chat interface: returns replies
app/page.tsx - Chat endpoint → Clinic operations: dispatches operations
app/api/chat/route.ts - Chat endpoint → OpenAI service: requests completion
app/api/chat/route.ts - Chat endpoint → Clinic FAQ: handles questions
app/api/chat/route.ts - Clinic operations → Doctor discovery: finds doctors
lib/clinic.ts - Clinic operations → Slot availability: checks slots
lib/clinic.ts - Clinic operations → Appointment booking: books appointments
lib/clinic.ts - Clinic operations → Appointment management: manages appointments
lib/clinic.ts - Clinic operations → Database and seeding: uses database
lib/clinic.ts - Database and seeding → MongoDB connection: gets client
lib/db.ts - MongoDB connection → MongoDB Atlas: connects
- Patient → Admin dashboard: views overview
- Admin dashboard → Appointments endpoint: fetches appointments
app/admin/page.tsx - Appointments endpoint → Clinic operations: reads appointments
- Appointment booking → Reminder records: sets pending status
lib/clinic.ts - Admin dashboard → No-show tracking: counts status
app/admin/page.tsx