# d4c-prof/fleetflow architecture

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

## Overview

FleetFlow is presented as an integrated supply-chain and fleet-management platform, but the visible implementation is chiefly a Spring Boot Drivers service plus an Angular shell. The documented user path is Angular UI → REST backend → MySQL; within the sampled backend, assignment, hiccup, and assignment-history APIs are distinct domain stages. The README also describes procurement, inventory, transportation, delivery, and vehicle management, but their repository directories contain no sampled implementation. Those branches are shown as documented capabilities, not connected to an invented workflow. Some backend wiring is represented as unverified because its call sites were not excerpted.

Main entry points: [`Backend/Drivers/src/main/java/lockin/fleetflow/drivers/controller`](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/controller) (Driver APIs), [`Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java`](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java) (Assignment History), [`Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/AssignmentServiceImpl.java`](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/AssignmentServiceImpl.java) (Assignments), [`Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HiccupServiceImpl.java`](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HiccupServiceImpl.java) (Driver Hiccups)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User Interface"]
  node_angular["Angular App<br/>[app.ts]"]
end

subgraph group_driver["Driver Operations"]
  node_driver_api["Driver APIs"]
  node_assign_service["Assignments"]
  node_hiccup_service["Driver Hiccups"]
  node_history_service["Assignment History"]
  node_mapper["DTO Mapping<br/>[IMapper.java]"]
  node_driver_entities["Driver Domain Records"]
end

subgraph group_platform["Supply Chain Capabilities"]
  node_procurement["Procurement"]
  node_inventory["Inventory"]
  node_vehicles["Vehicle Management"]
  node_transport["Transportation"]
  node_deliveries["Delivery Tracking"]
end

subgraph group_data["Persistence"]
  node_assignment_repo["Assignment Store Access"]
  node_hiccup_repo["Hiccup Store Access"]
  node_history_repo["History Store Access"]
  node_mysql[("MySQL")]
end

node_user(("User"))

node_user -->|"uses"| node_angular
node_angular -->|"REST requests"| node_driver_api
node_driver_api -.->|"delegates to"| node_assign_service
node_driver_api -.->|"delegates to"| node_hiccup_service
node_driver_api -.->|"delegates to"| node_history_service
node_history_service -->|"reads and saves"| node_history_repo
node_history_service -->|"reads"| node_assignment_repo
node_history_service -->|"maps DTOs"| node_mapper
node_assign_service -.->|"uses"| node_assignment_repo
node_hiccup_service -.->|"uses"| node_hiccup_repo
node_assign_service -.->|"maps DTOs"| node_mapper
node_hiccup_service -.->|"maps DTOs"| node_mapper
node_driver_api -->|"backend persistence"| node_mysql

click node_angular "https://github.com/d4c-prof/fleetflow/blob/main/Frontend/src/app/app.ts"
click node_driver_api "https://github.com/d4c-prof/fleetflow/tree/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/controller"
click node_assign_service "https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/AssignmentServiceImpl.java"
click node_hiccup_service "https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HiccupServiceImpl.java"
click node_history_service "https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java"
click node_mapper "https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/dto/IMapper.java"
click node_assignment_repo "https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IAssignmentRepsitory.java"
click node_hiccup_repo "https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IHiccupRepository.java"
click node_history_repo "https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IHistoryRepository.java"
click node_driver_entities "https://github.com/d4c-prof/fleetflow/tree/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/domain"
click node_procurement "https://github.com/d4c-prof/fleetflow/tree/main/Backend/Users"
click node_inventory "https://github.com/d4c-prof/fleetflow/tree/main/Backend/Storage"
click node_vehicles "https://github.com/d4c-prof/fleetflow/tree/main/Backend/Vehicles"
click node_transport "https://github.com/d4c-prof/fleetflow/tree/main/Backend/Orders"
click node_deliveries "https://github.com/d4c-prof/fleetflow/tree/main/Backend/Deliveries"

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_angular,node_user toneBlue
class node_driver_api,node_assign_service,node_hiccup_service,node_history_service,node_mapper,node_driver_entities toneAmber
class node_procurement,node_inventory,node_vehicles,node_transport,node_deliveries toneMint
class node_assignment_repo,node_hiccup_repo,node_history_repo,node_mysql toneRose
```

## Components

### User Interface

- [Angular App](https://github.com/d4c-prof/fleetflow/blob/main/Frontend/src/app/app.ts): `Frontend/src/app/app.ts`

### Driver Operations

- [Driver APIs](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/controller): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/controller`
- [Assignments](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/AssignmentServiceImpl.java): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/AssignmentServiceImpl.java`
- [Driver Hiccups](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HiccupServiceImpl.java): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HiccupServiceImpl.java`
- [Assignment History](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java`
- [DTO Mapping](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/dto/IMapper.java): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/dto/IMapper.java`
- [Driver Domain Records](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/domain): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/domain`

### Supply Chain Capabilities

- [Procurement](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Users): `Backend/Users`
- [Inventory](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Storage): `Backend/Storage`
- [Vehicle Management](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Vehicles): `Backend/Vehicles`
- [Transportation](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Orders): `Backend/Orders`
- [Delivery Tracking](https://github.com/d4c-prof/fleetflow/tree/main/Backend/Deliveries): `Backend/Deliveries`

### Persistence

- [Assignment Store Access](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IAssignmentRepsitory.java): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IAssignmentRepsitory.java`
- [Hiccup Store Access](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IHiccupRepository.java): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IHiccupRepository.java`
- [History Store Access](https://github.com/d4c-prof/fleetflow/blob/main/Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IHistoryRepository.java): `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/repository/IHistoryRepository.java`
- **MySQL**

### Other components

- **User**

## Connections

- User → Angular App: uses (evidence: `README.md`)
- Angular App → Driver APIs: REST requests (evidence: `README.md`)
- Driver APIs → Assignments: delegates to
- Driver APIs → Driver Hiccups: delegates to
- Driver APIs → Assignment History: delegates to
- Assignment History → History Store Access: reads and saves (evidence: `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java`)
- Assignment History → Assignment Store Access: reads (evidence: `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java`)
- Assignment History → DTO Mapping: maps DTOs (evidence: `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HistoryServiceImpl.java`)
- Assignments → Assignment Store Access: uses (evidence: `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/AssignmentServiceImpl.java`)
- Driver Hiccups → Hiccup Store Access: uses (evidence: `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HiccupServiceImpl.java`)
- Assignments → DTO Mapping: maps DTOs (evidence: `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/AssignmentServiceImpl.java`)
- Driver Hiccups → DTO Mapping: maps DTOs (evidence: `Backend/Drivers/src/main/java/lockin/fleetflow/drivers/service/HiccupServiceImpl.java`)
- Driver APIs → MySQL: backend persistence (evidence: `README.md`)
