🏥 MedTrack

A Full-Stack Medical Equipment Management & Tracking System
Explore the docs »

Join Discord · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Core Features
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage & Test Accounts
4. Contributing
5. License
6. Contact

About The Project

MedTrack is a Full-Stack Medical Equipment Management Platform that helps hospitals manage their equipment inventory, maintenance schedules, and equipment orders efficiently.

The system is designed with a microservice-oriented backend and a responsive React frontend, created specifically for the MedTrack Case Study 06 during the Elite Summer of Code (ECSoc).

Core Features

The system supports three major roles:

• 🏥 Hospital: Manage inventory, schedule maintenance, and order equipment.
• 🔧 Technician: View and complete assigned maintenance tasks.
• 🚚 Supplier: Fulfill equipment orders and update delivery status.

(back to top)

Built With

• 
• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

• Java 17 or higher
• Node.js (v16+)
• npm (v8+)
• Maven

Installation

1. Clone the repo

   git clone https://github.com/kRamu81/MedTrack_Application.git

2. Start the Backend

   cd Backend
   mvn spring-boot:run

   • API URL: http://localhost:8081
   • H2 Console: http://localhost:8081/h2-console (JDBC: jdbc:h2:mem:medtrackdb, User: sa)

3. Start the Frontend

   # Open a new terminal in the root directory
   npm install
   npm start

   • App URL: http://localhost:3000/MedTrack_Application

(back to top)

Usage & Test Accounts

Use the following default accounts to test the different role dashboards:

Role	Email	Password
Hospital Admin	hospital@medtrack.com	admin123
Technician	tech@medtrack.com	tech123
Supplier	supplier@medtrack.com	supply123

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Please see our CONTRIBUTING.md file for full details on how to get started, assign yourself an issue, and submit a Pull Request.

Quick Steps:

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Top Contributors

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Project Link: https://github.com/kRamu81/MedTrack_Application

💬 Join our Discord Community: https://discord.gg/F7TUpgPzJ

(back to top)