# pdaw-proyectos/pdaw-2026-proyfinal-g08 architecture

> Architecture diagram of the GitHub repository pdaw-proyectos/pdaw-2026-proyfinal-g08, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pdaw-proyectos/pdaw-2026-proyfinal-g08
- Repository: https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08

## Overview

Orsai combines football scores, schedules, league standings and team details with a community platform for registered fans. The football workflow is assembled at startup: repositories and services are wired into the HTTP app, whose routes expose league, match and team operations; background synchronization loads football data from TheSportsDB. A separate community app handles accounts and, per the README, forum, profiles, store and administration. The browser has corresponding football and community views. Community internals and several routes were not sampled, so those capabilities are shown without speculative internal call chains.

Main entry points: [`src/server.js`](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/server.js) (Server startup), [`src/app.js`](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/app.js) (HTTP app), [`public/js/main.js`](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/main.js) (Browser entry), [`src/routes/auth.routes.js`](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/routes/auth.routes.js) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and HTTP"]
  node_server["Server startup<br/>[server.js]"]
  node_http["HTTP app<br/>[app.js]"]
  node_authroutes["Auth routes<br/>[auth.routes.js]"]
  node_authcontroller["Auth controller<br/>[auth.controller.js]"]
  node_authmiddleware["Session middleware<br/>[auth.middleware.js]"]
  node_leaguecontroller["League controller"]
  node_matchcontroller["Match controller"]
  node_teamcontroller["Team controller"]
end

subgraph group_football["Football data"]
  node_leagueflow["League service<br/>[ligas.service.js]"]
  node_matchflow["Match service"]
  node_teamflow["Team service<br/>[equipos.service.js]"]
  node_leagues[("League repository<br/>[LigasRepository.js]")]
  node_matches[("Match repository")]
  node_teams[("Team repository")]
  node_sync["Data synchronization"]
  node_sportsapi["Football API client"]
end

subgraph group_community["Community platform"]
  node_communityapp["Community app<br/>[app.js]"]
  node_users[("User store<br/>[users.js]")]
  node_communitydata[("Community repository")]
  node_settings[("Admin settings")]
end

subgraph group_browser["Browser experience"]
  node_browsermain["Browser entry<br/>[main.js]"]
  node_footballviews["Football views<br/>[partidos.js]"]
  node_teamview["Team view<br/>[equipo.js]"]
  node_leagueview["League view<br/>[ligas.js]"]
  node_searchview["Search view<br/>[buscador.js]"]
  node_authview["Account view<br/>[auth.js]"]
  node_communityviews["Community views<br/>[foro.js]"]
  node_storeview["Store view<br/>[tienda.js]"]
  node_profileview["Profile view<br/>[perfil.js]"]
  node_adminview["Admin view<br/>[admin.js]"]
end

node_fan(("Fan"))
node_externalapi{{"TheSportsDB"}}

node_server -->|"creates"| node_http
node_server -->|"wires"| node_leagueflow
node_server -->|"wires"| node_matchflow
node_server -->|"wires"| node_teamflow
node_server -->|"creates"| node_leagues
node_server -->|"creates"| node_matches
node_server -->|"creates"| node_teams
node_server -->|"creates"| node_sportsapi
node_server -->|"starts sync"| node_sync
node_server -->|"creates"| node_communityapp
node_server -->|"creates"| node_users
node_server -->|"creates"| node_communitydata
node_server -->|"creates"| node_settings
node_http -->|"mounts"| node_authroutes
node_http -.->|"routes via"| node_leaguecontroller
node_http -.->|"routes via"| node_matchcontroller
node_http -.->|"routes via"| node_teamcontroller
node_http -->|"mounts"| node_communityapp
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"guards"| node_authmiddleware
node_browsermain -->|"imports"| node_searchview
node_browsermain -->|"imports"| node_authview
node_browsermain -->|"imports"| node_leagueview
node_browsermain -->|"imports"| node_teamview
node_browsermain -.->|"imports"| node_footballviews
node_fan -.->|"uses"| node_browsermain
node_sportsapi -.->|"requests data"| node_externalapi

click node_server "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/server.js"
click node_http "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/app.js"
click node_authroutes "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/routes/auth.routes.js"
click node_authcontroller "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/auth.controller.js"
click node_authmiddleware "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/middlewares/auth.middleware.js"
click node_leaguecontroller "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/ligas.controller.js"
click node_matchcontroller "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/partidos.controller.js"
click node_teamcontroller "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/equipos.controller.js"
click node_leagueflow "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/ligas.service.js"
click node_matchflow "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/partidos.service.js"
click node_teamflow "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/equipos.service.js"
click node_leagues "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/repositories/LigasRepository.js"
click node_matches "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/repositories/PartidosRepository.js"
click node_teams "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/repositories/EquiposRepository.js"
click node_sync "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/sincronizacion.service.js"
click node_sportsapi "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/apiFutbol.service.js"
click node_communityapp "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/app.js"
click node_users "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/Usuarios/users.js"
click node_communitydata "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/Comunidad/RepositorioComunidad.js"
click node_settings "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/Configuracion/RepositorioConfiguracion.js"
click node_browsermain "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/main.js"
click node_footballviews "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/partidos.js"
click node_teamview "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/equipo.js"
click node_leagueview "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/ligas.js"
click node_searchview "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/buscador.js"
click node_authview "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/auth.js"
click node_communityviews "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/foro.js"
click node_storeview "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/tienda.js"
click node_profileview "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/perfil.js"
click node_adminview "https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/admin.js"

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_server,node_http,node_authroutes,node_authcontroller,node_authmiddleware,node_leaguecontroller,node_matchcontroller,node_teamcontroller toneBlue
class node_leagueflow,node_matchflow,node_teamflow,node_leagues,node_matches,node_teams,node_sync,node_sportsapi toneAmber
class node_communityapp,node_users,node_communitydata,node_settings toneMint
class node_browsermain,node_footballviews,node_teamview,node_leagueview,node_searchview,node_authview,node_communityviews,node_storeview,node_profileview,node_adminview toneRose
class node_fan,node_externalapi toneIndigo
```

## Components

### Runtime and HTTP

- [Server startup](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/server.js): `src/server.js`
- [HTTP app](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/app.js): `src/app.js`
- [Auth routes](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [Auth controller](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/auth.controller.js): `src/controllers/auth.controller.js`
- [Session middleware](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/middlewares/auth.middleware.js): `src/middlewares/auth.middleware.js`
- [League controller](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/ligas.controller.js): `src/controllers/ligas.controller.js`
- [Match controller](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/partidos.controller.js): `src/controllers/partidos.controller.js`
- [Team controller](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/controllers/equipos.controller.js): `src/controllers/equipos.controller.js`

### Football data

- [League service](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/ligas.service.js): `src/services/ligas.service.js`
- [Match service](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/partidos.service.js): `src/services/partidos.service.js`
- [Team service](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/equipos.service.js): `src/services/equipos.service.js`
- [League repository](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/repositories/LigasRepository.js): `src/repositories/LigasRepository.js`
- [Match repository](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/repositories/PartidosRepository.js): `src/repositories/PartidosRepository.js`
- [Team repository](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/repositories/EquiposRepository.js): `src/repositories/EquiposRepository.js`
- [Data synchronization](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/sincronizacion.service.js): `src/services/sincronizacion.service.js`
- [Football API client](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/services/apiFutbol.service.js): `src/services/apiFutbol.service.js`

### Community platform

- [Community app](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/app.js): `src/js/app.js`
- [User store](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/Usuarios/users.js): `src/js/Usuarios/users.js`
- [Community repository](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/Comunidad/RepositorioComunidad.js): `src/js/Comunidad/RepositorioComunidad.js`
- [Admin settings](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/src/js/Configuracion/RepositorioConfiguracion.js): `src/js/Configuracion/RepositorioConfiguracion.js`

### Browser experience

- [Browser entry](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/main.js): `public/js/main.js`
- [Football views](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/partidos.js): `public/js/partidos.js`
- [Team view](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/equipo.js): `public/js/equipo.js`
- [League view](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/ligas.js): `public/js/ligas.js`
- [Search view](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/buscador.js): `public/js/buscador.js`
- [Account view](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/auth.js): `public/js/auth.js`
- [Community views](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/foro.js): `public/js/foro.js`
- [Store view](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/tienda.js): `public/js/tienda.js`
- [Profile view](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/perfil.js): `public/js/perfil.js`
- [Admin view](https://github.com/pdaw-proyectos/pdaw-2026-proyfinal-g08/blob/main/public/js/admin.js): `public/js/admin.js`

### Other components

- **Fan**
- **TheSportsDB**

## Connections

- Server startup → HTTP app: creates (evidence: `src/server.js`)
- Server startup → League service: wires (evidence: `src/server.js`)
- Server startup → Match service: wires (evidence: `src/server.js`)
- Server startup → Team service: wires (evidence: `src/server.js`)
- Server startup → League repository: creates (evidence: `src/server.js`)
- Server startup → Match repository: creates (evidence: `src/server.js`)
- Server startup → Team repository: creates (evidence: `src/server.js`)
- Server startup → Football API client: creates (evidence: `src/server.js`)
- Server startup → Data synchronization: starts sync (evidence: `src/server.js`)
- Server startup → Community app: creates (evidence: `src/server.js`)
- Server startup → User store: creates (evidence: `src/server.js`)
- Server startup → Community repository: creates (evidence: `src/server.js`)
- Server startup → Admin settings: creates (evidence: `src/server.js`)
- HTTP app → Auth routes: mounts (evidence: `src/app.js`)
- HTTP app → League controller: routes via
- HTTP app → Match controller: routes via
- HTTP app → Team controller: routes via
- HTTP app → Community app: mounts (evidence: `src/app.js`)
- Auth routes → Auth controller: dispatches (evidence: `src/routes/auth.routes.js`)
- Auth routes → Session middleware: guards (evidence: `src/routes/auth.routes.js`)
- Browser entry → Search view: imports (evidence: `public/js/main.js`)
- Browser entry → Account view: imports (evidence: `public/js/main.js`)
- Browser entry → League view: imports (evidence: `public/js/main.js`)
- Browser entry → Team view: imports (evidence: `public/js/main.js`)
- Browser entry → Football views: imports
- Fan → Browser entry: uses
- Football API client → TheSportsDB: requests data
