# arpitjain-coder/pashuraksha architecture

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

- Interactive diagram: https://gitdiagram.com/arpitjain-coder/pashuraksha
- Repository: https://github.com/arpitjain-coder/pashuraksha

## Overview

PashuSetu is a native, offline-first livestock-health and veterinary triage app serving farmers, veterinarians, and district officers. Farmers report symptoms through a guided intake; local triage and case tracking inform farmer action plans and the veterinary queue, while officer screens present district risk and outbreak clusters. Compose screens route through the main activity and view model into a repository backed by Room. The README also documents voice, camera, route-planning, and heatmap capabilities; those are represented as documented product branches, but their implementation wiring was not shown in the sampled source.

Main entry points: [`app/src/main/java/com/pashusetu/app/MainActivity.kt`](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/MainActivity.kt) (App navigation), [`app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt`](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt) (Pashu repository), [`app/src/main/java/com/pashusetu/app/presentation/ui/components/PashuComponents.kt`](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/components/PashuComponents.kt) (Shared UI), [`app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/ReportWizardScreens.kt`](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/ReportWizardScreens.kt) (Symptom reporting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["App experience"]
  node_activity["App navigation<br/>[MainActivity.kt]"]
  node_auth["Sign-in &amp; language<br/>[AuthScreens.kt]"]
  node_viewmodel["App state<br/>[MainViewModel.kt]"]
  node_components["Shared UI<br/>[PashuComponents.kt]"]
end

subgraph group_workflow["Health workflows"]
  node_herd["Herd catalog<br/>[HerdScreens.kt]"]
  node_farmerhome["Farmer dashboard"]
  node_report["Symptom reporting"]
  node_triage["Triage &amp; cases"]
  node_vetportal["Vet queue &amp; routes<br/>[VetScreens.kt]"]
  node_officerportal["District surveillance<br/>[OfficerScreens.kt]"]
end

subgraph group_data["Local data"]
  node_models["Domain models<br/>[Models.kt]"]
  node_repository["Pashu repository<br/>[PashuRepository.kt]"]
  node_room[("Room database<br/>[PashuDatabase.kt]")]
  node_daos["Data access<br/>[Daos.kt]"]
  node_entities["Stored records<br/>[Entities.kt]"]
end

subgraph group_connectivity["Connectivity"]
  node_network["Network monitor<br/>[NetworkMonitor.kt]"]
  node_api["REST API client"]
  node_sync["Background sync<br/>[SyncDataWorker.kt]"]
end

node_farmer(("Farmer"))
node_vet(("Veterinarian"))
node_officer(("District officer"))
node_backend["Remote service"]

node_farmer -->|"opens app"| node_activity
node_vet -.->|"opens app"| node_activity
node_officer -.->|"opens app"| node_activity
node_activity -->|"routes to"| node_auth
node_activity -->|"routes to"| node_farmerhome
node_activity -->|"routes to"| node_herd
node_activity -->|"routes to"| node_report
node_activity -->|"routes to"| node_triage
node_activity -.->|"routes to"| node_vetportal
node_activity -.->|"routes to"| node_officerportal
node_activity -->|"creates"| node_viewmodel
node_activity -.->|"renders"| node_components
node_farmerhome -.->|"uses"| node_components
node_herd -.->|"uses"| node_components
node_report -.->|"uses"| node_components
node_triage -.->|"uses"| node_components
node_viewmodel -->|"reads &amp; writes"| node_repository
node_repository -->|"reads &amp; writes"| node_room
node_room -.->|"exposes"| node_daos
node_daos -.->|"stores"| node_entities
node_repository -->|"maps records"| node_models
node_repository -->|"checks status"| node_network
node_sync -->|"retries items"| node_repository
node_repository -.->|"uses client"| node_api
node_api -.->|"requests"| node_backend
node_farmer -->|"reports signs"| node_report
node_report -.->|"presents guidance"| node_triage
node_vet -->|"reviews queue"| node_vetportal
node_officer -->|"reviews clusters"| node_officerportal

click node_activity "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/MainActivity.kt"
click node_auth "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/auth/AuthScreens.kt"
click node_viewmodel "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/viewmodel/MainViewModel.kt"
click node_components "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/components/PashuComponents.kt"
click node_herd "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/HerdScreens.kt"
click node_farmerhome "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/FarmerHomeScreen.kt"
click node_report "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/ReportWizardScreens.kt"
click node_triage "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/TriageAndCaseScreens.kt"
click node_vetportal "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/vet/VetScreens.kt"
click node_officerportal "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/officer/OfficerScreens.kt"
click node_models "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/domain/model/Models.kt"
click node_repository "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt"
click node_room "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/local/PashuDatabase.kt"
click node_daos "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/local/dao/Daos.kt"
click node_entities "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/local/entities/Entities.kt"
click node_network "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/remote/NetworkMonitor.kt"
click node_api "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/remote/PashuSetuApiService.kt"
click node_sync "https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/repository/SyncDataWorker.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_activity,node_auth,node_viewmodel,node_components toneBlue
class node_herd,node_farmerhome,node_report,node_triage,node_vetportal,node_officerportal toneAmber
class node_models,node_repository,node_room,node_daos,node_entities toneMint
class node_network,node_api,node_sync toneRose
class node_farmer,node_vet,node_officer,node_backend toneIndigo
```

## Components

### App experience

- [App navigation](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/MainActivity.kt): `app/src/main/java/com/pashusetu/app/MainActivity.kt`
- [Sign-in & language](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/auth/AuthScreens.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/screens/auth/AuthScreens.kt`
- [App state](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/viewmodel/MainViewModel.kt): `app/src/main/java/com/pashusetu/app/presentation/viewmodel/MainViewModel.kt`
- [Shared UI](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/components/PashuComponents.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/components/PashuComponents.kt`

### Health workflows

- [Herd catalog](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/HerdScreens.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/HerdScreens.kt`
- [Farmer dashboard](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/FarmerHomeScreen.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/FarmerHomeScreen.kt`
- [Symptom reporting](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/ReportWizardScreens.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/ReportWizardScreens.kt`
- [Triage & cases](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/TriageAndCaseScreens.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/TriageAndCaseScreens.kt`
- [Vet queue & routes](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/vet/VetScreens.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/screens/vet/VetScreens.kt`
- [District surveillance](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/presentation/ui/screens/officer/OfficerScreens.kt): `app/src/main/java/com/pashusetu/app/presentation/ui/screens/officer/OfficerScreens.kt`

### Local data

- [Domain models](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/domain/model/Models.kt): `app/src/main/java/com/pashusetu/app/domain/model/Models.kt`
- [Pashu repository](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt): `app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt`
- [Room database](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/local/PashuDatabase.kt): `app/src/main/java/com/pashusetu/app/data/local/PashuDatabase.kt`
- [Data access](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/local/dao/Daos.kt): `app/src/main/java/com/pashusetu/app/data/local/dao/Daos.kt`
- [Stored records](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/local/entities/Entities.kt): `app/src/main/java/com/pashusetu/app/data/local/entities/Entities.kt`

### Connectivity

- [Network monitor](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/remote/NetworkMonitor.kt): `app/src/main/java/com/pashusetu/app/data/remote/NetworkMonitor.kt`
- [REST API client](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/remote/PashuSetuApiService.kt): `app/src/main/java/com/pashusetu/app/data/remote/PashuSetuApiService.kt`
- [Background sync](https://github.com/arpitjain-coder/pashuraksha/blob/main/app/src/main/java/com/pashusetu/app/data/repository/SyncDataWorker.kt): `app/src/main/java/com/pashusetu/app/data/repository/SyncDataWorker.kt`

### Other components

- **Farmer**
- **Veterinarian**
- **District officer**
- **Remote service**

## Connections

- Farmer → App navigation: opens app (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- Veterinarian → App navigation: opens app (evidence: `README.md`)
- District officer → App navigation: opens app (evidence: `README.md`)
- App navigation → Sign-in & language: routes to (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- App navigation → Farmer dashboard: routes to (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- App navigation → Herd catalog: routes to (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- App navigation → Symptom reporting: routes to (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- App navigation → Triage & cases: routes to (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- App navigation → Vet queue & routes: routes to (evidence: `README.md`)
- App navigation → District surveillance: routes to (evidence: `README.md`)
- App navigation → App state: creates (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- App navigation → Shared UI: renders (evidence: `app/src/main/java/com/pashusetu/app/MainActivity.kt`)
- Farmer dashboard → Shared UI: uses (evidence: `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/FarmerHomeScreen.kt`)
- Herd catalog → Shared UI: uses (evidence: `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/HerdScreens.kt`)
- Symptom reporting → Shared UI: uses (evidence: `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/ReportWizardScreens.kt`)
- Triage & cases → Shared UI: uses (evidence: `app/src/main/java/com/pashusetu/app/presentation/ui/screens/farmer/TriageAndCaseScreens.kt`)
- App state → Pashu repository: reads & writes (evidence: `app/src/main/java/com/pashusetu/app/presentation/viewmodel/MainViewModel.kt`)
- Pashu repository → Room database: reads & writes (evidence: `app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt`)
- Room database → Data access: exposes (evidence: `app/src/main/java/com/pashusetu/app/data/local/PashuDatabase.kt`)
- Data access → Stored records: stores (evidence: `app/src/main/java/com/pashusetu/app/data/local/dao/Daos.kt`)
- Pashu repository → Domain models: maps records (evidence: `app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt`)
- Pashu repository → Network monitor: checks status (evidence: `app/src/main/java/com/pashusetu/app/data/repository/PashuRepository.kt`)
- Background sync → Pashu repository: retries items (evidence: `app/src/main/java/com/pashusetu/app/data/repository/SyncDataWorker.kt`)
- Pashu repository → REST API client: uses client
- REST API client → Remote service: requests
- Farmer → Symptom reporting: reports signs (evidence: `README.md`)
- Symptom reporting → Triage & cases: presents guidance (evidence: `README.md`)
- Veterinarian → Vet queue & routes: reviews queue (evidence: `README.md`)
- District officer → District surveillance: reviews clusters (evidence: `README.md`)
