> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visita.co.za/llms.txt
> Use this file to discover all available pages before exploring further.

# Signal Resolution Process

> How civic issues go from report to resolution

# 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
```

| Factor       | Contribution                        |
| ------------ | ----------------------------------- |
| **Severity** | AI-assigned 1-5 based on issue type |
| **Upvotes**  | Each "Me Too" adds 1 point          |
| **Age**      | Each day open adds 1 point          |

### Heat Thresholds

| Heat Score | What Happens                          |
| ---------- | ------------------------------------- |
| **10+**    | Resolution Poll automatically created |
| **25+**    | Marked as "Critical" priority         |

## The Resolution Poll

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

<CardGroup cols={3}>
  <Card title="Option A" icon="building-columns">
    **Log with Municipality**

    Free - City handles it through normal channels
  </Card>

  <Card title="Option B" icon="people-group">
    **Community Volunteer**

    DIY - Neighbors coordinate the fix
  </Card>

  <Card title="Option C" icon="briefcase">
    **Hire Private Vendor**

    Paid - Local business fixes it
  </Card>
</CardGroup>

### 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**:

<Accordion title="What's in the AI 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
</Accordion>

The AI report is posted as the first comment in the discussion thread.

## Vendor Bidding (If Paid Option Wins)

<Steps>
  <Step title="Work Order Created">
    System creates a job listing for the issue
  </Step>

  <Step title="Vendors Notified">
    Registered local businesses with matching skills get alerts
  </Step>

  <Step title="Bids Submitted">
    Vendors submit blind bids with price and timeline
  </Step>

  <Step title="Admin Shortlists">
    Top 3 bids are presented to the community
  </Step>

  <Step title="Community Votes">
    Residents vote on which vendor to hire
  </Step>

  <Step title="Work Order Assigned">
    Winner receives the job and begins work
  </Step>
</Steps>

## Completion & Verification

<Steps>
  <Step title="Work Completed">
    Vendor/volunteer uploads completion photo
  </Step>

  <Step title="Community Verifies">
    A neighbor confirms the fix is real
  </Step>

  <Step title="Signal Closed">
    Issue marked as resolved in the Ward Ledger
  </Step>
</Steps>

## Flow Diagram

```mermaid theme={null}
flowchart TD
    A[Issue Reported] --> B{Heat ≥ 10?}
    B -->|No| C[Wait for Upvotes]
    C --> B
    B -->|Yes| D[Poll Created]
    D --> E{48h Vote}
    E -->|Municipality| F[City Ticket]
    E -->|Volunteer| G[Community Fix]
    E -->|Vendor| H[Open for Bids]
    H --> I[Vendors Bid]
    I --> J[Admin Shortlists]
    J --> K[Community Votes]
    K --> L[Work Order]
    L --> M[Fix Completed]
    F --> M
    G --> M
    M --> N[Verified ✓]
```