Plateforme & Guide

Plateforme, Guide & API

CLAIR (Citoyen Libre, Analyse, Information, République) rapproche les citoyens du travail parlementaire français : parlementaires, scrutins, dossiers législatifs, débats, commissions, lobbying, avec des visualisations, des synthèses et une API ouverte.


📑 Sommaire de la section


🏢 Organisation du monorepo

Monorepo pnpm géré par Turborepo. Quatre workspaces portent le code ; les deux paquets de packages/ sont aujourd'hui des coquilles vides.

Code
CLAIR/ ├── apps/ │ ├── web/ # Frontend Next.js 14 (App Router), clair.vote, hébergé sur Vercel │ └── api/ # API Fastify + Prisma, lecture seule, api.clair.vote, hébergée sur Railway │ └── prisma/ # schema.prisma (source de vérité du modèle), migrations, triggers, seed ├── services/ │ └── ingestion/ # CLI d'ingestion : sources publiques → PostgreSQL, │ # rattachements, statistiques, enrichissement IA ├── docs/ # Cette documentation (Zudoku), docs.clair.vote ├── packages/ │ ├── config/ # Vide (module.exports = {}) │ └── shared/ # Vide (export {}) ├── scripts/ # Scripts ponctuels (audits, logos de groupes, géographie) ├── Dockerfile # Image de l'API ├── docker-compose.yml # PostgreSQL + Redis pour le développement local └── .github/workflows/ # CI (lint, tests, build)

La plateforme n'a ni comptes utilisateurs, ni authentification : l'API est publique et en lecture seule. La seule écriture publique est l'envoi d'un retour anonyme (POST /api/v1/feedback).


🗺️ Pages du site

RouteContenu
/Accueil
/deputes, /deputes/[slug], /deputes/comparerDéputés : liste, fiche, comparateur
/senateurs, /senateurs/[slug], /senateurs/comparerSénateurs : liste, fiche, comparateur
/groupes, /groupes/[chambre]/[slug]Groupes politiques de l'Assemblée et du Sénat
/scrutins, /scrutins/[numero]Scrutins publics des deux chambres
/votes, /votes/[year], /votes/[year]/[month]Archives des scrutins, par année et par mois
/dossiers, /dossiers/[uid]Dossiers législatifs
/sujets, /sujets/[slug]Sujets : regroupement des dossiers AN et Sénat portant sur le même texte
/commissions, /commissions/[slug]Commissions et organes
/agenda, /reunions/[uid]Agenda parlementaire, réunions et séances
/lobbying, /lobbying/[id], /lobbying/actionsReprésentants d'intérêts et actions déclarées (HATVP)
/senatoriales-2026, /senatoriales-2026/[departement], /senatoriales-2026/graphiques/[slug]Élections sénatoriales 2026 : bilan des sortants, candidats, résultats
/classementsClassements des parlementaires
/explorateurExplorateur de données
/rechercheRecherche globale
/apiPrésentation de l'API publique
/comprendre/*Pages pédagogiques (Parlement, parlementaire, scrutin, dossier législatif, commissions, groupes, lobbying)
/guide/*Guides d'usage
/methodologieMéthodologie des statistiques et de l'IA
/soutenirDons (formulaire HelloAsso intégré)
/a-propos, /contact, /cgu, /confidentialite, /mentions-legalesPages institutionnelles