Swipez le programme. Mesurez l'adhésion populaire.
Scrutinder est une application civique de type Tinder qui permet aux citoyens d'évaluer les 837 mesures du programme politique L'Avenir en Commun (LFI / Mélenchon 2027) - un swipe à la fois. Les comptages de votes sont agrégés en temps réel, chiffrés localement, et vérifiables par tous grâce à un hash d'intégrité public SHA-256.
Le nom est un mot-valise composé de scrutin et de Tinder.
Chaque session présente un tirage aléatoire de 8 mesures issues du programme complet. Swipez - ou appuyez sur un bouton - pour exprimer votre vote :
| Geste | Direction | Signification |
|---|---|---|
| ♥ | Swipe droite | Pour - je soutiens cette mesure |
| ✕ | Swipe gauche | Contre - je m'y oppose |
| ★ | Swipe haut | Prioritaire - je soutiens ET c'est urgent |
| … | Swipe bas | À discuter - j'ai besoin de plus d'informations |
| ? | Bouton | Incompris - je ne comprends pas cette mesure |
Après 8 swipes, vous consultez les résultats agrégés de toutes les mesures sous forme de tableau triable, accompagnés d'un hash SHA-256 du décompte des votes - pour que chacun puisse vérifier que les chiffres n'ont pas été altérés.
- Pas de compte, pas d'e-mail. L'identité repose sur un passkey WebAuthn et une graine de 32 octets générée localement, stockée uniquement dans votre navigateur.
- Les votes sont chiffrés côté client (AES-GCM, clé dérivée de votre graine) avant d'être envoyés au serveur. Le serveur stocke des enveloppes chiffrées, pas les choix en clair.
- Votre identifiant (
sc_<hex32>) est dérivé desha256(seed)- il est impossible de le remonter jusqu'à vous. - Le serveur reçoit : un identifiant de mesure, un libellé de choix, un pseudonyme de votant (optionnel) et une enveloppe chiffrée. Rien d'autre.
| Couche | Choix |
|---|---|
| Framework | Next.js 15 (App Router) + TypeScript |
| Style | Tailwind CSS |
| Animations | Framer Motion (physique de swipe) |
| Auth | WebAuthn passkeys - @simplewebauthn/server + @simplewebauthn/browser |
| Base de données | Prisma + PostgreSQL (Neon serverless) |
| Déploiement | Vercel |
- Node.js 18+
- Une base de données PostgreSQL Neon (le niveau gratuit suffit)
- Un navigateur compatible WebAuthn (Chrome, Safari, Firefox - nécessite
localhostou HTTPS)
git clone <repo-url> scrutinder
cd scrutinder
npm installcp .env.example .envÉditez .env :
# Chaîne de connexion Neon PostgreSQL
DATABASE_URL=postgresql://user:password@host/scrutinder?sslmode=require&connect_timeout=10
# Origine WebAuthn - doit correspondre exactement à ce qui apparaît dans la barre d'adresse du navigateur
WEBAUTHN_RP_ID=localhost
WEBAUTHN_ORIGIN=http://localhost:3000npm run db:generate # générer le client Prisma
npm run db:push # pousser le schéma vers Neon (dev uniquement - utiliser db:migrate en prod)npm run dev # http://localhost:3000npm run dev # Serveur de développement Next.js
npm run build # Build de production
npm start # Serveur de production
npm run typecheck # tsc --noEmit (à exécuter avant chaque commit)
npm run db:generate # Regénérer le client Prisma après des changements de schéma
npm run db:push # Synchroniser le schéma avec la DB (dev)
npm run db:migrate # Créer une migration nommée (production)
npm run db:studio # Ouvrir Prisma Studio (navigateur visuel de DB)scrutinder/
├── app/
│ ├── page.tsx # Accueil - onboarding ou tableau de bord
│ ├── swipe/page.tsx # Deck de swipe
│ ├── programme/page.tsx # Lecteur de programme (19 chapitres)
│ ├── resultats/page.tsx # Résultats en direct + hash d'intégrité
│ └── api/ # Gestionnaires de routes
│ ├── auth/ # WebAuthn register + authenticate
│ ├── measures/ # GET - retourne toutes les mesures
│ ├── program/ # GET - retourne tous les chapitres
│ ├── vote/ # POST - enregistre un vote
│ ├── vote/undo/ # POST - annule le dernier vote
│ └── results/ # GET - comptages agrégés + hash
├── components/ # Composants React UI
├── context/
│ └── IdentityContext.tsx # Machine à états d'authentification
├── lib/
│ ├── identity.client.ts # Navigateur : localStorage + chiffrement AES-GCM
│ ├── identity.server.ts # Serveur : helpers @simplewebauthn
│ ├── db.ts # Singleton Prisma
│ ├── measures.ts # Chargeur de données statiques
│ └── crypto.ts # Hash SHA-256 des votes
├── data/
│ ├── measures.json # 837 mesures politiques (IDs entiers stables)
│ └── program.json # 19 chapitres du programme
├── prisma/
│ └── schema.prisma # Vote, WebAuthnCredential, WebAuthnChallenge
├── types/index.ts # Types TypeScript partagés
├── BACKLOG.md # Suivi des tâches phase par phase
├── AGENTS.md # Rôles des agents IA et guide de coordination
└── CLAUDE.md # Référence rapide développeur/agent
Tous les endpoints sont sous /api.
| Méthode | Chemin | Description |
|---|---|---|
GET |
/api/measures |
Retourne le tableau complet des mesures |
GET |
/api/program |
Retourne tous les chapitres du programme |
POST |
/api/vote |
Enregistre un vote { id, choice, voterId?, encryptedVote? } |
POST |
/api/vote/undo |
Supprime le vote correspondant le plus récent |
GET |
/api/results |
Comptages agrégés des votes + hash SHA-256 |
POST |
/api/auth/register/generate-options |
Démarre l'enregistrement d'un passkey |
POST |
/api/auth/register/verify |
Vérifie et stocke le nouveau credential |
POST |
/api/auth/authenticate/generate-options |
Démarre l'authentification par passkey |
POST |
/api/auth/authenticate/verify |
Vérifie l'authentification |
model Vote {
id String // cuid
measureId Int // FK vers l'id dans measures.json
choice String // pour | contre | discuter | prioritaire | incompris
voterId String? // sc_<hex32> identifiant d'identité (optionnel)
encryptedVote Json? // enveloppe chiffrée AES-GCM
createdAt DateTime
}
model WebAuthnCredential {
credentialId String // unique, base64url
userId String // sc_<hex32>
publicKey String // clé publique CBOR, base64url
counter BigInt // protection contre les attaques par rejeu
...
}
model WebAuthnChallenge {
challenge String // unique, base64url - TTL 60s
userId String?
expiresAt DateTime
}Note : Les valeurs de
measureIdsont stables - elles ne doivent jamais être renumérotées, car elles sont utilisées comme clés étrangères dans la tableVote.
- Poussez vers GitHub et connectez le dépôt à Vercel
- Ajoutez les variables d'environnement dans le tableau de bord Vercel :
DATABASE_URL → votre chaîne de connexion Neon (avec ?connect_timeout=10) WEBAUTHN_RP_ID → votre domaine (ex. scrutinder.fr) WEBAUTHN_ORIGIN → https://scrutinder.fr - Exécutez la migration de production une fois :
npx prisma migrate deploy
- Déployez - Vercel détecte Next.js automatiquement.
WebAuthn nécessite HTTPS. Les passkeys ne fonctionnent pas sur
http://simple, sauf surlocalhost.
| Phase | Statut | Objectif |
|---|---|---|
| 1 - Fondation | ✅ Terminée | Next.js + Prisma + WebAuthn + parité fonctionnelle avec le prototype |
| 2 - Finition UX | 🔵 Suivante | Réglage Framer Motion, PWA, zones sécurisées mobiles, accessibilité |
| 3 - Communauté | 🔵 Planifiée | Fils de discussion sur les mesures débattues, boîte à idées, vue admin |
| 4 - Production | 🔵 Planifiée | Déploiement Vercel, domaine personnalisé, Sentry, tests de charge |
| 5 - Web3 | ⏸ Reportée | Ancrage des votes sur Polkadot Bulletin Chain, page de vérification publique |
Voir BACKLOG.md pour la liste détaillée des tâches.
Voir AGENTS.md pour l'architecture de coordination des agents IA et CLAUDE.md pour les commandes développeur et les invariants clés.
Règle sur les dépendances : toutes les dépendances de production sont épinglées à des versions exactes. Lors de l'ajout d'un package, lisez toujours les définitions de types installées avant d'écrire les sites d'appel, puis épinglez la version. Exécutez npm run typecheck avant de committer.
MIT