# panaligana17-code/sannorem architecture

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

- Interactive diagram: https://gitdiagram.com/panaligana17-code/sannorem
- Repository: https://github.com/panaligana17-code/sannorem

## Overview

San Norem is an Android retail-coverage app for Nasugbu. Users enter the app, explore branch coverage by barangay or map location, filter brands and nearby branches, and inspect coverage results; administrators have a separate login and operations dashboard. The architecture separates Compose screens and view models from repository-backed barangay/branch data and geographic coverage logic. Several UI and admin wiring details are represented only by source-index references, so those connections are marked unverified rather than asserted as confirmed calls.

Main entry points: [`app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt) (Map state), [`app/src/main/java/com/sannorem/app/MainActivity.kt`](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/MainActivity.kt) (App entry), [`app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt) (User navigation), [`app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt`](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt) (Dashboard state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and access"]
  node_main["App entry<br/>[MainActivity.kt]"]
  node_userportal["User activity"]
  node_adminlogin["Admin login"]
  node_adminactivity["Admin activity"]
  node_admindashboard["Admin dashboard"]
end

subgraph group_user["Customer coverage"]
  node_navigation["User navigation<br/>[SanNoremNavHost.kt]"]
  node_dashboard["Branch dashboard<br/>[DashboardScreen.kt]"]
  node_dashboardvm["Dashboard state"]
  node_map["Coverage map"]
  node_mapview["Map renderer"]
  node_mapvm["Map state"]
  node_mapstate["Map UI state"]
  node_login["User login screen<br/>[LoginScreen.kt]"]
  node_branchcard["Branch card"]
end

subgraph group_domain["Coverage domain and data"]
  node_barangayrepo["Barangay repository"]
  node_assetbarangay["Asset barangays"]
  node_branchrepo["Branch repository"]
  node_assetbranch["Asset branches"]
  node_coverageusecase["Coverage lookup"]
  node_geoutils["Geographic calculations<br/>[GeoUtils.kt]"]
  node_barangaymodel["Barangay model<br/>[Barangay.kt]"]
  node_groupmodel["Barangay groups<br/>[BarangayGroup.kt]"]
  node_branchmodel["Branch model<br/>[RetailBranch.kt]"]
  node_brandmodel["Retail brands<br/>[Brand.kt]"]
  node_resultmodel["Coverage result<br/>[CoverageResult.kt]"]
end

node_customer(("App user"))

node_customer -->|"opens"| node_main
node_main -->|"routes admin"| node_adminactivity
node_main -->|"routes admin"| node_adminlogin
node_main -.->|"routes user"| node_userportal
node_adminactivity -->|"redirects unauthenticated"| node_adminlogin
node_adminactivity -->|"hosts dashboard"| node_admindashboard
node_customer -.->|"uses"| node_navigation
node_navigation -.->|"routes to"| node_login
node_navigation -.->|"routes to"| node_dashboard
node_navigation -.->|"routes to"| node_map
node_dashboard -->|"reads state"| node_dashboardvm
node_dashboard -->|"renders"| node_branchcard
node_dashboardvm -.->|"loads barangays"| node_barangayrepo
node_dashboardvm -.->|"loads branches"| node_branchrepo
node_dashboardvm -.->|"uses calculations"| node_geoutils
node_map -->|"dispatches actions"| node_mapvm
node_map -->|"renders map"| node_mapview
node_mapvm -->|"updates"| node_mapstate
node_mapvm -->|"loads barangays"| node_barangayrepo
node_mapvm -->|"loads branches"| node_branchrepo
node_mapvm -->|"calculates distances"| node_geoutils
node_mapvm -->|"looks up coverage"| node_coverageusecase
node_coverageusecase -.->|"reads branches"| node_branchrepo
node_coverageusecase -.->|"uses geography"| node_geoutils
node_assetbarangay -.->|"creates records"| node_barangaymodel
node_assetbranch -.->|"creates records"| node_branchmodel
node_branchrepo -.->|"implemented by"| node_assetbranch
node_barangayrepo -.->|"implemented by"| node_assetbarangay

click node_main "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/MainActivity.kt"
click node_userportal "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/UserMainActivity.kt"
click node_adminlogin "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/AdminLoginActivity.kt"
click node_adminactivity "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt"
click node_admindashboard "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardComponents.kt"
click node_navigation "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt"
click node_dashboard "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt"
click node_dashboardvm "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt"
click node_map "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt"
click node_mapview "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/OsmCoverageMapView.kt"
click node_mapvm "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt"
click node_mapstate "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapUiState.kt"
click node_login "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/login/LoginScreen.kt"
click node_barangayrepo "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/BarangayRepository.kt"
click node_assetbarangay "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt"
click node_branchrepo "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/BranchRepository.kt"
click node_assetbranch "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt"
click node_coverageusecase "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt"
click node_geoutils "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/geo/GeoUtils.kt"
click node_barangaymodel "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/Barangay.kt"
click node_groupmodel "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/BarangayGroup.kt"
click node_branchmodel "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/RetailBranch.kt"
click node_brandmodel "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/Brand.kt"
click node_resultmodel "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/CoverageResult.kt"
click node_branchcard "https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/components/RetailBranchCard.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_main,node_userportal,node_adminlogin,node_adminactivity,node_admindashboard,node_customer toneBlue
class node_navigation,node_dashboard,node_dashboardvm,node_map,node_mapview,node_mapvm,node_mapstate,node_login,node_branchcard toneAmber
class node_barangayrepo,node_assetbarangay,node_branchrepo,node_assetbranch,node_coverageusecase,node_geoutils,node_barangaymodel,node_groupmodel,node_branchmodel,node_brandmodel,node_resultmodel toneMint
```

## Components

### App entry and access

- [App entry](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/MainActivity.kt): `app/src/main/java/com/sannorem/app/MainActivity.kt`
- [User activity](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/UserMainActivity.kt): `app/src/main/java/com/sannorem/app/UserMainActivity.kt`
- [Admin login](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/AdminLoginActivity.kt): `app/src/main/java/com/sannorem/app/AdminLoginActivity.kt`
- [Admin activity](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt): `app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt`
- [Admin dashboard](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardComponents.kt): `app/src/main/java/com/sannorem/app/AdminDashboardComponents.kt`

### Customer coverage

- [User navigation](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt): `app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`
- [Branch dashboard](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt): `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt`
- [Dashboard state](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt): `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt`
- [Coverage map](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt): `app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt`
- [Map renderer](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/OsmCoverageMapView.kt): `app/src/main/java/com/sannorem/app/ui/map/OsmCoverageMapView.kt`
- [Map state](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt): `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`
- [Map UI state](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapUiState.kt): `app/src/main/java/com/sannorem/app/ui/map/CoverageMapUiState.kt`
- [User login screen](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/login/LoginScreen.kt): `app/src/main/java/com/sannorem/app/ui/login/LoginScreen.kt`
- [Branch card](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/ui/components/RetailBranchCard.kt): `app/src/main/java/com/sannorem/app/ui/components/RetailBranchCard.kt`

### Coverage domain and data

- [Barangay repository](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/BarangayRepository.kt): `app/src/main/java/com/sannorem/app/data/BarangayRepository.kt`
- [Asset barangays](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt): `app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt`
- [Branch repository](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/BranchRepository.kt): `app/src/main/java/com/sannorem/app/data/BranchRepository.kt`
- [Asset branches](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt): `app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt`
- [Coverage lookup](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt): `app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt`
- [Geographic calculations](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/geo/GeoUtils.kt): `app/src/main/java/com/sannorem/app/domain/geo/GeoUtils.kt`
- [Barangay model](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/Barangay.kt): `app/src/main/java/com/sannorem/app/domain/model/Barangay.kt`
- [Barangay groups](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/BarangayGroup.kt): `app/src/main/java/com/sannorem/app/domain/model/BarangayGroup.kt`
- [Branch model](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/RetailBranch.kt): `app/src/main/java/com/sannorem/app/domain/model/RetailBranch.kt`
- [Retail brands](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/Brand.kt): `app/src/main/java/com/sannorem/app/domain/model/Brand.kt`
- [Coverage result](https://github.com/panaligana17-code/sannorem/blob/main/app/src/main/java/com/sannorem/app/domain/model/CoverageResult.kt): `app/src/main/java/com/sannorem/app/domain/model/CoverageResult.kt`

### Other components

- **App user**

## Connections

- App user → App entry: opens (evidence: `app/src/main/java/com/sannorem/app/MainActivity.kt`)
- App entry → Admin activity: routes admin (evidence: `app/src/main/java/com/sannorem/app/MainActivity.kt`)
- App entry → Admin login: routes admin (evidence: `app/src/main/java/com/sannorem/app/MainActivity.kt`)
- App entry → User activity: routes user (evidence: `app/src/main/java/com/sannorem/app/MainActivity.kt`)
- Admin activity → Admin login: redirects unauthenticated (evidence: `app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt`)
- Admin activity → Admin dashboard: hosts dashboard (evidence: `app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt`)
- App user → User navigation: uses
- User navigation → User login screen: routes to (evidence: `app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`)
- User navigation → Branch dashboard: routes to (evidence: `app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`)
- User navigation → Coverage map: routes to (evidence: `app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`)
- Branch dashboard → Dashboard state: reads state (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt`)
- Branch dashboard → Branch card: renders (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt`)
- Dashboard state → Barangay repository: loads barangays (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt`)
- Dashboard state → Branch repository: loads branches (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt`)
- Dashboard state → Geographic calculations: uses calculations (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt`)
- Coverage map → Map state: dispatches actions (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt`)
- Coverage map → Map renderer: renders map (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt`)
- Map state → Map UI state: updates (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Map state → Barangay repository: loads barangays (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Map state → Branch repository: loads branches (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Map state → Geographic calculations: calculates distances (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Map state → Coverage lookup: looks up coverage (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Coverage lookup → Branch repository: reads branches (evidence: `app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt`)
- Coverage lookup → Geographic calculations: uses geography (evidence: `app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt`)
- Asset barangays → Barangay model: creates records (evidence: `app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt`)
- Asset branches → Branch model: creates records (evidence: `app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt`)
- Branch repository → Asset branches: implemented by (evidence: `app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt`)
- Barangay repository → Asset barangays: implemented by (evidence: `app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt`)
