# amankrjaiswal1504-boop/safakabad architecture

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

- Interactive diagram: https://gitdiagram.com/amankrjaiswal1504-boop/safakabad
- Repository: https://github.com/amankrjaiswal1504-boop/safakabad

## Overview

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: [`backend/src/services/bookingService.js`](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/bookingService.js) (Booking engine), [`backend/src/app.js`](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/app.js) (HTTP API), [`backend/src/models/Pickup.js`](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/models/Pickup.js) (Pickup records), [`backend/src/controllers/pickupController.js`](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/pickupController.js) (Pickup workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Customer experience"]
  node_web["Customer website<br/>[App.jsx]"]
  node_booking_ui["Booking wizard<br/>[SchedulePickup.jsx]"]
  node_tracking_ui["Pickup tracking<br/>[PickupTracking.jsx]"]
  node_account_ui["Customer account"]
end

subgraph group_operations["Collection operations"]
  node_collector_ui["Collector app"]
  node_admin_ui["Admin console"]
end

subgraph group_backend["Backend services"]
  node_api["HTTP API<br/>[app.js]"]
  node_pickup_routes["Pickup routes<br/>[pickupRoutes.js]"]
  node_pickup_controller["Pickup workflows"]
  node_collector_controller["Collector workflows"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_admin_controller["Admin operations<br/>[adminController.js]"]
  node_booking["Booking engine<br/>[bookingService.js]"]
  node_assignment["Collector assignment"]
  node_pickup_lifecycle["Pickup lifecycle<br/>[pickupService.js]"]
  node_notifications["Notifications"]
  node_chat["Chat support<br/>[chatController.js]"]
  node_rates["Rates and pricing<br/>[rateService.js]"]
  node_scheduling["Slots and service areas<br/>[slotService.js]"]
  node_growth["Growth features"]
  node_payment["Payments and payouts<br/>[paymentGateway.js]"]
end

subgraph group_data["Platform data"]
  node_pickup_record[("Pickup records<br/>[Pickup.js]")]
  node_user_record[("User records<br/>[User.js]")]
  node_platform_records[("Platform records<br/>[platform.js]")]
end

node_customer(("Customer"))
node_collector(("Collector"))
node_admin(("Admin staff"))
node_mongo[("MongoDB")]

node_customer -->|"uses"| node_web
node_web -->|"offers booking"| node_booking_ui
node_booking_ui -.->|"submits booking"| node_api
node_api -->|"routes requests"| node_pickup_routes
node_pickup_routes -->|"dispatches"| node_pickup_controller
node_pickup_controller -->|"creates bookings"| node_booking
node_booking -->|"estimates items"| node_rates
node_booking -->|"checks availability"| node_scheduling
node_booking -->|"auto-assigns"| node_assignment
node_booking -->|"notifies customer"| node_notifications
node_booking -->|"creates pickup"| node_pickup_record
node_booking -->|"loads customer"| node_user_record
node_booking -->|"pays out"| node_payment
node_pickup_controller -->|"manages status"| node_pickup_lifecycle
node_collector -->|"handles jobs"| node_collector_ui
node_collector_ui -.->|"updates job"| node_api
node_collector_controller -->|"updates pickup"| node_pickup_record
node_collector_controller -->|"sends updates"| node_notifications
node_admin -->|"manages operations"| node_admin_ui
node_admin_ui -.->|"requests operations"| node_api
node_api -->|"routes requests"| node_admin_routes
node_admin_routes -->|"dispatches"| node_admin_controller
node_admin_controller -->|"manages pickups"| node_pickup_record
node_admin_controller -->|"ranks collectors"| node_assignment
node_pickup_record -.->|"persists in"| node_mongo
node_user_record -.->|"persists in"| node_mongo
node_platform_records -.->|"persists in"| node_mongo
node_customer -->|"tracks pickup"| node_tracking_ui
node_customer -->|"manages account"| node_account_ui
node_customer -->|"gets support"| node_chat
node_chat -->|"books pickup"| node_booking
node_customer -->|"uses growth features"| node_growth
node_notifications -->|"stores notification"| node_platform_records

click node_web "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/frontend/src/App.jsx"
click node_booking_ui "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/frontend/src/pages/SchedulePickup.jsx"
click node_tracking_ui "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/frontend/src/pages/PickupTracking.jsx"
click node_account_ui "https://github.com/amankrjaiswal1504-boop/safakabad/tree/main/frontend/src/pages/account"
click node_collector_ui "https://github.com/amankrjaiswal1504-boop/safakabad/tree/main/frontend/src/pages/collector"
click node_admin_ui "https://github.com/amankrjaiswal1504-boop/safakabad/tree/main/frontend/src/pages/admin"
click node_api "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/app.js"
click node_pickup_routes "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/routes/pickupRoutes.js"
click node_pickup_controller "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/pickupController.js"
click node_collector_controller "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/collectorController.js"
click node_admin_routes "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/routes/adminRoutes.js"
click node_admin_controller "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/adminController.js"
click node_booking "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/bookingService.js"
click node_assignment "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/assignmentService.js"
click node_pickup_lifecycle "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/pickupService.js"
click node_notifications "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/notificationService.js"
click node_chat "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/chatController.js"
click node_rates "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/rateService.js"
click node_scheduling "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/slotService.js"
click node_growth "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/growthController.js"
click node_payment "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/paymentGateway.js"
click node_pickup_record "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/models/Pickup.js"
click node_user_record "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/models/User.js"
click node_platform_records "https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/models/platform.js"

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_web,node_booking_ui,node_tracking_ui,node_account_ui toneBlue
class node_collector_ui,node_admin_ui,node_mongo toneAmber
class node_api,node_pickup_routes,node_pickup_controller,node_collector_controller,node_admin_routes,node_admin_controller,node_booking,node_assignment,node_pickup_lifecycle,node_notifications,node_chat,node_rates,node_scheduling,node_growth,node_payment toneMint
class node_pickup_record,node_user_record,node_platform_records toneRose
class node_customer,node_collector,node_admin toneIndigo
```

## Components

### Customer experience

- [Customer website](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Booking wizard](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/frontend/src/pages/SchedulePickup.jsx): `frontend/src/pages/SchedulePickup.jsx`
- [Pickup tracking](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/frontend/src/pages/PickupTracking.jsx): `frontend/src/pages/PickupTracking.jsx`
- [Customer account](https://github.com/amankrjaiswal1504-boop/safakabad/tree/main/frontend/src/pages/account): `frontend/src/pages/account`

### Collection operations

- [Collector app](https://github.com/amankrjaiswal1504-boop/safakabad/tree/main/frontend/src/pages/collector): `frontend/src/pages/collector`
- [Admin console](https://github.com/amankrjaiswal1504-boop/safakabad/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`

### Backend services

- [HTTP API](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/app.js): `backend/src/app.js`
- [Pickup routes](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/routes/pickupRoutes.js): `backend/src/routes/pickupRoutes.js`
- [Pickup workflows](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/pickupController.js): `backend/src/controllers/pickupController.js`
- [Collector workflows](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/collectorController.js): `backend/src/controllers/collectorController.js`
- [Admin routes](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/routes/adminRoutes.js): `backend/src/routes/adminRoutes.js`
- [Admin operations](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Booking engine](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/bookingService.js): `backend/src/services/bookingService.js`
- [Collector assignment](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/assignmentService.js): `backend/src/services/assignmentService.js`
- [Pickup lifecycle](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/pickupService.js): `backend/src/services/pickupService.js`
- [Notifications](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/notificationService.js): `backend/src/services/notificationService.js`
- [Chat support](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/chatController.js): `backend/src/controllers/chatController.js`
- [Rates and pricing](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/rateService.js): `backend/src/services/rateService.js`
- [Slots and service areas](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/slotService.js): `backend/src/services/slotService.js`
- [Growth features](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/controllers/growthController.js): `backend/src/controllers/growthController.js`
- [Payments and payouts](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/services/paymentGateway.js): `backend/src/services/paymentGateway.js`

### Platform data

- [Pickup records](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/models/Pickup.js): `backend/src/models/Pickup.js`
- [User records](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/models/User.js): `backend/src/models/User.js`
- [Platform records](https://github.com/amankrjaiswal1504-boop/safakabad/blob/main/backend/src/models/platform.js): `backend/src/models/platform.js`

### Other components

- **Customer**
- **Collector**
- **Admin staff**
- **MongoDB**

## Connections

- Customer → Customer website: uses
- Customer website → Booking wizard: offers booking (evidence: `frontend/src/App.jsx`)
- Booking wizard → HTTP API: submits booking
- HTTP API → Pickup routes: routes requests (evidence: `backend/src/app.js`)
- Pickup routes → Pickup workflows: dispatches (evidence: `backend/src/routes/pickupRoutes.js`)
- Pickup workflows → Booking engine: creates bookings (evidence: `backend/src/controllers/pickupController.js`)
- Booking engine → Rates and pricing: estimates items (evidence: `backend/src/services/bookingService.js`)
- Booking engine → Slots and service areas: checks availability (evidence: `backend/src/services/bookingService.js`)
- Booking engine → Collector assignment: auto-assigns (evidence: `backend/src/services/bookingService.js`)
- Booking engine → Notifications: notifies customer (evidence: `backend/src/services/bookingService.js`)
- Booking engine → Pickup records: creates pickup (evidence: `backend/src/services/bookingService.js`)
- Booking engine → User records: loads customer (evidence: `backend/src/services/bookingService.js`)
- Booking engine → Payments and payouts: pays out (evidence: `backend/src/services/bookingService.js`)
- Pickup workflows → Pickup lifecycle: manages status (evidence: `backend/src/controllers/pickupController.js`)
- Collector → Collector app: handles jobs
- Collector app → HTTP API: updates job
- Collector workflows → Pickup records: updates pickup (evidence: `backend/src/controllers/collectorController.js`)
- Collector workflows → Notifications: sends updates (evidence: `backend/src/controllers/collectorController.js`)
- Admin staff → Admin console: manages operations
- Admin console → HTTP API: requests operations
- HTTP API → Admin routes: routes requests (evidence: `backend/src/app.js`)
- Admin routes → Admin operations: dispatches (evidence: `backend/src/routes/adminRoutes.js`)
- Admin operations → Pickup records: manages pickups (evidence: `backend/src/controllers/adminController.js`)
- Admin operations → Collector assignment: ranks collectors (evidence: `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 (evidence: `backend/src/controllers/chatController.js`)
- Customer → Growth features: uses growth features
- Notifications → Platform records: stores notification (evidence: `backend/src/services/notificationService.js`)
