How nirban-a/hospital-management-system-v2 works
HMS is a role-based hospital web application. Patients discover doctors, check availability, book and manage appointments, and view or export medical records; doctors manage schedules, consult patients, and review histories; administrators manage departments, users, appointments, and dashboards. The Vue client routes by role and calls a Flask API, which persists hospital data and supports background exports and reminders. The README confirms the product and Celery use; several backend capabilities are represented by documented routes, but unsampled handler internals are not assumed.
Main entry points: api.js API client · index.js Role routes · crud_api.py Hospital API · app.py Flask app and routes
Components 19
Web client
- Vue application
frontend/src/main.js - Role routes
frontend/src/router/index.js - API client
frontend/src/utils/api.js - Admin workspace
frontend/src/views/admin - Doctor workspace
frontend/src/views/doctor - Patient workspace
frontend/src/views/patient - Appointment booking
frontend/src/views/patient/PatientBooking.vue - Profile management
frontend/src/views/CommonProfile.vue
Identity
- Auth state
frontend/src/stores/auth.js - Login and registration
frontend/src/views/Login.vue - Authentication API
backend/application/auth_api.py - User datastore
backend/application/user_datastore.py
Hospital operations
- Hospital API
backend/application/crud_api.py - Flask app and routes
backend/app.py
Records and jobs
- SQL database
backend/application/database.py - Hospital data models
backend/application/models.py - Redis cache
backend/application/cache.py - Background jobs
backend/application/tasks.py
Other components
- User
Connections 24
- User → Vue application: uses
frontend/src/main.js - Vue application → Role routes: mounts routes
frontend/src/main.js - Role routes → Auth state: checks roles
frontend/src/router/index.js - Role routes → Admin workspace: routes admins
frontend/src/router/index.js - Role routes → Doctor workspace: routes doctors
frontend/src/router/index.js - Role routes → Patient workspace: routes patients
frontend/src/router/index.js - Login and registration → Auth state: sets session
frontend/src/views/Login.vue - Auth state → API client: supplies token
frontend/src/utils/api.js - Admin workspace → API client: requests data
frontend/src/views/admin/AdminDepartments.vue - Doctor workspace → API client: requests data
frontend/src/views/doctor/DoctorSchedule.vue - Patient workspace → API client: requests data
frontend/src/views/patient/PatientRecords.vue - Appointment booking → API client: books appointments
frontend/src/views/patient/PatientBooking.vue - Profile management → API client: updates profile
frontend/src/views/CommonProfile.vue - API client → Flask app and routes: HTTP requests
frontend/src/utils/api.js - Flask app and routes → Authentication API: registers resources
backend/app.py - Flask app and routes → Hospital API: registers resources
backend/app.py - Flask app and routes → User datastore: initializes roles
backend/app.py - Authentication API → User datastore: finds users
backend/application/auth_api.py - Authentication API → Redis cache: invalidates cache
backend/application/auth_api.py - Hospital API → SQL database: queries and commits
backend/application/crud_api.py - Hospital API → Hospital data models: uses entities
backend/application/crud_api.py - Hospital API → Background jobs: dispatches jobs
backend/application/crud_api.py - Hospital data models → SQL database: defines tables
backend/application/models.py - Background jobs → Hospital data models: queries records
backend/application/tasks.py