# erehbani/coffee-system-backend architecture

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

- Interactive diagram: https://gitdiagram.com/erehbani/coffee-system-backend
- Repository: https://github.com/erehbani/coffee-system-backend

## Overview

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: [`src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java`](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java) (Purchases), [`src/main/java/com/CoffeeGroup/Coffee/System/features/product/CafeProductService.java`](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/product/CafeProductService.java) (Café Products), [`src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java`](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java) (Café Reviews), [`src/main/java/com/CoffeeGroup/Coffee/System/features/cafe/CafeService.java`](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/cafe/CafeService.java) (Café Management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Access"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_security["Role Security<br/>[SecurityUtils.java]"]
  node_users["User Accounts<br/>[UserService.java]"]
end

subgraph group_cafe_ops["Café Operations"]
  node_cafes["Café Management<br/>[CafeService.java]"]
  node_categories["Product Categories"]
  node_catalog["Product Catalog"]
  node_products["Café Products"]
end

subgraph group_loyalty["Loyalty Transactions"]
  node_cart["Shopping Cart<br/>[CartService.java]"]
  node_purchases["Purchases"]
  node_clients["Client Points<br/>[ClientService.java]"]
  node_tiers["Loyalty Tiers<br/>[TierService.java]"]
  node_formats["Benefit Formats"]
  node_benefits["Redeemable Benefits"]
  node_redemptions["Benefit Redemptions"]
end

subgraph group_engagement["Customer Engagement"]
  node_reviews["Café Reviews<br/>[ReviewService.java]"]
end

node_client(("Client"))

node_client -->|"authenticates"| node_auth
node_auth -->|"issues JWT session"| node_security
node_client -->|"browses"| node_products
node_cafes -->|"publishes products"| node_products
node_categories -.->|"organizes products"| node_products
node_products -->|"uses catalog"| node_catalog
node_client -->|"builds cart"| node_cart
node_cart -->|"creates purchase"| node_purchases
node_purchases -->|"reads cart"| node_cart
node_purchases -->|"awards points"| node_clients
node_purchases -->|"updates tier"| node_tiers
node_clients -->|"holds tier"| node_tiers
node_formats -->|"defines types"| node_benefits
node_client -->|"redeems benefits"| node_redemptions
node_benefits -.->|"supplies benefits"| node_redemptions
node_client -->|"writes reviews"| node_reviews
node_reviews -->|"loads café"| node_cafes
node_reviews -->|"validates purchase"| node_purchases
node_users -->|"backs café accounts"| node_cafes

click node_auth "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/auth/AuthService.java"
click node_security "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/auth/config/securityconfig/SecurityUtils.java"
click node_users "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/user/UserService.java"
click node_cafes "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/cafe/CafeService.java"
click node_categories "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/category/CategoryService.java"
click node_catalog "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/catalog/CatalogProductService.java"
click node_products "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/product/CafeProductService.java"
click node_cart "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/cart/CartService.java"
click node_purchases "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java"
click node_clients "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/client/ClientService.java"
click node_tiers "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/tier/TierService.java"
click node_formats "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/benefit_format/BenefitFormatService.java"
click node_benefits "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/benefit/BenefitService.java"
click node_redemptions "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/redemption/RedemptionService.java"
click node_reviews "https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.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,node_security,node_users,node_client toneBlue
class node_cafes,node_categories,node_catalog,node_products toneAmber
class node_cart,node_purchases,node_clients,node_tiers,node_formats,node_benefits,node_redemptions toneMint
class node_reviews toneRose
```

## Components

### Identity and Access

- [Authentication](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/auth/AuthService.java): `src/main/java/com/CoffeeGroup/Coffee/System/auth/AuthService.java`
- [Role Security](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/auth/config/securityconfig/SecurityUtils.java): `src/main/java/com/CoffeeGroup/Coffee/System/auth/config/securityconfig/SecurityUtils.java`
- [User Accounts](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/user/UserService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/user/UserService.java`

### Café Operations

- [Café Management](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/cafe/CafeService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/cafe/CafeService.java`
- [Product Categories](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/category/CategoryService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/category/CategoryService.java`
- [Product Catalog](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/catalog/CatalogProductService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/catalog/CatalogProductService.java`
- [Café Products](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/product/CafeProductService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/product/CafeProductService.java`

### Loyalty Transactions

- [Shopping Cart](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/cart/CartService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/cart/CartService.java`
- [Purchases](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java`
- [Client Points](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/client/ClientService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/client/ClientService.java`
- [Loyalty Tiers](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/tier/TierService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/tier/TierService.java`
- [Benefit Formats](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/benefit_format/BenefitFormatService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/benefit_format/BenefitFormatService.java`
- [Redeemable Benefits](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/benefit/BenefitService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/benefit/BenefitService.java`
- [Benefit Redemptions](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/redemption/RedemptionService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/redemption/RedemptionService.java`

### Customer Engagement

- [Café Reviews](https://github.com/erehbani/coffee-system-backend/blob/main/src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java): `src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java`

### Other components

- **Client**

## Connections

- 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 (evidence: `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 (evidence: `src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java`)
- Purchases → Client Points: awards points
- Purchases → Loyalty Tiers: updates tier (evidence: `src/main/java/com/CoffeeGroup/Coffee/System/features/purchase/PurchaseService.java`)
- Client Points → Loyalty Tiers: holds tier
- Benefit Formats → Redeemable Benefits: defines types (evidence: `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é (evidence: `src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java`)
- Café Reviews → Purchases: validates purchase (evidence: `src/main/java/com/CoffeeGroup/Coffee/System/features/review/ReviewService.java`)
- User Accounts → Café Management: backs café accounts
