MedNexus

Full Stack Hospital Management System | React • Node • MySQL • Docker | Smart Front Desk. Smooth Patient Care.

---

MedNexus – Hospital Management System

MedNexus is a complete Hospital Management System built for hospitals and clinics to efficiently manage operations digitally.

It supports: • Patient registration & management • Patient records and status tracking • Doctor appointment scheduling • Billing & invoice management • Reports and summaries • Optional AI-powered assistant

The entire application runs locally using Docker — no manual database installation required.

---

Repository Branches (IMPORTANT)

This repository contains two main branches:

Branch Name	Purpose
main	Production-ready deployment code
docker-setup	Local development using Docker & MySQL

To run this project locally, you MUST use the docker-setup branch.

---

Docker-Based Setup (Recommended)

Step 1: Install Docker

Download and install Docker Desktop:

🔗 https://www.docker.com/products/docker-desktop/

After installation, open Docker Desktop and ensure:

Docker Engine is running

---

Step 2: Clone the Repository

git clone https://github.com/pawan-19012006/Hospital_Website.git
cd Hospital_Website

---

Step 3: Switch to Docker Branch

git checkout docker-setup

#Verify
git branch

#You will see:
* docker-setup

---

Project Structure

Hospital_Website/
│
├── backend/
│   ├── Dockerfile
│   ├── .env.example
│   ├── controllers/
│   ├── routes/
│   └── server.js
│
├── frontend/
│   ├── Dockerfile
│   ├── .env.example
│   ├── src/
│   └── vite.config.js
│
├── docker-compose.yml
└── schema.sql

---

Environment Variables Setup

Backend Environment

# Go to:

backend/.env.example

# to check how the format of .env file that is to be created

# Create:

backend/.env

# in the same format of .env.example, create .env file in the backend folder

Frontend Environment

# Go to:

frontend/.env.example

# to check the format of .env that is to be created

# Create:

frontend/.env

# in the same format of .env.example, create .env file in the frontend folder

---

Database Setup (Automatic)

•	✔ MySQL runs inside Docker
•	✔ Database & tables created automatically
•	✔ Uses schema.sql on first run
•	✔ Data persists using Docker volumes

No need to install MySQL manually.

---

Start the Application

# From the Project root (Hospital_Website), run in terminal:

docker compose up --build

---

Access the Application:

Frontend : http://localhost:5173
Backend API : http://localhost:5001
MySQL : Docker Internal

---

Connect Your Own MySQL Database (Optional):

# Edit backend/.env:

DB_HOST=your_mysql_host
DB_PORT=your_mysql_port
DB_USER=your_mysql_user
DB_PASSWORD=your_mysql_password
DB_NAME=your_mysql_database

---

Who Should Use This Setup?

•	Beginners learning full-stack development
•	Contributors & collaborators
•	Local testing & demos
•	Interview & portfolio projects

---

Summary

•	Fully Dockerized setup
•	One command to run everything
•	MySQL included
•	Clean separation between dev & prod

---

✨ Happy Coding ✨

```