# sonajus007-commits/marutham-agrolink architecture

> Architecture diagram of the GitHub repository sonajus007-commits/marutham-agrolink, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sonajus007-commits/marutham-agrolink
- Repository: https://github.com/sonajus007-commits/marutham-agrolink

## Overview

Marutham Agrolink is a farm-to-consumer produce marketplace with public shopping and a signed-in operations app. A shopper discovers produce, registers or signs in, places an order, and tracks delivery; farmers manage listings and orders, agents handle delivery, and administrators oversee platform operations. The React app routes users by role to these workflows, while Express exposes API routes backed by Supabase. The README documents additional marketplace capabilities; unsampled route internals are represented at their existing directory paths, with edges limited to documented or indexed relationships.

Main entry points: [`apps/web/src/App.tsx`](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/App.tsx) (App routes), [`backend/server.js`](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/server.js) (Express entry), [`backend/db/supabase.js`](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/db/supabase.js) (Supabase data store), [`apps/web/src/pages/consumer/ConsumerPage.tsx`](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/consumer/ConsumerPage.tsx) (Consumer workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public marketplace"]
  node_shop["Marketplace<br/>[page.tsx]"]
  node_shop_product["Product detail<br/>[page.tsx]"]
  node_shop_cart["Shop cart<br/>[CartProvider.tsx]"]
end

subgraph group_portal["Signed-in app"]
  node_web_entry["App routes<br/>[App.tsx]"]
  node_web_auth["Session and roles<br/>[AuthContext.tsx]"]
  node_consumer["Consumer workflow<br/>[ConsumerPage.tsx]"]
  node_consumer_data["Consumer data"]
  node_farmer["Farmer workflow<br/>[FarmerPage.tsx]"]
  node_agent["Agent workflow<br/>[AgentPage.tsx]"]
  node_admin["Admin workflow<br/>[AdminPage.tsx]"]
end

subgraph group_backend["API and access"]
  node_server["Express entry<br/>[server.js]"]
  node_auth_routes["Authentication API<br/>[auth.js]"]
  node_auth_mw["Authentication middleware<br/>[auth.js]"]
  node_permissions["Permission resolution<br/>[permissions.js]"]
end

subgraph group_domain["Platform operations"]
  node_orders["Order API<br/>[orders.js]"]
  node_delivery["Delivery API<br/>[delivery.js]"]
  node_market_ops["Marketplace APIs"]
  node_dashboard["Management APIs<br/>[dashboard.js]"]
end

subgraph group_data["Shared services"]
  node_api_client["Typed API client<br/>[client.ts]"]
  node_supabase[("Supabase data store<br/>[supabase.js]")]
end

node_shopper(("Shopper"))
node_farmer_actor(("Farmer"))
node_agent_actor(("Delivery agent"))
node_admin_actor(("Administrator"))

node_shopper -->|"browses"| node_shop
node_shop -->|"opens products"| node_shop_product
node_shop_product -.->|"adds to cart"| node_shop_cart
node_shopper -->|"opens app"| node_web_entry
node_web_entry -->|"provides session"| node_web_auth
node_web_entry -->|"routes consumer"| node_consumer
node_web_entry -->|"routes farmer"| node_farmer
node_web_entry -->|"routes agent"| node_agent
node_web_entry -->|"routes admin"| node_admin
node_consumer -->|"uses data context"| node_consumer_data
node_consumer -.->|"loads marketplace data"| node_api_client
node_farmer_actor -->|"manages listings"| node_farmer
node_agent_actor -->|"handles deliveries"| node_agent
node_admin_actor -->|"oversees platform"| node_admin
node_web_auth -->|"verifies session"| node_api_client
node_api_client -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_orders
node_server -->|"mounts routes"| node_delivery
node_server -->|"mounts routes"| node_market_ops
node_server -->|"mounts routes"| node_dashboard
node_auth_routes -->|"guards requests"| node_auth_mw
node_auth_routes -->|"reads and writes"| node_supabase
node_auth_mw -->|"loads user"| node_supabase
node_auth_mw -->|"resolves access"| node_permissions
node_permissions -->|"loads role rules"| node_supabase
node_orders -.->|"persists orders"| node_supabase
node_delivery -.->|"updates delivery"| node_supabase
node_market_ops -.->|"serves platform data"| node_supabase
node_dashboard -->|"queries metrics"| node_supabase

click node_shop "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/shop/app/products/page.tsx"
click node_shop_product "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/shop/app/products/%5Bid%5D/page.tsx"
click node_shop_cart "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/shop/components/cart/CartProvider.tsx"
click node_web_entry "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/App.tsx"
click node_web_auth "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/auth/AuthContext.tsx"
click node_consumer "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/consumer/ConsumerPage.tsx"
click node_consumer_data "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/consumer/ConsumerDataContext.tsx"
click node_farmer "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/farmer/FarmerPage.tsx"
click node_agent "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/agent/AgentPage.tsx"
click node_admin "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/admin/AdminPage.tsx"
click node_api_client "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/packages/api-client/src/client.ts"
click node_server "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/server.js"
click node_auth_routes "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/auth.js"
click node_orders "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/orders.js"
click node_delivery "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/delivery.js"
click node_market_ops "https://github.com/sonajus007-commits/marutham-agrolink/tree/main/backend/routes"
click node_dashboard "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/dashboard.js"
click node_auth_mw "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/middleware/auth.js"
click node_permissions "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/middleware/permissions.js"
click node_supabase "https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/db/supabase.js"

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_shop,node_shop_product,node_shop_cart toneBlue
class node_web_entry,node_web_auth,node_consumer,node_consumer_data,node_farmer,node_agent,node_admin toneAmber
class node_server,node_auth_routes,node_auth_mw,node_permissions toneMint
class node_orders,node_delivery,node_market_ops,node_dashboard toneRose
class node_api_client,node_supabase,node_shopper,node_farmer_actor,node_agent_actor,node_admin_actor toneIndigo
```

## Components

### Public marketplace

- [Marketplace](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/shop/app/products/page.tsx): `apps/shop/app/products/page.tsx`
- [Product detail](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/shop/app/products/%5Bid%5D/page.tsx): `apps/shop/app/products/[id]/page.tsx`
- [Shop cart](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/shop/components/cart/CartProvider.tsx): `apps/shop/components/cart/CartProvider.tsx`

### Signed-in app

- [App routes](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Session and roles](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/auth/AuthContext.tsx): `apps/web/src/auth/AuthContext.tsx`
- [Consumer workflow](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/consumer/ConsumerPage.tsx): `apps/web/src/pages/consumer/ConsumerPage.tsx`
- [Consumer data](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/consumer/ConsumerDataContext.tsx): `apps/web/src/pages/consumer/ConsumerDataContext.tsx`
- [Farmer workflow](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/farmer/FarmerPage.tsx): `apps/web/src/pages/farmer/FarmerPage.tsx`
- [Agent workflow](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/agent/AgentPage.tsx): `apps/web/src/pages/agent/AgentPage.tsx`
- [Admin workflow](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/apps/web/src/pages/admin/AdminPage.tsx): `apps/web/src/pages/admin/AdminPage.tsx`

### API and access

- [Express entry](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/server.js): `backend/server.js`
- [Authentication API](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Authentication middleware](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Permission resolution](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/middleware/permissions.js): `backend/middleware/permissions.js`

### Platform operations

- [Order API](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/orders.js): `backend/routes/orders.js`
- [Delivery API](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/delivery.js): `backend/routes/delivery.js`
- [Marketplace APIs](https://github.com/sonajus007-commits/marutham-agrolink/tree/main/backend/routes): `backend/routes`
- [Management APIs](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/routes/dashboard.js): `backend/routes/dashboard.js`

### Shared services

- [Typed API client](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/packages/api-client/src/client.ts): `packages/api-client/src/client.ts`
- [Supabase data store](https://github.com/sonajus007-commits/marutham-agrolink/blob/main/backend/db/supabase.js): `backend/db/supabase.js`

### Other components

- **Shopper**
- **Farmer**
- **Delivery agent**
- **Administrator**

## Connections

- Shopper → Marketplace: browses (evidence: `README.md`)
- Marketplace → Product detail: opens products (evidence: `apps/shop/app/products/page.tsx`)
- Product detail → Shop cart: adds to cart
- Shopper → App routes: opens app (evidence: `README.md`)
- App routes → Session and roles: provides session (evidence: `apps/web/src/App.tsx`)
- App routes → Consumer workflow: routes consumer (evidence: `apps/web/src/App.tsx`)
- App routes → Farmer workflow: routes farmer (evidence: `apps/web/src/App.tsx`)
- App routes → Agent workflow: routes agent (evidence: `apps/web/src/App.tsx`)
- App routes → Admin workflow: routes admin (evidence: `apps/web/src/App.tsx`)
- Consumer workflow → Consumer data: uses data context (evidence: `apps/web/src/pages/consumer/ConsumerPage.tsx`)
- Consumer workflow → Typed API client: loads marketplace data
- Farmer → Farmer workflow: manages listings (evidence: `README.md`)
- Delivery agent → Agent workflow: handles deliveries (evidence: `README.md`)
- Administrator → Admin workflow: oversees platform (evidence: `README.md`)
- Session and roles → Typed API client: verifies session (evidence: `apps/web/src/auth/AuthContext.tsx`)
- Typed API client → Express entry: calls API (evidence: `README.md`)
- Express entry → Authentication API: mounts routes (evidence: `backend/server.js`)
- Express entry → Order API: mounts routes (evidence: `backend/server.js`)
- Express entry → Delivery API: mounts routes (evidence: `backend/server.js`)
- Express entry → Marketplace APIs: mounts routes (evidence: `backend/server.js`)
- Express entry → Management APIs: mounts routes (evidence: `backend/server.js`)
- Authentication API → Authentication middleware: guards requests (evidence: `backend/routes/auth.js`)
- Authentication API → Supabase data store: reads and writes (evidence: `backend/routes/auth.js`)
- Authentication middleware → Supabase data store: loads user (evidence: `backend/middleware/auth.js`)
- Authentication middleware → Permission resolution: resolves access (evidence: `backend/middleware/auth.js`)
- Permission resolution → Supabase data store: loads role rules (evidence: `backend/middleware/permissions.js`)
- Order API → Supabase data store: persists orders
- Delivery API → Supabase data store: updates delivery
- Marketplace APIs → Supabase data store: serves platform data (evidence: `backend/routes/auth.js`)
- Management APIs → Supabase data store: queries metrics (evidence: `backend/routes/dashboard.js`)
