# victsilva37/golazo-rup architecture

> Architecture diagram of the GitHub repository victsilva37/golazo-rup, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/victsilva37/golazo-rup
- Repository: https://github.com/victsilva37/golazo-rup

## Overview

##### Project type and purpose
- This is a full-stack web application (“golazo-rup”) composed of:
- An Angular single-page application (SPA) in the angular-project directory
- A NestJS REST API backend in the nest-project directory
- A relational database (via TypeORM entities) storing players, categories, and goal statistics
- The domain revolves around “Jugador” (player), “Categoria” (category), and “Estadistica_gol” (goal stats), so the system serves a frontend UI for browsing/managing players and their goal data, while the backend exposes REST endpoints and persists data.

##### File structure
- Top-level directories:
- angular-project/ → Angular client (app/, components/, layouts/, interfaces/)
- nest-project/   → NestJS server (src/app.module.ts; src/{categoria,estadistica_gol,jugador}/ modules, controllers, services, entities)
- documentacion/ → API documentation text file
- Angular side: component-based architecture (each UI widget under src/app/components), global routes in app.routes.ts, and use of interfaces for typing.
- NestJS side: modular structure (one module per domain entity), MVC-style controllers calling services, with entities for ORM mapping.
- Config/build files: angular.json, tsconfig*.json, package.json at each root, .gitignore, ESLint/Prettier configs, nest-cli.json.

##### Detail without overthinking
- NestJS module separately to reflect its distinct entity/service responsibilities.
- Angular folder structure by grouping related components and interfaces.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Angular Client" 
        direction TB
        FE_MainEntry["main.ts"]:::frontend
        FE_Routes["app.routes.ts"]:::frontend
        FE_AppModule["app.ts"]:::frontend
        FE_AppConfig["app.config.ts"]:::frontend
        subgraph Components
            direction TB
            FE_Filtro["filtro-jugador.ts"]:::frontend
            FE_Panel["panel-categorias.ts"]:::frontend
            FE_Header["header.ts"]:::frontend
        end
        subgraph Interfaces
            direction TB
            FE_IF_Cat["Categoria.ts"]:::frontend
            FE_IF_Jug["Jugador.ts"]:::frontend
        end
        FE_Styles["styles.css / index.html"]:::frontend
    end

    %% Backend Layer
    subgraph "NestJS API"
        direction TB
        BE_Main["main.ts"]:::backend
        BE_AppModule["app.module.ts"]:::backend

        subgraph CategoriaModule
            direction TB
            Cat_Controller["categoria.controller.ts"]:::backend
            Cat_Service["categoria.service.ts"]:::backend
            Cat_Entity["categoria.entity.ts"]:::backend
        end

        subgraph JugadorModule
            direction TB
            Jug_Controller["jugador.controller.ts"]:::backend
            Jug_Service["jugador.service.ts"]:::backend
            Jug_Entity["jugador.entity.ts"]:::backend
        end

        subgraph EstadisticaGolModule
            direction TB
            Est_Controller["estadistica_gol.controller.ts"]:::backend
            Est_Service["estadistica_gol.service.ts"]:::backend
            Est_Entity["estadistica_gol.entity.ts"]:::backend
        end
    end

    %% Data and Documentation
    Database[("Database (TypeORM)")]:::db
    Doc["API Documentation"]:::doc

    %% Connections
    FE_MainEntry --> FE_Routes
    FE_Routes --> FE_AppModule
    FE_AppModule --> FE_AppConfig
    FE_AppConfig --> FE_Styles

    FE_Header --> FE_AppModule
    FE_Filtro --> FE_AppModule
    FE_Panel --> FE_AppModule
    FE_IF_Cat --> FE_AppModule
    FE_IF_Jug --> FE_AppModule

    FE_AppModule -->|HTTP/JSON| BE_Main
    BE_Main --> BE_AppModule

    BE_AppModule --> Cat_Controller
    Cat_Controller --> Cat_Service
    Cat_Service --> Cat_Entity
    Cat_Entity --> Database

    BE_AppModule --> Jug_Controller
    Jug_Controller --> Jug_Service
    Jug_Service --> Jug_Entity
    Jug_Entity --> Database

    BE_AppModule --> Est_Controller
    Est_Controller --> Est_Service
    Est_Service --> Est_Entity
    Est_Entity --> Database

    BE_AppModule -.-> Doc

    %% Click Events
    click FE_MainEntry "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/main.ts"
    click FE_Routes "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/app.routes.ts"
    click FE_AppModule "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/app.ts"
    click FE_AppConfig "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/app.config.ts"
    click FE_Filtro "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/components/filtro-jugador/filtro-jugador.ts"
    click FE_Panel "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/components/panel-categorias/panel-categorias.ts"
    click FE_Header "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/layouts/header/header.ts"
    click FE_IF_Cat "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/interfaces/Categoria.ts"
    click FE_IF_Jug "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/app/interfaces/Jugador.ts"
    click FE_Styles "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/styles.css"
    click FE_Styles "https://github.com/victsilva37/golazo-rup/blob/main/angular-project/src/index.html"
    click BE_Main "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/main.ts"
    click BE_AppModule "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/app.module.ts"
    click Cat_Controller "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/categoria/categoria.controller.ts"
    click Cat_Service "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/categoria/categoria.service.ts"
    click Cat_Entity "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/categoria/categoria.entity.ts"
    click Jug_Controller "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/jugador/jugador.controller.ts"
    click Jug_Service "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/jugador/jugador.service.ts"
    click Jug_Entity "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/jugador/jugador.entity.ts"
    click Est_Controller "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/estadistica_gol/estadistica_gol.controller.ts"
    click Est_Service "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/estadistica_gol/estadistica_gol.service.ts"
    click Est_Entity "https://github.com/victsilva37/golazo-rup/blob/main/nest-project/src/estadistica_gol/estadistica_gol.entity.ts"
    click Doc "https://github.com/victsilva37/golazo-rup/blob/main/documentacion/api_document.txt"

    %% Styling
    classDef frontend fill:#bbdefb,stroke:#0d47a1,color:#0d47a1;
    classDef backend fill:#c8e6c9,stroke:#1b5e20,color:#1b5e20;
    classDef db fill:#ffe0b2,stroke:#e65100,color:#e65100;
    classDef doc fill:#eceff1,stroke:#607d8b,color:#607d8b;
```
