# qum11ch/apex architecture

> Architecture diagram of the GitHub repository qum11ch/apex, 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/qum11ch/apex
- Repository: https://github.com/qum11ch/apex

## Overview

Apex is an Android F1 companion: users browse current and historical race data, standings and driver/team statistics, and can use prediction, leaderboard and award features. The README names Firebase, Jolpica and OpenF1 as data services and describes offline access and notifications. The source excerpts contain no app runtime code, so subsystem paths are grounded in the tree; edges capture documented capabilities and integrations, not uninspected call chains. Firebase server-side prediction processing is explicitly outside this repository.

Main entry points: [`app/src/main/java/com/example/f1app/MainActivity.java`](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/MainActivity.java) (Apex app), [`app/src/main/java/com/example/f1app/userPredictionsActivity.java`](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/userPredictionsActivity.java) (User predictions), [`app/src/main/java/com/example/f1app/leaderboardActivity.java`](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/leaderboardActivity.java) (Leaderboard), [`app/src/main/java/com/example/f1app/awardsCollectionActivity.java`](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/awardsCollectionActivity.java) (Awards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_android["Apex app<br/>[MainActivity.java]"]
end

subgraph group_racing["F1 data and browsing"]
  node_schedule["Race schedule"]
  node_race["Race pages"]
  node_standings["Season standings"]
  node_team_standings["Team standings"]
  node_drivers["Driver profiles"]
  node_teams["Team profiles"]
  node_all_drivers["All drivers"]
  node_saved_races["Saved races"]
  node_archive["Past seasons<br/>[pastSeasons.java]"]
  node_champion["Title contenders"]
end

subgraph group_predictions["Predictions and community"]
  node_neuro["Qualifying forecast"]
  node_user_predictions["User predictions"]
  node_prediction_stats["Prediction stats"]
  node_leaderboard["Leaderboard"]
  node_public_profile["Public profiles"]
end

subgraph group_account["Account and engagement"]
  node_awards["Awards"]
  node_account["Account"]
  node_notifications["Race notifications"]
end

subgraph group_platform["Data integrations"]
  node_offline[("Offline cache")]
  node_firebase[("Firebase services")]
  node_jolpica["Jolpica API"]
  node_openf1["OpenF1 API"]
end

node_user(("F1 fan"))

node_user -->|"uses"| node_android
node_android -->|"offers"| node_schedule
node_android -->|"offers"| node_race
node_android -->|"offers"| node_standings
node_android -->|"offers"| node_team_standings
node_android -->|"offers"| node_drivers
node_android -->|"offers"| node_teams
node_android -->|"offers"| node_all_drivers
node_android -->|"offers"| node_saved_races
node_android -->|"offers"| node_archive
node_android -->|"offers"| node_champion
node_android -->|"offers"| node_neuro
node_android -->|"offers"| node_user_predictions
node_android -->|"offers"| node_prediction_stats
node_android -->|"offers"| node_leaderboard
node_android -->|"offers"| node_public_profile
node_android -->|"offers"| node_awards
node_android -->|"sends"| node_notifications
node_android -->|"serves cached data"| node_offline
node_android -->|"uses"| node_firebase
node_android -->|"fetches F1 data"| node_jolpica
node_android -->|"fetches F1 data"| node_openf1
node_android -->|"offers"| node_account
node_firebase -.->|"processes submissions"| node_user_predictions
node_firebase -.->|"provides ranking"| node_leaderboard
node_firebase -.->|"provides medals"| node_awards

click node_android "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/MainActivity.java"
click node_schedule "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/scheduleActivity.java"
click node_race "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/raceResultsActivity.java"
click node_standings "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/driversStandingsActivity.java"
click node_team_standings "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/teamsStandingsActivity.java"
click node_drivers "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/driverPageActivity.java"
click node_teams "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/teamPageActivity.java"
click node_all_drivers "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/allDriversActivity.java"
click node_saved_races "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/savedRacesRepository.java"
click node_archive "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/pastSeasons.java"
click node_champion "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/winnersWDCActivity.java"
click node_neuro "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/neuroPredictionActivity.java"
click node_user_predictions "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/userPredictionsActivity.java"
click node_prediction_stats "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/predictionStatsLoader.java"
click node_leaderboard "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/leaderboardActivity.java"
click node_public_profile "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/publicProfileActivity.java"
click node_awards "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/awardsCollectionActivity.java"
click node_account "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/accountPageActivity.java"
click node_notifications "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/NotifyReceiver.java"
click node_offline "https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/cachedJsonRequest.java"

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_android toneBlue
class node_schedule,node_race,node_standings,node_team_standings,node_drivers,node_teams,node_all_drivers,node_saved_races,node_archive,node_champion toneAmber
class node_neuro,node_user_predictions,node_prediction_stats,node_leaderboard,node_public_profile toneMint
class node_awards,node_account,node_notifications toneRose
class node_offline,node_firebase,node_jolpica,node_openf1,node_user toneIndigo
```

## Components

### Android app

- [Apex app](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/MainActivity.java): `app/src/main/java/com/example/f1app/MainActivity.java`

### F1 data and browsing

- [Race schedule](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/scheduleActivity.java): `app/src/main/java/com/example/f1app/scheduleActivity.java`
- [Race pages](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/raceResultsActivity.java): `app/src/main/java/com/example/f1app/raceResultsActivity.java`
- [Season standings](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/driversStandingsActivity.java): `app/src/main/java/com/example/f1app/driversStandingsActivity.java`
- [Team standings](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/teamsStandingsActivity.java): `app/src/main/java/com/example/f1app/teamsStandingsActivity.java`
- [Driver profiles](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/driverPageActivity.java): `app/src/main/java/com/example/f1app/driverPageActivity.java`
- [Team profiles](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/teamPageActivity.java): `app/src/main/java/com/example/f1app/teamPageActivity.java`
- [All drivers](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/allDriversActivity.java): `app/src/main/java/com/example/f1app/allDriversActivity.java`
- [Saved races](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/savedRacesRepository.java): `app/src/main/java/com/example/f1app/savedRacesRepository.java`
- [Past seasons](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/pastSeasons.java): `app/src/main/java/com/example/f1app/pastSeasons.java`
- [Title contenders](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/winnersWDCActivity.java): `app/src/main/java/com/example/f1app/winnersWDCActivity.java`

### Predictions and community

- [Qualifying forecast](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/neuroPredictionActivity.java): `app/src/main/java/com/example/f1app/neuroPredictionActivity.java`
- [User predictions](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/userPredictionsActivity.java): `app/src/main/java/com/example/f1app/userPredictionsActivity.java`
- [Prediction stats](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/predictionStatsLoader.java): `app/src/main/java/com/example/f1app/predictionStatsLoader.java`
- [Leaderboard](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/leaderboardActivity.java): `app/src/main/java/com/example/f1app/leaderboardActivity.java`
- [Public profiles](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/publicProfileActivity.java): `app/src/main/java/com/example/f1app/publicProfileActivity.java`

### Account and engagement

- [Awards](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/awardsCollectionActivity.java): `app/src/main/java/com/example/f1app/awardsCollectionActivity.java`
- [Account](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/accountPageActivity.java): `app/src/main/java/com/example/f1app/accountPageActivity.java`
- [Race notifications](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/NotifyReceiver.java): `app/src/main/java/com/example/f1app/NotifyReceiver.java`

### Data integrations

- [Offline cache](https://github.com/qum11ch/apex/blob/master/app/src/main/java/com/example/f1app/cachedJsonRequest.java): `app/src/main/java/com/example/f1app/cachedJsonRequest.java`
- **Firebase services**
- **Jolpica API**
- **OpenF1 API**

### Other components

- **F1 fan**

## Connections

- F1 fan → Apex app: uses (evidence: `README.md`)
- Apex app → Race schedule: offers (evidence: `README.md`)
- Apex app → Race pages: offers (evidence: `README.md`)
- Apex app → Season standings: offers (evidence: `README.md`)
- Apex app → Team standings: offers (evidence: `README.md`)
- Apex app → Driver profiles: offers (evidence: `README.md`)
- Apex app → Team profiles: offers (evidence: `README.md`)
- Apex app → All drivers: offers (evidence: `README.md`)
- Apex app → Saved races: offers (evidence: `README.md`)
- Apex app → Past seasons: offers (evidence: `README.md`)
- Apex app → Title contenders: offers (evidence: `README.md`)
- Apex app → Qualifying forecast: offers (evidence: `README.md`)
- Apex app → User predictions: offers (evidence: `README.md`)
- Apex app → Prediction stats: offers (evidence: `README.md`)
- Apex app → Leaderboard: offers (evidence: `README.md`)
- Apex app → Public profiles: offers (evidence: `README.md`)
- Apex app → Awards: offers (evidence: `README.md`)
- Apex app → Race notifications: sends (evidence: `README.md`)
- Apex app → Offline cache: serves cached data (evidence: `README.md`)
- Apex app → Firebase services: uses (evidence: `README.md`)
- Apex app → Jolpica API: fetches F1 data (evidence: `README.md`)
- Apex app → OpenF1 API: fetches F1 data (evidence: `README.md`)
- Apex app → Account: offers (evidence: `README.md`)
- Firebase services → User predictions: processes submissions (evidence: `README.md`)
- Firebase services → Leaderboard: provides ranking (evidence: `README.md`)
- Firebase services → Awards: provides medals (evidence: `README.md`)
