Skip to content

Repository files navigation

πŸ›‘οΈ ShramSuraksha β€” AI Parametric Income Protection for India’s Gig Economy

Guidewire DEVTrails 2026 | Final Phase 3 Submission Team: Era | ITER - SOA University

πŸ“Œ Table of Contents

  1. Problem Statement
  2. Our Solution β€” ShramSuraksha
  3. Persona & Scenario Analysis
  4. Application Workflow
  5. Weekly Premium Model
  6. Parametric Triggers
  7. Platform Choice: Web vs Mobile
  8. AI/ML Integration Plan
  9. Fraud Detection Architecture
  10. Tech Stack
  11. Development Roadmap (6 Weeks)
  12. Business Viability
  13. Repository Structure

🚨 Problem Statement

India has over 12 million platform-based delivery workers operating across Zomato, Swiggy, Amazon, Flipkart, Zepto, and Blinkit. These workers operate entirely without a financial safety net. When external disruptions hit β€” a sudden cloudburst in Mumbai, a three-day flood in Bengaluru, a civic curfew in Delhi β€” their income drops to zero, often for 1–4 days straight.

Our research and secondary data analysis reveals:

  • Delivery partners lose an estimated β‚Ή1,500–₹3,500 per disruption event depending on severity and city
  • 72% of food delivery workers have no savings buffer exceeding 7 days
  • Weather-related disruptions affect delivery operations in Indian metros 40–60 days per year on average
  • There is zero formal income protection product in the market today tailored for this segment

The existing insurance products (health, term life, vehicle insurance) do not address income loss during uncontrollable parametric events. ShramSuraksha fills this exact gap.


πŸ’‘ Why we built this our way (Our Opinionated View)

"We realized traditional insurance is useless for gig workers because they need money within 2 hours of a flood, not 30 days. We threw out claims adjusters entirely. Code decides the payout."

The "Unexpected Thinking" We Brought to Phase 2

The judges asked for creative, opinionated thinking. We looked at the gig economy framework and decided that porting a standard corporate insurance model onto a delivery rider was a path to failure. To actually solve this, we embraced two deeply opinionated architectural choices:

1. The Weekly Premium Model (Micro-Sachets)

We charge β‚Ή59/week instead of monthly. Why? Because we actually spoke to the ecosystem and understood that Zomato and Swiggy workers are paid on Thursdays and Fridays. A monthly insurance premium creates a catastrophic cash-flow mismatch for someone living week-to-week. ShramSuraksha naturally aligns the premium draft directly with their platform settlement days. This isn't just an arbitrary pricing model; it's a natively integrated billing psychology built specifically for the gig economy.

2. Offline Mode (PWA & React Query)

An insurance app for extreme weather is completely useless if it breaks during extreme weather. During floods or cyclones, 4G networks degrade instantly. That's why we bypassed native app stores entirely and deployed ShramSuraksha as a Progressive Web App (PWA) combined with TanStack React Query. Even if a gig worker's network fails during a sudden Delhi storm, the app remains fully functional. It caches their active policy status locally and relies on optimistic UI updates, so they can still interface with their safety net when they need it most.


πŸ’‘ Our Solution β€” ShramSuraksha

ShramSuraksha is an AI-enabled parametric income insurance platform exclusively for food delivery partners (Zomato/Swiggy) in Tier-1 and Tier-2 Indian cities.

Core Value Proposition:

"Your rain should not be your loss. Get paid when the weather stops you from working."

What Makes ShramSuraksha Different

Feature Traditional Insurance ShramSuraksha
Claims process Manual, 7–30 days Fully automated, under 2 hours
Triggers Human-assessed Parametric (objective data APIs)
Pricing Annual/monthly Weekly, aligned with gig income cycles
Coverage Health, vehicle, life Income loss only during disruption events
Fraud verification Adjuster-driven AI anomaly detection + GPS validation
Payout channel Cheque/NEFT Direct UPI to worker's linked account

πŸ‘€ Persona & Scenario Analysis

Chosen Persona: Food Delivery Partner (Zomato / Swiggy)

We have deliberately narrowed our focus to food delivery workers for the following reasons:

  1. Highest exposure to weather disruption (outdoor, two-wheeler, peak hours are lunch/dinner)
  2. Largest addressable segment (~4 million active workers on Zomato + Swiggy combined)
  3. Most predictable income baseline (order earnings + per-km incentive per platform)
  4. Clear, verifiable GPS-based activity data available for fraud prevention

🎭 Scenario 1 β€” Rajan, Bengaluru (Monsoon Flooding)

Profile: Rajan, 28, delivers for Swiggy in the Koramangala–HSR Layout corridor. He earns an average of β‚Ή700–₹900/day on weekdays and β‚Ή1,000–₹1,200 on weekends. He is enrolled on ShramSuraksha's Standard Plan (β‚Ή99/week).

Event: IMD issues a Red Alert for Bengaluru on August 14. Rainfall exceeds 115mm in 24 hours. The Outer Ring Road is flooded. Swiggy suspends operations for the affected zone for 18 hours.

ShramSuraksha Flow:

  1. 🌧️ OpenWeatherMap API detects rainfall > 100mm threshold for Rajan's registered zone
  2. βœ… System cross-validates with IMD alert feed and Swiggy's zone-level suspension signal (mock API)
  3. πŸ“² Rajan receives a push notification: "Disruption event detected. Your claim is being processed."
  4. πŸ€– AI Fraud Engine validates: Rajan's GPS was in the coverage zone, no deliveries logged = legitimate
  5. πŸ’Έ β‚Ή420 payout (calculated as 60% of his daily average for 18 hours of downtime) is transferred via UPI within 90 minutes. Zero manual action required.

🎭 Scenario 2 β€” Priya, Delhi (Severe Pollution + Odd-Even Restriction)

Profile: Priya, 25, delivers for Zomato in South Delhi. She owns a two-wheeler and earns ~β‚Ή650/day. Enrolled on ShramSuraksha's Basic Plan (β‚Ή59/week).

Event: AQI in Delhi crosses 450 (Severe+) on November 3rd. Delhi government invokes GRAP Stage IV restrictions. Two-wheelers are banned from operating in select zones from 8 AM – 8 PM.

ShramSuraksha Flow:

  1. πŸ’¨ CPCB AQI feed registers Severe+ level in Priya's registered zone (South Delhi)
  2. πŸ“‹ Government-issued GRAP restriction API / web scrape confirms operational ban
  3. πŸ€– System calculates 12-hour income loss based on Priya's historical daily earnings
  4. πŸ’Έ β‚Ή325 payout transferred to Priya's UPI handle by 10 AM, before she even realizes she can't work

🎭 Scenario 3 β€” Mohammed, Mumbai (Cyclone Pre-Warning / Curfew)

Profile: Mohammed, 32, earns β‚Ή800–₹950/day delivering for Swiggy in the Andheri–Bandra zone.

Event: IMD issues a Cyclone Warning for coastal Maharashtra on June 9. BMC issues a curfew advisory. Swiggy halts all deliveries in the zone.

ShramSuraksha Flow:

  1. πŸŒ€ IMD cyclone warning API triggers a pre-emptive coverage extension (ShramSuraksha's proactive feature)
  2. Mohammed's policy is automatically extended for 48-hour coverage at no extra premium
  3. System locks in his income baseline 12 hours before the disruption begins (anti-fraud measure)
  4. Upon event confirmation, β‚Ή1,700 payout (2 days Γ— 85% daily average) is processed

πŸ”„ Application Workflow

ShramSuraksha Full System Architecture

Step-by-Step User Flow

1. Onboarding (5 minutes, one-time)

  • Worker registers using mobile number + Aadhaar OTP
  • Links their Swiggy/Zomato Partner ID for income verification
  • Selects home city and primary delivery zone(s) β€” up to 3 zones
  • Sets UPI handle for payouts
  • AI Risk Engine generates their initial risk score based on zone, city, historical disruption frequency

2. Policy Activation

  • Worker picks a weekly plan (Basic / Standard / Premium β€” see pricing below)
  • β‚Ή premium deducted via UPI AutoPay every Monday at 6 AM
  • Policy is active from Monday 00:00 to Sunday 23:59
  • Workers can pause or cancel policy mid-week (no pro-rata refund in V1)

3. Trigger Monitoring (Fully Automated)

  • ShramSuraksha's backend polls 4 external data feeds every 30 minutes
  • When a threshold is crossed in a worker's registered zone, the claim pipeline is triggered automatically
  • No worker action needed β€” purely parametric and zero-touch

4. Fraud Validation

  • AI engine cross-checks GPS last-known location, platform activity logs (via simulated API), and historical claim patterns
  • Flags suspicious claims for manual review (estimated <2% of claims)
  • Clean claims auto-approved and pushed to payout in under 90 minutes

5. Payout

  • UPI transfer to worker's registered handle
  • In-app notification with claim breakdown
  • Monthly summary sent via WhatsApp (planned for Phase 2)

πŸ’° Weekly Premium Model

Why Weekly?

Food delivery workers are paid on a weekly settlement cycle by platforms (Zomato pays every Thursday, Swiggy every Friday). A monthly or annual insurance premium model creates a cash-flow mismatch. Workers simply won't maintain a policy that drafts money the week before a payout.

Our weekly premium aligns insurance cost directly with income arrival β€” a fundamentally different mental model for the gig worker.

Pricing Tiers

Plan Weekly Premium Max Weekly Payout Coverage Hours/Day Disruptions Covered
Basic β‚Ή49 β‚Ή500 Up to 6 hours/day Weather (Rain, Heat) only
Standard β‚Ή99 β‚Ή1,200 Up to 10 hours/day Weather + AQI + Curfew
Premium β‚Ή149 β‚Ή2,000 Up to 12 hours/day All triggers + Proactive alerts

Dynamic Premium Calculation (AI-Adjusted)

The base premium is adjusted weekly by our ML Risk Engine based on:

Adjusted Premium = Base Premium Γ— Zone Risk Multiplier Γ— Weather Forecast Factor Γ— Claim History Modifier

Where:
  Zone Risk Multiplier   = 0.85 (low-flood-risk zone) to 1.30 (high-risk zone)
  Weather Forecast Factor = IMD forecast severity index for the coming week (0.90 – 1.25)
  Claim History Modifier  = 0.95 (no claims in 4 weeks) to 1.10 (multiple claims)

Example: A Standard Plan worker in a low-risk zone with no recent claims during a clear-forecast week: β‚Ή99 Γ— 0.85 Γ— 0.92 Γ— 0.95 = β‚Ή73.5 effective premium

This dynamic pricing ensures affordability for workers in safer zones while maintaining actuarial soundness.

Payout Calculation

Payout = (Worker's 4-Week Rolling Daily Average Earnings) Γ— Disruption Hour Fraction Γ— Coverage Multiplier

Where:
  4-Week Rolling Average = Mean daily earnings from platform data over last 28 days
  Disruption Hour Fraction = Hours unable to work Γ· Typical working hours per day (10h)
  Coverage Multiplier = Per plan: Basic=0.6, Standard=0.8, Premium=1.0

⚑ Parametric Triggers

All triggers are objective, data-driven, and automatically verifiable. No claim form. No assessor visit. No human discretion.

# Trigger Data Source Threshold Payout Condition
1 Heavy Rainfall OpenWeatherMap API + IMD RSS > 64.5 mm/24h in registered zone Deliveries logistically halted
2 Severe Heat Wave IMD Heat Alert API Temperature > 45Β°C + Heat Alert Level 3+ Unsafe outdoor working conditions
3 Air Quality (AQI) CPCB AQI API (api.cpcbccr.gov.in) AQI > 401 (Severe) + GRAP Stage IV Two-wheeler ban / outdoor work restriction
4 Civic Curfew / Strike Government advisory scraper (PIB/State Govt feeds) Confirmed zone-level curfew issued Access to pickup/drop zones blocked
5 Platform Outage (Premium only) Swiggy/Zomato status mock API Platform down > 2 hours during peak (12–2 PM or 7–10 PM) Worker logged in but zero orders dispatched

Important: ShramSuraksha only covers income loss caused by these parametric triggers. Vehicle damage, health issues, and personal accidents are explicitly excluded from all plans.


πŸ“± Platform Choice: Web vs Mobile

Decision: Progressive Web App (PWA) β€” Mobile-First

Rationale:

  • Over 94% of delivery workers access the internet exclusively via Android smartphones
  • A native app requires Play Store approval (2–5 day delay, unsuitable for 6-week hackathon)
  • A PWA delivers native app experience (home screen install, push notifications, offline mode) with zero installation friction
  • Aadhaar OTP-based KYC works seamlessly in mobile browser environments
  • UPI deep-links work natively on Android browsers without a native wrapper

Technology: React (Vite) PWA β€” renders as a full-screen app on Android with service workers for push notifications and offline policy-status caching.


πŸ€– AI/ML Integration Plan

1. Dynamic Risk Scoring & Premium Engine

Model: Gradient Boosted Trees (XGBoost) β€” chosen for tabular data performance and interpretability (SHAP explainability for regulatory audits)

Features:

  • Worker's registered zone(s) historical disruption frequency (past 3 years)
  • IMD 7-day weather forecast severity index
  • City-level monsoon onset calendar
  • Worker's own claim history (frequency, severity)
  • Seasonal risk calendar (pre-encoded: Oct–Dec = Delhi pollution season, Jun–Sep = Mumbai monsoon)

Training Data: Synthesized using IMD historical weather records, CPCB AQI archives, and news-scraped civic disruption events (2018–2024).

Output: Per-worker adjusted weekly premium + explainable breakdown sent to worker ("Your premium this week is lower because no rain is forecast and your zone has low flood history")


2. Income Baseline Estimation

Problem: Workers won't always have verifiable income records. New workers with <4 weeks of history need a baseline.

Solution: A Zone Γ— Tenure Γ— Platform regression model trained on synthetic platform earnings data:

Estimated Daily Income = Ξ²β‚€ + β₁(Zone_Tier) + Ξ²β‚‚(Tenure_Weeks) + β₃(Platform) + Ξ²β‚„(Day_of_Week) + Ξ΅

For workers with 4+ weeks of history, the actual rolling 28-day average overrides the model estimate.


3. Fraud Detection Engine

Architecture: Isolation Forest (unsupervised anomaly detection) as the first pass, followed by a rule-based decision tree for explainability.

Feature Signals Used:

Signal Fraud Pattern Detected
GPS last known location Worker claims disruption but GPS shows them in a different zone
Platform activity log (mock) Worker logged deliveries during claimed downtime
Claim frequency Unusual spike β€” worker claims every week for 6+ consecutive weeks
Weather event magnitude vs payout request AQI was 250 (Moderate), but worker claims Severe event payout
Historical co-claimant analysis 10+ workers from the same tiny zone claiming simultaneously (zone farming)

Output: Fraud Risk Score (0–100). Score > 70 β†’ held for manual review. Score > 90 β†’ auto-rejected with explanation.


πŸ› οΈ Tech Stack

Frontend

Component Technology Reason
Framework React 18 (Vite) Fast build, PWA support
Query Layer TanStack React Query Optimistic UI Updates & Caching
Styling Vanilla CSS / Design Tokens Rapid custom UI development
Dashboard Recharts Lightweight, interactive charts

Backend

Component Technology Reason
Runtime Node.js (Express) Scalable REST API
Database MongoDB (via Mongoose) Document DB for flexible schema & fast scaling
AI Engine Google Gemini 2.0 Flash AI Premium Calculation & Fraud verification
Cache Node-Cache (Redis Sync) Reducing 3rd party API calls via TTL

External APIs

Data API/Source Usage
Weather OpenWeatherMap Rainfall, temperature, triggers
Generative AI Google Gemini AI Insights and text interpretation

Infrastructure

Component Service
Hosting Vercel (frontend) + Railway (backend)

πŸ—“οΈ Development Roadmap (6 Weeks)

βœ… Phase 1 β€” Weeks 1–2: Ideation & Foundation (March 4 – March 20)

  • Problem research and persona definition
  • Parametric trigger selection and threshold research
  • Weekly premium model design (actuarial logic)
  • AI/ML architecture planning (XGBoost + Isolation Forest)
  • Tech stack selection and justification
  • README documentation (this document)
  • Repository scaffolding β€” monorepo structure initialized
  • UI wireframes β€” onboarding, dashboard, claim notification flows
  • Figma prototype (low-fidelity) β€” 5 core screens
  • API research β€” OpenWeatherMap, CPCB, Razorpay test mode verified

Prototype Scope (Phase 1):

  • Static UI mockup of onboarding screen with plan selection
  • Mock trigger: rainfall API call β†’ console log of triggered event
  • Readme + architecture documentation (this submission)

πŸ”§ Phase 2 β€” Weeks 3–4: Automation & Protection (March 21 – April 4)

Goal: Working end-to-end flow β€” from registration to automated claim

  • Full deployment (Frontend Vercel / Backend Railway)
  • Mongoose connection and Worker registration flows
  • Express API deployment and CORS configuration
  • AI Gemini integration for automated premium calculations
  • Live OpenWeatherMap data streaming into Dashboards
  • Animated interactive dashboards for Admin view
  • Working PWA manifest (Installable Native UI capability)

πŸš€ Phase 3 β€” Weeks 5–6: Scale & Optimise (April 5 – April 17)

Goal: Production-hardened, fully demo-able platform with Zero-Touch Automation

  • True Automated Trigger Monitoring: Integrated Node.js background worker processes (Cron Jobs) to poll weather APIs autonomously, routing payloads through an LLM evaluation agent for zero-touch claim approvals.
  • Dynamic Income-Tied Payouts: Replaced flat payouts with a dynamic formula: (Daily Declared Income / 8) * Hours of Disruption, proving actuarial soundness suited for the gig economy.
  • Geospatial City Tier Analysis: Created a definitive geospatial matrix applying risk and payout multipliers based on City Tiers (e.g., Tier-1 Mumbai = 1.3x baseline).
  • Behavioral Risk Differentiation: Implemented a Dynamic Risk Scoring Engine that auto-calculates claim frequency ratios and device integrity mismatch to adjust individual weekly premiums interactively.
  • Advanced Fraud Detection: Implemented LLM cross-referencing to catch gig-specific fraud (e.g., GPS spoofing, fake weather claims checking historical logs vs exact claim timestamps).
  • Simulated Instant Payouts: Integrated mock UPI payment gateways to demonstrate instant wage credits.
  • Intelligent Insurer Dashboard: Polished the live Admin panel to display real-time payout flow, loss ratios, and simulated claim metrics.
  • Vernacular & Sunlight UI: Upgraded the frontend interface to default to high-contrast modes for direct sunlight reading, complete with interactive English/Hindi toggling to deeply target the blue-collar delivery partner persona.

πŸ“Š Business Viability

Market Sizing

  • Serviceable Addressable Market (SAM): ~4 million food delivery workers on Zomato + Swiggy
  • Target Initial Segment: Workers in top 6 metro cities β€” est. 1.8 million
  • Assumed 5% penetration in Year 1: 90,000 policyholders
  • Average Revenue (Standard Plan, adjusted): β‚Ή85/week Γ— 52 weeks = β‚Ή4,420/worker/year
  • Projected ARR (Year 1): ~β‚Ή39.8 crore

Loss Ratio Estimate

  • Historical average disruption days in Indian metros: ~45 days/year (weather + civic)
  • Average payout per event per worker (Standard Plan): β‚Ή480
  • Expected annual payout per worker: ~β‚Ή2,160 (~48% loss ratio on Standard Plan)
  • Gross margin at scale: ~52% before operational costs β€” commercially viable

Why Guidewire / Insurtech Integration Makes Sense

  • Guidewire ClaimCenter can manage the parametric claims pipeline at enterprise scale
  • PolicyCenter can handle the weekly policy issuance/renewal lifecycle
  • BillingCenter integrates with UPI AutoPay for the weekly debit cycle
  • ShramSuraksha is architected as a Guidewire-compatible insurance product from Day 1

πŸ“ Repository Structure

ShramSuraksha/
β”œβ”€β”€ README.md                    ← This document
β”œβ”€β”€ src/                         ← React PWA Frontend
β”‚   β”œβ”€β”€ pages/
β”‚   β”‚   β”œβ”€β”€ LandingPage.jsx
β”‚   β”‚   β”œβ”€β”€ Dashboard.jsx
β”‚   β”‚   β”œβ”€β”€ ClaimsPage.jsx
β”‚   β”‚   └── AdminPage.jsx
β”‚   β”œβ”€β”€ components/              ← React components
β”‚   └── api.js                   ← Axios API clients
β”œβ”€β”€ server/                      ← Node.js Express Backend
β”‚   β”œβ”€β”€ routes/
β”‚   β”‚   β”œβ”€β”€ auth.js
β”‚   β”‚   β”œβ”€β”€ policy.js
β”‚   β”‚   β”œβ”€β”€ claims.js
β”‚   β”‚   β”œβ”€β”€ weather.js
β”‚   β”‚   └── ai.js
β”‚   β”œβ”€β”€ models.js                ← Mongoose Schema Definitions
β”‚   β”œβ”€β”€ store.js                 ← MongoDB Connection & Seeding
β”‚   └── index.js

πŸ‘₯ Team Era

Name Role
Ayush Raj Chourasia Team Leader
Tribhuwan Singh Member
Satyajit Sethy Member
Surajit Sahoo Member
E Sailaja Member

πŸ“Ž Submission Links

Real-time OTP setup

  • Email OTP delivery now uses the Gmail API over HTTPS instead of SMTP, so the Railway backend is no longer dependent on outbound mail port access.
  • Required backend env vars: GMAIL_USER, GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET, GMAIL_REFRESH_TOKEN, and GOOGLE_CLIENT_ID.
  • WhatsApp and SMS continue to use Twilio Verify / Twilio Messaging for real delivery.

ShramSuraksha is built for the 4 AM rider who has nowhere to go when the city floods. This is not a product. It's a safety net.


About

An AI-enabled parametric income insurance platform for India's gig workers, offering automated, weather-triggered payouts via a mobile-first PWA.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages