🏥 MediTrack

Your Personal Health & Medication Management Platform

A modern, full-stack health management platform to track medicines, store medical records, and monitor your wellness journey.

Features • Tech Stack • Quick Start • Project Structure • Contributing

---

✨ Features

💊 Medicine Management Smart medication reminders Dosage tracking & scheduling Medicine inventory management Refill alerts	📁 Medical Records Secure document storage Prescription uploads Lab report management Cloud-synced records
📊 Health Analytics Visual health insights Medication adherence tracking Historical data analysis Customizable reports	🔒 Security & Privacy End-to-end encryption JWT authentication HIPAA-conscious design Data never shared

---

🛠 Tech Stack

Frontend

Backend

---

🚀 Quick Start

Prerequisites

• Node.js 18+ (Download)
• MongoDB (Local or Atlas)
• Git (Download)

Installation

# Clone the repository
git clone https://github.com/dinraj910/Health-Tracker-App.git
cd Health-Tracker-App

# Install frontend dependencies
cd frontend && npm install

# Install backend dependencies
cd ../backend && npm install

# Setup environment variables
cp ../.env.example .env
# Edit .env with your configuration

Running the Application

# Terminal 1 - Start Backend
cd backend
npm run dev

# Terminal 2 - Start Frontend
cd frontend
npm run dev

Service	URL
Frontend	http://localhost:5173
Backend	http://localhost:5000

---

📁 Project Structure

Frontend Architecture

frontend/
├── src/
│   ├── components/          # Reusable UI components
│   │   ├── Navbar.jsx
│   │   ├── Sidebar.jsx
│   │   ├── MedicineCard.jsx
│   │   ├── RecordCard.jsx
│   │   └── Chart.jsx
│   │
│   ├── pages/               # Route pages
│   │   ├── Auth/
│   │   │   ├── Login.jsx
│   │   │   └── Register.jsx
│   │   ├── Home.jsx
│   │   ├── Dashboard.jsx
│   │   ├── Medicines.jsx
│   │   ├── AddMedicine.jsx
│   │   ├── Records.jsx
│   │   ├── UploadRecord.jsx
│   │   ├── History.jsx
│   │   └── Profile.jsx
│   │
│   ├── layouts/             # Layout wrappers
│   │   └── AuthLayout.jsx
│   │
│   ├── routes/              # Route configuration
│   │   └── AppRoutes.jsx
│   │
│   ├── context/             # React Context providers
│   │   ├── AuthContext.jsx
│   │   └── UIContext.jsx
│   │
│   ├── services/            # API service layers
│   │   ├── authService.js
│   │   ├── medicineService.js
│   │   ├── recordService.js
│   │   ├── logService.js
│   │   └── analyticsService.js
│   │
│   ├── hooks/               # Custom React hooks
│   │   ├── useAuth.js
│   │   └── useFetch.js
│   │
│   ├── utils/               # Helper functions
│   │   └── helpers.js
│   │
│   ├── styles/              # Global styles
│   │   └── global.css
│   │
│   ├── main.jsx             # Entry point
│   └── App.jsx              # Root component
│
├── index.html
└── package.json

Backend Architecture

backend/
├── src/
│   ├── config/              # Configuration files
│   │   ├── db.js            # Database connection
│   │   └── cloudinary.js    # Cloud storage config
│   │
│   ├── middleware/          # Express middleware
│   │   ├── authMiddleware.js
│   │   ├── errorMiddleware.js
│   │   └── uploadMiddleware.js
│   │
│   ├── controllers/         # Route handlers
│   │   ├── authController.js
│   │   ├── userController.js
│   │   ├── medicineController.js
│   │   ├── recordController.js
│   │   ├── logController.js
│   │   └── analyticsController.js
│   │
│   ├── models/              # MongoDB schemas
│   │   ├── User.js
│   │   ├── Medicine.js
│   │   ├── MedicineLog.js
│   │   └── MedicalRecord.js
│   │
│   ├── routes/              # API routes
│   │   ├── authRoutes.js
│   │   ├── userRoutes.js
│   │   ├── medicineRoutes.js
│   │   ├── recordRoutes.js
│   │   ├── logRoutes.js
│   │   └── analyticsRoutes.js
│   │
│   ├── utils/               # Utility functions
│   │   ├── token.js
│   │   ├── validators.js
│   │   └── sendEmail.js
│   │
│   ├── cron/                # Scheduled tasks
│   │   └── reminderCron.js
│   │
│   ├── app.js               # Express app setup
│   └── server.js            # Server entry point
│
├── .env
└── package.json

---

🔌 API Endpoints

Authentication

Method	Endpoint	Description
POST	/api/auth/register	Register new user
POST	/api/auth/login	User login
POST	/api/auth/logout	User logout
GET	/api/auth/me	Get current user

Medicines

Method	Endpoint	Description
GET	/api/medicines	Get all medicines
POST	/api/medicines	Add new medicine
PUT	/api/medicines/:id	Update medicine
DELETE	/api/medicines/:id	Delete medicine

Medical Records

Method	Endpoint	Description
GET	/api/records	Get all records
POST	/api/records	Upload record
DELETE	/api/records/:id	Delete record

---

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

# Create feature branch
git checkout -b feature/amazing-feature

# Commit changes
git commit -m "feat: add amazing feature"

# Push to branch
git push origin feature/amazing-feature

# Open a Pull Request

---

📄 License

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

---

Built with ❤️ by Dinraj

⭐ Star this repo if you find it helpful! ⭐