E2E

Contexte

E2E fonctionne avec une organisation Minimax centrale ("master") comme source de vérité pour le catalogue produits. Les sous-traitants travaillent dans leurs propres organisations Minimax et ont besoin de données d'articles cohérentes pour éviter les incompatibilités de codes, noms, prix et configuration TVA.

Problème

• Un compte Minimax master doit propager les changements d'articles vers plus de 50 comptes de sous-traitants.
• La synchronisation doit être incrémentale et idempotente (pas de doublons).
• Les mappings comptables spécifiques aux sous-traitants ne doivent pas être écrasés lors des mises à jour.
• Les opérations ont besoin d'un moyen simple pour intégrer/désactiver les comptes de sous-traitants.

Objectifs du projet

• Synchroniser le catalogue d'articles master dans plus de 50 organisations Minimax.
• Implémenter une logique d'upsert déterministe : créer les articles manquants, mettre à jour les articles modifiés.
• Suivre les mappings d'articles master↔sous-traitant et les RowVersions pour une détection efficace des changements.
• Fournir des outils d'administration pour l'intégration de comptes et les contrôles opérationnels.

Contraintes et défis

• Le cycle de vie des tokens OAuth2 (expiration + rafraîchissement) doit être robuste.
• Le mapping multi-tenant doit être stable (ID article master → ID article sous-traitant).
• Les mises à jour doivent préserver les champs comptables des sous-traitants (comptes de stocks/revenus).
• L'utilisation de l'API doit rester efficace avec plus de 50 organisations.

Aperçu de la solution

Nous avons construit un petit système d'intégration qui :

• S'authentifie sur Minimax et récupère les candidats de synchronisation incrémentale depuis le compte master.
• Effectue des upserts d'articles dans chaque organisation de sous-traitant active.
• Persiste le mapping + suivi RowVersion dans MySQL pour éviter les doublons et réduire les appels API.
• Inclut une interface d'administration légère pour gérer les identifiants des sous-traitants et leur participation.

En tant que module opérationnel supplémentaire, le système peut également envoyer des e-mails de rappel automatisés pour les factures émises en retard.

Architecture et approche technique

Client API Minimax

• Récupération et rafraîchissement des tokens OAuth2.
• Helpers `GET`/`POST`/`PUT` avec authentification Bearer.
• Instances client par organisation pour le master et les sous-traitants.

Synchronisation incrémentale

• Récupère les `/items/synccandidates` du master (optionnellement avec `RecordDtModifiedFrom`).
• Charge les détails des articles et applique une logique de création/mise à jour déterministe par sous-traitant.
• Préserve les mappings de comptes des sous-traitants lors des mises à jour.

Mapping + suivi de version

• Stocke l'ID article master/RowVersion et l'ID article sous-traitant/RowVersion.
• Utilise les comparaisons RowVersion pour éviter les écritures inutiles.

Opérations d'administration

• Interface d'intégration pour ajouter des organisations Minimax de sous-traitants.
• Contrôles d'activation/désactivation pour inclure ou exclure des comptes de la synchronisation.

Stack technologique

• PHP + MySQL
• OAuth2 Minimax + REST API
• PHPMailer (automatisation des rappels de factures)
• Frontend d'administration minimal (Material Components + jQuery)

Processus d'implémentation

1. Définir le modèle de mapping et de versioning master→sous-traitant.
2. Implémenter les utilitaires client Minimax avec gestion OAuth2.
3. Construire la synchronisation incrémentale et la logique d'upsert déterministe.
4. Ajouter la persistance pour les mappings et le suivi RowVersion.
5. Construire l'interface d'administration pour l'intégration et les bascules opérationnelles.

Résultats et impact

• Catalogues d'articles cohérents sur plus de 50 organisations Minimax de sous-traitants.
• Synchronisation incrémentale et idempotente qui évite les doublons et réduit le travail manuel.
• Configuration comptable des sous-traitants préservée lors des mises à jour.
• Workflow opérationnel simple pour gérer la participation des sous-traitants.

Réflexion

Dans un environnement multi-organisation, le mapping d'identité stable et la synchronisation consciente des versions sont non négociables. La persistance des RowVersions master et sous-traitant a permis un comportement prévisible et une utilisation efficace de l'API, tandis que la préservation des champs spécifiques aux sous-traitants a évité des perturbations comptables coûteuses.

Résumé

Cette intégration maintient un catalogue d'inventaire Minimax master synchronisé dans plus de 50 comptes Minimax de sous-traitants, en utilisant des upserts déterministes, la persistance des mappings et la détection de changements basée sur RowVersion. Une interface d'administration légère supporte l'intégration et le contrôle opérationnel.