cmejia5486/uganda

# 🇼 UgandaEMR Mobile App **UgandaEMR Mobile** is an Android application built to support **offline FHIR-based data collection**, patient management, and encounter recording in healthcare facilities across Uganda. The app uses the Android FHIR SDK to enable standards-based interoperability and integrates with the UgandaEMR backend via OpenMRS FHIR. --- ## 📲 Features * ✅ FHIR-based Patient registration, visits, and encounters * ✅ Form rendering using FHIR SDC questionnaires * ✅ Offline-first with encrypted local FHIR storage * ✅ Secure user authentication and session management * ✅ Data synchronization with OpenMRS-compatible FHIR server * ✅ Modular, testable codebase with modern Android architecture --- ## 🏗️ Architecture Overview The app follows **Clean Architecture** and integrates the **Android FHIR SDK**: ``` UI (Jetpack Compose) ↓ ViewModel (StateFlow) ↓ UseCase (Business logic) ↓ FHIRRepository (Data layer) ↓ Android FHIR Engine (local store) + Remote FHIR API (OpenMRS) ``` ### 🔧 Tech Stack * 🧱 Jetpack Compose (UI) * 🏧 MVVM + Use Cases + Hilt * 📦 Android FHIR Engine (SDK) * 🌐 OpenMRS FHIR API (DSTU3/R4) * 📂 Encrypted SharedPreferences + DataStore * 📲 WorkManager (sync) * 🔐 Secure local FHIR storage --- ## 🧹 Modules | Module | Description | | ----------------- | ----------------------------------------------- | | `app` | Main navigation & entry point | | `core-fhir` | FHIR engine config, DAO wrappers | | `core-ui` | Shared UI components, theme, typography | | `core-network` | FHIR REST client config | | `core-domain` | Use cases, models, validators | | `feature-auth` | Login & token management | | `feature-patient` | Patient list, search, registration (FHIR-based) | | `feature-form` | SDC Questionnaire rendering + response mapping | | `feature-sync` | Backg …