Plateforme de commande pour grossiste pharmaceutique et ERP
Une plateforme de commande B2B pour la distribution pharmaceutique en gros : un mini-programme acheteur, une console opérateur et une API Spring Boot. Des tâches planifiées récupèrent produits et stocks dans l'ERP du distributeur et lui renvoient commandes et clients, avec nouvelles tentatives.
EN BREF : Nous avons mis en place la commande en libre-service pour un grossiste pharmaceutique tout en laissant l’ERP du distributeur faire référence : des tâches planifiées récupèrent catalogue et stocks, renvoient commandes et clients avec nouvelles tentatives, et interrogent l’état des documents jusqu’à l’expédition des marchandises et l’émission des factures.
Vue d’ensemble
Pharmacies et cliniques commandent via un mini-programme. Les opérateurs gèrent produits, habilitations des acheteurs, commandes et SAV dans une console web. Produits, stocks et factures viennent toujours de l’ERP ; la plateforme n’envoie que les commandes payées et validées, avec leurs clients.
Problème
Les acheteurs en gros voulaient commander en libre-service, mais stocks, comptabilité et facturation devaient rester dans l’ERP. Les deux systèmes devaient rester cohérents via une spécification d’interface publiée côté ERP.
Contraintes
- L’ERP fait référence pour les produits, les stocks, l’état des documents et les factures.
- Les habilitations des acheteurs doivent être vérifiées avant l’achat, y compris par reconnaissance des documents de licence téléversés.
- Développement et tests doivent tourner sans accès réel au paiement, à la logistique, aux notifications ni à l’ERP.
Architecture
| Élément | Mise en œuvre |
|---|---|
| Back-end | Java 17, Spring Boot 3.3, MySQL 8, Redis, stockage objet compatible S3, migrations Flyway |
| Clients | Mini-programme d’une plateforme de messagerie pour les acheteurs ; console opérateur en Vue 3 |
| Adaptateur ERP | Bascule entre une simulation en mémoire, qui fait avancer les commandes jusqu’à « comptabilisé » et produit les factures, et l’implémentation HTTP |
| Planification | Catalogue toutes les 30 minutes ; stocks chaque minute ; envoi des commandes et clients avec nouvelles tentatives chaque minute ; interrogation de l’état des documents toutes les 5 minutes |
| Exploitation | Page d’intégration dans la console avec état et journaux de synchronisation ; synchronisation, envoi et interrogation peuvent être lancés à la main |
Décisions clés
- Récupérer et interroger, sans base partagée. La plateforme n’accède à l’ERP que par son interface publiée ; un changement de schéma d’un côté ne casse pas l’autre.
- Adaptateurs simulés d’abord. Paiement, logistique, notifications et ERP ont chacun leur simulation, ce qui permet de faire tourner en local tout le cycle de vie d’une commande, facturation comprise, sans identifiants partenaires.
- Les secrets restent hors du dépôt. La CI lance la vérification back-end, le lint, le contrôle de types, les tests et le build de la console, ainsi qu’une recherche de secrets ; seuls des fichiers d’environnement d’exemple sont commités.
Éléments de preuve
- 45 classes de test back-end et 56 fichiers de migration.
- Les documents de déploiement en production couvrent mise en production, rollback, rotation des secrets, sauvegarde et restauration.
Limites
Le volume de commandes, le nombre d’acheteurs, la date de mise en service et les conditions commerciales ne sont pas publiés.
Questions fréquentes
Comment le stock reste-t-il synchronisé avec l'ERP ?
Les produits sont récupérés toutes les 30 minutes, les stocks chaque minute. Commandes et clients sont envoyés avec nouvelles tentatives. L'état des documents est interrogé toutes les 5 minutes.
Peut-on développer sans accès au véritable ERP ?
Un adaptateur ERP simulé reproduit le cycle de vie des documents, facturation comprise.
Que se passe-t-il quand un envoi vers l'ERP échoue ?
L'enregistrement reste en file et est retenté au passage suivant, qui tourne chaque minute. Les opérateurs voient les journaux de synchronisation et peuvent relancer l'envoi depuis la console.