# kalainidhias/foodbridge architecture

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

- Interactive diagram: https://gitdiagram.com/kalainidhias/foodbridge
- Repository: https://github.com/kalainidhias/foodbridge

## Overview

FoodBridge is a backend REST API for a role-based marketplace connecting homemakers, customers, NGOs, and administrators. The documented workflow spans profile verification, meal listing, paid ordering and order tracking, or free-food donation and collection; earnings, reviews, and notifications support those flows. The graph includes core service, persistence, and JWT-authentication layers. Some controller and admin capabilities are documented but not sampled, so those links rely on the README; unsampled implementation details are not inferred.

Main entry points: [`foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java`](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java) (Authentication API), [`foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java`](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java) (Order processing), [`foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java`](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java) (Donation workflow), [`foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java`](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java) (Notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity and Access"]
  node_authapi["Authentication API"]
  node_jwt["JWT utilities<br/>[JwtUtils.java]"]
  node_userdetails["User details"]
  node_verify["Profile verification"]
  node_uploads["Document uploads"]
end

subgraph group_market["Listings and Orders"]
  node_listings["Listing management"]
  node_orderapi["Order endpoints"]
  node_orders["Order processing<br/>[OrderService.java]"]
  node_earnings["Earnings<br/>[Earning.java]"]
end

subgraph group_community["Donations and Engagement"]
  node_donations["Donation workflow"]
  node_reviews["Review workflow<br/>[ReviewService.java]"]
  node_notify["Notifications"]
end

subgraph group_persistence["Domain Persistence"]
  node_users["Platform users<br/>[User.java]"]
  node_roles["User roles<br/>[UserRole.java]"]
  node_userrepo[("User repository")]
  node_listingdata["Food listings<br/>[FoodListing.java]"]
  node_listingrepo[("Listing repository")]
  node_orderdata["Orders<br/>[Order.java]"]
  node_orderrepo[("Order repository")]
  node_earningrepo[("Earning repository")]
  node_donationdata["Donations<br/>[Donation.java]"]
  node_donationrepo[("Donation repository")]
  node_reviewdata["Reviews<br/>[Review.java]"]
  node_reviewrepo[("Review repository")]
  node_notifyrepo[("Notification repository")]
end

node_customer(("Customer"))
node_homemaker(("Homemaker"))
node_ngo(("NGO"))
node_admin(("Administrator"))

node_authapi -->|"creates tokens"| node_jwt
node_authapi -->|"builds identity"| node_userdetails
node_authapi -->|"reads and saves"| node_userrepo
node_authapi -->|"creates accounts"| node_users
node_authapi -->|"assigns roles"| node_roles
node_orderapi -->|"delegates orders"| node_orders
node_orders -->|"reads and saves"| node_orderrepo
node_orders -->|"checks stock"| node_listingrepo
node_orders -->|"records earnings"| node_earningrepo
node_orders -->|"sends updates"| node_notify
node_listings -->|"reads and saves"| node_listingrepo
node_donations -->|"reads and saves"| node_donationrepo
node_donations -->|"checks listings"| node_listingrepo
node_donations -->|"sends updates"| node_notify
node_reviews -->|"reads and saves"| node_reviewrepo
node_reviews -->|"sends review alert"| node_notify
node_notify -->|"stores notifications"| node_notifyrepo
node_customer -.->|"signs in"| node_authapi
node_homemaker -.->|"signs in"| node_authapi
node_ngo -.->|"signs in"| node_authapi
node_admin -.->|"verifies profiles"| node_verify
node_homemaker -.->|"submits documents"| node_uploads
node_homemaker -.->|"manages meals"| node_listings
node_customer -.->|"browses meals"| node_listings
node_customer -.->|"places orders"| node_orderapi
node_ngo -.->|"requests collection"| node_donations
node_homemaker -.->|"offers surplus"| node_donations
node_customer -.->|"reviews orders"| node_reviews

click node_users "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/User.java"
click node_roles "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/UserRole.java"
click node_authapi "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java"
click node_jwt "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/JwtUtils.java"
click node_userdetails "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/UserDetailsImpl.java"
click node_userrepo "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/UserRepository.java"
click node_verify "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AdminController.java"
click node_uploads "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/FileUploadController.java"
click node_listings "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/FoodListingService.java"
click node_listingdata "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/FoodListing.java"
click node_listingrepo "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/FoodListingRepository.java"
click node_orderapi "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/OrderController.java"
click node_orders "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java"
click node_orderdata "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Order.java"
click node_orderrepo "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/OrderRepository.java"
click node_earnings "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Earning.java"
click node_earningrepo "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/EarningRepository.java"
click node_donations "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java"
click node_donationdata "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Donation.java"
click node_donationrepo "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/DonationRepository.java"
click node_reviews "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java"
click node_reviewdata "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Review.java"
click node_reviewrepo "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/ReviewRepository.java"
click node_notify "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java"
click node_notifyrepo "https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/NotificationRepository.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_authapi,node_jwt,node_userdetails,node_verify,node_uploads toneBlue
class node_listings,node_orderapi,node_orders,node_earnings toneAmber
class node_donations,node_reviews,node_notify toneMint
class node_users,node_roles,node_userrepo,node_listingdata,node_listingrepo,node_orderdata,node_orderrepo,node_earningrepo,node_donationdata,node_donationrepo,node_reviewdata,node_reviewrepo,node_notifyrepo toneRose
class node_customer,node_homemaker,node_ngo,node_admin toneIndigo
```

## Components

### Identity and Access

- [Authentication API](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java`
- [JWT utilities](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/JwtUtils.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/JwtUtils.java`
- [User details](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/UserDetailsImpl.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/UserDetailsImpl.java`
- [Profile verification](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AdminController.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AdminController.java`
- [Document uploads](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/FileUploadController.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/FileUploadController.java`

### Listings and Orders

- [Listing management](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/FoodListingService.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/FoodListingService.java`
- [Order endpoints](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/OrderController.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/OrderController.java`
- [Order processing](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java`
- [Earnings](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Earning.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Earning.java`

### Donations and Engagement

- [Donation workflow](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java`
- [Review workflow](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java`
- [Notifications](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java`

### Domain Persistence

- [Platform users](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/User.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/User.java`
- [User roles](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/UserRole.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/UserRole.java`
- [User repository](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/UserRepository.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/UserRepository.java`
- [Food listings](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/FoodListing.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/FoodListing.java`
- [Listing repository](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/FoodListingRepository.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/FoodListingRepository.java`
- [Orders](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Order.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Order.java`
- [Order repository](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/OrderRepository.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/OrderRepository.java`
- [Earning repository](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/EarningRepository.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/EarningRepository.java`
- [Donations](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Donation.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Donation.java`
- [Donation repository](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/DonationRepository.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/DonationRepository.java`
- [Reviews](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Review.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Review.java`
- [Review repository](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/ReviewRepository.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/ReviewRepository.java`
- [Notification repository](https://github.com/kalainidhias/foodbridge/blob/MAIN/foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/NotificationRepository.java): `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/NotificationRepository.java`

### Other components

- **Customer**
- **Homemaker**
- **NGO**
- **Administrator**

## Connections

- Authentication API → JWT utilities: creates tokens (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java`)
- Authentication API → User details: builds identity (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java`)
- Authentication API → User repository: reads and saves (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java`)
- Authentication API → Platform users: creates accounts (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java`)
- Authentication API → User roles: assigns roles (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java`)
- Order endpoints → Order processing: delegates orders (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/OrderController.java`)
- Order processing → Order repository: reads and saves (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java`)
- Order processing → Listing repository: checks stock (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java`)
- Order processing → Earning repository: records earnings (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java`)
- Order processing → Notifications: sends updates (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java`)
- Listing management → Listing repository: reads and saves (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/FoodListingService.java`)
- Donation workflow → Donation repository: reads and saves (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java`)
- Donation workflow → Listing repository: checks listings (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java`)
- Donation workflow → Notifications: sends updates (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java`)
- Review workflow → Review repository: reads and saves (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java`)
- Review workflow → Notifications: sends review alert (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java`)
- Notifications → Notification repository: stores notifications (evidence: `foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java`)
- Customer → Authentication API: signs in (evidence: `README.md`)
- Homemaker → Authentication API: signs in (evidence: `README.md`)
- NGO → Authentication API: signs in (evidence: `README.md`)
- Administrator → Profile verification: verifies profiles (evidence: `README.md`)
- Homemaker → Document uploads: submits documents (evidence: `README.md`)
- Homemaker → Listing management: manages meals (evidence: `README.md`)
- Customer → Listing management: browses meals (evidence: `README.md`)
- Customer → Order endpoints: places orders (evidence: `README.md`)
- NGO → Donation workflow: requests collection (evidence: `README.md`)
- Homemaker → Donation workflow: offers surplus (evidence: `README.md`)
- Customer → Review workflow: reviews orders (evidence: `README.md`)
