# bechiixd/do-expensive-games-get-better-reviews architecture

> Architecture diagram of the GitHub repository bechiixd/do-expensive-games-get-better-reviews, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bechiixd/do-expensive-games-get-better-reviews
- Repository: https://github.com/bechiixd/do-expensive-games-get-better-reviews

## Overview

Este repositorio es un proyecto de análisis de datos sobre precio, popularidad y reviews de juegos de Steam. El flujo principal recolecta ventas semanales, enriquece los juegos seleccionados, obtiene sus reviews y construye un dataset; los notebooks exploran los datos y evalúan las hipótesis. El README documenta el orden del pipeline y el análisis, mientras que las relaciones con servicios y archivos intermedios se apoyan en los scripts excerptados. Los notebooks no fueron muestreados, así que sus detalles internos se omiten.

Main entry points: [`data/dataset.csv`](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/dataset.csv) (Dataset analítico), [`scripts/enrich_getitems.py`](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/enrich_getitems.py) (Enriquecimiento GetItems), [`scripts/fetch_reviews.py`](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/fetch_reviews.py) (Obtención de reviews), [`scripts/build_dataset.py`](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/build_dataset.py) (Ingeniería de features)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Recolección y enriquecimiento"]
  node_weekly["Ventas semanales"]
  node_enrich["Enriquecimiento GetItems<br/>[enrich_getitems.py]"]
  node_fetch_reviews["Obtención de reviews<br/>[fetch_reviews.py]"]
end

subgraph group_dataset["Construcción de datos"]
  node_build["Ingeniería de features<br/>[build_dataset.py]"]
end

subgraph group_analysis["Análisis"]
  node_exploration["Exploración de datos"]
  node_eda["EDA y correlaciones<br/>[02_eda.ipynb]"]
  node_hypothesis["Test de hipótesis<br/>[03_analysis.ipynb]"]
end

subgraph group_outputs["Datos y resultados"]
  node_checkpoint[("Checkpoint de juegos<br/>[checkpoint.json]")]
  node_selected[("Juegos seleccionados<br/>[selected.csv]")]
  node_reviews[("Reviews agregadas<br/>[reviews.csv]")]
  node_dataset_file[("Dataset analítico<br/>[dataset.csv]")]
  node_figures["Figuras del análisis"]
end

node_researcher(("Analista"))
node_steam{{"Servicios Steam"}}

node_researcher -->|"inicia pipeline"| node_weekly
node_weekly -->|"consulta ventas"| node_steam
node_weekly -->|"guarda juegos"| node_checkpoint
node_enrich -->|"lee checkpoint"| node_checkpoint
node_enrich -->|"consulta GetItems"| node_steam
node_enrich -->|"guarda selección"| node_selected
node_fetch_reviews -->|"lee selección"| node_selected
node_fetch_reviews -->|"consulta reviews"| node_steam
node_fetch_reviews -->|"guarda reviews"| node_reviews
node_build -->|"lee selección"| node_selected
node_build -->|"lee reviews"| node_reviews
node_build -->|"construye dataset"| node_dataset_file
node_researcher -->|"ejecuta notebooks"| node_exploration
node_dataset_file -->|"alimenta exploración"| node_exploration
node_dataset_file -->|"alimenta EDA"| node_eda
node_dataset_file -->|"alimenta análisis"| node_hypothesis
node_hypothesis -->|"genera figuras"| node_figures

click node_weekly "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/fetch_topsellers.py"
click node_checkpoint "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/checkpoint.json"
click node_enrich "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/enrich_getitems.py"
click node_selected "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/selected.csv"
click node_fetch_reviews "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/fetch_reviews.py"
click node_reviews "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/reviews.csv"
click node_build "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/build_dataset.py"
click node_dataset_file "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/dataset.csv"
click node_exploration "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/notebooks/01_exploration.ipynb"
click node_eda "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/notebooks/02_eda.ipynb"
click node_hypothesis "https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/notebooks/03_analysis.ipynb"
click node_figures "https://github.com/bechiixd/do-expensive-games-get-better-reviews/tree/main/img"

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_weekly,node_enrich,node_fetch_reviews toneBlue
class node_build toneAmber
class node_exploration,node_eda,node_hypothesis toneMint
class node_checkpoint,node_selected,node_reviews,node_dataset_file,node_figures toneRose
class node_researcher,node_steam toneIndigo
```

## Components

### Recolección y enriquecimiento

- [Ventas semanales](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/fetch_topsellers.py): `scripts/fetch_topsellers.py`
- [Enriquecimiento GetItems](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/enrich_getitems.py): `scripts/enrich_getitems.py`
- [Obtención de reviews](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/fetch_reviews.py): `scripts/fetch_reviews.py`

### Construcción de datos

- [Ingeniería de features](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/scripts/build_dataset.py): `scripts/build_dataset.py`

### Análisis

- [Exploración de datos](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/notebooks/01_exploration.ipynb): `notebooks/01_exploration.ipynb`
- [EDA y correlaciones](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/notebooks/02_eda.ipynb): `notebooks/02_eda.ipynb`
- [Test de hipótesis](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/notebooks/03_analysis.ipynb): `notebooks/03_analysis.ipynb`

### Datos y resultados

- [Checkpoint de juegos](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/checkpoint.json): `data/checkpoint.json`
- [Juegos seleccionados](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/selected.csv): `data/selected.csv`
- [Reviews agregadas](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/reviews.csv): `data/reviews.csv`
- [Dataset analítico](https://github.com/bechiixd/do-expensive-games-get-better-reviews/blob/main/data/dataset.csv): `data/dataset.csv`
- [Figuras del análisis](https://github.com/bechiixd/do-expensive-games-get-better-reviews/tree/main/img): `img`

### Other components

- **Analista**
- **Servicios Steam**

## Connections

- Analista → Ventas semanales: inicia pipeline (evidence: `README.md`)
- Ventas semanales → Servicios Steam: consulta ventas (evidence: `scripts/fetch_topsellers.py`)
- Ventas semanales → Checkpoint de juegos: guarda juegos (evidence: `scripts/fetch_topsellers.py`)
- Enriquecimiento GetItems → Checkpoint de juegos: lee checkpoint (evidence: `scripts/enrich_getitems.py`)
- Enriquecimiento GetItems → Servicios Steam: consulta GetItems (evidence: `scripts/enrich_getitems.py`)
- Enriquecimiento GetItems → Juegos seleccionados: guarda selección (evidence: `scripts/enrich_getitems.py`)
- Obtención de reviews → Juegos seleccionados: lee selección (evidence: `scripts/fetch_reviews.py`)
- Obtención de reviews → Servicios Steam: consulta reviews (evidence: `scripts/fetch_reviews.py`)
- Obtención de reviews → Reviews agregadas: guarda reviews (evidence: `scripts/fetch_reviews.py`)
- Ingeniería de features → Juegos seleccionados: lee selección (evidence: `scripts/build_dataset.py`)
- Ingeniería de features → Reviews agregadas: lee reviews (evidence: `scripts/build_dataset.py`)
- Ingeniería de features → Dataset analítico: construye dataset (evidence: `scripts/build_dataset.py`)
- Analista → Exploración de datos: ejecuta notebooks (evidence: `README.md`)
- Dataset analítico → Exploración de datos: alimenta exploración (evidence: `README.md`)
- Dataset analítico → EDA y correlaciones: alimenta EDA (evidence: `README.md`)
- Dataset analítico → Test de hipótesis: alimenta análisis (evidence: `README.md`)
- Test de hipótesis → Figuras del análisis: genera figuras (evidence: `README.md`)
