🏥 Smartcare HMS — Hospital Management System

A full-stack Hospital Management System built with React + Vite, Node.js/Express, MongoDB, and JWT authentication. Supports three roles: Patient, Doctor, and Admin.

---

🚀 Quick Start

Prerequisites

• Node.js v18+
• MongoDB (local or Atlas)
• npm

1. Clone / Extract the project

cd smartcare-hms

2. Backend Setup

cd backend
cp .env.example .env

npm install
npm run seed     # Seed database with sample data
npm run dev      # Start backend on port 5001

3. Frontend Setup

cd ../frontend
npm install
npm run dev      # Start frontend on port 5173

Open http://localhost:5173

---

---

📁 Project Structure

smartcare-hms/
├── backend/
│   ├── server.js
│   ├── .env.example
│   ├── package.json
│   ├── models/
│   │   ├── User.js          # Base model + Patient/Doctor/Admin discriminators
│   │   ├── Test.js
│   │   └── Appointment.js
│   ├── middleware/
│   │   └── auth.js          # JWT verify + RBAC
│   ├── controllers/
│   │   ├── authController.js
│   │   ├── doctorController.js
│   │   ├── testController.js
│   │   ├── appointmentController.js
│   │   └── adminController.js
│   ├── routes/
│   │   ├── auth.js
│   │   ├── doctors.js
│   │   ├── tests.js
│   │   ├── appointments.js
│   │   ├── slots.js
│   │   ├── admin.js
│   │   └── contact.js
│   └── utils/
│       └── seed.js
│
└── frontend/
    ├── index.html
    ├── vite.config.js
    ├── tailwind.config.js
    └── src/
        ├── main.jsx
        ├── App.jsx
        ├── index.css
        ├── utils/
        │   └── api.js           # Axios instance with JWT interceptor
        ├── context/
        │   └── AuthContext.jsx  # Auth state management
        ├── components/
        │   ├── layout/
        │   │   └── Navbar.jsx
        │   └── common/
        │       └── BookingModal.jsx
        └── pages/
            ├── Home.jsx
            ├── Doctors.jsx
            ├── Tests.jsx
            ├── Contact.jsx
            ├── auth/
            │   └── AuthPage.jsx
            ├── patient/
            │   └── Dashboard.jsx
            ├── doctor/
            │   └── Dashboard.jsx
            └── admin/
                └── Dashboard.jsx

🏗️ Key Features

Booking Rules

• Slots: Every 15 minutes, 8:00 AM – 10:00 PM
• Working days: Saturday – Thursday (Friday is off)
• Double booking: Prevented — each slot handles one patient
• Daily limit: One booking per patient per doctor/test per day

Role-Based Access

• Patient: Book appointments, view/cancel their own appointments, manage profile
• Doctor: View & manage their appointments (confirm/reject/complete), update profile
• Admin: Full control over tests, test bookings, doctor management, stats

Security

• Passwords hashed with bcrypt (salt rounds: 12)
• JWT tokens expire in 7 days
• Rate limiting: 100 requests per 15 minutes per IP
• CORS restricted to frontend origin
• Helmet.js security headers

---

🚢 Deployment

Backend (e.g. Railway / Render)

1. Set environment variables from .env.example
2. Set MONGODB_URI to your MongoDB Atlas URI
3. Set CLIENT_URL to your deployed frontend URL
4. Deploy the backend/ folder

Frontend (e.g. Vercel / Netlify)

1. Update vite.config.js proxy OR set VITE_API_URL env variable
2. In src/utils/api.js, change baseURL to your backend URL for production
3. Deploy the frontend/ folder

MongoDB Atlas

1. Create free cluster at mongodb.com/atlas
2. Whitelist all IPs (0.0.0.0/0) for cloud deployment
3. Copy connection string to MONGODB_URI

---

🐛 Troubleshooting

Problem	Solution
MongoServerError: connect ECONNREFUSED	Start MongoDB locally or use Atlas URI
Invalid admin key	Check ADMIN_KEY in .env matches what you enter in signup
CORS errors	Ensure CLIENT_URL in backend .env matches your frontend port
Slots not loading	Make sure you're passing date, type, and id as query params
401 on dashboard	Token may have expired — log out and log in again

---

📄 License

MIT © Smartcare HMS

Smartcare-HMS