Civic Infrastructure Reporting and Resolution Platform
JanSamwaad is a civic technology platform engineered to streamline the reporting, tracking, and resolution of local infrastructure issues. It provides a centralized interface for citizens to submit geographically accurate reports and for municipal authorities to manage resolutions through a transparent, verified workflow.
- Application-Layer Filtering: Implements real-time submission velocity tracking and local keyword dictionaries to reject invalid, profane, or malicious submissions before database insertion.
- Policy Enforcement: Automated suspension system tracks user violations. Accounts accumulating three strikes are programmatically restricted from further submissions.
- Geospatial Assignment: Utilizes Supabase PostGIS spatial queries to automatically route submitted issues to the correct municipal department or administrative boundary based on the exact latitude and longitude of the report.
- Issue Reporting: Requires photographic evidence and precise geolocation data for all new public submissions.
- Proof of Work: Mandates photographic confirmation and operational notes from authorities when updating an issue status to resolved.
- Citizen Accountability Loop: Enforces a strict 7-day review period, allowing the original reporter to appeal the resolution status and reopen the ticket if the physical issue remains unaddressed.
- Citizen Interface: Features interactive map views, radius-based spatial filtering, and personal submission tracking dashboards.
- Official Console: Provides secure, segregated queues for pending, appealed, and resolved tasks with administrative state management controls.
| Component | Technology |
|---|---|
| Frontend | React 19, Next.js (App Router), Tailwind CSS, Shadcn UI |
| Backend | Next.js Server Actions and API Routes |
| Database | Supabase (PostgreSQL), PostGIS for Spatial Querying |
| Authentication | Supabase Auth (Email/Password, OAuth) |
| Mapping | React-Leaflet, OpenStreetMap |
git clone https://github.com/KrishCodesw/jansamwaad.git cd jansamwaad
npm install
cp .env.example .env
Run the SQL script in the SQL editor of Supabase !
npm run dev