MedicationSystem (MediHealth Global)

Built: January 2025
Status: v0.1 - Active Development (UX Refinement in Progress)

MedicationSystem is a next-generation clinical coordination platform designed to unify the workflows of Patients, Coordinators, Nurses, Doctors, and Hospital Administrators. It bridges the gap between patient reporting and clinical action using Gemini AI and high-fidelity 3D Bio-Anatomy.

---

📱 Android App

The ecosystem includes a dedicated Android App for Patients/Users, allowing them to:

• Submit requests (Text/Voice/PDF) on the go.
• Track their medical journey and 3D diagnostics.
• Access their secure Pharmacy Wallet for QR-based medication pickup.

---

🧪 Testing & Setup Guide

To test the full system, follow this end-to-end flow:

1. Hospital Creation & Staff Onboarding

1. Create Hospital: Log in and register a new Hospital Node.
2. Invite Staff: From the Hospital Admin dashboard, generate invite links for:
   • Coordinator (Secretary)
   • Nurse
   • Doctor
3. Connect: Once these users register via the invite, they are automatically linked to your hospital's private ecosystem.

2. The Clinical Journey (Example: ACL Injury)

1. User Request: A user logs into the app/portal, selects your hospital, and submits a request: "I think I have an ACL injury." They can also attach a PDF medical report.
2. Coordinator Triage: The Coordinator receives the request first. They review the AI urgency score and assign a Nurse and Doctor to the case.
3. Nurse Intake: The Nurse opens the case, registers the patient's Vitals and Triage Notes, then passes the case to the assigned Doctor.
4. Doctor Consultation:
   • The Doctor reviews the clinical synthesis.
   • 3D AI Analysis: If a PDF or text was provided and a Gemini API Key is in the .env, the system performs a deep analysis.
   • Anatomical Mapping: The problem area (e.g., the Knee) is highlighted on the 3D Humanoid. Red areas indicate damaged tissue/bone as identified by the AI.

3. Pharmacy QR Flow

• After the consultation, the Doctor prescribes medication.
• The user receives a QR Code in their digital wallet.
• Dispensing: The pharmacist scans this QR code.
• Verification: Upon scanning, the pharmacist sees the Hospital Name, Doctor Name, and Exact Medication (Patient diagnosis remains private).

---

🧬 Gemini-Powered 3D Anatomy

• Automated Analysis: Gemini 1.5 Flash/Pro converts complex medical jargon into 3D mesh coordinates.
• Visual Diagnostics: Highlights specific parts (e.g., LegL: ACL, Vertebrae: L4) in red to represent pathology.
• Workflow Integration: Accessible by both the patient (for understanding) and the clinical staff (for precision).

---

📡 Connectivity & Tunnels

Important

For the real-time link between Users/Patients and Hospital Staff to function (especially when using the Android App or Vercel), the Backend Tunnel must be running.

Run the tunnel in your terminal:

lt --port 8001 --subdomain medical-hub-brain

🔓 Remote Configuration

To ensure seamless connectivity across Web and Android:

1. Frontend: Set VITE_TUNNEL_URL=https://medical-hub-brain.loca.lt in your .env (or your chosen subdomain).
2. Android: The app is pre-configured to allow traffic from loca.lt domains. If testing on a physical device, ensure your phone can reach the tunnel URL.
3. Local Checks: If the backend is running locally, the system automatically defaults to localhost.

---

🛠 Tech Stack

• Frontend: React + Vite (Vercel).
• Backend Logic: FastAPI (Python) + Gemini AI.
• Database: Supabase (PostgreSQL + RLS).
• Communication: Real-time subscriptions via Supabase.

---

Note: Some UI components are currently being redesigned for enhanced clinical efficiency. We are still working on the final polish.