Copy page

Guide Développeur

Installation & Démarrage Local

📋 Prérequis

• Node.js ≥ 20 (version LTS recommandée).
• pnpm 8 / 9 (corepack enable pnpm).
• Docker & Docker Compose (pour démarrer PostgreSQL 16 et Redis 7).
• (Facultatif) poppler-utils (commande pdftotext) pour extraire les comptes rendus PDF de l'Assemblée nationale.

---

⚡ Installation Pas à Pas

1. Cloner & Installer

Code
git clone https://github.com/accelaire/CLAIR.git
cd CLAIR
pnpm install

2. Variables d'Environnement

Code
cp .env.example .env

# Créer les liens symboliques vers les paquets concernés
ln -s ../../.env apps/api/.env
ln -s ../../.env services/ingestion/.env

3. Démarrer les Services & Base de Données

Code
# Lancer PostgreSQL 16 et Redis 7
pnpm docker:up

# Générer le client Prisma
pnpm db:generate

# Pousser le schéma dans la base locale
pnpm db:push

4. Lancer l'Application

Code
# Lancer le Web (:3000), l'API (:3001) et la Docs (:3002)
pnpm dev

# Ou lancer uniquement la documentation sur le port 3002
pnpm dev:docs

---

🗃️ Peupler la Base de Données

Une fois le schéma appliqué, votre base PostgreSQL locale est initialement vierge :

Code
# Option A : Insérer un jeu d'échantillons minimal pour tester l'UI
pnpm db:seed

# Option B : Synchroniser un échantillon réel depuis les sources Open Data
pnpm --filter @clair/ingestion build
pnpm ingestion:sync -p                  # Télécharge les députés et sénateurs
pnpm ingestion:sync -s -l 50            # Télécharge 50 scrutins récents

---

🔍 Points de Contrôle

• Frontend Web : http://localhost:3000
• API REST & Swagger : http://localhost:3001/docs
• Santé de l'API : http://localhost:3001/health
• Portail de Documentation (Zudoku) : http://localhost:3002