403b94fa2c
Backend: rate limiter, security headers, blockchain cache service avec RPC, public API (7 endpoints read-only), WebSocket auth + heartbeat, DB connection pooling, structured logging, health check DB. Frontend: API retry/timeout, WebSocket auth + heartbeat + typed events, notifications toast, mobile hamburger + drawer, error boundary, offline banner, loading skeletons, dashboard enrichi. Documentation: guides utilisateur complets (demarrage, vote, sanctuaire, FAQ 30+), guide deploiement, politique securite. 123 tests, 155 fichiers. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8.1 KiB
title, description
| title | description |
|---|---|
| Premiers pas | Connexion et prise en main de Glibredecision |
Premiers pas
Ce guide vous accompagne de votre premiere visite jusqu'a votre premier vote sur Glibredecision.
Prerequis
Avant de commencer, assurez-vous de disposer de :
| Prerequis | Description | Ou l'obtenir |
|---|---|---|
| Navigateur moderne | Chrome, Firefox, Edge ou Safari a jour | Mis a jour automatiquement |
| Extension Polkadot.js | Extension de signature pour Substrate/Duniter V2 | polkadot.js.org/extension |
| Identite Duniter V2 | Adresse SS58 avec une identite confirmee dans la Toile de Confiance | Via Cesium2 ou directement sur la blockchain Duniter V2 |
::callout{type="info"} Vous pouvez consulter les documents, decisions et resultats de vote sans aucune authentification. Seules les actions de participation (voter, proposer, creer) necessitent une identite Duniter. ::
Installer l'extension Polkadot.js
- Rendez-vous sur polkadot.js.org/extension.
- Installez l'extension pour votre navigateur (Chrome ou Firefox).
- Creez ou importez votre compte Duniter V2 dans l'extension.
- Assurez-vous que votre adresse SS58 est bien celle liee a votre identite Duniter.
Qui peut utiliser Glibredecision ?
Glibredecision est ouvert a tous les membres de la Toile de Confiance (WoT) Duniter V2. Pour utiliser pleinement la plateforme, vous devez posseder une identite Duniter avec une adresse SS58 valide.
- Consultation : tout visiteur peut consulter les documents, decisions et resultats de vote.
- Participation (voter, proposer) : reservee aux membres authentifies via leur identite Duniter.
Premiere connexion
La connexion utilise votre identite Duniter sans jamais transmettre votre cle privee. Le mecanisme est un challenge-response cryptographique :
Comment ca marche (en termes simples)
Imaginez que la plateforme vous montre une phrase aleatoire et vous demande de la signer avec votre cle privee. C'est comme signer un document avec un stylo que vous seul possedez. La plateforme peut verifier que c'est bien votre signature grace a votre cle publique, sans jamais voir votre cle privee.
Etape par etape
- Cliquez sur Se connecter dans la barre de navigation.
- Saisissez votre adresse Duniter (format SS58, par exemple
5GrwvaEF...). - La plateforme vous envoie un challenge : un texte aleatoire de 64 caracteres hexadecimaux.
- Votre extension Polkadot.js (ou votre portefeuille Cesium) vous demande d'autoriser la signature du challenge avec votre cle privee Ed25519.
- Signez le challenge. Votre cle privee ne quitte jamais votre appareil.
- Soumettez la signature. La plateforme verifie que vous etes bien le proprietaire de l'adresse.
- Vous etes connecte. Un jeton de session est stocke localement (valable 24 heures).
::callout{type="tip"} Votre cle privee n'est jamais transmise au serveur. Seule la signature du challenge est envoyee. C'est le principe fondamental de l'authentification par challenge-response Ed25519. ::
Tour de l'interface
Barre de navigation
La barre de navigation en haut de page contient :
- Logo Glibredecision : retour a l'accueil
- Menu principal : acces aux cinq sections
- Bouton de connexion / Votre profil (si connecte)
- Indicateur temps reel : point colore indiquant l'etat de la connexion WebSocket
Sidebar (menu lateral)
La sidebar sur la gauche donne acces aux cinq sections principales :
| Section | Icone | Description |
|---|---|---|
| Documents | -- | Documents de reference de la communaute |
| Decisions | -- | Processus decisionnels en cours et archives |
| Votes | -- | Sessions de vote actives et resultats |
| Mandats | -- | Mandats attribues aux membres |
| Sanctuaire | -- | Archives immuables (IPFS + blockchain) |
Dashboard (tableau de bord)
Apres connexion, le tableau de bord affiche un apercu rapide de :
- Votes en cours : les sessions de vote ouvertes auxquelles vous pouvez participer
- Vos derniers votes : historique de vos votes recents
- Decisions actives : les processus decisionnels en cours
- Mandats : les mandats actifs et en cours d'election
- Activite recente : flux des dernieres actions sur la plateforme
Votre profil
Apres connexion, votre profil affiche :
- Votre adresse Duniter SS58
- Votre nom d'affichage (si configure)
- Votre statut WoT : membre, en attente, revoque
- Vos roles : membre Smith (forgeron) et/ou membre du Comite Technique
Ces informations sont synchronisees depuis la blockchain Duniter V2 et determinent vos droits de vote.
Premier vote : voter sur un item de document
Voici comment participer a votre premier vote en quelques minutes :
1. Trouver un vote ouvert
- Depuis le tableau de bord, consultez la section Votes en cours.
- Ou rendez-vous dans la section Votes du menu et filtrez par statut "En cours".
- Les sessions ouvertes sont signalees par un badge vert.
2. Lire le sujet
- Cliquez sur la session de vote qui vous interesse.
- Lisez attentivement le texte soumis au vote (document, decision, modification d'item).
- Consultez le diff si c'est une modification : les ajouts sont en vert, les suppressions en rouge.
3. Voter
- Vote binaire : cliquez sur Pour (vert) ou Contre (rouge).
- Vote nuance : choisissez un niveau de 0 (CONTRE) a 5 (TOUT A FAIT) sur l'echelle proposee.
- Ajoutez un commentaire si vous souhaitez expliquer votre choix (optionnel mais recommande).
4. Signer votre vote
- Apres avoir choisi, la plateforme genere un payload contenant votre vote, l'identifiant de la session et un horodatage.
- Votre extension Polkadot.js vous demande de signer ce payload.
- Signez, puis cliquez sur Soumettre.
5. Verification
- Un message de confirmation apparait.
- Votre vote est visible dans la liste des votes de la session.
- La jauge de seuil se met a jour en temps reel pour refleter votre vote.
::callout{type="info"} Vous pouvez modifier votre vote a tout moment tant que la session est ouverte. L'ancien vote est conserve pour l'audit mais seul le dernier compte. ::
Premiers pas avec les decisions
Au-dela du vote, vous pouvez participer activement a la gouvernance :
Proposer une modification de document
- Ouvrez un document de reference dans la section Documents.
- Selectionnez l'item (clause, regle, article) que vous souhaitez modifier.
- Cliquez sur Proposer une modification.
- Redigez votre nouveau texte et justifiez votre proposition.
- Soumettez : un diff est genere automatiquement.
Votre proposition sera examinee et soumise au vote par la communaute.
Creer une decision
- Rendez-vous dans la section Decisions.
- Cliquez sur Nouvelle decision.
- Renseignez le titre, la description et le contexte.
- Choisissez le type de decision et le protocole de vote.
- Definissez les etapes du processus.
Consulter le Sanctuaire
Le Sanctuaire contient les archives immuables de toutes les decisions adoptees, documents archives et resultats de vote. Rendez-vous dans la section Sanctuaire pour explorer l'historique verifiable de la communaute.
Deconnexion
Cliquez sur votre profil puis Se deconnecter. La session est invalidee cote serveur et le jeton local est supprime.
Pour aller plus loin
| Guide | Description |
|---|---|
| Documents | Tout savoir sur les documents de reference et leurs modifications |
| Decisions | Comprendre les processus decisionnels multi-etapes |
| Vote | Comprendre les types de vote, la formule de seuil et le simulateur |
| Mandats | Elections et responsabilites au sein de la communaute |
| Sanctuaire | Archivage immuable et verification d'integrite |
| FAQ | Reponses aux questions frequentes |