NEW-SIHMVP

Rural Healthcare Telemedicine MVP - Nabha

🚀 Live Demo

🌐 Try the Application

📱 Demo Credentials

Phone: 9876543210
Password: demo123

🏥 Project Overview

A telemedicine platform designed to address healthcare accessibility challenges in Nabha and surrounding rural areas of Punjab, India. This MVP provides video consultations, digital health records, medicine availability tracking, and offline capabilities optimized for low-bandwidth rural environments.

Problem Statement (ID: 25018)

🎯 Key Features

Core MVP Features

  1. Multi-lingual Support - Punjabi, Hindi, and English interfaces
  2. Video Consultations - Low-bandwidth optimized telemedicine
  3. Digital Health Records - Offline-capable patient records
  4. Medicine Tracker - Real-time pharmacy inventory
  5. AI Symptom Checker - Rule-based health assessment
  6. Offline Mode - Works without constant internet

🏗️ Project Structure

rural-healthcare-mvp/
├── .github/
│   └── workflows/
│       └── deploy.yml         # GitHub Actions CI/CD
├── backend/
│   ├── src/
│   │   ├── config/
│   │   │   └── database.js   # Database configuration
│   │   ├── controllers/      # Request handlers
│   │   ├── middleware/
│   │   │   ├── auth.js       # JWT authentication
│   │   │   ├── errorHandler.js
│   │   │   └── rateLimiter.js
│   │   ├── models/
│   │   │   └── User.js       # User model with auth
│   │   ├── routes/
│   │   │   ├── auth.routes.js
│   │   │   ├── consultation.routes.js
│   │   │   ├── medicine.routes.js
│   │   │   ├── record.routes.js
│   │   │   └── symptom.routes.js
│   │   ├── utils/
│   │   │   └── symptomData.js # AI symptom checker data
│   │   └── server.js         # Main server file
│   ├── .env.example          # Environment variables template
│   └── package.json          # Backend dependencies
├── frontend/
│   ├── public/
│   │   ├── index.html        # Main HTML file
│   │   └── manifest.json     # PWA manifest
│   ├── src/
│   │   ├── components/
│   │   │   ├── Layout/
│   │   │   │   └── Layout.js  # Main layout wrapper
│   │   │   └── PrivateRoute.js # Protected route component
│   │   ├── i18n/
│   │   │   └── i18n.js        # Multi-language support
│   │   ├── pages/
│   │   │   ├── Login.js       # Login page
│   │   │   ├── Register.js    # Registration page
│   │   │   ├── Dashboard.js   # Main dashboard
│   │   │   ├── Consultations.js
│   │   │   ├── VideoCall.js   # Video consultation
│   │   │   ├── HealthRecords.js
│   │   │   ├── MedicineTracker.js
│   │   │   ├── SymptomChecker.js
│   │   │   └── Profile.js
│   │   ├── store/
│   │   │   └── store.js       # Redux store configuration
│   │   ├── App.js             # Main React component
│   │   ├── index.js           # React entry point
│   │   ├── index.css          # Global styles
│   │   ├── serviceWorker.js  # PWA service worker
│   │   └── serviceWorkerRegistration.js
│   └── package.json          # Frontend dependencies
├── database/                 # SQLite database files
├── docs/                     # Additional documentation
├── scripts/                  # Utility scripts
├── .gitignore               # Git ignore file
├── Dockerfile               # Docker configuration
├── docker-compose.yml       # Docker Compose setup
├── netlify.toml             # Netlify deployment config
├── vercel.json              # Vercel deployment config
└── README.md                # Project documentation

🚀 Quick Start

Prerequisites

Installation

  1. Clone the repository 
    cd rural-healthcare-mvp
  2. Install Backend Dependencies 
    cd backend
npm install
  3. Install Frontend Dependencies 
    cd ../frontend
npm install
  4. Set up environment variables 
    # Create .env file in backend directory
cp backend/.env.example backend/.env
# Edit with your configuration
  5. Initialize Database 
    cd backend
npm run db:init
  6. Start Development Servers

Backend (Terminal 1):

cd backend
npm run dev
# Server runs on http://localhost:5000

Frontend (Terminal 2):

cd frontend
npm start
# App runs on http://localhost:3000

💻 Technology Stack

Backend

Frontend

📱 Features Implementation

1. User Registration/Login

2. Video Consultations

3. Digital Health Records

4. Medicine Availability

5. AI Symptom Checker

6. Offline Functionality

🌐 API Endpoints

Authentication

Consultations

Health Records

Medicine Tracker

Symptom Checker

🔒 Security Considerations

📊 Database Schema

Users Table

Patients Table

Doctors Table

Appointments Table

Health Records Table

Medicines Table

Pharmacy Inventory Table

🚢 Deployment

Local Development

npm run dev

Production Build

# Backend
cd backend
npm run build

# Frontend
cd frontend
npm run build

Docker Deployment

docker-compose up -d

Environment Variables

Required environment variables:

📈 Performance Optimization

🧪 Testing

# Run backend tests
cd backend
npm test

# Run frontend tests
cd frontend
npm test

# E2E tests
npm run test:e2e

🤝 Contributing

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open Pull Request

📄 License

This project is developed for the Government of Punjab under the Department of Higher Education.

👥 Stakeholders

📊 Success Metrics

🆘 Support

For issues and questions:

🗺️ Roadmap

Phase 1 (MVP) - Current

Phase 2

Phase 3

Built with ❤️ for rural healthcare accessibility in Punjab

Rural Healthcare MVP

Healthcare at your doorstep - A comprehensive telemedicine platform designed specifically for rural healthcare in the Nabha region, serving 173+ villages with limited medical infrastructure.

🌐 Live Demo

🔗 Live Application: https://gautamkapil9080.github.io/NEW-SIHMVP
📊 Source Code: https://github.com/gautamkapil9080/NEW-SIHMVP

Demo Credentials:

🌟 Problem Statement

Rural healthcare in the Nabha region faces critical challenges:

💡 Our Solution: Complete Healthcare Ecosystem

A Progressive Web App (PWA) that provides comprehensive healthcare services optimized for rural internet connectivity and basic smartphones.

🚀 Key Features

1. 🌐 Multilingual Interface

2. 📹 Video Consultations

3. 🤖 AI Symptom Checker

4. 💊 Real-time Medicine Tracker

5. 📋 Digital Prescription System

6. 🏛️ Government Schemes Integration

7. 🚨 Comprehensive Emergency Services

🛠️ Technical Architecture

Modern Tech Stack

Progressive Web App (PWA)

📊 Expected Impact & Scalability

Immediate Impact

Government-Ready Solution

🚀 Getting Started

Prerequisites

🔧 Quick Start (5 minutes)

  1. Clone the repository 
    git clone https://github.com/YOUR_USERNAME/rural-healthcare-mvp.git
cd rural-healthcare-mvp
  2. Install dependencies 
    npm install

    This may take 2-3 minutes to download all packages

  3. Start the development server 
    npm start

    Server will start on http://localhost:3000 and open automatically

  4. Start using the app!
    • Patient Demo: Use any name + village (suggestions provided)
    • Doctor Demo: demo@doctor.com / demo123

🏥 Firebase Setup (Optional)

The app works completely offline using localStorage. For real-time features:

  1. Create Firebase project at https://console.firebase.google.com
  2. Enable Firestore Database
  3. Copy config to src/firebase.ts: 
    const firebaseConfig = {
  apiKey: "your-api-key",
  authDomain: "your-project.firebaseapp.com",
  projectId: "your-project-id",
  // ... rest of config
};

📦 Available Commands

npm start          # Start development server (http://localhost:3000)
npm test           # Run tests
npm run build      # Build for production
npm run eject      # Eject from Create React App (not recommended)

🐛 Troubleshooting

Port 3000 already in use?

npm start -- --port 3001

npm install fails?

npm cache clean --force
npm install

Node.js not found?

🎯 Demo Credentials

Doctor Login

Or use any of these pre-configured doctors:

Patient Login

📱 How to Use

For Patients:

  1. Click “Patient Login” on the landing page
  2. Enter your name and village
  3. Describe symptoms in the symptom checker
  4. Review AI analysis and recommendations
  5. Request video consultation if needed
  6. Access emergency services if urgent
  7. View government health schemes

For Doctors:

  1. Click “Doctor Login” and use demo credentials
  2. View pending patient consultation requests
  3. Accept consultations to start video calls
  4. Create and generate PDF prescriptions
  5. Monitor patient statistics

🏗️ Project Structure

rural-healthcare-mvp/
├── public/
│   ├── index.html
│   └── manifest.json (PWA)
├── src/
│   ├── components/          # React components
│   │   ├── LandingPage.tsx
│   │   ├── PatientLogin.tsx
│   │   ├── DoctorLogin.tsx
│   │   ├── PatientDashboard.tsx
│   │   ├── DoctorDashboard.tsx
│   │   ├── PrescriptionForm.tsx
│   │   └── PatientPrescriptions.tsx
│   ├── contexts/           # React contexts
│   │   └── AuthContext.tsx
│   ├── services/          # API and utility services
│   │   ├── aiService.ts   # AI symptom analysis
│   │   ├── firestoreService.ts
│   │   └── prescriptionService.ts
│   ├── App.tsx           # Main app component
│   ├── index.tsx         # Entry point
│   └── index.css         # Tailwind CSS
├── tailwind.config.js    # Tailwind configuration
├── package.json
└── README.md

🎨 Design System

Color Palette

Typography

🚨 Emergency Features

🏥 Health Schemes Integration

The platform provides easy access to:

🤖 AI-Powered Features

Symptom Analysis

Common Conditions Covered

📋 Prescription System

Features

Medicine Database

Pre-loaded with common rural healthcare medicines:

🌐 PWA Features (Planned Enhancement)

🔒 Security & Privacy

🚀 Future Enhancements

Phase 2 Features

Phase 3 Features

🤝 Contributing

This MVP was built for internal hackathon demonstration. Future contributions welcome for:

📞 Support & Contact

📄 License

This project is designed for government deployment and public health benefit.

Built with ❤️ for rural healthcare transformation in Punjab, India

Serving 173+ villages • Connecting patients with doctors • Healthcare at your doorstep