How jashikaraja05-pixel/buygen works
BUYGEN is a full-stack consumer-electronics marketplace. Customers discover products, manage a cart, check out through simulated payment, and track orders; administrators manage catalog, categories, offers, orders, payments, users, and metrics. The React app routes these experiences through a shared API client to an Express API, backed by a database layer and Firestore. The README documents AI advising, comparison, smart search, and guarded administration. Some subsystem links are documented rather than verified in sampled implementation excerpts.
Main entry points: services/api.ts API Client · App.tsx App Router · server/api.ts Express API · AuthContext.tsx Authentication
Components 29
Customer Storefront
- App Router
src/App.tsx - Authentication
src/context/AuthContext.tsx - Sign-in & Registration
src/pages/AuthGatewayPage.tsx - Home & Catalog
src/pages/HomePage.tsx - Product Discovery
src/pages/ProductsPage.tsx - Product Details
src/pages/ProductDetailsPage.tsx
Shopping & Orders
- Cart State
src/context/CartContext.tsx - Wishlist
src/context/WishlistContext.tsx - Product Comparison
src/pages/ComparePage.tsx - Checkout & Payment
src/pages/CheckoutPage.tsx - Order History
src/pages/OrdersPage.tsx - Order Tracking
src/components/RealTimeOrderTracker.tsx
Admin Console
- Admin Guard & Layout
src/pages/admin/AdminLayout.tsx - Admin Metrics
src/pages/admin/AdminDashboard.tsx - Catalog Management
src/pages/admin/AdminProductsPage.tsx - Category Management
src/pages/admin/AdminCategoriesPage.tsx - Order Management
src/pages/admin/AdminOrdersPage.tsx - User Management
src/pages/admin/AdminUsersPage.tsx - Offers & Payments
src/pages/admin/AdminOffersPage.tsx
API & Persistence
- API Client
src/services/api.ts - Express API
src/server/api.ts - Database Store
src/server/db.ts - Firestore
AI & Discovery
- Tech Advisor
src/pages/AdvisorPage.tsx - Smart Search
src/pages/SearchResultsPage.tsx - AI Comparison
src/pages/ComparePage.tsx - Spelling Normalizer
src/lib/spellingNormalizer.ts - Gemini Advisor
Other components
- Shopper
Connections 35
- Shopper → App Router: uses
- App Router → Authentication: provides auth
src/App.tsx - App Router → Sign-in & Registration: routes unauthenticated
src/App.tsx - App Router → Home & Catalog: routes storefront
src/App.tsx - App Router → Product Discovery: routes catalog
src/App.tsx - App Router → Product Details: routes details
src/App.tsx - App Router → Checkout & Payment: routes checkout
src/App.tsx - App Router → Order History: routes orders
src/App.tsx - App Router → Admin Guard & Layout: routes admin
src/App.tsx - Authentication → API Client: calls auth API
src/context/AuthContext.tsx - Home & Catalog → API Client: loads storefront data
src/pages/HomePage.tsx - Product Discovery → API Client: searches catalog
src/pages/ProductsPage.tsx - Product Details → Cart State: adds products
src/pages/ProductDetailsPage.tsx - Cart State → API Client: calls cart API
src/context/CartContext.tsx - Wishlist → API Client: calls wishlist API
src/context/WishlistContext.tsx - Wishlist → Cart State: moves to cart
src/context/WishlistContext.tsx - Checkout & Payment → API Client: creates order
src/pages/CheckoutPage.tsx - Order History → API Client: loads orders
src/pages/OrdersPage.tsx - Order Tracking → Firestore: reads live updates
src/components/RealTimeOrderTracker.tsx - Admin Guard & Layout → Authentication: checks role
src/pages/admin/AdminLayout.tsx - Admin Metrics → API Client: loads metrics
src/pages/admin/AdminDashboard.tsx - Catalog Management → API Client: manages products
src/pages/admin/AdminProductsPage.tsx - Category Management → API Client: manages categories
src/pages/admin/AdminCategoriesPage.tsx - Order Management → API Client: manages orders
src/pages/admin/AdminOrdersPage.tsx - User Management → API Client: manages users
src/pages/admin/AdminUsersPage.tsx - Offers & Payments → API Client: manages offers
src/services/api.ts - Tech Advisor → API Client: requests advice
src/pages/AdvisorPage.tsx - Smart Search → API Client: requests smart search
src/pages/SearchResultsPage.tsx - AI Comparison → API Client: requests evaluation
src/services/api.ts - API Client → Express API: sends API requests
- Express API → Database Store: uses data store
src/server/api.ts - Database Store → Firestore: persists records
src/server/db.ts - Express API → Spelling Normalizer: normalizes search
src/server/api.ts - Express API → Gemini Advisor: requests recommendations
- Gemini Advisor → Database Store: queries product data