# patriciopicchioni48-hub/tpe_ingenieria architecture

> Architecture diagram of the GitHub repository patriciopicchioni48-hub/tpe_ingenieria, 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/patriciopicchioni48-hub/tpe_ingenieria
- Repository: https://github.com/patriciopicchioni48-hub/tpe_ingenieria

## Overview

Trotamundos es un prototipo Go de recomendaciones de viajes. El flujo principal recibe feedback por HTTP, lo convierte en un evento y lo encola para que un worker lo procese en segundo plano; otro endpoint devuelve sugerencias precalculadas. El README también identifica un contrato OpenAPI estático. El procesamiento de IA y la actualización del perfil son simulados; no se muestra persistencia. Las relaciones del contrato con las rutas no están verificadas en los fragmentos disponibles.

Main entry points: [`cmd/api/main.go`](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/cmd/api/main.go) (Servidor y rutas), [`internal/recomendacion/controller.go`](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/controller.go) (Handlers HTTP), [`internal/recomendacion/facade.go`](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/facade.go) (Fachada feedback), [`pkg/broker/memory.go`](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/pkg/broker/memory.go) (Cola en memoria)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API HTTP"]
  node_server["Servidor y rutas<br/>[main.go]"]
  node_handlers["Handlers HTTP<br/>[controller.go]"]
end

subgraph group_recommendations["Recomendaciones"]
  node_facade["Fachada feedback<br/>[facade.go]"]
end

subgraph group_async["Procesamiento asíncrono"]
  node_broker["Cola en memoria<br/>[memory.go]"]
  node_worker["Worker recomendaciones<br/>[worker.go]"]
end

subgraph group_contract["Contrato API"]
  node_openapi["Especificación OpenAPI<br/>[openapi.yaml]"]
end

node_traveler(("Cliente"))

node_traveler -->|"envía HTTP"| node_server
node_server -->|"registra rutas"| node_handlers
node_server -->|"inicia"| node_worker
node_handlers -->|"registra feedback"| node_facade
node_facade -->|"publica evento"| node_broker
node_broker -->|"entrega eventos"| node_worker
node_handlers -->|"devuelve sugerencias"| node_traveler

click node_server "https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/cmd/api/main.go"
click node_handlers "https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/controller.go"
click node_facade "https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/facade.go"
click node_broker "https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/pkg/broker/memory.go"
click node_worker "https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/worker.go"
click node_openapi "https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/docs/api/openapi.yaml"

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_server,node_handlers,node_traveler toneBlue
class node_facade toneAmber
class node_broker,node_worker toneMint
class node_openapi toneRose
```

## Components

### API HTTP

- [Servidor y rutas](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/cmd/api/main.go): `cmd/api/main.go`
- [Handlers HTTP](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/controller.go): `internal/recomendacion/controller.go`

### Recomendaciones

- [Fachada feedback](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/facade.go): `internal/recomendacion/facade.go`

### Procesamiento asíncrono

- [Cola en memoria](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/pkg/broker/memory.go): `pkg/broker/memory.go`
- [Worker recomendaciones](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/internal/recomendacion/worker.go): `internal/recomendacion/worker.go`

### Contrato API

- [Especificación OpenAPI](https://github.com/patriciopicchioni48-hub/tpe_ingenieria/blob/main/docs/api/openapi.yaml): `docs/api/openapi.yaml`

### Other components

- **Cliente**

## Connections

- Cliente → Servidor y rutas: envía HTTP (evidence: `README.md`)
- Servidor y rutas → Handlers HTTP: registra rutas (evidence: `cmd/api/main.go`)
- Servidor y rutas → Worker recomendaciones: inicia (evidence: `cmd/api/main.go`)
- Handlers HTTP → Fachada feedback: registra feedback (evidence: `internal/recomendacion/controller.go`)
- Fachada feedback → Cola en memoria: publica evento (evidence: `internal/recomendacion/facade.go`)
- Cola en memoria → Worker recomendaciones: entrega eventos (evidence: `internal/recomendacion/worker.go`)
- Handlers HTTP → Cliente: devuelve sugerencias (evidence: `internal/recomendacion/controller.go`)
