Identité canonique¶

La Canonical Identity — identité canonique — est la référence métier stable utilisée par CMonChoix pour représenter un produit indépendamment de la manière dont les marchands le décrivent.

Pourquoi elle est nécessaire¶

Deux marchands peuvent vendre le même produit avec des titres différents, des identifiants différents ou des informations plus ou moins complètes.

Exemple :

Marchand A : Samsung Galaxy S26 256GB Noir
Marchand B : Galaxy S26 Black 256 Go

Ces deux offres peuvent désigner le même produit réel. CMonChoix ne doit donc pas utiliser directement le titre marchand comme identité définitive.

Comment elle est obtenue¶

La plateforme collecte d'abord des preuves : marque, modèle, identifiants, attributs et informations normalisées. Elle construit ensuite des candidats et utilise le Resolver pour déterminer si une identité peut être établie avec suffisamment de confiance.

Observations marchands
        ↓
Preuves normalisées
        ↓
Candidats
        ↓
Resolver
        ↓
Résultat de résolution
        ↓
Identité canonique si le résultat est `resolved`

Ce qu'il ne faut pas confondre¶

Une identité canonique n'est pas :

un titre commercial ;
un identifiant propre à un marchand ;
une ligne brute de feed ;
une projection frontend ;
une simple valeur EAN prise isolément.

Ces informations peuvent servir de preuves, mais elles ne deviennent pas automatiquement la vérité métier.

États possibles avant résolution¶

Le système doit pouvoir conserver plusieurs situations :

resolved : l'identité est suffisamment établie ;
unknown : les données ne permettent pas encore de décider ;
ambiguous : plusieurs identités restent plausibles ;
conflict : certaines preuves se contredisent.

Il est préférable de conserver une incertitude explicite plutôt que d'attacher une offre au mauvais produit.

Pour diagnostiquer un mauvais produit¶

Si une offre apparaît sous le mauvais produit, ne commence pas par modifier le frontend.

Cherche plutôt :

quelles observations ont été reçues ;
comment elles ont été normalisées ;
quels candidats ont été générés ;
quel résultat le Resolver a produit ;
quelle projection utilise ensuite cette identité.

Voir la documentation complète : Identité canonique — architecture.