# drodriguezgarces/poo_2024_25 architecture

> Architecture diagram of the GitHub repository drodriguezgarces/poo_2024_25, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/drodriguezgarces/poo_2024_25
- Repository: https://github.com/drodriguezgarces/poo_2024_25

## Overview

##### Project type and purpose
- This is a Java-based, console-driven OOP application (POO_2024_25) for managing mobility services (vehicles, trips, users, bases, maintenance staff, etc.).
- There is no web/UI layer; it follows a classic layered architecture: entry point → controller → service → domain models → utilities.

##### File structure
- Top-level folders:
– src/: Java source organized by package
· controller/ – SistemaController.java
· movilidad/ – Movilidad.java (main class)
· service/ – BaseService, UsuarioService, VehiculoService, ViajeService
· model/ – domain entities (Usuario, Vehiculo subclasses, Base, Viaje, Trabajador, etc.)
· util/ – Constants, ValidationUtils
· module-info.java – Java module descriptor
– bin/: compiled class output mirroring src/ packages
– README.md – project title only

##### Key architectural insights
- Layered pattern (somewhat MVC-inspired):
– Presentation/Orchestration: Movilidad (main) + SistemaController
– Business logic: Service layer
– Domain layer: Model classes
– Cross-cutting concerns: ValidationUtils, Constants
- No external persistence layer is visible (likely in-memory or future extension).

a. Main components
1. Movilidad (application entry point)
2. SistemaController (handles user input/commands)
3. Service Layer (BaseService, UsuarioService, VehiculoService, ViajeService)
4. Model Layer (domain entities: Usuario, Vehiculo, Base, Viaje, Trabajador, etc.)
5. Utility Layer (ValidationUtils, Constants)
b. Relationships & interactions
– Movilidad → invokes SistemaController methods
– SistemaController → calls appropriate Service methods
– Services ↔ manipulate Model objects (create/read/update domain entities)
– Services & Controller → utilize ValidationUtils and Constants for input checks/config values
c. Architectural patterns & principles
– Layered architecture (Separation of concerns)
– Single responsibility per class (e.g., each service handles one entity)
– Java Module System for modularization
d. Technologies & frameworks
– Java (SE), package modules (module-info.java)
– No external frameworks currently (pure Java implementation)

##### Final advice
– Ensure the module boundary (module-info.java) is shown if modularization is important to your architecture.
– Review the source to confirm any missing components (e.g., logging or exception-handling utilities) and add them.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Movilidad["Movilidad"]:::presentation
        SistemaController["SistemaController"]:::presentation
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        BaseService["BaseService"]:::service
        UsuarioService["UsuarioService"]:::service
        VehiculoService["VehiculoService"]:::service
        ViajeService["ViajeService"]:::service
    end

    %% Model Layer
    subgraph "Model Layer"
        direction TB
        Persona["Persona"]:::model
        Usuario["Usuario"]:::model
        Trabajador["Trabajador"]:::model
        EncargadoMantenimiento["EncargadoMantenimiento"]:::model
        Mecanico["Mecanico"]:::model
        Administrador["Administrador"]:::model
        Vehiculo["Vehiculo"]:::model
        Bicicleta["Bicicleta"]:::model
        Moto["Moto"]:::model
        Patinete["Patinete"]:::model
        Base["Base"]:::model
        Viaje["Viaje"]:::model
    end

    %% Utility Layer
    subgraph "Utility Layer"
        direction TB
        Constants["Constants"]:::utility
        ValidationUtils["ValidationUtils"]:::utility
    end

    %% Module and Output
    ModuleInfo["module-info.java"]:::module
    BinOutput["bin/ (compiled)"]:::module

    %% Relationships
    Movilidad -->|"invokes"| SistemaController
    SistemaController -->|"calls BaseService"| BaseService
    SistemaController -->|"calls UsuarioService"| UsuarioService
    SistemaController -->|"calls VehiculoService"| VehiculoService
    SistemaController -->|"calls ViajeService"| ViajeService

    BaseService -->|"manages"| Base
    UsuarioService -->|"manages"| Usuario
    VehiculoService -->|"manages"| Vehiculo
    VehiculoService -->|"handles subclasses"| Bicicleta
    VehiculoService -->|"handles subclasses"| Moto
    VehiculoService -->|"handles subclasses"| Patinete
    ViajeService -->|"manages"| Viaje

    BaseService -->|"validates with"| ValidationUtils
    UsuarioService -->|"validates with"| ValidationUtils
    VehiculoService -->|"validates with"| ValidationUtils
    ViajeService -->|"validates with"| ValidationUtils
    SistemaController -->|"uses constants"| Constants
    SistemaController -->|"uses validation"| ValidationUtils

    Persona -->|«superclass»| Usuario
    Persona -->|«superclass»| Trabajador
    Trabajador -->|«subclass»| EncargadoMantenimiento
    Trabajador -->|«subclass»| Mecanico
    Trabajador -->|«subclass»| Administrador

    ModuleInfo -.-> Movilidad
    ModuleInfo -.-> SistemaController
    ModuleInfo -.-> BaseService
    ModuleInfo -.-> UsuarioService
    ModuleInfo -.-> VehiculoService
    ModuleInfo -.-> ViajeService
    ModuleInfo -.-> Persona
    ModuleInfo -.-> ValidationUtils

    Movilidad -->|compiled to| BinOutput
    SistemaController -->|compiled to| BinOutput

    %% Click Events
    click Movilidad "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/movilidad/Movilidad.java"
    click SistemaController "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/controller/SistemaController.java"
    click BaseService "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/service/BaseService.java"
    click UsuarioService "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/service/UsuarioService.java"
    click VehiculoService "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/service/VehiculoService.java"
    click ViajeService "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/service/ViajeService.java"
    click Persona "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Persona.java"
    click Usuario "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Usuario.java"
    click Vehiculo "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Vehiculo.java"
    click Bicicleta "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Bicicleta.java"
    click Moto "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Moto.java"
    click Patinete "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Patinete.java"
    click Base "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Base.java"
    click Viaje "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Viaje.java"
    click Trabajador "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Trabajador.java"
    click EncargadoMantenimiento "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/EncargadoMantenimiento.java"
    click Mecanico "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Mecanico.java"
    click Administrador "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/model/Administrador.java"
    click Constants "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/util/Constants.java"
    click ValidationUtils "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/util/ValidationUtils.java"
    click ModuleInfo "https://github.com/drodriguezgarces/poo_2024_25/blob/main/src/module-info.java"
    click BinOutput "https://github.com/drodriguezgarces/poo_2024_25/tree/main/bin/"

    %% Styles
    classDef presentation fill:#D6E9F8,stroke:#1E90FF,color:#1E1E1E;
    classDef service fill:#DFF2BF,stroke:#4F8A10,color:#1E1E1E;
    classDef model fill:#FEEFB3,stroke:#9F6000,color:#1E1E1E;
    classDef utility fill:#E0E0E0,stroke:#A0A0A0,color:#1E1E1E;
    classDef module fill:#F4D6FF,stroke:#9B30FF,color:#1E1E1E;
```
