# esmogg/starleague architecture

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

## Overview

StarLeague is a modular sports, mental-sports, and esports tournament-management web platform. Its visible workflows cover account registration and login, team creation, tournament creation and browsing, and participant registration; tournament creation and enrollment are distinct stages. The sampled code shows browser forms calling PHP endpoints, with tournament and team endpoints using MySQL access. Some listed capabilities—especially login, team search, and tournament display—are represented in the tree but their implementation was not sampled, so their internal links are omitted where unverified.

Main entry points: [`php/conexion.php`](https://github.com/esmogg/starleague/blob/main/php/conexion.php) (MySQL connection), [`php/equipos/crear_equipos.php`](https://github.com/esmogg/starleague/blob/main/php/equipos/crear_equipos.php) (Team creation endpoint), [`php/torneos/crear_torneos.php`](https://github.com/esmogg/starleague/blob/main/php/torneos/crear_torneos.php) (Tournament creation endpoint), [`js/torneos/crear-torneos.js`](https://github.com/esmogg/starleague/blob/main/js/torneos/crear-torneos.js) (Tournament creation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_login_pages["Login pages"]
  node_register_page["Registration page<br/>[register.html]"]
  node_team_pages["Team pages"]
  node_tournament_pages["Tournament pages"]
  node_public_tournament_pages["Public tournament pages"]
  node_shared_ui["Shared UI behavior<br/>[script.js]"]
end

subgraph group_accounts["Accounts"]
  node_login_handler["Login handler<br/>[login.php]"]
  node_registration_client["Registration client<br/>[register.js]"]
  node_registration_handler["User registration<br/>[crear_usuario.php]"]
end

subgraph group_teams["Teams"]
  node_team_creation_client["Team creation<br/>[crear-equipos.js]"]
  node_team_search["Team search<br/>[buscar-equipos.js]"]
  node_team_endpoint["Team creation endpoint<br/>[crear_equipos.php]"]
end

subgraph group_tournaments["Tournaments"]
  node_tournament_catalogs["Tournament catalogs<br/>[catalogos.js]"]
  node_tournament_creation_client["Tournament creation<br/>[crear-torneos.js]"]
  node_tournament_endpoint["Tournament creation endpoint<br/>[crear_torneos.php]"]
  node_tournament_browse["Tournament browsing<br/>[ver-torneos.js]"]
  node_tournament_display["Tournament display<br/>[mostrar.js]"]
  node_tournament_feed["Tournament listing endpoint"]
  node_candidate_lookup["Participant candidates"]
  node_enrollment["Tournament enrollment"]
end

subgraph group_persistence["Persistence"]
  node_database_schema[("MySQL schema<br/>[starleague_BD.sql]")]
  node_mysqli_connection["MySQL connection<br/>[conexion.php]"]
end

node_visitor(("User"))

node_visitor -->|"uses"| node_login_pages
node_visitor -->|"uses"| node_register_page
node_visitor -->|"manages teams"| node_team_pages
node_visitor -->|"manages tournaments"| node_tournament_pages
node_visitor -->|"browses tournaments"| node_public_tournament_pages
node_registration_client -->|"posts JSON"| node_registration_handler
node_team_creation_client -->|"posts form data"| node_team_endpoint
node_team_endpoint -->|"includes"| node_mysqli_connection
node_tournament_creation_client -->|"reads catalogs"| node_tournament_catalogs
node_tournament_creation_client -->|"posts tournament"| node_tournament_endpoint
node_tournament_endpoint -->|"includes"| node_mysqli_connection
node_tournament_endpoint -.->|"writes tournament"| node_database_schema
node_team_endpoint -.->|"writes team"| node_database_schema
node_enrollment -->|"requires"| node_mysqli_connection
node_tournament_feed -->|"requires"| node_mysqli_connection
node_candidate_lookup -->|"requires"| node_mysqli_connection

click node_login_pages "https://github.com/esmogg/starleague/tree/main/html/nologin/usuario"
click node_register_page "https://github.com/esmogg/starleague/blob/main/html/nologin/usuario/register.html"
click node_team_pages "https://github.com/esmogg/starleague/tree/main/html/login/equipos"
click node_tournament_pages "https://github.com/esmogg/starleague/tree/main/html/login/torneos"
click node_public_tournament_pages "https://github.com/esmogg/starleague/tree/main/html/nologin/torneos"
click node_shared_ui "https://github.com/esmogg/starleague/blob/main/js/script.js"
click node_login_handler "https://github.com/esmogg/starleague/blob/main/php/auth/login.php"
click node_registration_client "https://github.com/esmogg/starleague/blob/main/js/usuario/register.js"
click node_registration_handler "https://github.com/esmogg/starleague/blob/main/php/auth/crear_usuario.php"
click node_team_creation_client "https://github.com/esmogg/starleague/blob/main/js/equipos/crear-equipos.js"
click node_team_search "https://github.com/esmogg/starleague/blob/main/js/equipos/buscar-equipos.js"
click node_team_endpoint "https://github.com/esmogg/starleague/blob/main/php/equipos/crear_equipos.php"
click node_tournament_catalogs "https://github.com/esmogg/starleague/blob/main/js/torneos/catalogos.js"
click node_tournament_creation_client "https://github.com/esmogg/starleague/blob/main/js/torneos/crear-torneos.js"
click node_tournament_endpoint "https://github.com/esmogg/starleague/blob/main/php/torneos/crear_torneos.php"
click node_tournament_browse "https://github.com/esmogg/starleague/blob/main/js/torneos/ver-torneos.js"
click node_tournament_display "https://github.com/esmogg/starleague/blob/main/js/torneos/mostrar.js"
click node_tournament_feed "https://github.com/esmogg/starleague/blob/main/php/torneos/obtener_torneos.php"
click node_candidate_lookup "https://github.com/esmogg/starleague/blob/main/php/torneos/obtener_candidatos.php"
click node_enrollment "https://github.com/esmogg/starleague/blob/main/php/torneos/procesar_inscripcion.php"
click node_database_schema "https://github.com/esmogg/starleague/blob/main/database/starleague_BD.sql"
click node_mysqli_connection "https://github.com/esmogg/starleague/blob/main/php/conexion.php"

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_login_pages,node_register_page,node_team_pages,node_tournament_pages,node_public_tournament_pages,node_shared_ui,node_visitor toneBlue
class node_login_handler,node_registration_client,node_registration_handler toneAmber
class node_team_creation_client,node_team_search,node_team_endpoint toneMint
class node_tournament_catalogs,node_tournament_creation_client,node_tournament_endpoint,node_tournament_browse,node_tournament_display,node_tournament_feed,node_candidate_lookup,node_enrollment toneRose
class node_database_schema,node_mysqli_connection toneIndigo
```

## Components

### Web interface

- [Login pages](https://github.com/esmogg/starleague/tree/main/html/nologin/usuario): `html/nologin/usuario`
- [Registration page](https://github.com/esmogg/starleague/blob/main/html/nologin/usuario/register.html): `html/nologin/usuario/register.html`
- [Team pages](https://github.com/esmogg/starleague/tree/main/html/login/equipos): `html/login/equipos`
- [Tournament pages](https://github.com/esmogg/starleague/tree/main/html/login/torneos): `html/login/torneos`
- [Public tournament pages](https://github.com/esmogg/starleague/tree/main/html/nologin/torneos): `html/nologin/torneos`
- [Shared UI behavior](https://github.com/esmogg/starleague/blob/main/js/script.js): `js/script.js`

### Accounts

- [Login handler](https://github.com/esmogg/starleague/blob/main/php/auth/login.php): `php/auth/login.php`
- [Registration client](https://github.com/esmogg/starleague/blob/main/js/usuario/register.js): `js/usuario/register.js`
- [User registration](https://github.com/esmogg/starleague/blob/main/php/auth/crear_usuario.php): `php/auth/crear_usuario.php`

### Teams

- [Team creation](https://github.com/esmogg/starleague/blob/main/js/equipos/crear-equipos.js): `js/equipos/crear-equipos.js`
- [Team search](https://github.com/esmogg/starleague/blob/main/js/equipos/buscar-equipos.js): `js/equipos/buscar-equipos.js`
- [Team creation endpoint](https://github.com/esmogg/starleague/blob/main/php/equipos/crear_equipos.php): `php/equipos/crear_equipos.php`

### Tournaments

- [Tournament catalogs](https://github.com/esmogg/starleague/blob/main/js/torneos/catalogos.js): `js/torneos/catalogos.js`
- [Tournament creation](https://github.com/esmogg/starleague/blob/main/js/torneos/crear-torneos.js): `js/torneos/crear-torneos.js`
- [Tournament creation endpoint](https://github.com/esmogg/starleague/blob/main/php/torneos/crear_torneos.php): `php/torneos/crear_torneos.php`
- [Tournament browsing](https://github.com/esmogg/starleague/blob/main/js/torneos/ver-torneos.js): `js/torneos/ver-torneos.js`
- [Tournament display](https://github.com/esmogg/starleague/blob/main/js/torneos/mostrar.js): `js/torneos/mostrar.js`
- [Tournament listing endpoint](https://github.com/esmogg/starleague/blob/main/php/torneos/obtener_torneos.php): `php/torneos/obtener_torneos.php`
- [Participant candidates](https://github.com/esmogg/starleague/blob/main/php/torneos/obtener_candidatos.php): `php/torneos/obtener_candidatos.php`
- [Tournament enrollment](https://github.com/esmogg/starleague/blob/main/php/torneos/procesar_inscripcion.php): `php/torneos/procesar_inscripcion.php`

### Persistence

- [MySQL schema](https://github.com/esmogg/starleague/blob/main/database/starleague_BD.sql): `database/starleague_BD.sql`
- [MySQL connection](https://github.com/esmogg/starleague/blob/main/php/conexion.php): `php/conexion.php`

### Other components

- **User**

## Connections

- User → Login pages: uses (evidence: `README.md`)
- User → Registration page: uses (evidence: `README.md`)
- User → Team pages: manages teams (evidence: `README.md`)
- User → Tournament pages: manages tournaments (evidence: `README.md`)
- User → Public tournament pages: browses tournaments (evidence: `README.md`)
- Registration client → User registration: posts JSON (evidence: `js/usuario/register.js`)
- Team creation → Team creation endpoint: posts form data (evidence: `js/equipos/crear-equipos.js`)
- Team creation endpoint → MySQL connection: includes (evidence: `php/equipos/crear_equipos.php`)
- Tournament creation → Tournament catalogs: reads catalogs (evidence: `js/torneos/crear-torneos.js`)
- Tournament creation → Tournament creation endpoint: posts tournament (evidence: `js/torneos/crear-torneos.js`)
- Tournament creation endpoint → MySQL connection: includes (evidence: `php/torneos/crear_torneos.php`)
- Tournament creation endpoint → MySQL schema: writes tournament
- Team creation endpoint → MySQL schema: writes team
- Tournament enrollment → MySQL connection: requires (evidence: `php/torneos/procesar_inscripcion.php`)
- Tournament listing endpoint → MySQL connection: requires (evidence: `php/torneos/obtener_torneos.php`)
- Participant candidates → MySQL connection: requires (evidence: `php/torneos/obtener_candidatos.php`)
