# alexandra585/plataformalogistica_patrones architecture

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

- Interactive diagram: https://gitdiagram.com/alexandra585/plataformalogistica_patrones
- Repository: https://github.com/alexandra585/plataformalogistica_patrones

## Overview

AppLogistica is a Java Swing logistics operations desktop app. Its main workflow registers shipments, manages their operational state and tracking through delivery, and offers management functions including workforce/payroll and Jasper reports. The README documents several substantial features whose detailed wiring was not sampled; these are represented as subsystems without asserting unsupported calls. Edges are limited to relationships visible in sampled source, the SOURCE INDEX, or explicit README statements.

Main entry points: [`src/uni/controller/EmpleadoController.java`](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/controller/EmpleadoController.java) (Employee controller), [`src/uni/service/SeguimientoServiceProxy.java`](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/SeguimientoServiceProxy.java) (Tracking access proxy), [`src/uni/service/SeguimientoServiceImpl.java`](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/SeguimientoServiceImpl.java) (Tracking service), [`src/uni/dao/EnvioDao.java`](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/dao/EnvioDao.java) (Shipment data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop UI"]
  node_login["Login<br/>[LoginView.java]"]
  node_employee_ctrl["Employee controller"]
  node_session["User session<br/>[SesionUsuario.java]"]
  node_shipment_ui["Shipment entry<br/>[EnvioView.java]"]
  node_tracking_ui["Tracking and actions"]
  node_manifest_ui["Manifests"]
  node_workforce_ui["Workforce screens<br/>[EmpleadoView.java]"]
  node_reports_ui["Report screens<br/>[ReporteView.java]"]
end

subgraph group_ops["Shipment Operations"]
  node_registration["Shipment registration"]
  node_shipment_ctrl["Shipment controller"]
  node_shipment_context["Shipment lifecycle<br/>[EnvioContexto.java]"]
  node_tracking_proxy["Tracking access proxy"]
  node_tracking_service["Tracking service"]
  node_tracking_contract["Tracking contract"]
  node_shipment_memento["Shipment snapshots<br/>[EnvioMemento.java]"]
end

subgraph group_workforce["Workforce"]
  node_workforce_service["Workforce state"]
  node_payroll["Payroll and payslips"]
end

subgraph group_data["Persistence"]
  node_employee_dao["Employee data<br/>[EmpleadoDao.java]"]
  node_shipment_dao["Shipment data<br/>[EnvioDao.java]"]
  node_boleta_dao["Payslip data<br/>[BoletaDao.java]"]
  node_database[("MySQL connection<br/>[AccesoDB.java]")]
end

subgraph group_reporting["Reports"]
  node_report_engine["Jasper report bridge<br/>[Reporte.java]"]
  node_report_outputs["Report outputs"]
end

node_staff(("Staff user"))

node_staff -->|"signs in"| node_login
node_login -.->|"validates user"| node_employee_ctrl
node_employee_ctrl -->|"checks credentials"| node_employee_dao
node_employee_ctrl -->|"starts session"| node_session
node_staff -->|"enters shipment"| node_shipment_ui
node_shipment_ui -.->|"submits registration"| node_registration
node_registration -.->|"records shipment"| node_shipment_dao
node_shipment_ctrl -->|"delegates CRUD"| node_shipment_dao
node_tracking_ui -->|"requests tracking"| node_tracking_proxy
node_tracking_proxy -.->|"delegates operations"| node_tracking_service
node_tracking_proxy -->|"implements"| node_tracking_contract
node_tracking_service -->|"uses lifecycle"| node_shipment_context
node_tracking_service -->|"creates snapshots"| node_shipment_memento
node_staff -->|"manages manifests"| node_manifest_ui
node_workforce_ui -.->|"manages staff"| node_employee_ctrl
node_employee_ctrl -->|"changes labor state"| node_workforce_service
node_employee_ctrl -->|"creates payslip generator"| node_payroll
node_payroll -.->|"persists payslips"| node_boleta_dao
node_reports_ui -.->|"requests reports"| node_report_engine
node_report_engine -->|"uses output bridge"| node_report_outputs
node_employee_dao -->|"queries"| node_database
node_shipment_dao -->|"queries"| node_database
node_boleta_dao -.->|"queries"| node_database

click node_login "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/LoginView.java"
click node_employee_ctrl "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/controller/EmpleadoController.java"
click node_employee_dao "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/dao/EmpleadoDao.java"
click node_session "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/util/SesionUsuario.java"
click node_shipment_ui "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/EnvioView.java"
click node_registration "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/controller/RegistroEnvioFacade.java"
click node_shipment_ctrl "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/controller/EnvioController.java"
click node_shipment_dao "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/dao/EnvioDao.java"
click node_shipment_context "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/EnvioContexto.java"
click node_tracking_ui "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/SeguimientoView.java"
click node_tracking_proxy "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/SeguimientoServiceProxy.java"
click node_tracking_service "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/SeguimientoServiceImpl.java"
click node_tracking_contract "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/ISeguimientoService.java"
click node_shipment_memento "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/EnvioMemento.java"
click node_manifest_ui "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/ManifiestoView.java"
click node_workforce_ui "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/EmpleadoView.java"
click node_workforce_service "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/GestionLaboralService.java"
click node_payroll "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/GeneradorBoleta.java"
click node_boleta_dao "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/dao/BoletaDao.java"
click node_reports_ui "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/ReporteView.java"
click node_report_engine "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/reportes/Reporte.java"
click node_report_outputs "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/reportes/ISalidaReporte.java"
click node_database "https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/database/AccesoDB.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_login,node_employee_ctrl,node_session,node_shipment_ui,node_tracking_ui,node_manifest_ui,node_workforce_ui,node_reports_ui,node_staff toneBlue
class node_registration,node_shipment_ctrl,node_shipment_context,node_tracking_proxy,node_tracking_service,node_tracking_contract,node_shipment_memento toneAmber
class node_workforce_service,node_payroll toneMint
class node_employee_dao,node_shipment_dao,node_boleta_dao,node_database toneRose
class node_report_engine,node_report_outputs toneIndigo
```

## Components

### Desktop UI

- [Login](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/LoginView.java): `src/uni/formularios/LoginView.java`
- [Employee controller](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/controller/EmpleadoController.java): `src/uni/controller/EmpleadoController.java`
- [User session](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/util/SesionUsuario.java): `src/uni/util/SesionUsuario.java`
- [Shipment entry](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/EnvioView.java): `src/uni/formularios/EnvioView.java`
- [Tracking and actions](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/SeguimientoView.java): `src/uni/formularios/SeguimientoView.java`
- [Manifests](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/ManifiestoView.java): `src/uni/formularios/ManifiestoView.java`
- [Workforce screens](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/EmpleadoView.java): `src/uni/formularios/EmpleadoView.java`
- [Report screens](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/formularios/ReporteView.java): `src/uni/formularios/ReporteView.java`

### Shipment Operations

- [Shipment registration](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/controller/RegistroEnvioFacade.java): `src/uni/controller/RegistroEnvioFacade.java`
- [Shipment controller](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/controller/EnvioController.java): `src/uni/controller/EnvioController.java`
- [Shipment lifecycle](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/EnvioContexto.java): `src/uni/service/EnvioContexto.java`
- [Tracking access proxy](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/SeguimientoServiceProxy.java): `src/uni/service/SeguimientoServiceProxy.java`
- [Tracking service](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/SeguimientoServiceImpl.java): `src/uni/service/SeguimientoServiceImpl.java`
- [Tracking contract](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/ISeguimientoService.java): `src/uni/service/ISeguimientoService.java`
- [Shipment snapshots](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/EnvioMemento.java): `src/uni/service/EnvioMemento.java`

### Workforce

- [Workforce state](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/GestionLaboralService.java): `src/uni/service/GestionLaboralService.java`
- [Payroll and payslips](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/service/GeneradorBoleta.java): `src/uni/service/GeneradorBoleta.java`

### Persistence

- [Employee data](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/dao/EmpleadoDao.java): `src/uni/dao/EmpleadoDao.java`
- [Shipment data](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/dao/EnvioDao.java): `src/uni/dao/EnvioDao.java`
- [Payslip data](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/dao/BoletaDao.java): `src/uni/dao/BoletaDao.java`
- [MySQL connection](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/database/AccesoDB.java): `src/uni/database/AccesoDB.java`

### Reports

- [Jasper report bridge](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/reportes/Reporte.java): `src/uni/reportes/Reporte.java`
- [Report outputs](https://github.com/alexandra585/plataformalogistica_patrones/blob/main/src/uni/reportes/ISalidaReporte.java): `src/uni/reportes/ISalidaReporte.java`

### Other components

- **Staff user**

## Connections

- Staff user → Login: signs in
- Login → Employee controller: validates user
- Employee controller → Employee data: checks credentials (evidence: `src/uni/controller/EmpleadoController.java`)
- Employee controller → User session: starts session (evidence: `src/uni/controller/EmpleadoController.java`)
- Staff user → Shipment entry: enters shipment
- Shipment entry → Shipment registration: submits registration
- Shipment registration → Shipment data: records shipment
- Shipment controller → Shipment data: delegates CRUD (evidence: `src/uni/controller/EnvioController.java`)
- Tracking and actions → Tracking access proxy: requests tracking (evidence: `src/uni/formularios/SeguimientoView.java`)
- Tracking access proxy → Tracking service: delegates operations
- Tracking access proxy → Tracking contract: implements (evidence: `src/uni/service/SeguimientoServiceProxy.java`)
- Tracking service → Shipment lifecycle: uses lifecycle (evidence: `src/uni/service/SeguimientoServiceImpl.java`)
- Tracking service → Shipment snapshots: creates snapshots (evidence: `src/uni/service/SeguimientoServiceImpl.java`)
- Staff user → Manifests: manages manifests
- Workforce screens → Employee controller: manages staff
- Employee controller → Workforce state: changes labor state (evidence: `src/uni/controller/EmpleadoController.java`)
- Employee controller → Payroll and payslips: creates payslip generator (evidence: `src/uni/controller/EmpleadoController.java`)
- Payroll and payslips → Payslip data: persists payslips
- Report screens → Jasper report bridge: requests reports
- Jasper report bridge → Report outputs: uses output bridge (evidence: `src/uni/reportes/Reporte.java`)
- Employee data → MySQL connection: queries (evidence: `src/uni/dao/EmpleadoDao.java`)
- Shipment data → MySQL connection: queries (evidence: `src/uni/dao/EnvioDao.java`)
- Payslip data → MySQL connection: queries
