# medtronic-labs/uhis_lf_mobile architecture

> Architecture diagram of the GitHub repository medtronic-labs/uhis_lf_mobile, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/medtronic-labs/uhis_lf_mobile
- Repository: https://github.com/medtronic-labs/uhis_lf_mobile

## Overview

Apon Sushashthya is a Flutter mobile app for frontline health workers, supporting offline-first patient care and AI-assisted workflows. The main journey is sign-in and data sync, patient or household discovery, then an assessment visit with triage, briefing, and optional voice-assisted form entry; the mission dashboard prioritizes follow-up work. The graph includes documented capabilities and sampled Android bridges. Several Dart subsystem paths are directory-level because their internal wiring was not sampled; their links reflect README statements rather than inferred calls.

Main entry points: [`android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt`](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt) (Android Flutter Host), [`lib/features/search`](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/search) (Patient Search), [`lib/features/visit/forms`](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/visit/forms) (Visit Assessment), [`lib/core/sync/offline_sync_service.dart`](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/sync/offline_sync_service.dart) (Offline Sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Navigation"]
  node_auth["Sign-in and Lock"]
  node_router["App Navigation<br/>[router.dart]"]
end

subgraph group_care["Patient Care"]
  node_search["Patient Search"]
  node_households["Household Enrollment"]
  node_patient["Patient Context"]
  node_visit["Visit Assessment"]
  node_scribe["AI Voice Scribe"]
  node_realtime["Realtime Speech"]
end

subgraph group_decision["Clinical Decision Support"]
  node_dashboard["Mission Dashboard"]
  node_mission["Worklist Prioritization"]
  node_triage["Symptom Triage"]
  node_briefing["Pre-visit Briefing"]
  node_risk["Risk Evaluation"]
end

subgraph group_platform["Data and Integrations"]
  node_localdata[("Offline Data Store<br/>[app_database.dart]")]
  node_sync["Offline Sync"]
  node_api["Backend API<br/>[api_client.dart]"]
  node_coachingbridge["Coaching Bridge"]
  node_coachingsdk["Coaching SDK Setup<br/>[MainApplication.kt]"]
  node_syncbridge["Sync Service Bridge"]
  node_syncservice["Android Sync Service"]
  node_battery["Battery Settings Bridge"]
  node_activity["Android Flutter Host<br/>[MainActivity.kt]"]
end

node_worker(("Health Worker"))
node_gateway{{"UHIS Gateway"}}

node_worker -->|"signs in"| node_auth
node_auth -->|"sets access state"| node_router
node_router -->|"opens"| node_dashboard
node_dashboard -->|"prioritizes work"| node_mission
node_worker -->|"searches records"| node_search
node_search -.->|"finds patient"| node_patient
node_search -.->|"finds household"| node_households
node_patient -.->|"starts assessment"| node_visit
node_visit -.->|"collects symptoms"| node_triage
node_triage -->|"shows pre-visit cards"| node_briefing
node_visit -->|"assists form entry"| node_scribe
node_scribe -.->|"uses speech input"| node_realtime
node_mission -->|"ranks clinical risk"| node_risk
node_sync -->|"updates records"| node_localdata
node_sync -->|"fetches synced data"| node_api
node_api -->|"sends requests"| node_gateway
node_activity -->|"registers plugin"| node_coachingbridge
node_activity -->|"registers plugin"| node_syncbridge
node_activity -->|"registers plugin"| node_battery
node_coachingbridge -->|"initializes SDK"| node_coachingsdk
node_syncbridge -->|"dispatches actions"| node_syncservice

click node_auth "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/core/auth"
click node_router "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/app/router.dart"
click node_dashboard "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/features/dashboard/mission_dashboard_screen.dart"
click node_mission "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/mission/mission_dashboard_service.dart"
click node_search "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/search"
click node_households "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/household/enrollment"
click node_patient "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/patient"
click node_visit "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/visit/forms"
click node_triage "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/visit/triage"
click node_briefing "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/features/visit/briefing/visit_briefing_repository.dart"
click node_scribe "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/scribe"
click node_realtime "https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/realtime_asr"
click node_risk "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/risk/risk_scoring_service.dart"
click node_localdata "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/db/app_database.dart"
click node_sync "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/sync/offline_sync_service.dart"
click node_api "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/api/api_client.dart"
click node_coachingbridge "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MicroCoachingPlugin.kt"
click node_coachingsdk "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainApplication.kt"
click node_syncbridge "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/SyncForegroundPlugin.kt"
click node_syncservice "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/SyncForegroundService.kt"
click node_battery "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/DeviceBatteryPlugin.kt"
click node_activity "https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth,node_router toneBlue
class node_search,node_households,node_patient,node_visit,node_scribe,node_realtime toneAmber
class node_dashboard,node_mission,node_triage,node_briefing,node_risk toneMint
class node_localdata,node_sync,node_api,node_coachingbridge,node_coachingsdk,node_syncbridge,node_syncservice,node_battery,node_activity,node_worker toneRose
class node_gateway toneIndigo
```

## Components

### Access and Navigation

- [Sign-in and Lock](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/core/auth): `lib/core/auth`
- [App Navigation](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/app/router.dart): `lib/app/router.dart`

### Patient Care

- [Patient Search](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/search): `lib/features/search`
- [Household Enrollment](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/household/enrollment): `lib/features/household/enrollment`
- [Patient Context](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/patient): `lib/features/patient`
- [Visit Assessment](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/visit/forms): `lib/features/visit/forms`
- [AI Voice Scribe](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/scribe): `lib/features/scribe`
- [Realtime Speech](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/realtime_asr): `lib/features/realtime_asr`

### Clinical Decision Support

- [Mission Dashboard](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/features/dashboard/mission_dashboard_screen.dart): `lib/features/dashboard/mission_dashboard_screen.dart`
- [Worklist Prioritization](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/mission/mission_dashboard_service.dart): `lib/core/mission/mission_dashboard_service.dart`
- [Symptom Triage](https://github.com/medtronic-labs/uhis_lf_mobile/tree/main/lib/features/visit/triage): `lib/features/visit/triage`
- [Pre-visit Briefing](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/features/visit/briefing/visit_briefing_repository.dart): `lib/features/visit/briefing/visit_briefing_repository.dart`
- [Risk Evaluation](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/risk/risk_scoring_service.dart): `lib/core/risk/risk_scoring_service.dart`

### Data and Integrations

- [Offline Data Store](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/db/app_database.dart): `lib/core/db/app_database.dart`
- [Offline Sync](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/sync/offline_sync_service.dart): `lib/core/sync/offline_sync_service.dart`
- [Backend API](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/lib/core/api/api_client.dart): `lib/core/api/api_client.dart`
- [Coaching Bridge](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MicroCoachingPlugin.kt): `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MicroCoachingPlugin.kt`
- [Coaching SDK Setup](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainApplication.kt): `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainApplication.kt`
- [Sync Service Bridge](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/SyncForegroundPlugin.kt): `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/SyncForegroundPlugin.kt`
- [Android Sync Service](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/SyncForegroundService.kt): `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/SyncForegroundService.kt`
- [Battery Settings Bridge](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/DeviceBatteryPlugin.kt): `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/DeviceBatteryPlugin.kt`
- [Android Flutter Host](https://github.com/medtronic-labs/uhis_lf_mobile/blob/main/android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt): `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt`

### Other components

- **Health Worker**
- **UHIS Gateway**

## Connections

- Health Worker → Sign-in and Lock: signs in (evidence: `README.md`)
- Sign-in and Lock → App Navigation: sets access state (evidence: `README.md`)
- App Navigation → Mission Dashboard: opens (evidence: `README.md`)
- Mission Dashboard → Worklist Prioritization: prioritizes work (evidence: `README.md`)
- Health Worker → Patient Search: searches records (evidence: `README.md`)
- Patient Search → Patient Context: finds patient
- Patient Search → Household Enrollment: finds household
- Patient Context → Visit Assessment: starts assessment
- Visit Assessment → Symptom Triage: collects symptoms
- Symptom Triage → Pre-visit Briefing: shows pre-visit cards (evidence: `README.md`)
- Visit Assessment → AI Voice Scribe: assists form entry (evidence: `README.md`)
- AI Voice Scribe → Realtime Speech: uses speech input
- Worklist Prioritization → Risk Evaluation: ranks clinical risk (evidence: `README.md`)
- Offline Sync → Offline Data Store: updates records (evidence: `README.md`)
- Offline Sync → Backend API: fetches synced data (evidence: `README.md`)
- Backend API → UHIS Gateway: sends requests (evidence: `README.md`)
- Android Flutter Host → Coaching Bridge: registers plugin (evidence: `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt`)
- Android Flutter Host → Sync Service Bridge: registers plugin (evidence: `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt`)
- Android Flutter Host → Battery Settings Bridge: registers plugin (evidence: `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MainActivity.kt`)
- Coaching Bridge → Coaching SDK Setup: initializes SDK (evidence: `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/MicroCoachingPlugin.kt`)
- Sync Service Bridge → Android Sync Service: dispatches actions (evidence: `android/app/src/main/kotlin/com/medtroniclabs/uhis_next/SyncForegroundPlugin.kt`)
