How santhosh-ek2007-zen/kuralagri works
KuralAgri is an agricultural aggregation platform connecting farmers, CSC hubs, and commercial buyers. Its principal workflow is listing produce, grading and pricing it, assigning it to a nearby hub, pooling it for buyer orders, and settling collection through escrow and QR confirmation; reputation records completed transactions. The graph includes the documented product capabilities and sampled API/UI structure. Some feature links come from the README because relevant implementation details were not excerpted.
Main entry points: main.py API application · database.py Relational database · client.js API client · App.jsx Application shell
Components 23
Supply and market
- Produce listings
backend/app/routers/listings.py - AI quality grading
backend/app/services/ai_grading.py - Hub assignment
backend/app/services/geo.py - Mandi pricing
backend/app/services/pricing.py - Aggregation points
backend/app/routers/aggregation_points.py - IVR listing service
backend/app/routers/ivr.py
Orders and trust
- Buyer aggregation
backend/app/routers/buyer.py - Orders and escrow
backend/app/routers/orders.py - Trust and disputes
backend/app/routers/reputation.py
Backend services
- Accounts and access
backend/app/routers/auth.py - Relational database
backend/app/database.py - Domain records
backend/app/models.py - API application
backend/main.py
Frontend experience
- Farmer studio
frontend/src/components/FarmerPortal.jsx - Buyer catalog
frontend/src/components/BuyerCatalog.jsx - IVR simulator
frontend/src/components/IvrSimulatorModal.jsx - Escrow pickup view
frontend/src/components/OrderEscrowView.jsx - Reputation center
frontend/src/components/ReputationView.jsx - Application shell
frontend/src/App.jsx - API client
frontend/src/api/client.js
Other components
- Farmers / CSC operators
- Commercial buyers
- CSC hub managers
Connections 44
- Application shell → Farmer studio: renders
frontend/src/App.jsx - Application shell → Buyer catalog: renders
frontend/src/App.jsx - Application shell → IVR simulator: opens
frontend/src/App.jsx - Application shell → Escrow pickup view: renders
frontend/src/App.jsx - Application shell → Reputation center: renders
frontend/src/App.jsx - Application shell → API client: checks health
frontend/src/App.jsx - Farmer studio → API client: requests listings
frontend/src/components/FarmerPortal.jsx - Buyer catalog → API client: loads catalog
frontend/src/components/BuyerCatalog.jsx - IVR simulator → API client: submits IVR
frontend/src/components/IvrSimulatorModal.jsx - Escrow pickup view → API client: manages orders
frontend/src/components/OrderEscrowView.jsx - Reputation center → API client: loads trust
frontend/src/components/ReputationView.jsx - API client → Produce listings: uploads photos
frontend/src/api/client.js - API client → Orders and escrow: places orders
frontend/src/api/client.js - API client → IVR listing service: simulates calls
frontend/src/api/client.js - Farmers / CSC operators → Farmer studio: lists produce
README.md - Farmers / CSC operators → IVR simulator: uses voice listing
README.md - Commercial buyers → Buyer catalog: browses produce
README.md - CSC hub managers → Escrow pickup view: scans pickup QR
README.md - API application → Accounts and access: registers router
backend/main.py - API application → Produce listings: registers router
backend/main.py - API application → Aggregation points: registers router
backend/main.py - API application → Buyer aggregation: registers router
backend/main.py - API application → Orders and escrow: registers router
backend/main.py - API application → Mandi pricing: registers router
backend/main.py - API application → Trust and disputes: registers router
backend/main.py - API application → IVR listing service: registers router
backend/main.py - API application → Relational database: initializes
backend/main.py - API application → Relational database: seeds data
backend/main.py - Produce listings → Hub assignment: assigns hub
backend/app/routers/listings.py - Produce listings → AI quality grading: analyzes image
backend/app/routers/listings.py - Produce listings → Mandi pricing: calculates price
backend/app/routers/listings.py - IVR listing service → Hub assignment: assigns hub
backend/app/routers/ivr.py - IVR listing service → Mandi pricing: calculates price
backend/app/routers/ivr.py - Aggregation points → Hub assignment: uses routing
backend/app/routers/aggregation_points.py - Accounts and access → Relational database: reads and writes
backend/app/routers/auth.py - Produce listings → Relational database: reads and writes
backend/app/routers/listings.py - Buyer aggregation → Relational database: reads catalog
backend/app/routers/buyer.py - Orders and escrow → Relational database: reads and writes
backend/app/routers/orders.py - Trust and disputes → Relational database: reads trust records
backend/app/routers/reputation.py - IVR listing service → Relational database: reads and writes
backend/app/routers/ivr.py - Aggregation points → Relational database: reads hubs
backend/app/routers/aggregation_points.py - Relational database → Domain records: maps records
backend/app/models.py - Orders and escrow → Trust and disputes: updates trust
README.md - Orders and escrow → CSC hub managers: releases escrow
README.md