What is your project?

Jan Awaaz is a citizen-initiative web app demo for reporting public infrastructure problems in cities and villages—such as potholes, broken streetlights, overflowing drains, burst pipelines, and garbage.

The goal is to help people report issues with photo and location evidence, reduce duplicate reports, and make each report’s progress visible. It is not a government website.

Project repository: Mayank357-engineer/nagarsevak

How does a citizen use it?

The reporting process has three steps:

1. Take a photo and capture GPS: Open the report flow and allow camera and location access. Take a photo using the live camera; gallery uploads are not available. GPS coordinates and accuracy are recorded.
2. Confirm the location: The app tries to find the address and nearby shops. Choose a shop or add a landmark by typing or using voice input.
3. Review AI analysis and submit: Gemma, running locally through LM Studio, attempts to identify the issue type, severity, and description. You can edit the description before submitting.

If an unresolved report of the same issue type is found within 100 metres, the demo shows the existing report and offers “Repost: still not fixed” instead of creating a duplicate.

How do Gemma and the other features work?

• The Test Gemma button sends a test request to LM Studio at localhost:1234.
• The chatbot asks about the problem, its location, and the risk.
• Gemma checks photos for listed infrastructure problems and may flag unclear or unrelated images. AI can be wrong, so users should review the description.
• Nominatim and Overpass are used for location lookup and nearby places. Leaflet and OpenStreetMap provide the map.
• The feed shows nearby reports, photos, status, likes/dislikes, reposts, and WhatsApp sharing. The app also has a Hindi/English toggle and voice input.

What can an admin do?

Demo admin login: admin / janawaaz2024.

The admin dashboard provides a report map and list, filters, and summary statistics. Admins can move a report through Reported → In Progress → Claimed Done.

To mark a report Claimed Done, the admin must take a live after-photo and provide GPS within 50 metres of the original location. Nearby users can confirm the fix if they are within 500 metres: within seven days, 20 confirmations are required for city reports and five for village reports. A claimed fix can be reopened if it receives enough dislikes.

What problem does the demo help address?

Infrastructure problems may go unnoticed, reports can lack clear location evidence, and multiple people may report the same issue separately. This demo helps by:

• Attaching photo and GPS evidence to reports.
• Showing nearby reports to reduce duplicate effort.
• Using AI to suggest an issue category and severity.
• Making report status visible in a public feed.
• Collecting nearby user feedback on claimed fixes.

It helps with reporting and visibility; it does not carry out repairs. Actual action depends on the relevant authority.

Important demo limitations

This is a browser-only demo. Reports and interactions are saved in that browser’s local storage—not in a shared database. The admin login is only a demo gate, not secure authentication. A production system would need a backend, real admin authentication, verified authority contacts, persistent storage, and stronger protection against fake GPS. It should not be used as a real public service yet.

To run it: Start the LM Studio server with CORS enabled, then open index.html using VS Code Live Server. The local Gemma connection is available only on the computer running LM Studio.