Everything you need to use Koodal

The life of an issue

1. Report. A citizen takes a photo, picks a category and a location. Koodal checks for a similar issue nearby first, so the same pothole is not reported ten times.

2. Support. Neighbours back it with a tap. Each supporter raises community confidence.

3. Official case. When support reaches 5 supporters or 80% confidence (your admin can change both), the issue becomes an official case with a case ID and lands on the department’s desk.

4. Fix. Staff approve it, assign a team, start work and mark it fixed with an after photo. Every step appears on the public timeline, live.

5. Confirm. Citizens compare before and after photos. Enough confirmations close the case; three “not yet” answers reopen it.

Citizens · Koodal app

1. Open the app and tap Log in, then enter your phone number. While the demo is running, test accounts are listed below the field: tap one to fill it in.

   

2. Tap Send OTP.

   

3. Enter the 6-digit code and tap Verify. If you have signed in before, you go straight to Nearby.

   

   

Staff · Koodal Console

1. Go to Koodal Console and enter your employee ID and password (or tap a test account).

   

2. Tap Continue.

   

3. Enter the one-time code and tap Verify & continue.

   

4. You land on Home: what needs your decision, overdue work and hotspots. Staff see only their own departments; admins see everything.

   

Create your account

The first time you sign in, Koodal verifies that you are a resident and sets up your profile. It takes about a minute.

1. Swipe through the three intro screens with Next, then tap Get started.

   

   

2. Enter your phone number, tap Send OTP, then Verify.

   

3. Verify your identity with Aadhaar e-KYC. Officials only see a verified badge, never your Aadhaar number.

   

   

4. Add your name and your area, then tap Continue. You can post anonymously by default if you prefer.

   

5. Allow location so Koodal can show issues around you. You are in.

   

   

Report an issue

1. Tap the camera button at the bottom of the screen.

   

2. Take a photo, or tap the gallery icon to pick one.

   

3. Give it a title, pick a category and describe what is wrong. Your GPS location is filled in; tap it to change.

   

4. Scroll down and drag the arrow to the right to report.

   

5. Koodal analyses the report: category, severity and the department it goes to. If nothing similar is nearby, tap Post as new issue.

   

   

6. Your issue is live, with you as the first supporter. Share it with neighbours so they can back it.

   

When a similar issue already exists

If someone nearby has already reported the same problem, Koodal suggests joining it instead of creating a duplicate. Joining counts as your support.

1. Report as usual. The analysis screen shows 1 match nearby; tap it.

   

   

2. Check the match and tap Join. Choose Mine is different if it is a separate problem.

   

3. Your photo is added to the existing issue and you are counted as a supporter.

   

Support an issue

Open any issue and press and hold “Hold to support” until the button fills. What happens next depends on how close it is to the threshold.

1. Your support makes it official. An issue one supporter short becomes an official case the moment you support it, and you see the celebration screen.

   

   

2. Confidence can get it there too. An issue with strong evidence can cross on confidence (80%) before it reaches 5 supporters.

   

   

3. Still gathering support. If more backing is needed, your support is counted and the bar moves closer to the threshold.

   

   

4. Already official. Once an issue is an official case, support closes and you can Track official case instead.

   

Track your cases

1. Issues you support show their official case, the department and team, and the target date as they move forward.

   

2. The Cases tab lists everything you reported or supported, with a badge when something needs you.

   

Confirm a fix

When the department marks a case fixed, the people who backed it decide whether it really is.

1. Open the case and tap Check the fix.

   

2. Compare the before and after photos, then tap Fixed or Not yet.

   

3. When enough neighbours confirm, the case closes. Closed cases keep the fix note and proof photo on their timeline.

   

   

Three “Not yet” answers reopen the case and send it back to the department.

Decide on new cases

1. Home lists every case that crossed the community threshold under Needs your decision, with the time left to decide. Approve assigns a team and target date; Reject needs a reason, an explanation and a proof photo.

   

Work a case

1. Open an assigned case and tap Start work on site.

   

2. When the work is done, tap Mark as fixed, add after photos and a short note, then tap Send for confirmation.

   

What citizens see

The citizen app updates live, with no refresh: assigned, then in progress, then fixed and waiting for confirmation.

1. Filter by When, Area, Department or Problem type. Click a bar to zoom into that period, or export the numbers as CSV.

   

2. The Cases list shows every case with its status, community support, team and target date. Switch to Board to move cases between stages.

   

1. Test mode lists the test accounts on both sign-in pages and unlocks the data tools. Turn it off before real users sign in.

   

2. Thresholds: supporters needed to open a case, or the confidence that opens it, the confidence each support adds, and the confirmations needed to close a fixed case. Tap Save thresholds; the new rules apply immediately.

   

3. Data tools (test mode only). Seed data adds the demo scenarios. Reset seed data removes demo data and seeds a fresh copy; reports from real citizens stay. Remove all data deletes every report and citizen profile and asks you to type DELETE first.

   

   

Koodal app

Koodal Console

Sample issues to explore

Seeded in Chennai with the default thresholds. Open one at /issues/<ID>.