# donmixho/aquasample architecture

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

- Interactive diagram: https://gitdiagram.com/donmixho/aquasample
- Repository: https://github.com/donmixho/aquasample

## Overview

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: [`aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt) (Route coordinator), [`aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt`](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt) (Technical review), [`aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt`](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt) (Creation state), [`aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt`](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt) (Sample history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flow["User flow"]
  node_login["Sign-in<br/>[LoginScreen.kt]"]
  node_home["Sample history<br/>[HomeScreen.kt]"]
  node_new["Sample details<br/>[NewSampleScreen.kt]"]
  node_photo["Photo evidence"]
  node_count["Count and notes"]
  node_summary["Sample summary"]
  node_review["Technical review"]
end

subgraph group_ui["Screens and navigation"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_navigation["Route coordinator<br/>[AquaNavigation.kt]"]
  node_topbar["Top bar<br/>[AquaTopBar.kt]"]
  node_badge["Status badge<br/>[StatusBadge.kt]"]
end

subgraph group_logic["Application logic"]
  node_auth["Session state<br/>[AuthViewModel.kt]"]
  node_listvm["History state"]
  node_createvm["Creation state"]
  node_reviewvm["Review state"]
  node_status["Review statuses<br/>[SampleStatus.kt]"]
  node_roles["User roles<br/>[UserRole.kt]"]
end

subgraph group_storage["Local persistence"]
  node_repository["Sample repository"]
  node_database[("Room database")]
  node_dao["Sample DAO<br/>[SampleDao.kt]"]
  node_sample["Sample records<br/>[SampleEntity.kt]"]
  node_centers["Center catalog<br/>[CenterEntity.kt]"]
end

node_operator(("Field operator"))
node_supervisor(("Supervisor"))

node_operator -->|"opens app"| node_activity
node_supervisor -->|"opens app"| node_activity
node_activity -->|"launches"| node_navigation
node_navigation -->|"routes to"| node_login
node_navigation -->|"routes to"| node_home
node_navigation -->|"routes to"| node_new
node_navigation -->|"routes to"| node_photo
node_navigation -->|"routes to"| node_count
node_navigation -->|"routes to"| node_summary
node_navigation -->|"routes to"| node_review
node_navigation -->|"creates"| node_auth
node_navigation -->|"creates"| node_createvm
node_navigation -->|"creates"| node_listvm
node_navigation -->|"creates"| node_reviewvm
node_login -->|"uses"| node_roles
node_home -->|"reads state"| node_listvm
node_home -->|"opens sample"| node_review
node_new -.->|"edits sample"| node_createvm
node_photo -.->|"adds evidence"| node_createvm
node_count -.->|"edits count"| node_createvm
node_summary -.->|"saves draft"| node_createvm
node_review -->|"submits decision"| node_reviewvm
node_home -->|"renders status"| node_badge
node_review -->|"renders status"| node_badge
node_review -->|"renders"| node_topbar
node_createvm -->|"calls"| node_repository
node_listvm -->|"calls"| node_repository
node_reviewvm -->|"calls"| node_repository
node_repository -->|"queries and writes"| node_dao
node_database -->|"provides"| node_dao
node_dao -->|"reads and writes"| node_sample
node_dao -->|"reads and writes"| node_centers
node_badge -->|"formats"| node_status
node_reviewvm -->|"sets outcome"| node_status
node_operator -->|"signs in"| node_login
node_supervisor -->|"reviews samples"| node_review

click node_activity "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/MainActivity.kt"
click node_navigation "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt"
click node_login "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/login/LoginScreen.kt"
click node_auth "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/AuthViewModel.kt"
click node_home "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt"
click node_listvm "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleListViewModel.kt"
click node_new "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/NewSampleScreen.kt"
click node_photo "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/PhotoCaptureScreen.kt"
click node_count "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/CountObservationsScreen.kt"
click node_summary "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/SampleSummaryScreen.kt"
click node_createvm "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt"
click node_review "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt"
click node_reviewvm "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt"
click node_repository "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/repository/SampleRepository.kt"
click node_database "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/AquaSampleDatabase.kt"
click node_dao "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt"
click node_sample "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/SampleEntity.kt"
click node_centers "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/CenterEntity.kt"
click node_status "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/model/SampleStatus.kt"
click node_roles "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/model/UserRole.kt"
click node_topbar "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/AquaTopBar.kt"
click node_badge "https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/StatusBadge.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_login,node_home,node_new,node_photo,node_count,node_summary,node_review toneBlue
class node_activity,node_navigation,node_topbar,node_badge toneAmber
class node_auth,node_listvm,node_createvm,node_reviewvm,node_status,node_roles toneMint
class node_repository,node_database,node_dao,node_sample,node_centers toneRose
class node_operator,node_supervisor toneIndigo
```

## Components

### User flow

- [Sign-in](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/login/LoginScreen.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/login/LoginScreen.kt`
- [Sample history](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt`
- [Sample details](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/NewSampleScreen.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/NewSampleScreen.kt`
- [Photo evidence](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/PhotoCaptureScreen.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/PhotoCaptureScreen.kt`
- [Count and notes](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/CountObservationsScreen.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/CountObservationsScreen.kt`
- [Sample summary](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/SampleSummaryScreen.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/sample/SampleSummaryScreen.kt`
- [Technical review](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt`

### Screens and navigation

- [App entry](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/MainActivity.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/MainActivity.kt`
- [Route coordinator](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`
- [Top bar](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/AquaTopBar.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/AquaTopBar.kt`
- [Status badge](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/StatusBadge.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/StatusBadge.kt`

### Application logic

- [Session state](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/AuthViewModel.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/AuthViewModel.kt`
- [History state](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleListViewModel.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleListViewModel.kt`
- [Creation state](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt`
- [Review state](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt`
- [Review statuses](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/model/SampleStatus.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/data/model/SampleStatus.kt`
- [User roles](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/model/UserRole.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/data/model/UserRole.kt`

### Local persistence

- [Sample repository](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/repository/SampleRepository.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/data/repository/SampleRepository.kt`
- [Room database](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/AquaSampleDatabase.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/data/local/AquaSampleDatabase.kt`
- [Sample DAO](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt`
- [Sample records](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/SampleEntity.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/SampleEntity.kt`
- [Center catalog](https://github.com/donmixho/aquasample/blob/main/aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/CenterEntity.kt): `aldemar/app/src/main/java/com/aldemar/aquasample/data/local/entity/CenterEntity.kt`

### Other components

- **Field operator**
- **Supervisor**

## Connections

- Field operator → App entry: opens app (evidence: `README.md`)
- Supervisor → App entry: opens app (evidence: `README.md`)
- App entry → Route coordinator: launches (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/MainActivity.kt`)
- Route coordinator → Sign-in: routes to (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Sample history: routes to (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Sample details: routes to (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Photo evidence: routes to (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Count and notes: routes to (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Sample summary: routes to (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Technical review: routes to (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Session state: creates (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Creation state: creates (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → History state: creates (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Route coordinator → Review state: creates (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/navigation/AquaNavigation.kt`)
- Sign-in → User roles: uses (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/login/LoginScreen.kt`)
- Sample history → History state: reads state (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt`)
- Sample history → Technical review: opens sample (evidence: `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 (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt`)
- Sample history → Status badge: renders status (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/home/HomeScreen.kt`)
- Technical review → Status badge: renders status (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt`)
- Technical review → Top bar: renders (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/screens/review/SupervisorReviewScreen.kt`)
- Creation state → Sample repository: calls (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleCreateViewModel.kt`)
- History state → Sample repository: calls (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SampleListViewModel.kt`)
- Review state → Sample repository: calls (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt`)
- Sample repository → Sample DAO: queries and writes (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/data/repository/SampleRepository.kt`)
- Room database → Sample DAO: provides (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/data/local/AquaSampleDatabase.kt`)
- Sample DAO → Sample records: reads and writes (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt`)
- Sample DAO → Center catalog: reads and writes (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/data/local/dao/SampleDao.kt`)
- Status badge → Review statuses: formats (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/components/StatusBadge.kt`)
- Review state → Review statuses: sets outcome (evidence: `aldemar/app/src/main/java/com/aldemar/aquasample/ui/viewmodel/SupervisorReviewViewModel.kt`)
- Field operator → Sign-in: signs in (evidence: `README.md`)
- Supervisor → Technical review: reviews samples (evidence: `README.md`)
