# aerwalk/training-project-of-the-maintenance-station architecture

> Architecture diagram of the GitHub repository aerwalk/training-project-of-the-maintenance-station, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aerwalk/training-project-of-the-maintenance-station
- Repository: https://github.com/aerwalk/training-project-of-the-maintenance-station

## Overview

This is a Java console module for accessing a PostgreSQL database for an auto-repair shop. Users enter through the CLI (or the documented demo mode) to authenticate and work with orders and reference data; the application also supports order status history and connection/error handling. The README describes configuration, service, JDBC repository, and database layers, but no source excerpts were supplied, so internal call ownership cannot be verified. Dashed links mark documented architecture whose precise runtime calls are unverified.

Main entry points: [`src/main/java/org/example/sto/cli/ConsoleMenu.java`](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/cli/ConsoleMenu.java) (Console menu), [`src/main/java/org/example/sto/repository`](https://github.com/aerwalk/training-project-of-the-maintenance-station/tree/master/src/main/java/org/example/sto/repository) (JDBC repositories), [`src/main/java/org/example/sto/service/OrderService.java`](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/service/OrderService.java) (Order workflows), [`src/main/java/org/example/sto/db/ConnectionManager.java`](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/db/ConnectionManager.java) (Connection pool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["Application"]
  node_menu["Console menu<br/>[ConsoleMenu.java]"]
  node_demo["Demo runner<br/>[DemoRunner.java]"]
end

subgraph group_domain["Shop workflows"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_catalog["Shop catalog"]
  node_orders["Order workflows<br/>[OrderService.java]"]
  node_models["Domain models"]
end

subgraph group_data["Data access"]
  node_repositories["JDBC repositories"]
  node_schema["Database schema<br/>[sto.sql]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_runtime["Runtime support"]
  node_config["DB settings"]
  node_connection["Connection pool"]
  node_retry["Retry policy<br/>[RetryPolicy.java]"]
  node_sqlerrors["SQL error translation"]
end

node_user(("Console user"))

node_user -->|"uses"| node_menu
node_app -->|"starts interactive mode"| node_menu
node_app -->|"starts demo mode"| node_demo
node_menu -.->|"supports authentication"| node_auth
node_menu -.->|"supports catalog access"| node_catalog
node_menu -.->|"supports order access"| node_orders
node_demo -.->|"runs demo scenario"| node_orders
node_auth -.->|"uses JDBC access"| node_repositories
node_catalog -.->|"uses JDBC access"| node_repositories
node_orders -.->|"uses JDBC access"| node_repositories
node_repositories -.->|"reads and writes"| node_postgres
node_schema -->|"defines schema"| node_postgres
node_config -.->|"provides settings"| node_connection
node_connection -.->|"connects to"| node_postgres
node_retry -.->|"retries failures"| node_connection
node_repositories -.->|"translates SQL errors"| node_sqlerrors

click node_app "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/StoApplication.java"
click node_menu "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/cli/ConsoleMenu.java"
click node_demo "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/cli/DemoRunner.java"
click node_auth "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/service/AuthService.java"
click node_catalog "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/service/CatalogService.java"
click node_orders "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/service/OrderService.java"
click node_models "https://github.com/aerwalk/training-project-of-the-maintenance-station/tree/master/src/main/java/org/example/sto/model"
click node_repositories "https://github.com/aerwalk/training-project-of-the-maintenance-station/tree/master/src/main/java/org/example/sto/repository"
click node_schema "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/sto.sql"
click node_config "https://github.com/aerwalk/training-project-of-the-maintenance-station/tree/master/src/main/java/org/example/sto/config"
click node_connection "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/db/ConnectionManager.java"
click node_retry "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/db/RetryPolicy.java"
click node_sqlerrors "https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/db/SqlExceptionTranslator.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_app,node_menu,node_demo,node_user toneBlue
class node_auth,node_catalog,node_orders,node_models toneAmber
class node_repositories,node_schema,node_postgres toneMint
class node_config,node_connection,node_retry,node_sqlerrors toneRose
```

## Components

### Application entry

- [Application](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/StoApplication.java): `src/main/java/org/example/sto/StoApplication.java`
- [Console menu](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/cli/ConsoleMenu.java): `src/main/java/org/example/sto/cli/ConsoleMenu.java`
- [Demo runner](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/cli/DemoRunner.java): `src/main/java/org/example/sto/cli/DemoRunner.java`

### Shop workflows

- [Authentication](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/service/AuthService.java): `src/main/java/org/example/sto/service/AuthService.java`
- [Shop catalog](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/service/CatalogService.java): `src/main/java/org/example/sto/service/CatalogService.java`
- [Order workflows](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/service/OrderService.java): `src/main/java/org/example/sto/service/OrderService.java`
- [Domain models](https://github.com/aerwalk/training-project-of-the-maintenance-station/tree/master/src/main/java/org/example/sto/model): `src/main/java/org/example/sto/model`

### Data access

- [JDBC repositories](https://github.com/aerwalk/training-project-of-the-maintenance-station/tree/master/src/main/java/org/example/sto/repository): `src/main/java/org/example/sto/repository`
- [Database schema](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/sto.sql): `sto.sql`
- **PostgreSQL**

### Runtime support

- [DB settings](https://github.com/aerwalk/training-project-of-the-maintenance-station/tree/master/src/main/java/org/example/sto/config): `src/main/java/org/example/sto/config`
- [Connection pool](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/db/ConnectionManager.java): `src/main/java/org/example/sto/db/ConnectionManager.java`
- [Retry policy](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/db/RetryPolicy.java): `src/main/java/org/example/sto/db/RetryPolicy.java`
- [SQL error translation](https://github.com/aerwalk/training-project-of-the-maintenance-station/blob/master/src/main/java/org/example/sto/db/SqlExceptionTranslator.java): `src/main/java/org/example/sto/db/SqlExceptionTranslator.java`

### Other components

- **Console user**

## Connections

- Console user → Console menu: uses (evidence: `README.md`)
- Application → Console menu: starts interactive mode (evidence: `README.md`)
- Application → Demo runner: starts demo mode (evidence: `README.md`)
- Console menu → Authentication: supports authentication
- Console menu → Shop catalog: supports catalog access
- Console menu → Order workflows: supports order access
- Demo runner → Order workflows: runs demo scenario
- Authentication → JDBC repositories: uses JDBC access
- Shop catalog → JDBC repositories: uses JDBC access
- Order workflows → JDBC repositories: uses JDBC access
- JDBC repositories → PostgreSQL: reads and writes
- Database schema → PostgreSQL: defines schema (evidence: `README.md`)
- DB settings → Connection pool: provides settings
- Connection pool → PostgreSQL: connects to
- Retry policy → Connection pool: retries failures
- JDBC repositories → SQL error translation: translates SQL errors
