# Couverture des destinations

Ce document décrit ce que mesure Pet Route Planner, les exclusions de sécurité
et la procédure à suivre pour augmenter la couverture sans créer de faux
guidages.

## État audité et exposé en V0.46.0

Les données `Data/Acquisitions.lua` contiennent 2 102 fiches de mascottes :

| Catégorie exclusive | Nombre | Signification |
|---|---:|---|
| Guidable | 1 143 | au moins une destination a `routeEligible=true` |
| Zone seulement | 603 | une carte est connue, mais aucun point exact ou d’instance n’est utilisable |
| Point rejeté | 91 | un point existe, mais sa provenance ne permet pas de garantir qu’il s’agit du lieu d’obtention |
| Sans carte | 265 | aucune carte exploitable n’est fournie |
| Total | 2 102 | fiches d’espèces présentes dans la table générée |

Le chiffre **1 143** n’est donc pas un nombre de fiches « validées » sur 2 102.
Les 2 102 fiches sont cataloguées ; 1 143 d’entre elles peuvent actuellement
alimenter le guide avec au moins une destination. La disponibilité réelle est
ensuite évaluée pour le personnage courant : faction, niveau, classe, race,
métier, quête, haut fait, réputation, événement et version du jeu.

Depuis la V0.46.0, `/prp report` recalcule et inclut ces catégories pour les
mascottes et les jouets. Si une collection est sélectionnée, le même rapport
ajoute sa méthode effective, son état de disponibilité, son repère et le
diagnostic de trajet. Le rapport suit la langue de l’interface PRP et ne contient
ni nom de personnage ni royaume.

## Audit des points rejetés

Les 91 fiches « Point rejeté » contiennent 141 candidats précis. Leur ventilation
au 17 août 2026 est la suivante :

| Candidats | Type généré | Score | Motif principal |
|---:|---|---:|---|
| 67 | PNJ | 50 | rôle du PNJ incertain ; une coordonnée de contexte ne prouve pas l’obtention |
| 39 | vendeur probable | 30 | disponibilité non résolue, souvent contenu retiré ou Comptoir |
| 20 | PNJ | 30 | entrée retirée ou indisponible et rôle incertain |
| 9 | autre / objet | 25 | coordonnée de la source de l’objet, pas nécessairement de la mascotte |
| 4 | quête | 30 | quête retirée ou disponibilité non résolue |
| 2 | profession | 25 | lieu de contexte du métier, pas lieu d’obtention garanti |

Aucun de ces groupes ne peut être promu en bloc. Passer simplement le seuil
sous 70 ferait notamment guider vers des PNJ d’ambiance, d’anciens vendeurs,
des sources d’objets intermédiaires ou du contenu retiré.

## Politique de promotion

Une destination ne doit devenir guidable que si les points suivants sont
établis :

1. la coordonnée désigne bien l’action d’obtention finale, et non un objet ou
   un en-tête de contexte ;
2. le rôle de la source est explicite (vendeur, quête, combat, trésor, secret,
   haut fait, profession ou capture) ;
3. la carte, les coordonnées et l’éventuelle entrée d’instance sont cohérentes ;
4. les marqueurs de retrait et de version (`u`, `rwp`, `timeline`) ont une
   interprétation sûre ;
5. les restrictions de faction, classe, race et métier sont conservées ;
6. le trajet obtenu est testé dans le client sur le thème WoW et le thème ElvUI.

Une correction manuelle doit rester traçable par identifiant d’espèce et clé
de candidat. Il ne faut jamais réécrire silencieusement la table générée ou
modifier globalement le seuil `routeEligibleThreshold=70`.

## Exceptions d’acquisition vérifiées

Les corrections manuelles vivent dans `Data/Overrides.lua` et sont appliquées
par clé de candidat sans modifier les exports ATT. La révision
`scenario-guidance-v7` du 19 août 2026 couvre 35 enregistrements correspondant à
15 jouets et six familles de scénarios :

| Famille | Traitement |
|---|---|
| Entraînement des flétris | sept jouets reliés à une machine d’état locale : prérequis de Suramar, premier essai, disponibilité, Mana ancestral, objectifs du scénario puis coffre final aléatoire de Falanaar ; les trois variantes de coffre sont reconnues sans imposer un identifiant unique |
| Vision horrifique revisitée d’Orgrimmar | entrée Soridormi, choix de ville et Image de Wrathion communs ; caisse du salon et coffre de Zekhan distingués, ce dernier restant final |
| Vision horrifique revisitée de Hurlevent | entrée Soridormi, patrouille mobile de Craggle, pomme source séparée du coffre d’Alleria et petit crâne non surligné distingués |
| Catacombes de Karazhan | Clé singulière, Torche de Pyrreth, Clé des ombres, Clé astrale puis Coffre astral ordonnés pour les Lunettes au regard étoilé |
| Marche des traditions de Xal’atath | départ, quatre quêtes intermédiaires, scénario et rendu final au Chroniqueur Cho de la bonne capitale séparés |
| Héritage pandaren | chaîne de quête réservée aux Pandarens de niveau 50, départ du Chroniqueur Cho et rendu final auprès de Chon Po séparés ; aucun faux état de scénario |

Douze anciens candidats des Visions horrifiques restent identifiés comme
sources de scénario, mais sont exclus du calcul afin de ne pas concurrencer
les cartes revisitées actuelles. Les textes d’action propres à chaque source
sont conservés dans la fiche principale et traduits en anglais ; le résumé
générique de méthode ne peut plus les remplacer.

Les coordonnées et contextes proviennent du commit ATT
`e4364deafc9ef0e0ca6229b403fb2970e924c833`. Les mécaniques des Visions ont
également été recoupées avec les guides Wowhead d’Orgrimmar et de Hurlevent,
et le coffre final de Falanaar avec la documentation de l’Entraînement des
flétris.

Les routes compilées conservent une clé stable par étape et la variante de
départ retenue. Un recalcul ou une restauration peut ainsi reprendre le suffixe
déjà atteint sans réexposer une entrée extérieure accomplie. Les passages
interzones encore non planifiables sont classés `partial` avec le code
`custom_route_unplanned_segments` ; ils ne sont jamais comptés comme trajet
complet et sont précisés lorsque la nouvelle carte permet un recalcul sûr.

La révision V7 valide chaque transition dans l’ordre : être déjà sur la carte
d’un futur rendu ne permet pas de sauter les objectifs précédents. Les actions
géolocalisées exigent la bonne carte et la proximité attendue, sauf les cibles
explicitement mobiles. Une quête ou un objet dont l’état n’est pas lisible est
traité comme inconnu et bloque prudemment l’avancement au lieu d’être supposé
acquis.

## Audit générique V8

La passe V8 couvre également les 3 540 méthodes importées qui ne disposent pas
d’une exception manuelle : 1 225 vendeurs, 434 sources de butin, 650 quêtes,
738 captures de mascottes, 247 objets et 246 instances. Chaque méthode conserve
son filtre primaire et produit une instruction adaptée à son type ; une source
de butin demande notamment de trouver, vaincre puis fouiller le PNJ au lieu de
présenter une interaction générique.

Les coûts en or, objets et monnaies sont évalués séparément, y compris les
coûts composites. Une valeur absente, illisible ou mal formée reste inconnue et
ne peut pas rendre la méthode disponible. Les rotations quotidiennes et
hebdomadaires, le niveau, la faction, la classe, la race, le métier, les quêtes,
les hauts faits et la réputation suivent la même politique prudente.

Les phrases assemblées dynamiquement sont localisées avant concaténation. Les
instructions, prérequis, résumés de méthode, états de disponibilité, titres de
repère et messages de récupération ont été contrôlés sur les 3 540 méthodes en
français et en anglais. L’arrivée à une destination générique ne valide jamais
seule l’obtention finale.

## Procédure de réaudit

Après chaque régénération des données :

1. recompter les quatre catégories exclusives ;
2. extraire les candidats `exact` ou `instance` encore rejetés ;
3. regrouper par type, score, source des coordonnées, drapeaux et disponibilité ;
4. examiner individuellement les nouveaux candidats qui ne sont ni retirés,
   ni indirects, ni marqués `roleUncertain` ;
5. valider les promotions en jeu sur au moins deux silhouettes et deux points
   géographiques distincts ;
6. reporter ici le commit ATT source, les nouveaux totaux et les exceptions
   ajoutées.

La source actuelle est le commit ATT
`e4364deafc9ef0e0ca6229b403fb2970e924c833`, déclaré dans
`Data/Acquisitions.lua`.
