Comprendre le modèle d’extension
Une extension est une capacité installable qui enrichit Ormuz. Elle décrit ce qu’elle sait faire et les contrats qu’elle expose ; une extension config est l’instance configurée de cette extension dans le périmètre d’un marchand.
Extension et extension config
| Concept | Responsabilité | Durée de vie |
|---|---|---|
| Extension | Déclare une capacité réutilisable : configuration, channels, nodes, tools, événements, objets externes et autres contributions prises en charge. | Versionnée et maintenue par son éditeur. |
| Extension config | Rend l’extension opérante pour un marchand donné et porte la configuration nécessaire à cette installation. | Créée, activée, suspendue ou supprimée dans le périmètre du marchand. |
Ormuz n’utilise pas une abstraction parallèle de « module ». Une capacité optionnelle suit le même modèle d’extension qu’elle appelle un service externe ou qu’elle fournisse une fonctionnalité native installable.
Ce qu’une extension peut apporter
Une extension peut combiner plusieurs contributions sans être obligée de toutes les fournir.
Configuration
Champs de configuration, secrets fournis par le marchand et politique d’activation.
Échanges
APIs consommées ou exposées, événements reçus ou envoyés et authentification associée.
Données
Objets externes typés, projections vers des objets plateforme et correspondances durables.
Orchestration
Nodes de processus et événements déclencheurs. Des process templates peuvent être distribués séparément lorsqu’une composition réutilisable doit accompagner l’extension.
Agents
Tools explicitement conçus pour être sélectionnés et utilisés par un Agent, indépendamment du catalogue de nodes.
User Journeys
Actions participant-facing chargées à la demande pour une UI embedded ou une interaction externe fournie par l’extension.
Types d’extension
Le contrat actuel reconnaît trois types structurels.
| Type | Quand l’utiliser |
|---|---|
provider_integration | L’extension relie Ormuz à un service ou fournisseur externe qu’Ormuz orchestre. |
host_connector | L’extension relie Ormuz à un système métier qui ancre le marchand dans son SI, par exemple un ERP ou une plateforme e-commerce. |
bundle | L’extension regroupe des capacités installables sans exposer de channel externe propre. |
Le type décrit la forme de l’extension ; il ne détermine ni son niveau de confiance, ni la relation commerciale du partenaire, ni les droits que l’extension obtient à l’exécution.
Ne pas confondre les axes
| Axe | Question | Ce qu’il ne décide pas |
|---|---|---|
| Type de partenaire | Quelle relation l’organisation entretient-elle avec Ormuz ? | Les droits runtime d’une extension. |
| Capacités de l’extension | Qu’expose le produit construit ? | Son niveau commercial. |
| Statut de distribution/confiance | Dans quel cadre l’extension peut-elle être distribuée ? | Une permission implicite sur les données. |
| Niveau de partenariat | Quelle maturité et quels bénéfices caractérisent la relation ? | L’autorité métier de l’extension. |
Cette séparation est un invariant de gouvernance : un statut partenaire plus élevé ne remplace jamais les permissions, le consentement marchand, les règles d’autorité ou la classification de risque.