# gerardsmal/veicoli_base_09_2026 architecture

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

- Interactive diagram: https://gitdiagram.com/gerardsmal/veicoli_base_09_2026
- Repository: https://github.com/gerardsmal/veicoli_base_09_2026

## Overview

This is a small Java console vehicle registry. MainVeicoli supplies commands to StartVeicolo, which dispatches vehicle additions to type-specific handlers or requests a listing. Add handlers parse and validate shared and type-specific fields, then assign IDs and store vehicles in a singleton in-memory manager; the listing service prints that collection. The model classes represent shared vehicle fields and bicycle, car, and motorcycle extensions. Edges follow the excerpts and SOURCE INDEX references; no README or external integrations are present.

Main entry points: [`src/com/betacom/veicoli/singleton/ListManager.java`](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/singleton/ListManager.java) (In-memory registry), [`src/com/betacom/veicoli/process/StartVeicolo.java`](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/process/StartVeicolo.java) (Command dispatcher), [`src/com/betacom/veicoli/services/MacchinaImpl.java`](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/MacchinaImpl.java) (Car add), [`src/com/betacom/veicoli/services/MotoImpl.java`](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/MotoImpl.java) (Motorcycle add)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command entry"]
  node_main["Console main<br/>[MainVeicoli.java]"]
  node_dispatch["Command dispatcher<br/>[StartVeicolo.java]"]
end

subgraph group_services["Vehicle services"]
  node_common["Shared validation"]
  node_car_add["Car add<br/>[MacchinaImpl.java]"]
  node_moto_add["Motorcycle add<br/>[MotoImpl.java]"]
  node_bike_add["Bicycle add<br/>[BiciImpl.java]"]
  node_list["List vehicles<br/>[ListImpl.java]"]
end

subgraph group_models["Vehicle models"]
  node_vehicle["Vehicle base<br/>[Veicoli.java]"]
  node_car["Car model<br/>[Macchina.java]"]
  node_moto["Motorcycle model<br/>[Moto.java]"]
  node_bike["Bicycle model<br/>[Bici.java]"]
end

subgraph group_state["Registry state"]
  node_manager[("In-memory registry<br/>[ListManager.java]")]
end

node_main -->|"executes commands"| node_dispatch
node_dispatch -->|"dispatches car"| node_car_add
node_dispatch -->|"dispatches motorcycle"| node_moto_add
node_dispatch -->|"dispatches bicycle"| node_bike_add
node_dispatch -->|"requests listing"| node_list
node_dispatch -->|"loads constants"| node_manager
node_car_add -->|"validates shared fields"| node_common
node_moto_add -->|"validates shared fields"| node_common
node_bike_add -->|"validates shared fields"| node_common
node_car_add -->|"creates car"| node_car
node_moto_add -->|"creates motorcycle"| node_moto
node_bike_add -->|"creates bicycle"| node_bike
node_car -->|"extends"| node_vehicle
node_moto -->|"extends"| node_vehicle
node_bike -->|"extends"| node_vehicle
node_common -->|"checks allowed values"| node_manager
node_car_add -->|"checks and inserts"| node_manager
node_moto_add -->|"checks and inserts"| node_manager
node_bike_add -->|"validates and inserts"| node_manager
node_list -->|"reads collection"| node_manager
node_manager -->|"stores vehicles"| node_vehicle

click node_main "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/MainVeicoli.java"
click node_dispatch "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/process/StartVeicolo.java"
click node_common "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/VeicoloAbstract.java"
click node_car_add "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/MacchinaImpl.java"
click node_moto_add "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/MotoImpl.java"
click node_bike_add "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/BiciImpl.java"
click node_list "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/ListImpl.java"
click node_vehicle "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Veicoli.java"
click node_car "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Macchina.java"
click node_moto "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Moto.java"
click node_bike "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Bici.java"
click node_manager "https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/singleton/ListManager.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_main,node_dispatch toneBlue
class node_common,node_car_add,node_moto_add,node_bike_add,node_list toneAmber
class node_vehicle,node_car,node_moto,node_bike toneMint
class node_manager toneRose
```

## Components

### Command entry

- [Console main](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/MainVeicoli.java): `src/com/betacom/veicoli/MainVeicoli.java`
- [Command dispatcher](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/process/StartVeicolo.java): `src/com/betacom/veicoli/process/StartVeicolo.java`

### Vehicle services

- [Shared validation](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/VeicoloAbstract.java): `src/com/betacom/veicoli/services/VeicoloAbstract.java`
- [Car add](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/MacchinaImpl.java): `src/com/betacom/veicoli/services/MacchinaImpl.java`
- [Motorcycle add](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/MotoImpl.java): `src/com/betacom/veicoli/services/MotoImpl.java`
- [Bicycle add](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/BiciImpl.java): `src/com/betacom/veicoli/services/BiciImpl.java`
- [List vehicles](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/services/ListImpl.java): `src/com/betacom/veicoli/services/ListImpl.java`

### Vehicle models

- [Vehicle base](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Veicoli.java): `src/com/betacom/veicoli/models/Veicoli.java`
- [Car model](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Macchina.java): `src/com/betacom/veicoli/models/Macchina.java`
- [Motorcycle model](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Moto.java): `src/com/betacom/veicoli/models/Moto.java`
- [Bicycle model](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/models/Bici.java): `src/com/betacom/veicoli/models/Bici.java`

### Registry state

- [In-memory registry](https://github.com/gerardsmal/veicoli_base_09_2026/blob/main/src/com/betacom/veicoli/singleton/ListManager.java): `src/com/betacom/veicoli/singleton/ListManager.java`

## Connections

- Console main → Command dispatcher: executes commands (evidence: `src/com/betacom/veicoli/MainVeicoli.java`)
- Command dispatcher → Car add: dispatches car (evidence: `src/com/betacom/veicoli/process/StartVeicolo.java`)
- Command dispatcher → Motorcycle add: dispatches motorcycle (evidence: `src/com/betacom/veicoli/process/StartVeicolo.java`)
- Command dispatcher → Bicycle add: dispatches bicycle (evidence: `src/com/betacom/veicoli/process/StartVeicolo.java`)
- Command dispatcher → List vehicles: requests listing (evidence: `src/com/betacom/veicoli/process/StartVeicolo.java`)
- Command dispatcher → In-memory registry: loads constants (evidence: `src/com/betacom/veicoli/process/StartVeicolo.java`)
- Car add → Shared validation: validates shared fields (evidence: `src/com/betacom/veicoli/services/MacchinaImpl.java`)
- Motorcycle add → Shared validation: validates shared fields (evidence: `src/com/betacom/veicoli/services/MotoImpl.java`)
- Bicycle add → Shared validation: validates shared fields (evidence: `src/com/betacom/veicoli/services/BiciImpl.java`)
- Car add → Car model: creates car (evidence: `src/com/betacom/veicoli/services/MacchinaImpl.java`)
- Motorcycle add → Motorcycle model: creates motorcycle (evidence: `src/com/betacom/veicoli/services/MotoImpl.java`)
- Bicycle add → Bicycle model: creates bicycle (evidence: `src/com/betacom/veicoli/services/BiciImpl.java`)
- Car model → Vehicle base: extends (evidence: `src/com/betacom/veicoli/models/Macchina.java`)
- Motorcycle model → Vehicle base: extends (evidence: `src/com/betacom/veicoli/models/Moto.java`)
- Bicycle model → Vehicle base: extends (evidence: `src/com/betacom/veicoli/models/Bici.java`)
- Shared validation → In-memory registry: checks allowed values (evidence: `src/com/betacom/veicoli/services/VeicoloAbstract.java`)
- Car add → In-memory registry: checks and inserts (evidence: `src/com/betacom/veicoli/services/MacchinaImpl.java`)
- Motorcycle add → In-memory registry: checks and inserts (evidence: `src/com/betacom/veicoli/services/MotoImpl.java`)
- Bicycle add → In-memory registry: validates and inserts (evidence: `src/com/betacom/veicoli/services/BiciImpl.java`)
- List vehicles → In-memory registry: reads collection (evidence: `src/com/betacom/veicoli/services/ListImpl.java`)
- In-memory registry → Vehicle base: stores vehicles (evidence: `src/com/betacom/veicoli/singleton/ListManager.java`)
