README.md

Med-Space (Appointment Booking System)

📈 GitHub Repository Stats

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	✅ Contributors

This project is now OFFICIALLY accepted for

Table of Contents

• Introduction
• Features
• Tech Stack
• Demo
• Getting Started
  • Prerequisites
  • Installation
  • Configuration
• Usage
• Project Structure
• Contributing
• License
• Contact

Introduction

The Medi-Connect (Appointment Booking System) is a comprehensive web-based solution designed to streamline hospital operations by implementing efficient queuing models for Outpatient Departments (OPDs), real-time bed availability tracking, patient admission management, and inventory management for medicines and consumables. This system is scalable and can be integrated with a city-wide module, facilitating seamless coordination across multiple healthcare institutions.

Developed for the Smart India Hackathon, this platform aims to enhance patient experience, optimize hospital resources, and improve overall healthcare delivery in urban settings.

Features

• OPD Queue Management

  • Real-time tracking of patient queues
  • Online appointment scheduling
  • Notifications and alerts for patients

• Bed Availability Management

  • Real-time monitoring of bed occupancy
  • Emergency bed allocation
  • Filtering and sorting options for bed status

• Patient Admission System

  • Streamlined admission process
  • Integrated patient information and history
  • Doctor and nurse coordination tools

• Inventory Management

  • Stock level monitoring for medicines and consumables
  • Automated alerts for low stock
  • Inventory usage reporting and analytics

• User Roles and Authentication

  • Doctor and Patient roles
  • Secure authentication and authorization
  • Role-based access control

• City-Wide Integration

  • Data sharing across multiple hospitals
  • Centralized health management system integration
  • Scalable architecture for city-wide deployment

Tech Stack

• Frontend

  • React.js
  • Redux (for state management)
  • React Router
  • Axios (for API calls)
  • CSS3 / SASS

• Backend

  • Node.js
  • Express.js
  • MongoDB (or PostgreSQL/MySQL)
  • RESTful APIs
  • JWT for authentication

• Deployment

  • Render
  • Netlify

• Other Tools

  • Git & GitHub
  • Postman (for API testing)
  • ESLint & Prettier (for code quality)

Demo

Visit the deployment Site

Experience the full functionality of MediConnect through our live deployment. This platform enables seamless access to healthcare services, providing users with tools for easy communication, scheduling, and medical record management, all in one place.

Getting Started

Follow these instructions to set up a local copy of the repository on your machine for development and testing purposes.

Prerequisites

Ensure you have the following installed on your local machine:

• Node.js (v14 or later)
• npm or Yarn
• Git
• MongoDB (if using MongoDB as the database)
• Docker

Installation

1. Clone the Repository

   git clone https://github.com/Luson045/medi-connect
   cd medi-connect

2. Install Backend Dependencies

   cd server
   npm install

3. Install Frontend Dependencies

   cd client
   npm install

4. Backend Configuration

• Open the .env file and update the following variables:

PORT=5000
PASSDB=your_mongodb_connection_string
JWT=your_jwt_secret

Installation via Docker

1. Clone the Repository

   git clone https://github.com/Luson045/medi-connect
   cd medi-connect

2. Run the following commands

       docker compose build
       docker compose up
   

3. To close the running containers run docker compose down

4. Frontend will be running on localhost:3000 and backend server on localhost:5000

*** Video Guide for how to run project via Docker

Docker.SetUp.1.mp4

Usage

The backend server should be running at https://medi-connect-f671.onrender.com.

Start the Frontend Server

The frontend application should be running at http://localhost:3000.

Access the Application

Open your web browser and navigate to http://localhost:3000 to access the Medi-Connect(Application Booking System).

• backend/: Contains the server-side code, including API routes, controllers, models, and configuration files.
• frontend/: Contains the client-side code built with React.js, including components, pages, context, and services.

Code Formatting

To ensure consistent code formatting across the project, you can use the following scripts:

• Run npm run format to format your code according to Prettier's rules.
• Run npm run format-check to check if the code is formatted correctly.

Make sure to run these commands in both the client and server directories.

Our Contributors

Thank you for contributing to our repository

Stargazers ❤️

Forkers ❤️

License

This project is licensed under the MIT License.

👥 Team

Luson Basumatary Project Admin

For any inquiries or feedback, please contact. Happy Contributing 🫡

⭐️ Support the Project

If you find this project helpful, please consider giving it a ⭐ on GitHub! Your support helps to grow the project and reach more contributors.