# 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é en V0.40.25

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.

## 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`.

## 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`.
