How vietthangpq099-prog/nguyenhuuvietthang-24ct1-cnpm works
OpticShop is a Vietnamese eyewear storefront with customer shopping, account and warranty pages, plus staff and admin operations. The main customer flow is browse/search products, inspect a product, add it to the persistent cart, submit checkout, and reach order confirmation; the implemented order API writes through a database adapter. Separate login and registration handlers support accounts, while admin/staff screens cover catalog, inventory, users, and order handling. The README documents SQLite persistence and these capabilities; several UI routes and integrations were not sampled, so edges are limited to evidenced calls or documented relationships.
Main entry points: mock-admin.ts Operations Data · mock-products.ts Product Data · db.ts Database Adapter · CartContext.tsx Cart State
Components 30
Customer Storefront
- Product Catalog
app/(shop)/san-pham/page.tsx - Product Detail
app/(shop)/san-pham/[id]/page.tsx - Product Search
app/(shop)/tim-kiem/page.tsx - Storefront Home
app/(shop)/page.tsx - Warranty Service
app/(shop)/bao-hanh/page.tsx
Cart and Checkout
- Cart State
lib/context/CartContext.tsx - Cart Page
app/(shop)/gio-hang/page.tsx - Checkout
app/(shop)/thanh-toan/page.tsx - Order Confirmation
app/(shop)/dat-hang-thanh-cong/page.tsx - Customer Orders
app/(shop)/don-hang/page.tsx
Accounts
- Registration
app/(auth)/dang-ky/page.tsx - Sign In
app/(auth)/dang-nhap/page.tsx - Customer Account
app/(shop)/tai-khoan/page.tsx
Staff and Admin
- Admin Console
app/(admin)/quan-tri/page.tsx - Product Management
app/(admin)/quan-tri/san-pham/page.tsx - Product Entry
app/(admin)/quan-tri/san-pham/them-moi/page.tsx - Inventory
app/(admin)/quan-tri/kho-hang/page.tsx - Order Management
app/(admin)/quan-tri/don-hang/page.tsx - User Management
app/(admin)/quan-tri/nguoi-dung/page.tsx - Staff Order Queue
app/(nhan-vien)/nhan-vien/don-hang/page.tsx - Processed Orders
app/(nhan-vien)/nhan-vien/da-xu-ly/page.tsx
API and Data
- Product Data
lib/data/mock-products.ts - Operations Data
lib/data/mock-admin.ts - Products API
app/api/products/route.ts - Orders API
app/api/orders/route.ts - Login API
app/api/auth/login/route.ts - Registration API
app/api/auth/register/route.ts - Database Adapter
lib/db.ts - SQLite Database
database/opticshop.db
Other components
- Shopper
Connections 27
- Shopper → Product Catalog: browses
- Shopper → Product Search: searches
- Product Catalog → Product Data: reads catalog
app/(shop)/san-pham/page.tsx - Product Search → Product Data: searches data
app/(shop)/tim-kiem/page.tsx - Product Detail → Product Data: loads product
app/(shop)/san-pham/[id]/page.tsx - Product Detail → Cart State: adds item
app/(shop)/san-pham/[id]/page.tsx - Product Catalog → Cart State: adds item
- Cart State → Cart Page: provides state
- Checkout → Cart State: reads and clears
app/(shop)/thanh-toan/page.tsx - Checkout → Orders API: submits order
- Orders API → Database Adapter: queries and writes
app/api/orders/route.ts - Products API → Database Adapter: loads products
app/api/products/route.ts - Sign In → Login API: authenticates
- Registration → Registration API: registers
- Login API → Database Adapter: checks and logs
app/api/auth/login/route.ts - Registration API → Database Adapter: checks and creates
app/api/auth/register/route.ts - Database Adapter → SQLite Database: uses local store
README.md - Admin Console → Operations Data: reads metrics
app/(admin)/quan-tri/page.tsx - Admin Console → Product Data: reads stock
app/(admin)/quan-tri/page.tsx - Order Management → Operations Data: reads order data
app/(admin)/quan-tri/don-hang/page.tsx - User Management → Operations Data: reads user data
app/(admin)/quan-tri/nguoi-dung/page.tsx - Product Management → Product Data: uses catalog data
app/(admin)/quan-tri/san-pham/page.tsx - Inventory → Product Data: uses stock data
app/(admin)/quan-tri/kho-hang/page.tsx - Staff Order Queue → Operations Data: reads order data
app/(nhan-vien)/nhan-vien/don-hang/page.tsx - Processed Orders → Operations Data: reads processed data
app/(nhan-vien)/nhan-vien/da-xu-ly/page.tsx - Customer Orders → Operations Data: reads order data
app/(shop)/don-hang/page.tsx - Customer Account → Operations Data: uses account data
app/(shop)/tai-khoan/page.tsx