akvo/african-bamboo-odk-external-validations

Custom ODK Collect Apps with More Additional Functionalities # AfriBamODKValidator > African Bamboo Plot Validator An Android client application for KoboToolbox API integration. AfriBamODKValidator enables users to download, view, and manage form submissions from KoboToolbox servers with offline validation capabilities. ## Features - Connect to KoboToolbox servers (EU, Global, or custom instances) - Download and browse form submissions - Search submissions by user, UUID, or date - Lazy loading pagination for large datasets - Sync status tracking for submissions - Material 3 design with Jetpack Compose - **ODK External App**: Polygon validation for geoshape fields - **ODK Custom Camera**: Image blur detection for document photos (title deeds, farmer names) - **Plot Overlap Detection**: Detect and block overlapping plots (>= 20% threshold) - **Image Quality Check**: ML Kit OCR confidence + Laplacian fallback with color-coded watermarks - **Map Visualization**: View overlapping plots on interactive map with offline tile support - **Configurable Settings**: Runtime-adjustable thresholds for blur detection - **In-App Updates**: Self-update via GitHub Releases with version comparison and DownloadManager > **How does it all fit together?** The app has two roles: (1) a data manager that downloads submissions and populates the plot database, and (2) an external validator that ODK Collect calls to check polygons and image quality. See the Architecture Overview for diagrams explaining how these components communicate. ## Tech Stack | Component | Technology | |-----------|------------| | Language | Kotlin 2.0.21 | | UI | Jetpack Compose with Material 3 | | Architecture | MVVM with Clean Architecture | | DI | Hilt 2.51.1 | | Navigation | Navigation Compose 2.8.5 | | Database | Room 2.6.1 | | Settings | DataStore Preferences 1.1.1 | | OCR | ML Kit Text Recognition 16.0.1 | | Geometry | JTS Topology Suite 1.19.0 | | Maps | Mapbox Maps SDK 11.18.1 | | Serialization | Kotlinx Serialization 1.6.3 | | Min SDK | 24 (Android 7.0) | | Target …