# kirkemneo15/routa architecture

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

- Interactive diagram: https://gitdiagram.com/kirkemneo15/routa
- Repository: https://github.com/kirkemneo15/routa

## Overview

Routa is a transit-information application with a React route entry point and a Spring REST backend. Its visible domain capabilities include route and stop discovery, nearby stops, transport modes, alerts, accounts, favorites, user reports, and administration. The sampled controllers delegate to service classes, but those classes and most frontend pages are absent from the supplied tree; the README names no workflow details. Accordingly, the graph preserves documented-in-code capabilities without guessing calls between the frontend, backend, and persistence.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app_routes["Page routing<br/>[App.tsx]"]
end

subgraph group_transit["Transit information"]
  node_routes_api["Route endpoints"]
  node_stops_api["Stop endpoints"]
  node_transport_api["Transport endpoints"]
  node_alerts_api["Alert endpoints"]
  node_db_migrations[("Database migrations")]
  node_city_boundary["City boundary data"]
end

subgraph group_accounts["Accounts and safety"]
  node_favorites_api["Saved routes"]
  node_auth_api["Authentication"]
  node_reports_api["User reports"]
  node_health_api["Health check"]
end

subgraph group_admin["Administration"]
  node_admin_api["Admin operations"]
  node_stats_api["Statistics"]
  node_security["Access control"]
  node_demo_seed["Demo accounts<br/>[DataSeeder.java]"]
end

node_visitor(("Visitor"))
node_user(("Signed-in user"))
node_admin_actor(("Administrator"))

click node_app_routes "https://github.com/kirkemneo15/routa/blob/main/frontend/src/App.tsx"
click node_routes_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/RouteController.java"
click node_stops_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/StopController.java"
click node_transport_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/TransportationController.java"
click node_alerts_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/AlertController.java"
click node_favorites_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/FavoriteController.java"
click node_auth_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/AuthController.java"
click node_reports_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/ReportController.java"
click node_health_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/HealthController.java"
click node_admin_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/AdminController.java"
click node_stats_api "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/StatsController.java"
click node_security "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/config/SecurityConfig.java"
click node_demo_seed "https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/config/DataSeeder.java"
click node_db_migrations "https://github.com/kirkemneo15/routa/blob/main/database/migrations/001-remove-shuttle-and-train.sql"
click node_city_boundary "https://github.com/kirkemneo15/routa/blob/main/frontend/public/data/batangas-city-boundary.geojson"

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_app_routes,node_user toneBlue
class node_routes_api,node_stops_api,node_transport_api,node_alerts_api,node_db_migrations,node_city_boundary toneAmber
class node_favorites_api,node_auth_api,node_reports_api,node_health_api toneMint
class node_admin_api,node_stats_api,node_security,node_demo_seed toneRose
class node_visitor,node_admin_actor toneIndigo
```

## Components

### Web application

- [Page routing](https://github.com/kirkemneo15/routa/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Transit information

- [Route endpoints](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/RouteController.java): `backend/src/main/java/com/transithub/controller/RouteController.java`
- [Stop endpoints](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/StopController.java): `backend/src/main/java/com/transithub/controller/StopController.java`
- [Transport endpoints](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/TransportationController.java): `backend/src/main/java/com/transithub/controller/TransportationController.java`
- [Alert endpoints](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/AlertController.java): `backend/src/main/java/com/transithub/controller/AlertController.java`
- [Database migrations](https://github.com/kirkemneo15/routa/blob/main/database/migrations/001-remove-shuttle-and-train.sql): `database/migrations/001-remove-shuttle-and-train.sql`
- [City boundary data](https://github.com/kirkemneo15/routa/blob/main/frontend/public/data/batangas-city-boundary.geojson): `frontend/public/data/batangas-city-boundary.geojson`

### Accounts and safety

- [Saved routes](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/FavoriteController.java): `backend/src/main/java/com/transithub/controller/FavoriteController.java`
- [Authentication](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/AuthController.java): `backend/src/main/java/com/transithub/controller/AuthController.java`
- [User reports](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/ReportController.java): `backend/src/main/java/com/transithub/controller/ReportController.java`
- [Health check](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/HealthController.java): `backend/src/main/java/com/transithub/controller/HealthController.java`

### Administration

- [Admin operations](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/AdminController.java): `backend/src/main/java/com/transithub/controller/AdminController.java`
- [Statistics](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/controller/StatsController.java): `backend/src/main/java/com/transithub/controller/StatsController.java`
- [Access control](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/config/SecurityConfig.java): `backend/src/main/java/com/transithub/config/SecurityConfig.java`
- [Demo accounts](https://github.com/kirkemneo15/routa/blob/main/backend/src/main/java/com/transithub/config/DataSeeder.java): `backend/src/main/java/com/transithub/config/DataSeeder.java`

### Other components

- **Visitor**
- **Signed-in user**
- **Administrator**
