🏥 ClinicEase - Appointment Management System

A modern, full-stack hospital management system with AI-powered features built using the MERN stack (MongoDB, Express.js, React, Node.js).

✨ Overview

ClinicEase is a comprehensive healthcare management platform that streamlines hospital operations with role-based access control for patients, doctors, and administrators. The system features AI-powered chatbot assistance, automated patient summaries, and seamless appointment management.

🚀 Quick Start

Prerequisites

Node.js (v14 or higher)
MongoDB (v4.4 or higher)
npm or yarn
Google Gemini API Key (for AI features)
AWS S3 (optional, for cloud file storage)

Installation

1. Clone the Repository

git clone <repository-url>
cd ClinicEase

2. Setup Backend

cd backend
npm install

# Create .env file from example
cp .env.example .env

# Edit .env and add your configuration
# Add GEMINI_API_KEY for AI features
# Add AWS credentials for S3 (optional)

# Seed database with demo data
npm run seed

# Start backend server
npm run dev

Backend will run on http://localhost:3000

3. Setup Frontend

cd frontend
npm install

# Create .env file from example
cp .env.example .env

# Start frontend development server
npm run dev

Frontend will run on http://localhost:5173

4. Start MongoDB

Ensure MongoDB is running on your system:

mongod

Or use MongoDB Atlas for cloud database.

🔐 Demo Credentials

Role	Email	Password
Patient	john@example.com	patient123
Doctor	dr.smith@clinicease.com	doctor123
Admin	admin@clinicease.com	admin123

📋 Features

👤 For Patients

✅ User Registration & Authentication - Secure signup and login
✅ Appointment Booking - Schedule appointments with available doctors
✅ Appointment Management - View, track, and cancel appointments
✅ Medical Report Upload - Upload and store medical documents
✅ Medical History - Access complete medical history and reports
✅ AI Chatbot - Get instant health guidance and symptom analysis
✅ Dashboard - View statistics and upcoming appointments
✅ Profile Management - Update personal information

👨‍⚕️ For Doctors

✅ Doctor Registration - Register with admin approval workflow
✅ Appointment Management - View and manage patient appointments
✅ Status Updates - Approve, reject, or complete appointments
✅ Patient History Access - View complete patient medical records
✅ Report Generation - Create and upload medical reports
✅ File Attachments - Attach documents to patient reports
✅ AI Patient Summaries - Generate AI-powered patient summaries
✅ Dashboard - View appointment statistics and pending cases
✅ Prescription Guidance - AI-assisted treatment recommendations

👨‍💼 For Administrators

✅ Doctor Approval System - Approve or reject doctor registrations
✅ User Management - Manage all users (patients, doctors)
✅ Appointment Oversight - View all appointments across departments
✅ System Analytics - Comprehensive statistics and insights
✅ Search Functionality - Search users and appointments
✅ User Deletion - Remove users from the system
✅ Status Management - Update doctor approval status
✅ Dashboard - System-wide overview and metrics

🤖 AI-Powered Features

✅ Medical Chatbot - Powered by Google Gemini 2.0 Flash
✅ Symptom Analysis - AI-driven symptom evaluation
✅ Patient Summaries - Automated patient history summaries
✅ Prescription Guidance - Treatment recommendations for doctors
✅ Conversation History - Persistent chat history with context
✅ Fallback Responses - Rule-based responses when AI is unavailable

🛠️ Tech Stack

Backend

Runtime: Node.js
Framework: Express.js
Database: MongoDB with Mongoose ODM
Authentication: JWT (JSON Web Tokens)
Password Security: bcryptjs
File Upload: Multer
Cloud Storage: AWS S3 SDK
AI Integration: Google Generative AI (Gemini)
CORS: Enabled for cross-origin requests
Environment: dotenv for configuration

Frontend

Framework: React 19
Routing: React Router DOM v7
Styling: Tailwind CSS with custom Neobrutalism theme
HTTP Client: Axios
Form Handling: React Hook Form
Validation: Zod
Charts: Recharts
Icons: Lucide React
Notifications: Sonner (toast notifications)
Build Tool: Vite

📁 Project Structure

ClinicEase/
├── backend/
│   ├── src/
│   │   ├── controllers/       # Business logic & request handlers
│   │   │   ├── appointmentController.js
│   │   │   ├── authController.js
│   │   │   ├── chatbotController.js
│   │   │   ├── reportController.js
│   │   │   └── userController.js
│   │   ├── models/            # MongoDB schemas
│   │   │   ├── User.js
│   │   │   ├── Appointment.js
│   │   │   ├── Report.js
│   │   │   └── ChatHistory.js
│   │   ├── routes/            # API route definitions
│   │   │   ├── authRoutes.js
│   │   │   ├── appointmentRoutes.js
│   │   │   ├── reportRoutes.js
│   │   │   ├── userRoutes.js
│   │   │   └── chatbotRoutes.js
│   │   ├── middleware/        # Custom middleware
│   │   │   ├── auth.js        # JWT authentication
│   │   │   └── upload.js      # File upload handling
│   │   ├── services/          # External services
│   │   │   ├── geminiService.js  # AI integration
│   │   │   └── s3Service.js      # AWS S3 integration
│   │   ├── App.js            # Express app setup
│   │   └── seed.js           # Database seeding
│   ├── uploads/              # Local file storage
│   ├── .env                  # Environment variables
│   ├── .env.example          # Environment template
│   ├── package.json
│   └── setup-s3-bucket.js    # S3 bucket setup script
│
└── frontend/
    ├── src/
    │   ├── components/       # Reusable UI components
    │   │   ├── ProtectedRoute.jsx
    │   │   ├── ChatBotWindow.jsx
    │   │   ├── ReportCard.jsx
    │   │   └── ...
    │   ├── contexts/         # React Context providers
    │   │   └── AuthContext.jsx
    │   ├── hooks/            # Custom React hooks
    │   │   └── useTheme.js
    │   ├── pages/            # Page components
    │   │   ├── auth/         # Login, Register
    │   │   ├── patient/      # Patient pages
    │   │   ├── Doctor/       # Doctor pages
    │   │   ├── admin/        # Admin pages
    │   │   └── shared/       # Shared pages
    │   ├── services/         # API service layer
    │   │   ├── api.js
    │   │   ├── authService.js
    │   │   ├── appointmentService.js
    │   │   ├── reportService.js
    │   │   ├── chatbotService.js
    │   │   └── usersService.js
    │   ├── config/           # Configuration files
    │   │   └── api.js
    │   ├── App.jsx           # Main app component
    │   ├── main.jsx          # Entry point
    │   └── index.css         # Global styles
    ├── public/               # Static assets
    ├── .env                  # Environment variables
    ├── .env.example          # Environment template
    ├── index.html
    ├── package.json
    ├── tailwind.config.js    # Tailwind configuration
    └── vite.config.js        # Vite configuration

🔌 API Documentation

Authentication Endpoints

Method	Endpoint	Description	Auth Required	Role
POST	`/api/auth/register`	Register new user	No	-
POST	`/api/auth/login`	Login user	No	-
GET	`/api/auth/me`	Get current user	Yes	All
PUT	`/api/auth/profile`	Update user profile	Yes	All

Appointment Endpoints

Method	Endpoint	Description	Auth Required	Role
POST	`/api/appointments`	Create appointment	Yes	Patient
GET	`/api/appointments/my-appointments`	Get user appointments	Yes	All
GET	`/api/appointments/all`	Get all appointments	Yes	Doctor, Admin
GET	`/api/appointments/stats`	Get appointment stats	Yes	Admin
GET	`/api/appointments/:id`	Get appointment by ID	Yes	All
PUT	`/api/appointments/:id/status`	Update appointment status	Yes	Doctor, Admin
DELETE	`/api/appointments/:id`	Delete appointment	Yes	Patient, Admin

Report Endpoints

Method	Endpoint	Description	Auth Required	Role
POST	`/api/reports`	Create report (doctor)	Yes	Doctor
POST	`/api/reports/upload`	Upload report (patient)	Yes	Patient
GET	`/api/reports/my-reports`	Get user's reports	Yes	All
GET	`/api/reports/patient/:patientEmail`	Get patient reports	Yes	All
GET	`/api/reports/ai-summary/:patientEmail`	Generate AI patient summary	Yes	All
GET	`/api/reports/:id`	Get report by ID	Yes	All
GET	`/api/reports`	Get all reports	Yes	Admin
PUT	`/api/reports/:id`	Update report	Yes	Doctor, Admin
DELETE	`/api/reports/:id`	Delete report	Yes	Doctor, Admin

User Endpoints

Method	Endpoint	Description	Auth Required	Role
GET	`/api/users/doctors`	Get all doctors	Yes	All
GET	`/api/users/patients`	Get all patients	Yes	Doctor, Admin
GET	`/api/users/stats`	Get user statistics	Yes	Admin
GET	`/api/users/search`	Search users	Yes	All
GET	`/api/users/:id`	Get user by ID	Yes	All
PUT	`/api/users/doctors/:id/status`	Update doctor status	Yes	Admin
DELETE	`/api/users/:id`	Delete user	Yes	Admin

Chatbot Endpoints

Method	Endpoint	Description	Auth Required	Role
POST	`/api/chatbot/message`	Send chat message	Yes	All
GET	`/api/chatbot/history`	Get chat history	Yes	All
DELETE	`/api/chatbot/history`	Clear chat history	Yes	All

Health Check

Method	Endpoint	Description	Auth Required
GET	`/api/health`	Health check	No

📝 Environment Variables

Backend (.env)

# Server Configuration
PORT=3000
NODE_ENV=development

# Database
MONGODB_URI=mongodb://localhost:27017/clinicease

# JWT Secret (Change in production!)
JWT_SECRET=your-super-secret-jwt-key-change-this-in-production

# Frontend URL
FRONTEND_URL=http://localhost:5173

# Google Gemini AI
GEMINI_API_KEY=your-gemini-api-key

# AWS S3 (Optional)
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key
AWS_REGION=us-east-1
AWS_S3_BUCKET_NAME=clinicease-uploads

Frontend (.env)

VITE_API_URL=http://localhost:3000/api

🧪 Testing

The project includes several test scripts to verify functionality:

cd backend

# Test all endpoints
node test-all-endpoints.js

# Test AI features
node test-ai-features.js

# Test report creation
node test-report-creation.js

# Test Gemini API directly
node test-gemini-direct.js

# Simple API test
node test-simple.js

🔒 Security Features

JWT Authentication - Secure token-based authentication
Password Hashing - bcryptjs with salt rounds
Role-Based Access Control (RBAC) - Granular permissions
Protected Routes - Frontend and backend route protection
CORS Configuration - Controlled cross-origin access
File Upload Validation - Secure file handling with Multer
Environment Variables - Sensitive data protection
Input Validation - Zod schema validation on frontend
MongoDB Injection Prevention - Mongoose sanitization

🎨 Design System

The frontend uses a custom Neobrutalism design system with:

Bold borders and shadows
Vibrant color palette
Rounded corners (1.25rem)
Custom shadow effects
Accessible color contrast
Responsive design

Color Palette

nb-bg: #F2F7F9        // Background
nb-ink: #0F172A       // Text/Borders
nb-accent: #A78BFA    // Primary accent (Purple)
nb-accent-2: #34D399  // Secondary accent (Green)
nb-warn: #FBBF24      // Warning (Yellow)
nb-error: #F43F5E     // Error (Red)
nb-ok: #22C55E        // Success (Green)
nb-card: #FFFFFF      // Card background

🐛 Troubleshooting

MongoDB Connection Error

# Ensure MongoDB is running
mongod

# Or check if MongoDB service is active
sudo systemctl status mongod

Port Already in Use

# Backend: Change PORT in backend/.env
PORT=3001

# Frontend: Vite will auto-select next available port
# Or specify in package.json: "dev": "vite --port 5174"

CORS Errors

Verify FRONTEND_URL in backend/.env matches your frontend URL:

FRONTEND_URL=http://localhost:5173

AI Features Not Working

Ensure you have a valid Google Gemini API key:

GEMINI_API_KEY=your-actual-api-key

Get your API key from: https://makersuite.google.com/app/apikey

File Upload Issues

Check upload directory permissions:

cd backend
mkdir -p uploads
chmod 755 uploads

📦 Deployment

Backend Deployment

Set NODE_ENV=production in environment
Use a process manager like PM2
Configure MongoDB Atlas for cloud database
Set up AWS S3 for file storage
Use environment variables for all secrets

Frontend Deployment

Build the production bundle:

npm run build

Deploy the dist folder to:
- Vercel
- Netlify
- AWS S3 + CloudFront
- Any static hosting service
Update VITE_API_URL to production backend URL

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

This project is licensed under the ISC License. See the LICENSE file for details.

👥 Authors

16010123036 - Amandeep Singh

16010123037 - Ambuj Rai

16010123035 - Alapan Barman

🙏 Acknowledgments

Google Gemini AI for chatbot capabilities
MongoDB for database solutions
React and Vite teams for excellent developer experience
Tailwind CSS for styling framework

Status: ✅ Production Ready - All features implemented and tested

Version: 1.0.0

For questions or support, please open an issue on GitHub.

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
.vscode		.vscode
backend		backend
frontend		frontend
.DS_Store		.DS_Store
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json

Folders and files

Latest commit

History

Repository files navigation

🏥 ClinicEase - Appointment Management System

✨ Overview

🚀 Quick Start

Prerequisites

Installation

1. Clone the Repository

2. Setup Backend

3. Setup Frontend

4. Start MongoDB

🔐 Demo Credentials

📋 Features

👤 For Patients

👨‍⚕️ For Doctors

👨‍💼 For Administrators

🤖 AI-Powered Features

🛠️ Tech Stack

Backend

Frontend

📁 Project Structure

🔌 API Documentation

Authentication Endpoints

Appointment Endpoints

Report Endpoints

User Endpoints

Chatbot Endpoints

Health Check

📝 Environment Variables

Backend (.env)

Frontend (.env)

🧪 Testing

🔒 Security Features

🎨 Design System

Color Palette

🐛 Troubleshooting

MongoDB Connection Error

Port Already in Use

CORS Errors

AI Features Not Working

File Upload Issues

📦 Deployment

Backend Deployment

Frontend Deployment

🤝 Contributing

📄 License

👥 Authors

🙏 Acknowledgments

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages