# augustoc99/tf-gestion-taller-mecanico architecture

> Architecture diagram of the GitHub repository augustoc99/tf-gestion-taller-mecanico, 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/augustoc99/tf-gestion-taller-mecanico
- Repository: https://github.com/augustoc99/tf-gestion-taller-mecanico

## Overview

MiTaller is a workshop-management and repair-traceability web application. Reception staff register customers and vehicles, open and assign work orders; mechanics record diagnosis and work, and staff advance the repair through controlled states to delivery. The frontend provides order, customer, vehicle, and user screens; a Spring REST API delegates business rules to services and persists records through repositories. The README documents the H2/JPA persistence layer. Some frontend modules and backend subsystems were not sampled, so their connections are shown only where routing, references, or documentation support them.

Main entry points: [`backend/src/main/java/com/taller/controller`](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/backend/src/main/java/com/taller/controller) (REST controllers), [`backend/src/main/java/com/taller/repository`](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/backend/src/main/java/com/taller/repository) (Data repositories), [`frontend/src/App.jsx`](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/frontend/src/App.jsx) (App routing), [`frontend/src/api/axios.js`](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/frontend/src/api/axios.js) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app["App routing<br/>[App.jsx]"]
  node_client_pages["Customer screens"]
  node_vehicle_pages["Vehicle screens"]
  node_order_pages["Order screens"]
  node_user_pages["User screens"]
  node_api_client["HTTP client<br/>[axios.js]"]
end

subgraph group_api["REST API"]
  node_rest_api["REST controllers"]
end

subgraph group_workshop["Workshop operations"]
  node_order_service["Order lifecycle"]
  node_work_service["Work details"]
end

subgraph group_records["Operational records"]
  node_customer_service["Customer management"]
  node_vehicle_service["Vehicle management"]
  node_user_service["User management"]
end

subgraph group_persistence["Persistence"]
  node_customers[("Customer records<br/>[Cliente.java]")]
  node_vehicles[("Vehicle records<br/>[Vehiculo.java]")]
  node_users[("User and roles<br/>[Usuario.java]")]
  node_orders[("Work orders<br/>[OrdenTrabajo.java]")]
  node_work_records[("Work and status history")]
  node_repositories["Data repositories"]
end

node_staff(("Workshop staff"))
node_h2[("H2 database")]

node_staff -->|"uses"| node_app
node_app -->|"routes to"| node_client_pages
node_app -->|"routes to"| node_vehicle_pages
node_app -->|"routes to"| node_order_pages
node_app -->|"routes to"| node_user_pages
node_client_pages -->|"calls"| node_api_client
node_vehicle_pages -.->|"calls"| node_api_client
node_order_pages -->|"calls"| node_api_client
node_user_pages -.->|"calls"| node_api_client
node_api_client -->|"HTTP JSON"| node_rest_api
node_rest_api -->|"delegates to"| node_customer_service
node_rest_api -->|"delegates to"| node_vehicle_service
node_rest_api -->|"delegates to"| node_user_service
node_rest_api -->|"delegates to"| node_order_service
node_rest_api -->|"delegates to"| node_work_service
node_customer_service -->|"reads and writes"| node_repositories
node_vehicle_service -->|"reads and writes"| node_repositories
node_user_service -->|"reads and writes"| node_repositories
node_order_service -->|"reads and writes"| node_repositories
node_work_service -->|"reads and writes"| node_repositories
node_repositories -->|"persists via JPA"| node_h2

click node_app "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/frontend/src/App.jsx"
click node_client_pages "https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/clientes"
click node_vehicle_pages "https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/vehiculos"
click node_order_pages "https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/ordenes"
click node_user_pages "https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/usuarios"
click node_api_client "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/frontend/src/api/axios.js"
click node_rest_api "https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/backend/src/main/java/com/taller/controller"
click node_customer_service "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/ClienteService.java"
click node_vehicle_service "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/VehiculoService.java"
click node_user_service "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/UsuarioService.java"
click node_order_service "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/OrdenTrabajoService.java"
click node_work_service "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/DetalleTrabajoService.java"
click node_customers "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/Cliente.java"
click node_vehicles "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/Vehiculo.java"
click node_users "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/Usuario.java"
click node_orders "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/OrdenTrabajo.java"
click node_work_records "https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/DetalleTrabajo.java"
click node_repositories "https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/backend/src/main/java/com/taller/repository"

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_app,node_client_pages,node_vehicle_pages,node_order_pages,node_user_pages,node_api_client toneBlue
class node_rest_api,node_h2 toneAmber
class node_order_service,node_work_service toneMint
class node_customer_service,node_vehicle_service,node_user_service toneRose
class node_customers,node_vehicles,node_users,node_orders,node_work_records,node_repositories,node_staff toneIndigo
```

## Components

### Web interface

- [App routing](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Customer screens](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/clientes): `frontend/src/paginas/clientes`
- [Vehicle screens](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/vehiculos): `frontend/src/paginas/vehiculos`
- [Order screens](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/ordenes): `frontend/src/paginas/ordenes`
- [User screens](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/frontend/src/paginas/usuarios): `frontend/src/paginas/usuarios`
- [HTTP client](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### REST API

- [REST controllers](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/backend/src/main/java/com/taller/controller): `backend/src/main/java/com/taller/controller`

### Workshop operations

- [Order lifecycle](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/OrdenTrabajoService.java): `backend/src/main/java/com/taller/service/OrdenTrabajoService.java`
- [Work details](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/DetalleTrabajoService.java): `backend/src/main/java/com/taller/service/DetalleTrabajoService.java`

### Operational records

- [Customer management](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/ClienteService.java): `backend/src/main/java/com/taller/service/ClienteService.java`
- [Vehicle management](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/VehiculoService.java): `backend/src/main/java/com/taller/service/VehiculoService.java`
- [User management](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/service/UsuarioService.java): `backend/src/main/java/com/taller/service/UsuarioService.java`

### Persistence

- [Customer records](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/Cliente.java): `backend/src/main/java/com/taller/entity/Cliente.java`
- [Vehicle records](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/Vehiculo.java): `backend/src/main/java/com/taller/entity/Vehiculo.java`
- [User and roles](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/Usuario.java): `backend/src/main/java/com/taller/entity/Usuario.java`
- [Work orders](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/OrdenTrabajo.java): `backend/src/main/java/com/taller/entity/OrdenTrabajo.java`
- [Work and status history](https://github.com/augustoc99/tf-gestion-taller-mecanico/blob/main/backend/src/main/java/com/taller/entity/DetalleTrabajo.java): `backend/src/main/java/com/taller/entity/DetalleTrabajo.java`
- [Data repositories](https://github.com/augustoc99/tf-gestion-taller-mecanico/tree/main/backend/src/main/java/com/taller/repository): `backend/src/main/java/com/taller/repository`

### Other components

- **Workshop staff**
- **H2 database**

## Connections

- Workshop staff → App routing: uses
- App routing → Customer screens: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Vehicle screens: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Order screens: routes to (evidence: `frontend/src/App.jsx`)
- App routing → User screens: routes to (evidence: `frontend/src/App.jsx`)
- Customer screens → HTTP client: calls (evidence: `frontend/src/paginas/clientes/PaginaFormularioCliente.jsx`)
- Vehicle screens → HTTP client: calls (evidence: `frontend/src/paginas/vehiculos/PaginaFormularioVehiculo.jsx`)
- Order screens → HTTP client: calls (evidence: `frontend/src/paginas/ordenes/PaginaDetalleOrden.jsx`)
- User screens → HTTP client: calls (evidence: `frontend/src/paginas/usuarios/PaginaFormularioUsuario.jsx`)
- HTTP client → REST controllers: HTTP JSON
- REST controllers → Customer management: delegates to (evidence: `backend/src/main/java/com/taller/controller/ClienteController.java`)
- REST controllers → Vehicle management: delegates to (evidence: `backend/src/main/java/com/taller/controller/VehiculoController.java`)
- REST controllers → User management: delegates to (evidence: `backend/src/main/java/com/taller/controller/UsuarioController.java`)
- REST controllers → Order lifecycle: delegates to (evidence: `backend/src/main/java/com/taller/controller/OrdenTrabajoController.java`)
- REST controllers → Work details: delegates to (evidence: `backend/src/main/java/com/taller/controller/OrdenTrabajoController.java`)
- Customer management → Data repositories: reads and writes (evidence: `backend/src/main/java/com/taller/service/ClienteService.java`)
- Vehicle management → Data repositories: reads and writes (evidence: `backend/src/main/java/com/taller/service/VehiculoService.java`)
- User management → Data repositories: reads and writes (evidence: `backend/src/main/java/com/taller/service/UsuarioService.java`)
- Order lifecycle → Data repositories: reads and writes (evidence: `backend/src/main/java/com/taller/service/OrdenTrabajoService.java`)
- Work details → Data repositories: reads and writes (evidence: `backend/src/main/java/com/taller/service/DetalleTrabajoService.java`)
- Data repositories → H2 database: persists via JPA
