Commandes CLI & Scripts d'Ingestion

🛠️ Scripts Principaux du Monorepo

Code
# Lancer tous les modules (Web :3000, API :3001, Docs :3002)
pnpm dev

# Lancer des modules spécifiques
pnpm dev:web
pnpm dev:api
pnpm dev:docs

# Base de données
pnpm db:generate
pnpm db:push
pnpm db:seed
pnpm db:studio

# Docker
pnpm docker:up
pnpm docker:down
pnpm docker:logs

⚙️ La CLI d'Ingestion (@clair/ingestion)

Point d'entrée : services/ingestion/src/cli.ts. Raccourcis disponibles depuis la racine du dépôt :

Code
pnpm ingestion:sync ...              # Synchronisation manuelle ciblée
pnpm ingestion:smart-sync ...        # Synchronisation avec suivi de fraîcheur (ETag)
pnpm ingestion:status                # Affichage de l'état et de la fraîcheur des 22 sources
pnpm ingestion:calculate-stats       # Recalcul des statistiques des parlementaires et groupes
pnpm ingestion:backfill              # Rapprochements rétroactifs
pnpm ingestion:schedule              # Planificateur de tâches local

🚀 Options de smart-sync (Batch Nocturne)

Code
# Exécution complète dans l'ordre de production
pnpm ingestion:smart-sync -a

# Forcer le re-téléchargement sans tenir compte des ETags
pnpm ingestion:smart-sync -a --force

# Exécution sans recalculer les statistiques globales
pnpm ingestion:smart-sync -a --skip-stats

# Limiter le nombre d'éléments par ressource (mode test rapide)
pnpm ingestion:smart-sync -a -l 50

# Synchroniser uniquement des clés spécifiques
pnpm ingestion:smart-sync --sources senat:agenda,senat:videos

🎯 Options de sync (Synchronisation Manuelle Ciblée)

Filtres de chambre : --an (Assemblée nationale), --se (Sénat).

Code
# Parlementaires
pnpm ingestion:sync -p                      # Députés + sénateurs actifs
pnpm ingestion:sync -p --an --legislature 16 # Députés d'une législature passée

# Scrutins & Votes
pnpm ingestion:sync -s                      # Scrutins récents
pnpm ingestion:sync -s --an --legislature 16
pnpm ingestion:sync -s --se --sessions 2024,2025

# Amendements & Dossiers
pnpm ingestion:sync --am                    # Amendements
pnpm ingestion:sync --do                    # Dossiers législatifs

# Rapprochement Scrutins vers Amendements
pnpm ingestion:sync --am --enrich           # Scraping des scrutins sans amendement
pnpm ingestion:sync --am --link             # Rapprochement par numéro avec contrainte dossier

# Lobbying HATVP
pnpm ingestion:sync --lo                    # Répertoire complet des représentants d'intérêts
pnpm ingestion:sync --de                    # Déclarations d'intérêts et de patrimoine des élus