How vedanttathe/jalsaathi works
JalSaathi is an area-based water-can delivery platform connecting customers, providers, delivery personnel, and administrators. Its main workflow spans account access and provider discovery, ordering and payment, provider acceptance and delivery assignment, delivery confirmation, and order visibility for customers and administrators. The graph shows the React client, modular Express backend, and key domain areas. The README documents the end-to-end roles and flow; source excerpts and the index support selected internal calls. Some frontend-to-backend wiring and unsampled module internals are not verified here.
Main entry points: App.jsx React app · server.js API server · order/service.js Order management · admin/service.js Admin oversight
Components 22
Web client
- React app
frontend/src/App.jsx - Session and auth
frontend/src/contexts/AuthContext.jsx - Customer dashboard
frontend/src/pages/dashboards/CustomerDashboard.jsx - Provider dashboard
frontend/src/pages/dashboards/ProviderDashboard.jsx - Delivery dashboard
frontend/src/pages/dashboards/DeliveryDashboard.jsx - Admin dashboard
frontend/src/pages/dashboards/AdminDashboard.jsx - API client
frontend/src/services/api.js
Backend platform
- API server
backend/src/server.js - Authentication
backend/src/modules/auth/service.js - User and addresses
backend/src/modules/user/service.js - Admin oversight
backend/src/modules/admin/service.js - MongoDB
Orders and delivery
- Provider operations
backend/src/modules/provider/service.js - Order management
backend/src/modules/order/service.js - Delivery operations
backend/src/modules/delivery/service.js
Payments and settlement
- Payment processing
backend/src/services/paymentService.js - Razorpay
- Provider settlements
backend/src/services/settlementService.js
Other components
- Customer
- Provider
- Delivery person
- Administrator
Connections 36
- Customer → React app: uses
README.md - Provider → React app: uses
README.md - Delivery person → React app: uses
README.md - Administrator → React app: uses
README.md - React app → Session and auth: reads session
frontend/src/App.jsx - React app → Customer dashboard: routes by role
frontend/src/App.jsx - React app → Provider dashboard: routes by role
frontend/src/App.jsx - React app → Delivery dashboard: routes by role
frontend/src/App.jsx - React app → Admin dashboard: routes admin
frontend/src/App.jsx - Session and auth → API client: calls auth API
frontend/src/contexts/AuthContext.jsx - Customer dashboard → API client: requests data
frontend/src/pages/dashboards/CustomerDashboard.jsx - API client → API server: sends API requests
- API server → Authentication: mounts auth routes
backend/src/server.js - API server → Order management: mounts order routes
backend/src/server.js - API server → Provider operations: mounts provider routes
backend/src/server.js - API server → Delivery operations: mounts delivery routes
backend/src/server.js - API server → Admin oversight: mounts admin routes
backend/src/server.js - API server → Payment processing: mounts payment routes
backend/src/server.js - Customer → Order management: places order
README.md - Order management → Razorpay: initiates payment
backend/src/modules/order/service.js - Customer → Payment processing: pays
README.md - Provider → Provider operations: accepts and assigns
README.md - Provider operations → Delivery operations: assigns delivery
- Delivery person → Delivery operations: confirms delivery
README.md - Customer → User and addresses: manages account
README.md - Administrator → Admin oversight: monitors platform
README.md - Admin oversight → Order management: queries orders
backend/src/modules/admin/controller.js - Administrator → Provider settlements: manages settlements
- Authentication → MongoDB: reads and writes users
- User and addresses → MongoDB: reads and writes
- Order management → MongoDB: reads and writes orders
backend/src/modules/order/service.js - Provider operations → MongoDB: reads and writes
- Delivery operations → MongoDB: reads and writes
- Admin oversight → MongoDB: reads and writes
- Payment processing → Razorpay: processes payments
- Provider settlements → MongoDB: stores settlements