How gs-shaykot/hyperreal works
This is a Next.js ecommerce application. Shoppers discover products, manage a cart, submit an order for payment, and can then review account information such as addresses, orders, and saved items. Separate account flows handle registration, sign-in, verification, and session management; administrators manage the store and inspect sales analytics. The graph emphasizes the sampled checkout, cart, address, authentication, and admin-dashboard relationships. Other routes and integrations are represented from the repository tree, but their internal wiring is not established by the excerpts.
Main entry points: prisma.ts PostgreSQL data · route.ts Order checkout · admin/page.tsx Admin dashboard · app/page.tsx Home discovery
Components 24
Storefront
- Home discovery
app/page.tsx - Home features
app/components/(Home_Components) - Product catalog
app/(Routes)/products/page.tsx - Product details
app/(Routes)/products/[id]/ProductDetails.tsx
Identity and account
- Authentication
lib/auth.ts - Registration and recovery
app/(Routes)/(auth)/register/page.tsx - Email verification
app/api/sendOtp/route.ts - Account management
app/(Routes)/account/overview/page.tsx - Address management
app/api/address/route.ts - Session management
app/api/account/sessions/route.ts
Cart and payments
- Shopping cart
app/api/cart/cartItem/route.ts - Cart interface
app/(Routes)/cart/page.tsx - Order checkout
app/api/order/route.ts - Order calculation
lib/service/orderService.ts - Payment completion
lib/service/paymentService.ts - Payment gateways
lib/stripe.ts - Payment outcomes
app/(Routes)/(Payment Status)/success/page.tsx
Store administration
- Admin dashboard
app/(Routes)/admin/page.tsx - Product administration
app/(Routes)/admin/products/page.tsx - Order administration
app/(Routes)/admin/orders/page.tsx - Sales analytics
utils/AdminUtils
Other components
- Shopper
- PostgreSQL data
lib/prisma.ts - Administrator
Connections 29
- Shopper → Home discovery: browses
app/page.tsx - Home discovery → Home features: renders
app/page.tsx - Shopper → Product catalog: browses
- Shopper → Product details: views
- Shopper → Registration and recovery: registers or recovers
- Registration and recovery → Email verification: requests verification
- Email verification → PostgreSQL data: stores OTP
app/api/sendOtp/route.ts - Shopper → Authentication: signs in
- Authentication → PostgreSQL data: reads and updates sessions
lib/auth.ts - Shopper → Account management: manages account
- Account management → Address management: manages addresses
- Address management → PostgreSQL data: reads and writes addresses
app/api/address/route.ts - Shopper → Session management: manages sessions
- Session management → PostgreSQL data: reads and updates sessions
app/api/account/sessions/route.ts - Shopper → Cart interface: updates cart
- Cart interface → Shopping cart: uses cart API
- Shopping cart → PostgreSQL data: reads and writes cart
app/api/cart/cartItem/route.ts - Shopper → Order checkout: submits order
- Order checkout → Order calculation: calculates totals
app/api/order/route.ts - Order calculation → PostgreSQL data: reads variants and coupons
lib/service/orderService.ts - Order checkout → Payment completion: completes payment
app/api/order/route.ts - Payment completion → PostgreSQL data: updates order and stock
lib/service/paymentService.ts - Order checkout → Payment gateways: initiates payment
app/api/order/route.ts - Payment gateways → Payment outcomes: returns payment outcome
- Administrator → Admin dashboard: reviews dashboard
- Admin dashboard → Sales analytics: loads metrics
app/(Routes)/admin/page.tsx - Admin dashboard → Product administration: manages products
- Admin dashboard → Order administration: manages orders
- Sales analytics → PostgreSQL data: queries store data
utils/AdminUtils/getAdminProducts.ts