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>
66 lines
3.2 KiB
Markdown
66 lines
3.2 KiB
Markdown
---
|
|
title: Documentation technique
|
|
description: Architecture, API et reference technique de Glibredecision
|
|
---
|
|
|
|
# Documentation technique
|
|
|
|
Bienvenue dans la documentation technique de Glibredecision, la plateforme de decisions collectives pour la communaute Duniter/G1.
|
|
|
|
## Presentation
|
|
|
|
Glibredecision 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/glibredecision](https://git.duniter.org/tools/glibredecision)
|
|
|
|
## 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
|