VYAVASTHA: Bridging Citizens & Government with AI

AI civic portal where citizens report verified local issues, get real-time updates & government resolves faster powered by Featherless AI, Sight engine, Socket.io & Miro.

Comment

Inspiration

Every day, millions of citizens worldwide face broken roads, overflowing drains, power outages, and public safety hazards — but reporting them is frustrating, slow, and often goes nowhere.

Whether you're in India, Nigeria, Indonesia, or Brazil — civic complaint systems are broken everywhere. Paper forms, zero transparency, no follow-up, no accountability.

What We Built

VYAVASTHA is a full-stack AI-powered civic complaint platform that bridges the gap between citizens and local government

For Citizens:

  • Submit complaints with AI-verified real photos
  • AI auto-classifies category, severity and routes to correct department
  • Real-time popup notifications when complaint status changes
  • Track complaint journey: Submitted → Assigned → In Progress → Resolved
  • Upvote community complaints for collective pressure
  • 25 language support for global accessibility

For Government Officials:

  • Structured dashboard to assign, escalate and resolve complaints
  • AI generates professional ATR (Action Taken Report) instantly
  • Miro board embedded for department planning and coordination
  • Analytics dashboard showing complaint trends by category and area
  • Auto-escalation alerts for overdue complaints

Image Authenticity Verification (3 Layers)

No fake complaints. No AI-generated evidence. Real photos only.

Layer 1 — EXIF Metadata Check Real camera photos contain metadata: camera make, model, GPS coordinates. AI images have none of this.

Layer 2 — Sightengine AI Detection Sightengine API scans every upload and rejects AI-generated images instantly.

Layer 3 — Sanity Check File size between 20KB–15MB, minimum 400x400px dimensions, only JPG/PNG/WebP formats accepted.

AI Features (Powered by Featherless AI)

When a citizen types a complaint, Featherless AI instantly:

  • Detects category: Road, Water, Electricity, Sanitation, Public Safety
  • Routes to correct department: PWD, Water Board, BESCOM, BBMP, Police
  • Assigns severity: Low / Medium / High / Urgent
  • Generates a professional summary
  • Writes a complete ATR report for officials
  • Predicts expected resolution time

Real-Time Notifications (Socket.io)

When an official updates a complaint status, the citizen's portal instantly shows a color-coded popup notification — no refresh needed.

  • Green — Complaint Resolved
  • Blue — Complaint Assigned
  • Orange — Work In Progress
  • Red — Complaint Rejected

Auto-Escalation System (node-cron)

No complaint falls through the cracks. Ever.

Severity Escalates After
Urgent 1 day
High 3 days
Medium 7 days
Low 14 days

Runs automatically every midnight. Citizens notified instantly when complaint is escalated to senior authorities.

How We Built It

Frontend: React 18, Vite, Tailwind CSS, Zustand, i18next

Backend: Node.js, Express, MongoDB, Mongoose, JWT, Socket.io, node-cron, Multer

AI & Sponsor Tools:

  • Featherless AI — LLM complaint classification and ATR generation
  • Sightengine — Screenshot and AI-image detection
  • Miro — Embedded planning board in government admin dashboard
  • DevSwarm — Parallel AI-assisted development across features

Infrastructure: Docker

Challenges We Faced

  • Integrating Socket.io correctly inside Docker containers
  • Building 3-layer image verification fast enough for real-time use
  • Balancing Featherless AI response quality vs speed
  • Implementing complete i18n for 25 languages in 7 days
  • Building production-grade role-based system as a student team

What We Learned

  • How to integrate LLM APIs for structured real-world outputs
  • Real-time architecture with Socket.io user rooms
  • Image authenticity detection using metadata and ML APIs
  • SLA-based automation with cron jobs
  • Building for real civic use cases that matter to people

Impact

VYAVASTHA makes civic accountability visible, complaints actionable, and governance more responsive — for any city, any government, any citizen worldwide.

Built With

Share this project:

Updates