How dr5t/food-aid works
Food Aid connects donors, NGOs, logistics partners, and administrators through a Flutter app backed by Firebase. The main workflow is donation listing, NGO acceptance, pickup and delivery, with status tracking; emergency SOS requests and administration are distinct supporting capabilities. The README documents these capabilities, but no Dart application source was excerpted, so implementation-level calls and data paths cannot be verified; edges below reflect documented product interactions only.
Main entry points: auth Authentication · ngo_dashboard.dart Browse donations · notifications_screen.dart Notifications · donor_dashboard.dart Donor dashboard
Components 21
Access and roles
- Authentication
lib/screens/auth - Donor dashboard
lib/screens/donor/donor_dashboard.dart - NGO dashboard
lib/screens/ngo/ngo_dashboard.dart - Logistics dashboards
lib/screens/logistics - Admin dashboard
lib/screens/admin/admin_dashboard.dart
Food distribution
- Create donation
lib/screens/donor/create_donation_screen.dart - Donation history
lib/screens/donor/donation_history_screen.dart - Donation tracking
lib/screens/donor/donation_tracking_screen.dart - Browse donations
lib/screens/ngo/ngo_dashboard.dart - Maps and location
lib/services/location_service.dart - Transport jobs
lib/screens/logistics - Delivery confirmation
lib/screens/logistics
Coordination and support
- Emergency SOS
lib/screens/donor/sos_requests_screen.dart - Notifications
lib/screens/notifications/notifications_screen.dart
App and services
- Auth service
lib/services/auth_service.dart - Firestore service
lib/services/firestore_service.dart - Cloud Firestore
Other components
- Donors
- NGOs
- Logistics partners
- Administrators
Connections 23
- Donors → Authentication: sign in
README.md - NGOs → Authentication: sign in
README.md - Logistics partners → Authentication: sign in
README.md - Administrators → Authentication: sign in
README.md - Donors → Donor dashboard: manage donations
README.md - NGOs → NGO dashboard: manage needs
README.md - Logistics partners → Logistics dashboards: manage transport
README.md - Administrators → Admin dashboard: oversee activity
README.md - Donor dashboard → Create donation: create listing
README.md - Donors → Donation history: view impact
README.md - Donors → Donation tracking: track status
README.md - NGO dashboard → Browse donations: browse listings
README.md - Browse donations → Maps and location: view nearby
README.md - NGOs → Browse donations: accept donations
README.md - Logistics dashboards → Transport jobs: manage jobs
README.md - Transport jobs → Delivery confirmation: confirm delivery
README.md - Logistics partners → Maps and location: share location
README.md - NGOs → Emergency SOS: request supplies
README.md - Emergency SOS → Notifications: broadcast SOS
README.md - Donors → Notifications: receive updates
README.md - Logistics partners → Notifications: receive updates
README.md - Authentication → Auth service: authenticate
README.md - Firestore service → Cloud Firestore: use database
README.md