How vergo-wear/vergo-app works
Vergo Wear is a custom-apparel commerce and order-operations platform. Customers browse products, manage a cart, calculate shipping, and place COD or bank-transfer checkouts; reserved inventory and payment-proof review support order creation, followed by employee fulfillment and courier dispatch. Separate admin, identity, reviews, and notification capabilities are retained from the README and repository tree. Most unsampled feature links are documented capabilities rather than inspected calls, so they are shown as dashed with no evidence path.
Main entry points: prisma.service.ts PostgreSQL data · orders.service.ts Checkout engine · checkout Checkout · admin.service.ts Admin services
Components 25
Customer commerce
- Storefront
frontend/src/app/(store) - Catalog browsing
frontend/src/app/(store)/collection - Cart
frontend/src/app/(store)/cart/page.tsx - Checkout
frontend/src/app/(store)/checkout
Commerce services
- Product catalogue
backend/src/product-catalogue/product-catalogue.service.ts - Cart persistence
backend/src/cart/cart.service.ts - Delivery fees
backend/src/delivery-fees/delivery-fees.service.ts - Order endpoints
backend/src/orders/orders.controller.ts - Checkout engine
backend/src/orders/orders.service.ts - Stock reservation
backend/src/stock-reservation/stock-reservation.service.ts - Payment proofs
backend/src/payment-proof/payment-proof.service.ts - Reviews moderation
backend/src/reviews/reviews.service.ts - Notifications
backend/src/notifications/notifications.service.ts
Store operations
- Admin dashboard
frontend/src/app/(admin)/admin - Admin services
backend/src/admin/admin.service.ts - Employee workspace
frontend/src/app/(employee)/employee - Fulfillment queue
backend/src/employees/employees.service.ts - Citypak logistics
backend/src/integrations/citypak
Identity and infrastructure
- Media storage
backend/src/cloudinary/cloudinary.service.ts - Authentication
backend/src/auth/auth.service.ts - Request auth
backend/src/auth/guards/supabase-auth.guard.ts - Role access
backend/src/auth/guards/roles.guard.ts - PostgreSQL data
backend/src/prisma/prisma.service.ts
Other components
- Customer
- Citypak courier
Connections 24
- Customer → Storefront: browses
- Storefront → Catalog browsing: opens
- Catalog browsing → Product catalogue: requests products
- Customer → Cart: manages cart
- Cart → Cart persistence: persists cart
- Customer → Checkout: checks out
- Checkout → Delivery fees: calculates delivery
- Checkout → Order endpoints: submits order
- Order endpoints → Checkout engine: creates checkout
backend/src/orders/orders.controller.ts - Checkout engine → Stock reservation: reserves stock
- Checkout engine → Payment proofs: audits payment
- Payment proofs → Media storage: uploads receipt
- Admin dashboard → Admin services: manages operations
- Admin services → Media storage: stores product media
backend/src/admin/admin.controller.ts - Employee workspace → Fulfillment queue: fulfills orders
- Fulfillment queue → PostgreSQL data: reads and writes
backend/src/employees/employees.service.ts - Admin services → PostgreSQL data: reads and writes
backend/src/admin/admin.service.ts - Checkout engine → PostgreSQL data: reads and writes
- Authentication → PostgreSQL data: reads and writes
backend/src/auth/auth.service.ts - Request auth → PostgreSQL data: loads profile
backend/src/auth/guards/supabase-auth.guard.ts - Request auth → Role access: provides identity
backend/src/auth/guards/roles.guard.ts - Citypak logistics → Citypak courier: registers shipments
- Reviews moderation → PostgreSQL data: reads and writes
backend/src/reviews/reviews.service.ts - Notifications → Customer: sends updates