# panaligana17-code/2108_pabalate_panaligan-sannorem-app architecture

> Architecture diagram of the GitHub repository panaligana17-code/2108_pabalate_panaligan-sannorem-app, 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/2108_pabalate_panaligan-sannorem-app
- Repository: https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app

## Overview

San Norem is an Android store-coverage and GIS app for Nasugbu, with a separate administrator portal. A user enters the app, explores barangays and nearby retail branches on a dashboard or map, applies brand/proximity filters, and can check which branches cover a selected location. The map path loads local barangay and branch data, computes proximity and coverage, then renders markers and results. The tree also indicates administrative operations, but sampled excerpts do not expose their internal data flow; those capabilities are represented without guessed links.

Main entry points: [`app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt) (Map state), [`app/src/main/java/com/sannorem/app/data/BranchRepository.kt`](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/BranchRepository.kt) (Branch access), [`app/src/main/java/com/sannorem/app/MainActivity.kt`](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/MainActivity.kt) (Session routing), [`app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt) (User navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_main["Session routing<br/>[MainActivity.kt]"]
  node_nav["User navigation<br/>[SanNoremNavHost.kt]"]
end

subgraph group_user["User coverage"]
  node_dashboard["Branch dashboard<br/>[DashboardScreen.kt]"]
  node_dashboardvm["Dashboard state"]
  node_map["Coverage map"]
  node_mapvm["Map state"]
  node_osm["Map rendering"]
  node_branchcard["Branch cards"]
end

subgraph group_domain["Coverage domain"]
  node_bmodel["Barangay model<br/>[Barangay.kt]"]
  node_bgmodel["Barangay groups<br/>[BarangayGroup.kt]"]
  node_brand["Retail brands<br/>[Brand.kt]"]
  node_branchmodel["Branch model<br/>[RetailBranch.kt]"]
  node_coverage["Coverage result<br/>[CoverageResult.kt]"]
  node_geo["Geo calculations<br/>[GeoUtils.kt]"]
  node_findcover["Coverage lookup"]
end

subgraph group_data["Local data"]
  node_barangayrepo["Barangay access"]
  node_branchrepo["Branch access"]
  node_assetbarangay["Asset barangays"]
  node_assetbranch["Asset branches"]
  node_assets[("Local GIS data")]
end

subgraph group_admin["Admin portal"]
  node_adminlogin["Admin sign-in"]
  node_admindash["Admin operations"]
  node_admincomponents["Admin controls"]
end

node_person(("App user"))

node_person -->|"opens"| node_main
node_main -.->|"routes user"| node_nav
node_main -.->|"routes admin"| node_adminlogin
node_nav -->|"shows"| node_dashboard
node_nav -->|"shows"| node_map
node_dashboard -->|"observes"| node_dashboardvm
node_dashboard -->|"renders"| node_branchcard
node_dashboardvm -->|"loads"| node_barangayrepo
node_dashboardvm -->|"loads"| node_branchrepo
node_map -->|"observes"| node_mapvm
node_map -->|"renders map"| node_osm
node_mapvm -->|"loads"| node_barangayrepo
node_mapvm -->|"loads"| node_branchrepo
node_mapvm -->|"calculates distance"| node_geo
node_mapvm -->|"checks coverage"| node_findcover
node_findcover -->|"reads branches"| node_branchrepo
node_findcover -->|"uses geometry"| node_geo
node_assetbarangay -->|"implements"| node_barangayrepo
node_assetbranch -->|"implements"| node_branchrepo
node_assetbarangay -.->|"reads GIS data"| node_assets
node_adminlogin -->|"starts"| node_admindash
node_admindash -->|"hosts"| node_admincomponents

click node_main "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/MainActivity.kt"
click node_nav "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt"
click node_dashboard "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt"
click node_dashboardvm "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt"
click node_map "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt"
click node_mapvm "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt"
click node_osm "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/map/OsmCoverageMapView.kt"
click node_branchcard "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/components/RetailBranchCard.kt"
click node_bmodel "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/Barangay.kt"
click node_bgmodel "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/BarangayGroup.kt"
click node_brand "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/Brand.kt"
click node_branchmodel "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/RetailBranch.kt"
click node_coverage "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/CoverageResult.kt"
click node_geo "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/geo/GeoUtils.kt"
click node_findcover "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt"
click node_barangayrepo "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/BarangayRepository.kt"
click node_branchrepo "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/BranchRepository.kt"
click node_assetbarangay "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt"
click node_assetbranch "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt"
click node_assets "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/assets/nasugbu_barangays_geojson.json"
click node_adminlogin "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/AdminLoginActivity.kt"
click node_admindash "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt"
click node_admincomponents "https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardComponents.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_nav,node_person toneBlue
class node_dashboard,node_dashboardvm,node_map,node_mapvm,node_osm,node_branchcard toneAmber
class node_bmodel,node_bgmodel,node_brand,node_branchmodel,node_coverage,node_geo,node_findcover toneMint
class node_barangayrepo,node_branchrepo,node_assetbarangay,node_assetbranch,node_assets toneRose
class node_adminlogin,node_admindash,node_admincomponents toneIndigo
```

## Components

### App entry

- [Session routing](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/MainActivity.kt): `app/src/main/java/com/sannorem/app/MainActivity.kt`
- [User navigation](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt): `app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`

### User coverage

- [Branch dashboard](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/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/2108_pabalate_panaligan-sannorem-app/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/2108_pabalate_panaligan-sannorem-app/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 state](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/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 rendering](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/ui/map/OsmCoverageMapView.kt): `app/src/main/java/com/sannorem/app/ui/map/OsmCoverageMapView.kt`
- [Branch cards](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/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

- [Barangay model](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/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/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/BarangayGroup.kt): `app/src/main/java/com/sannorem/app/domain/model/BarangayGroup.kt`
- [Retail brands](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/Brand.kt): `app/src/main/java/com/sannorem/app/domain/model/Brand.kt`
- [Branch model](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/RetailBranch.kt): `app/src/main/java/com/sannorem/app/domain/model/RetailBranch.kt`
- [Coverage result](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/model/CoverageResult.kt): `app/src/main/java/com/sannorem/app/domain/model/CoverageResult.kt`
- [Geo calculations](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/geo/GeoUtils.kt): `app/src/main/java/com/sannorem/app/domain/geo/GeoUtils.kt`
- [Coverage lookup](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt): `app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt`

### Local data

- [Barangay access](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/BarangayRepository.kt): `app/src/main/java/com/sannorem/app/data/BarangayRepository.kt`
- [Branch access](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/BranchRepository.kt): `app/src/main/java/com/sannorem/app/data/BranchRepository.kt`
- [Asset barangays](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt): `app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt`
- [Asset branches](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt): `app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt`
- [Local GIS data](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/assets/nasugbu_barangays_geojson.json): `app/src/main/assets/nasugbu_barangays_geojson.json`

### Admin portal

- [Admin sign-in](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/AdminLoginActivity.kt): `app/src/main/java/com/sannorem/app/AdminLoginActivity.kt`
- [Admin operations](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt): `app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt`
- [Admin controls](https://github.com/panaligana17-code/2108_pabalate_panaligan-sannorem-app/blob/main/app/src/main/java/com/sannorem/app/AdminDashboardComponents.kt): `app/src/main/java/com/sannorem/app/AdminDashboardComponents.kt`

### Other components

- **App user**

## Connections

- App user → Session routing: opens (evidence: `app/src/main/java/com/sannorem/app/MainActivity.kt`)
- Session routing → User navigation: routes user
- Session routing → Admin sign-in: routes admin (evidence: `app/src/main/java/com/sannorem/app/MainActivity.kt`)
- User navigation → Branch dashboard: shows (evidence: `app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`)
- User navigation → Coverage map: shows (evidence: `app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt`)
- Branch dashboard → Dashboard state: observes (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt`)
- Branch dashboard → Branch cards: renders (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt`)
- Dashboard state → Barangay access: loads (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt`)
- Dashboard state → Branch access: loads (evidence: `app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt`)
- Coverage map → Map state: observes (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt`)
- Coverage map → Map rendering: renders map (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt`)
- Map state → Barangay access: loads (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Map state → Branch access: loads (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Map state → Geo calculations: calculates distance (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Map state → Coverage lookup: checks coverage (evidence: `app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt`)
- Coverage lookup → Branch access: reads branches (evidence: `app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt`)
- Coverage lookup → Geo calculations: uses geometry (evidence: `app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt`)
- Asset barangays → Barangay access: implements (evidence: `app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt`)
- Asset branches → Branch access: implements (evidence: `app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt`)
- Asset barangays → Local GIS data: reads GIS data
- Admin sign-in → Admin operations: starts (evidence: `app/src/main/java/com/sannorem/app/AdminLoginActivity.kt`)
- Admin operations → Admin controls: hosts (evidence: `app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt`)
