# marcolb123/ecorouteplanner architecture

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

- Interactive diagram: https://gitdiagram.com/marcolb123/ecorouteplanner
- Repository: https://github.com/marcolb123/ecorouteplanner

## Overview

EcoRoute Planner is a sustainable-trip planning and tracking application. Users authenticate, plan routes with map services, compare transport emissions, save journeys, monitor impact and points, and redeem rewards; admins manage users, roles, rewards, and aggregate metrics. The React pages call a shared API client and Spring REST controllers handle backend operations against SQLite. The README documents capabilities and endpoint relationships; source-index references support several controller-to-manager links, but unsampled implementations are not asserted in detail.

Main entry points: [`src/services/api.js`](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/services/api.js) (API client), [`src/App.js`](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/App.js) (Route and access), [`backend/src/main/java/com/ecoroute/database`](https://github.com/marcolb123/ecorouteplanner/tree/Main/backend/src/main/java/com/ecoroute/database) (SQLite managers), [`src/pages/RoutePlannerPage.js`](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/RoutePlannerPage.js) (Route planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_app["Route and access<br/>[App.js]"]
  node_login["Authentication<br/>[LogInPage.js]"]
  node_rewards["Rewards and purchases<br/>[RewardsPage.js]"]
  node_adminui["Admin dashboard"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_trip["Trip planning"]
  node_planner["Route planner"]
  node_map["Map and routes<br/>[MapView.js]"]
  node_vehicles["Vehicle comparison"]
  node_journeys["Trip history<br/>[TripHistoryPage.js]"]
  node_impact["Impact statistics<br/>[StatisticsPage.js]"]
end

subgraph group_backend["Backend services"]
  node_authapi["Auth and user endpoints"]
  node_journeyapi["Journey endpoints"]
  node_statsapi["Statistics endpoints"]
  node_rewardapi["Rewards endpoints"]
  node_adminapi["Admin endpoints"]
  node_vehicleapi["Vehicle endpoints"]
  node_userservice["User logic<br/>[UserService.java]"]
end

subgraph group_data["Persistence"]
  node_managers["SQLite managers"]
  node_entities["Domain entities"]
  node_sqlite[("SQLite database")]
end

node_traveler(("Traveler"))
node_google["Google Maps APIs"]

node_traveler -->|"opens"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_planner
node_app -->|"routes to"| node_vehicles
node_app -->|"routes to"| node_journeys
node_app -->|"routes to"| node_impact
node_app -->|"routes to"| node_rewards
node_app -->|"guards"| node_adminui
node_planner -->|"renders"| node_map
node_planner -->|"uses"| node_api
node_map -->|"requests data"| node_api
node_vehicles -->|"requests data"| node_api
node_journeys -.->|"requests data"| node_api
node_impact -.->|"requests data"| node_api
node_rewards -.->|"requests data"| node_api
node_adminui -.->|"requests data"| node_api
node_api -.->|"HTTP calls"| node_authapi
node_api -.->|"HTTP calls"| node_journeyapi
node_api -.->|"HTTP calls"| node_statsapi
node_api -.->|"HTTP calls"| node_rewardapi
node_api -.->|"HTTP calls"| node_adminapi
node_api -.->|"HTTP calls"| node_vehicleapi
node_authapi -->|"delegates"| node_userservice
node_userservice -->|"reads and writes"| node_managers
node_journeyapi -->|"accesses journeys"| node_managers
node_journeyapi -->|"uses user logic"| node_userservice
node_statsapi -->|"reads journeys"| node_managers
node_rewardapi -->|"manages rewards"| node_managers
node_adminapi -->|"manages users"| node_managers
node_vehicleapi -.->|"manages vehicles"| node_managers
node_managers -->|"queries"| node_sqlite
node_managers -->|"maps records"| node_entities
node_map -.->|"uses mapping APIs"| node_google

click node_app "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/App.js"
click node_login "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/LogInPage.js"
click node_planner "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/RoutePlannerPage.js"
click node_map "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/components/MapView.js"
click node_vehicles "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/VehicleComparisonPage.js"
click node_journeys "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/TripHistoryPage.js"
click node_impact "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/StatisticsPage.js"
click node_rewards "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/RewardsPage.js"
click node_adminui "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/AdminDashboardPage.js"
click node_api "https://github.com/marcolb123/ecorouteplanner/blob/Main/src/services/api.js"
click node_authapi "https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/AuthController.java"
click node_journeyapi "https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/JourneyController.java"
click node_statsapi "https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/StatisticsController.java"
click node_rewardapi "https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/StaffRewardsController.java"
click node_adminapi "https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/AdminController.java"
click node_vehicleapi "https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/VehicleController.java"
click node_userservice "https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/service/UserService.java"
click node_managers "https://github.com/marcolb123/ecorouteplanner/tree/Main/backend/src/main/java/com/ecoroute/database"
click node_entities "https://github.com/marcolb123/ecorouteplanner/tree/Main/backend/src/main/java/com/ecoroute/model"

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,node_login,node_rewards,node_adminui,node_api toneBlue
class node_planner,node_map,node_vehicles,node_journeys,node_impact toneAmber
class node_authapi,node_journeyapi,node_statsapi,node_rewardapi,node_adminapi,node_vehicleapi,node_userservice,node_google toneMint
class node_managers,node_entities,node_sqlite toneRose
class node_traveler toneIndigo
```

## Components

### Web experience

- [Route and access](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/App.js): `src/App.js`
- [Authentication](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/LogInPage.js): `src/pages/LogInPage.js`
- [Rewards and purchases](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/RewardsPage.js): `src/pages/RewardsPage.js`
- [Admin dashboard](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/AdminDashboardPage.js): `src/pages/AdminDashboardPage.js`
- [API client](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/services/api.js): `src/services/api.js`

### Trip planning

- [Route planner](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/RoutePlannerPage.js): `src/pages/RoutePlannerPage.js`
- [Map and routes](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/components/MapView.js): `src/components/MapView.js`
- [Vehicle comparison](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/VehicleComparisonPage.js): `src/pages/VehicleComparisonPage.js`
- [Trip history](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/TripHistoryPage.js): `src/pages/TripHistoryPage.js`
- [Impact statistics](https://github.com/marcolb123/ecorouteplanner/blob/Main/src/pages/StatisticsPage.js): `src/pages/StatisticsPage.js`

### Backend services

- [Auth and user endpoints](https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/AuthController.java): `backend/src/main/java/com/ecoroute/controller/AuthController.java`
- [Journey endpoints](https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/JourneyController.java): `backend/src/main/java/com/ecoroute/controller/JourneyController.java`
- [Statistics endpoints](https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/StatisticsController.java): `backend/src/main/java/com/ecoroute/controller/StatisticsController.java`
- [Rewards endpoints](https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/StaffRewardsController.java): `backend/src/main/java/com/ecoroute/controller/StaffRewardsController.java`
- [Admin endpoints](https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/AdminController.java): `backend/src/main/java/com/ecoroute/controller/AdminController.java`
- [Vehicle endpoints](https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/controller/VehicleController.java): `backend/src/main/java/com/ecoroute/controller/VehicleController.java`
- [User logic](https://github.com/marcolb123/ecorouteplanner/blob/Main/backend/src/main/java/com/ecoroute/service/UserService.java): `backend/src/main/java/com/ecoroute/service/UserService.java`

### Persistence

- [SQLite managers](https://github.com/marcolb123/ecorouteplanner/tree/Main/backend/src/main/java/com/ecoroute/database): `backend/src/main/java/com/ecoroute/database`
- [Domain entities](https://github.com/marcolb123/ecorouteplanner/tree/Main/backend/src/main/java/com/ecoroute/model): `backend/src/main/java/com/ecoroute/model`
- **SQLite database**

### Other components

- **Traveler**
- **Google Maps APIs**

## Connections

- Traveler → Route and access: opens (evidence: `src/App.js`)
- Route and access → Authentication: routes to (evidence: `src/App.js`)
- Route and access → Route planner: routes to (evidence: `src/App.js`)
- Route and access → Vehicle comparison: routes to (evidence: `src/App.js`)
- Route and access → Trip history: routes to (evidence: `src/App.js`)
- Route and access → Impact statistics: routes to (evidence: `src/App.js`)
- Route and access → Rewards and purchases: routes to (evidence: `src/App.js`)
- Route and access → Admin dashboard: guards (evidence: `src/App.js`)
- Route planner → Map and routes: renders (evidence: `src/pages/RoutePlannerPage.js`)
- Route planner → API client: uses (evidence: `src/pages/RoutePlannerPage.js`)
- Map and routes → API client: requests data (evidence: `src/components/MapView.js`)
- Vehicle comparison → API client: requests data (evidence: `src/pages/VehicleComparisonPage.js`)
- Trip history → API client: requests data (evidence: `src/pages/TripHistoryPage.js`)
- Impact statistics → API client: requests data (evidence: `src/pages/StatisticsPage.js`)
- Rewards and purchases → API client: requests data (evidence: `src/pages/RewardsPage.js`)
- Admin dashboard → API client: requests data (evidence: `src/pages/AdminDashboardPage.js`)
- API client → Auth and user endpoints: HTTP calls
- API client → Journey endpoints: HTTP calls
- API client → Statistics endpoints: HTTP calls
- API client → Rewards endpoints: HTTP calls
- API client → Admin endpoints: HTTP calls
- API client → Vehicle endpoints: HTTP calls
- Auth and user endpoints → User logic: delegates (evidence: `backend/src/main/java/com/ecoroute/controller/AuthController.java`)
- User logic → SQLite managers: reads and writes (evidence: `backend/src/main/java/com/ecoroute/service/UserService.java`)
- Journey endpoints → SQLite managers: accesses journeys (evidence: `backend/src/main/java/com/ecoroute/controller/JourneyController.java`)
- Journey endpoints → User logic: uses user logic (evidence: `backend/src/main/java/com/ecoroute/controller/JourneyController.java`)
- Statistics endpoints → SQLite managers: reads journeys (evidence: `backend/src/main/java/com/ecoroute/controller/StatisticsController.java`)
- Rewards endpoints → SQLite managers: manages rewards (evidence: `backend/src/main/java/com/ecoroute/controller/StaffRewardsController.java`)
- Admin endpoints → SQLite managers: manages users (evidence: `backend/src/main/java/com/ecoroute/controller/AdminController.java`)
- Vehicle endpoints → SQLite managers: manages vehicles
- SQLite managers → SQLite database: queries (evidence: `backend/src/main/java/com/ecoroute/database/DatabaseManager.java`)
- SQLite managers → Domain entities: maps records (evidence: `backend/src/main/java/com/ecoroute/database/JourneyDatabaseManager.java`)
- Map and routes → Google Maps APIs: uses mapping APIs
