How vijayaramanujam/paari works
Paari is a food-rescue platform connecting donors, receivers, volunteers, and administrators. Users register or sign in, donors publish surplus food, receivers request it, and delivery logistics assign volunteers and track fulfillment; notifications support the handoffs. The frontend routes users to role-specific portals and a chatbot. The tree also shows matching, route optimization, payments, feedback, analytics, and wastage prediction capabilities, but their runtime wiring is not established by the sampled source. Those feature nodes are retained without speculative call chains.
Main entry points: App.jsx App shell · api.js REST client · LogisticsService.java Request and delivery · AuthController.java Authentication API
Components 24
Web experience
- App shell
frontend/src/App.jsx - Sign-in UI
frontend/src/pages/Auth.jsx - Donor portal
frontend/src/pages/DonorPortal.jsx - Role portals
frontend/src/pages - Chatbot UI
frontend/src/components/Chatbot.jsx - Language context
frontend/src/context/LanguageContext.jsx - REST client
frontend/src/api.js
Identity and access
- Authentication API
backend/src/main/java/com/paari/controller/AuthController.java - JWT security
backend/src/main/java/com/paari/security
Food rescue workflow
- Donation API
backend/src/main/java/com/paari/controller/DonationController.java - Request and delivery
backend/src/main/java/com/paari/service/LogisticsService.java - Delivery API
backend/src/main/java/com/paari/controller/DeliveryController.java
Platform capabilities
- Smart matching
backend/src/main/java/com/paari/service/SmartMatchingService.java - Route optimization
backend/src/main/java/com/paari/service/RouteOptimizationService.java - Wastage prediction
backend/src/main/java/com/paari/service/WastagePredictionService.java - Chatbot service
backend/src/main/java/com/paari/controller/ChatbotController.java - Other platform APIs
backend/src/main/java/com/paari/controller
Domain and persistence
- Rescue domain models
backend/src/main/java/com/paari/entity - Donation repository
backend/src/main/java/com/paari/repository/FoodDonationRepository.java - Delivery repository
backend/src/main/java/com/paari/repository/PickupDeliveryRepository.java - User repository
backend/src/main/java/com/paari/repository/UserRepository.java - Receiver repository
backend/src/main/java/com/paari/repository/ReceiverRepository.java
Other components
- Platform users
- Relational store
Connections 33
- Platform users → App shell: use
- App shell → Sign-in UI: renders
frontend/src/App.jsx - App shell → Donor portal: routes
frontend/src/App.jsx - App shell → Role portals: routes
frontend/src/App.jsx - App shell → Chatbot UI: renders
frontend/src/App.jsx - App shell → REST client: fetches notifications
frontend/src/App.jsx - Sign-in UI → REST client: submits credentials
frontend/src/pages/Auth.jsx - Chatbot UI → REST client: sends requests
frontend/src/components/Chatbot.jsx - App shell → Language context: uses translations
frontend/src/App.jsx - Sign-in UI → Language context: uses translations
frontend/src/pages/Auth.jsx - REST client → Authentication API: calls REST endpoints
- REST client → Donation API: calls REST endpoints
- REST client → Delivery API: calls REST endpoints
- REST client → Chatbot service: calls REST endpoints
- Authentication API → User repository: reads and writes users
backend/src/main/java/com/paari/controller/AuthController.java - Authentication API → JWT security: issues JWT
backend/src/main/java/com/paari/controller/AuthController.java - Authentication API → Receiver repository: creates profiles
backend/src/main/java/com/paari/controller/AuthController.java - Authentication API → Rescue domain models: creates role profiles
backend/src/main/java/com/paari/controller/AuthController.java - Donation API → Donation repository: saves and queries
backend/src/main/java/com/paari/controller/DonationController.java - Donation API → User repository: loads account
backend/src/main/java/com/paari/controller/DonationController.java - Donation API → Rescue domain models: creates donations
backend/src/main/java/com/paari/controller/DonationController.java - Delivery API → Request and delivery: delegates delivery work
backend/src/main/java/com/paari/controller/DeliveryController.java - Request and delivery → Donation repository: reads donations
backend/src/main/java/com/paari/service/LogisticsService.java - Request and delivery → Receiver repository: loads receivers
backend/src/main/java/com/paari/service/LogisticsService.java - Request and delivery → Delivery repository: saves delivery tasks
backend/src/main/java/com/paari/service/LogisticsService.java - Request and delivery → Rescue domain models: updates rescue state
backend/src/main/java/com/paari/service/LogisticsService.java - Donation repository → Relational store: persists entities
- Delivery repository → Relational store: persists entities
- User repository → Relational store: persists entities
- Receiver repository → Relational store: persists entities
- Smart matching → Receiver repository: queries receivers
backend/src/main/java/com/paari/service/SmartMatchingService.java - Smart matching → Rescue domain models: evaluates candidates
backend/src/main/java/com/paari/service/SmartMatchingService.java - Request and delivery → Route optimization: requests route planning
backend/src/main/java/com/paari/service/LogisticsService.java