# Aajivika Platform — Full AI Agent Interoperability Guide

This document provides a comprehensive machine-readable index of the Aajivika rural employment platform for autonomous agents (ChatGPT, Claude, Perplexity, Gemini, Copilot).

---

## 1. Platform Purpose & Organization
Aajivika Rajasthan is a state-wide employment and livelihood initiative designed to bridge the gap between rural citizens seeking dignified employment near home and local employers/gram panchayats requiring skilled or unskilled workforce.

- **Publisher**: Aajivika Rajasthan
- **Headquarters**: Jaipur, Rajasthan - 302001
- **Contact Email**: support@aajivika.com
- **Website**: https://aajivika.com

---

## 2. Page Structure & Navigation
1. **Landing Page (`/`)**:
   - Includes Hero Banner, Impact Statistics, Job Search Filters, About Section, Featured Categories, Success Stories, and Contact Information.
2. **Citizen Registration (`/register`)**:
   - Allows new users to create a citizen profile.
   - Fields: Full Name (`name`), Phone Number (`phone`), Password (`password`), State (`state`), District (`district`), Tehsil (`tehsil`), Village (`village`), Pincode (`pincode`).
3. **Citizen Login (`/login`)**:
   - Authenticates registered citizens using phone number and password.
4. **Admin Login (`/admin/login`)**:
   - Access point for Gram Pradhans, Panchayat Officers, and System Administrators.
5. **Citizen Dashboard (`/dashboard/user`)**:
   - Profile management, document uploads (Aadhaar, Marksheet, PAN Card, Voter ID, etc.), application tracking, and notifications.
6. **Admin Dashboard (`/dashboard/admin`)**:
   - Approval of posted jobs, document verification (Verify / Reject with reason), citizen search, analytics export.

---

## 3. Machine-Readable API Endpoints
- `GET /api/jobs` — Retrieve active job listings with filter parameters `search`, `category`, `district`.
- `POST /api/auth/register` — Citizen registration payload.
- `POST /api/auth/login` — Session creation payload.
- `GET /api/documents` — List user uploaded documents.
- `POST /api/documents/upload` — Upload document payload with multipart/form-data (`file`, `documentType`, `customDocumentName`).
- `GET /api/documents/:id/download` — Secure file retrieval stream.

---

## 4. Accessibility & Machine Readability Guarantees
- All interactive controls are standard `<button>` or `<a>` elements with explicit text or `aria-label`.
- All form inputs feature matching `<label htmlFor="...">`, explicit `name`, `autocomplete`, and `id`.
- Navigation menus provide `aria-expanded` and `aria-controls` for accessibility trees.