# alfredyael01/gestion-esport-main architecture

> Architecture diagram of the GitHub repository alfredyael01/gestion-esport-main, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alfredyael01/gestion-esport-main
- Repository: https://github.com/alfredyael01/gestion-esport-main

## Overview

##### Project type and purpose
- This is a full-stack, client–server Java application for managing an e-sport competition season.
- The “both” package holds shared domain types and network message definitions.
- The “client” module implements an MVC-style Swing GUI that communicates with the server over TCP (Netty).
- The “server” module hosts a Netty-based socket server, processes client commands, and persists data in a relational database via JDBC.

##### Top-level architecture components
a. Client Application
- View layer (com.esporter.client.vue + subpackages) – Swing UIs (home, calendar, ranking, stable management, error dialogs, custom components).
- Controller layer (com.esporter.client.controleur) – event handlers, input validation, orchestrates UI updates.
- Client model / networking (com.esporter.client.model.user) – NettyClient, CommunicationServer, ClientProcessingHandler encapsulate socket setup and asynchronous I/O.
b. Shared Domain (com.esporter.both)
- Data.java – core data structures.
- Command, Response, ResponseObject – message envelopes.
- Types.* – all application message payloads (login, team, tournament, match, etc.).
c. Server Application
- Network layer (com.esporter.server.main) – NettyServer bootstraps, ConnectionClient wraps channels, ProcessingHandler decodes messages, mainThread orchestrates request handling.
- Service / business logic – runs in ProcessingHandler/mainThread, applies rules (e.g. permission checks, tournament full exceptions).
- Persistence layer (com.esporter.server.model.database) – DatabaseAccess (JDBC), Query builder, QueueDatabase (threaded request queue), Result wrappers.
d. Database
- External RDBMS (MySQL/PostgreSQL) configured via JDBC in DatabaseAccess.

##### Relationships and data flows
- The UI emits events → Controller invokes ClientProcessingHandler to serialize a Command using shared Types.
- NettyClient sends Command → arrives at NettyServer → ProcessingHandler decodes into CommandName + payload.
- ProcessingHandler/mainThread executes business logic → queries DatabaseAccess → builds ResponseObject.
- NettyServer sends Response back over the channel → ClientProcessingHandler decodes into Response → controller updates the View.

##### Architectural patterns and design principles
- MVC in the client (clean separation of View, Controller, Model).
- Shared domain objects in a “both” package to ensure client & server use identical message schemas (DRY).
- Layered server architecture: Network → Service → Persistence.
- Asynchronous, event-driven I/O using Netty for high concurrency.
- Repository/DAO pattern in DatabaseAccess to isolate SQL logic.

##### Checklist
– Notes on key frameworks/libraries next to each component.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Application Layer
    subgraph "Client Application"
        subgraph "Client View Layer"
            CV["Swing UIs (Home, Calendar, Ranking, StableMgmt)"]:::frontend
        end
        subgraph "Client Controller Layer"
            CC["Controllers & Event Handlers"]:::frontend
        end
        subgraph "Client Networking"
            CPH["ClientProcessingHandler"]:::network
            NC["NettyClient (TCP 8080)"]:::network
        end
    end

    %% Shared Domain
    subgraph "Shared Domain"
        SD["Data.java"]:::shared
        SM["Socket Messages (Command, Response)"]:::shared
        ST["Types (login, team, tournament, match)"]:::shared
    end

    %% Server Application Layer
    subgraph "Server Application"
        subgraph "Server Network Layer"
            NS["NettyServer (boss/workers)"]:::server
            CCli["ConnectionClient"]:::server
            PH["ProcessingHandler"]:::server
            RT["mainThread"]:::server
        end
        SR["Run.java"]:::server
        MI["Main.java"]:::server
        subgraph "Persistence Layer"
            DA["DatabaseAccess (JDBC)"]:::server
            QB["QueryBuilder"]:::server
            QDB["QueueDatabase"]:::server
            RW["Result Wrappers"]:::server
        end
    end

    %% Database
    DB[(External RDBMS)]:::db

    %% Data Flows
    CV -->|"UI Event"| CC
    CC -->|"Command<TypesXYZ>"| CPH
    CPH -->|"send Command"| NC
    NC ---|TCP 8080| NS
    NS -->|"decoded Command"| PH
    PH -->|"exec business logic"| RT
    PH -->|"DB Query"| DA
    DA -->|"SQL via JDBC"| DB
    DB -->|"ResultSet"| DA
    DA -->|"ResponseObject<TypesXYZ>"| PH
    PH -->|"send Response"| NS
    NS ---|TCP 8080| NC
    NC -->|"decoded Response"| CPH
    CPH -->|"Response<TypesXYZ>"| CC
    CC -->|"update View"| CV

    %% Shared Domain Usage
    CPH -- uses --> SD
    CPH -- uses --> SM
    CPH -- uses --> ST
    PH -- uses --> SD
    PH -- uses --> SM
    PH -- uses --> ST

    %% Click Events
    click CV "https://github.com/alfredyael01/gestion-esport-main/tree/main/Esporter/src/com/esporter/client/vue"
    click CC "https://github.com/alfredyael01/gestion-esport-main/tree/main/Esporter/src/com/esporter/client/controleur"
    click CPH "https://github.com/alfredyael01/gestion-esport-main/tree/main/Esporter/src/com/esporter/client/model/user"
    click SD "https://github.com/alfredyael01/gestion-esport-main/blob/main/Esporter/src/com/esporter/both/data/Data.java"
    click SM "https://github.com/alfredyael01/gestion-esport-main/tree/main/Esporter/src/com/esporter/both/socket"
    click ST "https://github.com/alfredyael01/gestion-esport-main/tree/main/Esporter/src/com/esporter/both/types"
    click NS "https://github.com/alfredyael01/gestion-esport-main/tree/main/Esporter/src/com/esporter/server/main"
    click SR "https://github.com/alfredyael01/gestion-esport-main/blob/main/Esporter/src/com/esporter/server/main/Run.java"
    click MI "https://github.com/alfredyael01/gestion-esport-main/blob/main/Esporter/src/com/esporter/server/Main.java"
    click DA "https://github.com/alfredyael01/gestion-esport-main/tree/main/Esporter/src/com/esporter/server/model/database"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0366d6,color:#0366d6;
    classDef network fill:#E8F0FE,stroke:#6aafe6,color:#034f84;
    classDef shared fill:#F0F0F0,stroke:#888888,color:#555555;
    classDef server fill:#E6F4EA,stroke:#2c8a37,color:#27632a;
    classDef db fill:#FFE7D6,stroke:#d2691e,color:#a64200;
```
