How sa301-boop/narendra-farms works
Narendra Farms is an online farm-products storefront with customer accounts, shopping, order management, reviews, and an admin console. Customers browse and manage a cart and wishlist, then authenticate and check out; the server exposes the corresponding catalog, account, address, order, review, and analytics APIs. Admins manage catalog and orders, while order updates can trigger WhatsApp notifications. A separate product-service package also implements product catalog endpoints. The README is empty, so feature coverage is inferred from the tree and sampled routes; the gateway’s relationship to the services is not shown.
Main entry points: App.tsx App routing · app.ts API route mounting · HomePage.tsx Browse and cart · product.routes.ts Catalog routes
Components 23
Customer storefront
- App routing
narendra-farms/src/App.tsx - Browse and cart
narendra-farms/src/pages/HomePage.tsx - Checkout
narendra-farms/src/pages/CheckoutPage.tsx - Account and addresses
narendra-farms/src/pages/ProfilePage.tsx - Session context
narendra-farms/src/context/AuthContext.tsx - Cart state
narendra-farms/src/context/CartContext.tsx - Wishlist
narendra-farms/src/context/WishlistContext.tsx - Admin console
narendra-farms/src/pages/AdminDashboard.tsx - API endpoint config
narendra-farms/src/config/api.ts
Commerce API
- API route mounting
narendra-farms/server/src/app.ts - Authentication routes
narendra-farms/server/src/routes/auth.routes.ts - Catalog routes
narendra-farms/server/src/routes/product.routes.ts - Order processing
narendra-farms/server/src/controllers/order.controller.ts - Product reviews
narendra-farms/server/src/controllers/review.controller.ts - JWT authentication
narendra-farms/server/src/middleware/auth.middleware.ts - Commerce database
narendra-farms/server/src/config/prisma.ts
Product service
- Product management
narendra-farms/services/product-service/src/controllers/product.controller.ts - Product-service routes
narendra-farms/services/product-service/src/routes/product.routes.ts - Product-service database
narendra-farms/services/product-service/src/config/prisma.ts
Messaging integration
- WhatsApp notifications
narendra-farms/server/src/services/whatsapp.service.ts - WhatsApp webhook
narendra-farms/server/src/routes/whatsapp-webhook.routes.ts
Other components
- Shopper
- WhatsApp provider
Connections 24
- Shopper → App routing: uses storefront
narendra-farms/src/App.tsx - App routing → Browse and cart: routes to
narendra-farms/src/App.tsx - App routing → Checkout: routes to
narendra-farms/src/App.tsx - App routing → Account and addresses: routes to
narendra-farms/src/App.tsx - App routing → Admin console: routes to
narendra-farms/src/App.tsx - Browse and cart → Cart state: uses state
narendra-farms/src/pages/HomePage.tsx - Browse and cart → Wishlist: uses state
narendra-farms/src/pages/HomePage.tsx - Browse and cart → API endpoint config: uses endpoint
narendra-farms/src/pages/HomePage.tsx - Session context → API endpoint config: calls API
narendra-farms/src/context/AuthContext.tsx - App routing → Session context: checks session
narendra-farms/src/App.tsx - API route mounting → Authentication routes: mounts
narendra-farms/server/src/app.ts - API route mounting → Catalog routes: mounts
narendra-farms/server/src/app.ts - API route mounting → Order processing: mounts order routes
- API route mounting → Product reviews: mounts review routes
- Authentication routes → JWT authentication: protects routes
narendra-farms/server/src/routes/auth.routes.ts - Catalog routes → JWT authentication: protects admin routes
narendra-farms/server/src/routes/product.routes.ts - Order processing → Commerce database: reads and writes
narendra-farms/server/src/controllers/order.controller.ts - Order processing → WhatsApp notifications: dispatches notices
narendra-farms/server/src/controllers/order.controller.ts - Product reviews → Commerce database: reads and writes
narendra-farms/server/src/controllers/review.controller.ts - Catalog routes → Product management: dispatches admin calls
- Product-service routes → Product management: dispatches handlers
narendra-farms/services/product-service/src/routes/product.routes.ts - Product management → Product-service database: reads and writes
narendra-farms/services/product-service/src/controllers/product.controller.ts - WhatsApp notifications → WhatsApp provider: sends notifications
- WhatsApp provider → WhatsApp webhook: delivers events