# davidg199/ruta_express architecture

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

- Interactive diagram: https://gitdiagram.com/davidg199/ruta_express
- Repository: https://github.com/davidg199/ruta_express

## Overview

RutaExpress Antioquia is a Java logistics-management application operated through a JOptionPane menu. Users manage clients, delivery-network locations and roads, parcel intake and tracking, vehicle dispatch and delivery, PQR cases, reports, and configuration. The main documented path is menu → system facade → domain managers, with file-backed data and custom data structures supporting those operations. The README documents capabilities not visible in sampled implementations; those branches are included, but edges for them rely on that documentation rather than inspected calls.

Main entry points: [`src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java) (System facade), [`src/main/java/com/mycompany/rutaexpress/files/GestorArchivos.java`](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/files/GestorArchivos.java) (File access), [`src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java`](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java) (Delivery network), [`src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java`](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java) (Parcel management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_menu["Menu and dialogs<br/>[RutaExpress.java]"]
  node_system["System facade"]
end

subgraph group_operations["Logistics operations"]
  node_clients["Client management<br/>[ClientManager.java]"]
  node_network["Delivery network<br/>[RedManager.java]"]
  node_parcels["Parcel management"]
  node_fleet["Fleet management"]
  node_pqr["PQR cases<br/>[PqrManager.java]"]
  node_configuration["Configuration"]
end

subgraph group_support["Supporting services"]
  node_reports["Report generation"]
  node_files["File access"]
  node_notifications["Email notifications"]
end

subgraph group_storage["Persistence and structures"]
  node_datafiles[("Operational data files")]
  node_structures["Custom data structures"]
  node_graph["Network graph<br/>[GrafoRed.java]"]
  node_queue["Dispatch and case queues<br/>[Cola.java]"]
end

node_operator(("Operator"))
node_smtp["SMTP service"]

node_operator -->|"uses"| node_menu
node_menu -->|"invokes"| node_system
node_system -->|"delegates to"| node_clients
node_system -->|"delegates to"| node_network
node_system -->|"delegates to"| node_parcels
node_system -->|"delegates to"| node_fleet
node_system -->|"delegates to"| node_pqr
node_system -->|"delegates to"| node_configuration
node_system -->|"requests reports"| node_reports
node_parcels -->|"checks routes"| node_network
node_clients -->|"reads shipment history"| node_parcels
node_fleet -->|"uses route data"| node_network
node_clients -->|"reads and writes"| node_files
node_network -->|"reads and writes"| node_files
node_parcels -->|"reads and writes"| node_files
node_fleet -->|"reads and writes"| node_files
node_pqr -->|"reads and writes"| node_files
node_configuration -->|"reads configuration"| node_files
node_reports -->|"writes report"| node_files
node_files -->|"reads and writes"| node_datafiles
node_clients -->|"sends notices"| node_notifications
node_network -->|"sends notices"| node_notifications
node_parcels -->|"sends notices"| node_notifications
node_fleet -->|"sends notices"| node_notifications
node_notifications -->|"sends email"| node_smtp
node_notifications -->|"logs failures"| node_files
node_network -->|"uses graph"| node_graph
node_clients -->|"uses collections and index"| node_structures
node_parcels -->|"uses search tree"| node_structures
node_network -->|"manages dispatch queue"| node_queue
node_pqr -->|"uses case queue"| node_queue
node_fleet -.->|"loads queued parcels"| node_queue

click node_menu "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/ui/RutaExpress.java"
click node_system "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java"
click node_clients "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/client/ClientManager.java"
click node_network "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java"
click node_parcels "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java"
click node_fleet "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/vehicle/VehiculoManager.java"
click node_pqr "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/pqr/PqrManager.java"
click node_configuration "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/config/ConfiguracionManager.java"
click node_reports "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/files/GeneradorInformes.java"
click node_files "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/files/GestorArchivos.java"
click node_notifications "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/files/GestorNotificaciones.java"
click node_structures "https://github.com/davidg199/ruta_express/tree/main/src/main/java/com/mycompany/rutaexpress/estructures"
click node_graph "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/estructures/graphs/GrafoRed.java"
click node_queue "https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/estructures/queues/Cola.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_menu,node_system toneBlue
class node_clients,node_network,node_parcels,node_fleet,node_pqr,node_configuration toneAmber
class node_reports,node_files,node_notifications toneMint
class node_datafiles,node_structures,node_graph,node_queue toneRose
class node_operator,node_smtp toneIndigo
```

## Components

### User interface

- [Menu and dialogs](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/ui/RutaExpress.java): `src/main/java/com/mycompany/rutaexpress/ui/RutaExpress.java`
- [System facade](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java): `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`

### Logistics operations

- [Client management](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/client/ClientManager.java): `src/main/java/com/mycompany/rutaexpress/domain/client/ClientManager.java`
- [Delivery network](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java): `src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java`
- [Parcel management](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java): `src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java`
- [Fleet management](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/vehicle/VehiculoManager.java): `src/main/java/com/mycompany/rutaexpress/domain/vehicle/VehiculoManager.java`
- [PQR cases](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/pqr/PqrManager.java): `src/main/java/com/mycompany/rutaexpress/domain/pqr/PqrManager.java`
- [Configuration](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/domain/config/ConfiguracionManager.java): `src/main/java/com/mycompany/rutaexpress/domain/config/ConfiguracionManager.java`

### Supporting services

- [Report generation](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/files/GeneradorInformes.java): `src/main/java/com/mycompany/rutaexpress/files/GeneradorInformes.java`
- [File access](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/files/GestorArchivos.java): `src/main/java/com/mycompany/rutaexpress/files/GestorArchivos.java`
- [Email notifications](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/files/GestorNotificaciones.java): `src/main/java/com/mycompany/rutaexpress/files/GestorNotificaciones.java`

### Persistence and structures

- **Operational data files**
- [Custom data structures](https://github.com/davidg199/ruta_express/tree/main/src/main/java/com/mycompany/rutaexpress/estructures): `src/main/java/com/mycompany/rutaexpress/estructures`
- [Network graph](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/estructures/graphs/GrafoRed.java): `src/main/java/com/mycompany/rutaexpress/estructures/graphs/GrafoRed.java`
- [Dispatch and case queues](https://github.com/davidg199/ruta_express/blob/main/src/main/java/com/mycompany/rutaexpress/estructures/queues/Cola.java): `src/main/java/com/mycompany/rutaexpress/estructures/queues/Cola.java`

### Other components

- **Operator**
- **SMTP service**

## Connections

- Operator → Menu and dialogs: uses (evidence: `README.md`)
- Menu and dialogs → System facade: invokes (evidence: `src/main/java/com/mycompany/rutaexpress/ui/RutaExpress.java`)
- System facade → Client management: delegates to (evidence: `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`)
- System facade → Delivery network: delegates to (evidence: `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`)
- System facade → Parcel management: delegates to (evidence: `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`)
- System facade → Fleet management: delegates to (evidence: `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`)
- System facade → PQR cases: delegates to (evidence: `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`)
- System facade → Configuration: delegates to (evidence: `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`)
- System facade → Report generation: requests reports (evidence: `src/main/java/com/mycompany/rutaexpress/main/SistemaRutaExpress.java`)
- Parcel management → Delivery network: checks routes (evidence: `src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java`)
- Client management → Parcel management: reads shipment history (evidence: `src/main/java/com/mycompany/rutaexpress/domain/client/ClientManager.java`)
- Fleet management → Delivery network: uses route data (evidence: `src/main/java/com/mycompany/rutaexpress/domain/vehicle/VehiculoManager.java`)
- Client management → File access: reads and writes (evidence: `src/main/java/com/mycompany/rutaexpress/domain/client/ClientManager.java`)
- Delivery network → File access: reads and writes (evidence: `src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java`)
- Parcel management → File access: reads and writes (evidence: `src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java`)
- Fleet management → File access: reads and writes (evidence: `src/main/java/com/mycompany/rutaexpress/domain/vehicle/VehiculoManager.java`)
- PQR cases → File access: reads and writes (evidence: `src/main/java/com/mycompany/rutaexpress/domain/pqr/PqrManager.java`)
- Configuration → File access: reads configuration (evidence: `src/main/java/com/mycompany/rutaexpress/domain/config/ConfiguracionManager.java`)
- Report generation → File access: writes report (evidence: `src/main/java/com/mycompany/rutaexpress/files/GeneradorInformes.java`)
- File access → Operational data files: reads and writes (evidence: `src/main/java/com/mycompany/rutaexpress/files/GestorArchivos.java`)
- Client management → Email notifications: sends notices (evidence: `src/main/java/com/mycompany/rutaexpress/domain/client/ClientManager.java`)
- Delivery network → Email notifications: sends notices (evidence: `src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java`)
- Parcel management → Email notifications: sends notices (evidence: `src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java`)
- Fleet management → Email notifications: sends notices (evidence: `src/main/java/com/mycompany/rutaexpress/domain/vehicle/VehiculoManager.java`)
- Email notifications → SMTP service: sends email (evidence: `src/main/java/com/mycompany/rutaexpress/files/GestorNotificaciones.java`)
- Email notifications → File access: logs failures (evidence: `src/main/java/com/mycompany/rutaexpress/files/GestorNotificaciones.java`)
- Delivery network → Network graph: uses graph (evidence: `src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java`)
- Client management → Custom data structures: uses collections and index (evidence: `src/main/java/com/mycompany/rutaexpress/domain/client/ClientManager.java`)
- Parcel management → Custom data structures: uses search tree (evidence: `src/main/java/com/mycompany/rutaexpress/domain/parcel/PaqueteManager.java`)
- Delivery network → Dispatch and case queues: manages dispatch queue (evidence: `src/main/java/com/mycompany/rutaexpress/domain/network/RedManager.java`)
- PQR cases → Dispatch and case queues: uses case queue (evidence: `src/main/java/com/mycompany/rutaexpress/domain/pqr/PqrManager.java`)
- Fleet management → Dispatch and case queues: loads queued parcels (evidence: `README.md`)
