PAN-RAP Municipio v0.5
Système de vote anonyme avec intégrité cryptographique pour la gouvernance civique municipale. Blind Schnorr sur secp256k1, éligibilité modulaire HMAC, cycle de vie des convocations et génération de procès-verbaux PDF vérifiables.
Qu'est-ce que c'est
PAN-RAP (Planet Assembly Network / Red Asamblearia Planetaria) est un écosystème de gouvernance civique décentralisé conçu pour les municipalités de ~25 000 habitants. Ce dépôt est l'implémentation de référence du module de vote anonyme.
Stack :
- Backend : Python 3.12+ / FastAPI / coincurve (libsecp256k1)
- Frontend : Modules JavaScript ES / @noble/curves vendorisé (sans CDN)
- Crypto : Blind Schnorr sur secp256k1 (token 65 octets)
- BD : SQLite (WITHOUT ROWID sur l'urne)
- Licence : AGPL-3.0-or-later
Ce qu'il livre (Phase 5.5 terminée)
| Fonctionnalité | État | Détail |
|---|---|---|
| Moteur Blind Schnorr | ✅ | Émetteur (coincurve) + Urne (vérification fail-closed) + Frontend (@noble/curves) |
| Éligibilité modulaire | ✅ | 4 modes : recensement (HMAC), présentiel (codes à usage unique), parrainage (K parrainages), eid (placeholder) |
| Cycle de vie convocations | ✅ | Transitions validées : brouillon → programmée → émission → vote → close → scrutée → archivée |
| Scrutin public | ✅ | GET /convocatorias/{id}/escrutinio avec dépouillement, participation, hash de l'urne |
| Téléchargement urne complète | ✅ | GET /convocatorias/{id}/urna votes ordonnés par r_prima |
| Procès-verbal PDF | ✅ | POST /convocatorias/{id}/acta avec reportlab, seulement en état scrutée |
| Vérificateur indépendant | ✅ |
scripts/verificador_independiente.py audite l'urne complète |
| Tests | ✅ | 10 passed (3 éligibilité + 7 cycle de vie) |
Ce qu'il NE fait PAS encore
| Phase | État | En attente |
|---|---|---|
| Phase 6 | ⏳ | Audit cryptographique externe (Cure53, Trail of Bits, etc.) |
| Phase 7 | ⏳ | Déploiement pilote en municipalité réelle |
| Persistance états mémoire | ⏳ | Codes présentiel et parrainages perdus au redémarrage |
| Endpoint lister convocations | ⏳ | GET /convocatorias public pour découverte |
| Mode eid complet | ⏳ | Intégration OIDC / identité numérique nationale |
Note de transparence : Le projet est en Phase 5.5. Les tests passent (10/10), le moteur crypto est audité en interne, mais aucun audit externe n'a été réalisé. Non apte à un usage contraignant jusqu'à la Phase 6.
Comment l'essayer
# 1. Cloner et configurer
git clone https://github.com/amurlaniakea/pan-rap-municipio.git
cd pan-rap-municipio
python3.12 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt # inclut reportlab pour les PV PDF
# 2. Lancer les tests
pytest tests/ -v
# → 10 passed
# 3. Démarrer le serveur
export PANRAP_EMISOR_KEY_HEX="$(openssl rand -hex 32)"
fastapi dev main.py
# 4. Flux rapide (exemple mode recensement)
curl -X POST http://localhost:8000/convocatorias \
-H "Content-Type: application/json" \
-d '{"titulo":"Test","texto":"...","opciones":["a_favor","en_contra"],"modo_elegibilidad":"padron","nivel_garantia":"alta","emision_abre_en":"2026-11-01T00:00:00","voto_abre_en":"2026-11-02T00:00:00","cierra_en":"2026-11-03T00:00:00"}'
# → {"id": "uuid", "estado": "borrador"}
curl -X POST http://localhost:8000/convocatorias/{id}/censo \
-H "Content-Type: application/json" \
-d '{"identificadores": ["dni_123"]}'
curl -X PATCH http://localhost:8000/convocatorias/{id}/estado \
-H "Content-Type: application/json" \
-d '{"estado": "programada"}'
curl -X PATCH http://localhost:8000/convocatorias/{id}/estado \
-H "Content-Type: application/json" \
-d '{"estado": "emision"}'
# 5. Vérifier l'urne et générer le PV
python scripts/verificador_independiente.py
# → VÉRIFICATION RÉUSSIE : X votes valides, 0 invalides
Architecture de sécurité (résumé)
-
S1 Émission séquentielle :
threading.Lock()+ TTL 10s -
S4 Zéro arithmétique int sur secrets : seulement
coincurve -
S5
képhémère par session :PrivateKey()nouveau à chaqueinicio() -
S6 Validation fail-closed :
urna_schnorr.verificar()capture les exceptions -
S7 Clé hors git :
.gitignorecouvreclave_emisor.hex -
S8 Client vendorisé :
frontend/lib/avec@noble/curves(sans CDN) -
Éligibilité :
persona_ref = HMAC-SHA256(secreto_convocatoria, convocatoria:identifiant)— différent par convocation, non liable -
Secret persistant : stocké dans
convocatorias.secreto_hmac, jamais exposé dans les réponses HTTP
Références
- Repo : https://github.com/amurlaniakea/pan-rap-municipio
- README : https://github.com/amurlaniakea/pan-rap-municipio/blob/main/README.md
-
Docs :
docs/01-spec-v0.md,docs/03-motor-blind-schnorr.md -
Tests :
tests/test_elegibilidad.py,tests/test_ciclo_vida.py -
Frontend :
frontend/voto_schnorr.js,frontend/lib/noble/ -
Vérificateur :
scripts/verificador_independiente.py - Licence : AGPL-3.0-or-later (661 lignes verbatim GNU)
Auteur : Pedro Sordo Martínez
Licence : AGPL-3.0-or-later
Top comments (0)