# rahulchakamuri/travion-krishidirect architecture

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

- Interactive diagram: https://gitdiagram.com/rahulchakamuri/travion-krishidirect
- Repository: https://github.com/rahulchakamuri/travion-krishidirect

## Overview

KrishiDirect connects farmers, village agents and buyers through assisted produce selling, verified supply aggregation, ordering and delivery. The principal flow is farmer produce entry and fair pricing, agent verification and pooling, buyer matching and ordering, then agent dispatch and buyer OTP delivery confirmation with payment release. The React portals call a FastAPI backend, which applies role controls, pricing and order-state validation over a shared SQLAlchemy data store. The README documents the end-to-end flow; unsampled route details are represented only at their documented subsystem level.

Main entry points: [`frontend/src/api.js`](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/api.js) (API Client), [`backend/app/api.py`](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/api.py) (FastAPI Routes), [`frontend/src/pages/agent`](https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/agent) (Agent Portal), [`frontend/src/pages/buyer`](https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/buyer) (Buyer Portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["Role Portals"]
  node_farmer_portal["Farmer Portal"]
  node_agent_portal["Agent Portal"]
  node_buyer_portal["Buyer Portal"]
  node_auth_ui["Portal Access<br/>[auth.jsx]"]
  node_api_client["API Client<br/>[api.js]"]
end

subgraph group_market["Supply Marketplace"]
  node_produce_pricing["Produce &amp; Pricing<br/>[AddProduce.jsx]"]
  node_verification["Produce Verification<br/>[Verification.jsx]"]
  node_supply_matching["Supply Matching<br/>[Matching.jsx]"]
  node_buyer_search["Buyer Search<br/>[FindProduce.jsx]"]
end

subgraph group_fulfillment["Order Fulfillment"]
  node_orders["Order Management<br/>[BuyerOrders.jsx]"]
  node_logistics["Logistics &amp; Delivery<br/>[AgentLogistics.jsx]"]
end

subgraph group_platform["Platform Services"]
  node_api["FastAPI Routes<br/>[api.py]"]
  node_pricing_engine["Fair-Price Engine<br/>[pricing.py]"]
  node_access_control["Role &amp; Token Security<br/>[security.py]"]
  node_order_state["Order State Machine<br/>[state_machine.py]"]
  node_data_model[("Domain Data Store<br/>[models.py]")]
end

node_farmer(("Farmer"))
node_agent(("Village Agent"))
node_buyer(("Buyer"))

node_farmer -->|"uses"| node_farmer_portal
node_agent -->|"uses"| node_agent_portal
node_buyer -->|"uses"| node_buyer_portal
node_farmer_portal -->|"enters produce"| node_produce_pricing
node_produce_pricing -.->|"requests API"| node_api_client
node_agent_portal -->|"reviews produce"| node_verification
node_verification -.->|"requests API"| node_api_client
node_agent_portal -->|"creates pools"| node_supply_matching
node_supply_matching -.->|"requests API"| node_api_client
node_buyer_portal -->|"searches supply"| node_buyer_search
node_buyer_search -.->|"requests API"| node_api_client
node_buyer_portal -->|"places orders"| node_orders
node_orders -.->|"requests API"| node_api_client
node_agent_portal -->|"schedules pickup"| node_logistics
node_logistics -.->|"requests API"| node_api_client
node_api_client -.->|"calls"| node_api
node_auth_ui -->|"stores credentials"| node_api_client
node_api -->|"uses pricing"| node_pricing_engine
node_api -->|"uses security"| node_access_control
node_api -->|"validates transitions"| node_order_state
node_api -->|"reads and writes"| node_data_model

click node_farmer_portal "https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/farmer"
click node_agent_portal "https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/agent"
click node_buyer_portal "https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/buyer"
click node_auth_ui "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/auth.jsx"
click node_api_client "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/api.js"
click node_produce_pricing "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/farmer/AddProduce.jsx"
click node_verification "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/agent/Verification.jsx"
click node_supply_matching "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/agent/Matching.jsx"
click node_buyer_search "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/buyer/FindProduce.jsx"
click node_orders "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/buyer/BuyerOrders.jsx"
click node_logistics "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/agent/AgentLogistics.jsx"
click node_api "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/api.py"
click node_pricing_engine "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/pricing.py"
click node_access_control "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/security.py"
click node_order_state "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/state_machine.py"
click node_data_model "https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/models.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_farmer_portal,node_agent_portal,node_buyer_portal,node_auth_ui,node_api_client toneBlue
class node_produce_pricing,node_verification,node_supply_matching,node_buyer_search toneAmber
class node_orders,node_logistics toneMint
class node_api,node_pricing_engine,node_access_control,node_order_state,node_data_model toneRose
class node_farmer,node_agent,node_buyer toneIndigo
```

## Components

### Role Portals

- [Farmer Portal](https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/farmer): `frontend/src/pages/farmer`
- [Agent Portal](https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/agent): `frontend/src/pages/agent`
- [Buyer Portal](https://github.com/rahulchakamuri/travion-krishidirect/tree/main/frontend/src/pages/buyer): `frontend/src/pages/buyer`
- [Portal Access](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/auth.jsx): `frontend/src/auth.jsx`
- [API Client](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Supply Marketplace

- [Produce & Pricing](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/farmer/AddProduce.jsx): `frontend/src/pages/farmer/AddProduce.jsx`
- [Produce Verification](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/agent/Verification.jsx): `frontend/src/pages/agent/Verification.jsx`
- [Supply Matching](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/agent/Matching.jsx): `frontend/src/pages/agent/Matching.jsx`
- [Buyer Search](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/buyer/FindProduce.jsx): `frontend/src/pages/buyer/FindProduce.jsx`

### Order Fulfillment

- [Order Management](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/buyer/BuyerOrders.jsx): `frontend/src/pages/buyer/BuyerOrders.jsx`
- [Logistics & Delivery](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/frontend/src/pages/agent/AgentLogistics.jsx): `frontend/src/pages/agent/AgentLogistics.jsx`

### Platform Services

- [FastAPI Routes](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/api.py): `backend/app/api.py`
- [Fair-Price Engine](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/pricing.py): `backend/app/pricing.py`
- [Role & Token Security](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/security.py): `backend/app/security.py`
- [Order State Machine](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/state_machine.py): `backend/app/state_machine.py`
- [Domain Data Store](https://github.com/rahulchakamuri/travion-krishidirect/blob/main/backend/app/models.py): `backend/app/models.py`

### Other components

- **Farmer**
- **Village Agent**
- **Buyer**

## Connections

- Farmer → Farmer Portal: uses (evidence: `README.md`)
- Village Agent → Agent Portal: uses (evidence: `README.md`)
- Buyer → Buyer Portal: uses (evidence: `README.md`)
- Farmer Portal → Produce & Pricing: enters produce (evidence: `README.md`)
- Produce & Pricing → API Client: requests API (evidence: `frontend/src/pages/farmer/AddProduce.jsx`)
- Agent Portal → Produce Verification: reviews produce (evidence: `README.md`)
- Produce Verification → API Client: requests API (evidence: `frontend/src/pages/agent/Verification.jsx`)
- Agent Portal → Supply Matching: creates pools (evidence: `README.md`)
- Supply Matching → API Client: requests API (evidence: `frontend/src/pages/agent/Matching.jsx`)
- Buyer Portal → Buyer Search: searches supply (evidence: `README.md`)
- Buyer Search → API Client: requests API (evidence: `frontend/src/pages/buyer/FindProduce.jsx`)
- Buyer Portal → Order Management: places orders (evidence: `README.md`)
- Order Management → API Client: requests API (evidence: `frontend/src/pages/buyer/BuyerOrders.jsx`)
- Agent Portal → Logistics & Delivery: schedules pickup (evidence: `README.md`)
- Logistics & Delivery → API Client: requests API (evidence: `frontend/src/pages/agent/AgentLogistics.jsx`)
- API Client → FastAPI Routes: calls
- Portal Access → API Client: stores credentials (evidence: `frontend/src/auth.jsx`)
- FastAPI Routes → Fair-Price Engine: uses pricing (evidence: `backend/app/api.py`)
- FastAPI Routes → Role & Token Security: uses security (evidence: `backend/app/api.py`)
- FastAPI Routes → Order State Machine: validates transitions (evidence: `backend/app/api.py`)
- FastAPI Routes → Domain Data Store: reads and writes (evidence: `backend/app/api.py`)
