Canonical Identity¶
La Canonical Product Identity constitue la vérité métier centrale de CMonChoix Platform.
Toutes les couches de la Platform s'appuient sur cette identité.
Elle représente un produit indépendamment des marchands, des feeds et des variations de présentation.
Sommaire¶
- Pourquoi une Canonical Identity ?
- Définition
- Les objectifs
- Construction
- Cycle de vie
- Les composants
- Les variantes
- Les projections
- Les responsabilités
- Ce qui est interdit
- Conclusion
- Voir aussi
Pourquoi une Canonical Identity ?¶
Les catalogues marchands décrivent souvent un même produit de façons très différentes.
Quelques exemples :
- titre très court
- titre marketing
- titre SEO
- titre marketplace
- titre reconditionné
- titre international
Tous doivent pourtant représenter un seul produit.
La Canonical Identity fournit cette représentation unique.
Définition¶
Une Canonical Identity est la représentation métier officielle d'un produit.
Elle ne dépend pas :
- d'un marchand ;
- d'un feed ;
- d'un EAN particulier ;
- d'un titre commercial.
Elle représente le produit lui-même.
Objectifs¶
La Canonical Identity poursuit plusieurs objectifs.
Une identité unique¶
Un produit possède une seule identité canonique.
Une identité stable¶
Les changements de marchands ne doivent pas modifier cette identité.
Une identité réutilisable¶
Toutes les verticales utilisent exactement le même concept.
Une identité indépendante¶
La Canonical Identity ne dépend jamais :
- du Frontend ;
- du Pipeline ;
- du Runtime ;
- des Vertical Modules.
Construction¶
La construction suit toujours la même séquence.
Identifiers
│
▼
Canonical Candidate
│
▼
Canonical Identity
│
▼
Variants
│
▼
Projection
Les composants¶
Une Canonical Identity contient uniquement des informations métier stables.
Par exemple :
- Brand
- Series
- Model
- Generation
- Family
- Product Type
Elle ne contient pas les informations propres aux offres marchandes.
Les variantes¶
Les variantes décrivent les différences d'un même produit.
Par exemple :
- couleur ;
- capacité ;
- mémoire ;
- réseau ;
- finition.
Ces variantes restent rattachées à une seule Canonical Identity.
Les projections¶
Une Projection est une représentation adaptée à un besoin.
Par exemple :
- affichage Frontend ;
- SEO ;
- comparaison ;
- recherche ;
- export.
La Projection ne crée jamais une nouvelle identité.
Elle utilise uniquement la Canonical Identity.
Les responsabilités¶
La Canonical Identity est responsable :
- de l'identification du produit ;
- de la cohérence entre les marchands ;
- des regroupements ;
- des variantes ;
- des projections.
Elle n'est pas responsable :
- des promotions ;
- des prix ;
- des stocks ;
- du rendu Frontend.
Exemple Smartphone¶
Brand
Apple
Series
iPhone 16
Model
Pro
Generation
16
Variant
256 Go
Black Titanium
Exemple Photo¶
Brand
Canon
Series
EF-S
Model
55-250 mm
Variant
f/4-5.6
IS STM
Exemple TV¶
Brand
Samsung
Series
Neo QLED
Model
QN90D
Variant
65 pouces
Ce qui est interdit¶
Il est interdit :
- de recalculer une Canonical Identity dans le Frontend ;
- de modifier directement une Canonical Identity depuis une verticale ;
- de créer plusieurs Canonical Identity pour un même produit ;
- de contourner le Resolver ;
- de stocker une logique spécifique à une verticale dans la Canonical Identity.
Conclusion¶
La Canonical Identity représente la vérité métier centrale de CMonChoix.
Toutes les autres couches de la Platform gravitent autour d'elle.
Elle constitue le point de convergence entre les identifiants, les verticales, les projections et le runtime.
Sa stabilité est essentielle à la cohérence globale du projet.
Voir aussi¶
- Vision
- Principes
- Invariants
- Dépendances
- Identifier First
- Domain Core
- Resolver
- Projection