# quantums-company/quantum_project architecture

> Architecture diagram of the GitHub repository quantums-company/quantum_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quantums-company/quantum_project
- Repository: https://github.com/quantums-company/quantum_project
- Video tour (about a minute): https://gitdiagram.com/quantums-company/quantum_project/video

## Overview

ByteBloom LogiRoute is a logistics and fleet-management application with a CLI entry point, domain use cases, and Supabase-backed repositories. The principal visible workflow initializes remote repositories, reads logistics entities, runs CRUD and greedy fleet-dispatch demonstrations, and formats domain errors for CLI users. The domain also provides routing, pricing, shipment planning, hub management, and reporting capabilities. The graph reflects documented boundaries and sampled calls; several domain capabilities are represented from the file tree without asserting unsampled wiring.

Main entry points: [`src/main/kotlin/org/bytebloom/presentation/Main.kt`](https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/presentation/Main.kt) (CLI runner), [`src/main/kotlin/org/bytebloom/data/repository/remote`](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/repository/remote) (Remote repositories), [`src/main/kotlin/org/bytebloom/data/remote/datasource`](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/remote/datasource) (SDK data sources), [`src/main/kotlin/org/bytebloom/data/remote/client/SupabaseClientProvider.kt`](https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/data/remote/client/SupabaseClientProvider.kt) (Client provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_main["CLI runner<br/>[Main.kt]"]
  node_crud_runner["CRUD runner"]
end

subgraph group_domain["Logistics domain"]
  node_greedy_dispatch["Fleet dispatch"]
  node_crud_usecases["Entity CRUD"]
  node_queries["Logistics queries"]
  node_routing["Route finding"]
  node_pricing["Shipping pricing"]
  node_hub_ops["Hub operations"]
  node_trees["Hub trees"]
  node_repository_interfaces["Repository contracts"]
  node_exceptions["Domain errors"]
end

subgraph group_data["Data access"]
  node_remote_repositories["Remote repositories"]
  node_remote_sources["SDK data sources"]
  node_remote_client["Client provider"]
end

subgraph group_csv["CSV workflows"]
  node_csv_repositories["CSV repositories"]
  node_csv_sources["CSV sources"]
  node_csv_cleaning["CSV cleaning"]
end

subgraph group_integrations["External systems"]
  node_supabase[("Supabase")]
end

node_operator(("CLI user"))

node_operator -->|"runs"| node_main
node_main -->|"creates client"| node_remote_client
node_main -->|"initializes"| node_remote_repositories
node_main -->|"runs CRUD"| node_crud_runner
node_main -->|"demonstrates"| node_greedy_dispatch
node_remote_repositories -->|"calls"| node_remote_sources
node_remote_repositories -->|"implements"| node_repository_interfaces
node_remote_client -->|"creates SDK client"| node_supabase
node_remote_sources -->|"accesses"| node_supabase
node_main -->|"formats errors"| node_exceptions
node_csv_repositories -->|"loads CSV data"| node_csv_sources
node_csv_cleaning -.->|"uploads data"| node_supabase

click node_main "https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/presentation/Main.kt"
click node_crud_runner "https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/presentation/CrudUseCaseRunner.kt"
click node_greedy_dispatch "https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/domain/usecase/greedy/GreedyFleetDispatchUseCase.kt"
click node_crud_usecases "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/usecase/crud"
click node_queries "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/usecase/queries"
click node_routing "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/routing"
click node_pricing "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/pricing"
click node_hub_ops "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/usecase/commands"
click node_trees "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/tree"
click node_repository_interfaces "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/repository"
click node_remote_repositories "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/repository/remote"
click node_remote_sources "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/remote/datasource"
click node_remote_client "https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/data/remote/client/SupabaseClientProvider.kt"
click node_exceptions "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/model/exception"
click node_csv_repositories "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/repository/csv"
click node_csv_sources "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/local/csv"
click node_csv_cleaning "https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/local/cleaner"

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_main,node_crud_runner,node_operator toneBlue
class node_greedy_dispatch,node_crud_usecases,node_queries,node_routing,node_pricing,node_hub_ops,node_trees,node_repository_interfaces,node_exceptions toneAmber
class node_remote_repositories,node_remote_sources,node_remote_client toneMint
class node_csv_repositories,node_csv_sources,node_csv_cleaning toneRose
class node_supabase toneIndigo
```

## Components

### Presentation

- [CLI runner](https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/presentation/Main.kt): `src/main/kotlin/org/bytebloom/presentation/Main.kt`
- [CRUD runner](https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/presentation/CrudUseCaseRunner.kt): `src/main/kotlin/org/bytebloom/presentation/CrudUseCaseRunner.kt`

### Logistics domain

- [Fleet dispatch](https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/domain/usecase/greedy/GreedyFleetDispatchUseCase.kt): `src/main/kotlin/org/bytebloom/domain/usecase/greedy/GreedyFleetDispatchUseCase.kt`
- [Entity CRUD](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/usecase/crud): `src/main/kotlin/org/bytebloom/domain/usecase/crud`
- [Logistics queries](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/usecase/queries): `src/main/kotlin/org/bytebloom/domain/usecase/queries`
- [Route finding](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/routing): `src/main/kotlin/org/bytebloom/domain/routing`
- [Shipping pricing](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/pricing): `src/main/kotlin/org/bytebloom/domain/pricing`
- [Hub operations](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/usecase/commands): `src/main/kotlin/org/bytebloom/domain/usecase/commands`
- [Hub trees](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/tree): `src/main/kotlin/org/bytebloom/domain/tree`
- [Repository contracts](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/repository): `src/main/kotlin/org/bytebloom/domain/repository`
- [Domain errors](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/domain/model/exception): `src/main/kotlin/org/bytebloom/domain/model/exception`

### Data access

- [Remote repositories](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/repository/remote): `src/main/kotlin/org/bytebloom/data/repository/remote`
- [SDK data sources](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/remote/datasource): `src/main/kotlin/org/bytebloom/data/remote/datasource`
- [Client provider](https://github.com/quantums-company/quantum_project/blob/master/src/main/kotlin/org/bytebloom/data/remote/client/SupabaseClientProvider.kt): `src/main/kotlin/org/bytebloom/data/remote/client/SupabaseClientProvider.kt`

### CSV workflows

- [CSV repositories](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/repository/csv): `src/main/kotlin/org/bytebloom/data/repository/csv`
- [CSV sources](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/local/csv): `src/main/kotlin/org/bytebloom/data/local/csv`
- [CSV cleaning](https://github.com/quantums-company/quantum_project/tree/master/src/main/kotlin/org/bytebloom/data/local/cleaner): `src/main/kotlin/org/bytebloom/data/local/cleaner`

### External systems

- **Supabase**

### Other components

- **CLI user**

## Connections

- CLI user → CLI runner: runs
- CLI runner → Client provider: creates client
- CLI runner → Remote repositories: initializes
- CLI runner → CRUD runner: runs CRUD
- CLI runner → Fleet dispatch: demonstrates
- Remote repositories → SDK data sources: calls
- Remote repositories → Repository contracts: implements
- Client provider → Supabase: creates SDK client
- SDK data sources → Supabase: accesses
- CLI runner → Domain errors: formats errors
- CSV repositories → CSV sources: loads CSV data
- CSV cleaning → Supabase: uploads data