How elvisgarcia009/benitoventas works
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: OrderService.java Order lifecycle · AuthService.java Authentication · AuthResource.java Auth API · ProductResource.java Product API
Components 23
Identity and access
- Auth API
sales-auth/src/main/java/com/benito/sales/resource/AuthResource.java - Authentication
sales-auth/src/main/java/com/benito/sales/service/AuthService.java - User management
sales-auth/src/main/java/com/benito/sales/service/UserService.java - JWT tokens
sales-auth/src/main/java/com/benito/sales/service/TokenGenerator.java - User records
sales-auth/src/main/java/com/benito/sales/repository/UserRepository.java - Client profile client
sales-auth/src/main/java/com/benito/sales/restClient/ClientsApiClient.java
Product catalog
- Product API
sales-products/src/main/java/com/benito/sales/resource/ProductResource.java - Catalog management
sales-products/src/main/java/com/benito/sales/service/ProductService.java - Product records
sales-products/src/main/java/com/benito/sales/repository/ProductRepository.java
Client accounts
- Client API
sales-clients/src/main/java/com/benito/sales/resource/ClientResource.java - Client profiles and balance
sales-clients/src/main/java/com/benito/sales/service/ClientService.java - Client records
sales-clients/src/main/java/com/benito/sales/repository/ClientRepository.java
Order processing
- Order API
sales-orders/src/main/java/com/benito/sales/resource/OrderResource.java - Order lifecycle
sales-orders/src/main/java/com/benito/sales/service/OrderService.java - Order consumer
sales-orders/src/main/java/com/benito/sales/consumer/OrderConsumer.java - Order records
sales-orders/src/main/java/com/benito/sales/repository/OrderRepository.java - Service token client
sales-orders/src/main/java/com/benito/sales/service/ServiceTokenProvider.java - Auth service client
sales-orders/src/main/java/com/benito/sales/restClient/AuthApiClient.java - Clients service client
sales-orders/src/main/java/com/benito/sales/restClient/ClientsApiClient.java - Products service client
sales-orders/src/main/java/com/benito/sales/restClient/ProductsApiClient.java
Other components
- Customer
- Administrator
- Kafka order topic
Connections 29
- Customer → Product API: browse catalog
README.md - Customer → Auth API: register or login
README.md - Administrator → User management: manage users
README.md - Administrator → Product API: manage catalog
README.md - Administrator → Client API: manage clients
README.md - Administrator → Order API: manage orders
README.md - Auth API → Authentication: dispatches auth
- Auth API → User management: dispatches users
- Authentication → User records: reads and writes
sales-auth/src/main/java/com/benito/sales/service/AuthService.java - Authentication → JWT tokens: generates tokens
sales-auth/src/main/java/com/benito/sales/service/AuthService.java - Authentication → Client profile client: creates profile
sales-auth/src/main/java/com/benito/sales/service/AuthService.java - Client profile client → Client API: creates client
sales-auth/src/main/java/com/benito/sales/restClient/ClientsApiClient.java - User management → User records: reads and writes
sales-auth/src/main/java/com/benito/sales/service/UserService.java - Client API → Client profiles and balance: dispatches requests
sales-clients/src/main/java/com/benito/sales/resource/ClientResource.java - Client profiles and balance → Client records: reads and writes
sales-clients/src/main/java/com/benito/sales/service/ClientService.java - Product API → Catalog management: dispatches requests
- Catalog management → Product records: reads and writes
sales-products/src/main/java/com/benito/sales/service/ProductService.java - Order API → Order lifecycle: dispatches requests
- Order lifecycle → Order records: reads and writes
sales-orders/src/main/java/com/benito/sales/service/OrderService.java - Order lifecycle → Kafka order topic: publishes order
sales-orders/src/main/java/com/benito/sales/service/OrderService.java - Kafka order topic → Order consumer: delivers order
README.md - Order consumer → Order lifecycle: processes order
- Order lifecycle → Clients service client: gets client and debits
sales-orders/src/main/java/com/benito/sales/service/OrderService.java - Order lifecycle → Products service client: gets product details
sales-orders/src/main/java/com/benito/sales/service/OrderService.java - Order lifecycle → Service token client: obtains service token
sales-orders/src/main/java/com/benito/sales/service/OrderService.java - Service token client → Auth service client: requests token
sales-orders/src/main/java/com/benito/sales/service/ServiceTokenProvider.java - Auth service client → Auth API: requests service token
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