# salesreesk/2106_spartanpath_sales_valdez architecture

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

- Interactive diagram: https://gitdiagram.com/salesreesk/2106_spartanpath_sales_valdez
- Repository: https://github.com/salesreesk/2106_spartanpath_sales_valdez

## Overview

SpartanPath is an Android campus wayfinding and facilities-management app. Visitors and campus users explore the offline map and request routes; authenticated users can search assets or submit maintenance incidents, while role-specific staff manage tickets. The architecture separates UI, view models, domain/navigation, repositories, and Firebase-backed data. The README documents these capabilities and their relationships; application source excerpts were not provided, so links below reflect documented behavior rather than inspected call sites.

Main entry points: [`System/app/src/main/java/com/example/araspoint_map/frontend/activity/MapActivity.kt`](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/MapActivity.kt) (Map screen), [`System/app/src/main/java/com/example/araspoint_map/frontend/activity/ReportFragment.kt`](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/ReportFragment.kt) (Reports and tickets), [`System/app/src/main/java/com/example/araspoint_map/backend/navigation/CampusNavigationEngine.kt`](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/navigation/CampusNavigationEngine.kt) (A* route engine), [`System/app/src/main/java/com/example/araspoint_map/backend/repository/AssetRepository.kt`](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/AssetRepository.kt) (Asset data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Android presentation"]
  node_map_ui["Map screen<br/>[MapActivity.kt]"]
  node_directions_ui["Turn guidance"]
  node_auth_ui["Sign-in screens<br/>[LoginActivity.kt]"]
  node_auth_vm["Authentication state<br/>[AuthViewModel.kt]"]
  node_asset_ui["Inventory screens"]
  node_asset_vm["Asset state<br/>[AssetViewModel.kt]"]
  node_maintenance_ui["Reports and tickets<br/>[ReportFragment.kt]"]
  node_maintenance_vm["Ticket state"]
  node_user_admin["User management"]
  node_user_vm["User state<br/>[UserViewModel.kt]"]
end

subgraph group_navigation["Campus navigation"]
  node_map_web["Leaflet map<br/>[campus_map.html]"]
  node_kml["KML parser<br/>[KmlParser.kt]"]
  node_route_engine["A* route engine"]
  node_geo_models["Spatial models<br/>[GeoNode.kt]"]
end

subgraph group_facilities["Facilities workflows"]
  node_asset_service["Asset operations<br/>[AssetService.kt]"]
  node_asset_model["Asset records<br/>[Asset.kt]"]
  node_maintenance_service["Ticket operations"]
  node_ticket_model["Maintenance records"]
  node_user_service["User operations<br/>[UserService.kt]"]
end

subgraph group_backend["Backend services"]
  node_auth_repo["Authentication access<br/>[AuthRepository.kt]"]
  node_asset_repo["Asset data access<br/>[AssetRepository.kt]"]
  node_maintenance_repo["Ticket data access"]
  node_user_repo["User data access<br/>[UserRepository.kt]"]
end

node_visitor(("Campus visitor"))
node_campus_user(("Campus user"))
node_staff(("Admin or staff"))
node_firestore[("Cloud Firestore")]
node_firebase_auth["Firebase Auth"]
node_cloudinary["Cloudinary media"]

node_visitor -->|"explores map"| node_map_ui
node_campus_user -->|"requests route"| node_map_ui
node_map_ui -->|"shows map"| node_map_web
node_map_web -->|"uses map data"| node_kml
node_kml -->|"parses graph for"| node_route_engine
node_route_engine -->|"uses spatial nodes"| node_geo_models
node_map_ui -->|"requests route"| node_route_engine
node_route_engine -->|"produces guidance"| node_directions_ui
node_campus_user -->|"signs in"| node_auth_ui
node_auth_ui -->|"submits credentials"| node_auth_vm
node_auth_vm -->|"delegates auth"| node_auth_repo
node_auth_repo -->|"authenticates with"| node_firebase_auth
node_campus_user -->|"searches inventory"| node_asset_ui
node_asset_ui -->|"requests assets"| node_asset_vm
node_asset_vm -->|"uses operations"| node_asset_service
node_asset_service -->|"accesses data"| node_asset_repo
node_asset_repo -->|"reads and writes"| node_firestore
node_asset_repo -->|"maps asset records"| node_asset_model
node_campus_user -->|"reports incident"| node_maintenance_ui
node_staff -->|"manages tickets"| node_maintenance_ui
node_maintenance_ui -->|"submits ticket action"| node_maintenance_vm
node_maintenance_vm -->|"uses operations"| node_maintenance_service
node_maintenance_service -->|"accesses data"| node_maintenance_repo
node_maintenance_repo -->|"reads and writes"| node_firestore
node_maintenance_repo -->|"stores ticket records"| node_ticket_model
node_maintenance_ui -->|"uploads evidence"| node_cloudinary
node_staff -->|"manages roles"| node_user_admin
node_user_admin -->|"requests user changes"| node_user_vm
node_user_vm -->|"uses operations"| node_user_service
node_user_service -->|"accesses data"| node_user_repo
node_user_repo -->|"reads and writes"| node_firestore

click node_map_ui "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/MapActivity.kt"
click node_map_web "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/assets/campus_map.html"
click node_kml "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/navigation/KmlParser.kt"
click node_route_engine "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/navigation/CampusNavigationEngine.kt"
click node_geo_models "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/model/GeoNode.kt"
click node_directions_ui "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/DirectionStepsAdapter.kt"
click node_auth_ui "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/LoginActivity.kt"
click node_auth_vm "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/AuthViewModel.kt"
click node_auth_repo "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/AuthRepository.kt"
click node_asset_ui "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/InventoryFragment.kt"
click node_asset_vm "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/AssetViewModel.kt"
click node_asset_service "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/service/AssetService.kt"
click node_asset_repo "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/AssetRepository.kt"
click node_asset_model "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/model/Asset.kt"
click node_maintenance_ui "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/ReportFragment.kt"
click node_maintenance_vm "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/MaintenanceViewModel.kt"
click node_maintenance_service "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/service/MaintenanceService.kt"
click node_maintenance_repo "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/MaintenanceRepository.kt"
click node_ticket_model "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/model/MaintenanceRecord.kt"
click node_user_admin "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/UserManagementFragment.kt"
click node_user_vm "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/UserViewModel.kt"
click node_user_service "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/service/UserService.kt"
click node_user_repo "https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/UserRepository.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_map_ui,node_directions_ui,node_auth_ui,node_auth_vm,node_asset_ui,node_asset_vm,node_maintenance_ui,node_maintenance_vm,node_user_admin,node_user_vm,node_campus_user toneBlue
class node_map_web,node_kml,node_route_engine,node_geo_models,node_firestore toneAmber
class node_asset_service,node_asset_model,node_maintenance_service,node_ticket_model,node_user_service toneMint
class node_auth_repo,node_asset_repo,node_maintenance_repo,node_user_repo toneRose
class node_visitor,node_staff,node_firebase_auth,node_cloudinary toneIndigo
```

## Components

### Android presentation

- [Map screen](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/MapActivity.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/activity/MapActivity.kt`
- [Turn guidance](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/DirectionStepsAdapter.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/activity/DirectionStepsAdapter.kt`
- [Sign-in screens](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/LoginActivity.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/activity/LoginActivity.kt`
- [Authentication state](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/AuthViewModel.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/AuthViewModel.kt`
- [Inventory screens](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/InventoryFragment.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/activity/InventoryFragment.kt`
- [Asset state](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/AssetViewModel.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/AssetViewModel.kt`
- [Reports and tickets](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/ReportFragment.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/activity/ReportFragment.kt`
- [Ticket state](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/MaintenanceViewModel.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/MaintenanceViewModel.kt`
- [User management](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/activity/UserManagementFragment.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/activity/UserManagementFragment.kt`
- [User state](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/UserViewModel.kt): `System/app/src/main/java/com/example/araspoint_map/frontend/viewModel/UserViewModel.kt`

### Campus navigation

- [Leaflet map](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/assets/campus_map.html): `System/app/src/main/assets/campus_map.html`
- [KML parser](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/navigation/KmlParser.kt): `System/app/src/main/java/com/example/araspoint_map/backend/navigation/KmlParser.kt`
- [A* route engine](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/navigation/CampusNavigationEngine.kt): `System/app/src/main/java/com/example/araspoint_map/backend/navigation/CampusNavigationEngine.kt`
- [Spatial models](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/model/GeoNode.kt): `System/app/src/main/java/com/example/araspoint_map/backend/model/GeoNode.kt`

### Facilities workflows

- [Asset operations](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/service/AssetService.kt): `System/app/src/main/java/com/example/araspoint_map/backend/service/AssetService.kt`
- [Asset records](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/model/Asset.kt): `System/app/src/main/java/com/example/araspoint_map/backend/model/Asset.kt`
- [Ticket operations](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/service/MaintenanceService.kt): `System/app/src/main/java/com/example/araspoint_map/backend/service/MaintenanceService.kt`
- [Maintenance records](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/model/MaintenanceRecord.kt): `System/app/src/main/java/com/example/araspoint_map/backend/model/MaintenanceRecord.kt`
- [User operations](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/service/UserService.kt): `System/app/src/main/java/com/example/araspoint_map/backend/service/UserService.kt`

### Backend services

- [Authentication access](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/AuthRepository.kt): `System/app/src/main/java/com/example/araspoint_map/backend/repository/AuthRepository.kt`
- [Asset data access](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/AssetRepository.kt): `System/app/src/main/java/com/example/araspoint_map/backend/repository/AssetRepository.kt`
- [Ticket data access](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/MaintenanceRepository.kt): `System/app/src/main/java/com/example/araspoint_map/backend/repository/MaintenanceRepository.kt`
- [User data access](https://github.com/salesreesk/2106_spartanpath_sales_valdez/blob/main/System/app/src/main/java/com/example/araspoint_map/backend/repository/UserRepository.kt): `System/app/src/main/java/com/example/araspoint_map/backend/repository/UserRepository.kt`

### Other components

- **Campus visitor**
- **Campus user**
- **Admin or staff**
- **Cloud Firestore**
- **Firebase Auth**
- **Cloudinary media**

## Connections

- Campus visitor → Map screen: explores map (evidence: `README.md`)
- Campus user → Map screen: requests route (evidence: `README.md`)
- Map screen → Leaflet map: shows map (evidence: `README.md`)
- Leaflet map → KML parser: uses map data (evidence: `README.md`)
- KML parser → A* route engine: parses graph for (evidence: `README.md`)
- A* route engine → Spatial models: uses spatial nodes (evidence: `README.md`)
- Map screen → A* route engine: requests route (evidence: `README.md`)
- A* route engine → Turn guidance: produces guidance (evidence: `README.md`)
- Campus user → Sign-in screens: signs in (evidence: `README.md`)
- Sign-in screens → Authentication state: submits credentials (evidence: `README.md`)
- Authentication state → Authentication access: delegates auth (evidence: `README.md`)
- Authentication access → Firebase Auth: authenticates with (evidence: `README.md`)
- Campus user → Inventory screens: searches inventory (evidence: `README.md`)
- Inventory screens → Asset state: requests assets (evidence: `README.md`)
- Asset state → Asset operations: uses operations (evidence: `README.md`)
- Asset operations → Asset data access: accesses data (evidence: `README.md`)
- Asset data access → Cloud Firestore: reads and writes (evidence: `README.md`)
- Asset data access → Asset records: maps asset records (evidence: `README.md`)
- Campus user → Reports and tickets: reports incident (evidence: `README.md`)
- Admin or staff → Reports and tickets: manages tickets (evidence: `README.md`)
- Reports and tickets → Ticket state: submits ticket action (evidence: `README.md`)
- Ticket state → Ticket operations: uses operations (evidence: `README.md`)
- Ticket operations → Ticket data access: accesses data (evidence: `README.md`)
- Ticket data access → Cloud Firestore: reads and writes (evidence: `README.md`)
- Ticket data access → Maintenance records: stores ticket records (evidence: `README.md`)
- Reports and tickets → Cloudinary media: uploads evidence (evidence: `README.md`)
- Admin or staff → User management: manages roles (evidence: `README.md`)
- User management → User state: requests user changes (evidence: `README.md`)
- User state → User operations: uses operations (evidence: `README.md`)
- User operations → User data access: accesses data (evidence: `README.md`)
- User data access → Cloud Firestore: reads and writes (evidence: `README.md`)
