Medical Document Manager - HealthVault

Project Description

Medical Document Manager (HealthVault) is a comprehensive healthcare information management system that enables users to securely store, organize, and manage their medical records, appointments, medications, and health information in one secure location.

Technology Stack and Tools Used

Frontend

- HTML5 (Semantic markup)
- CSS3 (Flexbox, Grid, Animations)
- Vanilla JavaScript (ES6+, No frameworks)
- Responsive Design (Mobile-first approach)

Backend

- Node.js (Runtime)
- Express.js (Web framework)
- MongoDB (Database)
- Mongoose (ODM)
- JWT (Authentication)
- bcryptjs (Password hashing)
- Nodemailer (Email service)
- CORS (Cross-origin requests)

Database

- MongoDB Atlas (Cloud database)
- MongoDB Compass (Visual tool)

Tools & Services

- Git & GitHub (Version control)
- Postman (API testing)
- VS Code (IDE)
- MongoDB Atlas (Cloud DB)
- MongoDB Compass (DB visualization)

🚀 QUICK START (Follow in Order!

Step 1: MongoDB Setup

Read: SETUP_MONGODB.md

• Create free MongoDB Atlas account
• Create cluster
• Get connection string
• Update .env file

Step 2: Install Backend Dependencies

cd backend
npm install

Step 3: Start Backend Server

npm start

Should see: ✅ MongoDB Connected Successfully!

Step 4: Open Frontend

cd frontend
# Open index.html in browser

Step 5: Download MongoDB Compass

• Download from: https://www.mongodb.com/products/compass
• Connect with same connection string
• View your data in Compass!

---

📦 Project Structure

medical-doc-manager/
├── backend/
│   ├── server.js       (Express server)
│   ├── models.js       (MongoDB schemas)
│   ├── .env           (MongoDB connection)
│   ├── package.json    (Dependencies)
│   └── node_modules/   (Auto-created)
│
├── frontend/
│   └── index.html      (Complete web app)
│
├── SETUP_MONGODB.md    (Step-by-step guide)
└── README.md          (This file)

---

🗄️ MongoDB Database

Database Name

medical_db

Collections (Tables)

• users - User accounts
• documents - Medical documents
• appointments - Doctor appointments
• medications - Current medications
• healthMetrics - Health measurements
• doctors - Doctor contacts
• medicalHistory - Health conditions
• healthAlerts - Health notifications
• insurance - Insurance policies
• activityLog - User activity

---

🎯 Features

✅ User authentication (JWT)
✅ Document upload & management
✅ Appointment scheduling
✅ Medication tracking
✅ Doctor directory
✅ Activity logging
✅ MongoDB database integration
✅ MongoDB Compass integration

---

🔧 All API Endpoints

Authentication

• POST /api/auth/signup - Create account
• POST /api/auth/login - Login
• GET /api/auth/me - Get current user

Documents

• GET /api/documents - Get documents
• POST /api/documents - Upload document
• DELETE /api/documents/:id - Delete document

Appointments

• GET /api/appointments - Get appointments
• POST /api/appointments - Schedule appointment
• DELETE /api/appointments/:id - Cancel appointment

Medications

• GET /api/medications - Get medications
• POST /api/medications - Add medication
• DELETE /api/medications/:id - Remove medication

Doctors

• GET /api/doctors - Get doctors
• POST /api/doctors - Add doctor
• DELETE /api/doctors/:id - Remove doctor

Health Alerts

• GET /api/health-alerts - Get alerts
• POST /api/health-alerts - Create alert
• PATCH /api/health-alerts/:id/read - Mark as read

Activity Log

• GET /api/activity-log - Get activity

---

🆘 Troubleshooting

MongoDB not connecting?

• Check MONGODB_URI in .env
• Verify password is correct
• Check IP whitelist in MongoDB Atlas
• Make sure cluster is running

Port 5000 already in use?

npx kill-port 5000

npm modules not installing?

npm install --force

---

🎓 Submission Info

This project demonstrates:

• Full-stack development
• MongoDB integration
• REST APIs with Express
• JWT authentication
• Email notifications
• Professional UI/UX
• Production-ready code

---

📚 Resources

• MongoDB Atlas: https://www.mongodb.com/cloud/atlas
• MongoDB Compass: https://www.mongodb.com/products/compass
• Mongoose: https://mongoosejs.com
• Express: https://expressjs.com

---

TEAM MEMBERS:

Yashasvi Panchal- EN23CS3011158 Yashika Mehta- EN23CS3011159 Yashwini Shinde- EN23CS3011164