How maydeixxx/loyaltyengine works
OmniPoint is a loyalty platform with a React storefront and Java microservices. The main purchase flow submits an idempotent transaction, publishes it through Kafka, calculates cashback in the rule engine, and applies the result to a wallet; user registration also triggers wallet initialization. The README documents the broader capabilities, including product catalog, rule administration, wallet controls, JWT/RBAC, and outbox-based event handling. Source excerpts confirm several service internals; unsampled links are included only where the README documents them.
Main entry points: GatewayServiceApplication.java API Gateway · App.tsx SPA Router · CalculateCashbackService.java Cashback Calculation · RuleEngineService.java Rule Management
Components 19
Web Experience
- SPA Router
frontend/src/App.tsx - Checkout UI
frontend/src/pages/CheckoutPage.tsx - Wallet UI
frontend/src/pages/WalletPage.tsx - Admin UI
frontend/src/pages/AdminPage.tsx
Gateway and Discovery
- API Gateway
GatewayService/src/main/java/com/LoyaltyEngine/GatewayService/GatewayServiceApplication.java - Service Discovery
EurekaServer/src/main/java/com/LoyaltyEngine/EurekaServer/EurekaServerApplication.java
Identity and Catalog
- User Accounts
UserService/src/main/java/com/LoyaltyEngine/UserService/services/UserService.java - Authentication
UserService/src/main/java/com/LoyaltyEngine/UserService/services/AuthService.java - Product Catalog
ProductService/src/main/java/com/LoyaltyEngine/ProductService/services/ProductService.java
Purchase and Cashback
- Transaction Processing
TransactionService/src/main/java/com/LoyaltyEngine/TransactionService/services/TransactionService.java - Rule Management
RuleEngineService/src/main/java/com/LoyaltyEngine/RuleEngineService/services/RuleEngineService.java - Cashback Calculation
RuleEngineService/src/main/java/com/LoyaltyEngine/RuleEngineService/services/CalculateCashbackService.java - Wallet Operations
WalletService/src/main/java/com/LoyaltyEngine/WalletService/services/WalletService.java
Event Infrastructure
- Kafka Events
- Rule Cache
RuleEngineService/src/main/java/com/LoyaltyEngine/RuleEngineService/services/configs/RedisConfig.java - Rule Database
RuleEngineService/src/main/java/com/LoyaltyEngine/RuleEngineService/services/interfaces/RuleEngineRepository.java - Transaction Outbox
TransactionService/src/main/java/com/LoyaltyEngine/TransactionService/services/TransactionService.java - Wallet Outbox
WalletService/src/main/java/com/LoyaltyEngine/WalletService/services/OutboxEventService.java
Other components
- Customer or Admin
Connections 27
- Customer or Admin → SPA Router: uses
- SPA Router → Checkout UI: routes to
frontend/src/App.tsx - SPA Router → Wallet UI: routes to
frontend/src/App.tsx - SPA Router → Admin UI: routes to
frontend/src/App.tsx - Checkout UI → API Gateway: submits purchase
- Wallet UI → API Gateway: uses API
- Admin UI → API Gateway: manages rules
- API Gateway → Service Discovery: discovers services
- API Gateway → Transaction Processing: routes requests
- API Gateway → User Accounts: routes requests
- API Gateway → Rule Management: routes requests
- API Gateway → Product Catalog: routes requests
- User Accounts → Authentication: authenticates users
UserService/src/main/java/com/LoyaltyEngine/UserService/services/AuthService.java - User Accounts → Kafka Events: publishes registration
- Transaction Processing → Transaction Outbox: records event
TransactionService/src/main/java/com/LoyaltyEngine/TransactionService/services/TransactionService.java - Transaction Outbox → Kafka Events: publishes transaction
- Kafka Events → Cashback Calculation: delivers transaction
- Cashback Calculation → Rule Cache: reads cached rules
- Cashback Calculation → Rule Database: reads rules
- Cashback Calculation → Kafka Events: publishes result
- Kafka Events → Wallet Operations: delivers result
- Wallet Operations → Wallet Outbox: saves events
WalletService/src/main/java/com/LoyaltyEngine/WalletService/services/WalletService.java - Wallet Outbox → Kafka Events: publishes outcome
- Kafka Events → Wallet Operations: initializes wallet
- Admin UI → Rule Management: configures cashback
- Rule Management → Rule Database: persists rules
RuleEngineService/src/main/java/com/LoyaltyEngine/RuleEngineService/services/RuleEngineService.java - Rule Management → Rule Cache: evicts cache
RuleEngineService/src/main/java/com/LoyaltyEngine/RuleEngineService/services/RuleEngineService.java