# vijayaramanujam/paari architecture

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

- Interactive diagram: https://gitdiagram.com/vijayaramanujam/paari
- Repository: https://github.com/vijayaramanujam/paari

## Overview

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: [`frontend/src/App.jsx`](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/App.jsx) (App shell), [`frontend/src/api.js`](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/api.js) (REST client), [`backend/src/main/java/com/paari/service/LogisticsService.java`](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/LogisticsService.java) (Request and delivery), [`backend/src/main/java/com/paari/controller/AuthController.java`](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/AuthController.java) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["App shell<br/>[App.jsx]"]
  node_authui["Sign-in UI<br/>[Auth.jsx]"]
  node_donorui["Donor portal<br/>[DonorPortal.jsx]"]
  node_roleui["Role portals"]
  node_chatui["Chatbot UI<br/>[Chatbot.jsx]"]
  node_language["Language context"]
  node_api["REST client<br/>[api.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication API"]
  node_security["JWT security"]
end

subgraph group_rescue["Food rescue workflow"]
  node_donations["Donation API"]
  node_logistics["Request and delivery"]
  node_deliveryapi["Delivery API"]
end

subgraph group_insights["Platform capabilities"]
  node_matching["Smart matching"]
  node_routing["Route optimization"]
  node_prediction["Wastage prediction"]
  node_chatapi["Chatbot service"]
  node_otherapi["Other platform APIs"]
end

subgraph group_data["Domain and persistence"]
  node_models["Rescue domain models"]
  node_donationrepo["Donation repository"]
  node_deliveryrepo["Delivery repository"]
  node_userrepo["User repository"]
  node_receiverrepo["Receiver repository"]
end

node_people(("Platform users"))
node_store[("Relational store")]

node_people -.->|"use"| node_app
node_app -->|"renders"| node_authui
node_app -->|"routes"| node_donorui
node_app -->|"routes"| node_roleui
node_app -->|"renders"| node_chatui
node_app -->|"fetches notifications"| node_api
node_authui -->|"submits credentials"| node_api
node_chatui -->|"sends requests"| node_api
node_app -->|"uses translations"| node_language
node_authui -->|"uses translations"| node_language
node_api -.->|"calls REST endpoints"| node_auth
node_api -.->|"calls REST endpoints"| node_donations
node_api -.->|"calls REST endpoints"| node_deliveryapi
node_api -.->|"calls REST endpoints"| node_chatapi
node_auth -->|"reads and writes users"| node_userrepo
node_auth -->|"issues JWT"| node_security
node_auth -->|"creates profiles"| node_receiverrepo
node_auth -->|"creates role profiles"| node_models
node_donations -->|"saves and queries"| node_donationrepo
node_donations -->|"loads account"| node_userrepo
node_donations -->|"creates donations"| node_models
node_deliveryapi -->|"delegates delivery work"| node_logistics
node_logistics -->|"reads donations"| node_donationrepo
node_logistics -->|"loads receivers"| node_receiverrepo
node_logistics -->|"saves delivery tasks"| node_deliveryrepo
node_logistics -->|"updates rescue state"| node_models
node_donationrepo -.->|"persists entities"| node_store
node_deliveryrepo -.->|"persists entities"| node_store
node_userrepo -.->|"persists entities"| node_store
node_receiverrepo -.->|"persists entities"| node_store
node_matching -->|"queries receivers"| node_receiverrepo
node_matching -->|"evaluates candidates"| node_models
node_logistics -->|"requests route planning"| node_routing

click node_app "https://github.com/vijayaramanujam/paari/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/vijayaramanujam/paari/blob/main/frontend/src/pages/Auth.jsx"
click node_donorui "https://github.com/vijayaramanujam/paari/blob/main/frontend/src/pages/DonorPortal.jsx"
click node_roleui "https://github.com/vijayaramanujam/paari/tree/main/frontend/src/pages"
click node_chatui "https://github.com/vijayaramanujam/paari/blob/main/frontend/src/components/Chatbot.jsx"
click node_language "https://github.com/vijayaramanujam/paari/blob/main/frontend/src/context/LanguageContext.jsx"
click node_api "https://github.com/vijayaramanujam/paari/blob/main/frontend/src/api.js"
click node_auth "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/AuthController.java"
click node_security "https://github.com/vijayaramanujam/paari/tree/main/backend/src/main/java/com/paari/security"
click node_donations "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/DonationController.java"
click node_logistics "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/LogisticsService.java"
click node_deliveryapi "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/DeliveryController.java"
click node_matching "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/SmartMatchingService.java"
click node_routing "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/RouteOptimizationService.java"
click node_prediction "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/WastagePredictionService.java"
click node_chatapi "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/ChatbotController.java"
click node_otherapi "https://github.com/vijayaramanujam/paari/tree/main/backend/src/main/java/com/paari/controller"
click node_models "https://github.com/vijayaramanujam/paari/tree/main/backend/src/main/java/com/paari/entity"
click node_donationrepo "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/FoodDonationRepository.java"
click node_deliveryrepo "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/PickupDeliveryRepository.java"
click node_userrepo "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/UserRepository.java"
click node_receiverrepo "https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/ReceiverRepository.java"

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_app,node_authui,node_donorui,node_roleui,node_chatui,node_language,node_api,node_people toneBlue
class node_auth,node_security,node_store toneAmber
class node_donations,node_logistics,node_deliveryapi toneMint
class node_matching,node_routing,node_prediction,node_chatapi,node_otherapi toneRose
class node_models,node_donationrepo,node_deliveryrepo,node_userrepo,node_receiverrepo toneIndigo
```

## Components

### Web experience

- [App shell](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in UI](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/pages/Auth.jsx): `frontend/src/pages/Auth.jsx`
- [Donor portal](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/pages/DonorPortal.jsx): `frontend/src/pages/DonorPortal.jsx`
- [Role portals](https://github.com/vijayaramanujam/paari/tree/main/frontend/src/pages): `frontend/src/pages`
- [Chatbot UI](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/components/Chatbot.jsx): `frontend/src/components/Chatbot.jsx`
- [Language context](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/context/LanguageContext.jsx): `frontend/src/context/LanguageContext.jsx`
- [REST client](https://github.com/vijayaramanujam/paari/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Identity and access

- [Authentication API](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/AuthController.java): `backend/src/main/java/com/paari/controller/AuthController.java`
- [JWT security](https://github.com/vijayaramanujam/paari/tree/main/backend/src/main/java/com/paari/security): `backend/src/main/java/com/paari/security`

### Food rescue workflow

- [Donation API](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/DonationController.java): `backend/src/main/java/com/paari/controller/DonationController.java`
- [Request and delivery](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/LogisticsService.java): `backend/src/main/java/com/paari/service/LogisticsService.java`
- [Delivery API](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/DeliveryController.java): `backend/src/main/java/com/paari/controller/DeliveryController.java`

### Platform capabilities

- [Smart matching](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/SmartMatchingService.java): `backend/src/main/java/com/paari/service/SmartMatchingService.java`
- [Route optimization](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/RouteOptimizationService.java): `backend/src/main/java/com/paari/service/RouteOptimizationService.java`
- [Wastage prediction](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/service/WastagePredictionService.java): `backend/src/main/java/com/paari/service/WastagePredictionService.java`
- [Chatbot service](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/controller/ChatbotController.java): `backend/src/main/java/com/paari/controller/ChatbotController.java`
- [Other platform APIs](https://github.com/vijayaramanujam/paari/tree/main/backend/src/main/java/com/paari/controller): `backend/src/main/java/com/paari/controller`

### Domain and persistence

- [Rescue domain models](https://github.com/vijayaramanujam/paari/tree/main/backend/src/main/java/com/paari/entity): `backend/src/main/java/com/paari/entity`
- [Donation repository](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/FoodDonationRepository.java): `backend/src/main/java/com/paari/repository/FoodDonationRepository.java`
- [Delivery repository](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/PickupDeliveryRepository.java): `backend/src/main/java/com/paari/repository/PickupDeliveryRepository.java`
- [User repository](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/UserRepository.java): `backend/src/main/java/com/paari/repository/UserRepository.java`
- [Receiver repository](https://github.com/vijayaramanujam/paari/blob/main/backend/src/main/java/com/paari/repository/ReceiverRepository.java): `backend/src/main/java/com/paari/repository/ReceiverRepository.java`

### Other components

- **Platform users**
- **Relational store**

## Connections

- Platform users → App shell: use
- App shell → Sign-in UI: renders (evidence: `frontend/src/App.jsx`)
- App shell → Donor portal: routes (evidence: `frontend/src/App.jsx`)
- App shell → Role portals: routes (evidence: `frontend/src/App.jsx`)
- App shell → Chatbot UI: renders (evidence: `frontend/src/App.jsx`)
- App shell → REST client: fetches notifications (evidence: `frontend/src/App.jsx`)
- Sign-in UI → REST client: submits credentials (evidence: `frontend/src/pages/Auth.jsx`)
- Chatbot UI → REST client: sends requests (evidence: `frontend/src/components/Chatbot.jsx`)
- App shell → Language context: uses translations (evidence: `frontend/src/App.jsx`)
- Sign-in UI → Language context: uses translations (evidence: `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 (evidence: `backend/src/main/java/com/paari/controller/AuthController.java`)
- Authentication API → JWT security: issues JWT (evidence: `backend/src/main/java/com/paari/controller/AuthController.java`)
- Authentication API → Receiver repository: creates profiles (evidence: `backend/src/main/java/com/paari/controller/AuthController.java`)
- Authentication API → Rescue domain models: creates role profiles (evidence: `backend/src/main/java/com/paari/controller/AuthController.java`)
- Donation API → Donation repository: saves and queries (evidence: `backend/src/main/java/com/paari/controller/DonationController.java`)
- Donation API → User repository: loads account (evidence: `backend/src/main/java/com/paari/controller/DonationController.java`)
- Donation API → Rescue domain models: creates donations (evidence: `backend/src/main/java/com/paari/controller/DonationController.java`)
- Delivery API → Request and delivery: delegates delivery work (evidence: `backend/src/main/java/com/paari/controller/DeliveryController.java`)
- Request and delivery → Donation repository: reads donations (evidence: `backend/src/main/java/com/paari/service/LogisticsService.java`)
- Request and delivery → Receiver repository: loads receivers (evidence: `backend/src/main/java/com/paari/service/LogisticsService.java`)
- Request and delivery → Delivery repository: saves delivery tasks (evidence: `backend/src/main/java/com/paari/service/LogisticsService.java`)
- Request and delivery → Rescue domain models: updates rescue state (evidence: `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 (evidence: `backend/src/main/java/com/paari/service/SmartMatchingService.java`)
- Smart matching → Rescue domain models: evaluates candidates (evidence: `backend/src/main/java/com/paari/service/SmartMatchingService.java`)
- Request and delivery → Route optimization: requests route planning (evidence: `backend/src/main/java/com/paari/service/LogisticsService.java`)
