MediLink - Medical Doctor Booking Appointment System

🏥 Project Overview

MediLink is a medical appointment booking system designed to simplify the process of scheduling medical consultations. The platform provides intuitive interfaces for patients, doctors, and administrators to manage healthcare appointments efficiently.

🌟 Features

Patient Features

• User registration and profile management
• Doctor search and discovery
• Easy appointment booking
• View upcoming appointments
• Cancel or reschedule appointments

Doctor Features

• Professional profile creation
• Availability management
• Appointment scheduling
• View and manage appointments

Admin Features

• User and doctor management
• Appointment oversight
• System configuration

📸 Project Screenshots

MediLink Patient Portal

Patient login interface with secure authentication

Doctor search and filtering functionality

Intuitive appointment scheduling interface

Patient dashboard showing upcoming appointments

Admin & Doctor Dashboard

Secure admin authentication portal

Admin interface for managing doctor profiles

Comprehensive appointment management system

Doctor's interface for managing availability

🛠 Tech Stack

Frontend

• React (Vite)
• Tailwind CSS
• React Router
• Axios
• State Management

Backend

• Node.js
• Express.js
• MongoDB
• Mongoose
• JWT Authentication
• Cloudinary (Image Storage)

Deployment

• Frontend (Patients): MediLink Live
• Admin & Doctor Dashboard: Admin & Doctor Dashboard Live
• Backend: Render
• Database: MongoDB Atlas

📦 Project Structure

MediLink/
│
├── MediLink/           # Frontend Application
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── context/
│   │   └── utils/
│
├── admin/              # Admin Dashboard
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   └── utils/
│
└── backend/            # Backend Services
    ├── config/
    ├── controllers/
    ├── models/
    ├── routes/
    └── middlewares/

🚀 Getting Started

Prerequisites

• Node.js (v16+)
• npm or yarn
• MongoDB Atlas account
• Cloudinary account

Installation

1. Clone the repository

git clone https://github.com/Derrick-Ryan-Giggs/Power-Learn-Final-Project
cd MediLink

2. Install Dependencies

# Frontend
cd MediLink
npm install

# Admin
cd ../admin
npm install

# Backend
cd ../backend
npm install

3. Environment Variables

Frontend .env

VITE_API_BASE_URL=http://localhost:4000/api

Backend .env

PORT=4000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret

Running Locally

1. Start Backend

cd backend
npm run dev

2. Start Frontend

cd MediLink
npm run dev

3. Start Admin Dashboard

cd admin
npm run dev

🌐 Deployment

Frontend & Admin (Vercel)

• MediLink (Patients): Live Link
• Admin & Doctor Dashboard: Live Link
• Connect GitHub repository
• Set root directory
• Configure build settings
• Set environment variables

Backend (Render)

• Web Service deployment
• Set environment variables
• Configure build and start commands

🔒 Security Features

• JWT Authentication
• Password Encryption
• CORS Configuration
• Environment-based Configuration
• Input Validation

📊 Key Technologies

Frontend

Backend

🤝 Contributing

1. Fork the repository
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

📄 License

Distributed under the MIT License. See LICENSE for more information.

📞 Contact

Your Name - [email protected]

Project Repository: GitHub

🙏 Acknowledgements

• React
• Tailwind CSS
• Node.js
• Express
• MongoDB
• Cloudinary