How codefarm0/coupon-redemption-system works
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: CouponRedemptionService.java Coupon redemption service · client.js HTTP API client · CouponCard.jsx Coupon list and cards · App.jsx Dashboard app
Components 21
Coupon dashboard
- Dashboard app
frontend-react/src/App.jsx - Coupon list and cards
frontend-react/src/components/CouponCard.jsx - Create coupon form
frontend-react/src/components/CreateCoupon.jsx - Redemption history
frontend-react/src/components/RedemptionHistory.jsx - Redemption dialog
frontend-react/src/components/RedemptionDialog.jsx - HTTP API client
frontend-react/src/api/client.js
Coupon API
- Nginx load balancer
nginx/nginx.conf - Coupon REST endpoints
coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java
Redemption domain
- Coupon redemption service
coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java - API request and response DTOs
coupon-service/src/main/java/in/codefarm/coupon/service/dto - Coupon error handling
coupon-service/src/main/java/in/codefarm/coupon/service/exception/GlobalExceptionHandler.java
Persistence and locking
- Lock strategy configuration
coupon-service/src/main/java/in/codefarm/coupon/service/config/LockConfig.java - Lock strategy
coupon-service/src/main/java/in/codefarm/coupon/service/lock/LockStrategy.java - Redis lock implementation
coupon-service/src/main/java/in/codefarm/coupon/service/lock/RedisLockStrategy.java - Coupon repository
coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRepository.java - Redemption repository
coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRedemptionRepository.java - Coupon entity
coupon-service/src/main/java/in/codefarm/coupon/service/entity/Coupon.java - Redemption entity
coupon-service/src/main/java/in/codefarm/coupon/service/entity/CouponRedemption.java
Other components
- Dashboard user
- MySQL database
- Redis
Connections 24
- Dashboard user → Dashboard app: uses
Readme.md - Dashboard app → Coupon list and cards: renders
frontend-react/src/App.jsx - Dashboard app → Redemption history: renders
frontend-react/src/App.jsx - Coupon list and cards → HTTP API client: requests coupons
frontend-react/src/components/CouponList.jsx - Coupon list and cards → HTTP API client: submits redemptions
frontend-react/src/components/CouponCard.jsx - Coupon list and cards → Redemption dialog: shows results
frontend-react/src/components/CouponCard.jsx - Create coupon form → HTTP API client: creates coupons
frontend-react/src/components/CreateCoupon.jsx - Redemption history → HTTP API client: loads history
frontend-react/src/components/RedemptionHistory.jsx - HTTP API client → Nginx load balancer: HTTP requests
frontend-react/src/api/client.js - Nginx load balancer → Coupon REST endpoints: balances requests
Readme.md - Coupon REST endpoints → Coupon redemption service: delegates
coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java - Coupon REST endpoints → API request and response DTOs: accepts and returns
coupon-service/src/main/java/in/codefarm/coupon/service/controller/CouponController.java - Coupon redemption service → API request and response DTOs: maps responses
coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java - Coupon redemption service → Lock strategy: acquires and releases
coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java - Lock strategy configuration → Lock strategy: provides implementation
coupon-service/src/main/java/in/codefarm/coupon/service/config/LockConfig.java - Lock strategy → Redis lock implementation: implemented by
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
coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java - Coupon redemption service → Redemption repository: records and queries
coupon-service/src/main/java/in/codefarm/coupon/service/service/CouponRedemptionService.java - Coupon repository → Coupon entity: persists
coupon-service/src/main/java/in/codefarm/coupon/service/repository/CouponRepository.java - Redemption repository → Redemption entity: persists
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