How dhis2/dhis2-android-capture-app works
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.kt Capture app · DataSetTableScreen.kt Data Set entry · AndroidSyncRepository.kt Sync repository · MapController.kt Map controller
Components 17
App and session
- Capture app
app/src/main/java/org/dhis2/App.kt - Sign-in
login/src/androidMain/kotlin/org/dhis2/mobile/login/main/data/LoginRepositoryImpl.kt - Session manager
app/src/main/java/org/dhis2/usescases/general/SessionManagerActivity.kt
Data capture
- Tracker search
tracker/src/androidMain/kotlin/org/dhis2/tracker/search/data/SearchTrackedEntityRepositoryImpl.kt - Enrollment forms
form/src/main/java/org/dhis2/form/data/EnrollmentRepository.kt - Data Set entry
aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/ui/DataSetTableScreen.kt - Data Set data
aggregates/src/androidMain/kotlin/org/dhis2/mobile/aggregates/data/DataSetInstanceRepositoryImpl.kt
Rules and sync
- Validation rules
aggregates/src/commonMain/kotlin/org/dhis2/mobile/aggregates/domain/RunValidationRules.kt - Program rules
dhis2-mobile-program-rules/src/main/java/org/dhis2/mobileProgramRules/RuleEngineHelper.kt - Sync repository
sync/src/androidMain/kotlin/org/dhis2/mobile/sync/data/AndroidSyncRepository.kt - Sync status
sync/src/commonMain/kotlin/org/dhis2/mobile/sync/domain/SyncStatusController.kt - Sync notifications
commonskmm/src/commonMain/kotlin/org/dhis2/mobile/commons/notifications/NotificationManager.kt
Maps
- Map controller
dhis2_android_maps/src/main/java/org/dhis2/maps/MapController.kt - Tracked entity map
dhis2_android_maps/src/main/java/org/dhis2/maps/managers/TeiMapManager.kt - Map layers
dhis2_android_maps/src/main/java/org/dhis2/maps/layer/MapLayerManager.kt
Other components
- Field worker
- DHIS2 server
Connections 18
- Field worker → Capture app: uses
README.md - Capture app → Sign-in: authenticates
- Sign-in → DHIS2 server: signs in
- Capture app → Session manager: manages session
app/src/main/java/org/dhis2/usescases/general/SessionManagerActivity.kt - Field worker → Tracker search: finds records
README.md - Field worker → Enrollment forms: enters events
README.md - Field worker → Data Set entry: enters data
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
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