How juan-var-camp/consultafacil-api works
ConsultaFácil is an Express API for clinic appointment scheduling and administration. The main workflow is: a patient authenticates, checks a clinic’s availability, and books a time; clinic staff manage schedules and appointment status, while users and clinics are administered through separate endpoints. Appointment changes trigger email notifications, and a scheduled job sends reminders for upcoming appointments. Source excerpts establish the main route, scheduling, persistence and email calls; the README is empty, so no additional documented capabilities can be assessed.
Main entry points: index.js Express server · citas.js Appointment management · prisma.js Application database · consultorios.js Clinic management
Components 13
API routes
- Authentication
routes/auth.js - User administration
routes/usuarios.js - Clinic management
routes/consultorios.js - Appointment management
routes/citas.js - Token and role checks
middleware/auth.js
Scheduling domain
- Schedule rules
lib/horarios.js
Persistence and messaging
- Application database
lib/prisma.js - Email templates
lib/plantillas.js - SMTP mailer
lib/correo.js
Background jobs
- Appointment reminders
jobs/recordatorios.js
Other components
- API client
- Express server
index.js - SMTP service
Connections 24
- API client → Express server: sends requests
index.js - Express server → Authentication: mounts /api/auth
index.js - Express server → User administration: mounts /api/usuarios
index.js - Express server → Clinic management: mounts /api/consultorios
index.js - Express server → Appointment management: mounts /api/citas
index.js - Express server → SMTP mailer: checks mail
index.js - Express server → Appointment reminders: starts scheduler
index.js - Authentication → Application database: reads and writes users
routes/auth.js - User administration → Application database: manages users
routes/usuarios.js - Clinic management → Application database: manages clinics and hours
routes/consultorios.js - Clinic management → Schedule rules: generates availability
routes/consultorios.js - Appointment management → Application database: reads and writes appointments
routes/citas.js - Appointment management → Schedule rules: validates appointment time
routes/citas.js - Appointment management → Token and role checks: checks access
routes/citas.js - Authentication → Token and role checks: authenticates profile route
routes/auth.js - User administration → Token and role checks: checks access
routes/usuarios.js - Clinic management → Token and role checks: checks access
routes/consultorios.js - Appointment management → Email templates: formats notifications
routes/citas.js - Appointment management → SMTP mailer: sends notifications
routes/citas.js - Appointment reminders → Application database: finds and updates reminders
jobs/recordatorios.js - Appointment reminders → Email templates: formats reminders
jobs/recordatorios.js - Appointment reminders → SMTP mailer: sends reminders
jobs/recordatorios.js - SMTP mailer → SMTP service: sends mail
lib/correo.js - Schedule rules → Application database: reads clinic hours
lib/horarios.js