How dhanuprithika/aruva works
Aruva is an agricultural marketplace with farmer listings, buyer and retailer discovery, interest requests, account/profile management, and notifications. The main journey runs from a role-based user through the React app and API to authentication, crop or marketplace operations, and PostgreSQL-backed records. README also describes market intelligence, AI recommendations, and Tamil accessibility, but sampled runtime sources do not show those implementations, so they are represented only as documented capabilities. Frontend request wiring is evidenced; finer unsampled routes and integrations are not inferred.
Main entry points: main.py FastAPI application · auth.py JWT and role checks · models.py Domain records · marketplace_service.py Discovery and interests
Components 23
User application
- Marketplace UI
frontend/src/app/App.tsx - API client
frontend/src/app/api.ts - English and Tamil
frontend/src/app/App.tsx
API and access
- FastAPI application
backend/app/main.py - JWT and role checks
backend/app/dependencies/auth.py
Marketplace workflows
- Farmer routes
backend/app/routers/farmer.py - Buyer routes
backend/app/routers/buyer.py - Retailer routes
backend/app/routers/retailer.py - Crop listings
backend/app/services/crop_service.py - Discovery and interests
backend/app/services/marketplace_service.py - Notification routes
backend/app/routers/notifications.py - Notification service
backend/app/services/notification_service.py - Market intelligence
backend/app - AI recommendations
backend/app
Identity and profiles
- Authentication routes
backend/app/routers/auth.py - Profile routes
backend/app/routers/profile.py - Token security
backend/app/core/security.py - Registration and login
backend/app/services/auth_service.py - User profiles
backend/app/services/user_service.py
Persistence
- Domain records
backend/app/models/models.py - Async database session
backend/app/database/session.py - PostgreSQL
Other components
- Farmers, buyers, retailers
Connections 38
- Farmers, buyers, retailers → Marketplace UI: uses
README.md - Marketplace UI → API client: requests
frontend/src/app/App.tsx - API client → FastAPI application: calls API
- FastAPI application → Authentication routes: registers
backend/app/main.py - FastAPI application → Profile routes: registers
backend/app/main.py - FastAPI application → Farmer routes: registers
backend/app/main.py - FastAPI application → Buyer routes: registers
backend/app/main.py - FastAPI application → Retailer routes: registers
backend/app/main.py - FastAPI application → Notification routes: registers
backend/app/main.py - Authentication routes → Registration and login: calls
backend/app/routers/auth.py - Authentication routes → User profiles: calls
backend/app/routers/auth.py - Profile routes → User profiles: calls
backend/app/routers/profile.py - Registration and login → Token security: creates tokens
backend/app/services/auth_service.py - JWT and role checks → Token security: decodes token
backend/app/dependencies/auth.py - JWT and role checks → Async database session: queries user
backend/app/dependencies/auth.py - Farmer routes → JWT and role checks: requires role
backend/app/routers/farmer.py - Buyer routes → JWT and role checks: requires role
backend/app/routers/buyer.py - Retailer routes → JWT and role checks: requires role
backend/app/routers/retailer.py - Notification routes → JWT and role checks: requires user
backend/app/routers/notifications.py - Farmer routes → Crop listings: calls
backend/app/routers/farmer.py - Farmer routes → Discovery and interests: calls
backend/app/routers/farmer.py - Buyer routes → Discovery and interests: calls
backend/app/routers/buyer.py - Buyer routes → Crop listings: calls
backend/app/routers/buyer.py - Retailer routes → Discovery and interests: calls
backend/app/routers/retailer.py - Retailer routes → Crop listings: calls
backend/app/routers/retailer.py - Notification routes → Notification service: calls
backend/app/routers/notifications.py - Discovery and interests → Domain records: reads and writes
backend/app/services/marketplace_service.py - Crop listings → Domain records: reads and writes
backend/app/services/crop_service.py - Registration and login → Domain records: creates records
backend/app/services/auth_service.py - User profiles → Domain records: updates records
backend/app/services/user_service.py - Notification service → Domain records: uses records
backend/app/services/notification_service.py - Domain records → Async database session: extends base
backend/app/models/models.py - FastAPI application → Async database session: disposes engine
backend/app/main.py - Async database session → PostgreSQL: persists data
- Discovery and interests → Notification service: creates notifications
- Farmers, buyers, retailers → Market intelligence: uses insights
README.md - Farmers, buyers, retailers → AI recommendations: requests recommendations
README.md - Farmers, buyers, retailers → English and Tamil: selects language
README.md