Files

T

YvvandClaude Opus 5.5 a57a1ff642 v3 : inertie à cinq crans — ADR 0007, chantier, contrôles

ADR 0007 : les cinq crans, M_k et s_k, G_k déduit à la participation
habituelle ; la médiane (propositions votées dans l'année, au moins 5,
T compté à la mesure), la référence 2C/W, les bornes [1 %, 50 %], le
recalcul une fois par jour, l'héritage de l'inertie de l'inertie,
l'arrondi stable, la migration et l'amendement de E1 et E2, ce que ça
coûte (seuils comparés à ceux d'avant). L'ADR 0002 le note ; index.

CHANTIER.md : la table des crans et « l'inertie se vote aussi » au cran
de l'article. CLAUDE.md : l'invariant devient « hérite du cran de
l'article ». CONTROLES.md : C4, M1, et C20 « réglages de la formule et
cinq crans ». README, note de source du seed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-30 17:24:48 +01:00

7.1 KiB

Raw Blame History

libreDecision

Rendre possible la décision collective — en fonction du contexte, processus et modalités, boîte à outils. v3 : Rust + Svelte, un chantier à la fois, chacun livré en production avant le suivant (docs/chantiers/README.md). Référence du chantier en cours : docs/chantiers/acte-certification/CHANTIER.md — toute décision de comportement s'y adosse ; les décisions durables dans docs/adr/. La maquette v2 (Nuxt + FastAPI) vit dans maquette/, intacte (Yvv la présente) — ne pas y développer.

Protocole de début de session

git pull --rebase origin main (puis la branche du chantier : chantier/acte-certification)
Lire HANDOFF.md (où on en est, ce qui attend Yvv)
Si l'objectif de la session n'est pas précisé, le demander

Stack

Serveur : Rust edition 2024, toolchain 1.99 épinglée (rust-toolchain.toml) ; rustup installé sans PATH → export PATH=$HOME/.cargo/bin:$PATH. axum 0.8, sqlx 0.8 (SQLite, requêtes runtime + migrate!), tokio, reqwest rustls.
Interface : SvelteKit 2 / Svelte 5 (runes), adapter-static SPA, vite 7, vitest, Playwright ; npm. Polices Literata (textes) + Nunito (interface), fontsource.
Ports : dev interface 3002 (strict, proxy /api → 8002) · serveur 8002 · serveur jetable des e2e 8092.
Déploiement : une image (docker/app.Dockerfile), Woodpecker ci.open.us.org dépôt LPK/decision → sonic (fabio). .woodpecker/app.yml = le produit sur decision.librodrome.org ; .woodpecker/maquette.yml = la maquette sur maquette.decision.librodrome.org (le produit passe en premier et retire de la racine tout conteneur qui la revendique ; la maquette attend un déploiement réussi du produit). Push sur prod (gitea@git.open.us.org:EHV/decision.git) branche main = déploiement.

Structure

crates/
  ld-engine/        # PUR (zéro I/O) : threshold (formule inertielle), inertia (cinq crans, médiane,
                    # référence, échelle), edit (coquille vs fond, diff), assist (découpage, similarité,
                    # longueur), compose (adoption, aperçus)
  trustin-access/   # règles d'accès de trustinWallet : sees / opens / manages_access, groupes par défaut
  ld-server/
    migrations/     # schéma SQLite — additif seulement
    src/            # lib.rs (routes, csrf, run) · config.rs (LD_*) · auth.rs (connect OAuth2, invitations,
                    # dev, bootstrap) · team.rs (liens d'équipe) · docs.rs (lecture, aperçus) · proposals.rs (écrire, voter, signaler,
                    # traduire) · adoption.rs (balayage, verrou) · participation.rs (p̃, une fois par
                    # jour) · publish.rs (file → git) · wot.rs (W sur la chaîne) · seed.rs ·
                    # seed_amend.rs / inertia_amend.rs (amendements gardés) · web.rs (sert web/build)
    tests/api.rs    # scénarios bout en bout
seeds/              # acte-engagement-certification.json (trilingue, 33 articles, I1/E1/E2 en vigueur ;
                    # inertie 3, E1/E2 à 4)
                    # upcoming/<groupe>.json : les « À venir » des outils d'un groupe (fr, en, es), lus au démarrage
web/src/
  lib/i18n/         # fr.ts SOURCE (types Key) · en.ts · es.ts — parité testée
  lib/components/   # Sidebar, DocPanel, VoteView, ProposeView, UnitBlock, DeepList, Seal, Logo, Pillars…
  routes/           # / (accueil + choix du groupe) · connexion · invitation · equipe · g/[group] (piliers, en cours) ·
                    # g/[group]/docs · g/[group]/docs/[doc] (lecteur,
                    # panneau dans l'URL ?onglet=&article=) · g/[group]/decisions · g/[group]/mandats ·
                    # g/[group]/protocoles (à venir) · acces (trustinWallet) ; /groupes, /decisions… redirigent
web/e2e/            # Playwright C1–C20 + M1 ; serve.sh = serveur jetable /tmp/ld-e2e sur :8092
docker/             # app.Dockerfile · app-compose.yml (sonic)
.woodpecker/        # app.yml · maquette.yml
docs/               # chantiers/ · adr/ · dev/BLUEPRINT-V2.md (doctrine de la maquette) · recherche/
maquette/           # v2 intacte (frontend Nuxt, backend FastAPI, docker, docs-v1)

Données runtime — jamais écrasées

Production : volume lpk-libredecision-app_data (/data : libredecision.db, textes/ = clone du dépôt publié, keys/ = clé de publication, bootstrap-admin.txt). Jamais down -v, jamais recréé.
Maquette : volumes lpk-decision-main_postgres-data / _ipfs-data (inchangés).
Local : data/ (gitignoré) — le supprimer repart du seed. Les e2e utilisent /tmp/ld-e2e.
Un document seedé n'est jamais réinstancié : dès qu'il existe en base, c'est de la donnée.

Commandes — la boucle (tout vert = fait)

export PATH=$HOME/.cargo/bin:$PATH
cargo fmt --all --check && cargo clippy --workspace --all-targets -- -D warnings && cargo test --workspace
cd web && npm run check && npm test && npm run build && npm run e2e     # e2e : 21 contrôles

LD_DEV_LOGIN=1 cargo run -p ld-server     # :8002, sert web/build
cd web && npm run dev                     # :3002 à chaud
docker build -f docker/app.Dockerfile --target production .   # rejoue toute la boucle

Conventions / pièges

UI français, code anglais ; trilingue : aucune chaîne affichée en dur, tout passe par web/src/lib/i18n/fr.ts puis en/es (test de parité + FORBIDDEN_UI_TERMS). Tutoyer ; le sujet est la personne ou le groupe, jamais le système. Le français du texte voté fait foi.
Moteur pur : une règle de vote / édition / composition s'écrit et se teste dans ld-engine avant d'être câblée. Le serveur ne décide jamais l'accès seul : trustin-access.
Invariants : une seule voix ne fait jamais passer un texte (C = 50 pour Monnaie libre) ; une coquille ne demande pas de vote, un changement de fond si ; un signalement de contradiction bloque ; l'inertie de l'inertie hérite du cran de l'article (cinq crans, ADR 0007) ; le groupe d'essai ne publie jamais.
Écritures : en-tête x-requested-with: libredecision obligatoire (CSRF) ; cookie ld_session. Les tests d'API passent par Client (tests/api.rs).
Pièges vus : pkill -f target/debug/ld-server tue son propre shell → pkill -x ld-server ; un from_secret absent fait refuser tout le pipeline Woodpecker ; la route hôte /* de fabio masque le webroot ACME → arrêter le service avant acme.sh --issue ; Playwright en locale fr-FR (sinon l'interface part en anglais).
Design : sans bordures, arrondis 16/12/20/14, quatre ambiances pierre, calcaire (claires), nuit, ardoise (sombres) (data-mood, posé avant le premier rendu, clé ld:mood), logo « Clé de voûte » (Logo, jamais incliné, --cle par ambiance), sceau hexagramme 井 #48 en SVG (Seal — jamais le glyphe, qui s'affiche mal). Mouvement réduit respecté.
Domaine : decision.librodrome.org ; dépôt des textes git.open.us.org/yvv/decision-depot-textes-reference (provisoire : puis un dépôt pour l'ouverture, puis le dépôt officiel pour les textes en vigueur).

7.1 KiB Raw Blame History Unescape Escape