# sa301-boop/narendra-farms architecture

> Architecture diagram of the GitHub repository sa301-boop/narendra-farms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sa301-boop/narendra-farms
- Repository: https://github.com/sa301-boop/narendra-farms

## Overview

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: [`narendra-farms/src/App.tsx`](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/App.tsx) (App routing), [`narendra-farms/server/src/app.ts`](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/app.ts) (API route mounting), [`narendra-farms/src/pages/HomePage.tsx`](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/HomePage.tsx) (Browse and cart), [`narendra-farms/server/src/routes/product.routes.ts`](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/routes/product.routes.ts) (Catalog routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_app["App routing<br/>[App.tsx]"]
  node_shopping["Browse and cart<br/>[HomePage.tsx]"]
  node_checkout["Checkout<br/>[CheckoutPage.tsx]"]
  node_account["Account and addresses<br/>[ProfilePage.tsx]"]
  node_authui["Session context<br/>[AuthContext.tsx]"]
  node_cart["Cart state<br/>[CartContext.tsx]"]
  node_wishlist["Wishlist"]
  node_adminui["Admin console<br/>[AdminDashboard.tsx]"]
  node_webapi["API endpoint config<br/>[api.ts]"]
end

subgraph group_api["Commerce API"]
  node_serverapp["API route mounting<br/>[app.ts]"]
  node_authroutes["Authentication routes<br/>[auth.routes.ts]"]
  node_productroutes["Catalog routes<br/>[product.routes.ts]"]
  node_orders["Order processing"]
  node_reviews["Product reviews"]
  node_identity["JWT authentication<br/>[auth.middleware.ts]"]
  node_data[("Commerce database<br/>[prisma.ts]")]
end

subgraph group_catalog["Product service"]
  node_productservice["Product management"]
  node_productservice_routes["Product-service routes<br/>[product.routes.ts]"]
  node_productdata[("Product-service database<br/>[prisma.ts]")]
end

subgraph group_messaging["Messaging integration"]
  node_whatsapp["WhatsApp notifications"]
  node_webhook["WhatsApp webhook"]
end

node_shopper(("Shopper"))
node_wa_provider(("WhatsApp provider"))

node_shopper -->|"uses storefront"| node_app
node_app -->|"routes to"| node_shopping
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_account
node_app -->|"routes to"| node_adminui
node_shopping -->|"uses state"| node_cart
node_shopping -->|"uses state"| node_wishlist
node_shopping -->|"uses endpoint"| node_webapi
node_authui -->|"calls API"| node_webapi
node_app -->|"checks session"| node_authui
node_serverapp -->|"mounts"| node_authroutes
node_serverapp -->|"mounts"| node_productroutes
node_serverapp -.->|"mounts order routes"| node_orders
node_serverapp -.->|"mounts review routes"| node_reviews
node_authroutes -->|"protects routes"| node_identity
node_productroutes -->|"protects admin routes"| node_identity
node_orders -->|"reads and writes"| node_data
node_orders -->|"dispatches notices"| node_whatsapp
node_reviews -->|"reads and writes"| node_data
node_productroutes -->|"dispatches admin calls"| node_productservice
node_productservice_routes -->|"dispatches handlers"| node_productservice
node_productservice -->|"reads and writes"| node_productdata
node_whatsapp -.->|"sends notifications"| node_wa_provider
node_wa_provider -.->|"delivers events"| node_webhook

click node_app "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/App.tsx"
click node_shopping "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/HomePage.tsx"
click node_checkout "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/CheckoutPage.tsx"
click node_account "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/ProfilePage.tsx"
click node_authui "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/context/AuthContext.tsx"
click node_cart "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/context/CartContext.tsx"
click node_wishlist "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/context/WishlistContext.tsx"
click node_adminui "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/AdminDashboard.tsx"
click node_webapi "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/config/api.ts"
click node_serverapp "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/app.ts"
click node_authroutes "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/routes/auth.routes.ts"
click node_productroutes "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/routes/product.routes.ts"
click node_orders "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/controllers/order.controller.ts"
click node_reviews "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/controllers/review.controller.ts"
click node_identity "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/middleware/auth.middleware.ts"
click node_data "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/config/prisma.ts"
click node_productservice "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/services/product-service/src/controllers/product.controller.ts"
click node_productservice_routes "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/services/product-service/src/routes/product.routes.ts"
click node_productdata "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/services/product-service/src/config/prisma.ts"
click node_whatsapp "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/services/whatsapp.service.ts"
click node_webhook "https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/routes/whatsapp-webhook.routes.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_shopping,node_checkout,node_account,node_authui,node_cart,node_wishlist,node_adminui,node_webapi toneBlue
class node_serverapp,node_authroutes,node_productroutes,node_orders,node_reviews,node_identity,node_data toneAmber
class node_productservice,node_productservice_routes,node_productdata toneMint
class node_whatsapp,node_webhook toneRose
class node_shopper,node_wa_provider toneIndigo
```

## Components

### Customer storefront

- [App routing](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/App.tsx): `narendra-farms/src/App.tsx`
- [Browse and cart](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/HomePage.tsx): `narendra-farms/src/pages/HomePage.tsx`
- [Checkout](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/CheckoutPage.tsx): `narendra-farms/src/pages/CheckoutPage.tsx`
- [Account and addresses](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/ProfilePage.tsx): `narendra-farms/src/pages/ProfilePage.tsx`
- [Session context](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/context/AuthContext.tsx): `narendra-farms/src/context/AuthContext.tsx`
- [Cart state](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/context/CartContext.tsx): `narendra-farms/src/context/CartContext.tsx`
- [Wishlist](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/context/WishlistContext.tsx): `narendra-farms/src/context/WishlistContext.tsx`
- [Admin console](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/pages/AdminDashboard.tsx): `narendra-farms/src/pages/AdminDashboard.tsx`
- [API endpoint config](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/src/config/api.ts): `narendra-farms/src/config/api.ts`

### Commerce API

- [API route mounting](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/app.ts): `narendra-farms/server/src/app.ts`
- [Authentication routes](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/routes/auth.routes.ts): `narendra-farms/server/src/routes/auth.routes.ts`
- [Catalog routes](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/routes/product.routes.ts): `narendra-farms/server/src/routes/product.routes.ts`
- [Order processing](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/controllers/order.controller.ts): `narendra-farms/server/src/controllers/order.controller.ts`
- [Product reviews](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/controllers/review.controller.ts): `narendra-farms/server/src/controllers/review.controller.ts`
- [JWT authentication](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/middleware/auth.middleware.ts): `narendra-farms/server/src/middleware/auth.middleware.ts`
- [Commerce database](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/config/prisma.ts): `narendra-farms/server/src/config/prisma.ts`

### Product service

- [Product management](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/services/product-service/src/controllers/product.controller.ts): `narendra-farms/services/product-service/src/controllers/product.controller.ts`
- [Product-service routes](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/services/product-service/src/routes/product.routes.ts): `narendra-farms/services/product-service/src/routes/product.routes.ts`
- [Product-service database](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/services/product-service/src/config/prisma.ts): `narendra-farms/services/product-service/src/config/prisma.ts`

### Messaging integration

- [WhatsApp notifications](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/services/whatsapp.service.ts): `narendra-farms/server/src/services/whatsapp.service.ts`
- [WhatsApp webhook](https://github.com/sa301-boop/narendra-farms/blob/main/narendra-farms/server/src/routes/whatsapp-webhook.routes.ts): `narendra-farms/server/src/routes/whatsapp-webhook.routes.ts`

### Other components

- **Shopper**
- **WhatsApp provider**

## Connections

- Shopper → App routing: uses storefront (evidence: `narendra-farms/src/App.tsx`)
- App routing → Browse and cart: routes to (evidence: `narendra-farms/src/App.tsx`)
- App routing → Checkout: routes to (evidence: `narendra-farms/src/App.tsx`)
- App routing → Account and addresses: routes to (evidence: `narendra-farms/src/App.tsx`)
- App routing → Admin console: routes to (evidence: `narendra-farms/src/App.tsx`)
- Browse and cart → Cart state: uses state (evidence: `narendra-farms/src/pages/HomePage.tsx`)
- Browse and cart → Wishlist: uses state (evidence: `narendra-farms/src/pages/HomePage.tsx`)
- Browse and cart → API endpoint config: uses endpoint (evidence: `narendra-farms/src/pages/HomePage.tsx`)
- Session context → API endpoint config: calls API (evidence: `narendra-farms/src/context/AuthContext.tsx`)
- App routing → Session context: checks session (evidence: `narendra-farms/src/App.tsx`)
- API route mounting → Authentication routes: mounts (evidence: `narendra-farms/server/src/app.ts`)
- API route mounting → Catalog routes: mounts (evidence: `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 (evidence: `narendra-farms/server/src/routes/auth.routes.ts`)
- Catalog routes → JWT authentication: protects admin routes (evidence: `narendra-farms/server/src/routes/product.routes.ts`)
- Order processing → Commerce database: reads and writes (evidence: `narendra-farms/server/src/controllers/order.controller.ts`)
- Order processing → WhatsApp notifications: dispatches notices (evidence: `narendra-farms/server/src/controllers/order.controller.ts`)
- Product reviews → Commerce database: reads and writes (evidence: `narendra-farms/server/src/controllers/review.controller.ts`)
- Catalog routes → Product management: dispatches admin calls
- Product-service routes → Product management: dispatches handlers (evidence: `narendra-farms/services/product-service/src/routes/product.routes.ts`)
- Product management → Product-service database: reads and writes (evidence: `narendra-farms/services/product-service/src/controllers/product.controller.ts`)
- WhatsApp notifications → WhatsApp provider: sends notifications
- WhatsApp provider → WhatsApp webhook: delivers events
