# itzrandom23/kabadiwala-connect architecture

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

- Interactive diagram: https://gitdiagram.com/itzrandom23/kabadiwala-connect
- Repository: https://github.com/itzrandom23/kabadiwala-connect

## Overview

Kabadiwala Connect is an Android marketplace linking households, collectors (kabadiwalas), recyclers and administrators. The primary journey runs from a household’s photo-backed scrap listing through collector pickup, QR verification, weighing and payment, then into inventory and bulk lots; recyclers offer on lots, and accepted trades proceed to handover and settlement. Android screens use local cache/outbox and an authenticated API; the Express backend enforces account, ownership and transaction rules. Offline replay and push notifications are supporting capabilities. Backend relationships use visible wiring or README documentation; unsampled feature details are represented at subsystem level.

Main entry points: [`backend/src/app.ts`](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/app.ts) (HTTP routes), [`android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/navigation/AppNavHost.kt`](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/navigation/AppNavHost.kt) (Navigation), [`android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt`](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt) (App entry), [`android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/sync/Sync.kt`](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/sync/Sync.kt) (Offline sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android app"]
  node_android_entry["App entry<br/>[MainActivity.kt]"]
  node_navigation["Navigation<br/>[AppNavHost.kt]"]
  node_onboarding["Onboarding"]
  node_household_listing["Household listings"]
  node_collector_pickup["Pickup workflow<br/>[HandoverScreens.kt]"]
  node_lots_offers["Lots and offers"]
  node_recycler_market["Recycler marketplace<br/>[RecyclerScreens.kt]"]
  node_admin_tools["Admin tools"]
  node_android_auth["Android auth"]
  node_locale["Language settings<br/>[LocaleManager.kt]"]
  node_sync_worker["Offline sync<br/>[Sync.kt]"]
  node_api["Android API client<br/>[ApiService.kt]"]
end

subgraph group_backend["Backend API"]
  node_api_app["HTTP routes<br/>[app.ts]"]
  node_auth_routes["Authentication routes<br/>[authController.ts]"]
  node_auth_service["Auth and sessions<br/>[authService.ts]"]
  node_jwt["Token service<br/>[jwt.ts]"]
  node_auth_guard["Access control<br/>[auth.ts]"]
  node_pickup_routes["Pickup and supply routes"]
  node_trade_routes["Trade formalisation"]
  node_handover_service["Handover rules<br/>[handoverService.ts]"]
  node_recycler_service["Recycler accounts<br/>[recyclerService.ts]"]
  node_lot_service["Lot management<br/>[lotService.ts]"]
  node_sync_service["Sync processing<br/>[syncService.ts]"]
  node_notification_service["Notifications"]
end

subgraph group_platform["Persistence and services"]
  node_local_store[("Room and outbox<br/>[AppDatabase.kt]")]
  node_collector_repo["Collector records"]
  node_storage["Photo storage<br/>[storage.ts]"]
  node_database[("MongoDB<br/>[prisma.ts]")]
end

node_household(("Household"))
node_collector(("Collector"))
node_recycler(("Recycler"))
node_admin(("Admin"))
node_push["Push delivery"]

node_household -->|"uses app"| node_android_entry
node_collector -->|"uses app"| node_android_entry
node_recycler -->|"uses app"| node_android_entry
node_admin -->|"uses app"| node_android_entry
node_android_entry -->|"opens navigation"| node_navigation
node_navigation -->|"routes to"| node_onboarding
node_navigation -->|"routes to"| node_household_listing
node_navigation -->|"routes to"| node_collector_pickup
node_navigation -->|"routes to"| node_lots_offers
node_navigation -->|"routes to"| node_recycler_market
node_navigation -->|"routes to"| node_admin_tools
node_onboarding -->|"authenticates with"| node_android_auth
node_android_entry -->|"loads language"| node_locale
node_household_listing -->|"caches drafts"| node_local_store
node_local_store -->|"queues replay"| node_sync_worker
node_sync_worker -->|"sends queued work"| node_api
node_android_auth -->|"calls endpoints"| node_api
node_api -->|"calls API"| node_api_app
node_api_app -->|"mounts routes"| node_auth_routes
node_api_app -->|"mounts routes"| node_pickup_routes
node_api_app -->|"mounts routes"| node_trade_routes
node_auth_routes -->|"invokes"| node_auth_service
node_auth_service -->|"reads and updates"| node_collector_repo
node_auth_service -->|"issues tokens"| node_jwt
node_auth_guard -->|"verifies tokens"| node_jwt
node_pickup_routes -->|"stores photos"| node_storage
node_trade_routes -.->|"supports handover"| node_handover_service
node_pickup_routes -->|"emits updates"| node_notification_service
node_api_app -->|"mounts lots"| node_lot_service
node_sync_worker -->|"synchronizes with"| node_sync_service
node_api_app -->|"mounts sync"| node_sync_service
node_api_app -.->|"mounts features"| node_recycler_service
node_api_app -->|"serves requests"| node_database
node_storage -.->|"optional integration"| node_push
node_notification_service -.->|"queues delivery"| node_push

click node_android_entry "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt"
click node_navigation "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/navigation/AppNavHost.kt"
click node_onboarding "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/auth/OnboardingScreen.kt"
click node_household_listing "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/household/HouseholdScreens.kt"
click node_collector_pickup "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/handovers/HandoverScreens.kt"
click node_lots_offers "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/supplychain/SupplyChainScreens.kt"
click node_recycler_market "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/recycler/RecyclerScreens.kt"
click node_admin_tools "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/admin/AdminConsoleScreen.kt"
click node_android_auth "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/auth/RemoteAuthenticationRepository.kt"
click node_locale "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/util/LocaleManager.kt"
click node_local_store "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/local/AppDatabase.kt"
click node_sync_worker "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/sync/Sync.kt"
click node_api "https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/remote/ApiService.kt"
click node_api_app "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/controllers/authController.ts"
click node_auth_service "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/authService.ts"
click node_jwt "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/jwt.ts"
click node_auth_guard "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/middleware/auth.ts"
click node_pickup_routes "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/routes/supplyChainRoutes.ts"
click node_trade_routes "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/routes/formalisationRoutes.ts"
click node_handover_service "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/handoverService.ts"
click node_recycler_service "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/recyclerService.ts"
click node_lot_service "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/lotService.ts"
click node_sync_service "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/syncService.ts"
click node_notification_service "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/notificationService.ts"
click node_collector_repo "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/repositories/collectorRepository.ts"
click node_storage "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/storage.ts"
click node_database "https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/config/prisma.ts"

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_android_entry,node_navigation,node_onboarding,node_household_listing,node_collector_pickup,node_lots_offers,node_recycler_market,node_admin_tools,node_android_auth,node_locale,node_sync_worker,node_api toneBlue
class node_api_app,node_auth_routes,node_auth_service,node_jwt,node_auth_guard,node_pickup_routes,node_trade_routes,node_handover_service,node_recycler_service,node_lot_service,node_sync_service,node_notification_service toneAmber
class node_local_store,node_collector_repo,node_storage,node_database toneMint
class node_household,node_collector,node_recycler,node_admin,node_push toneIndigo
```

## Components

### Android app

- [App entry](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt`
- [Navigation](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/navigation/AppNavHost.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/navigation/AppNavHost.kt`
- [Onboarding](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/auth/OnboardingScreen.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/auth/OnboardingScreen.kt`
- [Household listings](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/household/HouseholdScreens.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/household/HouseholdScreens.kt`
- [Pickup workflow](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/handovers/HandoverScreens.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/handovers/HandoverScreens.kt`
- [Lots and offers](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/supplychain/SupplyChainScreens.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/supplychain/SupplyChainScreens.kt`
- [Recycler marketplace](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/recycler/RecyclerScreens.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/recycler/RecyclerScreens.kt`
- [Admin tools](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/admin/AdminConsoleScreen.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/admin/AdminConsoleScreen.kt`
- [Android auth](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/auth/RemoteAuthenticationRepository.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/auth/RemoteAuthenticationRepository.kt`
- [Language settings](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/util/LocaleManager.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/util/LocaleManager.kt`
- [Offline sync](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/sync/Sync.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/sync/Sync.kt`
- [Android API client](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/remote/ApiService.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/remote/ApiService.kt`

### Backend API

- [HTTP routes](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Authentication routes](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/controllers/authController.ts): `backend/src/controllers/authController.ts`
- [Auth and sessions](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/authService.ts): `backend/src/services/authService.ts`
- [Token service](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/jwt.ts): `backend/src/services/jwt.ts`
- [Access control](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Pickup and supply routes](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/routes/supplyChainRoutes.ts): `backend/src/routes/supplyChainRoutes.ts`
- [Trade formalisation](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/routes/formalisationRoutes.ts): `backend/src/routes/formalisationRoutes.ts`
- [Handover rules](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/handoverService.ts): `backend/src/services/handoverService.ts`
- [Recycler accounts](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/recyclerService.ts): `backend/src/services/recyclerService.ts`
- [Lot management](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/lotService.ts): `backend/src/services/lotService.ts`
- [Sync processing](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/syncService.ts): `backend/src/services/syncService.ts`
- [Notifications](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/notificationService.ts): `backend/src/services/notificationService.ts`

### Persistence and services

- [Room and outbox](https://github.com/itzrandom23/kabadiwala-connect/blob/main/android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/local/AppDatabase.kt): `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/local/AppDatabase.kt`
- [Collector records](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/repositories/collectorRepository.ts): `backend/src/repositories/collectorRepository.ts`
- [Photo storage](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/services/storage.ts): `backend/src/services/storage.ts`
- [MongoDB](https://github.com/itzrandom23/kabadiwala-connect/blob/main/backend/src/config/prisma.ts): `backend/src/config/prisma.ts`

### Other components

- **Household**
- **Collector**
- **Recycler**
- **Admin**
- **Push delivery**

## Connections

- Household → App entry: uses app (evidence: `README.md`)
- Collector → App entry: uses app (evidence: `README.md`)
- Recycler → App entry: uses app (evidence: `README.md`)
- Admin → App entry: uses app (evidence: `README.md`)
- App entry → Navigation: opens navigation (evidence: `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt`)
- Navigation → Onboarding: routes to
- Navigation → Household listings: routes to (evidence: `README.md`)
- Navigation → Pickup workflow: routes to (evidence: `README.md`)
- Navigation → Lots and offers: routes to (evidence: `README.md`)
- Navigation → Recycler marketplace: routes to (evidence: `README.md`)
- Navigation → Admin tools: routes to (evidence: `README.md`)
- Onboarding → Android auth: authenticates with (evidence: `README.md`)
- App entry → Language settings: loads language (evidence: `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt`)
- Household listings → Room and outbox: caches drafts (evidence: `README.md`)
- Room and outbox → Offline sync: queues replay (evidence: `README.md`)
- Offline sync → Android API client: sends queued work (evidence: `README.md`)
- Android auth → Android API client: calls endpoints (evidence: `android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/auth/RemoteAuthenticationRepository.kt`)
- Android API client → HTTP routes: calls API (evidence: `README.md`)
- HTTP routes → Authentication routes: mounts routes (evidence: `backend/src/app.ts`)
- HTTP routes → Pickup and supply routes: mounts routes (evidence: `backend/src/app.ts`)
- HTTP routes → Trade formalisation: mounts routes (evidence: `backend/src/app.ts`)
- Authentication routes → Auth and sessions: invokes (evidence: `backend/src/controllers/authController.ts`)
- Auth and sessions → Collector records: reads and updates (evidence: `backend/src/services/authService.ts`)
- Auth and sessions → Token service: issues tokens (evidence: `backend/src/services/authService.ts`)
- Access control → Token service: verifies tokens (evidence: `backend/src/middleware/auth.ts`)
- Pickup and supply routes → Photo storage: stores photos (evidence: `backend/src/routes/supplyChainRoutes.ts`)
- Trade formalisation → Handover rules: supports handover
- Pickup and supply routes → Notifications: emits updates (evidence: `backend/src/routes/supplyChainRoutes.ts`)
- HTTP routes → Lot management: mounts lots (evidence: `backend/src/app.ts`)
- Offline sync → Sync processing: synchronizes with (evidence: `README.md`)
- HTTP routes → Sync processing: mounts sync (evidence: `backend/src/app.ts`)
- HTTP routes → Recycler accounts: mounts features (evidence: `backend/src/app.ts`)
- HTTP routes → MongoDB: serves requests (evidence: `README.md`)
- Photo storage → Push delivery: optional integration
- Notifications → Push delivery: queues delivery
