How kalainidhias/foodbridge works
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: AuthController.java Authentication API · OrderService.java Order processing · DonationService.java Donation workflow · NotificationService.java Notifications
Components 29
Identity and Access
- Authentication API
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java - JWT utilities
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/JwtUtils.java - User details
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/security/UserDetailsImpl.java - Profile verification
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AdminController.java - Document uploads
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/FileUploadController.java
Listings and Orders
- Listing management
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/FoodListingService.java - Order endpoints
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/OrderController.java - Order processing
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java - Earnings
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Earning.java
Donations and Engagement
- Donation workflow
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java - Review workflow
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java - Notifications
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java
Domain Persistence
- Platform users
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/User.java - User roles
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/UserRole.java - User repository
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/UserRepository.java - Food listings
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/FoodListing.java - Listing repository
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/FoodListingRepository.java - Orders
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Order.java - Order repository
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/OrderRepository.java - Earning repository
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/EarningRepository.java - Donations
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Donation.java - Donation repository
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/DonationRepository.java - Reviews
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/model/Review.java - Review repository
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/ReviewRepository.java - Notification repository
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/repository/NotificationRepository.java
Other components
- Customer
- Homemaker
- NGO
- Administrator
Connections 28
- Authentication API → JWT utilities: creates tokens
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java - Authentication API → User details: builds identity
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java - Authentication API → User repository: reads and saves
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java - Authentication API → Platform users: creates accounts
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java - Authentication API → User roles: assigns roles
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/AuthController.java - Order endpoints → Order processing: delegates orders
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/controller/OrderController.java - Order processing → Order repository: reads and saves
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java - Order processing → Listing repository: checks stock
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java - Order processing → Earning repository: records earnings
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java - Order processing → Notifications: sends updates
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/OrderService.java - Listing management → Listing repository: reads and saves
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/FoodListingService.java - Donation workflow → Donation repository: reads and saves
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java - Donation workflow → Listing repository: checks listings
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java - Donation workflow → Notifications: sends updates
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/DonationService.java - Review workflow → Review repository: reads and saves
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java - Review workflow → Notifications: sends review alert
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/ReviewService.java - Notifications → Notification repository: stores notifications
foodbridge-backend/src/main/java/com/foodbridge/foodbridge_backend/service/NotificationService.java - Customer → Authentication API: signs in
README.md - Homemaker → Authentication API: signs in
README.md - NGO → Authentication API: signs in
README.md - Administrator → Profile verification: verifies profiles
README.md - Homemaker → Document uploads: submits documents
README.md - Homemaker → Listing management: manages meals
README.md - Customer → Listing management: browses meals
README.md - Customer → Order endpoints: places orders
README.md - NGO → Donation workflow: requests collection
README.md - Homemaker → Donation workflow: offers surplus
README.md - Customer → Review workflow: reviews orders
README.md