Hospital Management System

A modern and user-friendly hospital management system built with Python and Tkinter. This application helps manage patients, doctors, appointments, and other hospital-related data efficiently.

Hospital.project.final.copy.mp4

Features

• Modern and intuitive user interface
• Patient management
• Doctor management
• Appointment scheduling
• Billing system
• Department management
• Staff management
• Room management
• Dependents tracking
• Advanced search and filtering
• Secure database operations
• Inventory management

Requirements

• Python 3.9 or higher
• MySQL 8.0 or higher
• Required Python packages (see requirements.txt)

Installation

1. Clone the repository:

git clone https://github.com/HosamDyab/Hospital-Management-System.git

2. Install the required packages:

pip install -r requirements.txt

3. Set up the MySQL database:

• Create a new MySQL database
• Update the database configuration in config/database.py
• Run the SQL script in database/init_database.sql

4. Run the application:

python run.py

Project Structure

• assets/ - Contains application assets like images
• config/ - Configuration files
• database/ - Database related files and SQL scripts
• src/ - Source code
  • app.py - Main application window
  • dashboard.py - Dashboard interface
  • table_view.py - Data table views
• ui/ - User interface components
• run.py - Application entry point

Configuration

1. Database Configuration (config/database.py):

DB_CONFIG = {
    'host': 'localhost',
    'user': 'your_username',
    'password': 'your_password',
    'database': 'your_databasename'
}

Usage

1. Start the application using python run.py
2. Use the sidebar to navigate between different sections
3. Use the search and filter options to find specific records
4. Add, edit, or delete records using the form interface
5. View and manage relationships between different entities

Security

• Password fields are properly handled
• Database connections are pooled and managed securely
• Input validation and sanitization
• Error handling and logging

Contributing

1. Fork the repository
2. Create a new branch
3. Make your changes
4. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

References & Resources Used

Core Libraries

1. Tkinter

   • Python's standard GUI library
   • Used for: Main application interface
   • Documentation: Python Tkinter Documentation

2. MySQL Connector/Python (8.0.33)

   • Used for: Database connectivity and operations
   • Documentation: MySQL Connector/Python

3. Pillow (9.5.0)

   • Used for: Image handling and processing
   • Documentation: Pillow Documentation

4. tkcalendar (1.6.1)

   • Used for: Calendar widget in appointment scheduling
   • Documentation: tkcalendar Documentation

Security & Authentication

1. python-dotenv (1.0.0)

   • Used for: Managing environment variables and configuration
   • Documentation: python-dotenv Documentation

2. cryptography (41.0.1)

   • Used for: Data encryption and security
   • Documentation: cryptography Documentation

3. bcrypt (4.0.1)

   • Used for: Password hashing
   • Documentation: bcrypt Documentation

Data Processing & Reporting

1. pandas (2.0.3)

   • Used for: Data manipulation and analysis
   • Documentation: pandas Documentation

2. openpyxl (3.1.2)

   • Used for: Excel file handling
   • Documentation: openpyxl Documentation

3. reportlab (4.0.4)

   • Used for: PDF report generation
   • Documentation: reportlab Documentation

4. python-dateutil (2.8.2)

   • Used for: Date and time handling
   • Documentation: dateutil Documentation

Design Resources Used

1. Color Scheme

   • Google Material Design Colors
   • Reference: Material Design Color System

2. Icons and UI Elements

   • Material Design Icons
   • Reference: Material Design Icons

3. Font Families

   • Segoe UI (Primary font)
   • Consolas (Monospace font for time display)
   • Reference: Microsoft Typography

Technical References

1. Database Design

   • MySQL Documentation: MySQL 8.0 Reference Manual
   • Database normalization: Database Normalization Basics

2. Python Best Practices

   • PEP 8 Style Guide: PEP 8
   • Clean Code principles: Clean Code in Python

3. Security Guidelines

   • OWASP Security Guidelines: OWASP Cheat Sheet Series
   • Python Security: Python Security Guide

Healthcare Management References

1. Hospital Information System Standards

   • HL7 Standards: Health Level Seven International
   • HIPAA Guidelines: HIPAA Journal

2. Healthcare Management Best Practices

   • WHO Guidelines: WHO Digital Health
   • Healthcare Information Management: HIMSS

UI/UX Design Principles

1. Modern UI Design

   • Material Design Guidelines: Material Design
   • Nielsen Norman Group: UX Research Articles

2. Healthcare UI/UX

   • Healthcare Design Magazine: Healthcare Design
   • HIMSS UX Guide: HIMSS UX Resources

Additional Resources

1. Project Management

   • Agile Methodology: Agile Alliance
   • Software Development Life Cycle: SDLC Models

2. Version Control

   • Git Documentation: Git SCM
   • GitHub Guides: GitHub Guides

3. Testing Resources

   • Python unittest: unittest Documentation
   • Software Testing Fundamentals: Software Testing Help