# nafis37/buet_premier_league architecture

> Architecture diagram of the GitHub repository nafis37/buet_premier_league, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nafis37/buet_premier_league
- Repository: https://github.com/nafis37/buet_premier_league

## Overview

BUET Premier League is a JavaFX desktop league manager with socket-backed text-file persistence and team group chat. Admins schedule fixtures and record results; teams manage and scout squads, view standings and chat; players register, view stats and chat after signing. The graph follows documented capabilities, but some controller and server internals were not excerpted, so uncertain links are omitted or marked unverified.

Main entry points: [`src/main/java/application/network/FileClient.java`](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/FileClient.java) (File client API), [`src/main/java/application/controller/UpdateResultController.java`](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/UpdateResultController.java) (Result entry), [`src/main/java/application/network/Client.java`](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/Client.java) (Chat client), [`src/main/java/application/controller/AdminDashboardController.java`](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/AdminDashboardController.java) (League dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_app["JavaFX application<br/>[Main.java]"]
  node_navigation["Screen navigation<br/>[Navigator.java]"]
  node_session["Login session<br/>[Session.java]"]
end

subgraph group_league["League operations"]
  node_admin["Admin access"]
  node_dashboard["League dashboard"]
  node_fixtures["Fixture scheduling"]
  node_results["Result entry"]
  node_standings["Points table<br/>[LeagueTables.java]"]
end

subgraph group_people["Player and team"]
  node_team_access["Team access"]
  node_team_home["Team overview"]
  node_scouting["Player scouting"]
  node_search["Player search"]
  node_team_matches["Team fixtures"]
  node_player_register["Player registration"]
  node_player_profile["Player profile"]
  node_chat_ui["Chat session UI<br/>[ChatSession.java]"]
end

subgraph group_transport["Socket services"]
  node_chat_client["Chat client<br/>[Client.java]"]
  node_chat_server["Team chat server"]
  node_file_client["File client API<br/>[FileClient.java]"]
  node_file_server["File manager server"]
  node_file_handler["File request handler"]
  node_socket["Serialized socket<br/>[SocketWrapper.java]"]
end

subgraph group_state["League state"]
  node_config["Ports and data paths<br/>[AppConfig.java]"]
  node_player_record["Player records<br/>[Player.java]"]
  node_match_record["Match records<br/>[Match.java]"]
  node_points_record["Points records<br/>[Points.java]"]
  node_text_data[("CSV data files")]
end

node_user(("Admin, team, player"))

node_user -->|"uses"| node_app
node_app -->|"opens screens"| node_navigation
node_admin -->|"authenticates via"| node_file_client
node_team_access -->|"authenticates via"| node_file_client
node_team_access -->|"sets login"| node_session
node_player_register -->|"saves player"| node_file_client
node_player_profile -->|"loads record"| node_file_client
node_player_profile -->|"sets player"| node_session
node_dashboard -->|"reads league data"| node_file_client
node_dashboard -->|"builds table"| node_standings
node_fixtures -.->|"persists fixtures"| node_file_client
node_results -->|"updates records"| node_file_client
node_results -->|"credits goals"| node_player_record
node_results -->|"records result"| node_match_record
node_results -->|"updates standings"| node_points_record
node_team_home -->|"loads squad"| node_file_client
node_scouting -->|"finds unsigned players"| node_file_client
node_search -->|"searches players"| node_file_client
node_team_matches -->|"loads fixtures"| node_file_client
node_team_matches -->|"renders table"| node_standings
node_chat_ui -->|"sends and receives"| node_chat_client
node_chat_client -->|"exchanges messages"| node_chat_server
node_file_client -->|"sends requests"| node_file_server
node_file_server -->|"dispatches clients"| node_file_handler
node_file_handler -->|"reads and writes"| node_text_data
node_file_client -->|"serializes requests"| node_socket
node_chat_client -->|"exchanges objects"| node_socket
node_file_client -->|"uses endpoint"| node_config
node_chat_ui -->|"uses endpoint"| node_config

click node_app "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/Main.java"
click node_navigation "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/Navigator.java"
click node_session "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/Session.java"
click node_admin "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/AdminLoginController.java"
click node_dashboard "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/AdminDashboardController.java"
click node_fixtures "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/AddMatchController.java"
click node_results "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/UpdateResultController.java"
click node_standings "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/LeagueTables.java"
click node_team_access "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/TeamLoginController.java"
click node_team_home "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/TeamViewController.java"
click node_scouting "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/ScoutController.java"
click node_search "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/SearchController.java"
click node_team_matches "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/UpcomingMatchesController.java"
click node_player_register "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/PlayerRegistrationController.java"
click node_player_profile "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/PlayerViewController.java"
click node_chat_ui "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/ChatSession.java"
click node_chat_client "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/Client.java"
click node_chat_server "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/GroupChatServer.java"
click node_file_client "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/FileClient.java"
click node_file_server "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/FileManagerServer.java"
click node_file_handler "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/FileServerReadThread.java"
click node_socket "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/SocketWrapper.java"
click node_config "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/config/AppConfig.java"
click node_player_record "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/model/Player.java"
click node_match_record "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/model/Match.java"
click node_points_record "https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/model/Points.java"
click node_text_data "https://github.com/nafis37/buet_premier_league/tree/main/data"

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_app,node_navigation,node_session toneBlue
class node_admin,node_dashboard,node_fixtures,node_results,node_standings toneAmber
class node_team_access,node_team_home,node_scouting,node_search,node_team_matches,node_player_register,node_player_profile,node_chat_ui toneMint
class node_chat_client,node_chat_server,node_file_client,node_file_server,node_file_handler,node_socket toneRose
class node_config,node_player_record,node_match_record,node_points_record,node_text_data,node_user toneIndigo
```

## Components

### Desktop client

- [JavaFX application](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/Main.java): `src/main/java/application/Main.java`
- [Screen navigation](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/Navigator.java): `src/main/java/application/util/Navigator.java`
- [Login session](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/Session.java): `src/main/java/application/util/Session.java`

### League operations

- [Admin access](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/AdminLoginController.java): `src/main/java/application/controller/AdminLoginController.java`
- [League dashboard](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/AdminDashboardController.java): `src/main/java/application/controller/AdminDashboardController.java`
- [Fixture scheduling](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/AddMatchController.java): `src/main/java/application/controller/AddMatchController.java`
- [Result entry](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/UpdateResultController.java): `src/main/java/application/controller/UpdateResultController.java`
- [Points table](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/LeagueTables.java): `src/main/java/application/util/LeagueTables.java`

### Player and team

- [Team access](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/TeamLoginController.java): `src/main/java/application/controller/TeamLoginController.java`
- [Team overview](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/TeamViewController.java): `src/main/java/application/controller/TeamViewController.java`
- [Player scouting](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/ScoutController.java): `src/main/java/application/controller/ScoutController.java`
- [Player search](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/SearchController.java): `src/main/java/application/controller/SearchController.java`
- [Team fixtures](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/UpcomingMatchesController.java): `src/main/java/application/controller/UpcomingMatchesController.java`
- [Player registration](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/PlayerRegistrationController.java): `src/main/java/application/controller/PlayerRegistrationController.java`
- [Player profile](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/controller/PlayerViewController.java): `src/main/java/application/controller/PlayerViewController.java`
- [Chat session UI](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/util/ChatSession.java): `src/main/java/application/util/ChatSession.java`

### Socket services

- [Chat client](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/Client.java): `src/main/java/application/network/Client.java`
- [Team chat server](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/GroupChatServer.java): `src/main/java/application/network/GroupChatServer.java`
- [File client API](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/FileClient.java): `src/main/java/application/network/FileClient.java`
- [File manager server](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/FileManagerServer.java): `src/main/java/application/network/FileManagerServer.java`
- [File request handler](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/FileServerReadThread.java): `src/main/java/application/network/FileServerReadThread.java`
- [Serialized socket](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/network/SocketWrapper.java): `src/main/java/application/network/SocketWrapper.java`

### League state

- [Ports and data paths](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/config/AppConfig.java): `src/main/java/application/config/AppConfig.java`
- [Player records](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/model/Player.java): `src/main/java/application/model/Player.java`
- [Match records](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/model/Match.java): `src/main/java/application/model/Match.java`
- [Points records](https://github.com/nafis37/buet_premier_league/blob/main/src/main/java/application/model/Points.java): `src/main/java/application/model/Points.java`
- [CSV data files](https://github.com/nafis37/buet_premier_league/tree/main/data): `data`

### Other components

- **Admin, team, player**

## Connections

- Admin, team, player → JavaFX application: uses (evidence: `README.md`)
- JavaFX application → Screen navigation: opens screens (evidence: `src/main/java/application/Main.java`)
- Admin access → File client API: authenticates via (evidence: `src/main/java/application/controller/AdminLoginController.java`)
- Team access → File client API: authenticates via (evidence: `src/main/java/application/controller/TeamLoginController.java`)
- Team access → Login session: sets login (evidence: `src/main/java/application/controller/TeamLoginController.java`)
- Player registration → File client API: saves player (evidence: `src/main/java/application/controller/PlayerRegistrationController.java`)
- Player profile → File client API: loads record (evidence: `src/main/java/application/controller/PlayerViewController.java`)
- Player profile → Login session: sets player (evidence: `src/main/java/application/controller/PlayerViewController.java`)
- League dashboard → File client API: reads league data (evidence: `src/main/java/application/controller/AdminDashboardController.java`)
- League dashboard → Points table: builds table (evidence: `src/main/java/application/controller/AdminDashboardController.java`)
- Fixture scheduling → File client API: persists fixtures (evidence: `src/main/java/application/controller/AddMatchController.java`)
- Result entry → File client API: updates records (evidence: `src/main/java/application/controller/UpdateResultController.java`)
- Result entry → Player records: credits goals (evidence: `src/main/java/application/controller/UpdateResultController.java`)
- Result entry → Match records: records result (evidence: `src/main/java/application/controller/UpdateResultController.java`)
- Result entry → Points records: updates standings (evidence: `src/main/java/application/controller/UpdateResultController.java`)
- Team overview → File client API: loads squad (evidence: `src/main/java/application/controller/TeamViewController.java`)
- Player scouting → File client API: finds unsigned players (evidence: `src/main/java/application/controller/ScoutController.java`)
- Player search → File client API: searches players (evidence: `src/main/java/application/controller/SearchController.java`)
- Team fixtures → File client API: loads fixtures (evidence: `src/main/java/application/controller/UpcomingMatchesController.java`)
- Team fixtures → Points table: renders table (evidence: `src/main/java/application/controller/UpcomingMatchesController.java`)
- Chat session UI → Chat client: sends and receives (evidence: `src/main/java/application/util/ChatSession.java`)
- Chat client → Team chat server: exchanges messages (evidence: `README.md`)
- File client API → File manager server: sends requests (evidence: `README.md`)
- File manager server → File request handler: dispatches clients (evidence: `src/main/java/application/network/FileManagerServer.java`)
- File request handler → CSV data files: reads and writes (evidence: `README.md`)
- File client API → Serialized socket: serializes requests (evidence: `src/main/java/application/network/FileClient.java`)
- Chat client → Serialized socket: exchanges objects (evidence: `src/main/java/application/network/Client.java`)
- File client API → Ports and data paths: uses endpoint (evidence: `src/main/java/application/network/FileClient.java`)
- Chat session UI → Ports and data paths: uses endpoint (evidence: `src/main/java/application/util/ChatSession.java`)
