Hicham-Elkebdani/MedConnect

MedConnect Oriental is a secure AI-powered platform that digitalizes specialized medical consultation referrals between healthcare facilities and CHU hospitals in Morocco. It improves patient orientation, reduces administrative delays, and enhances healthcare coordination using local AI and encrypted medical data. # MedConnect Oriental - Project Structure & Deployment Guide ## Table of Contents 1. Project Overview 2. Running the Application 3. Features & Functionality 4. Technical Architecture 5. User Roles & Permissions 6. Security Features 7. Technology Stack 8. Deployment Guide 9. Production Deployment 10. Credit --- ## Project Overview **MedConnect Oriental** is a secure medical referral management system designed for healthcare facilities in the Oriental region of Morocco. The platform facilitates the electronic referral of patients from Level 2 healthcare facilities (clinics, local health centers) to CHU (University Hospital Center) specialist departments. The system addresses critical healthcare challenges by: - **Digitizing the referral process** - Replacing paper-based referrals with electronic workflows - **AI-assisted triage** - Using local AI (Ollama) to recommend appropriate specialist departments - **Data encryption** - Encrypting sensitive patient data (PII) at rest using AES-256-GCM - **Audit compliance** - Maintaining comprehensive audit logs for Moroccan Law 09-08 compliance - **Multi-facility support** - Enabling referrals from multiple Level 2 facilities to CHU departments ### Problem Statement In the Oriental region of Morocco, patient referrals from local clinics to the CHU involve: - Paper-based documentation that can be lost or delayed - No standardized triage process - Difficulty tracking referral status - Limited visibility into department capacity - Security concerns for sensitive patient health information --- ## Running the Application ### Prerequisites | Requirement | Version | |-------------|---------| | Docker | 20.10+ | | Docker Compose | 2.0+ | | Go | 1.22+ | | Node.js | 18+ | | Bash | Any (macOS/Linux) | > **Note:** The `run.sh` script auto-creates a `.env` file from `.env.example` on first run. Before starting, review `.env.example` and set at minimum `AES_KEY` and `JWT_SECRET` (see Environment Variables below). The `WA_TOKEN` …