# API Parlementaires, Députés & Sénateurs

## 👥 Endpoints Principaux

| Méthode | Route | Description |
| :--- | :--- | :--- |
| `GET` | `/api/v1/parlementaires` | Liste paginée de tous les parlementaires (Assemblée + Sénat) |
| `GET` | `/api/v1/deputes` | Liste filtrée sur les députés de l'Assemblée nationale |
| `GET` | `/api/v1/senateurs` | Liste filtrée sur les sénateurs |
| `GET` | `/api/v1/parlementaires/:slug` | Fiche détaillée d'un élu (biographie, mandats, stats, résumé IA) |
| `GET` | `/api/v1/parlementaires/:slug/votes` | Historique de vote d'un parlementaire avec filtres |
| `GET` | `/api/v1/parlementaires/:slug/amendements` | Amendements déposés et cosignés par l'élu |
| `GET` | `/api/v1/parlementaires/:slug/interventions` | Prises de parole en séance et en commission |
| `GET` | `/api/v1/parlementaires/compare` | Comparateur d'activité entre deux parlementaires |

---

## 🏛️ Filtres Supportés

- `chambre` : `assemblee` ou `senat`
- `groupe` : Slug du groupe politique (ex: `ensemble-pour-la-republique` ou `rassemblement-national`)
- `departement` : Numéro de département (ex: `78`, `75`, `2A`, `974`)
- `actif` : `true` (en exercice, défaut) ou `false` (anciens élus)
- `search` : Recherche textuelle sur le nom / prénom
- `sort` : Tri par `nom`, `prenom`, `presence`, `loyaute`, `activite`, `amendements`, `interventions`
- `order` : Ordre `asc` ou `desc` (défaut : `asc`)
- `periode` : `mandat` (défaut) ou `carriere`

---

## 📋 Exemple de Réponse JSON (`GET /api/v1/parlementaires/yael-braun-pivet`)

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "slug": "yael-braun-pivet",
  "nom": "Braun-Pivet",
  "prenom": "Yaël",
  "sexe": "F",
  "chambre": "assemblee",
  "actif": true,
  "groupe": {
    "id": "e5f6a7b8-c9d0-1234-ef56-7890abcdef12",
    "slug": "ensemble-pour-la-republique",
    "chambre": "assemblee",
    "nom": "EPR",
    "nomComplet": "Ensemble pour la République",
    "couleur": "#FFB300",
    "position": "centre"
  },
  "circonscription": {
    "id": "f0e1d2c3-b4a5-6789-0123-456789abcdef",
    "departement": "78",
    "numero": 5,
    "nom": "Yvelines",
    "type": "circonscription"
  },
  "stats": {
    "presence": 92,
    "presenceSolennel": 95,
    "loyaute": 98,
    "participation": 342,
    "interventions": 1420,
    "amendements": {
      "proposes": 12,
      "adoptes": 4
    },
    "questions": 8
  }
}
```