# alonso-rodriguez-bolanos/proyecto3 architecture

> Architecture diagram of the GitHub repository alonso-rodriguez-bolanos/proyecto3, 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/alonso-rodriguez-bolanos/proyecto3
- Repository: https://github.com/alonso-rodriguez-bolanos/proyecto3

## Overview

El producto es un scraper paralelo de ofertas de videojuegos: carga juegos, consulta precios y datos de Metacritic y How Long To Beat, conserva datos previos cuando fallan fuentes y publica JSON para la web. El flujo principal parte de ejecutar.py; scraper/nivel1.py paraleliza juegos y scraper/nivel2.py coordina fuentes por juego. gestor.py ofrece edición de juegos y ejecución, mientras herramientas/ cubre enlaces y preparación de lotes. Las relaciones de subsistemas no muestreados se limitan a las capacidades y referencias explícitas del README y el SOURCE INDEX.

Main entry points: [`ejecutar.py`](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/ejecutar.py) (Ejecución principal), [`scraper/nivel2.py`](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/nivel2.py) (Coordinación fuentes), [`herramientas/preparar_lote.py`](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/preparar_lote.py) (Preparar lotes), [`gestor.py`](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/gestor.py) (Gestor GUI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_management["Gestión de juegos"]
  node_manager["Gestor GUI<br/>[gestor.py]"]
  node_table_tools["Acceso a tabla<br/>[tabla.py]"]
end

subgraph group_runtime["Motor de scraping"]
  node_runner["Ejecución principal<br/>[ejecutar.py]"]
  node_config["Configuración<br/>[config.py]"]
  node_level1["Paralelismo juegos<br/>[nivel1.py]"]
  node_level2["Coordinación fuentes<br/>[nivel2.py]"]
  node_limiter["Límites por sitio<br/>[limitador.py]"]
  node_network["Descarga segura<br/>[red.py]"]
end

subgraph group_sources["Fuentes de datos"]
  node_shop_scrapers["Scrapers de tiendas<br/>[tiendas.py]"]
  node_metacritic["Scraper Metacritic<br/>[metacritic.py]"]
  node_hltb["Scraper HLTB<br/>[hltb.py]"]
  node_fake_scrapers["Fuentes simuladas<br/>[falsos.py]"]
end

subgraph group_persistence["Datos y publicación"]
  node_repo["Carga de juegos<br/>[repo.py]"]
  node_supabase[("Supabase")]
  node_json_writer["Guardado y conservación<br/>[guardar.py]"]
  node_web_data["Datos web<br/>[data.json]"]
  node_web_page["Página de ofertas<br/>[index.html]"]
  node_csv_backup["Respaldo de juegos<br/>[juegos.csv]"]
end

subgraph group_tools["Herramientas de catálogo"]
  node_link_tools["Búsqueda de enlaces<br/>[enlaces.py]"]
  node_batch_tools["Preparar lotes<br/>[preparar_lote.py]"]
  node_audit_tools["Auditar enlaces<br/>[auditar_enlaces.py]"]
end

node_operator(("Operador"))

node_operator -->|"administra juegos"| node_manager
node_operator -->|"inicia scraping"| node_runner
node_manager -->|"administra catálogo"| node_table_tools
node_manager -->|"busca enlaces"| node_link_tools
node_manager -->|"lanza proceso"| node_runner
node_batch_tools -->|"completa enlaces"| node_link_tools
node_batch_tools -->|"consulta catálogo"| node_table_tools
node_batch_tools -->|"consulta tiendas"| node_shop_scrapers
node_batch_tools -->|"consulta tiempos"| node_hltb
node_audit_tools -->|"verifica enlaces"| node_link_tools
node_audit_tools -->|"lee juegos"| node_table_tools
node_audit_tools -->|"contrasta tiendas"| node_shop_scrapers
node_runner -->|"lee ajustes"| node_config
node_runner -->|"carga juegos"| node_repo
node_runner -->|"procesa juegos"| node_level1
node_runner -->|"guarda resultados"| node_json_writer
node_repo -->|"lee catálogo"| node_supabase
node_repo -->|"usa respaldo"| node_csv_backup
node_table_tools -->|"lee y escribe"| node_supabase
node_level1 -->|"distribuye juegos"| node_level2
node_level1 -->|"instala límites"| node_limiter
node_level2 -->|"consulta tiendas"| node_shop_scrapers
node_level2 -->|"consulta puntuación"| node_metacritic
node_level2 -->|"consulta duración"| node_hltb
node_level2 -->|"selecciona modo falso"| node_fake_scrapers
node_shop_scrapers -->|"descarga páginas"| node_network
node_metacritic -->|"descarga páginas"| node_network
node_hltb -->|"aplica protección"| node_network
node_network -->|"solicita turno"| node_limiter
node_fake_scrapers -->|"simula turno"| node_limiter
node_json_writer -->|"escribe JSON"| node_web_data
node_web_page -->|"muestra datos"| node_web_data

click node_manager "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/gestor.py"
click node_link_tools "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/enlaces.py"
click node_batch_tools "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/preparar_lote.py"
click node_audit_tools "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/auditar_enlaces.py"
click node_table_tools "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/tabla.py"
click node_runner "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/ejecutar.py"
click node_config "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/config.py"
click node_level1 "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/nivel1.py"
click node_level2 "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/nivel2.py"
click node_limiter "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/limitador.py"
click node_network "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/red.py"
click node_shop_scrapers "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/tiendas.py"
click node_metacritic "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/metacritic.py"
click node_hltb "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/hltb.py"
click node_fake_scrapers "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/falsos.py"
click node_repo "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/repo.py"
click node_json_writer "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/guardar.py"
click node_web_data "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/web/data.json"
click node_web_page "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/web/index.html"
click node_csv_backup "https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/datos/juegos.csv"

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_manager,node_table_tools toneBlue
class node_runner,node_config,node_level1,node_level2,node_limiter,node_network toneAmber
class node_shop_scrapers,node_metacritic,node_hltb,node_fake_scrapers toneMint
class node_repo,node_supabase,node_json_writer,node_web_data,node_web_page,node_csv_backup toneRose
class node_link_tools,node_batch_tools,node_audit_tools,node_operator toneIndigo
```

## Components

### Gestión de juegos

- [Gestor GUI](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/gestor.py): `gestor.py`
- [Acceso a tabla](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/tabla.py): `herramientas/tabla.py`

### Motor de scraping

- [Ejecución principal](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/ejecutar.py): `ejecutar.py`
- [Configuración](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/config.py): `scraper/config.py`
- [Paralelismo juegos](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/nivel1.py): `scraper/nivel1.py`
- [Coordinación fuentes](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/nivel2.py): `scraper/nivel2.py`
- [Límites por sitio](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/limitador.py): `scraper/limitador.py`
- [Descarga segura](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/red.py): `scraper/red.py`

### Fuentes de datos

- [Scrapers de tiendas](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/tiendas.py): `scraper/tiendas.py`
- [Scraper Metacritic](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/metacritic.py): `scraper/metacritic.py`
- [Scraper HLTB](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/hltb.py): `scraper/hltb.py`
- [Fuentes simuladas](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/falsos.py): `scraper/falsos.py`

### Datos y publicación

- [Carga de juegos](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/repo.py): `scraper/repo.py`
- **Supabase**
- [Guardado y conservación](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/scraper/guardar.py): `scraper/guardar.py`
- [Datos web](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/web/data.json): `web/data.json`
- [Página de ofertas](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/web/index.html): `web/index.html`
- [Respaldo de juegos](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/datos/juegos.csv): `datos/juegos.csv`

### Herramientas de catálogo

- [Búsqueda de enlaces](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/enlaces.py): `herramientas/enlaces.py`
- [Preparar lotes](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/preparar_lote.py): `herramientas/preparar_lote.py`
- [Auditar enlaces](https://github.com/alonso-rodriguez-bolanos/proyecto3/blob/main/herramientas/auditar_enlaces.py): `herramientas/auditar_enlaces.py`

### Other components

- **Operador**

## Connections

- Operador → Gestor GUI: administra juegos (evidence: `README.md`)
- Operador → Ejecución principal: inicia scraping (evidence: `README.md`)
- Gestor GUI → Acceso a tabla: administra catálogo (evidence: `gestor.py`)
- Gestor GUI → Búsqueda de enlaces: busca enlaces (evidence: `gestor.py`)
- Gestor GUI → Ejecución principal: lanza proceso (evidence: `gestor.py`)
- Preparar lotes → Búsqueda de enlaces: completa enlaces (evidence: `herramientas/preparar_lote.py`)
- Preparar lotes → Acceso a tabla: consulta catálogo (evidence: `herramientas/preparar_lote.py`)
- Preparar lotes → Scrapers de tiendas: consulta tiendas (evidence: `herramientas/preparar_lote.py`)
- Preparar lotes → Scraper HLTB: consulta tiempos (evidence: `herramientas/preparar_lote.py`)
- Auditar enlaces → Búsqueda de enlaces: verifica enlaces (evidence: `herramientas/auditar_enlaces.py`)
- Auditar enlaces → Acceso a tabla: lee juegos (evidence: `herramientas/auditar_enlaces.py`)
- Auditar enlaces → Scrapers de tiendas: contrasta tiendas (evidence: `herramientas/auditar_enlaces.py`)
- Ejecución principal → Configuración: lee ajustes (evidence: `ejecutar.py`)
- Ejecución principal → Carga de juegos: carga juegos (evidence: `ejecutar.py`)
- Ejecución principal → Paralelismo juegos: procesa juegos (evidence: `ejecutar.py`)
- Ejecución principal → Guardado y conservación: guarda resultados (evidence: `ejecutar.py`)
- Carga de juegos → Supabase: lee catálogo (evidence: `README.md`)
- Carga de juegos → Respaldo de juegos: usa respaldo (evidence: `README.md`)
- Acceso a tabla → Supabase: lee y escribe (evidence: `herramientas/tabla.py`)
- Paralelismo juegos → Coordinación fuentes: distribuye juegos (evidence: `scraper/nivel1.py`)
- Paralelismo juegos → Límites por sitio: instala límites (evidence: `scraper/nivel1.py`)
- Coordinación fuentes → Scrapers de tiendas: consulta tiendas (evidence: `README.md`)
- Coordinación fuentes → Scraper Metacritic: consulta puntuación (evidence: `README.md`)
- Coordinación fuentes → Scraper HLTB: consulta duración (evidence: `README.md`)
- Coordinación fuentes → Fuentes simuladas: selecciona modo falso (evidence: `scraper/nivel2.py`)
- Scrapers de tiendas → Descarga segura: descarga páginas (evidence: `README.md`)
- Scraper Metacritic → Descarga segura: descarga páginas (evidence: `README.md`)
- Scraper HLTB → Descarga segura: aplica protección (evidence: `scraper/hltb.py`)
- Descarga segura → Límites por sitio: solicita turno (evidence: `scraper/red.py`)
- Fuentes simuladas → Límites por sitio: simula turno (evidence: `scraper/falsos.py`)
- Guardado y conservación → Datos web: escribe JSON (evidence: `README.md`)
- Página de ofertas → Datos web: muestra datos (evidence: `README.md`)
