# bondreastefan/chess-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/bondreastefan/chess-dashboard
- Repository: https://github.com/bondreastefan/chess-dashboard

## Overview

This is a chess-coach dashboard: coaches authenticate, manage students, record or import PGN games, and review per-student game statistics. Its main request path is the frontend/API boundary into controllers, domain services, and repositories. The graph separates authentication, roster management, and game workflows; statistics are a distinct read stage. The README is empty, so capabilities are inferred from the source tree and shown excerpts; links to unsampled subsystems are omitted where callers were not demonstrated.

Main entry points: [`src/main/java/com/bond/chess_dashboard/student/StudentService.java`](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/student/StudentService.java) (Student service), [`src/main/java/com/bond/chess_dashboard/game/GameService.java`](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameService.java) (Game service), [`src/main/java/com/bond/chess_dashboard/coach/CoachService.java`](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/coach/CoachService.java) (Coach service), [`src/main/java/com/bond/chess_dashboard/auth/AuthService.java`](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/AuthService.java) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication"]
  node_auth_api["Auth API"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_jwt_filter["JWT filter<br/>[JwtAuthFilter.java]"]
end

subgraph group_roster["Coach and students"]
  node_coach_api["Coach API"]
  node_coach_service["Coach service<br/>[CoachService.java]"]
  node_coach_store[("Coach records")]
  node_student_api["Student API"]
  node_student_service["Student service"]
  node_student_store[("Student records")]
end

subgraph group_games["Game records"]
  node_game_api["Game API"]
  node_game_service["Game service<br/>[GameService.java]"]
  node_pgn_parser["PGN parser<br/>[PgnParser.java]"]
  node_game_store[("Game records")]
end

subgraph group_insights["Statistics"]
  node_stats_api["Stats API"]
  node_stats_service["Stats service"]
  node_stats_store[("Stats queries")]
end

subgraph group_client["Web client"]
  node_frontend["Dashboard UI<br/>[App.tsx]"]
  node_login["Login page<br/>[LoginPage.tsx]"]
end

node_coach_user(("Coach"))

node_coach_user -.->|"uses"| node_frontend
node_frontend -->|"renders"| node_login
node_login -.->|"submits login"| node_auth_api
node_coach_user -.->|"authenticates"| node_auth_api
node_auth_api -->|"delegates"| node_auth_service
node_auth_service -->|"registers, looks up"| node_coach_service
node_auth_service -->|"issues token"| node_jwt
node_coach_api -->|"delegates"| node_coach_service
node_coach_service -->|"reads, writes"| node_coach_store
node_coach_user -.->|"manages roster"| node_student_api
node_student_api -->|"delegates"| node_student_service
node_student_service -->|"reads, writes"| node_student_store
node_student_service -->|"checks coach"| node_coach_service
node_coach_user -.->|"records games"| node_game_api
node_game_api -->|"delegates"| node_game_service
node_game_service -->|"checks student"| node_student_service
node_game_service -->|"parses PGN"| node_pgn_parser
node_game_service -->|"reads, writes"| node_game_store
node_coach_user -.->|"views statistics"| node_stats_api
node_stats_api -->|"delegates"| node_stats_service
node_stats_service -->|"checks student"| node_student_service
node_stats_service -->|"queries totals"| node_stats_store

click node_frontend "https://github.com/bondreastefan/chess-dashboard/blob/main/frontend/src/App.tsx"
click node_login "https://github.com/bondreastefan/chess-dashboard/blob/main/frontend/src/auth/LoginPage.tsx"
click node_auth_api "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/AuthController.java"
click node_auth_service "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/AuthService.java"
click node_jwt "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/JwtService.java"
click node_jwt_filter "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/JwtAuthFilter.java"
click node_coach_api "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/coach/CoachController.java"
click node_coach_service "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/coach/CoachService.java"
click node_coach_store "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/coach/CoachRepository.java"
click node_student_api "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/student/StudentController.java"
click node_student_service "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/student/StudentService.java"
click node_student_store "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/student/StudentRepository.java"
click node_game_api "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameController.java"
click node_game_service "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameService.java"
click node_pgn_parser "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/PgnParser.java"
click node_game_store "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameRepository.java"
click node_stats_api "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameStatsController.java"
click node_stats_service "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameStatsService.java"
click node_stats_store "https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameStatsRepository.java"

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_auth_api,node_auth_service,node_jwt,node_jwt_filter toneBlue
class node_coach_api,node_coach_service,node_coach_store,node_student_api,node_student_service,node_student_store toneAmber
class node_game_api,node_game_service,node_pgn_parser,node_game_store toneMint
class node_stats_api,node_stats_service,node_stats_store toneRose
class node_frontend,node_login,node_coach_user toneIndigo
```

## Components

### Authentication

- [Auth API](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/AuthController.java): `src/main/java/com/bond/chess_dashboard/auth/AuthController.java`
- [Auth service](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/AuthService.java): `src/main/java/com/bond/chess_dashboard/auth/AuthService.java`
- [JWT service](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/JwtService.java): `src/main/java/com/bond/chess_dashboard/auth/JwtService.java`
- [JWT filter](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/auth/JwtAuthFilter.java): `src/main/java/com/bond/chess_dashboard/auth/JwtAuthFilter.java`

### Coach and students

- [Coach API](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/coach/CoachController.java): `src/main/java/com/bond/chess_dashboard/coach/CoachController.java`
- [Coach service](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/coach/CoachService.java): `src/main/java/com/bond/chess_dashboard/coach/CoachService.java`
- [Coach records](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/coach/CoachRepository.java): `src/main/java/com/bond/chess_dashboard/coach/CoachRepository.java`
- [Student API](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/student/StudentController.java): `src/main/java/com/bond/chess_dashboard/student/StudentController.java`
- [Student service](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/student/StudentService.java): `src/main/java/com/bond/chess_dashboard/student/StudentService.java`
- [Student records](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/student/StudentRepository.java): `src/main/java/com/bond/chess_dashboard/student/StudentRepository.java`

### Game records

- [Game API](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameController.java): `src/main/java/com/bond/chess_dashboard/game/GameController.java`
- [Game service](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameService.java): `src/main/java/com/bond/chess_dashboard/game/GameService.java`
- [PGN parser](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/PgnParser.java): `src/main/java/com/bond/chess_dashboard/game/PgnParser.java`
- [Game records](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameRepository.java): `src/main/java/com/bond/chess_dashboard/game/GameRepository.java`

### Statistics

- [Stats API](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameStatsController.java): `src/main/java/com/bond/chess_dashboard/game/GameStatsController.java`
- [Stats service](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameStatsService.java): `src/main/java/com/bond/chess_dashboard/game/GameStatsService.java`
- [Stats queries](https://github.com/bondreastefan/chess-dashboard/blob/main/src/main/java/com/bond/chess_dashboard/game/GameStatsRepository.java): `src/main/java/com/bond/chess_dashboard/game/GameStatsRepository.java`

### Web client

- [Dashboard UI](https://github.com/bondreastefan/chess-dashboard/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Login page](https://github.com/bondreastefan/chess-dashboard/blob/main/frontend/src/auth/LoginPage.tsx): `frontend/src/auth/LoginPage.tsx`

### Other components

- **Coach**

## Connections

- Coach → Dashboard UI: uses
- Dashboard UI → Login page: renders (evidence: `frontend/src/App.tsx`)
- Login page → Auth API: submits login
- Coach → Auth API: authenticates
- Auth API → Auth service: delegates (evidence: `src/main/java/com/bond/chess_dashboard/auth/AuthController.java`)
- Auth service → Coach service: registers, looks up (evidence: `src/main/java/com/bond/chess_dashboard/auth/AuthService.java`)
- Auth service → JWT service: issues token (evidence: `src/main/java/com/bond/chess_dashboard/auth/AuthService.java`)
- Coach API → Coach service: delegates (evidence: `src/main/java/com/bond/chess_dashboard/coach/CoachController.java`)
- Coach service → Coach records: reads, writes (evidence: `src/main/java/com/bond/chess_dashboard/coach/CoachService.java`)
- Coach → Student API: manages roster
- Student API → Student service: delegates (evidence: `src/main/java/com/bond/chess_dashboard/student/StudentController.java`)
- Student service → Student records: reads, writes (evidence: `src/main/java/com/bond/chess_dashboard/student/StudentService.java`)
- Student service → Coach service: checks coach (evidence: `src/main/java/com/bond/chess_dashboard/student/StudentService.java`)
- Coach → Game API: records games
- Game API → Game service: delegates (evidence: `src/main/java/com/bond/chess_dashboard/game/GameController.java`)
- Game service → Student service: checks student (evidence: `src/main/java/com/bond/chess_dashboard/game/GameService.java`)
- Game service → PGN parser: parses PGN (evidence: `src/main/java/com/bond/chess_dashboard/game/GameService.java`)
- Game service → Game records: reads, writes (evidence: `src/main/java/com/bond/chess_dashboard/game/GameService.java`)
- Coach → Stats API: views statistics
- Stats API → Stats service: delegates (evidence: `src/main/java/com/bond/chess_dashboard/game/GameStatsController.java`)
- Stats service → Student service: checks student (evidence: `src/main/java/com/bond/chess_dashboard/game/GameStatsService.java`)
- Stats service → Stats queries: queries totals (evidence: `src/main/java/com/bond/chess_dashboard/game/GameStatsService.java`)
