How amankrjaiswal1504-boop/safakabad works
SafaKabad is a Nepal-focused doorstep scrap collection and recycling platform. Customers check prices, book a sale or donation pickup, track collection and receive payment; collectors handle assigned jobs and admins manage dispatch, pricing and operations. The map highlights the booking and pickup lifecycle alongside customer growth, support and operational capabilities documented in the README. Source excerpts establish key backend calls; several frontend and admin feature links are documented rather than verified in sampled page code.
Main entry points: bookingService.js Booking engine · app.js HTTP API · Pickup.js Pickup records · pickupController.js Pickup workflows
Components 28
Customer experience
- Customer website
frontend/src/App.jsx - Booking wizard
frontend/src/pages/SchedulePickup.jsx - Pickup tracking
frontend/src/pages/PickupTracking.jsx - Customer account
frontend/src/pages/account
Collection operations
- Collector app
frontend/src/pages/collector - Admin console
frontend/src/pages/admin
Backend services
- HTTP API
backend/src/app.js - Pickup routes
backend/src/routes/pickupRoutes.js - Pickup workflows
backend/src/controllers/pickupController.js - Collector workflows
backend/src/controllers/collectorController.js - Admin routes
backend/src/routes/adminRoutes.js - Admin operations
backend/src/controllers/adminController.js - Booking engine
backend/src/services/bookingService.js - Collector assignment
backend/src/services/assignmentService.js - Pickup lifecycle
backend/src/services/pickupService.js - Notifications
backend/src/services/notificationService.js - Chat support
backend/src/controllers/chatController.js - Rates and pricing
backend/src/services/rateService.js - Slots and service areas
backend/src/services/slotService.js - Growth features
backend/src/controllers/growthController.js - Payments and payouts
backend/src/services/paymentGateway.js
Platform data
- Pickup records
backend/src/models/Pickup.js - User records
backend/src/models/User.js - Platform records
backend/src/models/platform.js
Other components
- Customer
- Collector
- Admin staff
- MongoDB
Connections 33
- Customer → Customer website: uses
- Customer website → Booking wizard: offers booking
frontend/src/App.jsx - Booking wizard → HTTP API: submits booking
- HTTP API → Pickup routes: routes requests
backend/src/app.js - Pickup routes → Pickup workflows: dispatches
backend/src/routes/pickupRoutes.js - Pickup workflows → Booking engine: creates bookings
backend/src/controllers/pickupController.js - Booking engine → Rates and pricing: estimates items
backend/src/services/bookingService.js - Booking engine → Slots and service areas: checks availability
backend/src/services/bookingService.js - Booking engine → Collector assignment: auto-assigns
backend/src/services/bookingService.js - Booking engine → Notifications: notifies customer
backend/src/services/bookingService.js - Booking engine → Pickup records: creates pickup
backend/src/services/bookingService.js - Booking engine → User records: loads customer
backend/src/services/bookingService.js - Booking engine → Payments and payouts: pays out
backend/src/services/bookingService.js - Pickup workflows → Pickup lifecycle: manages status
backend/src/controllers/pickupController.js - Collector → Collector app: handles jobs
- Collector app → HTTP API: updates job
- Collector workflows → Pickup records: updates pickup
backend/src/controllers/collectorController.js - Collector workflows → Notifications: sends updates
backend/src/controllers/collectorController.js - Admin staff → Admin console: manages operations
- Admin console → HTTP API: requests operations
- HTTP API → Admin routes: routes requests
backend/src/app.js - Admin routes → Admin operations: dispatches
backend/src/routes/adminRoutes.js - Admin operations → Pickup records: manages pickups
backend/src/controllers/adminController.js - Admin operations → Collector assignment: ranks collectors
backend/src/controllers/adminController.js - Pickup records → MongoDB: persists in
- User records → MongoDB: persists in
- Platform records → MongoDB: persists in
- Customer → Pickup tracking: tracks pickup
- Customer → Customer account: manages account
- Customer → Chat support: gets support
- Chat support → Booking engine: books pickup
backend/src/controllers/chatController.js - Customer → Growth features: uses growth features
- Notifications → Platform records: stores notification
backend/src/services/notificationService.js