How jayaliperera/patient-management-system works
A full-stack clinic booking system: patients and doctors authenticate into role-specific workspaces. Patients search doctors, inspect availability, book and manage appointments; doctors maintain profiles and availability, manage schedules and appointments, and review patient summaries. The React dashboards call a FastAPI API, whose services enforce domain rules and persist records through SQLAlchemy. README capabilities are included where documented; unsampled frontend pages and API routes are represented by their existing feature or route paths, with only documented relationships shown.
Main entry points: services.py Clinic domain services · api.js HTTP client · dependencies.py Token and role access · App.jsx Session and routing
Components 21
React application
- Session and routing
patient_management_syetem_FE/src/App.jsx - Sign-in and registration
patient_management_syetem_FE/src/features/auth/AuthScreen.jsx - Patient workspace
patient_management_syetem_FE/src/features/patient/PatientDashboard.jsx - Doctor workspace
patient_management_syetem_FE/src/features/doctor/DoctorDashboard.jsx - Appointment receipts
patient_management_syetem_FE/src/lib/receiptPdf.js - HTTP client
patient_management_syetem_FE/src/api.js
API and access
- API route handlers
patient_management_system_BE/app/api/v1 - Authentication routes
patient_management_system_BE/app/api/v1/auth.py - Doctor routes
patient_management_system_BE/app/api/v1/doctors.py - Patient routes
patient_management_system_BE/app/api/v1/patients.py - Appointment routes
patient_management_system_BE/app/api/v1/appointments.py - Token and role access
patient_management_system_BE/app/api/v1/dependencies.py
Clinic workflows
- Clinic domain services
patient_management_system_BE/app/services.py - Request and response schemas
patient_management_system_BE/app/schemas.py - Clinic time handling
patient_management_system_BE/app/core/timezone.py
Persistence and security
- JWT and password security
patient_management_system_BE/app/core/security.py - Application configuration
patient_management_system_BE/app/core/config.py - Database sessions
patient_management_system_BE/app/db/database.py - Clinic records
patient_management_system_BE/app/db/models.py
Other components
- Patient or doctor
- PostgreSQL or SQLite
Connections 32
- Patient or doctor → Session and routing: uses
patient_management_syetem_FE/src/App.jsx - Session and routing → Sign-in and registration: shows
patient_management_syetem_FE/src/App.jsx - Session and routing → Patient workspace: routes patient
patient_management_syetem_FE/src/App.jsx - Session and routing → Doctor workspace: routes doctor
patient_management_syetem_FE/src/App.jsx - Sign-in and registration → HTTP client: calls API
patient_management_syetem_FE/src/features/auth/AuthScreen.jsx - Patient workspace → HTTP client: calls API
patient_management_syetem_FE/src/features/patient/PatientDashboard.jsx - Doctor workspace → HTTP client: calls API
patient_management_syetem_FE/src/features/doctor/DoctorDashboard.jsx - Patient workspace → Appointment receipts: downloads receipt
patient_management_syetem_FE/src/features/patient/PatientDashboard.jsx - HTTP client → Authentication routes: HTTP requests
README.md - HTTP client → Doctor routes: HTTP requests
README.md - HTTP client → Patient routes: HTTP requests
README.md - HTTP client → Appointment routes: HTTP requests
README.md - Authentication routes → Clinic domain services: delegates to
patient_management_system_BE/app/api/v1/auth.py - Doctor routes → Clinic domain services: delegates to
patient_management_system_BE/app/api/v1/doctors.py - Appointment routes → Clinic domain services: delegates to
patient_management_system_BE/app/api/v1/appointments.py - Patient routes → Clinic domain services: delegates to
patient_management_system_BE/app/api/v1/patients.py - Authentication routes → Token and role access: uses dependencies
patient_management_system_BE/app/api/v1/auth.py - Doctor routes → Token and role access: uses dependencies
patient_management_system_BE/app/api/v1/doctors.py - Appointment routes → Token and role access: uses dependencies
patient_management_system_BE/app/api/v1/appointments.py - Patient routes → Token and role access: role protection
patient_management_system_BE/app/api/v1/patients.py - Token and role access → JWT and password security: decodes token
patient_management_system_BE/app/api/v1/dependencies.py - Token and role access → Database sessions: gets session
patient_management_system_BE/app/api/v1/dependencies.py - Token and role access → Clinic records: loads user
patient_management_system_BE/app/api/v1/dependencies.py - Clinic domain services → JWT and password security: hashes and verifies
patient_management_system_BE/app/services.py - Clinic domain services → Clinic time handling: uses time rules
patient_management_system_BE/app/services.py - Clinic domain services → Clinic records: queries and updates
patient_management_system_BE/app/services.py - Clinic domain services → Request and response schemas: returns domain data
patient_management_system_BE/app/services.py - Request and response schemas → Clinic records: maps ORM models
patient_management_system_BE/app/schemas.py - Database sessions → Application configuration: reads settings
patient_management_system_BE/app/db/database.py - Database sessions → Clinic records: initializes metadata
patient_management_system_BE/app/db/database.py - Database sessions → PostgreSQL or SQLite: opens sessions
- JWT and password security → Application configuration: reads secret settings
patient_management_system_BE/app/core/security.py