How donmixho/aquasample works
AquaSample is an offline-first Android app for recording and supervising aquaculture water/sample observations. Operators sign in, create a sample through location/details, photo, and count/observations steps, review and save it locally; users browse sample history, while supervisors open a sample and validate or flag it with a technical comment. The graph reflects documented navigation, ViewModel/repository calls, and Room persistence. Login and photo-capture internals are not fully excerpted; the README documents the wider MVP screens and capabilities.
Main entry points: AquaNavigation.kt Route coordinator · SupervisorReviewScreen.kt Technical review · SampleCreateViewModel.kt Creation state · HomeScreen.kt Sample history
Components 24
User flow
- Sign-in
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/login/LoginScreen.kt - Sample history
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt - Sample details
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/NewSampleScreen.kt - Photo evidence
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/PhotoCaptureScreen.kt - Count and notes
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/CountObservationsScreen.kt - Sample summary
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/SampleSummaryScreen.kt - Technical review
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt
Screens and navigation
- App entry
aldemar/app/src/main/java/com/aldemar/aquasample/MainActivity.kt - Route coordinator
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Top bar
aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/AquaTopBar.kt - Status badge
aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/StatusBadge.kt
Application logic
- Session state
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/AuthViewModel.kt - History state
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleListViewModel.kt - Creation state
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt - Review state
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt - Review statuses
aldemar/app/src/main/java/com/aldemar/aquasample/data/model/SampleStatus.kt - User roles
aldemar/app/src/main/java/com/aldemar/aquasample/data/model/UserRole.kt
Local persistence
- Sample repository
aldemar/app/src/main/java/com/aldemar/aquasample/data/repository/SampleRepository.kt - Room database
aldemar/app/src/main/java/com/aldemar/aquasample/data/local/AquaSampleDatabase.kt - Sample DAO
aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt - Sample records
aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/SampleEntity.kt - Center catalog
aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/CenterEntity.kt
Other components
- Field operator
- Supervisor
Connections 36
- Field operator → App entry: opens app
README.md - Supervisor → App entry: opens app
README.md - App entry → Route coordinator: launches
aldemar/app/src/main/java/com/aldemar/aquasample/MainActivity.kt - Route coordinator → Sign-in: routes to
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Sample history: routes to
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Sample details: routes to
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Photo evidence: routes to
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Count and notes: routes to
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Sample summary: routes to
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Technical review: routes to
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Session state: creates
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Creation state: creates
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → History state: creates
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Route coordinator → Review state: creates
aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt - Sign-in → User roles: uses
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/login/LoginScreen.kt - Sample history → History state: reads state
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt - Sample history → Technical review: opens sample
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt - Sample details → Creation state: edits sample
- Photo evidence → Creation state: adds evidence
- Count and notes → Creation state: edits count
- Sample summary → Creation state: saves draft
- Technical review → Review state: submits decision
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt - Sample history → Status badge: renders status
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt - Technical review → Status badge: renders status
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt - Technical review → Top bar: renders
aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt - Creation state → Sample repository: calls
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt - History state → Sample repository: calls
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleListViewModel.kt - Review state → Sample repository: calls
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt - Sample repository → Sample DAO: queries and writes
aldemar/app/src/main/java/com/aldemar/aquasample/data/repository/SampleRepository.kt - Room database → Sample DAO: provides
aldemar/app/src/main/java/com/aldemar/aquasample/data/local/AquaSampleDatabase.kt - Sample DAO → Sample records: reads and writes
aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt - Sample DAO → Center catalog: reads and writes
aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt - Status badge → Review statuses: formats
aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/StatusBadge.kt - Review state → Review statuses: sets outcome
aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt - Field operator → Sign-in: signs in
README.md - Supervisor → Technical review: reviews samples
README.md