# ousamaka/tallermecanico architecture

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

- Interactive diagram: https://gitdiagram.com/ousamaka/tallermecanico
- Repository: https://github.com/ousamaka/tallermecanico

## Overview

##### Project type and purpose
- This is a Java console application (Gradle‑based) that manages a mechanical workshop (“Taller Mecánico”) using a layered MVC architecture.
- It allows CRUD of clients, vehicles and two kinds of jobs (Revisiones and Trabajos Mecánicos) with calculations of fixed and specific prices.

##### File structure
- src/main/java/org/iesalandalus/programacion/tallermecanico packages into controlador, modelo, modelo/negocio, modelo/dominio, vista.
- modelo/negocio has subpackages memoria (in‑memory DAO impl.) and (future) ficheros (file‑based DAO).
- Resources: UML files under src/main/resources/uml.
- Tests exercise dominio, negocio (ficheros), modelo, etc.

##### README for additional insights
- The application must refactor into MVC using:
- Observer (view ↔ controller event subscription)
- Factory Method (create Views and Models)
- Abstract Factory (create Data Sources)
- Template Method (calculate job prices)
- Existing patterns: static factory methods in domain (“get” methods), DTOs, DAOs in business layer.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Presentation Layer"
        direction TB
        Vista["Vista <<Factory Method>>"]:::frontend
        FabricaVista["FabricaVista <<Factory Method>>"]:::frontend
        VistaTexto["VistaTexto <<Concrete View>>"]:::frontend
        Consola["Consola <<Helper I/O>>"]:::frontend
        Evento["Evento <<Observer>>"]:::frontend
        GestorEventos["GestorEventos <<Observer>>"]:::frontend
        ReceptorEventos["ReceptorEventos <<Observer>>"]:::frontend
    end

    subgraph "Controller Layer"
        direction TB
        IControlador["IControlador <<Interface>>"]:::controller
        Controlador["Controlador <<Observer & Command Handler>>"]:::controller
    end

    subgraph "Model Layer"
        direction TB
        Modelo["Modelo <<Interface>>"]:::model
        FabricaModelo["FabricaModelo <<Factory Method>>"]:::model
        ModeloCascada["ModeloCascada <<Implementation>>"]:::model
        TallerMecanicoExcepcion["TallerMecanicoExcepcion"]:::model
    end

    subgraph "Business Layer"
        direction TB
        FabricaFuenteDatos["FabricaFuenteDatos <<Abstract Factory>>"]:::business
        IFuenteDatos["IFuenteDatos <<Interface>>"]:::business
        IClientes["IClientes <<DAO>>"]:::business
        IVehiculos["IVehiculos <<DAO>>"]:::business
        ITrabajos["ITrabajos <<DAO>>"]:::business

        subgraph "Data Sources (Memoria)"
            direction TB
            FuenteDatosMemoria["FuenteDatosMemoria <<Concrete Factory>>"]:::datasource
            ClientesMemoria["Clientes <<Memory DAO>>"]:::datasource
            VehiculosMemoria["Vehiculos <<Memory DAO>>"]:::datasource
            TrabajosMemoria["Trabajos <<Memory DAO>>"]:::datasource
        end
    end

    subgraph "Domain Entities"
        direction TB
        Trabajo["Trabajo <<Template Method>>"]:::domain
        Revision["Revision <<Template Method>>"]:::domain
        Mecanico["Mecanico <<Template Method>>"]:::domain
        Cliente["Cliente"]:::domain
        Vehiculo["Vehiculo"]:::domain
    end

    Main["Main <<Entry Point>>"]:::main

    %% Connections
    Main -->|uses| FabricaVista
    Main -->|uses| FabricaModelo
    Main -->|uses| FabricaFuenteDatos

    FabricaVista -->|creates| VistaTexto
    FabricaModelo -->|creates| ModeloCascada
    FabricaFuenteDatos -->|selects| FuenteDatosMemoria

    VistaTexto -->|uses| Consola
    VistaTexto -->|publishes| Evento
    Evento -->|sent to| GestorEventos
    GestorEventos -->|notifies| Controlador
    Controlador -->|implements| IControlador
    Controlador -->|calls| Modelo
    ModeloCascada -->|implements| Modelo
    ModeloCascada -->|delegates| IFuenteDatos
    IFuenteDatos -->|provides| IClientes
    IFuenteDatos -->|provides| IVehiculos
    IFuenteDatos -->|provides| ITrabajos

    FuenteDatosMemoria -->|implements| IFuenteDatos
    FuenteDatosMemoria -->|provides| ClientesMemoria
    FuenteDatosMemoria -->|provides| VehiculosMemoria
    FuenteDatosMemoria -->|provides| TrabajosMemoria

    ClientesMemoria -->|manages| Cliente
    VehiculosMemoria -->|manages| Vehiculo
    TrabajosMemoria -->|manages| Trabajo

    Trabajo -->|extended by| Revision
    Trabajo -->|extended by| Mecanico

    Controlador -->|returns| VistaTexto
    ModeloCascada -->|throws| TallerMecanicoExcepcion

    %% Click Events
    click Main "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/Main.java"
    click Vista "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/vista/Vista.java"
    click FabricaVista "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/vista/FabricaVista.java"
    click VistaTexto "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/vista/texto/VistaTexto.java"
    click Consola "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/vista/texto/Consola.java"
    click Evento "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/vista/eventos/Evento.java"
    click GestorEventos "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/vista/eventos/GestorEventos.java"
    click ReceptorEventos "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/vista/eventos/ReceptorEventos.java"
    click IControlador "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/controlador/IControlador.java"
    click Controlador "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/controlador/Controlador.java"
    click Modelo "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/Modelo.java"
    click FabricaModelo "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/FabricaModelo.java"
    click ModeloCascada "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/cascada/ModeloCascada.java"
    click TallerMecanicoExcepcion "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/TallerMecanicoExcepcion.java"
    click FabricaFuenteDatos "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/FabricaFuenteDatos.java"
    click IFuenteDatos "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/IFuenteDatos.java"
    click IClientes "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/IClientes.java"
    click IVehiculos "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/IVehiculos.java"
    click ITrabajos "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/ITrabajos.java"
    click FuenteDatosMemoria "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/memoria/FuenteDatosMemoria.java"
    click ClientesMemoria "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/memoria/Clientes.java"
    click VehiculosMemoria "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/memoria/Vehiculos.java"
    click TrabajosMemoria "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/negocio/memoria/Trabajos.java"
    click Trabajo "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/dominio/Trabajo.java"
    click Revision "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/dominio/Revision.java"
    click Mecanico "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/dominio/Mecanico.java"
    click Cliente "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/dominio/Cliente.java"
    click Vehiculo "https://github.com/ousamaka/tallermecanico/blob/master/src/main/java/org/iesalandalus/programacion/tallermecanico/modelo/dominio/Vehiculo.java"

    %% Styles
    classDef frontend fill:#AED6F1,stroke:#21618C,color:#1B2631;
    classDef controller fill:#A9DFBF,stroke:#196F3D,color:#1B2631;
    classDef model fill:#F9E79F,stroke:#B7950B,color:#1B2631;
    classDef business fill:#F5CBA7,stroke:#7E5109,color:#1B2631;
    classDef datasource fill:#EDBB99,stroke:#784212,color:#1B2631;
    classDef domain fill:#D7DBDD,stroke:#566573,color:#1B2631;
    classDef main fill:#FADBD8,stroke:#943126,color:#1B2631;
```
