How panaligana17-code/sannorem works
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: CoverageMapViewModel.kt Map state · MainActivity.kt App entry · SanNoremNavHost.kt User navigation · DashboardViewModel.kt Dashboard state
Components 26
App entry and access
- App entry
app/src/main/java/com/sannorem/app/MainActivity.kt - User activity
app/src/main/java/com/sannorem/app/UserMainActivity.kt - Admin login
app/src/main/java/com/sannorem/app/AdminLoginActivity.kt - Admin activity
app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt - Admin dashboard
app/src/main/java/com/sannorem/app/AdminDashboardComponents.kt
Customer coverage
- User navigation
app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt - Branch dashboard
app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt - Dashboard state
app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt - Coverage map
app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt - Map renderer
app/src/main/java/com/sannorem/app/ui/map/OsmCoverageMapView.kt - Map state
app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt - Map UI state
app/src/main/java/com/sannorem/app/ui/map/CoverageMapUiState.kt - User login screen
app/src/main/java/com/sannorem/app/ui/login/LoginScreen.kt - Branch card
app/src/main/java/com/sannorem/app/ui/components/RetailBranchCard.kt
Coverage domain and data
- Barangay repository
app/src/main/java/com/sannorem/app/data/BarangayRepository.kt - Asset barangays
app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt - Branch repository
app/src/main/java/com/sannorem/app/data/BranchRepository.kt - Asset branches
app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt - Coverage lookup
app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt - Geographic calculations
app/src/main/java/com/sannorem/app/domain/geo/GeoUtils.kt - Barangay model
app/src/main/java/com/sannorem/app/domain/model/Barangay.kt - Barangay groups
app/src/main/java/com/sannorem/app/domain/model/BarangayGroup.kt - Branch model
app/src/main/java/com/sannorem/app/domain/model/RetailBranch.kt - Retail brands
app/src/main/java/com/sannorem/app/domain/model/Brand.kt - Coverage result
app/src/main/java/com/sannorem/app/domain/model/CoverageResult.kt
Other components
- App user
Connections 28
- App user → App entry: opens
app/src/main/java/com/sannorem/app/MainActivity.kt - App entry → Admin activity: routes admin
app/src/main/java/com/sannorem/app/MainActivity.kt - App entry → Admin login: routes admin
app/src/main/java/com/sannorem/app/MainActivity.kt - App entry → User activity: routes user
app/src/main/java/com/sannorem/app/MainActivity.kt - Admin activity → Admin login: redirects unauthenticated
app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt - Admin activity → Admin dashboard: hosts dashboard
app/src/main/java/com/sannorem/app/AdminDashboardActivity.kt - App user → User navigation: uses
- User navigation → User login screen: routes to
app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt - User navigation → Branch dashboard: routes to
app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt - User navigation → Coverage map: routes to
app/src/main/java/com/sannorem/app/ui/navigation/SanNoremNavHost.kt - Branch dashboard → Dashboard state: reads state
app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt - Branch dashboard → Branch card: renders
app/src/main/java/com/sannorem/app/ui/dashboard/DashboardScreen.kt - Dashboard state → Barangay repository: loads barangays
app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt - Dashboard state → Branch repository: loads branches
app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt - Dashboard state → Geographic calculations: uses calculations
app/src/main/java/com/sannorem/app/ui/dashboard/DashboardViewModel.kt - Coverage map → Map state: dispatches actions
app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt - Coverage map → Map renderer: renders map
app/src/main/java/com/sannorem/app/ui/map/CoverageMapScreen.kt - Map state → Map UI state: updates
app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt - Map state → Barangay repository: loads barangays
app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt - Map state → Branch repository: loads branches
app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt - Map state → Geographic calculations: calculates distances
app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt - Map state → Coverage lookup: looks up coverage
app/src/main/java/com/sannorem/app/ui/map/CoverageMapViewModel.kt - Coverage lookup → Branch repository: reads branches
app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt - Coverage lookup → Geographic calculations: uses geography
app/src/main/java/com/sannorem/app/domain/usecase/FindCoveringBranchesUseCase.kt - Asset barangays → Barangay model: creates records
app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt - Asset branches → Branch model: creates records
app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt - Branch repository → Asset branches: implemented by
app/src/main/java/com/sannorem/app/data/AssetBranchRepository.kt - Barangay repository → Asset barangays: implemented by
app/src/main/java/com/sannorem/app/data/AssetBarangayRepository.kt