Produits, versionnage & ressources

Les produits sont l'entité centrale de PIE. Un produit porte des attributs structurés (nom, SKU, GTIN, champs spécifiques à la catégorie), appartient à une catégorie, lie des entités de référence et peut être localisé, versionné et publié.

Catégories et attributs

Chaque produit appartient à une catégorie qui définit son schéma d'attributs. Une organisation productrice neuve fournit une catégorie préinstallée « Food (built-in) » pour créer immédiatement un produit alimentaire conforme, plus des catégories d'exemple (produits frais, aliments transformés, boissons). Les attributs de catégorie sont stockés en JSON structuré, de sorte que des catégories différentes peuvent porter des champs très différents sans migration de schéma.

Créer des produits

• Manuellement — renseignez les attributs dans l'éditeur de produit. Définissez les marchés cibles ; les langues-régions requises en découlent.
• Par ingestion IA — téléversez une fiche technique ou collez une URL et laissez le pipeline extraire un brouillon, que vous révisez avant l'import. Voir le guide IA.

Les produits utilisent une suppression logique : un produit supprimé est marqué d'un horodatage et disparaît des listes, mais son historique est conservé.

Entités de référence

Liez des entités de référence — allergènes, nutriments, certifications et autres types partagés ou personnalisés — plutôt que de dupliquer ces données sur chaque produit. Les données issues des entités alimentent la projection GS1 Global Data Model, l'évaluation de conformité et les passeports numériques de produit ; lier les entités une fois est donc payant à travers les sous-systèmes.

Versionnage

Les modifications de produit sont versionnées automatiquement. Chaque mise à jour écrit un instantané de l'état précédent dans l'historique des versions et incrémente le numéro de version du produit, en une seule transaction — vous disposez donc toujours d'un historique complet et auditable et voyez exactement ce qui a changé et quand.

Localisation

PIE stocke un ensemble d'attributs canonique plus des surcharges par langue-région. Vous modifiez une langue-région précise (par exemple de-DE, de-CH, fr-CH) et seuls les champs que vous traduisez sont surchargés ; tout le reste retombe sur le canonique. La qualité et la conformité sont évaluées par langue-région avec repli désactivé, de sorte qu'une traduction manquante est comptée comme manquante plutôt que de passer silencieusement. Les langues-régions activées proviennent des paramètres de votre organisation et des marchés cibles de votre produit.

Ressources

Les ressources sont gérées en mode bibliothèque : une ressource est liée aux produits via des liens de ressource, sans appartenir à un produit unique, de sorte que la même image ou le même document peut soutenir plusieurs produits.

Vous pouvez téléverser des images (JPEG, PNG, WebP, jusqu'à 20 Mo), des PDF (jusqu'à 50 Mo) et des vidéos (MP4, WebM, QuickTime, jusqu'à 100 Mo). Les vidéos sont stockées et servies telles quelles — sans transcodage ni image d'aperçu.

Les téléversements ne passent jamais par le serveur d'API. Le flux est :

1. Demander une URL de téléversement pré-signée pour le produit.
2. Téléverser le binaire directement vers le stockage d'objets à l'aide de cette URL.
3. Confirmer le téléversement — l'API ne stocke alors que les métadonnées de la ressource (bucket, clé, type MIME, taille).

La confirmation valide le fichier réellement arrivé dans le stockage, et non ce que la requête a déclaré : la taille réelle est comparée à la limite et les premiers octets au type déclaré. Un fichier qui échoue à l'une de ces vérifications est refusé et supprimé.

Les rendus (vignettes et autres tailles dérivées) sont générés à partir de préréglages de rendu, que vous gérez dans les paramètres. Un préréglage nommé thumbnail est créé pour vous ; c'est lui qui fait que chaque nouveau téléversement d'image obtient automatiquement une vignette. Les vidéos n'ont pas de rendus.

Lors de la consultation ou du téléchargement d'une ressource, l'URL est une URL pré-signée de courte durée générée à la demande — les URL de ressources ne sont jamais stockées ni servies directement.

Publier

La publication fait passer un produit par les barrières activées par votre organisation — qualité, conformité, conformité GS1 et approbation par workflow. Une fois publié, un produit peut être exposé aux acheteurs via des octrois, syndiqué vers des canaux et portails et publié en tant que passeport numérique de produit.