Produkte, Versionierung & Assets

Produkte sind die Kernentität in PIE. Ein Produkt trägt strukturierte Attribute (Name, SKU, GTIN, kategoriespezifische Felder), gehört zu einer Kategorie, verknüpft Referenzentitäten und kann lokalisiert, versioniert und veröffentlicht werden.

Kategorien und Attribute

Jedes Produkt gehört zu einer Kategorie, die sein Attributschema definiert. Eine frische Produzenten-Organisation bringt eine vorinstallierte Kategorie „Food (built-in)" mit, sodass Sie sofort ein konformes Lebensmittelprodukt anlegen können, plus Beispielkategorien (Frischwaren, verarbeitete Lebensmittel, Getränke). Kategorie-Attribute werden als strukturiertes JSON gespeichert, sodass verschiedene Kategorien sehr unterschiedliche Felder tragen können, ohne Schema-Migrationen.

Produkte anlegen

• Manuell — füllen Sie die Attribute im Produkteditor aus. Setzen Sie die Zielmärkte; die erforderlichen Sprachvarianten ergeben sich daraus.
• Per KI-Ingestion — laden Sie ein Datenblatt hoch oder fügen Sie eine URL ein und lassen Sie die Pipeline einen Entwurf extrahieren, den Sie vor dem Import prüfen. Siehe die KI-Anleitung.

Produkte nutzen einen Soft Delete: Ein gelöschtes Produkt wird mit einem Zeitstempel markiert und verschwindet aus Listen, seine Historie bleibt aber erhalten.

Referenzentitäten

Verknüpfen Sie Referenzentitäten — Allergene, Nährwerte, Zertifizierungen und andere geteilte oder eigene Typen —, statt diese Daten an jedem Produkt zu duplizieren. Entitätsbasierte Daten speisen die GS1-Global-Data-Model-Projektion, die Compliance-Bewertung und die Digitalen Produktpässe, sodass sich das einmalige Verknüpfen von Entitäten über die Subsysteme hinweg auszahlt.

Versionierung

Produktbearbeitungen werden automatisch versioniert. Jede Aktualisierung schreibt einen Schnappschuss des vorherigen Zustands in die Versionshistorie und erhöht die Versionsnummer des Produkts, in einer einzigen Transaktion — sodass Sie stets eine vollständige, prüfbare Historie haben und genau sehen, was sich wann geändert hat.

Lokalisierung

PIE speichert einen kanonischen Satz von Attributen plus Overrides je Sprachvariante. Sie bearbeiten eine bestimmte Sprachvariante (zum Beispiel de-DE, de-CH, fr-CH), und nur die von Ihnen übersetzten Felder werden überschrieben; alles andere fällt auf den kanonischen Wert zurück. Qualität und Compliance werden je Sprachvariante bewertet, mit deaktiviertem Fallback, sodass eine fehlende Übersetzung als fehlend gewertet wird statt still zu bestehen. Die aktivierten Sprachvarianten stammen aus Ihren Organisationseinstellungen und den Zielmärkten Ihres Produkts.

Assets

Assets werden bibliotheksorientiert verwaltet: Ein Asset wird über Asset-Verknüpfungen mit Produkten verbunden, nicht von einem einzelnen Produkt besessen, sodass dasselbe Bild oder Dokument mehrere Produkte hinterlegen kann.

Sie können Bilder (JPEG, PNG, WebP, bis 20 MB), PDFs (bis 50 MB) und Videos (MP4, WebM, QuickTime, bis 100 MB) hochladen. Videos werden unverändert gespeichert und ausgeliefert — es gibt keine Transkodierung und kein Vorschaubild.

Uploads laufen nie über den API-Server. Der Ablauf ist:

1. Eine Presigned-Upload-URL für das Produkt anfordern.
2. Die Binärdatei mit dieser URL direkt in den Objektspeicher hochladen.
3. Den Upload bestätigen — die API speichert dann nur die Asset-Metadaten (Bucket, Key, MIME-Typ, Größe).

Beim Bestätigen wird die tatsächlich im Speicher gelandete Datei geprüft, nicht die Angaben der Anfrage: Die reale Größe wird gegen das Limit geprüft und die ersten Bytes gegen den angegebenen Typ. Eine Datei, die eine der beiden Prüfungen nicht besteht, wird abgelehnt und gelöscht.

Ableitungen (Thumbnails und andere abgeleitete Größen) werden aus Rendition-Voreinstellungen erzeugt, die Sie unter „Einstellungen“ verwalten. Eine Voreinstellung namens thumbnail wird für Sie angelegt; sie sorgt dafür, dass jeder neue Bild-Upload automatisch ein Thumbnail erhält. Videos haben keine Ableitungen.

Beim Ansehen oder Herunterladen eines Assets ist die URL eine kurzlebige, bedarfsweise erzeugte Presigned-URL — Asset-URLs werden nie gespeichert oder direkt ausgeliefert.

Veröffentlichen

Beim Veröffentlichen durchläuft ein Produkt die von Ihrer Organisation aktivierten Sperren — Qualität, Compliance, GS1-Bereitschaft und Workflow-Genehmigung. Einmal veröffentlicht, kann ein Produkt Abnehmern über Freigaben bereitgestellt, an Kanäle und Portale syndiziert und als Digitaler Produktpass veröffentlicht werden.