Skip to main content

​
Signal Resolution Process

When you report an issue, here’s the full journey from complaint to completion.

​
The Heat Score System

Not all issues can be addressed at once. We use a Heat Score to prioritize: 
Heat Score = (Severity × 2) + Upvotes + Days Open
FactorContribution
SeverityAI-assigned 1-5 based on issue type
UpvotesEach “Me Too” adds 1 point
AgeEach day open adds 1 point

​
Heat Thresholds

Heat ScoreWhat Happens
10+Resolution Poll automatically created
25+Marked as “Critical” priority

​
The Resolution Poll

When heat reaches 10, community members vote on the solution:

Option A

Log with MunicipalityFree - City handles it through normal channels

Option B

Community VolunteerDIY - Neighbors coordinate the fix

Option C

Hire Private VendorPaid - Local business fixes it

​
Poll Rules

  • Duration: 48 hours
  • Quorum: Minimum 10 votes required
  • Default: If quorum not met, defaults to Municipality
  • One vote per person

​
AI Analysis

For every signal, our AI generates an Intelligence Report:
  • Responsible Entity — Who should fix this (City, Eskom, etc.)
  • Estimated Cost — Private repair cost range
  • Materials Needed — What’s required for the fix
  • Safety Risk — Urgency rating (1-5)
  • Recommended Action — AI’s suggestion
The AI report is posted as the first comment in the discussion thread.

​
Vendor Bidding (If Paid Option Wins)

1

Work Order Created

System creates a job listing for the issue
2

Vendors Notified

Registered local businesses with matching skills get alerts
3

Bids Submitted

Vendors submit blind bids with price and timeline
4

Admin Shortlists

Top 3 bids are presented to the community
5

Community Votes

Residents vote on which vendor to hire
6

Work Order Assigned

Winner receives the job and begins work

​
Completion & Verification

1

Work Completed

Vendor/volunteer uploads completion photo
2

Community Verifies

A neighbor confirms the fix is real
3

Signal Closed

Issue marked as resolved in the Ward Ledger

​
Flow Diagram