# adityanakhale/foodrescuai-springboot architecture

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

- Interactive diagram: https://gitdiagram.com/adityanakhale/foodrescuai-springboot
- Repository: https://github.com/adityanakhale/foodrescuai-springboot

## Overview

FoodRescuAI is a Spring Boot food-rescue platform connecting donors and NGOs. Its documented workflow covers donor and NGO access, donation posting, location- and capacity-based allocation, and NGO assignments, with dashboards for tracking. The tree exposes controllers, services, repositories, models, and Thymeleaf views, but no source excerpts were provided; therefore, internal call and persistence relationships cannot be verified. Dashed links mark relationships suggested by the README but not confirmed in source.

Main entry points: [`src/main/java/org/example/project3/service/RuleEngineService.java`](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/RuleEngineService.java) (Allocation rules), [`src/main/java/org/example/project3/Controller/FoodController.java`](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/FoodController.java) (Donation management), [`src/main/java/org/example/project3/Controller/LoginController.java`](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/LoginController.java) (Login), [`src/main/java/org/example/project3/Controller/DashboardController.java`](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/DashboardController.java) (Dashboards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_users["Participants"]
end

subgraph group_web["Web application"]
  node_spring_app["Application entry"]
  node_auth["Login"]
  node_food["Donation management"]
  node_dashboards["Dashboards"]
  node_admin["Administration"]
  node_admin_search["Admin search"]
  node_service_controller["Service endpoints"]
  node_views["Thymeleaf views"]
end

subgraph group_allocation["Rescue coordination"]
  node_allocation_engine["Allocation rules"]
  node_distance["Distance calculation"]
  node_email["Email notifications<br/>[EmailService.java]"]
  node_file_storage["File uploads"]
end

subgraph group_data["Domain and persistence"]
  node_donation_data[("Donation records")]
  node_food_data[("Food records")]
  node_ngo_data[("NGO records<br/>[NGORepository.java]")]
  node_allocation_data[("Allocation requests")]
  node_feedback_data[("Feedback records")]
  node_domain_models["Domain models"]
end

node_donor(("Donor"))
node_ngo(("NGO"))

node_donor -->|"posts donations"| node_food
node_ngo -->|"receives assignments"| node_allocation_engine
node_donor -->|"signs in"| node_auth
node_ngo -->|"signs in"| node_auth
node_allocation_engine -.->|"uses location"| node_distance
node_food -.->|"requests allocation"| node_allocation_engine
node_donor -->|"tracks donations"| node_dashboards
node_ngo -->|"tracks requests"| node_dashboards
node_ngo -->|"uploads verification"| node_file_storage

click node_spring_app "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Project3Application.java"
click node_auth "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/LoginController.java"
click node_food "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/FoodController.java"
click node_dashboards "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/DashboardController.java"
click node_admin "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/AdminController.java"
click node_admin_search "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/AdminSearchController.java"
click node_service_controller "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/ServiceController.java"
click node_allocation_engine "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/RuleEngineService.java"
click node_distance "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/DistanceService.java"
click node_email "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/EmailService.java"
click node_file_storage "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/FileStorageService.java"
click node_donation_data "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/DonationRepository.java"
click node_food_data "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/FoodRepository.java"
click node_ngo_data "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/NGORepository.java"
click node_allocation_data "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/AllocationRequestRepository.java"
click node_feedback_data "https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/FeedbackRepository.java"
click node_domain_models "https://github.com/adityanakhale/foodrescuai-springboot/tree/master/src/main/java/org/example/project3/Model"
click node_views "https://github.com/adityanakhale/foodrescuai-springboot/tree/master/src/main/resources/templates"

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_spring_app,node_auth,node_food,node_dashboards,node_admin,node_admin_search,node_service_controller,node_views toneAmber
class node_allocation_engine,node_distance,node_email,node_file_storage toneMint
class node_donation_data,node_food_data,node_ngo_data,node_allocation_data,node_feedback_data,node_domain_models toneRose
class node_donor,node_ngo toneIndigo
```

## Components

### Web application

- [Application entry](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Project3Application.java): `src/main/java/org/example/project3/Project3Application.java`
- [Login](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/LoginController.java): `src/main/java/org/example/project3/Controller/LoginController.java`
- [Donation management](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/FoodController.java): `src/main/java/org/example/project3/Controller/FoodController.java`
- [Dashboards](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/DashboardController.java): `src/main/java/org/example/project3/Controller/DashboardController.java`
- [Administration](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/AdminController.java): `src/main/java/org/example/project3/Controller/AdminController.java`
- [Admin search](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/AdminSearchController.java): `src/main/java/org/example/project3/Controller/AdminSearchController.java`
- [Service endpoints](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Controller/ServiceController.java): `src/main/java/org/example/project3/Controller/ServiceController.java`
- [Thymeleaf views](https://github.com/adityanakhale/foodrescuai-springboot/tree/master/src/main/resources/templates): `src/main/resources/templates`

### Rescue coordination

- [Allocation rules](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/RuleEngineService.java): `src/main/java/org/example/project3/service/RuleEngineService.java`
- [Distance calculation](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/DistanceService.java): `src/main/java/org/example/project3/service/DistanceService.java`
- [Email notifications](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/EmailService.java): `src/main/java/org/example/project3/service/EmailService.java`
- [File uploads](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/service/FileStorageService.java): `src/main/java/org/example/project3/service/FileStorageService.java`

### Domain and persistence

- [Donation records](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/DonationRepository.java): `src/main/java/org/example/project3/Repository/DonationRepository.java`
- [Food records](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/FoodRepository.java): `src/main/java/org/example/project3/Repository/FoodRepository.java`
- [NGO records](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/NGORepository.java): `src/main/java/org/example/project3/Repository/NGORepository.java`
- [Allocation requests](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/AllocationRequestRepository.java): `src/main/java/org/example/project3/Repository/AllocationRequestRepository.java`
- [Feedback records](https://github.com/adityanakhale/foodrescuai-springboot/blob/master/src/main/java/org/example/project3/Repository/FeedbackRepository.java): `src/main/java/org/example/project3/Repository/FeedbackRepository.java`
- [Domain models](https://github.com/adityanakhale/foodrescuai-springboot/tree/master/src/main/java/org/example/project3/Model): `src/main/java/org/example/project3/Model`

### Other components

- **Donor**
- **NGO**

## Connections

- Donor → Donation management: posts donations (evidence: `README.md`)
- NGO → Allocation rules: receives assignments (evidence: `README.md`)
- Donor → Login: signs in (evidence: `README.md`)
- NGO → Login: signs in (evidence: `README.md`)
- Allocation rules → Distance calculation: uses location
- Donation management → Allocation rules: requests allocation
- Donor → Dashboards: tracks donations (evidence: `README.md`)
- NGO → Dashboards: tracks requests (evidence: `README.md`)
- NGO → File uploads: uploads verification (evidence: `README.md`)
