# dhis2/dhis2-android-capture-app architecture

> Architecture diagram of the GitHub repository dhis2/dhis2-android-capture-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dhis2/dhis2-android-capture-app
- Repository: https://github.com/dhis2/dhis2-android-capture-app

## Overview

DHIS2 Android Capture is an offline-first field data collection app. A worker signs in, captures Tracker, Event, or Data Set records locally, then synchronizes changes with a DHIS2 server. The graph preserves those distinct capture stages, validation/rules, and supporting map and session capabilities. The README documents the offline and synchronization workflow; source excerpts show session handling and Tracker search, but capture-to-storage and synchronization internals were not sampled, so those links are documented rather than inferred from module names.

Main entry points: [`app/src/main/java/org/dhis2/App.kt`](https://github.com/dhis2/dhis2-android-capture-app/blob/main/app/src/main/java/org/dhis2/App.kt) (Capture app), [`aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/ui/DataSetTableScreen.kt`](https://github.com/dhis2/dhis2-android-capture-app/blob/main/aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/ui/DataSetTableScreen.kt) (Data Set entry), [`sync/src/androidMain/kotlin/org/dhis2/mobile/sync/data/AndroidSyncRepository.kt`](https://github.com/dhis2/dhis2-android-capture-app/blob/main/sync/src/androidMain/kotlin/org/dhis2/mobile/sync/data/AndroidSyncRepository.kt) (Sync repository), [`dhis2_android_maps/src/main/java/org/dhis2/maps/MapController.kt`](https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2_android_maps/src/main/java/org/dhis2/maps/MapController.kt) (Map controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and session"]
  node_capture_app["Capture app<br/>[App.kt]"]
  node_login["Sign-in"]
  node_session["Session manager"]
end

subgraph group_capture["Data capture"]
  node_tracker_search["Tracker search"]
  node_enrollment["Enrollment forms"]
  node_dataset_ui["Data Set entry"]
  node_dataset_data["Data Set data"]
end

subgraph group_services["Rules and sync"]
  node_validation["Validation rules"]
  node_program_rules["Program rules"]
  node_sync_repo["Sync repository"]
  node_sync_status["Sync status"]
  node_notifications["Sync notifications"]
end

subgraph group_mapping["Maps"]
  node_map_controller["Map controller<br/>[MapController.kt]"]
  node_tei_map["Tracked entity map<br/>[TeiMapManager.kt]"]
  node_map_layers["Map layers<br/>[MapLayerManager.kt]"]
end

node_worker(("Field worker"))
node_server{{"DHIS2 server"}}

node_worker -->|"uses"| node_capture_app
node_capture_app -.->|"authenticates"| node_login
node_login -.->|"signs in"| node_server
node_capture_app -->|"manages session"| node_session
node_worker -->|"finds records"| node_tracker_search
node_worker -->|"enters events"| node_enrollment
node_worker -->|"enters data"| node_dataset_ui
node_dataset_ui -.->|"loads and saves"| node_dataset_data
node_dataset_ui -.->|"validates entries"| node_validation
node_enrollment -.->|"applies rules"| node_program_rules
node_tracker_search -.->|"queries records"| node_server
node_dataset_data -.->|"queues changes"| node_sync_repo
node_sync_repo -->|"synchronizes"| node_server
node_sync_repo -.->|"reports progress"| node_sync_status
node_sync_status -.->|"updates notices"| node_notifications
node_worker -.->|"views locations"| node_map_controller
node_map_controller -.->|"loads features"| node_tei_map
node_map_controller -.->|"manages layers"| node_map_layers

click node_capture_app "https://github.com/dhis2/dhis2-android-capture-app/blob/main/app/src/main/java/org/dhis2/App.kt"
click node_login "https://github.com/dhis2/dhis2-android-capture-app/blob/main/login/src/androidMain/kotlin/org/dhis2/mobile/login/main/data/LoginRepositoryImpl.kt"
click node_session "https://github.com/dhis2/dhis2-android-capture-app/blob/main/app/src/main/java/org/dhis2/usescases/general/SessionManagerActivity.kt"
click node_tracker_search "https://github.com/dhis2/dhis2-android-capture-app/blob/main/tracker/src/androidMain/kotlin/org/dhis2/tracker/search/data/SearchTrackedEntityRepositoryImpl.kt"
click node_enrollment "https://github.com/dhis2/dhis2-android-capture-app/blob/main/form/src/main/java/org/dhis2/form/data/EnrollmentRepository.kt"
click node_dataset_ui "https://github.com/dhis2/dhis2-android-capture-app/blob/main/aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/ui/DataSetTableScreen.kt"
click node_dataset_data "https://github.com/dhis2/dhis2-android-capture-app/blob/main/aggregates/src/androidMain/kotlin/org/dhis2/mobile/aggregates/data/DataSetInstanceRepositoryImpl.kt"
click node_validation "https://github.com/dhis2/dhis2-android-capture-app/blob/main/aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/domain/RunValidationRules.kt"
click node_program_rules "https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2-mobile-program-rules/src/main/java/org/dhis2/mobileProgramRules/RuleEngineHelper.kt"
click node_sync_repo "https://github.com/dhis2/dhis2-android-capture-app/blob/main/sync/src/androidMain/kotlin/org/dhis2/mobile/sync/data/AndroidSyncRepository.kt"
click node_sync_status "https://github.com/dhis2/dhis2-android-capture-app/blob/main/sync/src/commonMain/kotlin/org/dhis2/mobile/sync/domain/SyncStatusController.kt"
click node_notifications "https://github.com/dhis2/dhis2-android-capture-app/blob/main/commonskmm/src/commonMain/kotlin/org/dhis2/mobile/commons/notifications/NotificationManager.kt"
click node_map_controller "https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2_android_maps/src/main/java/org/dhis2/maps/MapController.kt"
click node_tei_map "https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2_android_maps/src/main/java/org/dhis2/maps/managers/TeiMapManager.kt"
click node_map_layers "https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2_android_maps/src/main/java/org/dhis2/maps/layer/MapLayerManager.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_capture_app,node_login,node_session toneBlue
class node_tracker_search,node_enrollment,node_dataset_ui,node_dataset_data toneAmber
class node_validation,node_program_rules,node_sync_repo,node_sync_status,node_notifications,node_server toneMint
class node_map_controller,node_tei_map,node_map_layers,node_worker toneRose
```

## Components

### App and session

- [Capture app](https://github.com/dhis2/dhis2-android-capture-app/blob/main/app/src/main/java/org/dhis2/App.kt): `app/src/main/java/org/dhis2/App.kt`
- [Sign-in](https://github.com/dhis2/dhis2-android-capture-app/blob/main/login/src/androidMain/kotlin/org/dhis2/mobile/login/main/data/LoginRepositoryImpl.kt): `login/src/androidMain/kotlin/org/dhis2/mobile/login/main/data/LoginRepositoryImpl.kt`
- [Session manager](https://github.com/dhis2/dhis2-android-capture-app/blob/main/app/src/main/java/org/dhis2/usescases/general/SessionManagerActivity.kt): `app/src/main/java/org/dhis2/usescases/general/SessionManagerActivity.kt`

### Data capture

- [Tracker search](https://github.com/dhis2/dhis2-android-capture-app/blob/main/tracker/src/androidMain/kotlin/org/dhis2/tracker/search/data/SearchTrackedEntityRepositoryImpl.kt): `tracker/src/androidMain/kotlin/org/dhis2/tracker/search/data/SearchTrackedEntityRepositoryImpl.kt`
- [Enrollment forms](https://github.com/dhis2/dhis2-android-capture-app/blob/main/form/src/main/java/org/dhis2/form/data/EnrollmentRepository.kt): `form/src/main/java/org/dhis2/form/data/EnrollmentRepository.kt`
- [Data Set entry](https://github.com/dhis2/dhis2-android-capture-app/blob/main/aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/ui/DataSetTableScreen.kt): `aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/ui/DataSetTableScreen.kt`
- [Data Set data](https://github.com/dhis2/dhis2-android-capture-app/blob/main/aggregates/src/androidMain/kotlin/org/dhis2/mobile/aggregates/data/DataSetInstanceRepositoryImpl.kt): `aggregates/src/androidMain/kotlin/org/dhis2/mobile/aggregates/data/DataSetInstanceRepositoryImpl.kt`

### Rules and sync

- [Validation rules](https://github.com/dhis2/dhis2-android-capture-app/blob/main/aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/domain/RunValidationRules.kt): `aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/domain/RunValidationRules.kt`
- [Program rules](https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2-mobile-program-rules/src/main/java/org/dhis2/mobileProgramRules/RuleEngineHelper.kt): `dhis2-mobile-program-rules/src/main/java/org/dhis2/mobileProgramRules/RuleEngineHelper.kt`
- [Sync repository](https://github.com/dhis2/dhis2-android-capture-app/blob/main/sync/src/androidMain/kotlin/org/dhis2/mobile/sync/data/AndroidSyncRepository.kt): `sync/src/androidMain/kotlin/org/dhis2/mobile/sync/data/AndroidSyncRepository.kt`
- [Sync status](https://github.com/dhis2/dhis2-android-capture-app/blob/main/sync/src/commonMain/kotlin/org/dhis2/mobile/sync/domain/SyncStatusController.kt): `sync/src/commonMain/kotlin/org/dhis2/mobile/sync/domain/SyncStatusController.kt`
- [Sync notifications](https://github.com/dhis2/dhis2-android-capture-app/blob/main/commonskmm/src/commonMain/kotlin/org/dhis2/mobile/commons/notifications/NotificationManager.kt): `commonskmm/src/commonMain/kotlin/org/dhis2/mobile/commons/notifications/NotificationManager.kt`

### Maps

- [Map controller](https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2_android_maps/src/main/java/org/dhis2/maps/MapController.kt): `dhis2_android_maps/src/main/java/org/dhis2/maps/MapController.kt`
- [Tracked entity map](https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2_android_maps/src/main/java/org/dhis2/maps/managers/TeiMapManager.kt): `dhis2_android_maps/src/main/java/org/dhis2/maps/managers/TeiMapManager.kt`
- [Map layers](https://github.com/dhis2/dhis2-android-capture-app/blob/main/dhis2_android_maps/src/main/java/org/dhis2/maps/layer/MapLayerManager.kt): `dhis2_android_maps/src/main/java/org/dhis2/maps/layer/MapLayerManager.kt`

### Other components

- **Field worker**
- **DHIS2 server**

## Connections

- Field worker → Capture app: uses (evidence: `README.md`)
- Capture app → Sign-in: authenticates
- Sign-in → DHIS2 server: signs in
- Capture app → Session manager: manages session (evidence: `app/src/main/java/org/dhis2/usescases/general/SessionManagerActivity.kt`)
- Field worker → Tracker search: finds records (evidence: `README.md`)
- Field worker → Enrollment forms: enters events (evidence: `README.md`)
- Field worker → Data Set entry: enters data (evidence: `README.md`)
- Data Set entry → Data Set data: loads and saves
- Data Set entry → Validation rules: validates entries
- Enrollment forms → Program rules: applies rules
- Tracker search → DHIS2 server: queries records
- Data Set data → Sync repository: queues changes
- Sync repository → DHIS2 server: synchronizes (evidence: `README.md`)
- Sync repository → Sync status: reports progress
- Sync status → Sync notifications: updates notices
- Field worker → Map controller: views locations
- Map controller → Tracked entity map: loads features
- Map controller → Map layers: manages layers
