# esnogitaccount/avanceradfullstack_grupparbete_tss architecture

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

## Overview

This repository implements a city-guessing game: players use the web app to play daily or themed challenges, submit results, and view leaderboards and achievements. The backend exposes game, city-content, account, profile, and administration APIs, with persistence and image storage behind services. The graph preserves those documented product areas, but several frontend-to-API and backend service links are not shown in the available excerpts; those connections are omitted or marked unverified rather than inferred as confirmed calls.

Main entry points: [`frontend/src/App.tsx`](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/App.tsx) (Route shell), [`backend/Data/WhereAreWeDbContext.cs`](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Data/WhereAreWeDbContext.cs) (Game database), [`backend/Services/AuthService.cs`](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/AuthService.cs) (Authentication), [`backend/Services/CityService.cs`](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/CityService.cs) (City content management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Route shell<br/>[App.tsx]"]
  node_game_page["Game page<br/>[gamePage.tsx]"]
  node_leaderboard_page["Leaderboard page"]
  node_profile_page["Profile page<br/>[ProfilePage.tsx]"]
  node_admin_page["Admin page<br/>[AdminPage.tsx]"]
  node_game_ui["Game interaction<br/>[game.tsx]"]
end

subgraph group_play["Gameplay and content"]
  node_daily_challenge["Daily challenges"]
  node_city_content["City content management<br/>[CityService.cs]"]
  node_city_api["City endpoints"]
  node_game_api["Game endpoints<br/>[GamesController.cs]"]
  node_game_service["Game results<br/>[GameService.cs]"]
end

subgraph group_identity["Accounts and results"]
  node_auth_api["Authentication endpoints<br/>[AuthController.cs]"]
  node_auth_service["Authentication<br/>[AuthService.cs]"]
  node_profile_api["Profile endpoints"]
  node_leaderboard["Leaderboard service"]
  node_achievement["Achievements"]
end

subgraph group_storage["Persistence and media"]
  node_database[("Game database")]
  node_city_repository["City repository<br/>[CityRepository.cs]"]
  node_refresh_repository["Refresh-token repository"]
  node_registration_repository["Registration repository"]
  node_blob_service["Image blob storage"]
end

node_player(("Player"))
node_azure_blobs[("Azure Blob Storage")]

node_player -->|"uses"| node_app
node_app -->|"routes to"| node_game_page
node_app -->|"routes to"| node_leaderboard_page
node_app -->|"routes to"| node_profile_page
node_app -->|"routes to"| node_admin_page
node_game_page -.->|"renders"| node_game_ui
node_player -.->|"submits play"| node_game_api
node_game_api -->|"delegates to"| node_game_service
node_city_api -->|"delegates to"| node_city_content
node_city_content -->|"uses"| node_city_repository
node_city_content -->|"manages images"| node_blob_service
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and writes"| node_refresh_repository
node_auth_service -->|"registers through"| node_registration_repository
node_auth_service -.->|"reads users"| node_database
node_city_repository -->|"queries cities"| node_database
node_refresh_repository -->|"stores tokens"| node_database
node_registration_repository -->|"creates accounts"| node_database
node_database -.->|"stores blob names"| node_blob_service
node_blob_service -->|"uploads and downloads"| node_azure_blobs

click node_app "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/App.tsx"
click node_game_page "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/game-page/gamePage.tsx"
click node_leaderboard_page "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/leaderboard-page/LeaderboardPage.tsx"
click node_profile_page "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/profile-page/ProfilePage.tsx"
click node_admin_page "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/admin-page/AdminPage.tsx"
click node_game_ui "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/components/game-components/game/game.tsx"
click node_daily_challenge "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/DailyChallengeService.cs"
click node_city_content "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/CityService.cs"
click node_city_api "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/CitiesController.cs"
click node_game_api "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/GamesController.cs"
click node_game_service "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/GameService.cs"
click node_auth_api "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/AuthController.cs"
click node_auth_service "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/AuthService.cs"
click node_profile_api "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/ProfileController.cs"
click node_leaderboard "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/LeaderboardService.cs"
click node_achievement "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/AchievementService.cs"
click node_database "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Data/WhereAreWeDbContext.cs"
click node_city_repository "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Repositories/CityRepository.cs"
click node_refresh_repository "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Repositories/RefreshTokenRepository.cs"
click node_registration_repository "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Repositories/RegistrationRepository.cs"
click node_blob_service "https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/BlobStorageService.cs"

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_game_page,node_leaderboard_page,node_profile_page,node_admin_page,node_game_ui toneBlue
class node_daily_challenge,node_city_content,node_city_api,node_game_api,node_game_service,node_azure_blobs toneAmber
class node_auth_api,node_auth_service,node_profile_api,node_leaderboard,node_achievement toneMint
class node_database,node_city_repository,node_refresh_repository,node_registration_repository,node_blob_service toneRose
class node_player toneIndigo
```

## Components

### Web experience

- [Route shell](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Game page](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/game-page/gamePage.tsx): `frontend/src/pages/game-page/gamePage.tsx`
- [Leaderboard page](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/leaderboard-page/LeaderboardPage.tsx): `frontend/src/pages/leaderboard-page/LeaderboardPage.tsx`
- [Profile page](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/profile-page/ProfilePage.tsx): `frontend/src/pages/profile-page/ProfilePage.tsx`
- [Admin page](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/pages/admin-page/AdminPage.tsx): `frontend/src/pages/admin-page/AdminPage.tsx`
- [Game interaction](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/frontend/src/components/game-components/game/game.tsx): `frontend/src/components/game-components/game/game.tsx`

### Gameplay and content

- [Daily challenges](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/DailyChallengeService.cs): `backend/Services/DailyChallengeService.cs`
- [City content management](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/CityService.cs): `backend/Services/CityService.cs`
- [City endpoints](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/CitiesController.cs): `backend/Controllers/CitiesController.cs`
- [Game endpoints](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/GamesController.cs): `backend/Controllers/GamesController.cs`
- [Game results](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/GameService.cs): `backend/Services/GameService.cs`

### Accounts and results

- [Authentication endpoints](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/AuthController.cs): `backend/Controllers/AuthController.cs`
- [Authentication](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/AuthService.cs): `backend/Services/AuthService.cs`
- [Profile endpoints](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Controllers/ProfileController.cs): `backend/Controllers/ProfileController.cs`
- [Leaderboard service](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/LeaderboardService.cs): `backend/Services/LeaderboardService.cs`
- [Achievements](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/AchievementService.cs): `backend/Services/AchievementService.cs`

### Persistence and media

- [Game database](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Data/WhereAreWeDbContext.cs): `backend/Data/WhereAreWeDbContext.cs`
- [City repository](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Repositories/CityRepository.cs): `backend/Repositories/CityRepository.cs`
- [Refresh-token repository](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Repositories/RefreshTokenRepository.cs): `backend/Repositories/RefreshTokenRepository.cs`
- [Registration repository](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Repositories/RegistrationRepository.cs): `backend/Repositories/RegistrationRepository.cs`
- [Image blob storage](https://github.com/esnogitaccount/avanceradfullstack_grupparbete_tss/blob/master/backend/Services/BlobStorageService.cs): `backend/Services/BlobStorageService.cs`

### Other components

- **Player**
- **Azure Blob Storage**

## Connections

- Player → Route shell: uses
- Route shell → Game page: routes to (evidence: `frontend/src/App.tsx`)
- Route shell → Leaderboard page: routes to (evidence: `frontend/src/App.tsx`)
- Route shell → Profile page: routes to (evidence: `frontend/src/App.tsx`)
- Route shell → Admin page: routes to (evidence: `frontend/src/App.tsx`)
- Game page → Game interaction: renders
- Player → Game endpoints: submits play
- Game endpoints → Game results: delegates to (evidence: `backend/Controllers/GamesController.cs`)
- City endpoints → City content management: delegates to (evidence: `backend/Controllers/CitiesController.cs`)
- City content management → City repository: uses (evidence: `backend/Services/CityService.cs`)
- City content management → Image blob storage: manages images (evidence: `backend/Services/CityService.cs`)
- Authentication endpoints → Authentication: delegates to (evidence: `backend/Controllers/AuthController.cs`)
- Authentication → Refresh-token repository: reads and writes (evidence: `backend/Services/AuthService.cs`)
- Authentication → Registration repository: registers through (evidence: `backend/Services/AuthService.cs`)
- Authentication → Game database: reads users
- City repository → Game database: queries cities (evidence: `backend/Repositories/CityRepository.cs`)
- Refresh-token repository → Game database: stores tokens (evidence: `backend/Repositories/RefreshTokenRepository.cs`)
- Registration repository → Game database: creates accounts (evidence: `backend/Repositories/RegistrationRepository.cs`)
- Game database → Image blob storage: stores blob names
- Image blob storage → Azure Blob Storage: uploads and downloads (evidence: `backend/Services/BlobStorageService.cs`)
