🩺 Smart Healthcare Management System (SHMS)

An enterprise-grade, production-ready Hospital Information Management System (HIMS) and Clinical Decision Support System (CDSS) built with a modern multi-tier architecture, available on Web and Android.

---

🎯 Core Purpose & System Mission

The Smart Healthcare Management System (SHMS) was built to solve critical operational and clinical challenges faced by modern hospitals:

1. ⚡ Eliminate Hospital Waiting Times: Streamlines patient transitions through an automated 8-Stage Clinical Pathway Care Pipeline (Registration → Triage → Diagnosis → Lab Tests → Treatment → Pharmacy → Billing → Discharge).
2. 🤖 AI-Assisted Patient Safety: Integrates real-time AI microservices for symptom differential diagnosis, cardiovascular risk calculation, and drug prescription interaction safety checks.
3. 📄 Paperless Electronic Health Records (EHR): Centralizes vital signs (BP, Heart Rate, SpO2, Temperature), lab reports, doctor consultation notes, and historical medical records into a unified database.
4. 💳 Transparent Billing & Instant Claims: Automatically calculates consultation fees, lab procedures, and medication costs while generating itemized invoices and processing insurance claims with zero manual errors.
5. 📱 Omnichannel Availability: Fully responsive layout designed for desktop workstations, tablets, and Android smartphones (PWA & Native APK).

---

📱 Android Mobile Availability (PWA & APK)

SHMS is fully optimized for Android devices (smartphones and tablets):

🌟 Recommended: Progressive Web App (PWA) on Android (Instant 1-Tap Installation)

• Open Google Chrome or Samsung Internet on your Android device.
• Navigate to your SHMS web portal URL (http://<your-server-ip>:5173 or http://<your-server-ip>:8501).
• Tap Chrome Menu (⋮) ➔ Select 'Add to Home Screen' or 'Install App'.
• The app installs as a standalone native-feeling Android application complete with app drawer icon, splash screen, and offline caching via Service Worker (sw.js).

📦 Method 2: Native Android APK Build (Capacitor Engine)

Inside frontend-react/, SHMS is configured with Capacitor (capacitor.config.json) for Android native builds:

cd frontend-react
npm run build
npx cap add android
npx cap open android

In Android Studio, select Build > Build APK(s) to produce a signed release .apk for distribution.

---

📐 Architecture & Multi-Tier Tech Stack

 ┌─────────────────────────────────────────────────────────────────────────────┐
 │                                FRONTEND TIER                                 │
 │  • Streamlit Clinical Dashboard (Port 8501)                                 │
 │  • React 19 + TypeScript + Vite Web Portal (Port 5173)                       │
 │  • Android PWA Service Worker (sw.js) & Capacitor Config                    │
 └───────────────────────┬─────────────────────────────┬───────────────────────┘
                         │ (REST APIs)                 │ (AI Requests)
                         ▼                             ▼
 ┌─────────────────────────────────────────┐ ┌─────────────────────────────────┐
 │               BACKEND TIER              │ │            AI TIER              │
 │  • Java 21 + Spring Boot 3 REST API     │ │  • Python FastAPI Microservices │
 │  • JWT Security & Role-Based Access     │ │    - Symptom Analysis Engine    │
 │  • Hibernate JPA / Spring Data Repos    │ │    - Cardiovascular Risk Scorer │
 └───────────────────────┬─────────────────┘ │    - Prescription Safety Check  │
                         │                   └─────────────────────────────────┘
                         ▼
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │                            DATA PERSISTENCE TIER                            │
 │  • MySQL 8 (Production Database)                                            │
 │  • Transparent Automated Fallback to SQLite (`healthcare.db`)               │
 └─────────────────────────────────────────────────────────────────────────────┘

---

📱 Navigation & Module Guide

The system features an intuitive Pill-Shaped Sidebar Navigation Menu categorized into specialized clinical modules:

1. 🔑 Authentication & Role Access: BCrypt hashed login with role permissions (Admin, Doctor, Nurse, Pharmacist, Billing, Patient).
2. 👤 Patient Management: Registration, medical history, emergency contacts, blood group logging.
3. 👨‍⚕️ Doctor & Department Allocation: Specialty rosters, licensing numbers, shift schedules.
4. 📅 Appointment Scheduling: Real-time slot booking and queue state tracking.
5. 🛣️ Clinical Pathway Workflow: 8-stage care pipeline (Registration ➔ Triage ➔ Diagnosis ➔ Lab ➔ Treatment ➔ Pharmacy ➔ Billing ➔ Discharge).
6. 🏥 EHR & Vitals Monitor: Real-time logging of BP, HR, SpO2, Temp, and historical vitals trends.
7. 🤖 AI Clinical Decision Support: Symptom Checker, Cardiac Risk Calculator, Prescription Drug Safety Assistant, Clinical Chatbot.
8. 💊 Pharmacy & Inventory: Drug inventory tracking, reorder alerts, automated prescription mapping.
9. 💳 Billing & Claims: Itemized invoice generation and insurance claim handling.
10. ⚙️ Control & Audit Logs: System access logs and security audit trail.
11. ℹ️ About & Android App: Core mission overview, system metrics, and Android PWA/APK download guide.

---

⚡ Quick Start & Setup Guide

1. Test & Initialize Database

py -m unittest discover -s tests -p "test_*.py"

2. Start FastAPI AI Microservices (Port 8000)

cd ai-fastapi
py -m uvicorn main:app --host 127.0.0.1 --port 8000 --reload

3. Start Streamlit Clinical Portal (Port 8501)

py -m streamlit run app.py

4. Start React Web & Android PWA Portal (Port 5173)

cd frontend-react
npm install
npm run dev

---

🔑 Pre-Seeded System Credentials

Role	Username	Password	Access Level
Super Admin	ADMIN	ADMIN	Full System & Data Management
Lead Clinician	Sindiri	Aryan@AS_1622	Clinical Pathway & Patient Care
Staff Physician	Aryan	ADMIN	Consultations & Prescriptions

---

🤝 Contributing & License

Developed as part of the Smart Healthcare Initiative. Distributed under the MIT License.