Skip to content

Allankw-dev/hospital--program

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hospital--program

A console-based Hospital Management System built in Java to demonstrate strong Object-Oriented Programming (OOP) principles, clean code structure, and real-world system simulation.

This project simulates core hospital operations such as managing patients, doctors, and scheduling appointments.

📌 Project Overview

This system allows users to:

Register patients

Register doctors

Schedule appointments

View stored records

Manage data using Java Collections

The goal of this project was to practice:

Clean architecture

Object modeling

Input validation

Java Time API usage

Stream API usage

🛠 Tech Stack

Language: Java (JDK 8+)

Concepts: OOP, Encapsulation, Static Members

Libraries:

java.util.*

java.time.*

AtomicLong

Data Storage: In-memory using ArrayList

🏗 System Architecture Core Classes Class Responsibility Patient Stores patient details Doctor Stores doctor information Appointment Manages scheduling data MiniHospital Main controller & menu system

The system follows a clean separation of responsibilities and demonstrates proper class modeling.

▶️ How To Run 1️⃣ Clone Repository git clone https://github.com/Allankw-dev/mini-hospital.git cd mini-hospital

2️⃣ Compile javac MiniHospital.java

3️⃣ Run java MiniHospital

🖥 Sample Menu Output --- Mini Hospital Menu ---

  1. Add patient
  2. List patients
  3. Add doctor
  4. List doctors
  5. Schedule appointment
  6. List appointments
  7. Exit

🧠 Key Concepts Demonstrated

✔ Object-Oriented Programming ✔ Unique ID generation using AtomicLong ✔ Date & Time handling using LocalDateTime ✔ Exception handling ✔ Stream API filtering ✔ Menu-driven program logic

🚀 Future Improvements

Prevent doctor double-booking

File persistence (save/load from file)

Database integration (MySQL)

REST API version (Spring Boot)

GUI implementation (JavaFX)

💼 Why This Project Matters

This project demonstrates the ability to:

Model real-world systems

Write clean, maintainable Java code

Apply OOP principles correctly

Build structured, scalable console applications

It serves as a strong foundation for backend development roles and Java-based system design.

👨‍💻 Author

Allan Kamau 📧 allankamauw20@gmail.com

🔗 GitHub: https://github.com/Allankw-dev .

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages