Concepts cles

CycleCore est un Product Core System multi-tenant. L'API publique expose un modele catalogue stable, pense pour etre consomme par des integrateurs externes sans reveler les details internes de l'application.

Organization

Une organization est l'espace isole d'un client. Elle contient ses produits, familles, attributs, categories, medias, utilisateurs et reglages.

Une cle API appartient toujours a une seule organization. Vous ne passez pas organizationId dans les URLs publiques: CycleCore le deduit de la cle et filtre automatiquement les donnees.

Product

Un product represente une fiche produit du catalogue. Il est rattache a une organization et peut etre associe a:

• Une family qui definit sa structure attendue.
• Une category qui le classe dans le catalogue.
• Des attribute values qui portent les donnees metier.
• Des medias issus du DAM.

Un produit peut etre incomplet, en brouillon ou pret pour un canal de diffusion selon les regles de l'organisation.

Family

Une family decrit la structure attendue pour un type de produit. Par exemple: textile, chaussure, meuble, accessoire ou piece detachee.

Elle sert a definir quels attributs sont attendus pour les produits de ce type. Une integration peut utiliser les familles pour comprendre quelles donnees sont necessaires avant d'exporter ou de transformer un produit.

Attribute

Un attribute est un champ configurable. CycleCore supporte differents types de valeurs selon la configuration metier:

• Texte court ou long.
• Prix.
• Image ou media.
• Mesure.
• Selection simple ou multiple.
• Booleen, date ou autre type specialise.

Les attributs permettent d'adapter le modele catalogue au metier du client sans changer le contrat technique de base.

AttributeValue

Une attribute value est la valeur concrete d'un attribut pour un produit. Par exemple, l'attribut sku peut avoir la valeur TSHIRT-BLACK-M sur un produit donne.

Certaines valeurs peuvent varier selon un channel ou un contexte de diffusion. Par exemple, un libelle produit peut etre different entre un site e-commerce, une marketplace et un export interne.

Category

Une category classe les produits dans une arborescence ou une classification interne. Elle sert a structurer le catalogue et a preparer les exports vers des canaux externes.

Une categorie n'est pas forcement identique a une categorie Shopify, Amazon ou marketplace. Les mappings de diffusion peuvent transformer cette classification selon le canal cible.

Media

Un media est un fichier gere dans le DAM CycleCore: image produit, document, fiche technique, video ou ressource associee.

Un media peut etre relie a des produits et expose via l'API publique lorsque la cle possede le scope media:read.

Channel

Un channel represente un contexte de diffusion ou de variation des donnees: site e-commerce, marketplace, catalogue B2B, export distributeur ou flux interne.

Les channels permettent de preparer des valeurs adaptees a chaque destination. La documentation publique documentera les endpoints channels lorsque leur contrat public sera stabilise.

Multi-tenant isolation

CycleCore isole toujours les donnees par organization. Cette isolation est une regle centrale de l'API publique:

• Une cle API ne peut lire que les donnees de son organization.
• Les URLs publiques ne permettent pas de changer d'organization.
• Les routes publiques ne retournent pas les donnees techniques internes.
• Les erreurs ne doivent pas permettre de deduire l'existence de donnees d'une autre organization.