How ncd426/brewlite-2 works
BrewLite is a drink-ordering application with a Next.js storefront, NestJS API, and PostgreSQL persistence. Customers browse products, build a cart, preview promotions, place an order, and pay online; authenticated users can view profiles and order history. The API separately supports VNPay IPN verification and simulated counter sales, plus administrative product, inventory, and user management. The graph includes these documented capabilities; some frontend-to-API links are shown as unverified because the API client implementation was not excerpted.
Main entry points: payments.service.ts Payment processing · prisma.service.ts PostgreSQL · orders.service.ts Order processing · promotion-preview.service.ts Promotion preview
Components 29
Customer storefront
- Storefront pages
apps/web/app/page.tsx - Product details
apps/web/app/products/[id]/page.tsx - Cart
apps/web/app/cart/page.tsx - Cart state
apps/web/lib/useCartStore.ts - Checkout
apps/web/app/checkout/page.tsx - QR checkout
apps/web/app/checkout/qr/page.tsx - Order history
apps/web/app/orders/page.tsx
Ordering and catalog
- Product API
apps/api/src/products/products.controller.ts - Product catalog
apps/api/src/products/products.service.ts - Order API
apps/api/src/orders/orders.controller.ts - Order processing
apps/api/src/orders/orders.service.ts - Promotion preview
apps/api/src/orders/promotion-preview.service.ts - Pricing rules
apps/api/src/orders/pricing.ts - Promotion rules
apps/api/src/orders/promotion-rule.ts - Recipe inventory
apps/api/src/inventory/recipe-inventory.ts
Payments and rewards
- Payment API
apps/api/src/payments/payments.controller.ts - Payment processing
apps/api/src/payments/payments.service.ts - Payment gateways
apps/api/src/payments/payment-gateways.ts - VNPay IPN
apps/api/src/payments/payments-webhook.controller.ts - Loyalty points
apps/api/src/payments/loyalty-points.ts
Staff and administration
- Counter sales
apps/api/src/backoffice/counter-sales.service.ts - Admin console
apps/api/src/backoffice/admin.controller.ts - Backoffice services
apps/api/src/backoffice/backoffice.service.ts
Identity and persistence
- Authentication
apps/api/src/auth/auth.service.ts - User accounts
apps/api/src/users/users.service.ts - PostgreSQL
apps/api/src/prisma/prisma.service.ts
Other components
- Customer
- VNPay Sandbox
- Staff
Connections 37
- Customer → Storefront pages: browses
- Storefront pages → Product API: loads catalog
- Customer → Product details: selects drink
- Product details → Cart state: adds item
- Cart → Cart state: reads cart
apps/web/app/cart/page.tsx - Cart → Checkout: continues to
- Checkout → Promotion preview: requests quote
- Checkout → Order API: submits order
- Order API → Order processing: delegates to
apps/api/src/orders/orders.controller.ts - Order processing → Pricing rules: calculates price
apps/api/src/orders/orders.service.ts - Order processing → Promotion rules: resolves promotion
apps/api/src/orders/orders.service.ts - Order processing → Recipe inventory: checks ingredients
apps/api/src/orders/orders.service.ts - Promotion preview → Pricing rules: uses pricing
apps/api/src/orders/promotion-preview.service.ts - Promotion preview → Promotion rules: resolves promotion
apps/api/src/orders/promotion-preview.service.ts - Promotion preview → Recipe inventory: checks availability
apps/api/src/orders/promotion-preview.service.ts - Order processing → PostgreSQL: reads and writes
apps/api/src/orders/orders.service.ts - Product API → Product catalog: delegates to
apps/api/src/products/products.controller.ts - Product catalog → PostgreSQL: reads products
apps/api/src/products/products.service.ts - Product catalog → Recipe inventory: checks stock
apps/api/src/products/products.service.ts - Customer → Payment API: starts payment
- Payment API → Payment processing: processes payment
apps/api/src/payments/payments.controller.ts - Payment processing → Payment gateways: creates session
apps/api/src/payments/payments.service.ts - Payment processing → Loyalty points: redeems points
apps/api/src/payments/payments.service.ts - Payment processing → PostgreSQL: records payment
apps/api/src/payments/payments.service.ts - Payment processing → VNPay Sandbox: requests checkout
- VNPay Sandbox → VNPay IPN: sends IPN
- VNPay IPN → Payment gateways: verifies signature
apps/api/src/payments/payments-webhook.controller.ts - VNPay IPN → Payment processing: processes result
apps/api/src/payments/payments-webhook.controller.ts - Customer → Order history: views purchases
- Order history → Order API: loads orders
- Staff → Counter sales: records sale
- Counter sales → PostgreSQL: writes sale
apps/api/src/backoffice/counter-sales.service.ts - Admin console → Backoffice services: manages operations
apps/api/src/backoffice/admin.controller.ts - Backoffice services → PostgreSQL: reads and writes
apps/api/src/backoffice/backoffice.service.ts - Customer → Authentication: registers or signs in
- Authentication → User accounts: looks up or creates
apps/api/src/auth/auth.service.ts - User accounts → PostgreSQL: persists accounts
apps/api/src/users/users.service.ts