How ganeshnil/vivo_store_website works
Galaxy Mobile Gallery is a storefront and admin-managed product catalog for phones and accessories. Customers browse collections, compare products, and view product details; administrators manage catalog data, offers, stock, prices, settings, and operational records. The shared store context is a central application-state layer, while API routes provide admin authentication and synchronized live state. The README is empty, so the map relies on the supplied source index and excerpts; some page-to-client and subsystem links are supported by index references rather than complete source excerpts.
Main entry points: store-context.tsx Shared store state · HomePageClient.tsx Home experience · StoreClient.tsx Store directory · ProductDetailClient.tsx Product details
Components 25
Customer storefront
- Home experience
src/components/customer/HomePageClient.tsx - Product collections
src/components/customer/MobilesClient.tsx - Store directory
src/components/customer/StoreClient.tsx - Product details
src/components/customer/ProductDetailClient.tsx - Product comparison
src/components/customer/CompareClient.tsx - Product card
src/components/customer/ProductCard.tsx - Quick search
src/components/common/QuickSearchModal.tsx
Store administration
- Catalog management
src/app/admin/products/page.tsx - Offer management
src/app/admin/offers/page.tsx - Inventory management
src/app/admin/inventory/page.tsx - Price management
src/app/admin/prices/page.tsx - Store operations
src/app/admin/audit-logs/page.tsx - Stock notifications
src/app/admin/notify-requests/page.tsx
Catalog and state
- Shared store state
src/lib/store/store-context.tsx - Initial catalog data
src/lib/data/seed-data.ts - Domain types
src/lib/types/index.ts - Category specifications
src/lib/data/category-specs-schema.ts - Server product data
src/lib/data/products-server.ts
API and integrations
- Admin sign-in API
src/app/api/auth/admin/route.ts - Admin session checks
src/lib/auth/admin.ts - Live-state API
src/app/api/sync/route.ts - SEO metadata
src/lib/seo/config.ts
Other components
- Shopper
- Administrator
- Supabase database
Connections 37
- Shopper → Home experience: opens
- Shopper → Product collections: browses
src/components/customer/MobilesClient.tsx - Shopper → Store directory: finds stores
- Shopper → Product details: views
- Shopper → Product comparison: compares
- Home experience → Shared store state: reads catalog
src/components/customer/HomePageClient.tsx - Home experience → Product card: renders
src/components/customer/HomePageClient.tsx - Product collections → Shared store state: reads catalog
src/components/customer/MobilesClient.tsx - Product collections → Product card: renders
src/components/customer/MobilesClient.tsx - Store directory → Shared store state: reads state
src/components/customer/StoreClient.tsx - Product details → Shared store state: reads product
src/components/customer/ProductDetailClient.tsx - Product details → Product card: renders related
src/components/customer/ProductDetailClient.tsx - Product comparison → Shared store state: reads products
src/components/customer/CompareClient.tsx - Quick search → Shared store state: searches catalog
src/components/common/QuickSearchModal.tsx - Administrator → Catalog management: manages catalog
src/app/admin/products/page.tsx - Administrator → Offer management: manages offers
src/app/admin/offers/page.tsx - Administrator → Inventory management: manages stock
src/app/admin/inventory/page.tsx - Administrator → Price management: manages prices
src/app/admin/prices/page.tsx - Administrator → Store operations: reviews logs
src/app/admin/audit-logs/page.tsx - Administrator → Stock notifications: reviews requests
src/app/admin/notify-requests/page.tsx - Catalog management → Shared store state: updates catalog
src/app/admin/products/page.tsx - Catalog management → Category specifications: validates categories
src/app/admin/products/page.tsx - Offer management → Shared store state: updates offers
src/app/admin/offers/page.tsx - Inventory management → Shared store state: updates stock
src/app/admin/inventory/page.tsx - Price management → Shared store state: updates prices
src/app/admin/prices/page.tsx - Store operations → Shared store state: reads logs
src/app/admin/audit-logs/page.tsx - Stock notifications → Shared store state: reads requests
src/app/admin/notify-requests/page.tsx - Shared store state → Initial catalog data: loads defaults
src/lib/store/store-context.tsx - Shared store state → Domain types: uses types
src/lib/store/store-context.tsx - Admin sign-in API → Admin session checks: validates credentials
src/app/api/auth/admin/route.ts - Live-state API → Admin session checks: checks admin
src/app/api/sync/route.ts - Live-state API → Supabase database: reads and writes
src/app/api/sync/route.ts - Store directory → Server product data: loads products
src/app/store/page.tsx - Server product data → Initial catalog data: uses catalog defaults
- Home experience → SEO metadata: uses metadata
src/app/page.tsx - Product details → SEO metadata: uses metadata
src/app/product/[slug]/page.tsx - Store directory → SEO metadata: uses metadata
src/app/store/page.tsx