# 1shayd1/itmo architecture

> Architecture diagram of the GitHub repository 1shayd1/itmo, 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/1shayd1/itmo
- Repository: https://github.com/1shayd1/itmo

## Overview

This repository is a collection of unrelated coursework rather than one integrated product. The largest application is a Java client/server route manager with GUI editing, authentication, route commands, and shared request/response models; a separate Story exercise models gifts and dinnerware. The README does not describe capabilities. The graph emphasizes the route application's visible GUI and shared data, and retains the indexed Story modules. Server wiring beyond the sampled authentication service is not established by the excerpts, so uncertain connections are omitted.

Main entry points: [`Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java`](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java) (Route GUI), [`Programming/3-4 (Story)/StoryText.java`](https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/StoryText.java) (Story flow), [`Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/model/Route.java`](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/model/Route.java) (Route model), [`Programming/3-4 (Story)/heroes/Enchantress.java`](https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/heroes/Enchantress.java) (Enchantress)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Route client"]
  node_gui["Route GUI"]
  node_authgui["Auth GUI"]
  node_connection["Server connection"]
  node_renderer["Route renderer"]
  node_localization["Localization<br/>[LocaleManager.java]"]
  node_clientcommands["Client commands"]
  node_routebuilder["Route builder<br/>[RouteBuilder.java]"]
end

subgraph group_shared["Shared model"]
  node_route["Route model<br/>[Route.java]"]
  node_request["Request protocol<br/>[Request.java]"]
  node_response["Response protocol<br/>[Response.java]"]
  node_coordinates["Coordinates<br/>[Coordinates.java]"]
  node_location["Location<br/>[Location.java]"]
  node_validator["Input validation<br/>[Validator.java]"]
end

subgraph group_server["Route server"]
  node_server["Server runtime<br/>[ServerApp.java]"]
  node_auth["Authentication service<br/>[AuthService.java]"]
  node_users[("User repository")]
  node_routes[("Route repository")]
  node_collection["Route collection"]
  node_database[("Database manager")]
end

subgraph group_story["Story exercise"]
  node_storytext["Story flow<br/>[StoryText.java]"]
  node_enchantress["Enchantress<br/>[Enchantress.java]"]
  node_princess["Princess<br/>[Princess.java]"]
  node_gift["Gifts<br/>[Gift.java]"]
  node_dishset["Dish set<br/>[SetOfDishes.java]"]
end

node_user(("User"))

node_user -->|"uses"| node_gui
node_gui -->|"sends commands"| node_connection
node_gui -->|"updates display"| node_renderer
node_gui -->|"reads labels"| node_localization
node_gui -->|"handles routes"| node_route
node_gui -->|"reads results"| node_response
node_authgui -->|"sends auth"| node_connection
node_authgui -->|"reads results"| node_response
node_clientcommands -->|"builds requests"| node_request
node_clientcommands -->|"uses builder"| node_routebuilder
node_auth -->|"authenticates users"| node_users
node_route -->|"contains"| node_coordinates
node_route -->|"contains"| node_location
node_storytext -->|"invites"| node_enchantress
node_storytext -->|"presents gifts"| node_princess
node_storytext -->|"assembles dinnerware"| node_dishset
node_storytext -->|"creates gifts"| node_gift
node_enchantress -->|"delivers gifts"| node_princess
node_enchantress -->|"accepts gift"| node_gift

click node_gui "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java"
click node_authgui "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/controllers/AuthController.java"
click node_connection "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/network/ServerConnection.java"
click node_renderer "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/visualization/CanvasRenderer.java"
click node_localization "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/localization/LocaleManager.java"
click node_clientcommands "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/manager/ClientCommandManager.java"
click node_routebuilder "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/utils/RouteBuilder.java"
click node_route "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/model/Route.java"
click node_request "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/request_and_response/Request.java"
click node_response "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/request_and_response/Response.java"
click node_coordinates "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/model/Coordinates.java"
click node_location "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/model/Location.java"
click node_validator "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/utils/Validator.java"
click node_server "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/ServerApp.java"
click node_auth "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/auth/AuthService.java"
click node_users "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/db/UserRepository.java"
click node_routes "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/db/RouteRepository.java"
click node_collection "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/manager/CollectionManager.java"
click node_database "https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/db/DatabaseManager.java"
click node_storytext "https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/StoryText.java"
click node_enchantress "https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/heroes/Enchantress.java"
click node_princess "https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/heroes/Princess.java"
click node_gift "https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/gifts/Gift.java"
click node_dishset "https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/dishes/SetOfDishes.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_gui,node_authgui,node_connection,node_renderer,node_localization,node_clientcommands,node_routebuilder,node_user toneBlue
class node_route,node_request,node_response,node_coordinates,node_location,node_validator toneAmber
class node_server,node_auth,node_users,node_routes,node_collection,node_database toneMint
class node_storytext,node_enchantress,node_princess,node_gift,node_dishset toneRose
```

## Components

### Route client

- [Route GUI](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java): `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java`
- [Auth GUI](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/controllers/AuthController.java): `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/AuthController.java`
- [Server connection](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/network/ServerConnection.java): `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/network/ServerConnection.java`
- [Route renderer](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/visualization/CanvasRenderer.java): `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/visualization/CanvasRenderer.java`
- [Localization](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/gui/localization/LocaleManager.java): `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/localization/LocaleManager.java`
- [Client commands](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/manager/ClientCommandManager.java): `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/manager/ClientCommandManager.java`
- [Route builder](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/client/src/main/java/org/shayd1/utils/RouteBuilder.java): `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/utils/RouteBuilder.java`

### Shared model

- [Route model](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/model/Route.java): `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/model/Route.java`
- [Request protocol](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/request_and_response/Request.java): `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/request_and_response/Request.java`
- [Response protocol](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/request_and_response/Response.java): `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/request_and_response/Response.java`
- [Coordinates](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/model/Coordinates.java): `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/model/Coordinates.java`
- [Location](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/model/Location.java): `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/model/Location.java`
- [Input validation](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/common/src/main/java/org/shayd1/utils/Validator.java): `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/utils/Validator.java`

### Route server

- [Server runtime](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/ServerApp.java): `Programming/5-8 (2nd semester)/server/src/main/java/org/shayd1/ServerApp.java`
- [Authentication service](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/auth/AuthService.java): `Programming/5-8 (2nd semester)/server/src/main/java/org/shayd1/auth/AuthService.java`
- [User repository](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/db/UserRepository.java): `Programming/5-8 (2nd semester)/server/src/main/java/org/shayd1/db/UserRepository.java`
- [Route repository](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/db/RouteRepository.java): `Programming/5-8 (2nd semester)/server/src/main/java/org/shayd1/db/RouteRepository.java`
- [Route collection](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/manager/CollectionManager.java): `Programming/5-8 (2nd semester)/server/src/main/java/org/shayd1/manager/CollectionManager.java`
- [Database manager](https://github.com/1shayd1/itmo/blob/main/Programming/5-8%20(2nd%20semester)/server/src/main/java/org/shayd1/db/DatabaseManager.java): `Programming/5-8 (2nd semester)/server/src/main/java/org/shayd1/db/DatabaseManager.java`

### Story exercise

- [Story flow](https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/StoryText.java): `Programming/3-4 (Story)/StoryText.java`
- [Enchantress](https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/heroes/Enchantress.java): `Programming/3-4 (Story)/heroes/Enchantress.java`
- [Princess](https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/heroes/Princess.java): `Programming/3-4 (Story)/heroes/Princess.java`
- [Gifts](https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/gifts/Gift.java): `Programming/3-4 (Story)/gifts/Gift.java`
- [Dish set](https://github.com/1shayd1/itmo/blob/main/Programming/3-4%20(Story)/dishes/SetOfDishes.java): `Programming/3-4 (Story)/dishes/SetOfDishes.java`

### Other components

- **User**

## Connections

- User → Route GUI: uses
- Route GUI → Server connection: sends commands (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java`)
- Route GUI → Route renderer: updates display (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java`)
- Route GUI → Localization: reads labels (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java`)
- Route GUI → Route model: handles routes (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java`)
- Route GUI → Response protocol: reads results (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/MainController.java`)
- Auth GUI → Server connection: sends auth (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/AuthController.java`)
- Auth GUI → Response protocol: reads results (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/gui/controllers/AuthController.java`)
- Client commands → Request protocol: builds requests (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/manager/ClientCommandManager.java`)
- Client commands → Route builder: uses builder (evidence: `Programming/5-8 (2nd semester)/client/src/main/java/org/shayd1/manager/ClientCommandManager.java`)
- Authentication service → User repository: authenticates users (evidence: `Programming/5-8 (2nd semester)/server/src/main/java/org/shayd1/auth/AuthService.java`)
- Route model → Coordinates: contains (evidence: `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/model/Route.java`)
- Route model → Location: contains (evidence: `Programming/5-8 (2nd semester)/common/src/main/java/org/shayd1/model/Route.java`)
- Story flow → Enchantress: invites (evidence: `Programming/3-4 (Story)/StoryText.java`)
- Story flow → Princess: presents gifts (evidence: `Programming/3-4 (Story)/StoryText.java`)
- Story flow → Dish set: assembles dinnerware (evidence: `Programming/3-4 (Story)/StoryText.java`)
- Story flow → Gifts: creates gifts (evidence: `Programming/3-4 (Story)/StoryText.java`)
- Enchantress → Princess: delivers gifts (evidence: `Programming/3-4 (Story)/heroes/Enchantress.java`)
- Enchantress → Gifts: accepts gift (evidence: `Programming/3-4 (Story)/heroes/Enchantress.java`)
