How vernardtan/flash-sale works
Flash Sale System combines a React storefront with a NestJS API. The user browses sale status and products, creates a checkout, then submits its server-generated requestId to execute a purchase. Checkout validates eligibility without reserving stock; transaction processing revalidates conditions and atomically consumes inventory. PostgreSQL is authoritative, while Redis supports write rate limiting. The README documents major API capabilities; some controller-to-service links are supported by the source index rather than full excerpts, and frontend-to-API transport details were not sampled.
Main entry points: api.ts API client · prisma.service.ts Prisma data access · checkout.service.ts Checkout creation · sale.service.ts Sale rules
Components 19
Storefront
- Storefront UI
frontend/src/App.tsx - API client
frontend/src/api.ts
Catalog and sale
- Sale endpoint
backend/src/sale/sale.controller.ts - Sale rules
backend/src/sale/sale.service.ts - Product endpoint
backend/src/product/product.controller.ts - Product catalog
backend/src/product/product.service.ts
Checkout and purchase
- Checkout endpoint
backend/src/checkout/checkout.controller.ts - Checkout creation
backend/src/checkout/checkout.service.ts - Transaction endpoint
backend/src/purchase/transaction.controller.ts - Transaction processing
backend/src/purchase/transaction.service.ts - Purchase lookup
backend/src/purchase/purchase.controller.ts - Purchase query
backend/src/purchase/purchase.service.ts - Payment options
backend/src/payment/payment-methods.ts
Shared infrastructure
- Rate limiter
backend/src/common/rate-limit/rate-limit.guard.ts - Redis client
backend/src/redis/redis.service.ts - Prisma data access
backend/src/database/prisma.service.ts - PostgreSQL
- Domain errors
backend/src/common/errors/api.exception.ts
Other components
- Shopper
Connections 28
- Shopper → Storefront UI: uses
README.md - Storefront UI → API client: calls
frontend/src/App.tsx - API client → Sale endpoint: requests
- API client → Product endpoint: requests
- API client → Checkout endpoint: requests
- API client → Transaction endpoint: requests
- Sale endpoint → Sale rules: delegates
backend/src/sale/sale.module.ts - Product endpoint → Product catalog: delegates
backend/src/product/product.controller.ts - Checkout endpoint → Checkout creation: delegates
backend/src/checkout/checkout.controller.ts - Transaction endpoint → Transaction processing: delegates
backend/src/purchase/transaction.controller.ts - Purchase lookup → Purchase query: delegates
backend/src/purchase/purchase.controller.ts - Checkout endpoint → Rate limiter: applies limit
backend/src/checkout/checkout.controller.ts - Transaction endpoint → Rate limiter: applies limit
backend/src/purchase/transaction.controller.ts - Rate limiter → Redis client: checks limits
backend/src/common/rate-limit/rate-limit.guard.ts - Product catalog → Sale rules: derives status
backend/src/product/product.service.ts - Checkout creation → Sale rules: validates sale
backend/src/checkout/checkout.service.ts - Transaction processing → Sale rules: revalidates sale
backend/src/purchase/transaction.service.ts - Checkout creation → Payment options: validates method
backend/src/checkout/checkout.service.ts - Checkout creation → Prisma data access: creates checkout
backend/src/checkout/checkout.service.ts - Product catalog → Prisma data access: reads catalog
backend/src/product/product.service.ts - Sale rules → Prisma data access: reads sale data
backend/src/sale/sale.service.ts - Transaction processing → Prisma data access: claims and purchases
backend/src/purchase/transaction.service.ts - Purchase query → Prisma data access: reads purchases
backend/src/purchase/purchase.service.ts - Prisma data access → PostgreSQL: queries
backend/src/database/prisma.service.ts - Checkout creation → Domain errors: throws errors
backend/src/checkout/checkout.service.ts - Transaction processing → Domain errors: throws errors
backend/src/purchase/transaction.service.ts - Purchase lookup → API client: returns purchase
- API client → Payment options: loads options