# revaldo007/gaming-portal architecture

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

- Interactive diagram: https://gitdiagram.com/revaldo007/gaming-portal
- Repository: https://github.com/revaldo007/gaming-portal

## Overview

Gaming Portal is a browser arcade with account sessions, playable games, profiles, score history, leaderboards, coins, and achievements. The main user flow is sign in or register, enter the portal, play a game, and submit its result; the backend records scores and awards coins and achievements, which the portal reads for profile and leaderboard views. The README and sampled files establish the frontend/API wiring and backend routes. Frontend game internals were not sampled, so game execution details are not expanded here.

Main entry points: [`Backend/main.py`](https://github.com/revaldo007/gaming-portal/blob/main/Backend/main.py) (HTTP API), [`Backend/routes/auth.py`](https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/auth.py) (Account Routes), [`Backend/routes/scores.py`](https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/scores.py) (Scores & Awards), [`Backend/database.py`](https://github.com/revaldo007/gaming-portal/blob/main/Backend/database.py) (DB Sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser App"]
  node_app["App Router<br/>[App.jsx]"]
  node_auth_page["Sign In<br/>[AuthPage.jsx]"]
  node_auth_context["Session State<br/>[AuthContext.jsx]"]
  node_portal["Arcade Portal<br/>[GamingPortal.jsx]"]
  node_lottie["Lottie Player<br/>[LottiePlayer.jsx]"]
  node_api_client["API Client<br/>[api.js]"]
end

subgraph group_api["API Surface"]
  node_http_api["HTTP API<br/>[main.py]"]
  node_auth_routes["Account Routes<br/>[auth.py]"]
  node_games_routes["Game Catalog<br/>[games.py]"]
  node_scores_routes["Scores &amp; Awards<br/>[scores.py]"]
  node_achievements_routes["Achievement Routes<br/>[achievements.py]"]
  node_users_routes["Profile Routes<br/>[users.py]"]
end

subgraph group_services["Backend Services"]
  node_token_security["Token &amp; Passwords<br/>[auth.py]"]
  node_auth_dependency["Auth Dependency<br/>[dependencies.py]"]
  node_models["Domain Models<br/>[models.py]"]
end

subgraph group_data["Persistence"]
  node_db_session["DB Sessions<br/>[database.py]"]
  node_sqlite[("SQLite Database")]
  node_avatar_files["Avatar Uploads"]
end

node_player(("Player"))

node_player -->|"uses"| node_app
node_app -->|"provides session"| node_auth_context
node_app -->|"shows signed out"| node_auth_page
node_app -->|"shows signed in"| node_portal
node_auth_page -->|"calls login/register"| node_auth_context
node_auth_page -->|"renders"| node_lottie
node_auth_context -->|"calls"| node_api_client
node_portal -->|"fetches portal data"| node_api_client
node_api_client -->|"sends requests"| node_http_api
node_http_api -->|"registers router"| node_auth_routes
node_http_api -->|"registers router"| node_games_routes
node_http_api -->|"registers router"| node_scores_routes
node_http_api -->|"registers router"| node_achievements_routes
node_http_api -->|"registers router"| node_users_routes
node_http_api -->|"creates tables"| node_db_session
node_auth_routes -->|"hashes and signs"| node_token_security
node_auth_routes -->|"requires current user"| node_auth_dependency
node_auth_routes -->|"uses sessions"| node_db_session
node_auth_routes -->|"reads and writes"| node_models
node_auth_dependency -->|"decodes token"| node_token_security
node_auth_dependency -->|"loads user"| node_db_session
node_auth_dependency -->|"loads user model"| node_models
node_scores_routes -->|"requires current user"| node_auth_dependency
node_scores_routes -->|"queries and commits"| node_db_session
node_scores_routes -->|"stores scores and awards"| node_models
node_scores_routes -->|"reads game catalog"| node_games_routes
node_achievements_routes -->|"requires current user"| node_auth_dependency
node_achievements_routes -->|"queries records"| node_db_session
node_achievements_routes -->|"reads achievement models"| node_models
node_users_routes -->|"queries profile"| node_db_session
node_users_routes -->|"reads user models"| node_models
node_db_session -->|"persists data"| node_sqlite
node_auth_routes -->|"writes avatar"| node_avatar_files
node_http_api -->|"serves uploads"| node_avatar_files
node_auth_routes -->|"broadcasts profile updates"| node_http_api
node_scores_routes -->|"broadcasts coin updates"| node_http_api
node_portal -->|"submits game results"| node_scores_routes

click node_app "https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/App.jsx"
click node_auth_page "https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/pages/AuthPage.jsx"
click node_auth_context "https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/context/AuthContext.jsx"
click node_portal "https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/GamingPortal.jsx"
click node_lottie "https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/components/LottiePlayer.jsx"
click node_api_client "https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/api.js"
click node_http_api "https://github.com/revaldo007/gaming-portal/blob/main/Backend/main.py"
click node_auth_routes "https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/auth.py"
click node_games_routes "https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/games.py"
click node_scores_routes "https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/scores.py"
click node_achievements_routes "https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/achievements.py"
click node_users_routes "https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/users.py"
click node_token_security "https://github.com/revaldo007/gaming-portal/blob/main/Backend/auth.py"
click node_auth_dependency "https://github.com/revaldo007/gaming-portal/blob/main/Backend/dependencies.py"
click node_models "https://github.com/revaldo007/gaming-portal/blob/main/Backend/models.py"
click node_db_session "https://github.com/revaldo007/gaming-portal/blob/main/Backend/database.py"
click node_avatar_files "https://github.com/revaldo007/gaming-portal/tree/main/Backend/uploads"

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_auth_page,node_auth_context,node_portal,node_lottie,node_api_client toneBlue
class node_http_api,node_auth_routes,node_games_routes,node_scores_routes,node_achievements_routes,node_users_routes toneAmber
class node_token_security,node_auth_dependency,node_models toneMint
class node_db_session,node_sqlite,node_avatar_files toneRose
class node_player toneIndigo
```

## Components

### Browser App

- [App Router](https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Sign In](https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/pages/AuthPage.jsx): `Frontend/src/pages/AuthPage.jsx`
- [Session State](https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/context/AuthContext.jsx): `Frontend/src/context/AuthContext.jsx`
- [Arcade Portal](https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/GamingPortal.jsx): `Frontend/src/GamingPortal.jsx`
- [Lottie Player](https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/components/LottiePlayer.jsx): `Frontend/src/components/LottiePlayer.jsx`
- [API Client](https://github.com/revaldo007/gaming-portal/blob/main/Frontend/src/api.js): `Frontend/src/api.js`

### API Surface

- [HTTP API](https://github.com/revaldo007/gaming-portal/blob/main/Backend/main.py): `Backend/main.py`
- [Account Routes](https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/auth.py): `Backend/routes/auth.py`
- [Game Catalog](https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/games.py): `Backend/routes/games.py`
- [Scores & Awards](https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/scores.py): `Backend/routes/scores.py`
- [Achievement Routes](https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/achievements.py): `Backend/routes/achievements.py`
- [Profile Routes](https://github.com/revaldo007/gaming-portal/blob/main/Backend/routes/users.py): `Backend/routes/users.py`

### Backend Services

- [Token & Passwords](https://github.com/revaldo007/gaming-portal/blob/main/Backend/auth.py): `Backend/auth.py`
- [Auth Dependency](https://github.com/revaldo007/gaming-portal/blob/main/Backend/dependencies.py): `Backend/dependencies.py`
- [Domain Models](https://github.com/revaldo007/gaming-portal/blob/main/Backend/models.py): `Backend/models.py`

### Persistence

- [DB Sessions](https://github.com/revaldo007/gaming-portal/blob/main/Backend/database.py): `Backend/database.py`
- **SQLite Database**
- [Avatar Uploads](https://github.com/revaldo007/gaming-portal/tree/main/Backend/uploads): `Backend/uploads`

### Other components

- **Player**

## Connections

- Player → App Router: uses (evidence: `Frontend/src/App.jsx`)
- App Router → Session State: provides session (evidence: `Frontend/src/App.jsx`)
- App Router → Sign In: shows signed out (evidence: `Frontend/src/App.jsx`)
- App Router → Arcade Portal: shows signed in (evidence: `Frontend/src/App.jsx`)
- Sign In → Session State: calls login/register (evidence: `Frontend/src/pages/AuthPage.jsx`)
- Sign In → Lottie Player: renders (evidence: `Frontend/src/pages/AuthPage.jsx`)
- Session State → API Client: calls (evidence: `Frontend/src/context/AuthContext.jsx`)
- Arcade Portal → API Client: fetches portal data (evidence: `README.md`)
- API Client → HTTP API: sends requests (evidence: `README.md`)
- HTTP API → Account Routes: registers router (evidence: `Backend/main.py`)
- HTTP API → Game Catalog: registers router (evidence: `Backend/main.py`)
- HTTP API → Scores & Awards: registers router (evidence: `Backend/main.py`)
- HTTP API → Achievement Routes: registers router (evidence: `Backend/main.py`)
- HTTP API → Profile Routes: registers router (evidence: `Backend/main.py`)
- HTTP API → DB Sessions: creates tables (evidence: `Backend/main.py`)
- Account Routes → Token & Passwords: hashes and signs (evidence: `Backend/routes/auth.py`)
- Account Routes → Auth Dependency: requires current user (evidence: `Backend/routes/auth.py`)
- Account Routes → DB Sessions: uses sessions (evidence: `Backend/routes/auth.py`)
- Account Routes → Domain Models: reads and writes (evidence: `Backend/routes/auth.py`)
- Auth Dependency → Token & Passwords: decodes token (evidence: `Backend/dependencies.py`)
- Auth Dependency → DB Sessions: loads user (evidence: `Backend/dependencies.py`)
- Auth Dependency → Domain Models: loads user model (evidence: `Backend/dependencies.py`)
- Scores & Awards → Auth Dependency: requires current user (evidence: `Backend/routes/scores.py`)
- Scores & Awards → DB Sessions: queries and commits (evidence: `Backend/routes/scores.py`)
- Scores & Awards → Domain Models: stores scores and awards (evidence: `Backend/routes/scores.py`)
- Scores & Awards → Game Catalog: reads game catalog (evidence: `Backend/routes/scores.py`)
- Achievement Routes → Auth Dependency: requires current user (evidence: `Backend/routes/achievements.py`)
- Achievement Routes → DB Sessions: queries records (evidence: `Backend/routes/achievements.py`)
- Achievement Routes → Domain Models: reads achievement models (evidence: `Backend/routes/achievements.py`)
- Profile Routes → DB Sessions: queries profile (evidence: `Backend/routes/users.py`)
- Profile Routes → Domain Models: reads user models (evidence: `Backend/routes/users.py`)
- DB Sessions → SQLite Database: persists data (evidence: `Backend/database.py`)
- Account Routes → Avatar Uploads: writes avatar (evidence: `Backend/routes/auth.py`)
- HTTP API → Avatar Uploads: serves uploads (evidence: `Backend/main.py`)
- Account Routes → HTTP API: broadcasts profile updates (evidence: `Backend/routes/auth.py`)
- Scores & Awards → HTTP API: broadcasts coin updates (evidence: `Backend/routes/scores.py`)
- Arcade Portal → Scores & Awards: submits game results (evidence: `README.md`)
