Skip to content
DP-ADRSRelu · 2026-11-19Desktop 1.8 · Companion 1.1.1Read in English

Décisions et alternatives ​

Ces décisions décrivent les compromis du système actuel. Les modifier exige un nouvel enregistrement avec contexte, décision, alternatives, conséquences et preuve de validation. Un enregistrement remplacé reste lisible.

ADR-001 — Desktop portable, moteur local ​

Décision : Tauri pour l'enveloppe Windows, Node livré pour les calculs, HTML/CSS/JS pour l'interface. Pourquoi : conserver les données localement et partager les calculs entre application et harness. Alternative : service hébergé avec compte, qui ajoute synchronisation et exposition des données. Coût : runtime à distribuer, WebView2 requis, qualification Windows distincte.

ADR-002 — Lire les observations, laisser agir le joueur ​

Décision : SavedVariables lus comme données, exports manuels et transactions dans TSM. Alternative : automatiser les interactions de jeu. Conséquence : une actualisation ne force pas une sauvegarde WoW ; un import préparé n'est pas un import réalisé. Cette séparation est une limite produit assumée.

ADR-003 — Inconnu reste inconnu ​

Décision : ne pas déduire une vente d'une disparition, ni inventer un coût historique. Alternative : compléter tous les champs avec le marché actuel. Conséquence : couverture comptable partielle mais explicable. Les recettes nettes TSM ne subissent pas une seconde commission.

ADR-004 — Identité exacte avant agrégation ​

Décision : itemString complet, profil et personnage aux frontières des preuves. Alternative : tout regrouper par identifiant de base. Conséquence : moins de faux rapprochements, davantage de cas « à vérifier » pour variantes et historiques incomplets.

ADR-005 — Règles explicables, essais limités ​

Décision : demande récente observée, petits essais, déduction du stock, réserve et prix frais. Alternative : classement par marge théorique seule ou modèle prédictif opaque. Conséquence : le plan est conservateur et glouton, pas un optimum global ni une probabilité calibrée de vente.

ADR-006 — Qualité mesurable et livraisons attestées ​

Décision : tests Node/Lua/Rust, mutations ciblées, couverture financière, Fallow et digest des sources. Alternative : seulement tester l'interface manuellement. Conséquence : une modification documentaire peut invalider l'attestation de source d'un paquet ; reconstruire les preuves avant une nouvelle livraison applicative. Les ZIP déjà livrés restent immuables.

ADR-007 — Documentation statique bilingue ​

Décision : VitePress 1.6.4, Vue, recherche locale et paquet séparé. Alternative : manuel monolithique ou CMS hébergé. Conséquence : meilleure navigation et usage hors ligne après compilation, mais deux langues à maintenir. Vite est surchargé à 6.4.6 pour éviter les avis connus de la chaîne transitive stable ; l'audit et le build doivent rester verts. La documentation n'ajoute pas Vue au runtime desktop.

ADR-008 — Versions par composant et Git privé ​

Décision : versions desktop, Companion et documentation indépendantes, consignées dans versions.json ; tags annotés, dépôt initial privé, aucune donnée réelle. Alternative : un numéro unique qui oblige à republier tous les composants. Conséquence : chaque livraison doit préciser sa matrice de compatibilité. Les premiers tags représentent un import de sources candidates, pas une reconstruction d'un historique antérieur.

ADR-009 - Un design partagé, des rendus adaptés ​

Décision : tokens CSS et assets locaux communs, adaptés aux trois surfaces. Alternative : migrer toutes les interfaces vers un framework unique. Motif : cohérence immédiate sans réécrire le moteur ni alourdir le desktop. Coût : maintenir les adaptations ; la CI contrôle les copies générées et les deux langues.

ADR-010 - Installation guidée et récupérable ​

Décision : NSIS installe le logiciel par utilisateur ; l'assistant local valide le client WoW et déploie le Companion avec sauvegarde/journal. Alternative : plusieurs ZIP ou modification directe des SavedVariables. Conséquence : un téléchargement, aucune copie manuelle ; WoW doit être fermé et TSM reste séparé. Les choix ambigus ne sont pas devinés et la désinstallation conserve les données.

ADR-011 - Publication attestée avant promotion du site ​

Décision : monorepo, Actions, R2 immuable par exécution, puis Pages après vérification des octets publics. Alternative : téléverser manuellement ou publier le site avant le binaire. Conséquence : la page n'annonce pas un téléchargement non vérifié ; rollback Pages automatique sur échec. Le premier raccordement des secrets reste une opération de compte, distincte du code.

Un conseiller local. Des estimations explicites.