HealU - POLYCLINIC MANAGEMENT SYSTEM

Introduction
Overview
Features
System Architecture
Technologies
How to Run the Project
Screenshots
Documentations
Contributors

Introduction

HealU is a Polyclinic Management System that is developed to help the polyclinic to manage their daily operations. This system is developed using microservices architecture. This system is developed as a part of the Healthcare Information System course (SBE40XX) at the Department of Systems & Biomedical Engineering, Cairo University.

Overview

The system consists of:

Home Page
6 clinics (Medical Staff Portals)
API Gateway
Patient Portal
Admin Portal
Tons of backend services

Clinics

Features (Bear with me, it's a long list ;) )

Patient Portal
- Patient Login
- Patient Registration
  - Enter Personal Information
  - Enter Medical Information
  - Upload Medical Records
- Manage Appointments
  - View Appointments
  - Cancel Appointments
  - Book Appointments
  - View Appointment Details
- Patient Profile
- Patient Medical Records
Admin Portal
- Admin Login
- Admin Dashboard & Analytics
  - View Statistics and Data for the whole system components
- Clinic Management
  - (Add, Edit, Remove) Clinic
  - (Add, Edit, Remove) Clinic Services
  - (Add, Edit, Remove) Clinic Medical Staff
- Patient Management
Medical Staff Portals (One for each Clinic)
- Medical Staff Dashboard for Appointments & Patients
  - Manage Appointments
  - Manage Patients
  - (Add, Remove, Edit) Appointment Slots
- Medical Staff Dashboard for Prescriptions & Medical Records
  - (View, Add) Patient Medical Records
  - (View, Add) Patient Prescriptions
  - (View,Request, Add) Lab Tests
- Specialized Workflow features for each clinic
API Gateway
- Authentication
- Authorization
- Load Balancing
- Routing
- Caching
- Rate Limiting
- Logging
- Monitoring
Billing System
- Offline Payment
- Online Payment (PayPal)
- Generate Bills & Invoices
- View Bills & Invoices
- Pay Bills
Document Management System
- Upload Medical Documents
  - DICOM Images
  - JPEG/PNG Images
  - PDF Files
  - Word Documents
  - Excel Sheets
- (View, Edit) Documents
- Download Documents
Electronic Medical Records System
- (View, Add) Patient Medical Records
- (View, Add) Patient Prescriptions
- (View,Request, Add) Lab Tests
- (View, Add) Patient Medical Documents
Appointment Management System
- (View, Add, Cancel) Appointments
- (View, Add, Cancel) Appointment Slots
- (View, Add, Cancel) Appointment Requests
- (View, Add, Cancel) Appointment Cancellations

System Architecture

The system is developed using microservices architecture. The system consists of 6 clinics, each clinic has its own portal for the medical staff to manage the clinic's operations. There might be a backend service for the clinic or not, depending on the clinic's operations. The interactions between the clinics and the other system components are done via REST APIs. the connection between the clinics & services and the other system components is done via the API Gateway. The API Gateway is responsible for authentication, authorization, load balancing, routing, caching, rate limiting, logging, and monitoring.

Database schemas

Services

Appointments Service
Electronic Medical Records Service
Registration Service
Billing Service
Document Management Service
Admin Service

Technologies

Frontend

The Whole frontend is a single project where all the team members worked on. Following MVC architecture.

Backend

The backend is developed using microservices architecture. Each service is a separate project.

Databases

Multiple databases are used in the system. Each service has its own database, according to its needs.

How to Run the Project

Most Services and Databases are hosted on render.com. Most of them may be down due to the limited free tier.

Live Service URLs

You can run the project locally by following these steps:

Clone the project
Install the dependencies for each service
- for nodejs services:
```
cd ./service-name
npm install
```
- for python services:
```
cd ./service-name
pip install -r requirements.txt
```

Run the services

for nodejs services:

cd ./service-name
npm run dev OR npm start

for python services:

cd ./service-name
python manage.py runserver

Run the frontend

do the following:
```
cd ./client
npm install
npm start
```

5.Enjoy!

Screenshots

Home Page

Appointments

Clinic Portal

Analytics

Documentations

All the Services APIs is documented on Postman

Contributors

Around 40 Senior Students from the Department of Systems & Biomedical Engineering, Cairo University contributed to this project. They were divided into 7 teams, each team was responsible for a clinic and a service. and 1 core team that was responsible for the Patient Portal and API Gateway. Each team had a team lead, these leads with the core team formed the project management team. which was responsible for Admin Service, Analytics, and Billing System & more

Core Team
_{Zeyad Amr Fekry} (Team Lead) Full Stack	_{Ahmed Abd ElRaouf} Full Stack	_{Abdelrahman Yasser} Frontend	_{Mo'men Mohamed} Frontend	_{Mazen Tarek} PM & Backend
MDIMA ( Nutrition Clinic )
_{Ibrahim Mohamed} (Team Lead) Full Stack	_{Maha Medhat} Backend	_{Doha Eid} Backend	_{Maye Khaled} Frontend	_{Amira Mohamed} Frontend
MADS ( Dental Clinic )
_{Mohamed Ismail} (Team Lead) Full-Stack	_{Dina Mostafa} Backend	_{Sherif Ahmed} Backend	_{Ahmed El Sarta} Frontend	_{Adham Mohammed} Frontend	_{Mina Azeer} Backend
iHIS ( Ophthalmology Clinic )
_{Hanya Ahmed} (Team Lead) Full-Stack	_{Mariam Mounier} Frontend	_{Aya Amr} Backend	_{Mohamed Salman} Backend	_{Nourhan Sayed} Frontend
medmates ( Orthopedic Clinic )
_{Maryam Megahed} (Team Lead) Backend	_{Sara Amgad} Backend	_{Rawda Yousry} Frontend	_{Rawan Abd-Elrahman} Frontend	_{Sama Mostafa} Full Stack
care lifters ( Pediatric Clinic )
_{Abram Gad Hanna} (Team Lead) Frontend	_{Kareman Yasser Mohamed} Backend	_{Mayar Fayez Sadek} Frontend	_{Nada Ahmed Mohamed} Backend	_{Naira Youssef Abdelazim} Frontend	_{Yasmin Yasser Ali} Database