🏥 MediHub - Hospital Management System

A modern, professional web application for comprehensive hospital management with intelligent scheduling, secure medical records, and real-time notifications.

What is this project?

This is a hospital management system I built for managing appointments between doctors and patients. It has three types of users:

• Admin - Manages doctors and patients
• Doctors - View appointments and update treatment records
• Patients - Book appointments and view medical history

Why I made this

Most hospitals still use paper registers or complicated software. I wanted to make something simple that:

• Lets patients book appointments online
• Helps doctors see their schedule easily
• Gives admins control over everything
• Keeps all medical records in one place

Features

For Patients

• Register and login
• Book appointments (choose doctor, date, time slot)
• View appointment history
• See treatment records (diagnosis, medicines prescribed)
• Cancel appointments

For Doctors

• View today's appointments
• See assigned patients
• Update treatment details (diagnosis, prescription, notes)
• Mark appointments as completed
• Set availability (morning/evening slots for next 7 days)

For Admin

• Add/edit/blacklist doctors
• Edit/blacklist patients
• View all appointments
• Reschedule or cancel any appointment
• See appointment history for any doctor or patient
• Dashboard with statistics

Tech Stack

Frontend:

• HTML, CSS, JavaScript
• Vue.js 3 (loaded from CDN)
• Bootstrap 5 for styling
• Professional dark theme (#0f172a)

Backend:

• Python Flask
• SQLite database
• SQLAlchemy (ORM)
• JWT for authentication

Background Jobs:

• Celery (for sending emails)
• Redis (message broker)

Project Structure

hospital-management-system/
├── backend/
│   ├── models/              # Database tables
│   ├── routes/              # API endpoints
│   │   ├── auth.py         # Login/Register
│   │   ├── admin.py        # Admin features
│   │   ├── doctor.py       # Doctor features
│   │   └── patient.py      # Patient features
│   ├── celery_tasks/       # Email sending tasks
│   ├── app.py              # Main Flask app
│   ├── database.py         # Database setup
│   └── seed_db.py          # Create sample data
├── frontend/
│   ├── js/
│   │   ├── app.js          # Main Vue app
│   │   ├── admin.js        # Admin dashboard
│   │   ├── doctor.js       # Doctor dashboard
│   │   ├── patient.js      # Patient dashboard
│   │   └── api.js          # API calls
│   ├── custom.css          # Styling
│   └── index.html          # Main page
└── docs/                    # Documentation

🚀 Getting Started

For detailed installation and setup instructions, please refer to docs/setup.md.

Quick Start:

# Clone and setup
git clone https://github.com/aloktripathi1/hospital-management-system.git
cd hospital-management-system/backend

# Install and run
pip install -r requirements.txt
python seed_db.py
python app.py

# Visit http://localhost:5000

Default Login:

• Admin: admin / admin
• Doctor: ajay / ajay.kumar123
• Patient: rahul / rahul123

Database Tables

• users - Login credentials for all users
• doctors - Doctor profiles (name, specialization, experience, fees)
• patients - Patient info (name, age, gender, medical history)
• appointments - Booking records (date, time, status)
• treatments - Treatment records (diagnosis, prescription, notes)
• doctor_availability - Doctor schedule slots (morning/evening)

Screenshots

Homepage

Modern hero section with professional dark theme

Login/Register

Clean branded login page with stats

Admin Dashboard

Manage doctors, patients, and appointments

Doctor Dashboard

View appointments and update treatments

Patient Dashboard

Book appointments and view history

What I Learned

• Building REST APIs with Flask
• User authentication with JWT
• Frontend development with Vue.js
• Database design and relationships
• Background job processing with Celery
• UI/UX design principles

Future Improvements

• Payment integration for consultation fees
• Video consultation feature
• Prescription PDF download

Documentation

Check the docs/ folder for more details:

• setup.md - Detailed setup instructions
• architecture.md - How everything works together
• bg_jobs.md - Email system explanation

Contributing

Feel free to fork this project and make improvements! Some ideas:

• Add more specializations
• Improve UI design
• Add more features (lab reports, pharmacy, etc.)

License

MIT License