Moteur et API
Persister l’état produit et traiter les événements
Stockez l’état canonique du designer, restaurez-le sans risque et connectez l’hôte sans lire les objets internes du rendu.
Vue d’ensemble du guide
Avant de commencer
- Une instance atteint l’état ready.
- L’hôte possède un endpoint de persistance authentifié.
- L’intégration conserve les versions du moteur et du schéma.
Résultat attendu
Un produit ou design client sauvegardé est restauré à l’identique, avec autosauvegarde contrôlée et erreurs compréhensibles.
Utiliser l’état exporté comme source de vérité
Persistez uniquement l’état public sérialisable. Les objets canvas, meshes Babylon, nœuds DOM et états internes de modules ne sont pas un format de stockage durable.
Enregistrez les versions du moteur et du schéma, l’identifiant produit et la date de mise à jour avec le payload.
Exporter via l’API publique.
Ajouter les métadonnées de version et de produit.
Valider côté serveur.
Enregistrer de façon atomique.
Écouter les événements utiles
Écoutez les événements de produit, vue, sélection, validation, prix et export selon le parcours hôte. Une autosauvegarde peut suivre les changements d’état, mais doit être temporisée pour éviter une requête à chaque frame de déplacement.
Gardez les actions commerce explicites : une sauvegarde réussie n’est pas un ajout au panier.
Enregistrer les listeners après ready.
Temporiser la sauvegarde du brouillon.
Afficher les états en attente et enregistré.
Se désabonner à la destruction.
Restaurer et récupérer
Chargez l’état après configuration des adaptateurs et permissions, car la restauration peut nécessiter des médias distants. En cas d’échec de migration ou de média, conservez le dernier état valide et affichez une erreur précise.
Utilisez un identifiant de révision pour empêcher une ancienne fenêtre d’écraser une version récente.
Récupérer la dernière révision.
Importer via l’API publique.
Attendre les médias et la vue active.
Comparer l’export restauré à la révision sauvegardée.