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. AI Assistant (Beta)
5. Contributing
6. License
7. 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. It now also features an AI-powered assistant for equipment Q&A and document drafting.

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.
• 🤖 AI Assistant: Chat with a RAG-grounded assistant to ask questions about equipment/maintenance/orders, and draft purchase orders or reports in plain language — with human approval required before anything is submitted.

(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
• OPENAI_API_KEY environment variable (for the AI Service)
• Python 3.10+ (for the AI Service microservice)

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

4. Start the AI Service (Separate Python Microservice)

   cd ai-service
   # Ensure your .env contains OPENAI_API_KEY=your_api_key
   pip install -r requirements.txt
   uvicorn main:app --port 8000

   • API URL: http://localhost:8000

(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)

AI Assistant (Beta)

MedTrack now includes a conversational AI assistant grounded in live platform data (via RAG and pgvector/Elasticsearch kNN) to help orchestrate tasks across all roles.

• How to access: Click the 🤖 icon in the bottom right of any role dashboard.
• Example Prompt: "Draft a purchase order for 3 replacement infusion pump batteries at City General."
• Important Guardrail: All AI-drafted actions require explicit human review. A user must click "Approve & Submit" before any change takes effect. The agent NEVER writes directly to the database. All AI interactions are logged to the ai-events Kafka topic for auditing.

(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

A huge thank you to everyone who has contributed to MedTrack Application! Your contributions help make this project better every day. 💙

Every contribution matters — from bug fixes to major features.
Become a contributor and help us build the future of MedTrack!

(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)