Skip to content

Cnnb01/Healthcare-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🏥 Healthcare Management System

A full-stack healthcare management system built with React (Vite) and Express.js, backed by PostgreSQL.
This platform is designed to streamline clinic operations by enabling receptionists to register clients and doctors to manage health programs and assign them to individual clients.


✨ Features

🧾 Receptionist Dashboard

  • Register new clients with full name, phone number, and ID
  • View and search all registered clients
  • Intuitive modal interface for adding clients

🩺 Doctor Dashboard

  • Create and manage health programs (e.g., TB, HIV, Malaria)
  • Assign one or multiple programs to each client
  • View and search through assigned client programs
  • Clean UI design with soft gray and muted blue (#8DABCE) theme for low eye strain

📁 Project Structure

/frontend        # Frontend (React with Vite)
/backend       # Backend (Express.js)
/backend(pg admin)      # SQL setup (tables and seed data)

⚙️ Tech Stack

  • Frontend: React (Vite), Bootstrap
  • Backend: Express.js, Node.js
  • Database: PostgreSQL
  • Other Tools: Vite, pg, bcrypt, dotenv, cors

🚀 Getting Started

🛠 Backend Setup

  1. Navigate to the backend directory:

    cd backend
  2. Install dependencies:

    npm install
  3. Start the server:

    node server.js

The backend will run on:
http://localhost:8000


🎨 Frontend Setup (Vite)

  1. Navigate to the frontend directory:

    cd frontend
  2. Install dependencies:

    npm install
  3. Run the development server:

    npm run dev

The frontend will run on:
http://localhost:5173


🤝 Acknowledgments

This project was developed as part of an interview assignment and serves as a portfolio piece demonstrating:

  • Full-stack development (React + Express)
  • Relational database design with PostgreSQL
  • Security features such as password hashing and role authorization.
  • RESTful API architecture
  • UI/UX best practices
  • Vite-based frontend tooling

📬 Contact

Made with 💙 by Charity Nyamamba


📸 Screenshots

Receptionist HomepageDashboard alt text Recetionist Add Clients Functionality alt text Clients from receptionist's page alt text Doctor's homepage alt text Doctor's health programs alt text Client's view from doctor's page alt text


About

This repository contains a basic health information system for managing clients and health programs/services.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors