Skip to content

Latest commit

 

History

History
133 lines (102 loc) · 3.72 KB

README.md

File metadata and controls

133 lines (102 loc) · 3.72 KB

Healvista Hospital Management System

A modern, full-stack hospital management system for seamless hospital operations, built with React, Tailwind CSS, Zustand, Lucide React, Node.js, Express, and MS SQL Server.

🚀 Project Overview

Healvista is a role-based hospital management platform designed to streamline hospital workflows for administrators, doctors, and patients. It provides real-time dashboards, management tools, and a beautiful, responsive UI for all user types.

🛠️ Tech Stack

  • Frontend: React, Tailwind CSS, Zustand, Lucide React, React Router
  • Backend: Node.js, Express, mssql (MS SQL Server)
  • Database: MS SQL Server

✨ Features

Authentication & Role-Based Access

  • Secure login for Admin, Doctor, and Patient roles
  • Role-based dashboards and navigation

Admin Dashboard

  • Overview widgets: doctors, patients, appointments, billing, pharmacy, labs, etc.
  • Management pages for:
    • Users
    • Doctors
    • Patients
    • Appointments
    • Pharmacy (medicines)
    • Labs (lab tests)
    • Billing
    • Ambulances
    • Feedback
  • CRUD operations for all entities

Doctor Dashboard

  • Overview: today's appointments, total patients, pending labs, critical patients
  • Appointments management
  • Patient list and details
  • Lab test management
  • Pharmacy (prescribe/view medicines)
  • Responsive, real-time data

Patient Dashboard

  • Overview: upcoming appointments, lab results, billing, etc.
  • Book/view appointments
  • View available doctors
  • View all available medicines
  • View lab reports
  • Request ambulance
  • Submit/view feedback

📦 Project Structure

Healvista--hospital-management-system/
├── back_end/           # Node.js/Express backend
│   ├── config/         # Database config
│   ├── controller/     # Route controllers
│   ├── routes/         # API routes
│   └── server.js       # Entry point
├── front_end/          # React frontend
│   ├── src/
│   │   ├── components/ # UI and layout components
│   │   ├── pages/      # Page components (dashboards, management)
│   │   ├── store/      # Zustand stores
│   │   └── App.jsx     # Main app
│   └── ...
├── README.md           # This file
└── ...

⚡ Getting Started

Prerequisites

  • Node.js (v16+ recommended)
  • npm
  • MS SQL Server (local or remote)

1. Clone the Repository

git clone <repo-url>
cd Healvista--hospital-management-system

2. Backend Setup

cd back_end
npm install
# Configure your .env file with DB credentials (see config/db.js)
npm start

3. Frontend Setup

cd ../front_end
npm install
npm run dev

4. Access the App

  • Open http://localhost:5173 in your browser.
  • Login as Admin, Doctor, or Patient (see your Users table for credentials).

📝 Usage Notes

  • Role-based routing: Users are redirected to their dashboard after login.
  • Admin: Full access to all management features.
  • Doctor: Can view/manage their appointments, patients, labs, and more.
  • Patient: Can view appointments, doctors, medicines, labs, and request ambulance.
  • Medicines: All patients see all available medicines (no patient-specific filtering yet).
  • API Proxy: The frontend uses a Vite proxy to connect to the backend (/api/* routes).

📚 Customization & Extending

  • To add patient-specific medicines, implement a patient-medicine relationship in the backend and expose an endpoint like /api/pharmacy/patient/:id.
  • To add more granular permissions, implement route protection using a PrivateRoute/ProtectedRoute component.
  • Easily extend dashboards with more widgets, analytics, or management features.