How sudeepn1104/jalsetu-lite works
JalSetu Lite is a water-tanker marketplace connecting citizens, operators, drivers, and municipal rate benchmarks. The principal workflow is citizen search and order selection, operator dispatch, then driver delivery verification; cancellation and dispute handling are alternate lifecycle outcomes. Authentication, staff administration, account history, and public operator scorecards support that workflow. The backend excerpt shows the API and SQLite access but omits most endpoint implementations; lifecycle relationships therefore follow documented behavior, while unsupported internal call wiring is left unspecified.
Main entry points: citizen.html Citizen portal · jalsetu.db SQLite records · auth.js Sign-in and history · main.py Offer search
Components 21
Marketplace
- Citizen portal
frontend/citizen.html - Operator dashboard
frontend/operator.html - Offer search
backend/main.py - Operator and rate data
backend/seed/operators.json - Order selection
backend/main.py
Delivery lifecycle
- Driver dashboard
frontend/driver.html - Dispatch and delivery
backend/main.py - OTP and meter check
backend/main.py - Pre-dispatch cancellation
backend/main.py - Dispute lock
backend/main.py
Identity and records
- Sign-in and history
frontend/auth.js - JalSetu API
backend/main.py - SQLite records
backend/jalsetu.db - Staff administration
backend/main.py
Transparency and payment
- Operator scorecards
frontend/score/public/scores.html - Demo UPI QR
frontend/score/app/api/upi-qr/route.ts - UPI QR rendering
backend/main.py
Other components
- Citizen
- Operator
- Driver
- Administrator
Connections 25
- Citizen → Citizen portal: uses
- Citizen portal → Offer search: searches offers
- Offer search → Operator and rate data: reads operators
- Offer search → Citizen portal: returns offers
- Citizen portal → Order selection: selects offer
- Order selection → SQLite records: records order
- Operator → Operator dashboard: uses
- Operator dashboard → Dispatch and delivery: dispatches order
- Driver → Driver dashboard: uses
- Driver dashboard → Dispatch and delivery: updates delivery
- Dispatch and delivery → OTP and meter check: requests verification
- OTP and meter check → SQLite records: records outcome
- OTP and meter check → Dispute lock: locks on failure
- Dispute lock → SQLite records: records dispute
- Citizen portal → Pre-dispatch cancellation: cancels pre-dispatch
- Pre-dispatch cancellation → SQLite records: updates order history
- Sign-in and history → JalSetu API: authenticates
- JalSetu API → SQLite records: reads and writes
- Sign-in and history → JalSetu API: loads account history
- Administrator → Sign-in and history: manages staff
- Sign-in and history → Staff administration: creates or resets
- Staff administration → SQLite records: stores accounts
- Citizen → Operator scorecards: compares operators
- Citizen portal → Demo UPI QR: requests demo QR
- Citizen portal → UPI QR rendering: requests demo QR