Canonical Identity¶
La Canonical Identity représente la vérité métier unique d'un produit dans CMonChoix Platform.
Elle est indépendante des marchands, des feeds, des pipelines et du frontend.
Toutes les autres couches gravitent autour d'elle.
Sommaire¶
- Présentation
- Pourquoi une Canonical Identity ?
- Objectifs
- Cycle de vie
- Composition
- Responsabilités
- Ce qui n'appartient pas à la Canonical Identity
- Variants
- Invariants
- Exemples
- Voir aussi
Présentation¶
Une Canonical Identity représente un produit unique.
Elle ne décrit pas une offre marchande.
Elle ne décrit pas un feed.
Elle ne décrit pas un prix.
Elle décrit le produit lui-même.
Pourquoi une Canonical Identity ?¶
Les marchands décrivent souvent un même produit avec :
- des titres différents ;
- des niveaux de détail différents ;
- des identifiants différents ;
- des attributs différents.
La Platform construit donc une représentation commune.
Cette représentation devient la référence officielle.
Objectifs¶
La Canonical Identity poursuit plusieurs objectifs.
Unicité¶
Un produit possède une seule identité.
Stabilité¶
Un changement de marchand ne modifie jamais cette identité.
Réutilisabilité¶
Toutes les verticales utilisent exactement le même concept.
Traçabilité¶
Chaque décision peut être expliquée.
Cycle de vie¶
```text id="2mnq1e" Identifiers │ ▼ Candidates │ ▼ Resolver │ ▼ Canonical Identity │ ▼ Projection
La Canonical Identity constitue le point central du cycle.
---
# Composition
Une Canonical Identity peut contenir notamment :
* Brand ;
* Series ;
* Family ;
* Model ;
* Generation ;
* Product Type ;
* Variants ;
* Technical Attributes.
Les Vertical Modules peuvent enrichir cette structure.
Ils ne la remplacent jamais.
---
# Responsabilités
La Canonical Identity est responsable :
* de représenter un produit ;
* de fournir une référence stable ;
* d'alimenter les projections ;
* d'alimenter les audits ;
* de servir de base au frontend.
Elle n'est pas responsable :
* des prix ;
* des promotions ;
* des stocks ;
* des marchands ;
* des offres.
---
# Ce qui n'appartient pas à la Canonical Identity
Les éléments suivants restent extérieurs :
* prix ;
* remise ;
* disponibilité ;
* vendeur ;
* délai de livraison ;
* notation marchand.
Ces informations appartiennent aux offres.
---
# Variants
Une Canonical Identity peut posséder plusieurs variantes.
Exemples :
Smartphone :
* 128 Go ;
* 256 Go ;
* Noir ;
* Blanc.
Photo :
* différentes focales ;
* différentes ouvertures.
TV :
* 55 pouces ;
* 65 pouces ;
* 75 pouces.
Toutes restent rattachées à la même identité.
---
# Invariants
Une Canonical Identity :
* est unique ;
* est immutable pendant son utilisation ;
* ne dépend jamais d'un marchand ;
* reste indépendante du Frontend ;
* reste indépendante du Pipeline.
---
# Exemple Smartphone
```text id="f8yk5g"
Apple
iPhone 16 Pro
Generation 16
Variant
256 Go
Titanium Black
Exemple Photo¶
```text id="d5dhrw" Canon
EF-S
55-250 mm
f/4-5.6 IS STM
---
# Exemple Gaming
```text id="b0wjaf"
Sony
PlayStation 5
Slim
Digital Edition
Conclusion¶
La Canonical Identity constitue le cœur métier de CMonChoix Platform.
Toutes les décisions importantes convergent vers elle.
Sa stabilité conditionne la cohérence de l'ensemble du système.
Voir aussi¶
- Candidate
- Resolver
- Projection
- Identifier First
- Contracts