# codefarm0/coupon-redemption-system architecture

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

- Interactive diagram: https://gitdiagram.com/codefarm0/coupon-redemption-system
- Repository: https://github.com/codefarm0/coupon-redemption-system

## Overview

A React coupon dashboard drives a Spring Boot coupon API: users create and browse coupons, issue concurrent redemption attempts, and inspect paginated redemption history. The service protects redemption updates with a configurable lock strategy, records outcomes, and persists coupon and redemption data. README documents Nginx load balancing and MySQL/Redis deployment; the sampled service implementation and repository interfaces establish the internal lock, transaction, and persistence calls, while deployment wiring is represented as documented rather than inferred from unsampled code.

Main entry points: [`coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java`](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java) (Coupon redemption service), [`frontend-react/src/api/client.js`](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/api/client.js) (HTTP API client), [`frontend-react/src/components/CouponCard.jsx`](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/CouponCard.jsx) (Coupon list and cards), [`frontend-react/src/App.jsx`](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/App.jsx) (Dashboard app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Coupon dashboard"]
  node_app["Dashboard app<br/>[App.jsx]"]
  node_coupon_ui["Coupon list and cards<br/>[CouponCard.jsx]"]
  node_create_ui["Create coupon form<br/>[CreateCoupon.jsx]"]
  node_history_ui["Redemption history"]
  node_redemption_dialog["Redemption dialog"]
  node_api_client["HTTP API client<br/>[client.js]"]
end

subgraph group_api["Coupon API"]
  node_nginx["Nginx load balancer<br/>[nginx.conf]"]
  node_controller["Coupon REST endpoints"]
end

subgraph group_domain["Redemption domain"]
  node_service["Coupon redemption service"]
  node_dto["API request and response DTOs"]
  node_errors["Coupon error handling"]
end

subgraph group_storage["Persistence and locking"]
  node_lock_config["Lock strategy configuration<br/>[LockConfig.java]"]
  node_lock_strategy["Lock strategy<br/>[LockStrategy.java]"]
  node_redis_lock["Redis lock implementation"]
  node_coupon_repo["Coupon repository"]
  node_redemption_repo["Redemption repository"]
  node_coupon_entity["Coupon entity<br/>[Coupon.java]"]
  node_redemption_entity["Redemption entity"]
end

node_browser(("Dashboard user"))
node_mysql[("MySQL database")]
node_redis[("Redis")]

node_browser -->|"uses"| node_app
node_app -->|"renders"| node_coupon_ui
node_app -->|"renders"| node_history_ui
node_coupon_ui -->|"requests coupons"| node_api_client
node_coupon_ui -->|"submits redemptions"| node_api_client
node_coupon_ui -->|"shows results"| node_redemption_dialog
node_create_ui -->|"creates coupons"| node_api_client
node_history_ui -->|"loads history"| node_api_client
node_api_client -->|"HTTP requests"| node_nginx
node_nginx -->|"balances requests"| node_controller
node_controller -->|"delegates"| node_service
node_controller -->|"accepts and returns"| node_dto
node_service -->|"maps responses"| node_dto
node_service -->|"acquires and releases"| node_lock_strategy
node_lock_config -->|"provides implementation"| node_lock_strategy
node_lock_strategy -->|"implemented by"| node_redis_lock
node_redis_lock -.->|"lock operations"| node_redis
node_service -->|"reads and writes"| node_coupon_repo
node_service -->|"records and queries"| node_redemption_repo
node_coupon_repo -->|"persists"| node_coupon_entity
node_redemption_repo -->|"persists"| node_redemption_entity
node_coupon_repo -.->|"database access"| node_mysql
node_redemption_repo -.->|"database access"| node_mysql
node_service -.->|"throws domain errors"| node_errors

click node_app "https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/App.jsx"
click node_coupon_ui "https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/CouponCard.jsx"
click node_create_ui "https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/CreateCoupon.jsx"
click node_history_ui "https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/RedemptionHistory.jsx"
click node_redemption_dialog "https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/RedemptionDialog.jsx"
click node_api_client "https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/api/client.js"
click node_nginx "https://github.com/codefarm0/coupon-redemption-system/blob/main/nginx/nginx.conf"
click node_controller "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java"
click node_service "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java"
click node_dto "https://github.com/codefarm0/coupon-redemption-system/tree/main/coupon-service/src/main/java/in/codefarm/coupon/service/dto"
click node_errors "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/exception/GlobalExceptionHandler.java"
click node_lock_config "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/config/LockConfig.java"
click node_lock_strategy "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/lock/LockStrategy.java"
click node_redis_lock "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/lock/RedisLockStrategy.java"
click node_coupon_repo "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRepository.java"
click node_redemption_repo "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRedemptionRepository.java"
click node_coupon_entity "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/entity/Coupon.java"
click node_redemption_entity "https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/entity/CouponRedemption.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_app,node_coupon_ui,node_create_ui,node_history_ui,node_redemption_dialog,node_api_client,node_browser toneBlue
class node_nginx,node_controller,node_mysql,node_redis toneAmber
class node_service,node_dto,node_errors toneMint
class node_lock_config,node_lock_strategy,node_redis_lock,node_coupon_repo,node_redemption_repo,node_coupon_entity,node_redemption_entity toneRose
```

## Components

### Coupon dashboard

- [Dashboard app](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/App.jsx): `frontend-react/src/App.jsx`
- [Coupon list and cards](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/CouponCard.jsx): `frontend-react/src/components/CouponCard.jsx`
- [Create coupon form](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/CreateCoupon.jsx): `frontend-react/src/components/CreateCoupon.jsx`
- [Redemption history](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/RedemptionHistory.jsx): `frontend-react/src/components/RedemptionHistory.jsx`
- [Redemption dialog](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/components/RedemptionDialog.jsx): `frontend-react/src/components/RedemptionDialog.jsx`
- [HTTP API client](https://github.com/codefarm0/coupon-redemption-system/blob/main/frontend-react/src/api/client.js): `frontend-react/src/api/client.js`

### Coupon API

- [Nginx load balancer](https://github.com/codefarm0/coupon-redemption-system/blob/main/nginx/nginx.conf): `nginx/nginx.conf`
- [Coupon REST endpoints](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java): `coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java`

### Redemption domain

- [Coupon redemption service](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java): `coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java`
- [API request and response DTOs](https://github.com/codefarm0/coupon-redemption-system/tree/main/coupon-service/src/main/java/in/codefarm/coupon/service/dto): `coupon-service/src/main/java/in/codefarm/coupon/service/dto`
- [Coupon error handling](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/exception/GlobalExceptionHandler.java): `coupon-service/src/main/java/in/codefarm/coupon/service/exception/GlobalExceptionHandler.java`

### Persistence and locking

- [Lock strategy configuration](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/config/LockConfig.java): `coupon-service/src/main/java/in/codefarm/coupon/service/config/LockConfig.java`
- [Lock strategy](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/lock/LockStrategy.java): `coupon-service/src/main/java/in/codefarm/coupon/service/lock/LockStrategy.java`
- [Redis lock implementation](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/lock/RedisLockStrategy.java): `coupon-service/src/main/java/in/codefarm/coupon/service/lock/RedisLockStrategy.java`
- [Coupon repository](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRepository.java): `coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRepository.java`
- [Redemption repository](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRedemptionRepository.java): `coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRedemptionRepository.java`
- [Coupon entity](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/entity/Coupon.java): `coupon-service/src/main/java/in/codefarm/coupon/service/entity/Coupon.java`
- [Redemption entity](https://github.com/codefarm0/coupon-redemption-system/blob/main/coupon-service/src/main/java/in/codefarm/coupon/service/entity/CouponRedemption.java): `coupon-service/src/main/java/in/codefarm/coupon/service/entity/CouponRedemption.java`

### Other components

- **Dashboard user**
- **MySQL database**
- **Redis**

## Connections

- Dashboard user → Dashboard app: uses (evidence: `Readme.md`)
- Dashboard app → Coupon list and cards: renders (evidence: `frontend-react/src/App.jsx`)
- Dashboard app → Redemption history: renders (evidence: `frontend-react/src/App.jsx`)
- Coupon list and cards → HTTP API client: requests coupons (evidence: `frontend-react/src/components/CouponList.jsx`)
- Coupon list and cards → HTTP API client: submits redemptions (evidence: `frontend-react/src/components/CouponCard.jsx`)
- Coupon list and cards → Redemption dialog: shows results (evidence: `frontend-react/src/components/CouponCard.jsx`)
- Create coupon form → HTTP API client: creates coupons (evidence: `frontend-react/src/components/CreateCoupon.jsx`)
- Redemption history → HTTP API client: loads history (evidence: `frontend-react/src/components/RedemptionHistory.jsx`)
- HTTP API client → Nginx load balancer: HTTP requests (evidence: `frontend-react/src/api/client.js`)
- Nginx load balancer → Coupon REST endpoints: balances requests (evidence: `Readme.md`)
- Coupon REST endpoints → Coupon redemption service: delegates (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java`)
- Coupon REST endpoints → API request and response DTOs: accepts and returns (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java`)
- Coupon redemption service → API request and response DTOs: maps responses (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java`)
- Coupon redemption service → Lock strategy: acquires and releases (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java`)
- Lock strategy configuration → Lock strategy: provides implementation (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/config/LockConfig.java`)
- Lock strategy → Redis lock implementation: implemented by (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/config/LockConfig.java`)
- Redis lock implementation → Redis: lock operations
- Coupon redemption service → Coupon repository: reads and writes (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java`)
- Coupon redemption service → Redemption repository: records and queries (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java`)
- Coupon repository → Coupon entity: persists (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRepository.java`)
- Redemption repository → Redemption entity: persists (evidence: `coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRedemptionRepository.java`)
- Coupon repository → MySQL database: database access
- Redemption repository → MySQL database: database access
- Coupon redemption service → Coupon error handling: throws domain errors
