Comment computeRoleDiff() compare deux rôles catégorie par catégorie, la convention A/B, ce que chaque catégorie de changement signifie, et la différence entre l'onglet Diff dans le builder et la route de différence autonome.
Une différence entre rôles est la différence structurée entre deux rôles : arêtes de profil ajoutées ou retirées, changements de classification de profil, décalages d'IRI/ICI, et réordonnancements d'étapes de flux. C'est l'artefact de transformation dans RPF — quand vous voyez ce qui diffère entre le rôle d'aujourd'hui et celui de demain, vous voyez ce qu'il faut apprendre, ce qu'il faut enseigner, et ce qu'il faut approvisionner.
Trois publics lisent la différence différemment. Les ordres professionnels la lisent comme preuve de ce que « prêt pour l'avenir » signifie réellement en pratique. Les responsables d'organisation la lisent comme l'écart que leurs rôles doivent combler. Les praticiens la lisent comme le curriculum qu'ils doivent parcourir.
La différence est une fonction pure sur deux rôles publiés, A et B. Elle retourne un paquet RoleDiff structuré avec cinq sections : arêtes de profil (ajoutées / retirées / classification-modifiée / décalage IRI / décalage ICI) et étapes de flux (ajoutées / retirées / réordonnées). Elle ne retourne pas de prose ; elle retourne des données structurées catégorisées que l'UI rend.
Comme l'écart de profil (M18.1), la différence est calculée, pas autorée. Il n'y a pas d'« éditeur de différence ». La différence est une lecture en direct sur les deux rôles, recalculée chaque fois que l'un ou l'autre côté change.
A est le rôle à partir duquel vous avez ouvert la différence ; B est la cible de comparaison (généralement le successeur de A, ou défini via ?vs=<slug>). Visuellement, A s'affiche à gauche en tons ardoise ; B s'affiche à droite en tons émeraude. Les tons verts signifient « ajouté sur B / augmenté vers B » ; les tons ambre signifient « retiré / diminué ».
Le rôle sujet — habituellement l'hérité ou l'hybride. S'affiche du côté gauche de la différence. Les tons ardoise correspondent à la palette du badge d'archétype pour hérité.
La cible de comparaison — habituellement le successeur prêt pour l'avenir. S'affiche du côté droit de la différence. Les tons émeraude correspondent à la palette du badge d'archétype pour prêt pour l'avenir.
Profils attachés à B mais pas à A. Chaque ligne montre la classification (core / primaire / support). « Ajouté » signifie que le rôle prêt pour l'avenir attend une compétence dans un profil que le rôle hérité n'exigeait pas.
Profils attachés à A mais pas à B. « Retiré » signifie qu'une compétence que le rôle hérité exigeait n'est plus centrale pour le rôle prêt pour l'avenir — souvent un flux de travail automatisé ou délégué.
Profils présents des deux côtés où la classification a changé (par exemple core → primaire). La catégorie capture le décalage dans la centralité d'un profil au sein du rôle, même quand les deux côtés le portent.
Delta d'IRI par arête de profil (B − A), sommé en iriShiftTotal. Un décalage positif signifie que le rôle prêt pour l'avenir exige plus d'information à travers le profil ; un décalage négatif, moins. L'IRI varie 0–3 par profil par rôle.
Delta d'ICI par arête de profil (B − A), sommé en iciShiftTotal. Un décalage positif signifie que le rôle prêt pour l'avenir exige plus de profondeur de compétence (un seuil cognitif / d'exécution plus élevé). L'ICI varie 0–3 par profil par rôle.
Étapes de flux présentes des deux côtés où la position ordinale a changé, plus les étapes ajoutées ou retirées. Un réordonnancement signale généralement une restructuration du flux — par exemple, « coordination de projet » avancée plus tôt dans le cycle de vie.
L'onglet Diff à l'intérieur du builder de rôles (LeftPane) montre la même différence que la route autonome, mais avec des affordances d'autorat : cliquer sur une ligne peut vous amener à la section pertinente du builder, et l'indice de première exécution de l'agent est partagé avec la route autonome via une clé de rejet unique afin que la visite ne se déroule qu'une seule fois sur les deux surfaces. L'onglet Diff a remplacé l'ancien onglet Compare dans M18.3.3c.
La route autonome est un composant serveur en lecture seule, cacheable statiquement, et le lien canonique à partager quand quelqu'un veut voir la différence sans entrer dans le builder. Elle accepte ?vs=<autre-slug> pour surcharger la cible de comparaison, et rend le panneau d'agent + l'indice de première exécution en ligne.