How erehbani/coffee-system-backend works
Coffee System is a Spring REST API for managing a café network and its points-based loyalty program. The documented customer journey is: browse café products, build a cart, create a purchase, earn points toward a tier, and redeem eligible benefits; customers can also review cafés. The graph preserves administration, authentication, benefit formats, and catalog capabilities. Workflow links are based on the README; service-to-service links use the shown source or SOURCE INDEX. Other internal wiring is not inferred from the file tree.
Main entry points: PurchaseService.java Purchases · CafeProductService.java Café Products · ReviewService.java Café Reviews · CafeService.java Café Management
Components 16
Identity and Access
- Authentication
src/main/java/com/CoffeeGroup/Coffee/System/auth/AuthService.java - Role Security
src/main/java/com/CoffeeGroup/Coffee/System/auth/config/securityconfig/SecurityUtils.java - User Accounts
src/main/java/com/CoffeeGroup/Coffee/System/features/user/UserService.java
Café Operations
- Café Management
src/main/java/com/CoffeeGroup/Coffee/System/features/cafe/CafeService.java - Product Categories
src/main/java/com/CoffeeGroup/Coffee/System/features/category/CategoryService.java - Product Catalog
src/main/java/com/CoffeeGroup/Coffee/System/features/catalog/CatalogProductService.java - Café Products
src/main/java/com/CoffeeGroup/Coffee/System/features/product/CafeProductService.java
Loyalty Transactions
- Shopping Cart
src/main/java/com/CoffeeGroup/Coffee/System/features/cart/CartService.java - Purchases
src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java - Client Points
src/main/java/com/CoffeeGroup/Coffee/System/features/client/ClientService.java - Loyalty Tiers
src/main/java/com/CoffeeGroup/Coffee/System/features/tier/TierService.java - Benefit Formats
src/main/java/com/CoffeeGroup/Coffee/System/features/benefit_format/BenefitFormatService.java - Redeemable Benefits
src/main/java/com/CoffeeGroup/Coffee/System/features/benefit/BenefitService.java - Benefit Redemptions
src/main/java/com/CoffeeGroup/Coffee/System/features/redemption/RedemptionService.java
Customer Engagement
- Café Reviews
src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java
Other components
- Client
Connections 19
- Client → Authentication: authenticates
- Authentication → Role Security: issues JWT session
- Client → Café Products: browses
- Café Management → Café Products: publishes products
- Product Categories → Café Products: organizes products
- Café Products → Product Catalog: uses catalog
src/main/java/com/CoffeeGroup/Coffee/System/features/product/CafeProductService.java - Client → Shopping Cart: builds cart
- Shopping Cart → Purchases: creates purchase
- Purchases → Shopping Cart: reads cart
src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java - Purchases → Client Points: awards points
- Purchases → Loyalty Tiers: updates tier
src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java - Client Points → Loyalty Tiers: holds tier
- Benefit Formats → Redeemable Benefits: defines types
src/main/java/com/CoffeeGroup/Coffee/System/features/benefit/BenefitService.java - Client → Benefit Redemptions: redeems benefits
- Redeemable Benefits → Benefit Redemptions: supplies benefits
- Client → Café Reviews: writes reviews
- Café Reviews → Café Management: loads café
src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java - Café Reviews → Purchases: validates purchase
src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java - User Accounts → Café Management: backs café accounts