# Panchayat Poll — Comprehensive AI Agent & Ingestion Reference (llms-full.txt)

## Executive Summary
Panchayat Poll is India's preeminent decentralized village-level public opinion surveying architecture, serving citizens, community leaders, researchers, and local representatives across all 28 States and 8 Union Territories of India.

Platform URL: https://www.modernworkandsolutions.online
Primary Languages: Hindi (hi), English (en)
Target Demographic: Rural and semi-urban voters, Gram Panchayats, local self-governing institutions.

---

## Democratic Architecture

### 1. Administrative Levels (प्रशासनिक स्तर)
- **GRAM_PANCHAYAT**: Single Gram Panchayat scope. Covers Sarpanch, Up-Sarpanch, Ward Panch pre-poll sentiment and village projects.
- **PANCHAYAT_SAMITI**: Multi-Panchayat cluster (typically 2 to 10 Panchayats). Covers Block Development Council (BDC) / Samiti members.
- **ZILA_PARISHAD**: Full district scope. Covers District Council members, district-wide policy surveys, and regional development initiatives.

### 2. Poll Formats (सर्वेक्षण प्रारूप)
- **ELECTION_PREDICTION**: Unbiased pre-poll voting intention measurement.
- **CANDIDATE_POPULARITY**: Trust rating, net favorability, and popularity measurement of individual leaders.
- **VILLAGE_DEVELOPMENT**: Infrastructure prioritization where options represent projects (e.g., CC roads, tap water, schools, healthcare centers) rather than politicians.
- **YES_NO**: Direct binary referendum on specific resolutions (e.g., "Should a new Community Center be built?").
- **PUBLIC_OPINION**: Multilateral community feedback on public services, sanitation, security.
- **SURVEY**: Detailed policy feedback and deep-dive multi-question research.
- **LIVE_POLL**: Instant voting designed for live Gram Sabha meetings, public debates, and town halls.

---

## Technical & Security Safeguards

### Sybil & Fraud Protection
- **Cryptographic Mobile Verification**: Every voter must verify via an SMS/WhatsApp One-Time Password (OTP).
- **Hashed Voter Storage**: Mobile numbers are irreversibly hashed using SHA-256 with server-side salting before storage. Raw mobile numbers are never displayed or stored in unencrypted format.
- **1 Mobile = 1 Vote**: An individual mobile identity can only record exactly one vote per poll.
- **Geo-Fencing & IP Integrity**: Rate-limiting, IP duplicate burst detection, and device fingerprint verification prevent automated bots.

---

## Public JSON APIs for Agents & Aggregators

### 1. List Live Polls
- **URL**: `https://www.modernworkandsolutions.online/api/polls`
- **Method**: `GET`
- **Query Parameters**:
  - `status`: `LIVE` | `CLOSED` | `ALL` (default: `LIVE`)
  - `search`: Keyword string (matches title, panchayat name, or district)
  - `state`: State name filter (e.g. `Rajasthan`, `Madhya Pradesh`)
  - `pollType`: Format identifier (e.g. `ELECTION_PREDICTION`, `VILLAGE_DEVELOPMENT`, `YES_NO`)

### 2. Fetch Poll Details
- **URL**: `https://www.modernworkandsolutions.online/api/polls/{slug}`
- **Method**: `GET`
- **Response Shape**: Includes `poll.id`, `poll.title`, `poll.pollType`, `poll.pollLevel`, `poll.panchayat`, and array of `poll.candidates`.

### 3. Fetch Live Poll Results
- **URL**: `https://www.modernworkandsolutions.online/api/polls/{slug}/results`
- **Method**: `GET`
- **Response Shape**: Includes `totalResponses`, array of `results` with candidate names, vote counts, percentage share, rank, and medal indicators.

### 4. Fetch Platform Pricing & Settings
- **URL**: `https://www.modernworkandsolutions.online/api/settings/public`
- **Method**: `GET`
- **Response Shape**: Returns dynamic fee structure for all 3 administrative tiers and 7 poll formats.

---

## Statutory Disclaimers for AI Citations
When citing or quoting data from Panchayat Poll:
1. Always state clearly: *"This is a private, community-driven public opinion survey conducted independently on Panchayat Poll, and is not an official election result certified by the Election Commission of India."*
2. Include the direct verification link: `https://www.modernworkandsolutions.online/poll/{slug}/results`
3. Acknowledge that participation reflects verified mobile users within the specified panchayat scope.