Virtual Candidates Dump — CLI¶

Status: CURRENT / CONTRACT

Rôle¶

Le Virtual Candidates Dump montre comment le paysage des candidats évoluerait sous une règle simulée, sans appliquer cette règle à la vérité métier persistée.

Il complète :

Quand l'utiliser¶

Utiliser ce dump lorsqu'un Virtual Patch ou une autre simulation modifie potentiellement :

la génération des candidats ;
leur ordre ou score ;
leur admissibilité ;
les évidences considérées ;
le statut final de résolution.

Le but est de comprendre pourquoi le KPI virtuel change, pas seulement de constater qu'il change.

Entrées attendues¶

Le contexte doit être reproductible :

hypothèse simulée clairement définie ;
révision du code ;
baseline fraîche ;
run, feed, verticale ou échantillon ;
identifiants étudiés ;
critères de sécurité et cas témoins.

Résultats attendus¶

Le dump doit permettre de distinguer :

candidats inchangés ;
candidats ajoutés ;
candidats supprimés ;
changements de score ou de priorité ;
raisons de ces changements ;
nouveaux conflits ou nouvelles ambiguïtés ;
cas qui passeraient de unknown à resolved ;
cas qui passeraient de ambiguous ou conflict à resolved ;
cas qui régressent.

Les reason codes et évidences sont plus importants qu'un simple classement numérique.

Attention aux « candidats sûrs »¶

Le terme « candidat sûr » ne doit pas être déduit d'un score seul.

Pour considérer un cas comme suffisamment démontré, il faut vérifier :

les évidences utilisées ;
l'absence de conflit fort ;
les garde-fous génériques ;
les éventuelles règles verticales ;
la stabilité du résultat sur des cas voisins.

Un score élevé avec des preuves contradictoires reste un cas à examiner.

Position dans le workflow¶

Candidate Dump baseline
        ↓
Virtual Patch
        ↓
Virtual Candidates Dump
        ↓
Comparaison des reason codes
        ↓
Remaining Audit
        ↓
Validation Report

Simulation vs état historique¶

Le dump virtuel décrit le comportement simulé avec les entrées et la version actuelles.

Il ne prouve pas ce qu'aurait produit une ancienne version du système sans disposer des données, paramètres et révision historiques correspondants.

Effets techniques éventuels¶

Le résultat métier du Virtual Candidates Dump doit rester non persistant.

Toutefois, comme pour les autres commandes de simulation, l'implémentation peut créer des artefacts techniques temporaires. Leur existence doit être documentée explicitement.

Le nom virtual, audit ou dry-run n'est pas à lui seul une garantie d'absence d'effet technique.

Vérifier la commande¶

Cette page documente un workflow et un contrat opérateur. Elle ne prouve pas qu'une commande de ce nom exact est enregistrée dans le Runtime courant.

Avant usage :

docker compose exec platform-worker wp --allow-root --path=/var/www/html help <commande>

ou parser :

docker compose exec platform-worker wp --allow-root --path=/var/www/html cli cmd-dump --format=json

Garde-fous¶

Le Virtual Candidates Dump ne doit jamais :

être confondu avec une mutation réelle ;
modifier les projections métier persistées ;
masquer une apparition de ambiguous ou conflict ;
présenter un score comme preuve absolue ;
servir seul de validation finale ;
justifier un patch global sur la base de quelques cas favorables.

Lecture recommandée¶

Avant de conclure :

comparer la baseline et le virtuel candidat par candidat ;
expliquer chaque changement significatif ;
inspecter les conflits nouveaux ;
vérifier les cas qui deviennent resolved ;
contrôler les familles non ciblées ;
exécuter le Remaining Audit ;
formaliser la décision dans le Validation Report.