# acridgold/javalabsnsu architecture

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

## Overview

This repository is a set of independent Java labs, not one integrated application. Its product workflows include a stack calculator, falling-block game, car-factory simulator, and two chat implementations. The README confirms only labs 1–3 are marked done, so labs 4–5 are represented from source-index evidence rather than documentation; uncertain wiring is omitted. The sampled sources support the game, factory, calculator, and chat runtime layers, but detailed chat-server startup and several UI/storage interactions remain unverified.

Main entry points: [`lab3/src/main/java/ru/nsu/controller/GameController.java`](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/controller/GameController.java) (Game controller), [`lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java`](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java) (Factory dashboard), [`lab4/src/main/java/ru/nsu/factory/storage/Storage.java`](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/storage/Storage.java) (Part inventories), [`lab4/src/main/java/ru/nsu/factory/factory/StockController.java`](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/factory/StockController.java) (Stock controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_calc["Calculator"]
  node_calc_entry["Calculator CLI<br/>[Main.java]"]
  node_calc_engine["Command engine<br/>[Calculator.java]"]
  node_calc_factory["Command factory"]
  node_calc_commands["Stack commands"]
  node_calc_context["Stack context<br/>[Context.java]"]
  node_calc_errors["Calculator errors"]
end

subgraph group_game["Block game"]
  node_game_entry["Game startup<br/>[Main.java]"]
  node_game_controller["Game controller"]
  node_game_model["Game rules<br/>[GameModel.java]"]
  node_game_board["Board state<br/>[Board.java]"]
  node_game_view["Game window<br/>[MainWindow.java]"]
  node_game_panel["Board renderer<br/>[GamePanel.java]"]
  node_game_commands["Input handler"]
  node_game_scores[("Score records<br/>[ScoreStorage.java]")]
  node_game_score_entry["Score entry<br/>[ScoreEntry.java]"]
  node_game_settings["Display settings<br/>[AppSettings.java]"]
  node_game_dialogs["Scaled dialogs<br/>[ScaledDialogs.java]"]
end

subgraph group_factory["Factory simulator"]
  node_factory_app["Factory startup<br/>[FactoryApp.java]"]
  node_factory_ui["Factory dashboard<br/>[FactoryFrame.java]"]
  node_factory_stock["Stock controller"]
  node_factory_assembly["Assembly tasks<br/>[AssemblyTask.java]"]
  node_factory_pool["Worker pool<br/>[ThreadPool.java]"]
  node_factory_stores[("Part inventories<br/>[Storage.java]")]
  node_factory_parts["Vehicle parts"]
  node_factory_suppliers["Part suppliers<br/>[PartSupplier.java]"]
  node_factory_dealers["Dealers<br/>[Dealer.java]"]
  node_factory_logger["Sales logger<br/>[SaleLogger.java]"]
end

subgraph group_chat["Chat"]
  node_json_client["JSON client<br/>[ChatClient.java]"]
  node_json_connection["JSON connection"]
  node_chat_server["Chat server<br/>[ChatServer.java]"]
end

node_calcuser(("Calculator user"))
node_player(("Player"))
node_factory_operator(("Factory operator"))
node_chat_user(("Chat user"))

node_calcuser -->|"enters commands"| node_calc_entry
node_calc_entry -->|"invokes"| node_calc_engine
node_calc_engine -.->|"creates commands"| node_calc_factory
node_calc_commands -->|"uses state"| node_calc_context
node_calc_context -->|"raises errors"| node_calc_errors
node_game_entry -.->|"starts game"| node_game_controller
node_game_entry -->|"loads records"| node_game_scores
node_player -->|"plays"| node_game_controller
node_game_controller -->|"updates state"| node_game_model
node_game_controller -->|"refreshes"| node_game_view
node_game_controller -->|"saves result"| node_game_scores
node_game_controller -->|"creates record"| node_game_score_entry
node_game_controller -->|"prompts player"| node_game_dialogs
node_game_model -->|"reads and changes"| node_game_board
node_game_view -->|"displays board"| node_game_panel
node_game_panel -->|"reads state"| node_game_model
node_game_view -->|"registers input"| node_game_commands
node_game_panel -->|"reads settings"| node_game_settings
node_factory_app -->|"opens dashboard"| node_factory_ui
node_factory_operator -->|"adjusts speeds"| node_factory_ui
node_factory_app -->|"starts production"| node_factory_stock
node_factory_stock -->|"submits assembly"| node_factory_pool
node_factory_stock -->|"creates tasks"| node_factory_assembly
node_factory_ui -->|"reads inventory"| node_factory_stores
node_factory_ui -->|"sets delays"| node_factory_suppliers
node_factory_ui -->|"sets delays"| node_factory_dealers
node_factory_stock -->|"checks capacity"| node_factory_stores
node_factory_assembly -.->|"uses inventory"| node_factory_stores
node_factory_suppliers -->|"supplies parts"| node_factory_stores
node_factory_dealers -->|"takes cars"| node_factory_stores
node_factory_dealers -->|"logs sales"| node_factory_logger
node_factory_assembly -.->|"assembles vehicle"| node_factory_parts
node_chat_user -->|"sends messages"| node_json_client
node_json_client -->|"sends protocol data"| node_json_connection
node_json_connection -.->|"connects over socket"| node_chat_server

click node_calc_entry "https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/Main.java"
click node_calc_engine "https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/Calculator.java"
click node_calc_factory "https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/CommandFactory.java"
click node_calc_commands "https://github.com/acridgold/javalabsnsu/tree/main/lab2/src/main/java/ru/nsu/calculator/mods"
click node_calc_context "https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/Context.java"
click node_calc_errors "https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/CalculatorExceptions.java"
click node_game_entry "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/Main.java"
click node_game_controller "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/controller/GameController.java"
click node_game_model "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/GameModel.java"
click node_game_board "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/Board.java"
click node_game_view "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/MainWindow.java"
click node_game_panel "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/GamePanel.java"
click node_game_commands "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/controller/CommandHandler.java"
click node_game_scores "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/ScoreStorage.java"
click node_game_score_entry "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/ScoreEntry.java"
click node_game_settings "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/AppSettings.java"
click node_game_dialogs "https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/ScaledDialogs.java"
click node_factory_app "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/FactoryApp.java"
click node_factory_ui "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java"
click node_factory_stock "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/factory/StockController.java"
click node_factory_assembly "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/factory/AssemblyTask.java"
click node_factory_pool "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/threadpool/ThreadPool.java"
click node_factory_stores "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/storage/Storage.java"
click node_factory_parts "https://github.com/acridgold/javalabsnsu/tree/main/lab4/src/main/java/ru/nsu/factory/model"
click node_factory_suppliers "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/supplier/PartSupplier.java"
click node_factory_dealers "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/dealer/Dealer.java"
click node_factory_logger "https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/logger/SaleLogger.java"
click node_json_client "https://github.com/acridgold/javalabsnsu/blob/main/lab5/src/main/java/chat/client/ChatClient.java"
click node_json_connection "https://github.com/acridgold/javalabsnsu/blob/main/lab5/src/main/java/chat/client/ServerConnection.java"
click node_chat_server "https://github.com/acridgold/javalabsnsu/blob/main/lab5/src/main/java/chat/server/ChatServer.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_calc_entry,node_calc_engine,node_calc_factory,node_calc_commands,node_calc_context,node_calc_errors,node_calcuser,node_chat_user toneBlue
class node_game_entry,node_game_controller,node_game_model,node_game_board,node_game_view,node_game_panel,node_game_commands,node_game_scores,node_game_score_entry,node_game_settings,node_game_dialogs toneAmber
class node_factory_app,node_factory_ui,node_factory_stock,node_factory_assembly,node_factory_pool,node_factory_stores,node_factory_parts,node_factory_suppliers,node_factory_dealers,node_factory_logger toneMint
class node_json_client,node_json_connection,node_chat_server toneRose
class node_player,node_factory_operator toneIndigo
```

## Components

### Calculator

- [Calculator CLI](https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/Main.java): `lab2/src/main/java/ru/nsu/Main.java`
- [Command engine](https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/Calculator.java): `lab2/src/main/java/ru/nsu/calculator/Calculator.java`
- [Command factory](https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/CommandFactory.java): `lab2/src/main/java/ru/nsu/calculator/CommandFactory.java`
- [Stack commands](https://github.com/acridgold/javalabsnsu/tree/main/lab2/src/main/java/ru/nsu/calculator/mods): `lab2/src/main/java/ru/nsu/calculator/mods`
- [Stack context](https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/Context.java): `lab2/src/main/java/ru/nsu/calculator/Context.java`
- [Calculator errors](https://github.com/acridgold/javalabsnsu/blob/main/lab2/src/main/java/ru/nsu/calculator/CalculatorExceptions.java): `lab2/src/main/java/ru/nsu/calculator/CalculatorExceptions.java`

### Block game

- [Game startup](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/Main.java): `lab3/src/main/java/ru/nsu/Main.java`
- [Game controller](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/controller/GameController.java): `lab3/src/main/java/ru/nsu/controller/GameController.java`
- [Game rules](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/GameModel.java): `lab3/src/main/java/ru/nsu/model/GameModel.java`
- [Board state](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/Board.java): `lab3/src/main/java/ru/nsu/model/Board.java`
- [Game window](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/MainWindow.java): `lab3/src/main/java/ru/nsu/view/MainWindow.java`
- [Board renderer](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/GamePanel.java): `lab3/src/main/java/ru/nsu/view/GamePanel.java`
- [Input handler](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/controller/CommandHandler.java): `lab3/src/main/java/ru/nsu/controller/CommandHandler.java`
- [Score records](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/ScoreStorage.java): `lab3/src/main/java/ru/nsu/model/ScoreStorage.java`
- [Score entry](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/model/ScoreEntry.java): `lab3/src/main/java/ru/nsu/model/ScoreEntry.java`
- [Display settings](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/AppSettings.java): `lab3/src/main/java/ru/nsu/view/AppSettings.java`
- [Scaled dialogs](https://github.com/acridgold/javalabsnsu/blob/main/lab3/src/main/java/ru/nsu/view/ScaledDialogs.java): `lab3/src/main/java/ru/nsu/view/ScaledDialogs.java`

### Factory simulator

- [Factory startup](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/FactoryApp.java): `lab4/src/main/java/ru/nsu/factory/FactoryApp.java`
- [Factory dashboard](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java): `lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java`
- [Stock controller](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/factory/StockController.java): `lab4/src/main/java/ru/nsu/factory/factory/StockController.java`
- [Assembly tasks](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/factory/AssemblyTask.java): `lab4/src/main/java/ru/nsu/factory/factory/AssemblyTask.java`
- [Worker pool](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/threadpool/ThreadPool.java): `lab4/src/main/java/ru/nsu/factory/threadpool/ThreadPool.java`
- [Part inventories](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/storage/Storage.java): `lab4/src/main/java/ru/nsu/factory/storage/Storage.java`
- [Vehicle parts](https://github.com/acridgold/javalabsnsu/tree/main/lab4/src/main/java/ru/nsu/factory/model): `lab4/src/main/java/ru/nsu/factory/model`
- [Part suppliers](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/supplier/PartSupplier.java): `lab4/src/main/java/ru/nsu/factory/supplier/PartSupplier.java`
- [Dealers](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/dealer/Dealer.java): `lab4/src/main/java/ru/nsu/factory/dealer/Dealer.java`
- [Sales logger](https://github.com/acridgold/javalabsnsu/blob/main/lab4/src/main/java/ru/nsu/factory/logger/SaleLogger.java): `lab4/src/main/java/ru/nsu/factory/logger/SaleLogger.java`

### Chat

- [JSON client](https://github.com/acridgold/javalabsnsu/blob/main/lab5/src/main/java/chat/client/ChatClient.java): `lab5/src/main/java/chat/client/ChatClient.java`
- [JSON connection](https://github.com/acridgold/javalabsnsu/blob/main/lab5/src/main/java/chat/client/ServerConnection.java): `lab5/src/main/java/chat/client/ServerConnection.java`
- [Chat server](https://github.com/acridgold/javalabsnsu/blob/main/lab5/src/main/java/chat/server/ChatServer.java): `lab5/src/main/java/chat/server/ChatServer.java`

### Other components

- **Calculator user**
- **Player**
- **Factory operator**
- **Chat user**

## Connections

- Calculator user → Calculator CLI: enters commands (evidence: `lab2/src/main/java/ru/nsu/Main.java`)
- Calculator CLI → Command engine: invokes (evidence: `lab2/src/main/java/ru/nsu/Main.java`)
- Command engine → Command factory: creates commands (evidence: `lab2/src/main/java/ru/nsu/calculator/Calculator.java`)
- Stack commands → Stack context: uses state (evidence: `lab2/src/main/java/ru/nsu/calculator/mods/Divide.java`)
- Stack context → Calculator errors: raises errors (evidence: `lab2/src/main/java/ru/nsu/calculator/Context.java`)
- Game startup → Game controller: starts game
- Game startup → Score records: loads records (evidence: `lab3/src/main/java/ru/nsu/Main.java`)
- Player → Game controller: plays (evidence: `lab3/src/main/java/ru/nsu/controller/GameController.java`)
- Game controller → Game rules: updates state (evidence: `lab3/src/main/java/ru/nsu/controller/GameController.java`)
- Game controller → Game window: refreshes (evidence: `lab3/src/main/java/ru/nsu/controller/GameController.java`)
- Game controller → Score records: saves result (evidence: `lab3/src/main/java/ru/nsu/controller/GameController.java`)
- Game controller → Score entry: creates record (evidence: `lab3/src/main/java/ru/nsu/controller/GameController.java`)
- Game controller → Scaled dialogs: prompts player (evidence: `lab3/src/main/java/ru/nsu/controller/GameController.java`)
- Game rules → Board state: reads and changes (evidence: `lab3/src/main/java/ru/nsu/model/GameModel.java`)
- Game window → Board renderer: displays board (evidence: `lab3/src/main/java/ru/nsu/view/MainWindow.java`)
- Board renderer → Game rules: reads state (evidence: `lab3/src/main/java/ru/nsu/view/GamePanel.java`)
- Game window → Input handler: registers input (evidence: `lab3/src/main/java/ru/nsu/view/MainWindow.java`)
- Board renderer → Display settings: reads settings (evidence: `lab3/src/main/java/ru/nsu/view/GamePanel.java`)
- Factory startup → Factory dashboard: opens dashboard (evidence: `lab4/src/main/java/ru/nsu/factory/FactoryApp.java`)
- Factory operator → Factory dashboard: adjusts speeds (evidence: `lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java`)
- Factory startup → Stock controller: starts production (evidence: `lab4/src/main/java/ru/nsu/factory/FactoryApp.java`)
- Stock controller → Worker pool: submits assembly (evidence: `lab4/src/main/java/ru/nsu/factory/factory/StockController.java`)
- Stock controller → Assembly tasks: creates tasks (evidence: `lab4/src/main/java/ru/nsu/factory/factory/StockController.java`)
- Factory dashboard → Part inventories: reads inventory (evidence: `lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java`)
- Factory dashboard → Part suppliers: sets delays (evidence: `lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java`)
- Factory dashboard → Dealers: sets delays (evidence: `lab4/src/main/java/ru/nsu/factory/gui/FactoryFrame.java`)
- Stock controller → Part inventories: checks capacity (evidence: `lab4/src/main/java/ru/nsu/factory/factory/StockController.java`)
- Assembly tasks → Part inventories: uses inventory
- Part suppliers → Part inventories: supplies parts (evidence: `lab4/src/main/java/ru/nsu/factory/supplier/PartSupplier.java`)
- Dealers → Part inventories: takes cars (evidence: `lab4/src/main/java/ru/nsu/factory/dealer/Dealer.java`)
- Dealers → Sales logger: logs sales (evidence: `lab4/src/main/java/ru/nsu/factory/dealer/Dealer.java`)
- Assembly tasks → Vehicle parts: assembles vehicle
- Chat user → JSON client: sends messages (evidence: `lab5/src/main/java/chat/client/ChatClient.java`)
- JSON client → JSON connection: sends protocol data (evidence: `lab5/src/main/java/chat/client/ChatClient.java`)
- JSON connection → Chat server: connects over socket
