# kacper-holowaty/football_manager architecture

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

- Interactive diagram: https://gitdiagram.com/kacper-holowaty/football_manager
- Repository: https://github.com/kacper-holowaty/football_manager

## Overview

FC Manager is an Angular football-club management application. Users can register or log in, browse clubs, and—when authenticated—manage their own clubs, players, and achievements. The frontend’s route components call services that make HTTP requests to the Spring Boot API; the README identifies PostgreSQL as the backend database, but backend implementation and persistence links are not shown in this frontend tree. The graph focuses on product workflows and shared authentication, country, and notification layers; unsampled feature internals are represented only where the tree or README supports them.

Main entry points: [`frontend/src/app/components/club/club.routes.ts`](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club.routes.ts) (Club routes), [`frontend/src/app/services/auth.service.ts`](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/auth.service.ts) (Authentication), [`frontend/src/app/services/club.service.ts`](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/club.service.ts) (Club data service), [`frontend/src/app/app.routes.ts`](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/app.routes.ts) (App routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App and navigation"]
  node_app_routes["App routes<br/>[app.routes.ts]"]
  node_dashboard["Owner dashboard<br/>[main.component.ts]"]
end

subgraph group_identity["Identity and account"]
  node_account_views["Login and registration<br/>[login.component.ts]"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
  node_token_service["Token and session<br/>[token.service.ts]"]
  node_auth_interceptor["Auth interceptor"]
  node_user_service["User account service<br/>[user.service.ts]"]
end

subgraph group_club_domain["Club management"]
  node_club_routes["Club routes<br/>[club.routes.ts]"]
  node_club_browse["Club browsing"]
  node_club_pages["Club details and deletion"]
  node_club_form["Club form"]
  node_club_form_logic["Club form logic"]
  node_club_service["Club data service<br/>[club.service.ts]"]
end

subgraph group_squad_domain["Squad and achievements"]
  node_player_routes["Player routes<br/>[player.routes.ts]"]
  node_player_views["Player lists and details"]
  node_player_form["Player form"]
  node_player_service["Player data service<br/>[player.service.ts]"]
  node_achievement_views["Club achievements"]
  node_achievement_form["Achievement form"]
  node_achievement_service["Achievement data service"]
end

subgraph group_shared["Shared services"]
  node_country_service["Country lookup<br/>[country.service.ts]"]
  node_toast_service["Notifications<br/>[toast.service.ts]"]
end

node_visitor(("Visitor"))
node_api{{"Spring Boot API"}}

node_visitor -->|"opens"| node_app_routes
node_app_routes -->|"routes to"| node_account_views
node_app_routes -->|"routes to"| node_dashboard
node_app_routes -->|"loads routes"| node_club_routes
node_account_views -->|"authenticates"| node_auth_service
node_auth_service -->|"stores tokens"| node_token_service
node_auth_interceptor -->|"checks session"| node_auth_service
node_auth_interceptor -->|"reads tokens"| node_token_service
node_dashboard -->|"gets identity"| node_auth_service
node_dashboard -->|"loads owned clubs"| node_club_service
node_dashboard -->|"updates account"| node_user_service
node_club_routes -->|"routes to"| node_club_browse
node_club_routes -->|"routes to"| node_club_pages
node_club_routes -->|"routes to"| node_club_form
node_club_routes -->|"loads routes"| node_player_routes
node_club_routes -->|"routes to"| node_achievement_views
node_club_form -->|"delegates form"| node_club_form_logic
node_club_form_logic -->|"submits changes"| node_club_service
node_club_form -->|"looks up countries"| node_country_service
node_club_browse -.->|"loads clubs"| node_club_service
node_club_pages -.->|"loads club"| node_club_service
node_player_routes -->|"routes to"| node_player_views
node_player_routes -->|"routes to"| node_player_form
node_player_form -->|"loads and saves"| node_player_service
node_player_form -->|"looks up countries"| node_country_service
node_player_views -.->|"loads players"| node_player_service
node_achievement_views -->|"opens form"| node_achievement_form
node_achievement_views -->|"manages achievements"| node_achievement_service
node_achievement_form -->|"submits changes"| node_achievement_service
node_account_views -->|"shows feedback"| node_toast_service
node_club_form -->|"shows feedback"| node_toast_service
node_player_form -->|"shows feedback"| node_toast_service
node_club_service -->|"HTTP requests"| node_api
node_auth_service -->|"HTTP requests"| node_api
node_country_service -->|"HTTP requests"| node_api
node_player_service -.->|"HTTP requests"| node_api
node_achievement_service -.->|"HTTP requests"| node_api

click node_app_routes "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/app.routes.ts"
click node_account_views "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/login/login.component.ts"
click node_dashboard "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/main/main.component.ts"
click node_auth_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/auth.service.ts"
click node_token_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/token.service.ts"
click node_auth_interceptor "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/interceptors/auth.interceptor.ts"
click node_user_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/user.service.ts"
click node_club_routes "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club.routes.ts"
click node_club_browse "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club-list/club-list.component.ts"
click node_club_pages "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club-main/club-main.component.ts"
click node_club_form "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club-form/club-form.component.ts"
click node_club_form_logic "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/club-form.service.ts"
click node_club_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/club.service.ts"
click node_player_routes "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/player/player.routes.ts"
click node_player_views "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/player/player-list/player-list.component.ts"
click node_player_form "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/player/player-form/player-form.component.ts"
click node_player_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/player.service.ts"
click node_achievement_views "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/achievement/achievement-main/achievement-main.component.ts"
click node_achievement_form "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/achievement/achievement-form/achievement-form.component.ts"
click node_achievement_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/achievement.service.ts"
click node_country_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/country.service.ts"
click node_toast_service "https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/toast.service.ts"

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_routes,node_dashboard toneBlue
class node_account_views,node_auth_service,node_token_service,node_auth_interceptor,node_user_service toneAmber
class node_club_routes,node_club_browse,node_club_pages,node_club_form,node_club_form_logic,node_club_service,node_api toneMint
class node_player_routes,node_player_views,node_player_form,node_player_service,node_achievement_views,node_achievement_form,node_achievement_service toneRose
class node_country_service,node_toast_service,node_visitor toneIndigo
```

## Components

### App and navigation

- [App routes](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Owner dashboard](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/main/main.component.ts): `frontend/src/app/components/main/main.component.ts`

### Identity and account

- [Login and registration](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/login/login.component.ts): `frontend/src/app/components/login/login.component.ts`
- [Authentication](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/auth.service.ts): `frontend/src/app/services/auth.service.ts`
- [Token and session](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/token.service.ts): `frontend/src/app/services/token.service.ts`
- [Auth interceptor](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/interceptors/auth.interceptor.ts): `frontend/src/app/interceptors/auth.interceptor.ts`
- [User account service](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/user.service.ts): `frontend/src/app/services/user.service.ts`

### Club management

- [Club routes](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club.routes.ts): `frontend/src/app/components/club/club.routes.ts`
- [Club browsing](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club-list/club-list.component.ts): `frontend/src/app/components/club/club-list/club-list.component.ts`
- [Club details and deletion](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club-main/club-main.component.ts): `frontend/src/app/components/club/club-main/club-main.component.ts`
- [Club form](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/club/club-form/club-form.component.ts): `frontend/src/app/components/club/club-form/club-form.component.ts`
- [Club form logic](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/club-form.service.ts): `frontend/src/app/services/club-form.service.ts`
- [Club data service](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/club.service.ts): `frontend/src/app/services/club.service.ts`

### Squad and achievements

- [Player routes](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/player/player.routes.ts): `frontend/src/app/components/player/player.routes.ts`
- [Player lists and details](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/player/player-list/player-list.component.ts): `frontend/src/app/components/player/player-list/player-list.component.ts`
- [Player form](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/player/player-form/player-form.component.ts): `frontend/src/app/components/player/player-form/player-form.component.ts`
- [Player data service](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/player.service.ts): `frontend/src/app/services/player.service.ts`
- [Club achievements](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/achievement/achievement-main/achievement-main.component.ts): `frontend/src/app/components/achievement/achievement-main/achievement-main.component.ts`
- [Achievement form](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/components/achievement/achievement-form/achievement-form.component.ts): `frontend/src/app/components/achievement/achievement-form/achievement-form.component.ts`
- [Achievement data service](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/achievement.service.ts): `frontend/src/app/services/achievement.service.ts`

### Shared services

- [Country lookup](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/country.service.ts): `frontend/src/app/services/country.service.ts`
- [Notifications](https://github.com/kacper-holowaty/football_manager/blob/main/frontend/src/app/services/toast.service.ts): `frontend/src/app/services/toast.service.ts`

### Other components

- **Visitor**
- **Spring Boot API**

## Connections

- Visitor → App routes: opens (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Login and registration: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Owner dashboard: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Club routes: loads routes (evidence: `frontend/src/app/app.routes.ts`)
- Login and registration → Authentication: authenticates (evidence: `frontend/src/app/components/login/login.component.ts`)
- Authentication → Token and session: stores tokens (evidence: `frontend/src/app/services/auth.service.ts`)
- Auth interceptor → Authentication: checks session (evidence: `frontend/src/app/interceptors/auth.interceptor.ts`)
- Auth interceptor → Token and session: reads tokens (evidence: `frontend/src/app/interceptors/auth.interceptor.ts`)
- Owner dashboard → Authentication: gets identity (evidence: `frontend/src/app/components/main/main.component.ts`)
- Owner dashboard → Club data service: loads owned clubs (evidence: `frontend/src/app/components/main/main.component.ts`)
- Owner dashboard → User account service: updates account (evidence: `frontend/src/app/components/main/main.component.ts`)
- Club routes → Club browsing: routes to (evidence: `frontend/src/app/components/club/club.routes.ts`)
- Club routes → Club details and deletion: routes to (evidence: `frontend/src/app/components/club/club.routes.ts`)
- Club routes → Club form: routes to (evidence: `frontend/src/app/components/club/club.routes.ts`)
- Club routes → Player routes: loads routes (evidence: `frontend/src/app/components/club/club.routes.ts`)
- Club routes → Club achievements: routes to (evidence: `frontend/src/app/components/club/club.routes.ts`)
- Club form → Club form logic: delegates form (evidence: `frontend/src/app/components/club/club-form/club-form.component.ts`)
- Club form logic → Club data service: submits changes (evidence: `frontend/src/app/services/club-form.service.ts`)
- Club form → Country lookup: looks up countries (evidence: `frontend/src/app/components/club/club-form/club-form.component.ts`)
- Club browsing → Club data service: loads clubs
- Club details and deletion → Club data service: loads club
- Player routes → Player lists and details: routes to (evidence: `frontend/src/app/components/player/player.routes.ts`)
- Player routes → Player form: routes to (evidence: `frontend/src/app/components/player/player.routes.ts`)
- Player form → Player data service: loads and saves (evidence: `frontend/src/app/components/player/player-form/player-form.component.ts`)
- Player form → Country lookup: looks up countries (evidence: `frontend/src/app/components/player/player-form/player-form.component.ts`)
- Player lists and details → Player data service: loads players (evidence: `frontend/src/app/components/player/player-list/player-list.component.ts`)
- Club achievements → Achievement form: opens form (evidence: `frontend/src/app/components/achievement/achievement-main/achievement-main.component.ts`)
- Club achievements → Achievement data service: manages achievements (evidence: `frontend/src/app/components/achievement/achievement-main/achievement-main.component.ts`)
- Achievement form → Achievement data service: submits changes (evidence: `frontend/src/app/components/achievement/achievement-form/achievement-form.component.ts`)
- Login and registration → Notifications: shows feedback (evidence: `frontend/src/app/components/login/login.component.ts`)
- Club form → Notifications: shows feedback (evidence: `frontend/src/app/components/club/club-form/club-form.component.ts`)
- Player form → Notifications: shows feedback (evidence: `frontend/src/app/components/player/player-form/player-form.component.ts`)
- Club data service → Spring Boot API: HTTP requests (evidence: `frontend/src/app/services/club.service.ts`)
- Authentication → Spring Boot API: HTTP requests (evidence: `frontend/src/app/services/auth.service.ts`)
- Country lookup → Spring Boot API: HTTP requests (evidence: `frontend/src/app/services/country.service.ts`)
- Player data service → Spring Boot API: HTTP requests
- Achievement data service → Spring Boot API: HTTP requests
