Hospital Management System

Abstract

1. Introduction

A modular Django 4.2 Hospital Management System for a multi-specialty hospital. It manages patients, appointments, admissions & beds, an in-house pharmacy (drug requests + retail sales), hospital inventory, staff with role-based access, and a public website with a blog and inquiry system.

Pharmacist - plus a Head Nurse privilege (a nurse who can manage the hospital inventory).

2. Objective

A Django-based Hospital Management System that manages core hospital operations such as patients, appointments, billing, pharmacy, users, and website pages.

This project demonstrates how HTML, Django can be applied to a real-world Full Stack Web Development problem.

3. Key Features / Modules

• Role-based access for 5 roles - Admin, Doctor, Nurse, Receptionist,
• Patients & medical records - registration, structured prescriptions,
• Appointments - booking, doctor availability, leave requests & approval.
• Admissions - 6-floor / department layout, rooms & beds, admission
• In-house pharmacy
• Nurse -> Pharmacy drug requests: nurses request medicine, pharmacy
• Retail sales & billing: walk-in sales generate an invoice + printable
• Hospital inventory (equipment / surgical / consumables) - managed by the
• Admin analytics dashboard - hospital-wide KPIs, bed occupancy by floor,
• Public website - landing pages, doctor blogs, contact & appointment

4. Technology Stack

• Backend: Django 4.2 (Python)
• Database: SQLite
• Frontend: Django Templates, Bootstrap 5, crispy-forms
• Auth: Django auth with a custom users.User model + role middleware
• PDF: xhtml2pdf · Email/OTP: SMTP + IMAP (Gmail)

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• A modern web browser
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/R204570/hospital-management-system.git
cd hospital-management-system

pip install -r requirements.txt

python manage.py runserver

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add role-based access control
• Deploy on a VPS or cPanel hosting with a custom domain
• Add automated tests and a CI pipeline

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Explain the frontend, backend and database layers of this application.
2. How is user authentication and authorisation implemented?
3. Describe the main database tables / collections and their relationships.
4. Which REST APIs or routes are exposed and what do they return?
5. How would you deploy this application to production?

9. Source Code & License

This project is developed by R204570 and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.