How itzrandom23/kabadiwala-connect works
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: app.ts HTTP routes · AppNavHost.kt Navigation · MainActivity.kt App entry · Sync.kt Offline sync
Components 33
Android app
- App entry
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt - Navigation
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/navigation/AppNavHost.kt - Onboarding
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/auth/OnboardingScreen.kt - Household listings
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/household/HouseholdScreens.kt - Pickup workflow
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/handovers/HandoverScreens.kt - Lots and offers
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/supplychain/SupplyChainScreens.kt - Recycler marketplace
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/recycler/RecyclerScreens.kt - Admin tools
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/ui/screens/admin/AdminConsoleScreen.kt - Android auth
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/auth/RemoteAuthenticationRepository.kt - Language settings
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/util/LocaleManager.kt - Offline sync
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/sync/Sync.kt - Android API client
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/remote/ApiService.kt
Backend API
- HTTP routes
backend/src/app.ts - Authentication routes
backend/src/controllers/authController.ts - Auth and sessions
backend/src/services/authService.ts - Token service
backend/src/services/jwt.ts - Access control
backend/src/middleware/auth.ts - Pickup and supply routes
backend/src/routes/supplyChainRoutes.ts - Trade formalisation
backend/src/routes/formalisationRoutes.ts - Handover rules
backend/src/services/handoverService.ts - Recycler accounts
backend/src/services/recyclerService.ts - Lot management
backend/src/services/lotService.ts - Sync processing
backend/src/services/syncService.ts - Notifications
backend/src/services/notificationService.ts
Persistence and services
- Room and outbox
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/local/AppDatabase.kt - Collector records
backend/src/repositories/collectorRepository.ts - Photo storage
backend/src/services/storage.ts - MongoDB
backend/src/config/prisma.ts
Other components
- Household
- Collector
- Recycler
- Admin
- Push delivery
Connections 35
- Household → App entry: uses app
README.md - Collector → App entry: uses app
README.md - Recycler → App entry: uses app
README.md - Admin → App entry: uses app
README.md - App entry → Navigation: opens navigation
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt - Navigation → Onboarding: routes to
- Navigation → Household listings: routes to
README.md - Navigation → Pickup workflow: routes to
README.md - Navigation → Lots and offers: routes to
README.md - Navigation → Recycler marketplace: routes to
README.md - Navigation → Admin tools: routes to
README.md - Onboarding → Android auth: authenticates with
README.md - App entry → Language settings: loads language
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/MainActivity.kt - Household listings → Room and outbox: caches drafts
README.md - Room and outbox → Offline sync: queues replay
README.md - Offline sync → Android API client: sends queued work
README.md - Android auth → Android API client: calls endpoints
android_app/app/src/main/java/com/irinteractivestudios/kabadiwalaconnect/data/auth/RemoteAuthenticationRepository.kt - Android API client → HTTP routes: calls API
README.md - HTTP routes → Authentication routes: mounts routes
backend/src/app.ts - HTTP routes → Pickup and supply routes: mounts routes
backend/src/app.ts - HTTP routes → Trade formalisation: mounts routes
backend/src/app.ts - Authentication routes → Auth and sessions: invokes
backend/src/controllers/authController.ts - Auth and sessions → Collector records: reads and updates
backend/src/services/authService.ts - Auth and sessions → Token service: issues tokens
backend/src/services/authService.ts - Access control → Token service: verifies tokens
backend/src/middleware/auth.ts - Pickup and supply routes → Photo storage: stores photos
backend/src/routes/supplyChainRoutes.ts - Trade formalisation → Handover rules: supports handover
- Pickup and supply routes → Notifications: emits updates
backend/src/routes/supplyChainRoutes.ts - HTTP routes → Lot management: mounts lots
backend/src/app.ts - Offline sync → Sync processing: synchronizes with
README.md - HTTP routes → Sync processing: mounts sync
backend/src/app.ts - HTTP routes → Recycler accounts: mounts features
backend/src/app.ts - HTTP routes → MongoDB: serves requests
README.md - Photo storage → Push delivery: optional integration
- Notifications → Push delivery: queues delivery