Aller au contenu
P

Architecture de la plateforme

PIE est une plateforme B2B à deux faces, API-first et multi-locataire pour l'agroalimentaire, construite en monorepo TypeScript.

PIE (Product Information Exchange) est une plateforme SaaS B2B à deux faces, API-first et multi-locataire pour le secteur de l'alimentation et de l'agriculture.

Les deux faces

  • Producteurs (PIP) — coopératives, exploitations agricoles et transformateurs — gèrent des données produit structurées et accordent l'accès aux acheteurs.
  • Acheteurs (PIC) — distributeurs, grossistes et chaînes de restauration — s'abonnent aux flux produit des fournisseurs et intègrent les données dans leurs systèmes.

La relation cardinale est les producteurs produisent, les acheteurs lisent ce qui leur est accordé. Tout le reste — GS1, conformité, passeports, syndication, intégration — en découle.

Les applications

PIE est livré sous forme de plusieurs applications au-dessus d'une seule API :

  • Une API REST — le système de référence et la surface d'intégration. Chaque capacité est un point de terminaison d'API ; les interfaces en sont des clients.
  • Une application producteur pour les PIP, un portail acheteur pour les PIC, une console d'administration pour le personnel de la plateforme et un site marketing/documentation (où vous lisez ceci).
  • Des workers d'arrière-plan pour les webhooks, la synchronisation, l'ingestion IA et les tâches planifiées.

Infrastructure de support : PostgreSQL (données produit + isolation des locataires), Redis (sessions, cache, files de tâches), un stockage d'objets compatible S3 (ressources), un moteur de recherche (synchronisé depuis la base de données) et un reverse proxy qui termine le TLS.

Conventions API-first

L'API est versionnée sous /api/v1/. Elle utilise partout la pagination par curseur, une enveloppe d'erreur cohérente, un en-tête d'identifiant de requête sur chaque réponse, une limitation de débit par forfait et la validation de schéma sur toutes les entrées. Les ressources sont téléversées directement vers le stockage d'objets via des URL pré-signées, jamais par le serveur d'API. Voir les guides d'API pour les détails.

Conçu pour la portabilité

La plateforme fonctionne sur une infrastructure située dans l’Union européenne, derrière un reverse proxy, et elle est conçue pour migrer vers un cloud géré en ne changeant que les chaînes de connexion et le DNS — aucun changement de code.

Où aller ensuite