# bg68e9-lab/g1-uisrael-project architecture

> Architecture diagram of the GitHub repository bg68e9-lab/g1-uisrael-project, 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/bg68e9-lab/g1-uisrael-project
- Repository: https://github.com/bg68e9-lab/g1-uisrael-project

## Overview

Drinkhouse appears to be a Spring-based business inventory and purchasing API. A user submits purchase-order or inventory requests through REST controllers; controllers map DTOs to domain objects and invoke use cases, which delegate persistence to repository adapters and JPA. The sampled purchase flow also supports receiving orders into stock lots. The README provides no capability details, and most modules are unsampled; broader catalog, account, audit, and backup branches are represented at subsystem level without asserting unverified calls.

Main entry points: [`src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl`](https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl) (Other use cases), [`src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java`](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java) (Purchase adapter), [`src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java`](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java) (Purchase orders), [`src/main/java/com/uisrael/drinkhouse/presentacion/controladores/LoteProductoController.java`](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/LoteProductoController.java) (Stock lots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_purchase_api["Purchase orders"]
  node_inventory_api["Inventory endpoints"]
  node_lot_api["Stock lots"]
  node_movement_api["Stock movements"]
  node_other_api["Business resources"]
end

subgraph group_application["Application Logic"]
  node_purchase_uc["Purchase workflow"]
  node_other_uc["Other use cases"]
end

subgraph group_domain["Business Domain"]
  node_purchase_domain["Purchase orders<br/>[OrdenCompra.java]"]
  node_lot_domain["Stock lots<br/>[LoteProducto.java]"]
  node_inventory_domain["Inventory records<br/>[Producto.java]"]
  node_other_domain["Business entities"]
end

subgraph group_persistence["Persistence"]
  node_purchase_repo["Purchase adapter"]
  node_other_adapters["Repository adapters"]
  node_jpa_models["JPA entities"]
  node_database[("Relational store")]
end

node_user(("API client"))

node_user -->|"sends requests"| node_purchase_api
node_purchase_api -->|"invokes"| node_purchase_uc
node_purchase_api -->|"maps DTOs"| node_purchase_domain
node_purchase_uc -->|"delegates"| node_purchase_repo
node_purchase_uc -->|"validates transitions"| node_purchase_domain
node_purchase_repo -->|"maps and persists"| node_jpa_models
node_purchase_repo -.->|"reads and writes"| node_database
node_purchase_repo -->|"creates stock lots"| node_lot_domain
node_user -.->|"sends requests"| node_inventory_api
node_inventory_api -.->|"invokes"| node_other_uc
node_user -->|"sends requests"| node_lot_api
node_lot_api -.->|"maps DTOs"| node_lot_domain
node_lot_api -->|"invokes"| node_other_uc
node_user -.->|"sends requests"| node_movement_api
node_movement_api -->|"invokes"| node_other_uc
node_user -.->|"sends requests"| node_other_api
node_other_api -.->|"invokes"| node_other_uc
node_other_uc -.->|"delegates"| node_other_adapters
node_other_adapters -.->|"persists entities"| node_jpa_models
node_jpa_models -.->|"maps tables"| node_database

click node_purchase_api "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java"
click node_inventory_api "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/InventarioController.java"
click node_lot_api "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/LoteProductoController.java"
click node_movement_api "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/MovimientoInventarioController.java"
click node_other_api "https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores"
click node_purchase_uc "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl/OrdenCompraUseCaseImpl.java"
click node_other_uc "https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl"
click node_purchase_domain "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades/OrdenCompra.java"
click node_lot_domain "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades/LoteProducto.java"
click node_inventory_domain "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades/Producto.java"
click node_other_domain "https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades"
click node_purchase_repo "https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java"
click node_other_adapters "https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores"
click node_jpa_models "https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/jpa"

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_purchase_api,node_inventory_api,node_lot_api,node_movement_api,node_other_api,node_user toneBlue
class node_purchase_uc,node_other_uc toneAmber
class node_purchase_domain,node_lot_domain,node_inventory_domain,node_other_domain toneMint
class node_purchase_repo,node_other_adapters,node_jpa_models,node_database toneRose
```

## Components

### REST API

- [Purchase orders](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java): `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java`
- [Inventory endpoints](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/InventarioController.java): `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/InventarioController.java`
- [Stock lots](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/LoteProductoController.java): `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/LoteProductoController.java`
- [Stock movements](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores/MovimientoInventarioController.java): `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/MovimientoInventarioController.java`
- [Business resources](https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/presentacion/controladores): `src/main/java/com/uisrael/drinkhouse/presentacion/controladores`

### Application Logic

- [Purchase workflow](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl/OrdenCompraUseCaseImpl.java): `src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl/OrdenCompraUseCaseImpl.java`
- [Other use cases](https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl): `src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl`

### Business Domain

- [Purchase orders](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades/OrdenCompra.java): `src/main/java/com/uisrael/drinkhouse/dominio/entidades/OrdenCompra.java`
- [Stock lots](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades/LoteProducto.java): `src/main/java/com/uisrael/drinkhouse/dominio/entidades/LoteProducto.java`
- [Inventory records](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades/Producto.java): `src/main/java/com/uisrael/drinkhouse/dominio/entidades/Producto.java`
- [Business entities](https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/dominio/entidades): `src/main/java/com/uisrael/drinkhouse/dominio/entidades`

### Persistence

- [Purchase adapter](https://github.com/bg68e9-lab/g1-uisrael-project/blob/main/src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java): `src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java`
- [Repository adapters](https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores): `src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores`
- [JPA entities](https://github.com/bg68e9-lab/g1-uisrael-project/tree/main/src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/jpa): `src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/jpa`
- **Relational store**

### Other components

- **API client**

## Connections

- API client → Purchase orders: sends requests (evidence: `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java`)
- Purchase orders → Purchase workflow: invokes (evidence: `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java`)
- Purchase orders → Purchase orders: maps DTOs (evidence: `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/OrdenCompraController.java`)
- Purchase workflow → Purchase adapter: delegates (evidence: `src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl/OrdenCompraUseCaseImpl.java`)
- Purchase workflow → Purchase orders: validates transitions (evidence: `src/main/java/com/uisrael/drinkhouse/aplicacion/casosuso/impl/OrdenCompraUseCaseImpl.java`)
- Purchase adapter → JPA entities: maps and persists (evidence: `src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java`)
- Purchase adapter → Relational store: reads and writes
- Purchase adapter → Stock lots: creates stock lots (evidence: `src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java`)
- API client → Inventory endpoints: sends requests
- Inventory endpoints → Other use cases: invokes
- API client → Stock lots: sends requests (evidence: `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/LoteProductoController.java`)
- Stock lots → Stock lots: maps DTOs
- Stock lots → Other use cases: invokes (evidence: `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/LoteProductoController.java`)
- API client → Stock movements: sends requests
- Stock movements → Other use cases: invokes (evidence: `src/main/java/com/uisrael/drinkhouse/presentacion/controladores/MovimientoInventarioController.java`)
- API client → Business resources: sends requests
- Business resources → Other use cases: invokes
- Other use cases → Repository adapters: delegates
- Repository adapters → JPA entities: persists entities (evidence: `src/main/java/com/uisrael/drinkhouse/infraestructura/persistencia/adaptadores/OrdenCompraRepositorioImpl.java`)
- JPA entities → Relational store: maps tables
