# andy-2214/appsitp architecture

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

- Interactive diagram: https://gitdiagram.com/andy-2214/appsitp
- Repository: https://github.com/andy-2214/appsitp

## Overview

AppSITP is an Android public-transit route-planning app for Arequipa. The apparent main journey is authentication, opening the map, searching for routes, and viewing route guidance; the tree also shows AI recommendations, geocoding, comments, profile, history, and favorites. The README provides no capability details, so those branches are identified from module names and limited source evidence. Several view-model and integration connections are therefore omitted or marked unverified rather than inferred as confirmed calls.

Main entry points: [`app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt`](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt) (Map and guidance), [`app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt`](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt) (Route repository), [`app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaViewModel.kt`](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaViewModel.kt) (Search state), [`app/src/main/java/com/sitp/arequipa/MainActivity.kt`](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/MainActivity.kt) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_activity["App entry<br/>[MainActivity.kt]"]
end

subgraph group_routes["Route discovery"]
  node_map["Map and guidance<br/>[MapScreen.kt]"]
  node_search["Search UI<br/>[BusquedaSheet.kt]"]
  node_searchvm["Search state"]
  node_routeusecase["Route search"]
  node_routeentity["Route model<br/>[Ruta.kt]"]
  node_ai["AI recommendations<br/>[GroqAISource.kt]"]
  node_geocoding["Geocoding<br/>[GeocodingSource.kt]"]
end

subgraph group_account["Account and profile"]
  node_auth_ui["Sign-in screens<br/>[LoginScreen.kt]"]
  node_auth_vm["Authentication state<br/>[AuthViewModel.kt]"]
  node_auth_usecases["Auth actions<br/>[LoginUseCase.kt]"]
  node_auth_repo["Auth repository"]
  node_profile["User profile<br/>[PerfilScreen.kt]"]
end

subgraph group_engagement["History and feedback"]
  node_history_ui["History and favorites<br/>[HistorialScreen.kt]"]
  node_history_vm["History state"]
  node_history_repo["History repository"]
  node_comments["Route comments"]
  node_comment_vm["Comment state"]
end

subgraph group_data["Data and integrations"]
  node_route_repo["Route repository"]
  node_route_remote["Route source"]
  node_database[("Route cache<br/>[AppDatabase.kt]")]
  node_route_entities["Route records<br/>[RutaEntity.kt]"]
  node_auth_source["Firebase auth"]
  node_history_source["History source"]
end

node_user(("Transit rider"))
node_firebase{{"Firebase services"}}

node_user -->|"opens"| node_activity
node_activity -->|"routes to"| node_auth_ui
node_activity -->|"routes to"| node_map
node_auth_ui -.->|"uses"| node_auth_vm
node_auth_vm -->|"invokes"| node_auth_usecases
node_auth_usecases -.->|"delegates"| node_auth_repo
node_auth_repo -->|"calls"| node_auth_source
node_auth_source -->|"uses"| node_firebase
node_map -->|"shows"| node_search
node_search -->|"uses"| node_searchvm
node_searchvm -.->|"invokes"| node_routeusecase
node_routeusecase -.->|"delegates"| node_route_repo
node_map -.->|"configures"| node_route_repo
node_route_repo -->|"downloads routes"| node_route_remote
node_route_repo -->|"reads and writes"| node_database
node_database -->|"stores"| node_route_entities
node_route_repo -->|"maps to"| node_routeentity
node_map -->|"shows"| node_comments
node_map -->|"shows"| node_history_ui
node_map -->|"shows"| node_profile
node_comments -->|"loads comments"| node_comment_vm
node_history_ui -->|"uses"| node_history_vm
node_history_vm -.->|"via use cases"| node_history_repo
node_history_repo -->|"calls"| node_history_source
node_history_source -.->|"uses"| node_firebase
node_searchvm -.->|"requests recommendations"| node_ai
node_searchvm -.->|"resolves places"| node_geocoding

click node_activity "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/MainActivity.kt"
click node_map "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt"
click node_search "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaSheet.kt"
click node_searchvm "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaViewModel.kt"
click node_routeusecase "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/domain/usecase/BuscarRutaUseCase.kt"
click node_routeentity "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/domain/model/Ruta.kt"
click node_route_repo "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt"
click node_route_remote "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/FirestoreRouteSource.kt"
click node_database "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/local/db/AppDatabase.kt"
click node_route_entities "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/local/entity/RutaEntity.kt"
click node_ai "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/GroqAISource.kt"
click node_geocoding "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/GeocodingSource.kt"
click node_auth_ui "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/auth/LoginScreen.kt"
click node_auth_vm "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/auth/AuthViewModel.kt"
click node_auth_usecases "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/domain/usecase/LoginUseCase.kt"
click node_auth_repo "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/repository/AuthRepositoryImpl.kt"
click node_auth_source "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/FirebaseAuthSource.kt"
click node_history_ui "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/historial/HistorialScreen.kt"
click node_history_vm "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/historial/HistorialViewModel.kt"
click node_history_repo "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/repository/HistorialRepositoryImpl.kt"
click node_history_source "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/FirestoreHistorialSource.kt"
click node_comments "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/comentarios/ComentariosSheet.kt"
click node_comment_vm "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/comentarios/ComentarioViewModel.kt"
click node_profile "https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/perfil/PerfilScreen.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 toneBlue
class node_map,node_search,node_searchvm,node_routeusecase,node_routeentity,node_ai,node_geocoding toneAmber
class node_auth_ui,node_auth_vm,node_auth_usecases,node_auth_repo,node_profile toneMint
class node_history_ui,node_history_vm,node_history_repo,node_comments,node_comment_vm toneRose
class node_route_repo,node_route_remote,node_database,node_route_entities,node_auth_source,node_history_source,node_user,node_firebase toneIndigo
```

## Components

### App and navigation

- [App entry](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/MainActivity.kt): `app/src/main/java/com/sitp/arequipa/MainActivity.kt`

### Route discovery

- [Map and guidance](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt): `app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt`
- [Search UI](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaSheet.kt): `app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaSheet.kt`
- [Search state](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaViewModel.kt): `app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaViewModel.kt`
- [Route search](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/domain/usecase/BuscarRutaUseCase.kt): `app/src/main/java/com/sitp/arequipa/domain/usecase/BuscarRutaUseCase.kt`
- [Route model](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/domain/model/Ruta.kt): `app/src/main/java/com/sitp/arequipa/domain/model/Ruta.kt`
- [AI recommendations](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/GroqAISource.kt): `app/src/main/java/com/sitp/arequipa/data/remote/GroqAISource.kt`
- [Geocoding](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/GeocodingSource.kt): `app/src/main/java/com/sitp/arequipa/data/remote/GeocodingSource.kt`

### Account and profile

- [Sign-in screens](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/auth/LoginScreen.kt): `app/src/main/java/com/sitp/arequipa/presentation/auth/LoginScreen.kt`
- [Authentication state](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/auth/AuthViewModel.kt): `app/src/main/java/com/sitp/arequipa/presentation/auth/AuthViewModel.kt`
- [Auth actions](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/domain/usecase/LoginUseCase.kt): `app/src/main/java/com/sitp/arequipa/domain/usecase/LoginUseCase.kt`
- [Auth repository](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/repository/AuthRepositoryImpl.kt): `app/src/main/java/com/sitp/arequipa/data/repository/AuthRepositoryImpl.kt`
- [User profile](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/perfil/PerfilScreen.kt): `app/src/main/java/com/sitp/arequipa/presentation/perfil/PerfilScreen.kt`

### History and feedback

- [History and favorites](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/historial/HistorialScreen.kt): `app/src/main/java/com/sitp/arequipa/presentation/historial/HistorialScreen.kt`
- [History state](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/historial/HistorialViewModel.kt): `app/src/main/java/com/sitp/arequipa/presentation/historial/HistorialViewModel.kt`
- [History repository](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/repository/HistorialRepositoryImpl.kt): `app/src/main/java/com/sitp/arequipa/data/repository/HistorialRepositoryImpl.kt`
- [Route comments](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/comentarios/ComentariosSheet.kt): `app/src/main/java/com/sitp/arequipa/presentation/comentarios/ComentariosSheet.kt`
- [Comment state](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/presentation/comentarios/ComentarioViewModel.kt): `app/src/main/java/com/sitp/arequipa/presentation/comentarios/ComentarioViewModel.kt`

### Data and integrations

- [Route repository](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt): `app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt`
- [Route source](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/FirestoreRouteSource.kt): `app/src/main/java/com/sitp/arequipa/data/remote/FirestoreRouteSource.kt`
- [Route cache](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/local/db/AppDatabase.kt): `app/src/main/java/com/sitp/arequipa/data/local/db/AppDatabase.kt`
- [Route records](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/local/entity/RutaEntity.kt): `app/src/main/java/com/sitp/arequipa/data/local/entity/RutaEntity.kt`
- [Firebase auth](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/FirebaseAuthSource.kt): `app/src/main/java/com/sitp/arequipa/data/remote/FirebaseAuthSource.kt`
- [History source](https://github.com/andy-2214/appsitp/blob/main/app/src/main/java/com/sitp/arequipa/data/remote/FirestoreHistorialSource.kt): `app/src/main/java/com/sitp/arequipa/data/remote/FirestoreHistorialSource.kt`

### Other components

- **Transit rider**
- **Firebase services**

## Connections

- Transit rider → App entry: opens
- App entry → Sign-in screens: routes to (evidence: `app/src/main/java/com/sitp/arequipa/MainActivity.kt`)
- App entry → Map and guidance: routes to (evidence: `app/src/main/java/com/sitp/arequipa/MainActivity.kt`)
- Sign-in screens → Authentication state: uses
- Authentication state → Auth actions: invokes (evidence: `app/src/main/java/com/sitp/arequipa/presentation/auth/AuthViewModel.kt`)
- Auth actions → Auth repository: delegates
- Auth repository → Firebase auth: calls (evidence: `app/src/main/java/com/sitp/arequipa/data/repository/AuthRepositoryImpl.kt`)
- Firebase auth → Firebase services: uses (evidence: `app/src/main/java/com/sitp/arequipa/data/remote/FirebaseAuthSource.kt`)
- Map and guidance → Search UI: shows (evidence: `app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt`)
- Search UI → Search state: uses (evidence: `app/src/main/java/com/sitp/arequipa/presentation/busqueda/BusquedaSheet.kt`)
- Search state → Route search: invokes
- Route search → Route repository: delegates
- Map and guidance → Route repository: configures
- Route repository → Route source: downloads routes (evidence: `app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt`)
- Route repository → Route cache: reads and writes (evidence: `app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt`)
- Route cache → Route records: stores (evidence: `app/src/main/java/com/sitp/arequipa/data/local/db/AppDatabase.kt`)
- Route repository → Route model: maps to (evidence: `app/src/main/java/com/sitp/arequipa/data/repository/RouteRepositoryImpl.kt`)
- Map and guidance → Route comments: shows (evidence: `app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt`)
- Map and guidance → History and favorites: shows (evidence: `app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt`)
- Map and guidance → User profile: shows (evidence: `app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt`)
- Route comments → Comment state: loads comments (evidence: `app/src/main/java/com/sitp/arequipa/presentation/map/MapScreen.kt`)
- History and favorites → History state: uses (evidence: `app/src/main/java/com/sitp/arequipa/presentation/historial/HistorialScreen.kt`)
- History state → History repository: via use cases
- History repository → History source: calls (evidence: `app/src/main/java/com/sitp/arequipa/data/repository/HistorialRepositoryImpl.kt`)
- History source → Firebase services: uses
- Search state → AI recommendations: requests recommendations
- Search state → Geocoding: resolves places
