Hospital Management System

A web-based Hospital Management System built with Django that streamlines interactions between patients and doctors. The application provides appointment scheduling, patient records, prescriptions, and role-based dashboards through a clean server-rendered interface.

Features

• User authentication
• Doctor and patient roles
• Appointment scheduling
• Doctor dashboard
• Patient dashboard
• Prescription management
• Medical history
• Role-based authorization
• Server-rendered interface using Django Templates

Tech Stack

• Python
• Django
• HTML
• CSS
• Django Templates

Getting Started

Clone the repository

git clone https://github.com/zoanig/HMS
cd HMS

Create a virtual environment

python -m venv .venv

Activate it.

Windows

.venv\Scripts\activate

Linux/macOS

source .venv/bin/activate

Install dependencies

pip install -r requirements.txt

Apply migrations

python manage.py migrate

Create an administrator account

python manage.py createsuperuser

Run the development server

python manage.py runserver

Visit:

http://127.0.0.1:8000/

User Roles

Doctor

• View appointments
• Manage appointments
• Create prescriptions
• View prescription history

Patient

• Manage profile
• Book appointments
• View appointment history
• Browse doctors
• View prescriptions

Project Structure

.
├── HMS/
├── accounts/
├── doctors/
├── patients/
├── templates/
├── static/
├── requirements.txt
└── manage.py

Highlights

• Authentication and authorization
• Role-based access control
• Appointment scheduling workflow
• Prescription management
• Modular Django application structure
• Server-side rendering with Django Templates

Future Improvements

• Email notifications
• Search and filtering
• Medical report uploads
• REST API
• Automated tests

License

This project is licensed under the MIT License.