# koverthanan-git/game_recomendation architecture

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

- Interactive diagram: https://gitdiagram.com/koverthanan-git/game_recomendation
- Repository: https://github.com/koverthanan-git/game_recomendation

## Overview

The repository combines a React/Django FPS recommendation product with two documented data/model workflows: hardware-image classification and benchmark-data ETL. The main user flow configures a PC and game, requests a prediction, and views FPS and bottleneck results. The Django API looks up hardware data, runs CatBoost inference, and computes bottleneck advice. ETL and image-classification branches are documented in the README; their internal wiring is shown only where that documentation supports it. Source excerpts establish the API and UI links; unsampled subsystem details are not inferred.

Main entry points: [`api/views.py`](https://github.com/koverthanan-git/game_recomendation/blob/main/api/views.py) (REST Views), [`frontend/src/App.jsx`](https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/App.jsx) (FPS Dashboard), [`etl_pipeline.py`](https://github.com/koverthanan-git/game_recomendation/blob/main/etl_pipeline.py) (Benchmark ETL), [`app.py`](https://github.com/koverthanan-git/game_recomendation/blob/main/app.py) (Image Classifier App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Recommendation UI"]
  node_app_ui["FPS Dashboard<br/>[App.jsx]"]
  node_config["Rig Form<br/>[ConfigForm.jsx]"]
  node_autocomplete["Hardware Autocomplete"]
  node_client["API Client<br/>[api.js]"]
  node_results["Results Dashboard"]
end

subgraph group_backend["Prediction API"]
  node_api_views["REST Views<br/>[views.py]"]
  node_serializers["Request Validation<br/>[serializers.py]"]
  node_db_helpers["PostgreSQL Queries<br/>[db.py]"]
  node_predictor["FPS Inference<br/>[predictor.py]"]
  node_bottleneck["Bottleneck Analysis<br/>[bottleneck.py]"]
end

subgraph group_data["Data Pipeline"]
  node_postgres[("PostgreSQL")]
  node_etl["Benchmark ETL<br/>[etl_pipeline.py]"]
  node_igdb["IGDB Metadata"]
  node_training_export["Training CSV Export<br/>[etl_pipeline.py]"]
end

subgraph group_classifier["Image Classifier"]
  node_flask["Image Classifier App<br/>[app.py]"]
  node_cnn_training["VGG16 Training<br/>[model.py]"]
  node_image_dataset["CPU/GPU Images"]
end

node_gamer(("PC Builder"))
node_image_user(("Image Uploader"))

node_gamer -->|"configures"| node_app_ui
node_app_ui -->|"renders"| node_config
node_app_ui -->|"requests prediction"| node_client
node_app_ui -->|"renders results"| node_results
node_config -->|"uses"| node_autocomplete
node_client -->|"calls REST API"| node_api_views
node_api_views -->|"validates request"| node_serializers
node_api_views -->|"looks up hardware"| node_db_helpers
node_api_views -->|"requests inference"| node_predictor
node_api_views -->|"requests analysis"| node_bottleneck
node_db_helpers -->|"queries"| node_postgres
node_etl -->|"loads tables"| node_postgres
node_etl -->|"enriches games"| node_igdb
node_etl -->|"exports joined data"| node_training_export
node_image_user -->|"uploads image"| node_flask
node_flask -.->|"classifies images from"| node_image_dataset
node_cnn_training -->|"trains on"| node_image_dataset
node_cnn_training -.->|"provides trained model"| node_flask

click node_app_ui "https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/App.jsx"
click node_config "https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/components/ConfigForm.jsx"
click node_autocomplete "https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/components/AutocompleteInput.jsx"
click node_client "https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/api.js"
click node_results "https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/components/ResultsDashboard.jsx"
click node_api_views "https://github.com/koverthanan-git/game_recomendation/blob/main/api/views.py"
click node_serializers "https://github.com/koverthanan-git/game_recomendation/blob/main/api/serializers.py"
click node_db_helpers "https://github.com/koverthanan-git/game_recomendation/blob/main/api/db.py"
click node_predictor "https://github.com/koverthanan-git/game_recomendation/blob/main/services/predictor.py"
click node_bottleneck "https://github.com/koverthanan-git/game_recomendation/blob/main/services/bottleneck.py"
click node_etl "https://github.com/koverthanan-git/game_recomendation/blob/main/etl_pipeline.py"
click node_training_export "https://github.com/koverthanan-git/game_recomendation/blob/main/etl_pipeline.py"
click node_flask "https://github.com/koverthanan-git/game_recomendation/blob/main/app.py"
click node_cnn_training "https://github.com/koverthanan-git/game_recomendation/blob/main/model.py"
click node_image_dataset "https://github.com/koverthanan-git/game_recomendation/tree/main/dataset"

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_ui,node_config,node_autocomplete,node_client,node_results toneBlue
class node_api_views,node_serializers,node_db_helpers,node_predictor,node_bottleneck toneAmber
class node_postgres,node_etl,node_igdb,node_training_export toneMint
class node_flask,node_cnn_training,node_image_dataset toneRose
class node_gamer,node_image_user toneIndigo
```

## Components

### Recommendation UI

- [FPS Dashboard](https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Rig Form](https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/components/ConfigForm.jsx): `frontend/src/components/ConfigForm.jsx`
- [Hardware Autocomplete](https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/components/AutocompleteInput.jsx): `frontend/src/components/AutocompleteInput.jsx`
- [API Client](https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [Results Dashboard](https://github.com/koverthanan-git/game_recomendation/blob/main/frontend/src/components/ResultsDashboard.jsx): `frontend/src/components/ResultsDashboard.jsx`

### Prediction API

- [REST Views](https://github.com/koverthanan-git/game_recomendation/blob/main/api/views.py): `api/views.py`
- [Request Validation](https://github.com/koverthanan-git/game_recomendation/blob/main/api/serializers.py): `api/serializers.py`
- [PostgreSQL Queries](https://github.com/koverthanan-git/game_recomendation/blob/main/api/db.py): `api/db.py`
- [FPS Inference](https://github.com/koverthanan-git/game_recomendation/blob/main/services/predictor.py): `services/predictor.py`
- [Bottleneck Analysis](https://github.com/koverthanan-git/game_recomendation/blob/main/services/bottleneck.py): `services/bottleneck.py`

### Data Pipeline

- **PostgreSQL**
- [Benchmark ETL](https://github.com/koverthanan-git/game_recomendation/blob/main/etl_pipeline.py): `etl_pipeline.py`
- **IGDB Metadata**
- [Training CSV Export](https://github.com/koverthanan-git/game_recomendation/blob/main/etl_pipeline.py): `etl_pipeline.py`

### Image Classifier

- [Image Classifier App](https://github.com/koverthanan-git/game_recomendation/blob/main/app.py): `app.py`
- [VGG16 Training](https://github.com/koverthanan-git/game_recomendation/blob/main/model.py): `model.py`
- [CPU/GPU Images](https://github.com/koverthanan-git/game_recomendation/tree/main/dataset): `dataset`

### Other components

- **PC Builder**
- **Image Uploader**

## Connections

- PC Builder → FPS Dashboard: configures (evidence: `README.md`)
- FPS Dashboard → Rig Form: renders (evidence: `frontend/src/App.jsx`)
- FPS Dashboard → API Client: requests prediction (evidence: `frontend/src/App.jsx`)
- FPS Dashboard → Results Dashboard: renders results (evidence: `frontend/src/App.jsx`)
- Rig Form → Hardware Autocomplete: uses (evidence: `frontend/src/components/ConfigForm.jsx`)
- API Client → REST Views: calls REST API (evidence: `frontend/src/api.js`)
- REST Views → Request Validation: validates request (evidence: `api/views.py`)
- REST Views → PostgreSQL Queries: looks up hardware (evidence: `api/views.py`)
- REST Views → FPS Inference: requests inference (evidence: `api/views.py`)
- REST Views → Bottleneck Analysis: requests analysis (evidence: `api/views.py`)
- PostgreSQL Queries → PostgreSQL: queries (evidence: `api/db.py`)
- Benchmark ETL → PostgreSQL: loads tables (evidence: `README.md`)
- Benchmark ETL → IGDB Metadata: enriches games (evidence: `README.md`)
- Benchmark ETL → Training CSV Export: exports joined data (evidence: `README.md`)
- Image Uploader → Image Classifier App: uploads image (evidence: `README.md`)
- Image Classifier App → CPU/GPU Images: classifies images from
- VGG16 Training → CPU/GPU Images: trains on (evidence: `README.md`)
- VGG16 Training → Image Classifier App: provides trained model
