Données, identités et persistance
Sources et autorité
| Source | Apporte | Ne prouve pas |
|---|---|---|
| TradeSkillMaster.lua | Inventaires, métiers et historique sauvegardé | État instantané du serveur |
| AppData.lua | Prix et statistiques disponibles dans le cache | Vente future à ce prix |
| DonjonsEtPognons.lua | Observations du Companion sauvegardées | Issue certaine de chaque enchère |
| État local D&P | Décisions, confirmations et observations cumulées | Écritures dans WoW |
Le lecteur Lua interprète un sous-ensemble littéral : il n'exécute jamais le fichier. Il contrôle le nom du fichier et une taille maximale de 100 Mio, puis compare taille et date avant/après lecture. Un hash SHA-256 identifie le contenu. Une sauvegarde incohérente est rejetée ; une lecture ultérieure peut réussir.
Identités à préserver
i:1234 et un itemString avec suffixe ne sont pas interchangeables. Le nom et l'icône peuvent venir de l'identifiant de base ; un prix ou une vente d'une variante ne devient pas une preuve pour toutes les variantes. Les profils séparent royaume, faction, région et personnages sélectionnés.
La portée de performance inclut aussi le chemin TSM normalisé. Déplacer la source peut donc créer une nouvelle portée historique. Ne promettez pas une migration transparente en changeant simplement le chemin ; sauvegardez l'état et vérifiez le profil obtenu.
Persistance et déduplication
engine/state est privé. Les fichiers de configuration, espace de travail, journal de retours et performance y conservent les préférences et observations. Les écritures utilisent un fichier temporaire puis un remplacement ; les mutations sont sérialisées. Sauvegarder le dossier complet évite une restauration partielle incohérente.
Les transactions historiques sont regroupées par identité et multiplicité observée. Une relecture du même export n'ajoute pas une nouvelle vente. Ce mécanisme dépend des champs disponibles, pas d'un identifiant universel de transaction TSM. Les événements financiers sont bornés à 365 jours et 20 000 entrées par profil ; les coûts à 366 observations par itemString exact et portée. Un changement de coût produit immédiatement une nouvelle observation ; sans changement, une observation est ajoutée après au moins une heure.
Absence, zéro et ancienneté
Une source absente est inconnue, pas zéro. Une enchère disparue peut avoir été vendue, annulée, expirée ou être absente d'un relevé incomplet. L'observateur conserve le dernier état valide lorsque les données sont vides ou régressent. L'âge de stock est la première observation continue positive, pas la date d'achat. Voir comptabilité.
Les chemins, noms de personnages et historiques peuvent contenir des informations personnelles. Les fichiers bruts et états ne doivent jamais servir de fixtures publiques.
