# cubickt/cargo architecture

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

## Overview

Cargo is a Java desktop tool for checking whether a selected cargo shape fits the railway clearance envelope on a curve. The workflow selects cargo, gathers track and structure parameters, classifies protrusions by degree and zone, computes permitted movement mode and minimum clearances, then displays a diagram. The graph keeps geometry and clearance-table data distinct from calculation and Swing presentation. Some setup and enum implementations were not excerpted, so their internal links are omitted where the shown evidence does not establish a call.

Main entry points: [`src/main/java/com/cargo/Calculator/Calculator.java`](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Calculator/Calculator.java) (Calculation orchestration), [`src/main/java/com/cargo/Calculator/ResultCalculator.java`](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Calculator/ResultCalculator.java) (Clearance and mode), [`src/main/java/com/cargo/Main.java`](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Main.java) (Application entry), [`src/main/java/com/cargo/ui/DrawPanel.java`](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/ui/DrawPanel.java) (Calculation diagram)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Application workflow"]
  node_entry["Application entry<br/>[Main.java]"]
  node_cargo_select["Cargo selection<br/>[Main.java]"]
  node_params["Track parameters"]
end

subgraph group_calculation["Clearance calculation"]
  node_calculator["Calculation orchestration<br/>[Calculator.java]"]
  node_degree_calc["Degree classification<br/>[GeometryUtils.java]"]
  node_result_calc["Clearance and mode"]
end

subgraph group_domain["Geometry and domain"]
  node_cargo_shape["Cargo and envelope<br/>[ShapeModel.java]"]
  node_zone_model["Oversize zones<br/>[ZoneModel.java]"]
  node_zone_init["Zone initialization"]
  node_geometry_shape["Geometry interface"]
  node_geometry_utils["Geometry utilities<br/>[GeometryUtils.java]"]
  node_utils["Coordinate utilities<br/>[Utils.java]"]
  node_result["Calculation result<br/>[Result.java]"]
  node_result_interface["Result interface"]
end

subgraph group_data["Clearance data"]
  node_degree_side["Side degrees<br/>[DegreesSide.java]"]
  node_degree_top["Top degrees<br/>[DegreesTop.java]"]
  node_degree_lower["Lower degrees<br/>[DegreesLower.java]"]
  node_gap_reader["Gap table reader"]
  node_gap_row["Gap table row<br/>[GapTableRow.java]"]
  node_gap_json["Clearance values<br/>[gapTable.json]"]
end

subgraph group_presentation["Diagram and UI"]
  node_main_frame["Results window<br/>[MainFrame.java]"]
  node_draw_panel["Calculation diagram<br/>[DrawPanel.java]"]
end

node_operator(("Operator"))

node_operator -->|"starts"| node_entry
node_entry -->|"offers choices"| node_cargo_select
node_operator -->|"selects cargo"| node_cargo_select
node_entry -->|"requests calculation"| node_calculator
node_calculator -->|"reads input"| node_params
node_operator -->|"enters parameters"| node_params
node_calculator -->|"classifies shape"| node_geometry_utils
node_geometry_utils -->|"implements"| node_degree_calc
node_calculator -->|"initializes zones"| node_zone_init
node_zone_init -->|"creates zones"| node_zone_model
node_calculator -->|"loads table"| node_gap_reader
node_gap_reader -->|"builds rows"| node_gap_row
node_gap_reader -.->|"reads resource"| node_gap_json
node_calculator -->|"delegates calculation"| node_result_calc
node_result_calc -->|"maps side degree"| node_degree_side
node_result_calc -->|"maps top degree"| node_degree_top
node_result_calc -->|"maps lower degree"| node_degree_lower
node_result_calc -->|"uses clearance rows"| node_gap_row
node_result_calc -->|"creates result"| node_result
node_cargo_select -->|"creates shape"| node_cargo_shape
node_cargo_shape -->|"implements"| node_geometry_shape
node_cargo_shape -->|"converts coordinates"| node_utils
node_degree_calc -->|"converts points"| node_utils
node_entry -->|"opens window"| node_main_frame
node_main_frame -->|"displays diagram"| node_draw_panel
node_draw_panel -->|"renders result"| node_result
node_draw_panel -->|"draws zones"| node_zone_model
node_draw_panel -->|"computes gaps"| node_geometry_utils
node_result -->|"retains parameters"| node_params

click node_entry "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Main.java"
click node_cargo_select "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Main.java"
click node_params "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/IO/CalculationParameters.java"
click node_calculator "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Calculator/Calculator.java"
click node_degree_calc "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/GeometryUtils.java"
click node_result_calc "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Calculator/ResultCalculator.java"
click node_degree_side "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/DegreesSide.java"
click node_degree_top "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/DegreesTop.java"
click node_degree_lower "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/DegreesLower.java"
click node_gap_reader "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/GapTableReader.java"
click node_gap_row "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/GapTableRow.java"
click node_gap_json "https://github.com/cubickt/cargo/blob/master/src/main/resources/com/cargo/data/gapTable.json"
click node_cargo_shape "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/ShapeModel.java"
click node_zone_model "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/ZoneModel.java"
click node_zone_init "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/InitializationUtils.java"
click node_geometry_shape "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/GeometricShape.java"
click node_geometry_utils "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/GeometryUtils.java"
click node_utils "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/Utils.java"
click node_result "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/Result.java"
click node_result_interface "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/ResultInterface.java"
click node_main_frame "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/ui/MainFrame.java"
click node_draw_panel "https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/ui/DrawPanel.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_entry,node_cargo_select,node_params toneBlue
class node_calculator,node_degree_calc,node_result_calc toneAmber
class node_cargo_shape,node_zone_model,node_zone_init,node_geometry_shape,node_geometry_utils,node_utils,node_result,node_result_interface toneMint
class node_degree_side,node_degree_top,node_degree_lower,node_gap_reader,node_gap_row,node_gap_json toneRose
class node_main_frame,node_draw_panel,node_operator toneIndigo
```

## Components

### Application workflow

- [Application entry](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Main.java): `src/main/java/com/cargo/Main.java`
- [Cargo selection](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Main.java): `src/main/java/com/cargo/Main.java`
- [Track parameters](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/IO/CalculationParameters.java): `src/main/java/com/cargo/IO/CalculationParameters.java`

### Clearance calculation

- [Calculation orchestration](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Calculator/Calculator.java): `src/main/java/com/cargo/Calculator/Calculator.java`
- [Degree classification](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/GeometryUtils.java): `src/main/java/com/cargo/util/GeometryUtils.java`
- [Clearance and mode](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/Calculator/ResultCalculator.java): `src/main/java/com/cargo/Calculator/ResultCalculator.java`

### Geometry and domain

- [Cargo and envelope](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/ShapeModel.java): `src/main/java/com/cargo/model/ShapeModel.java`
- [Oversize zones](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/ZoneModel.java): `src/main/java/com/cargo/model/ZoneModel.java`
- [Zone initialization](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/InitializationUtils.java): `src/main/java/com/cargo/util/InitializationUtils.java`
- [Geometry interface](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/GeometricShape.java): `src/main/java/com/cargo/util/GeometricShape.java`
- [Geometry utilities](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/GeometryUtils.java): `src/main/java/com/cargo/util/GeometryUtils.java`
- [Coordinate utilities](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/util/Utils.java): `src/main/java/com/cargo/util/Utils.java`
- [Calculation result](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/Result.java): `src/main/java/com/cargo/model/Result.java`
- [Result interface](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/model/ResultInterface.java): `src/main/java/com/cargo/model/ResultInterface.java`

### Clearance data

- [Side degrees](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/DegreesSide.java): `src/main/java/com/cargo/data/DegreesSide.java`
- [Top degrees](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/DegreesTop.java): `src/main/java/com/cargo/data/DegreesTop.java`
- [Lower degrees](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/DegreesLower.java): `src/main/java/com/cargo/data/DegreesLower.java`
- [Gap table reader](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/GapTableReader.java): `src/main/java/com/cargo/data/GapTableReader.java`
- [Gap table row](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/data/GapTableRow.java): `src/main/java/com/cargo/data/GapTableRow.java`
- [Clearance values](https://github.com/cubickt/cargo/blob/master/src/main/resources/com/cargo/data/gapTable.json): `src/main/resources/com/cargo/data/gapTable.json`

### Diagram and UI

- [Results window](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/ui/MainFrame.java): `src/main/java/com/cargo/ui/MainFrame.java`
- [Calculation diagram](https://github.com/cubickt/cargo/blob/master/src/main/java/com/cargo/ui/DrawPanel.java): `src/main/java/com/cargo/ui/DrawPanel.java`

### Other components

- **Operator**

## Connections

- Operator → Application entry: starts (evidence: `src/main/java/com/cargo/Main.java`)
- Application entry → Cargo selection: offers choices (evidence: `src/main/java/com/cargo/Main.java`)
- Operator → Cargo selection: selects cargo (evidence: `src/main/java/com/cargo/Main.java`)
- Application entry → Calculation orchestration: requests calculation (evidence: `src/main/java/com/cargo/Main.java`)
- Calculation orchestration → Track parameters: reads input (evidence: `src/main/java/com/cargo/Calculator/Calculator.java`)
- Operator → Track parameters: enters parameters (evidence: `src/main/java/com/cargo/IO/CalculationParameters.java`)
- Calculation orchestration → Geometry utilities: classifies shape (evidence: `src/main/java/com/cargo/Calculator/Calculator.java`)
- Geometry utilities → Degree classification: implements (evidence: `src/main/java/com/cargo/util/GeometryUtils.java`)
- Calculation orchestration → Zone initialization: initializes zones (evidence: `src/main/java/com/cargo/Calculator/Calculator.java`)
- Zone initialization → Oversize zones: creates zones (evidence: `src/main/java/com/cargo/util/InitializationUtils.java`)
- Calculation orchestration → Gap table reader: loads table (evidence: `src/main/java/com/cargo/Calculator/Calculator.java`)
- Gap table reader → Gap table row: builds rows (evidence: `src/main/java/com/cargo/data/GapTableReader.java`)
- Gap table reader → Clearance values: reads resource
- Calculation orchestration → Clearance and mode: delegates calculation (evidence: `src/main/java/com/cargo/Calculator/Calculator.java`)
- Clearance and mode → Side degrees: maps side degree (evidence: `src/main/java/com/cargo/Calculator/ResultCalculator.java`)
- Clearance and mode → Top degrees: maps top degree (evidence: `src/main/java/com/cargo/Calculator/ResultCalculator.java`)
- Clearance and mode → Lower degrees: maps lower degree (evidence: `src/main/java/com/cargo/Calculator/ResultCalculator.java`)
- Clearance and mode → Gap table row: uses clearance rows (evidence: `src/main/java/com/cargo/Calculator/ResultCalculator.java`)
- Clearance and mode → Calculation result: creates result (evidence: `src/main/java/com/cargo/Calculator/ResultCalculator.java`)
- Cargo selection → Cargo and envelope: creates shape (evidence: `src/main/java/com/cargo/Main.java`)
- Cargo and envelope → Geometry interface: implements (evidence: `src/main/java/com/cargo/model/ShapeModel.java`)
- Cargo and envelope → Coordinate utilities: converts coordinates (evidence: `src/main/java/com/cargo/model/ShapeModel.java`)
- Degree classification → Coordinate utilities: converts points (evidence: `src/main/java/com/cargo/util/GeometryUtils.java`)
- Application entry → Results window: opens window (evidence: `src/main/java/com/cargo/Main.java`)
- Results window → Calculation diagram: displays diagram (evidence: `src/main/java/com/cargo/ui/MainFrame.java`)
- Calculation diagram → Calculation result: renders result (evidence: `src/main/java/com/cargo/ui/DrawPanel.java`)
- Calculation diagram → Oversize zones: draws zones (evidence: `src/main/java/com/cargo/ui/DrawPanel.java`)
- Calculation diagram → Geometry utilities: computes gaps (evidence: `src/main/java/com/cargo/ui/DrawPanel.java`)
- Calculation result → Track parameters: retains parameters (evidence: `src/main/java/com/cargo/model/Result.java`)
