# filip-ermenkov/tu-sofia-course-project architecture

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

- Interactive diagram: https://gitdiagram.com/filip-ermenkov/tu-sofia-course-project
- Repository: https://github.com/filip-ermenkov/tu-sofia-course-project

## Overview

Courier Shipment Management System is a C++20 console application for creating shipments, calculating charges, and tracking shipment status. Its documented workflow starts at the console entry point, creates a service-specific package through a factory, then relies on package behavior and shared value types for shipment details and pricing. Status transitions and input validation are handled in the domain layer. The README also mentions a history of logistics operations, but the available tree and excerpts do not establish its implementation or storage, so it is not shown as a separate subsystem.

Main entry points: [`src/Package.cpp`](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Package.cpp) (Package behavior), [`src/PackageFactory.cpp`](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/PackageFactory.cpp) (Package factory), [`src/Validation.cpp`](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Validation.cpp) (Input validation), [`src/ValidationException.cpp`](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/ValidationException.cpp) (Validation error)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Console entry"]
  node_app["Console application<br/>[main.cpp]"]
end

subgraph group_creation["Shipment creation"]
  node_factory["Package factory<br/>[PackageFactory.cpp]"]
end

subgraph group_domain["Shipment domain"]
  node_package["Package behavior<br/>[Package.cpp]"]
  node_standard["Standard service"]
  node_express["Express service<br/>[ExpressPackage.cpp]"]
  node_fragile["Fragile service<br/>[FragilePackage.cpp]"]
  node_status["Shipment status<br/>[PackageStatus.cpp]"]
  node_status_error["Status transition error"]
end

subgraph group_values["Values and validation"]
  node_dimensions["Parcel dimensions<br/>[Dimensions.cpp]"]
  node_money["Money arithmetic<br/>[Money.cpp]"]
  node_tracking["Tracking IDs<br/>[TrackingId.cpp]"]
  node_service_type["Service types<br/>[ServiceType.cpp]"]
  node_validation["Input validation<br/>[Validation.cpp]"]
  node_validation_error["Validation error"]
  node_logistics_error["Logistics errors"]
end

node_user(("Operator"))

node_user -.->|"uses"| node_app
node_app -->|"creates shipments"| node_factory
node_factory -->|"creates"| node_standard
node_factory -->|"creates"| node_express
node_factory -->|"creates"| node_fragile
node_standard -->|"extends"| node_package
node_express -->|"extends"| node_package
node_fragile -->|"extends"| node_package
node_package -->|"validates with"| node_validation
node_package -->|"checks transitions"| node_status
node_package -->|"throws"| node_status_error
node_dimensions -->|"validates with"| node_validation
node_tracking -->|"throws"| node_validation_error
node_validation -->|"throws"| node_validation_error
node_status_error -->|"extends"| node_logistics_error
node_validation_error -->|"extends"| node_logistics_error

click node_app "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/main.cpp"
click node_factory "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/PackageFactory.cpp"
click node_package "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Package.cpp"
click node_standard "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/StandardPackage.cpp"
click node_express "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/ExpressPackage.cpp"
click node_fragile "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/FragilePackage.cpp"
click node_status "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/PackageStatus.cpp"
click node_status_error "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/InvalidStatusChangeException.cpp"
click node_dimensions "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Dimensions.cpp"
click node_money "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Money.cpp"
click node_tracking "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/TrackingId.cpp"
click node_service_type "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/ServiceType.cpp"
click node_validation "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Validation.cpp"
click node_validation_error "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/ValidationException.cpp"
click node_logistics_error "https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/LogisticsException.cpp"

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 toneBlue
class node_factory toneAmber
class node_package,node_standard,node_express,node_fragile,node_status,node_status_error toneMint
class node_dimensions,node_money,node_tracking,node_service_type,node_validation,node_validation_error,node_logistics_error toneRose
class node_user toneIndigo
```

## Components

### Console entry

- [Console application](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/main.cpp): `src/main.cpp`

### Shipment creation

- [Package factory](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/PackageFactory.cpp): `src/PackageFactory.cpp`

### Shipment domain

- [Package behavior](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Package.cpp): `src/Package.cpp`
- [Standard service](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/StandardPackage.cpp): `src/StandardPackage.cpp`
- [Express service](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/ExpressPackage.cpp): `src/ExpressPackage.cpp`
- [Fragile service](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/FragilePackage.cpp): `src/FragilePackage.cpp`
- [Shipment status](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/PackageStatus.cpp): `src/PackageStatus.cpp`
- [Status transition error](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/InvalidStatusChangeException.cpp): `src/InvalidStatusChangeException.cpp`

### Values and validation

- [Parcel dimensions](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Dimensions.cpp): `src/Dimensions.cpp`
- [Money arithmetic](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Money.cpp): `src/Money.cpp`
- [Tracking IDs](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/TrackingId.cpp): `src/TrackingId.cpp`
- [Service types](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/ServiceType.cpp): `src/ServiceType.cpp`
- [Input validation](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/Validation.cpp): `src/Validation.cpp`
- [Validation error](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/ValidationException.cpp): `src/ValidationException.cpp`
- [Logistics errors](https://github.com/filip-ermenkov/tu-sofia-course-project/blob/main/src/LogisticsException.cpp): `src/LogisticsException.cpp`

### Other components

- **Operator**

## Connections

- Operator → Console application: uses
- Console application → Package factory: creates shipments (evidence: `src/main.cpp`)
- Package factory → Standard service: creates (evidence: `src/PackageFactory.cpp`)
- Package factory → Express service: creates (evidence: `src/PackageFactory.cpp`)
- Package factory → Fragile service: creates (evidence: `src/PackageFactory.cpp`)
- Standard service → Package behavior: extends
- Express service → Package behavior: extends
- Fragile service → Package behavior: extends
- Package behavior → Input validation: validates with (evidence: `src/Package.cpp`)
- Package behavior → Shipment status: checks transitions
- Package behavior → Status transition error: throws (evidence: `src/Package.cpp`)
- Parcel dimensions → Input validation: validates with (evidence: `src/Dimensions.cpp`)
- Tracking IDs → Validation error: throws (evidence: `src/TrackingId.cpp`)
- Input validation → Validation error: throws (evidence: `src/Validation.cpp`)
- Status transition error → Logistics errors: extends
- Validation error → Logistics errors: extends
