# aimilia-fl/prog2-project architecture

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

- Interactive diagram: https://gitdiagram.com/aimilia-fl/prog2-project
- Repository: https://github.com/aimilia-fl/prog2-project

## Overview

Next Lifts is an elevator-request and status API with a terminal passenger UI. The visible request workflow sends a floor pair to the central HTTP service, validates it, then returns a placeholder elevator assignment; the request handler explicitly notes dispatch is not implemented. Status retrieval is represented by separate central-client and elevator-endpoint handlers. The tree also includes an evaluation package, but its sampled files expose no connections to the runtime. Arrows reflect shown calls or documented HTTP wiring; unsampled operational behavior is not inferred.

Main entry points: [`src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java`](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java) (Terminal UI), [`src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorStatus.java`](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorStatus.java) (Status contract), [`src/main/java/gr/aueb/dmst/javengers/central/handlers/StatusHandler.java`](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/handlers/StatusHandler.java) (Status client), [`src/main/java/gr/aueb/dmst/javengers/central/CentralApp.java`](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/CentralApp.java) (Central server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Passenger client"]
  node_terminal["Terminal UI<br/>[UserInterface.java]"]
end

subgraph group_central["Central API"]
  node_central_server["Central server<br/>[CentralApp.java]"]
  node_request_handler["Request handler"]
  node_request_dto["Request contract"]
  node_response_dto["Assignment response"]
  node_exceptions["Request exceptions"]
end

subgraph group_status["Status exchange"]
  node_central_status["Status client<br/>[StatusHandler.java]"]
  node_elevator_status["Status endpoint<br/>[StatusHandler.java]"]
  node_status_dto["Status contract"]
end

subgraph group_domain["Elevator domain"]
  node_states["Operating states"]
  node_stop_model["Stop model<br/>[Stop.java]"]
  node_config_model["Elevator config"]
end

subgraph group_evaluation["Evaluation"]
  node_evaluation_main["Evaluation entry"]
  node_random_generator["Random generator"]
  node_math_evaluator["Math evaluator<br/>[MathEvaluator.java]"]
  node_data_storage["Evaluation storage<br/>[DataStorage.java]"]
end

node_passenger(("Passenger"))
node_elevator_service(("Elevator service"))

node_passenger -->|"enters floors"| node_terminal
node_terminal -->|"POSTs request"| node_central_server
node_central_server -->|"routes requests"| node_request_handler
node_terminal -->|"creates request"| node_request_dto
node_request_handler -->|"parses request"| node_request_dto
node_terminal -->|"parses assignment"| node_response_dto
node_terminal -->|"handles errors"| node_exceptions
node_central_status -->|"GETs status"| node_elevator_service
node_central_status -->|"parses status"| node_status_dto
node_elevator_status -->|"serializes status"| node_status_dto
node_status_dto -->|"uses state enums"| node_states
node_stop_model -->|"uses stop type"| node_states

click node_terminal "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java"
click node_central_server "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/CentralApp.java"
click node_request_handler "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/handlers/RequestHandler.java"
click node_request_dto "https://github.com/aimilia-fl/prog2-project/tree/main/src/main/java/gr/aueb/dmst/javengers/common/dto"
click node_response_dto "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorResponse.java"
click node_exceptions "https://github.com/aimilia-fl/prog2-project/tree/main/src/main/java/gr/aueb/dmst/javengers/common/exceptions"
click node_central_status "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/handlers/StatusHandler.java"
click node_elevator_status "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/elevator/handlers/StatusHandler.java"
click node_status_dto "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorStatus.java"
click node_states "https://github.com/aimilia-fl/prog2-project/tree/main/src/main/java/gr/aueb/dmst/javengers/elevator/model"
click node_stop_model "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/elevator/model/Stop.java"
click node_config_model "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/elevator/model/ElevatorConfig.java"
click node_evaluation_main "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/EvaluationMain.java"
click node_random_generator "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/Generator/RandomGenerator.java"
click node_math_evaluator "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/MathEvaluator/MathEvaluator.java"
click node_data_storage "https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/Storage/DataStorage.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_terminal toneBlue
class node_central_server,node_request_handler,node_request_dto,node_response_dto,node_exceptions toneAmber
class node_central_status,node_elevator_status,node_status_dto toneMint
class node_states,node_stop_model,node_config_model toneRose
class node_evaluation_main,node_random_generator,node_math_evaluator,node_data_storage,node_passenger,node_elevator_service toneIndigo
```

## Components

### Passenger client

- [Terminal UI](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java): `src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java`

### Central API

- [Central server](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/CentralApp.java): `src/main/java/gr/aueb/dmst/javengers/central/CentralApp.java`
- [Request handler](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/handlers/RequestHandler.java): `src/main/java/gr/aueb/dmst/javengers/central/handlers/RequestHandler.java`
- [Request contract](https://github.com/aimilia-fl/prog2-project/tree/main/src/main/java/gr/aueb/dmst/javengers/common/dto): `src/main/java/gr/aueb/dmst/javengers/common/dto`
- [Assignment response](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorResponse.java): `src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorResponse.java`
- [Request exceptions](https://github.com/aimilia-fl/prog2-project/tree/main/src/main/java/gr/aueb/dmst/javengers/common/exceptions): `src/main/java/gr/aueb/dmst/javengers/common/exceptions`

### Status exchange

- [Status client](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/central/handlers/StatusHandler.java): `src/main/java/gr/aueb/dmst/javengers/central/handlers/StatusHandler.java`
- [Status endpoint](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/elevator/handlers/StatusHandler.java): `src/main/java/gr/aueb/dmst/javengers/elevator/handlers/StatusHandler.java`
- [Status contract](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorStatus.java): `src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorStatus.java`

### Elevator domain

- [Operating states](https://github.com/aimilia-fl/prog2-project/tree/main/src/main/java/gr/aueb/dmst/javengers/elevator/model): `src/main/java/gr/aueb/dmst/javengers/elevator/model`
- [Stop model](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/elevator/model/Stop.java): `src/main/java/gr/aueb/dmst/javengers/elevator/model/Stop.java`
- [Elevator config](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/elevator/model/ElevatorConfig.java): `src/main/java/gr/aueb/dmst/javengers/elevator/model/ElevatorConfig.java`

### Evaluation

- [Evaluation entry](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/EvaluationMain.java): `src/main/java/gr/aueb/dmst/javengers/Evaluation/EvaluationMain.java`
- [Random generator](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/Generator/RandomGenerator.java): `src/main/java/gr/aueb/dmst/javengers/Evaluation/Generator/RandomGenerator.java`
- [Math evaluator](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/MathEvaluator/MathEvaluator.java): `src/main/java/gr/aueb/dmst/javengers/Evaluation/MathEvaluator/MathEvaluator.java`
- [Evaluation storage](https://github.com/aimilia-fl/prog2-project/blob/main/src/main/java/gr/aueb/dmst/javengers/Evaluation/Storage/DataStorage.java): `src/main/java/gr/aueb/dmst/javengers/Evaluation/Storage/DataStorage.java`

### Other components

- **Passenger**
- **Elevator service**

## Connections

- Passenger → Terminal UI: enters floors (evidence: `src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java`)
- Terminal UI → Central server: POSTs request (evidence: `src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java`)
- Central server → Request handler: routes requests (evidence: `src/main/java/gr/aueb/dmst/javengers/central/CentralApp.java`)
- Terminal UI → Request contract: creates request (evidence: `src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java`)
- Request handler → Request contract: parses request (evidence: `src/main/java/gr/aueb/dmst/javengers/central/handlers/RequestHandler.java`)
- Terminal UI → Assignment response: parses assignment (evidence: `src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java`)
- Terminal UI → Request exceptions: handles errors (evidence: `src/main/java/gr/aueb/dmst/javengers/ui/UserInterface.java`)
- Status client → Elevator service: GETs status (evidence: `src/main/java/gr/aueb/dmst/javengers/central/handlers/StatusHandler.java`)
- Status client → Status contract: parses status (evidence: `src/main/java/gr/aueb/dmst/javengers/central/handlers/StatusHandler.java`)
- Status endpoint → Status contract: serializes status (evidence: `src/main/java/gr/aueb/dmst/javengers/elevator/handlers/StatusHandler.java`)
- Status contract → Operating states: uses state enums (evidence: `src/main/java/gr/aueb/dmst/javengers/common/dto/ElevatorStatus.java`)
- Stop model → Operating states: uses stop type (evidence: `src/main/java/gr/aueb/dmst/javengers/elevator/model/Stop.java`)
