How ishanth777/sih works
This is a cooperative labour marketplace serving customers, workers, cooperative societies, and federations. Its central workflow is customer service discovery and booking, followed by worker matching, job tracking, and payment; operational modules also cover identity, cooperative administration, welfare, disputes, and demand forecasting. Web and mobile clients sit alongside a NestJS API and a separate Python forecasting service. The supplied excerpts establish only some call paths; uncertain integrations are omitted or marked unverified.
Main entry points: requests.service.ts Service requests · workers.service.ts Worker profiles and availability · matching.service.ts Worker matching · auth.service.ts Authentication
Components 26
Client experiences
- Web booking
apps/web/app/(customer)/booking/page.tsx - Worker recommendations
apps/web/components/matching/WorkerRecommendationChatbot.tsx - Worker mobile screens
apps/mobile/src/screens/WorkerAvailabilityToggle.tsx - Location tracking hook
apps/mobile/src/hooks/useWorkerLocation.ts - Location service
apps/mobile/src/services/location.service.ts - Offline cache
apps/mobile/src/services/offline-cache.service.ts
Marketplace API
- Authentication
apps/api/src/auth/auth.service.ts - Customer accounts
apps/api/src/customers/customers.service.ts - Service requests
apps/api/src/requests/requests.service.ts - Service catalog
apps/api/src/services-catalog/services-catalog.service.ts - Worker matching
apps/api/src/matching/matching.service.ts - Job lifecycle
apps/api/src/jobs/jobs.service.ts - Payments
apps/api/src/payments/payments.service.ts - Worker profiles and availability
apps/api/src/workers/workers.service.ts - Disputes
apps/api/src/disputes/disputes.service.ts - Worker welfare
apps/api/src/welfare/welfare.service.ts - Notifications
apps/api/src/notifications/notifications.service.ts - Database access
apps/api/src/common/prisma/prisma.service.ts
Cooperative operations
- Federation management
apps/api/src/federations/federations.service.ts - Cooperative management
apps/api/src/cooperatives/cooperatives.service.ts
Forecasting
- Forecast API
apps/api/src/forecasting/forecasting.service.ts - Forecast endpoint
apps/forecasting/main.py - Demand forecaster
apps/forecasting/forecaster.py
Other components
- Customer
- Worker
- Society and federation admins
Connections 27
- Customer → Web booking: books through
- Web booking → Service requests: submits request
- Customer → Worker recommendations: requests recommendation
- Worker recommendations → Service requests: creates booking
apps/web/components/matching/WorkerRecommendationChatbot.tsx - Worker → Worker mobile screens: uses
- Worker mobile screens → Location tracking hook: tracks location
- Location tracking hook → Location service: calls
apps/mobile/src/hooks/useWorkerLocation.ts - Location service → Worker profiles and availability: updates location
- Worker → Worker profiles and availability: manages profile
- Society and federation admins → Worker profiles and availability: manages workers
- Customer → Customer accounts: manages account
- Society and federation admins → Federation management: administers federation
- Society and federation admins → Cooperative management: administers cooperative
- Society and federation admins → Service requests: reviews requests
- Society and federation admins → Service catalog: maintains catalog
- Society and federation admins → Worker welfare: manages welfare
- Customer → Payments: pays for jobs
- Customer → Disputes: raises dispute
- Service requests → Worker matching: requests matching
- Worker matching → Worker profiles and availability: selects workers
- Worker matching → Job lifecycle: dispatches job
- Job lifecycle → Payments: initiates payment
- Authentication → Database access: reads and writes
apps/api/src/auth/auth.service.ts - Authentication → Notifications: may notify
apps/api/src/auth/auth.service.ts - Society and federation admins → Forecast API: requests forecast
- Forecast API → Forecast endpoint: obtains forecast
- Forecast endpoint → Demand forecaster: generates forecast
apps/forecasting/main.py