paulathejennifer/mediflow_backend

Mediflow Backend - AI-Powered Healthcare Referral System API for African facilities. # Mediflow Backend **AI-Powered Healthcare Referral System API** for African facilities. ## Overview Mediflow is an inter-facility patient referral management system with AI-assisted clinical summarization. It streamlines patient referrals between healthcare facilities by ensuring complete patient information transfer, reduced manual documentation effort, structured referral tracking, and AI-generated clinical summaries for receiving clinicians. ## Features - **Multi-facility referrals** with real-time tracking - **AI-powered summaries**, quality scores, and clinical suggestions - **Voice-to-text transcription** for medical notes - **Secure document management** with file uploads - **Role-based authentication** (Super Admin/Facility Admin/Clinician/Patient) - **MRN generation system** with concurrency safety - **Comprehensive audit logging** for accountability - **Facility-based data isolation** for security ## Architecture - **Backend**: FastAPI with SQLAlchemy ORM - **Database**: PostgreSQL with Alembic migrations - **Authentication**: JWT-based with role-based access control (RBAC) - **File Storage**: Local storage with organized structure - **AI Integration**: Ready for OpenAI API and Whisper integration ## User Roles 1. **Super Admin**: System owner with full access 2. **Facility Admin**: Manages users and operations within their facility 3. **Clinician**: Creates patients, referrals, uploads documents and voice notes 4. **Patient**: (Future) Portal access to own referral information ## Core Modules - **Authentication & Authorization**: JWT + RBAC system - **Facility Management**: Multi-facility setup with levels and types - **Patient Management**: Global patient records with facility-specific MRNs - **Referral System**: Complete referral workflow with status tracking - **Document System**: File uploads with type classification - **Voice Notes**: Audio recording and transcription pipeline - **Audit Logging**: Complete system activity tracking - **MRN …