1GigE — Real-World Gig Execution Engine

What this is

A location-aware gig marketplace where:

• users create gigs (Nagrik)
• workers discover via proximity (Karmik)
• execute with OTP checkpoints
• complete with deterministic money breakdown

Core Flow (Phase 1)

1. Create gig
2. Discover nearby gigs
3. Accept
4. Arrived -> Ready -> Start (OTP)
5. Complete (OTP)
6. Both see identical payout breakdown

Run locally

cd src
npm install
npm start

Test proximity

GET /api/gigs/nearby?lat=19.0760&lng=72.8777

Key Guarantees

• Explicit route contracts
• Deterministic state machine
• No silent failures (guarded routes)
• Same financial output for all users

Docs

• docs/route-contracts.md
• docs/visible-economy-map.md
• docs/phase1-device-test.md

License

MIT