How thinkhatminpro/clinicalappmanagement works
Clinic Appointment Management System supports patient self-service booking, doctor appointment management, and staff administration. Users enter through role-specific web portals; API routes authorize requests, controllers translate HTTP input, services enforce domain rules, and PostgreSQL stores clinic records. The principal booking workflow includes doctor availability, appointment creation, and overlap validation; staff also manages patient and doctor records and dashboards. The README documents the capabilities and layered API design. Some frontend-to-endpoint wiring and unsampled implementation details are represented only at subsystem level.
Main entry points: app.js Express API · App.jsx Role portals · api.js API client · prisma.js Prisma client
Components 25
Web application
- Role portals
web/src/App.jsx - Sign in / signup
web/src/pages/auth/AuthPage.jsx - Patient portal
web/src/pages/patient - Doctor portal
web/src/pages/doctor - Staff portal
web/src/pages/staff - API client
web/src/lib/api.js
API and access
- Express API
api/src/app.js - Authentication routes
api/src/routes/authRoutes.js - Patient routes
api/src/routes/patientRoutes.js - Doctor routes
api/src/routes/doctorRoutes.js - Staff routes
api/src/routes/staffRoutes.js - JWT and role guards
api/src/guards - API documentation
api/src/config/swagger.js
Clinic workflows
- Authentication logic
api/src/services/authService.js - Patient requests
api/src/controllers/patientController.js - Doctor requests
api/src/controllers/doctorController.js - Staff requests
api/src/controllers/staffController.js - Patient booking and profile
api/src/services/patientService.js - Doctor appointments
api/src/services/doctorService.js - Staff administration
api/src/services/staffService.js
Persistence and errors
- User repository
api/src/repositories/userRepository.js - Prisma client
api/src/config/prisma.js - PostgreSQL
- Error responses
api/src/middleware/errorHandler.js
Other components
- Clinic users
Connections 33
- Clinic users → Role portals: uses portals
web/src/App.jsx - Role portals → Sign in / signup: routes to
web/src/App.jsx - Role portals → Patient portal: routes to
web/src/App.jsx - Role portals → Doctor portal: routes to
web/src/App.jsx - Role portals → Staff portal: routes to
web/src/App.jsx - Sign in / signup → API client: submits auth
- Patient portal → API client: requests clinic data
- Doctor portal → API client: requests clinic data
- Staff portal → API client: requests clinic data
web/src/pages/staff/Appointments.jsx - API client → Express API: calls API
README.md - Express API → Authentication routes: mounts
api/src/app.js - Express API → Patient routes: mounts
api/src/app.js - Express API → Doctor routes: mounts
api/src/app.js - Express API → Staff routes: mounts
api/src/app.js - Express API → Error responses: formats failures
api/src/app.js - Express API → API documentation: serves docs
api/src/app.js - Authentication routes → Authentication logic: handles login
api/src/routes/authRoutes.js - Authentication routes → JWT and role guards: protects routes
- Patient routes → JWT and role guards: checks access
api/src/routes/patientRoutes.js - Doctor routes → JWT and role guards: checks access
api/src/routes/doctorRoutes.js - Staff routes → JWT and role guards: checks access
api/src/routes/staffRoutes.js - Patient routes → Patient requests: dispatches
api/src/routes/patientRoutes.js - Doctor routes → Doctor requests: dispatches
api/src/routes/doctorRoutes.js - Staff routes → Staff requests: dispatches
api/src/routes/staffRoutes.js - Patient requests → Patient booking and profile: delegates
api/src/controllers/patientController.js - Doctor requests → Doctor appointments: delegates
README.md - Staff requests → Staff administration: delegates
api/src/controllers/staffController.js - Authentication logic → User repository: looks up users
api/src/services/authService.js - User repository → PostgreSQL: reads and writes
api/src/repositories/userRepository.js - Patient booking and profile → Prisma client: uses database
api/src/services/patientService.js - Doctor appointments → Prisma client: uses database
api/src/services/doctorService.js - Staff administration → Prisma client: uses database
api/src/services/staffService.js - Prisma client → PostgreSQL: persists records
api/src/config/prisma.js