> **Révision v15 du 25 octobre 2026** : en DPS, « Donjons et raids » tient compte des dégâts monocibles et de zone de la même spécialisation. La maîtrise PvE s'applique ensuite une fois. Le rôle DPS et les départages suivent le même repère ; les autres activités gardent leurs propres notes. Choisir « Dégâts de zone » renforce cette envie. Ce repère est une convention d'aide au choix, pas une mesure des dégâts réels. Aucune note source ne change. [Les notes et leurs sources](fiches-sources/index.html). Publication à valider.

> **Révision validée du 25 octobre 2026 (v14)** : ton rôle est évalué dans les activités que tu choisis. Solo et leveling utilisent le repère solo et la difficulté PvE ; BG et PvP sauvage utilisent leurs repères PvP ; Donjons et raids garde son repère de groupe. Plusieurs activités comptent ensemble. Sans activité précisée, le rôle garde provisoirement son repère de groupe, indiqué dans le résultat. Le mode personnalisé ajoute Donjons et raids comme quinzième priorité ; tes anciens poids sauvegardés sont conservés. Les explications passent en mots et gardent les chiffres dans un volet facultatif. Les notes et les coefficients ne changent pas. Voir [la révision et ses limites](COHERENCE-PVE-PVP-V14.md). Les descriptions historiques ci-dessous doivent être lues avec cette révision.

# Moteur de recommandation — spécification et limites

**État : 20 octobre 2026. Modèle exploratoire, non calibré au niveau 60.**

**Révision éditoriale du 21 octobre 2026 :** soins Paladin et Chaman portés de 4 à 5 ; contrôle de Discipline de 4 à 3. Les formules et les coefficients de maîtrise sont conservés. Il s'agit de jugements d'aide au choix, pas de mesures de performance. Les repères « Jouer cette spécialisation » présentent le style, deux atouts et un point d'attention ; ils ne participent pas au score. Depuis le 22 octobre 2026 (moteur 1.0.9), chaque spécialisation est classée : une classe peut revenir, au plus deux fois dans les trois pistes du parcours guidé. Quand plusieurs spécialisations obtiennent le même score, celle qui a le plus haut potentiel compte tenu de ta maîtrise (adéquation PvE estimée, ajustée à ton niveau) passe devant. En solo, le Chasseur Maîtrise des bêtes reste accessible dès le niveau Débutant grâce à son familier ; Précision et Survie suivent l'effet général de la maîtrise. Voir [la révision et ses limites](REVISION-EDITORIALE-V2.md).

Le nouveau parcours de six questions est distinct du comparatif historique à 14 critères, retiré de la page le 21 octobre 2026 : ses 15 préréglages servent au mode personnalisé, et les 126 notes restent affichées dans la matrice. Depuis le 23 octobre 2026 (moteur 1.3.0, référence v13), chaque note de la matrice qui porte sur un critère des spécialisations est celle de la meilleure spécialisation de la classe ; un clic sur une classe déroule les notes de ses spécialisations. Le nouveau moteur ne prend jamais les meilleures notes de toutes les spécialisations d'une classe pour les additionner : il classe chaque spécialisation avec ses propres notes, la note de classe ne servant qu'à la référence de rôle ci-dessous.

## Données

Le fichier recommendation-engine.js décrit **27 spécialisations et une configuration Farouche Ours**, soit 28 configurations jouables. Les rôles, la portée et les possibilités de familiers sont rattachés aux fiches officielles Blizzard, dont https://worldofwarcraft.blizzard.com/en-us/news/24301515 et https://worldofwarcraft.blizzard.com/en-us/news/24310968 . La mention « familier optionnel » indique une possibilité de build et non des performances égales sans familier.

Les activités (raids, BG, PvP sauvage, solo), les six qualités de style et la difficulté d'exécution reçoivent des évaluations éditoriales sur 1–5. Elles sont **hypothétiques**, non mesurées sur des joueurs de niveau 60. Chaque configuration possède une référence officielle pour les éléments structurels, mais cette référence **ne valide pas les notes numériques éditoriales**.

## Saisie

1. Rôles (DPS, tank, soin), plusieurs choix et possibilité explicite d'exiger tous les rôles. Avec le rôle Soin, une sous-question facultative précise la façon de soigner (prévenir les dégâts, soins sur la durée, gros soins ciblés, soigner tout le groupe), deux choix au plus.
2. Activités (raids/donjons, BG, PvP sauvage/duel, solo/farm), réponses multiples.
3. Portée (distance, mêlée, alterner, indifférent), préférence souple ou exigence absolue.
4. Styles (burst, zone, contrôle, survie, mobilité, soutien), trois choix maximum.
5. Familiers (aimer, éviter, indifférent), avec option de refus strict des configurations nécessitant un familier.
6. Niveau de maîtrise actuel (quatre niveaux) et complexité recherchée, indépendants.

Toute réponse retenue comporte une certitude entière entre **0 (intuition)** et **5 (certain)**. Il ne s'agit pas d'un pourcentage de probabilité. Un rôle à 0/5 n'exclut pas automatiquement les autres ; **seule une exigence expressément déclarée** élimine une configuration. Les questions laissées sans réponse n'ajoutent aucun score. Si aucune préférence n'est donnée, aucun classement n'est affiché. Si les exigences s'excluent mutuellement, le moteur signale qu'aucune configuration n'est compatible.

Les réponses sont enregistrées dans le navigateur sous la clé wf-recommend-v1, distincte des sauvegardes du comparateur historique.

## Calcul explicite

Chaque domaine effectivement répondu contribue au score avec un poids de conception : rôles **0,25**, activités **0,25**, portée **0,15**, styles **0,20**, façon de soigner **0,15** (configurations de soin seulement), familiers **0,10**, complexité **0,05**. Les poids sont renormalisés sur les domaines actifs. À l'intérieur des questions multiples, les réponses sont moyennées : trois styles sélectionnés ne triplent donc pas leur importance.

Pour une adéquation brute a entre 0 et 1 et une certitude c dans 0…5 :

- intensité(c) = 0,25 + 0,75 × c / 5 ;
- adéquation(c) = 0,5 + intensité(c) × (a − 0,5).

Une certitude 0 atténue donc une préférence sans l'effacer ni la transformer en veto. La certitude ne doit pas être confondue avec l'importance ; cette première version conserve des poids explicites de conception, qui devront être calibrés sur des observations. Les notes de style et d'activité sont légèrement modulées par la maîtrise en fonction de la configuration et du contexte PvE/PvP.

Les exigences strictes sont vérifiées **avant le calcul**. Quand plusieurs rôles sont demandés, la couverture de la classe ne compte que parce que ce changement de rôle a été explicitement exprimé. Un seul rôle demandé ne rapporte aucun bonus de polyvalence.

## Restitution et robustesse

Le résultat propose trois classes distinctes au maximum, chacune avec **une spécialisation précise**, des correspondances, des compromis et un lien vers sa fiche officielle. Le score sur 100 est un **indice éditorial d'adéquation**, pas une probabilité.

Chaque réponse à certitude ≤2 entraîne un scénario déterministe où cette réponse est temporairement retirée. L'indication de stabilité du top 3 est une **fréquence interne aux scénarios explorés**, pas une probabilité prédictive. Cette méthode est locale et limitée aux suppressions une à une : elle ne modélise pas toutes les évolutions possibles de l'avis du joueur.

## Vérification et diffusion

Commande : node --test tests/*.test.cjs

La CI exécute les tests historiques et la nouvelle suite. Les contrôles couvrent notamment : inventaire et sources, données valides, cas indécis/contradictoires, exactitude des filtres stricts, certitude 0, monotonie, rôles et configurations Farouche, cas de référence indépendants, calculs bornés/déterministes et **12 000 profils générés reproductibles**.

Les profils générés ne représentent **pas** statistiquement la communauté : aucune part de première place par classe n'est une cible de validation. Les cas de référence doivent être confrontés à des spécialistes indépendants. Une inspection réelle de la page (mobile, clavier, contrastes, lecteurs d'écran) demeure indispensable.

Évolutions futures : mesurer les performances par spécialisation et activité après lancement, documenter tailles d'échantillon et incertitudes, calibrer les poids par une étude d'utilisateurs consentants, et versionner les données après chaque patch.

## Parcours de priorités — traitement du biais du généraliste

Le mode « Mode personnalisé » n'utilise **pas** l'ancien score par moyenne des maxima de spécialisations. Les 14 pondérations et les 15 profils existants sont repris tels quels depuis leurs contrôles historiques, mais évalués par la fonction `priorityRanking` du nouveau moteur. Le niveau de maîtrise est partagé avec le questionnaire.

Chaque spécialisation est évaluée sur quatre **domaines indépendants** :

| Domaine | Axes associés | Coefficient maximum |
| --- | --- | ---: |
| Rôles | Tank, Soin, DPS PvE | 0,30 |
| Activités | BG, PvP sauvage, Solo/leveling | 0,28 |
| Gameplay | Burst, Zone, Contrôle, Survie, Mobilité, Utilité | 0,28 |
| Affinités | Polyvalence, Technicité | 0,14 |

La pertinence d'un domaine est une **moyenne pondérée** de ses axes activés ; son poids effectif est le coefficient du domaine × (plus grand poids de ses axes / 3). Seuls les domaines effectivement activés entrent dans la normalisation finale. Une classe n'est pas créditée de tous les rôles simultanément : une spécialisation occupe le rôle qu'elle peut réellement exercer, et la diversité des rôles ne donne un avantage que si l'axe Polyvalence est choisi. Le domaine « rôles » est compté une seule fois, même si plusieurs axes de rôle ont un poids positif.

Les activités et styles sont évalués **dans la même configuration**, avec les coefficients éditoriaux de maîtrise. La Technicité n'est jamais un bonus par défaut ; lui attribuer un poids positif signifie explicitement rechercher un gameplay exigeant. Depuis le moteur 1.2.0, elle suit tes activités : Champ de bataille ou PvP sauvage seuls, la difficulté PvP ; Solo seul, la difficulté PvE ; les deux, chacun selon sa priorité ; aucune activité, la moyenne. Un rôle ne fait plus pencher vers le PvE. La maîtrise ajuste de même tes styles selon la difficulté PvE ou PvP de tes activités. Le meilleur résultat d'une configuration constitue le score de sa classe, sans réunir les qualités des différentes spécialisations. Les neuf classes restent affichées dans le classement, y compris si certaines répondent mal aux critères.

Le cas « Tous les critères » ne constitue **pas un état neutre au sens individuel** : les quatorze axes sont activés et la polyvalence demandée expressément. Pour une recommandation sans présupposé, le questionnaire ne classe aucune classe tant qu'aucune préférence n'est déclarée ; le bouton « Tout remettre à zéro » supprime aussi l'influence des pondérations.

Ces coefficients sont des conventions auditées et non une calibration auprès de joueurs. Les écarts de quelques points doivent être considérés comme des pistes proches, pas comme des mesures de supériorité. Le moteur **ne vise aucun quota de victoire par classe**.

### Tests de cette interface

- Tests unitaires de domaine et de données, avec cas rôles uniquement, polyvalence facultative, technicité facultative, scores finis, neuf classes distinctes et maintien des quinze profils.
- Test Chromium des deux parcours et de leurs interactions : 6 étapes, 0–5 de certitude, 14 critères, 15 profils, classement de neuf classes, maîtrise synchronisée, préférences rechargées.
- Captures mobiles et bureau générées automatiquement sur la pull request ; la revue visuelle et l'expérience utilisateur restent des activités de validation.


## Correctif de neutralité du 21 octobre 2026 : adéquation au rôle

### Incident identifié

L'ancienne formule \`priorityRanking\` accordait une valeur brute égale à **1** à toute spécialisation portant le rôle demandé (et 0 aux autres). Or **les neuf classes possèdent au moins une spécialisation DPS**. Avec le seul axe DPS PvE actif, la meilleure spécialisation DPS de chaque classe affichait donc **100/100**. Le rôle était traité comme une propriété booléenne plutôt qu'une évaluation comparative. Les tests d'origine vérifiaient les bornes et l'unicité, mais pas le caractère discriminant d'un axe isolé.

### Nouveau référentiel

Le calcul reste exploratoire, sans données de combat mesurées au niveau 60. Il combine une notation éditoriale du rôle par classe, **présente dans la matrice des 126 notes** (depuis la v13, la meilleure spécialisation de la classe dans ce rôle), avec la notation éditoriale PvE de **la spécialisation précise** sélectionnée :

\`adéquation_rôle(spécialisation) = 0,55 × (note_rôle_classe - 1)/4 + 0,45 × (note_raid_spé_corrigée_maîtrise - 1)/4\`

- Si la spécialisation ne tient pas ce rôle, sa contribution est **0**.
- Les rôles DPS, Tank et Soin restent un **seul domaine** de préférence, dont les axes sélectionnés sont moyennés au sein du domaine ; aucune prime universelle à la polyvalence.
- La spécialisation choisie pour chaque classe maximise le score **sur une seule configuration cohérente** : une classe hybride ne combine jamais artificiellement trois spécialisations dans le même résultat.
- La partie « note historique » correspond exactement aux valeurs de rôle de \`index.html\`, vérifiées automatiquement pour les neuf classes et trois rôles.
- La partie « raid » est une hypothèse éditoriale **par spécialisation**, distincte d'une mesure de DPS, menace, guérison ou victoire PvP. Un joueur peut jouer une spécialisation Tank/Soin avec une valeur PvE distincte, sans conclure à sa puissance réelle au niveau 60.

**Précision numérique :** si un seul axe est actif, le score est directement \`100 × adéquation_de_cet_axe\`. Cela évite qu'une division flottante pondérée introduise une différence de 0,01 point entre les poids 1, 2 et 3. Avec un seul critère, ces poids restent équivalents **par normalisation** ; ils ne deviennent discriminants en importance relative que lorsque plusieurs critères sont actifs.

### Moteur guidé

Lorsqu'un seul rôle est déclaré, le guide utilise le même \`adéquation_rôle\` plutôt que d'accorder automatiquement une note maximale aux neuf classes DPS. Une préférence de rôle à faible certitude demeure **souple** ; seuls les booléens d'exigence absolue éliminent des spécialisations. Le niveau de maîtrise est évalué par configuration et activité, et non comme un bonus de difficulté arbitraire.

### Contrôles de non-régression

Le protocole automatisé vérifie les 14 axes sur les quatre niveaux de maîtrise et les trois poids (168 situations isolées), les quinze profils historiques, les valeurs éditoriales sources, les scores finis et bornés, le classement des neuf classes, l'absence du « 100 % universel » et la reproductibilité des calculs sur **24 000 profils pondérés synthétiques**. Le moteur guidé conserve également sa suite de **12 000 profils** et ses tests de contraintes contradictoires.

Les tests Chromium valident les interactions des deux parcours, l'enregistrement puis la restauration d'une pondération personnelle, le passage entre les modes, la persistance après rechargement, et les mises en page mobile/ordinateur sur plusieurs largeurs.

Ces simulations et tests de comportement ne constituent **pas une validation scientifique du modèle**. La qualité de la recommandation dépend des évaluations éditoriales ; il faudra les confronter à des données réelles, détaillées par spécialisation, équipement, contexte et niveau de maîtrise.

## Lire les résultats — précisions du 21 octobre 2026

Chaque classe est représentée par une seule spécialisation adaptée à l'ensemble des réponses. Ajouter un critère peut changer la spécialisation retenue. Les égalités exactes partagent un rang ; l'ordre d'affichage ne démontre aucune supériorité. Les scores principaux sont arrondis à l'entier : un même entier affiché ne signifie pas nécessairement une égalité exacte.

Le contrôle recouvre immobilisations, ralentissements, neutralisations et interruptions, dont les contraintes diffèrent selon les talents et le familier. Les repères de difficulté PvE/PvP concernent la spécialisation affichée, sans mesurer précisément l'apprentissage d'un joueur ni sa capacité à optimiser. Depuis le moteur 1.0.5, ton rapport à la difficulté est comparé à la difficulté PvE si tu n'as choisi que des activités PvE, à la difficulté PvP si tu n'as choisi que du PvP, sinon à leur moyenne. Depuis le moteur 1.1.0, ces difficultés viennent d'une grille commune, le référentiel de complexité : cinq composantes par contexte, notées de 0 à 2 points (rotation, entretien, ressource, placement et pilotage en PvE ; contrôles, défense, placement, ouverture et pilotage en PvP), dont le total sur 10 donne la note. Elles servent aussi à la technicité du mode personnalisé et à l'effet de ta maîtrise. Les résultats disent ce qui pèse dans chaque difficulté ; [la fiche de la grille](fiches-sources/complexite.html) et les fiches de classes justifient chaque composante.

Un familier « facultatif » ne signifie pas un résultat identique sans compagnon. Depuis le moteur 1.0.8, quand le joueur préfère éviter les familiers sans l'exiger, Affliction, Destruction et Survie sont évaluées avec et sans leur compagnon, et le meilleur build complet est retenu ; s'il l'exige, seul le build sans compagnon compte. Le résultat annonce le build retenu : sans démon, le Démoniste perd notamment Séduction et Verrou magique. Précision est toujours évaluée en Loup solitaire, sans compagnon. Les variantes du Chasseur alternant mêlée et distance nécessitent aussi un alignement de leurs hypothèses de performance et de difficulté.

Depuis le moteur 1.0.7, la façon de soigner départage les soigneurs. Chaque configuration de soin porte un profil de 1 à 5 sur les quatre façons, tiré des présentations officielles : un portrait de jeu, pas une puissance de soin. Depuis le moteur 1.0.8, ce critère compte pour toutes les pistes : une configuration qui ne soigne pas ne répond pas à cette envie. Il est ignoré sans le rôle Soin. Sans façon de soigner précisée, une égalité entre soigneurs ne signifie pas qu'ils se jouent de la même façon ou fournissent exactement les mêmes soins. Voir [le détail et les effets](REVISION-EDITORIALE-V2.md).