Zum Inhalt springen
P

Plattformarchitektur

PIE ist eine zweiseitige, API-first, mandantenfähige B2B-Plattform für Lebensmittel und Landwirtschaft, gebaut als TypeScript-Monorepo.

PIE (Product Information Exchange) ist eine zweiseitige, API-first, mandantenfähige B2B-SaaS-Plattform für die Lebensmittel- und Landwirtschaftsbranche.

Die zwei Seiten

  • Produzenten (PIPs) — Genossenschaften, landwirtschaftliche Betriebe und Verarbeiter — verwalten strukturierte Produktdaten und geben Abnehmern Zugriff frei.
  • Abnehmer (PICs) — Händler, Distributoren und Restaurantketten — abonnieren Lieferanten-Produktfeeds und integrieren die Daten in ihre Systeme.

Die grundlegende Beziehung lautet Produzenten produzieren, Abnehmer lesen, was ihnen freigegeben ist. Alles andere — GS1, Compliance, Pässe, Syndizierung, Onboarding — hängt daran.

Die Anwendungen

PIE wird als mehrere Anwendungen über eine API bereitgestellt:

  • Eine REST-API — das System of Record und die Integrationsfläche. Jede Fähigkeit ist ein API-Endpunkt; die Oberflächen sind Clients davon.
  • Eine Produzenten-App für PIPs, ein Abnehmer-Portal für PICs, eine Admin-Konsole für Plattform-Mitarbeitende und eine Marketing-/Docs-Seite (auf der Sie dies lesen).
  • Hintergrund-Worker für Webhooks, Sync, KI-Ingestion und geplante Jobs.

Unterstützende Infrastruktur: PostgreSQL (Produktdaten + Mandantentrennung), Redis (Sitzungen, Cache, Job-Queues), ein S3-kompatibler Objektspeicher (Assets), eine Suchmaschine (aus der Datenbank synchronisiert) und ein Reverse Proxy, der TLS terminiert.

API-first-Konventionen

Die API ist unter /api/v1/ versioniert. Sie verwendet durchgängig cursorbasierte Paginierung, eine einheitliche Fehlerhülle, einen Request-ID-Header in jeder Antwort, tarifabhängige Ratenbegrenzungen und Schema-Validierung aller Eingaben. Assets werden über Presigned-URLs direkt in den Objektspeicher hochgeladen, nie über den API-Server. Die Details finden Sie in den API-Anleitungen.

Auf Portabilität ausgelegt

Die Plattform läuft auf Infrastruktur innerhalb der Europäischen Union hinter einem Reverse Proxy und ist so konzipiert, dass sie in eine verwaltete Cloud migrieren kann, wobei sich nur Verbindungszeichenfolgen und DNS ändern — keine Codeänderungen.

Wohin als Nächstes