---
title: Premiers pas
description: Connexion et prise en main de libreDecision
---

# Premiers pas

Ce guide vous accompagne de votre premiere visite jusqu'a votre premier vote sur libreDecision.

## 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](https://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

1. Rendez-vous sur [polkadot.js.org/extension](https://polkadot.js.org/extension/).
2. Installez l'extension pour votre navigateur (Chrome ou Firefox).
3. Creez ou importez votre compte Duniter V2 dans l'extension.
4. Assurez-vous que votre adresse SS58 est bien celle liee a votre identite Duniter.

## Qui peut utiliser libreDecision ?

libreDecision 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

1. Cliquez sur **Se connecter** dans la barre de navigation.
2. Saisissez votre **adresse Duniter** (format SS58, par exemple `5GrwvaEF...`).
3. La plateforme vous envoie un **challenge** : un texte aleatoire de 64 caracteres hexadecimaux.
4. Votre extension Polkadot.js (ou votre portefeuille Cesium) vous demande d'autoriser la signature du challenge avec votre cle privee Ed25519.
5. Signez le challenge. Votre cle privee ne quitte jamais votre appareil.
6. Soumettez la signature. La plateforme verifie que vous etes bien le proprietaire de l'adresse.
7. 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 libreDecision** : 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

1. Ouvrez un document de reference dans la section **Documents**.
2. Selectionnez l'item (clause, regle, article) que vous souhaitez modifier.
3. Cliquez sur **Proposer une modification**.
4. Redigez votre nouveau texte et justifiez votre proposition.
5. Soumettez : un diff est genere automatiquement.

Votre proposition sera examinee et soumise au vote par la communaute.

### Creer une decision

1. Rendez-vous dans la section **Decisions**.
2. Cliquez sur **Nouvelle decision**.
3. Renseignez le titre, la description et le contexte.
4. Choisissez le type de decision et le protocole de vote.
5. 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](/user/documents) | Tout savoir sur les documents de reference et leurs modifications |
| [Decisions](/user/decisions) | Comprendre les processus decisionnels multi-etapes |
| [Vote](/user/voting) | Comprendre les types de vote, la formule de seuil et le simulateur |
| [Mandats](/user/mandates) | Elections et responsabilites au sein de la communaute |
| [Sanctuaire](/user/sanctuary) | Archivage immuable et verification d'integrite |
| [FAQ](/user/faq) | Reponses aux questions frequentes |
