Architecture produit
Ormuz expose plusieurs surfaces publiques qui donnent accès au même cœur fonctionnel : des objets métier communs et des processus qui orchestrent vos systèmes, vos providers et les interactions humaines.
Vue d'ensemble
Une architecture Ormuz ne commence pas nécessairement par l'API. Un système peut communiquer directement avec la plateforme, passer par un connecteur métier, utiliser une extension spécialisée ou simplement ouvrir un parcours utilisateur lorsqu'une action humaine est nécessaire.
| Surface | Utilisée par | Rôle |
|---|---|---|
| API publique | Applications et intégrations sur mesure | Créer, lire et piloter les objets et processus Ormuz directement depuis votre système. |
| Connecteurs métier & extensions | ERP, e-commerce, comptabilité et services tiers | Relier des systèmes ou providers à Ormuz derrière une intégration packagée et maintenue. |
| Console | Équipes techniques et opérateurs | Configurer les intégrations, concevoir les processus et exploiter la plateforme. |
| Parcours utilisateurs | Acheteurs, contacts et approbateurs | Présenter les actions humaines demandées par un processus dans une interface sécurisée. |
L’API publique et les connecteurs/extensions rejoignent le même cœur Ormuz. La Console configure les objets et les artefacts d’orchestration ; les parcours utilisateurs portent les interactions avec les utilisateurs finaux.
Derrière toutes ces surfaces, Ormuz ramène les échanges vers deux couches stables : les objets métier, qui décrivent l’état métier, et l’orchestration. Cette dernière comprend les Processus, les Decisions et les Agents, qui portent respectivement les parcours, les politiques déterministes et les activités IA bornées.
Cette page décrit les surfaces et responsabilités visibles par un client ou un intégrateur. Les contrats HTTP détaillés appartiennent à API & événements, et les modes d'intégration sont détaillés dans Intégrations.
API publique
L'API publique est le point d'entrée direct pour les applications et intégrations sur mesure. Elle permet de manipuler les objets métier, démarrer ou suivre des processus et recevoir les événements nécessaires à la synchronisation de votre système.
Elle n'est pas obligatoire lorsqu'un connecteur métier ou une autre extension couvre déjà votre besoin. Dans ce cas, l'extension encapsule l'intégration et expose à Ormuz des contrats compatibles avec le reste de la plateforme.
Voir API & événements pour l'authentification, les ressources, les événements et les webhooks.
Connecteurs métier & extensions
Les extensions relient Ormuz aux systèmes et services externes. Un connecteur métier est une extension spécialisée dans la connexion d'un système métier tel qu'un ERP, une plateforme e-commerce ou un outil comptable.
Les autres extensions ajoutent des capacités externes — paiement, crédit, financement, KYC, fraude, données, documents, signature ou communications — que les processus peuvent utiliser comme des étapes composables.
API directe et extensions sont donc deux approches complémentaires, pas deux couches successives obligatoires. Consultez Intégrations pour les extensions disponibles et Modes d'intégration pour choisir le bon mode.
Console
La Console est l'interface d'administration de la plateforme. Elle sert à configurer, concevoir et exploiter Ormuz ; elle n'est pas un canal d'intégration supplémentaire.
| Domaine | Capacités |
|---|---|
| Intégrations | Installer et configurer les connecteurs métier et les extensions de services. |
| Orchestration | Concevoir, publier et faire évoluer les Processus, Decisions et Agents du marchand. |
| Exploitation | Suivre les instances, inspecter les objets métier et diagnostiquer les erreurs. |
| Administration | Gérer les accès, les clés API et les paramètres du compte et du marchand. |
Parcours utilisateurs
Les parcours utilisateurs sont la surface utilisée lorsqu'un processus doit faire intervenir une personne : acheteur, contact, approbateur ou autre participant.
Elles peuvent présenter une saisie, une validation, un consentement, un paiement ou une autre action utilisateur, puis rendre le résultat au processus. Elles permettent ainsi d'intégrer une interaction Ormuz dans un parcours existant sans reconstruire cette interface dans le système hôte.
Voir Parcours utilisateurs pour le modèle d'interaction détaillé.