How thakur2sahil/e-commerce works
This repository is a Next.js storefront with customer shopping and account flows plus administrative product, category, order, and user management. The main customer journey is browsing products, adding items to a cart, maintaining addresses, and placing an order; administrative screens manage the catalog and fulfillment. The graph includes sampled API, cart, authentication, and database relationships, and preserves major unsampled route families from the tree. Some UI-to-API wiring and unsampled admin behavior are not evidenced in the excerpts, so those links are omitted.
Main entry points: ProductCard.tsx Product cards · prisma.ts Application database · admin Admin workspace · cart Cart API
Components 32
Storefront
- Home and featured
src/app/page.tsx - Product discovery
src/app/(user)/shop/page.tsx - Product cards
src/_component/ProductCard.tsx - Product detail
src/app/(user)/products/[id]/page.tsx - Catalog API
src/app/api/shop/route.ts - Product API
src/app/api/products/[id]/route.tsx
Customer account
- Login and signup
src/app/(auth) - Profile management
src/app/(user)/(protected)/profile - Address management
src/app/(user)/(protected)/profile/addresses - Address API
src/app/api/address
Cart and orders
- Cart page
src/app/(user)/(protected)/cart/page.tsx - Cart indicator
src/_component/CartButton.tsx - Cart state
src/_context/CartContext.tsx - Cart API
src/app/api/cart - Cart calculations
src/_lib/getCartData.ts - Checkout
src/app/(user)/(protected)/checkout/page.tsx - Order placement
src/app/api/payment/route.ts - Customer orders
src/app/(user)/(protected)/orders/page.tsx
Administration
- Admin workspace
src/app/admin - Product management
src/app/admin/products - Category management
src/app/admin/categories - Order management
src/app/admin/orders - User management
src/app/admin/users - Admin APIs
src/app/api/admin
Shared services
- Session authentication
src/_lib/auth.ts - Route access checks
src/proxy.ts - Application database
src/_lib/prisma.ts - HTTP client helper
src/_lib/fetchApi.ts - Feedback modal
src/_context/ModalContext.tsx - Image upload
src/_lib/uploadImage.ts
Other components
- Shopper
- Cloudinary
Connections 33
- Shopper → Home and featured: visits
src/app/page.tsx - Shopper → Product discovery: browses
src/app/(user)/shop/page.tsx - Home and featured → Product cards: renders
src/app/page.tsx - Product discovery → Product cards: renders
src/app/(user)/shop/page.tsx - Product discovery → Catalog API: loads products
src/app/api/shop/route.ts - Shopper → Product detail: opens product
- Product detail → Product API: loads product
src/app/api/products/[id]/route.tsx - Product cards → Cart state: updates count
src/_component/ProductCard.tsx - Product cards → HTTP client helper: sends cart request
src/_component/ProductCard.tsx - Product cards → Feedback modal: shows feedback
src/_component/ProductCard.tsx - HTTP client helper → Cart API: requests cart
- Shopper → Login and signup: signs in
- Route access checks → Session authentication: checks session
src/proxy.ts - Address API → Session authentication: checks user
src/app/api/address/[id]/route.ts - Address API → Application database: reads and writes
src/app/api/address/[id]/route.ts - Shopper → Cart page: reviews cart
src/app/(user)/(protected)/cart/page.tsx - Cart indicator → Cart state: reads count
src/_component/CartButton.tsx - Cart page → HTTP client helper: requests data
src/app/(user)/(protected)/cart/page.tsx - Checkout → HTTP client helper: requests data
src/app/(user)/(protected)/checkout/page.tsx - Cart API → Session authentication: checks user
src/app/api/cart/route.tsx - Cart API → Cart calculations: loads cart
src/app/api/cart/route.tsx - Cart API → Application database: reads and writes
src/app/api/cart/route.tsx - Cart calculations → Application database: reads cart
src/_lib/getCartData.ts - Order placement → Session authentication: checks user
src/app/api/payment/route.ts - Order placement → Cart calculations: loads cart
src/app/api/payment/route.ts - Order placement → Application database: creates order
src/app/api/payment/route.ts - Admin APIs → Application database: manages records
src/app/api/admin/orders/[id]/route.ts - Product management → Image upload: uploads images
- Image upload → Cloudinary: stores images
- Admin workspace → Product management: manages catalog
- Admin workspace → Category management: manages categories
- Admin workspace → Order management: manages orders
- Admin workspace → User management: manages users