# abiram795/agriconnect-f2c architecture

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

- Interactive diagram: https://gitdiagram.com/abiram795/agriconnect-f2c
- Repository: https://github.com/abiram795/agriconnect-f2c

## Overview

AgriConnect is a farm-to-consumer marketplace with role-based workflows for farmers, consumers, delivery partners, hubs, and administrators. Users enter through the React app, manage produce listings or browse and order goods, while the backend provides marketplace, market-analysis, AI, logistics, and IVR capabilities. The supplied excerpts show frontend routes and selected HTTP requests, plus backend integrations with Supabase and market/AI services; many endpoint implementations were not shown, so those links are marked unverified or omitted.

Main entry points: [`Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py) (Backend API), [`Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx`](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx) (Farmer dashboard), [`Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/config/api.ts`](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/config/api.ts) (API URL config), [`Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/ConsumerHome.tsx`](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/ConsumerHome.tsx) (Consumer shopping)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_browser["Browser app<br/>[main.tsx]"]
  node_routes["Role routes<br/>[App.tsx]"]
  node_api_client["API URL config<br/>[api.ts]"]
end

subgraph group_commerce["Marketplace workflows"]
  node_farmer_dash["Farmer dashboard"]
  node_listings["Crop listings<br/>[FarmerListings.tsx]"]
  node_consumer_home["Consumer shopping<br/>[ConsumerHome.tsx]"]
  node_order_modal["Order form<br/>[OrderModal.tsx]"]
  node_address_form["Address form<br/>[AddressForm.tsx]"]
  node_ivr_ui["IVR menu"]
end

subgraph group_backend["Backend services"]
  node_backend_api["Backend API<br/>[main.py]"]
  node_data_models["Domain models<br/>[models.py]"]
  node_ivr["IVR service<br/>[ivr_service.py]"]
  node_geo_service["Geo logistics<br/>[geo_logistics.py]"]
  node_supabase[("Supabase store")]
end

subgraph group_insights["Decision support"]
  node_market_service["Market data<br/>[market_service.py]"]
  node_market_ui["Market analysis"]
  node_ai_service["AI assistance<br/>[ai_service.py]"]
end

node_farmer(("Farmer"))
node_consumer(("Consumer"))
node_market_data["Agmarknet API"]
node_gemini["Gemini API"]

node_browser -->|"renders"| node_routes
node_routes -->|"routes to"| node_farmer_dash
node_routes -->|"routes to"| node_consumer_home
node_farmer -.->|"manages produce"| node_farmer_dash
node_consumer -.->|"browses goods"| node_consumer_home
node_farmer_dash -.->|"opens listings"| node_listings
node_farmer_dash -->|"opens analysis"| node_market_ui
node_farmer_dash -->|"opens IVR"| node_ivr_ui
node_consumer_home -->|"opens order"| node_order_modal
node_order_modal -->|"uses address"| node_address_form
node_farmer_dash -->|"builds requests"| node_api_client
node_consumer_home -->|"builds requests"| node_api_client
node_listings -->|"builds requests"| node_api_client
node_market_ui -->|"builds requests"| node_api_client
node_ivr_ui -->|"builds requests"| node_api_client
node_api_client -.->|"HTTP requests"| node_backend_api
node_backend_api -->|"reads and writes"| node_supabase
node_ivr -->|"logs calls"| node_supabase
node_backend_api -.->|"uses models"| node_data_models
node_backend_api -.->|"delegates IVR"| node_ivr
node_backend_api -.->|"delegates analysis"| node_market_service
node_backend_api -.->|"delegates AI"| node_ai_service
node_backend_api -.->|"delegates logistics"| node_geo_service
node_market_service -->|"fetches prices"| node_market_data
node_market_service -->|"requests synthesis"| node_gemini
node_ai_service -->|"analyzes images"| node_gemini

click node_browser "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/main.tsx"
click node_routes "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/App.tsx"
click node_api_client "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/config/api.ts"
click node_farmer_dash "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx"
click node_listings "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerListings.tsx"
click node_consumer_home "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/ConsumerHome.tsx"
click node_order_modal "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/OrderModal.tsx"
click node_address_form "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/AddressForm.tsx"
click node_backend_api "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py"
click node_data_models "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/models.py"
click node_ivr "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ivr_service.py"
click node_ivr_ui "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/FarmerIVRMenuModal.tsx"
click node_market_service "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/market_service.py"
click node_market_ui "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/MarketAnalysisModal.tsx"
click node_ai_service "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ai_service.py"
click node_geo_service "https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/geo_logistics.py"

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_browser,node_routes,node_api_client toneBlue
class node_farmer_dash,node_listings,node_consumer_home,node_order_modal,node_address_form,node_ivr_ui toneAmber
class node_backend_api,node_data_models,node_ivr,node_geo_service,node_supabase,node_market_data,node_gemini toneMint
class node_market_service,node_market_ui,node_ai_service toneRose
class node_farmer,node_consumer toneIndigo
```

## Components

### Web application

- [Browser app](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/main.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/main.tsx`
- [Role routes](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/App.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/App.tsx`
- [API URL config](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/config/api.ts): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/config/api.ts`

### Marketplace workflows

- [Farmer dashboard](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx`
- [Crop listings](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerListings.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerListings.tsx`
- [Consumer shopping](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/ConsumerHome.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/ConsumerHome.tsx`
- [Order form](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/OrderModal.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/OrderModal.tsx`
- [Address form](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/AddressForm.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/AddressForm.tsx`
- [IVR menu](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/FarmerIVRMenuModal.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/FarmerIVRMenuModal.tsx`

### Backend services

- [Backend API](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`
- [Domain models](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/models.py): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/models.py`
- [IVR service](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ivr_service.py): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ivr_service.py`
- [Geo logistics](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/geo_logistics.py): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/geo_logistics.py`
- **Supabase store**

### Decision support

- [Market data](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/market_service.py): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/market_service.py`
- [Market analysis](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/MarketAnalysisModal.tsx): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/MarketAnalysisModal.tsx`
- [AI assistance](https://github.com/abiram795/agriconnect-f2c/blob/main/Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ai_service.py): `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ai_service.py`

### Other components

- **Farmer**
- **Consumer**
- **Agmarknet API**
- **Gemini API**

## Connections

- Browser app → Role routes: renders (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/main.tsx`)
- Role routes → Farmer dashboard: routes to (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/App.tsx`)
- Role routes → Consumer shopping: routes to (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/App.tsx`)
- Farmer → Farmer dashboard: manages produce
- Consumer → Consumer shopping: browses goods
- Farmer dashboard → Crop listings: opens listings
- Farmer dashboard → Market analysis: opens analysis (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx`)
- Farmer dashboard → IVR menu: opens IVR (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx`)
- Consumer shopping → Order form: opens order (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/ConsumerHome.tsx`)
- Order form → Address form: uses address (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/OrderModal.tsx`)
- Farmer dashboard → API URL config: builds requests (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerDashboard.tsx`)
- Consumer shopping → API URL config: builds requests (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/ConsumerHome.tsx`)
- Crop listings → API URL config: builds requests (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/pages/FarmerListings.tsx`)
- Market analysis → API URL config: builds requests (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/MarketAnalysisModal.tsx`)
- IVR menu → API URL config: builds requests (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/frontend/src/components/FarmerIVRMenuModal.tsx`)
- API URL config → Backend API: HTTP requests
- Backend API → Supabase store: reads and writes (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`)
- IVR service → Supabase store: logs calls (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ivr_service.py`)
- Backend API → Domain models: uses models (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`)
- Backend API → IVR service: delegates IVR (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`)
- Backend API → Market data: delegates analysis (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`)
- Backend API → AI assistance: delegates AI (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`)
- Backend API → Geo logistics: delegates logistics (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/main.py`)
- Market data → Agmarknet API: fetches prices (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/market_service.py`)
- Market data → Gemini API: requests synthesis (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/market_service.py`)
- AI assistance → Gemini API: analyzes images (evidence: `Agri-connect-F2C-jules-agriconnect-init-9153873128297835644/backend/ai_service.py`)
