# elvisgarcia009/benitoventas architecture

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

- Interactive diagram: https://gitdiagram.com/elvisgarcia009/benitoventas
- Repository: https://github.com/elvisgarcia009/benitoventas

## Overview

Benito Ventas is a Quarkus microservices sales system. A customer can browse products, register (creating both an auth user and a client profile), then submit an order; orders are queued and processed by checking products and debiting the client balance. Admin capabilities include managing products, users, clients, and orders. The graph captures those documented domains and the sampled service interactions. Resource-to-service and some Kafka dispatch details are not shown in the excerpts, so those links are marked unverified.

Main entry points: [`sales-orders/src/main/java/com/benito/sales/service/OrderService.java`](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/service/OrderService.java) (Order lifecycle), [`sales-auth/src/main/java/com/benito/sales/service/AuthService.java`](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/service/AuthService.java) (Authentication), [`sales-auth/src/main/java/com/benito/sales/resource/AuthResource.java`](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/resource/AuthResource.java) (Auth API), [`sales-products/src/main/java/com/benito/sales/resource/ProductResource.java`](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-products/src/main/java/com/benito/sales/resource/ProductResource.java) (Product API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity and access"]
  node_auth_api["Auth API<br/>[AuthResource.java]"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_user_service["User management<br/>[UserService.java]"]
  node_token_generator["JWT tokens"]
  node_user_store[("User records")]
  node_auth_clients_client["Client profile client"]
end

subgraph group_products["Product catalog"]
  node_products_api["Product API"]
  node_product_service["Catalog management"]
  node_product_store[("Product records")]
end

subgraph group_clients["Client accounts"]
  node_clients_api["Client API"]
  node_client_service["Client profiles and balance<br/>[ClientService.java]"]
  node_client_store[("Client records")]
end

subgraph group_orders["Order processing"]
  node_orders_api["Order API<br/>[OrderResource.java]"]
  node_order_service["Order lifecycle<br/>[OrderService.java]"]
  node_order_consumer["Order consumer<br/>[OrderConsumer.java]"]
  node_order_store[("Order records")]
  node_service_tokens["Service token client"]
  node_auth_client["Auth service client<br/>[AuthApiClient.java]"]
  node_clients_client["Clients service client"]
  node_products_client["Products service client"]
end

node_customer(("Customer"))
node_admin(("Administrator"))
node_kafka["Kafka order topic"]

node_customer -.->|"browse catalog"| node_products_api
node_customer -.->|"register or login"| node_auth_api
node_admin -.->|"manage users"| node_user_service
node_admin -.->|"manage catalog"| node_products_api
node_admin -.->|"manage clients"| node_clients_api
node_admin -.->|"manage orders"| node_orders_api
node_auth_api -.->|"dispatches auth"| node_auth_service
node_auth_api -.->|"dispatches users"| node_user_service
node_auth_service -->|"reads and writes"| node_user_store
node_auth_service -->|"generates tokens"| node_token_generator
node_auth_service -->|"creates profile"| node_auth_clients_client
node_auth_clients_client -->|"creates client"| node_clients_api
node_user_service -->|"reads and writes"| node_user_store
node_clients_api -->|"dispatches requests"| node_client_service
node_client_service -->|"reads and writes"| node_client_store
node_products_api -.->|"dispatches requests"| node_product_service
node_product_service -->|"reads and writes"| node_product_store
node_orders_api -.->|"dispatches requests"| node_order_service
node_order_service -->|"reads and writes"| node_order_store
node_order_service -->|"publishes order"| node_kafka
node_kafka -.->|"delivers order"| node_order_consumer
node_order_consumer -.->|"processes order"| node_order_service
node_order_service -->|"gets client and debits"| node_clients_client
node_order_service -->|"gets product details"| node_products_client
node_order_service -.->|"obtains service token"| node_service_tokens
node_service_tokens -.->|"requests token"| node_auth_client
node_auth_client -->|"requests service token"| node_auth_api
node_clients_client -.->|"calls client service"| node_clients_api
node_products_client -.->|"calls product service"| node_products_api

click node_auth_api "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/resource/AuthResource.java"
click node_auth_service "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/service/AuthService.java"
click node_user_service "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/service/UserService.java"
click node_token_generator "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/service/TokenGenerator.java"
click node_user_store "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/repository/UserRepository.java"
click node_clients_api "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-clients/src/main/java/com/benito/sales/resource/ClientResource.java"
click node_client_service "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-clients/src/main/java/com/benito/sales/service/ClientService.java"
click node_client_store "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-clients/src/main/java/com/benito/sales/repository/ClientRepository.java"
click node_products_api "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-products/src/main/java/com/benito/sales/resource/ProductResource.java"
click node_product_service "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-products/src/main/java/com/benito/sales/service/ProductService.java"
click node_product_store "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-products/src/main/java/com/benito/sales/repository/ProductRepository.java"
click node_orders_api "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/resource/OrderResource.java"
click node_order_service "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/service/OrderService.java"
click node_order_consumer "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/consumer/OrderConsumer.java"
click node_order_store "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/repository/OrderRepository.java"
click node_service_tokens "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/service/ServiceTokenProvider.java"
click node_auth_client "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/restClient/AuthApiClient.java"
click node_clients_client "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/restClient/ClientsApiClient.java"
click node_products_client "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/restClient/ProductsApiClient.java"
click node_auth_clients_client "https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/restClient/ClientsApiClient.java"

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_auth_api,node_auth_service,node_user_service,node_token_generator,node_user_store,node_auth_clients_client toneBlue
class node_products_api,node_product_service,node_product_store toneAmber
class node_clients_api,node_client_service,node_client_store toneMint
class node_orders_api,node_order_service,node_order_consumer,node_order_store,node_service_tokens,node_auth_client,node_clients_client,node_products_client toneRose
class node_customer,node_admin,node_kafka toneIndigo
```

## Components

### Identity and access

- [Auth API](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/resource/AuthResource.java): `sales-auth/src/main/java/com/benito/sales/resource/AuthResource.java`
- [Authentication](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/service/AuthService.java): `sales-auth/src/main/java/com/benito/sales/service/AuthService.java`
- [User management](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/service/UserService.java): `sales-auth/src/main/java/com/benito/sales/service/UserService.java`
- [JWT tokens](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/service/TokenGenerator.java): `sales-auth/src/main/java/com/benito/sales/service/TokenGenerator.java`
- [User records](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/repository/UserRepository.java): `sales-auth/src/main/java/com/benito/sales/repository/UserRepository.java`
- [Client profile client](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-auth/src/main/java/com/benito/sales/restClient/ClientsApiClient.java): `sales-auth/src/main/java/com/benito/sales/restClient/ClientsApiClient.java`

### Product catalog

- [Product API](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-products/src/main/java/com/benito/sales/resource/ProductResource.java): `sales-products/src/main/java/com/benito/sales/resource/ProductResource.java`
- [Catalog management](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-products/src/main/java/com/benito/sales/service/ProductService.java): `sales-products/src/main/java/com/benito/sales/service/ProductService.java`
- [Product records](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-products/src/main/java/com/benito/sales/repository/ProductRepository.java): `sales-products/src/main/java/com/benito/sales/repository/ProductRepository.java`

### Client accounts

- [Client API](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-clients/src/main/java/com/benito/sales/resource/ClientResource.java): `sales-clients/src/main/java/com/benito/sales/resource/ClientResource.java`
- [Client profiles and balance](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-clients/src/main/java/com/benito/sales/service/ClientService.java): `sales-clients/src/main/java/com/benito/sales/service/ClientService.java`
- [Client records](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-clients/src/main/java/com/benito/sales/repository/ClientRepository.java): `sales-clients/src/main/java/com/benito/sales/repository/ClientRepository.java`

### Order processing

- [Order API](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/resource/OrderResource.java): `sales-orders/src/main/java/com/benito/sales/resource/OrderResource.java`
- [Order lifecycle](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/service/OrderService.java): `sales-orders/src/main/java/com/benito/sales/service/OrderService.java`
- [Order consumer](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/consumer/OrderConsumer.java): `sales-orders/src/main/java/com/benito/sales/consumer/OrderConsumer.java`
- [Order records](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/repository/OrderRepository.java): `sales-orders/src/main/java/com/benito/sales/repository/OrderRepository.java`
- [Service token client](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/service/ServiceTokenProvider.java): `sales-orders/src/main/java/com/benito/sales/service/ServiceTokenProvider.java`
- [Auth service client](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/restClient/AuthApiClient.java): `sales-orders/src/main/java/com/benito/sales/restClient/AuthApiClient.java`
- [Clients service client](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/restClient/ClientsApiClient.java): `sales-orders/src/main/java/com/benito/sales/restClient/ClientsApiClient.java`
- [Products service client](https://github.com/elvisgarcia009/benitoventas/blob/master/sales-orders/src/main/java/com/benito/sales/restClient/ProductsApiClient.java): `sales-orders/src/main/java/com/benito/sales/restClient/ProductsApiClient.java`

### Other components

- **Customer**
- **Administrator**
- **Kafka order topic**

## Connections

- Customer → Product API: browse catalog (evidence: `README.md`)
- Customer → Auth API: register or login (evidence: `README.md`)
- Administrator → User management: manage users (evidence: `README.md`)
- Administrator → Product API: manage catalog (evidence: `README.md`)
- Administrator → Client API: manage clients (evidence: `README.md`)
- Administrator → Order API: manage orders (evidence: `README.md`)
- Auth API → Authentication: dispatches auth
- Auth API → User management: dispatches users
- Authentication → User records: reads and writes (evidence: `sales-auth/src/main/java/com/benito/sales/service/AuthService.java`)
- Authentication → JWT tokens: generates tokens (evidence: `sales-auth/src/main/java/com/benito/sales/service/AuthService.java`)
- Authentication → Client profile client: creates profile (evidence: `sales-auth/src/main/java/com/benito/sales/service/AuthService.java`)
- Client profile client → Client API: creates client (evidence: `sales-auth/src/main/java/com/benito/sales/restClient/ClientsApiClient.java`)
- User management → User records: reads and writes (evidence: `sales-auth/src/main/java/com/benito/sales/service/UserService.java`)
- Client API → Client profiles and balance: dispatches requests (evidence: `sales-clients/src/main/java/com/benito/sales/resource/ClientResource.java`)
- Client profiles and balance → Client records: reads and writes (evidence: `sales-clients/src/main/java/com/benito/sales/service/ClientService.java`)
- Product API → Catalog management: dispatches requests
- Catalog management → Product records: reads and writes (evidence: `sales-products/src/main/java/com/benito/sales/service/ProductService.java`)
- Order API → Order lifecycle: dispatches requests
- Order lifecycle → Order records: reads and writes (evidence: `sales-orders/src/main/java/com/benito/sales/service/OrderService.java`)
- Order lifecycle → Kafka order topic: publishes order (evidence: `sales-orders/src/main/java/com/benito/sales/service/OrderService.java`)
- Kafka order topic → Order consumer: delivers order (evidence: `README.md`)
- Order consumer → Order lifecycle: processes order
- Order lifecycle → Clients service client: gets client and debits (evidence: `sales-orders/src/main/java/com/benito/sales/service/OrderService.java`)
- Order lifecycle → Products service client: gets product details (evidence: `sales-orders/src/main/java/com/benito/sales/service/OrderService.java`)
- Order lifecycle → Service token client: obtains service token (evidence: `sales-orders/src/main/java/com/benito/sales/service/OrderService.java`)
- Service token client → Auth service client: requests token (evidence: `sales-orders/src/main/java/com/benito/sales/service/ServiceTokenProvider.java`)
- Auth service client → Auth API: requests service token (evidence: `sales-orders/src/main/java/com/benito/sales/restClient/AuthApiClient.java`)
- Clients service client → Client API: calls client service
- Products service client → Product API: calls product service
