How yorn-samnang/e-shop works
This repository is a full-stack commerce system: a customer storefront and staff dashboard use a Django backend for accounts, catalog, banners, cart, and orders. The main customer journey spans browsing products, managing a cart, and placing and reviewing orders; staff separately manage products, banners, orders, and users. Sampled sources show selected API calls and the admin image-upload authorization flow. Several listed capabilities were not sampled, so their detailed runtime connections are not asserted here.
Main entry points: route.ts Upload Endpoint · AddProductDialog.tsx Product Editor · AddBannerDialog.tsx Banner Editor · views.py Products API
Components 29
Customer Storefront
- Storefront Pages
Ecommerce/src/app/page.tsx - Product Browsing
Ecommerce/src/app/products/page.tsx - Product Detail
Ecommerce/src/app/products/[id]/page.tsx - Cart
Ecommerce/src/app/cart/page.tsx - Sign In & Register
Ecommerce/src/app/auth/login/page.tsx - Authentication State
Ecommerce/src/context/AuthContext.tsx - Order History
Ecommerce/src/app/orders/page.tsx - Order Operations
Ecommerce/src/hooks/useOrders.ts
Staff Dashboard
- Product Management
AdminDashboard/src/app/(app)/products/page.tsx - Product Editor
AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx - Product Details
AdminDashboard/src/app/(app)/products/[id]/page.tsx - Banner Management
AdminDashboard/src/app/(app)/banners/page.tsx - Banner Editor
AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx - Sales Dashboard
AdminDashboard/src/app/(app)/dashboard/page.tsx - Order Management
AdminDashboard/src/app/(app)/orders/page.tsx - User Management
AdminDashboard/src/app/(app)/users/page.tsx - Admin API Client
AdminDashboard/src/lib/axios.ts - Product Image Upload
AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx - Banner Image Upload
AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx
Commerce Backend
- Accounts API
Backend/src/accounts/views.py - Account Serialization
Backend/src/accounts/serializers.py - Products API
Backend/src/products/views.py - Banners API
Backend/src/banners/views.py - Cart API
Backend/src/cart/views.py - Orders API
Backend/src/orders/views.py - Staff Profile Check
Backend/src/accounts/views.py
Image Upload
- Upload Endpoint
AdminDashboard/src/app/api/blob/route.ts
Other components
- Customer
- Vercel Blob
Connections 14
- Customer → Storefront Pages: browses
- Order Operations → Authentication State: checks authentication
Ecommerce/src/hooks/useOrders.ts - Order Operations → Orders API: requests orders
Ecommerce/src/hooks/useOrders.ts - Product Management → Product Editor: opens editor
AdminDashboard/src/app/(app)/products/page.tsx - Product Management → Products API: deletes products
AdminDashboard/src/app/(app)/products/page.tsx - Product Details → Products API: loads product
AdminDashboard/src/app/(app)/products/[id]/page.tsx - Banner Management → Banner Editor: opens editor
AdminDashboard/src/app/(app)/banners/page.tsx - Banner Editor → Banners API: creates banner
AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx - Product Editor → Products API: creates product
AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx - Accounts API → Account Serialization: serializes accounts
Backend/src/accounts/views.py - Product Editor → Upload Endpoint: uploads image
- Banner Editor → Upload Endpoint: uploads image
- Upload Endpoint → Staff Profile Check: validates staff
AdminDashboard/src/app/api/blob/route.ts - Upload Endpoint → Vercel Blob: stores image
AdminDashboard/src/app/api/blob/route.ts