---
title: Documentation technique
description: Architecture, API et reference technique de libreDecision
---

# Documentation technique

Bienvenue dans la documentation technique de libreDecision, la plateforme de decisions collectives pour la communaute Duniter/G1.

## Presentation

libreDecision est une plateforme de gouvernance decentralisee qui permet aux membres de la Toile de Confiance (WoT) Duniter V2 de gerer des documents de reference modulaires sous vote permanent, prendre des decisions collectives multi-etapes, attribuer des mandats et archiver de maniere immuable les resultats via IPFS et la blockchain Duniter.

## Stack technique

| Couche       | Technologie                                        |
| ------------ | -------------------------------------------------- |
| Frontend     | Nuxt 4 + Nuxt UI v3 + Pinia + UnoCSS              |
| Backend      | Python FastAPI + SQLAlchemy 2.0 (async) + Pydantic v2 |
| Base de donnees | PostgreSQL 16 (asyncpg)                         |
| Authentification | Duniter V2 Ed25519 challenge-response          |
| Sanctuaire   | IPFS (kubo) + hash on-chain (system.remark)        |
| CI/CD        | Woodpecker CI + Docker + Traefik                   |
| Temps reel   | WebSocket pour les mises a jour de vote en direct  |

## Historique des sprints

| Sprint | Contenu principal | Statut |
| ------ | ----------------- | ------ |
| Sprint 1 | Architecture, modeles de base (documents, items, versions, identites, protocoles, formules), API documents et authentification | Termine |
| Sprint 2 | Sanctuaire (IPFS + on-chain), gestion complete des items (CRUD, reorder), verification d'integrite, archivage de documents | Termine |
| Sprint 3 | Systeme de vote complet (sessions, votes signes, seuil WoT, criteres Smith/TechComm), meta-gouvernance, simulateur de formules, WebSocket temps reel | Termine |
| Sprint 4 | Decisions multi-etapes (workflow, avancement, vote lie), mandats (candidature, election, assignation, revocation), vote nuance | Termine |
| Sprint 5 | Stabilisation, documentation complete, deploiement production, audit securite | En cours |

## Version et statut

- **Version** : 1.0.0-rc
- **Statut** : Release candidate -- Sprint 5 (documentation et stabilisation)
- **Depot** : [git.duniter.org/tools/libredecision](https://git.duniter.org/tools/libredecision)

## Sections

### Architecture et conception

- [Architecture](/dev/architecture) -- Vue d'ensemble de l'architecture, stack, flux de communication

### Reference technique

- [Reference API](/dev/api-reference) -- Tous les endpoints REST et WebSocket avec schemas
- [Schema de base de donnees](/dev/database-schema) -- Tables, colonnes, relations et diagramme

### Domaines fonctionnels

- [Formules](/dev/formulas) -- Formules mathematiques de seuil WoT, criteres Smith/TechComm, simulateur, meta-gouvernance
- [Integration blockchain](/dev/blockchain-integration) -- Duniter V2 RPC, IPFS, ancrage on-chain

### Operations

- [Deploiement](/dev/deployment) -- Docker, Traefik, migrations, sauvegarde, mise a jour, troubleshooting
- [Securite](/dev/security) -- Authentification, integrite des votes, rate limiting, en-tetes, audit

### Contribution

- [Guide de contribution](/dev/contributing) -- Installation locale, conventions, tests, processus de contribution
