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.
