ConnexionPlanifier un briefing

Chapitre 2.24

Construire une solution verticale sur mesure de bout en bout

La création pas à pas du pack métier Chaîne du froid, du cahier des charges initial jusqu'à une version exécutée pour chaque unité, avec son modèle de connaissances, ses prismes, une compétence, un plugin complet et des données d'exemple. Puis comment étendre un pack existant et comment ajouter un prisme à un pack déjà livré.

Cette page a été traduite par l'IA à partir de l'original en anglais. En cas de doute, la page en anglais fait foi. Lire cette page en anglais

19 minutes de lecture

Je m'appelle Mateo Ruiz et je suis développeur chez Corrán Orbital. L'essentiel de ma semaine est consacré à notre propre logiciel de charge utile, mais ce chapitre porte sur une mission que nous avons réalisée pour un client. Larkfield & Vane assure du fret, dont une part croissante voyage dans des conteneurs frigorifiques. Lorsqu'un conteneur frigorifique perd son alimentation à quai, la température grimpe, la marchandise s'abîme et une réclamation suit quelques semaines plus tard. Larkfield souhaitait que ses équipes voient cette chaîne comme un tout dans Nexus, de la panne électrique jusqu'à la réclamation, chaque rôle ne voyant que la partie qui le concerne. C'est ainsi qu'est né le pack Cold chain.

Ce qui suit présente la construction dans l'ordre où nous l'avons réalisée, avec les écrans, les fichiers et les commandes. J'y ai laissé nos erreurs, car deux des refus auxquels nous nous sommes heurtés nous en ont appris davantage sur la plateforme que le parcours nominal. La documentation de référence se trouve dans les chapitres précédents ; j'y renvoie plutôt que de la répéter. Ceux sur lesquels je me suis le plus appuyé sont le chapitre 2.18, Le modèle d'extension, et le chapitre 2.23, Les packs métier, en gardant le chapitre 2.21, Le SDK de plugin, ouvert à côté pour le kit de développement logiciel lui-même.

Un parcours de gauche à droite composé de huit cases : « Brief », « Parcours de référence », « Modèle de connaissances », « Vues », « Compétence et plugin », « Données d'exemple et aperçu », « Révision de publication », « Promotion ». Sous la dernière case, une seconde ligne de quatre cases plus petites reliées par des flèches montre les étapes de promotion : « Espace de dév. », « Préproduction », « Unité pilote (Rotterdam) », « Toutes les unités », avec une icône de cadenas sur chaque flèche intitulée « jalon ». Une flèche en pointillés allant directement de « Espace de dév. » à « Toutes les unités » est barrée et porte la mention GATE_CANNOT_BE_SKIPPED.
La construction de Cold chain, du cahier des charges jusqu'à chaque unité.

Le cahier des charges, et qui fait quoi

Larkfield m'a attribué un poste de développeur au sein de son organisation pour la durée du projet. Ce point est important, car un pack privé destiné à un seul client est construit au sein même de l'installation de ce client, sur ses espaces de développement et ses branches de données, avec les approbations de ses équipes. Un pack destiné à plusieurs clients se construit différemment, sur un cluster éditeur contenant uniquement des données d'exemple ; le chapitre 2.25, Construire pour chaque édition, traite ce cas.

Le cahier des charges tenait sur une page :

  • Les conteneurs frigorifiques à quai et sur les navires : leur alimentation électrique, leurs excursions de température et les réclamations qui s'ensuivent.
  • Deux rôles pour commencer : un technicien frigoriste sur le quai et un contrôleur de la chaîne du froid au bureau.
  • Un pilote déployé d'abord dans l'unité de Rotterdam, puis étendu à Felixstowe.
  • Des preuves pour trois ensembles de règles : l'accord ATP pour les denrées périssables, les bonnes pratiques de distribution de l'UE pour les médicaments et les registres de sécurité alimentaire selon la méthode HACCP (analyse des dangers et points critiques pour leur maîtrise). Les réclamations relevant des règles de La Haye-Visby utilisent les mêmes relevés d'excursion ; nous les avons donc notées pour la suite, après le pilote.

Les packs métier sont une fonctionnalité Enterprise. Larkfield utilise l'édition Enterprise, la voie du pack métier m'était donc ouverte. Sur l'édition Community, la voie royale pour créer un pack n'est pas proposée du tout.

Partir de la voie royale

Tout commence sur la page Démarrer quelque chose de nouveau. Elle propose six voies royales : plugin, pack métier, vue métier, plateforme, compétence et flux de travail. Chacune crée un dépôt à partir d'un modèle versionné, un manifeste qui déclare ce dont l'élément a besoin, des tests, un espace de développement et des branches de données. Les mêmes voies fonctionnent dans la console, en ligne de commande et depuis votre IDE (environnement de développement intégré), où l'outil Workbench nexus.create accomplit le même travail avec un plan que vous confirmez au préalable.

Démarrer un nouveau projet
Démarrer un nouveau projet
Les six voies royales, chacune avec ce qu'elle produit, sa commande nexus create et son modèle figé. Notez l'encadré au bas de la page : le manifeste est appliqué de manière stricte, et non à titre indicatif, et toute version qui demande davantage de droits est bloquée jusqu'à ce que deux personnes l'examinent.

Nous avons emprunté la voie du pack métier depuis cette page, en nommant le pack cold-chain et sa première unité Rotterdam. Le résultat indique le modèle figé, domain-pack@1.6.0, et dresse la liste de ce qu'il a créé : le dépôt, un manifeste déclarant quatre portées, deux magasins de données et aucune adresse sortante, 66 tests issus du modèle, un espace de développement à Rotterdam, trois branches de données synthétiques et une entrée en brouillon dans le catalogue propre à Larkfield, que moi seul pouvais voir. La version du modèle est figée, et sa mise à niveau ultérieure se présente comme une modification soumise à examen, comme n'importe quelle autre, de sorte que le pack de personne ne bouge sous ses pieds parce qu'un modèle a évolué. J'ai tout de même utilisé l'assistant de la console pour notre premier pack, car il affiche le plan avant de créer quoi que ce soit.

Étape 1 : définir la finalité du pack

L'assistant Nouveau pack métier comporte trois étapes : présentation, modèle de connaissances, puis vérification et création. L'étape 1 pose les quelques questions qui façonnent tout ce qui suit.

Champ Ce que nous avons saisi Remarque
Nom Chaîne du froid Utilisé pour le dépôt et le catalogue
À quoi il sert Conteneurs frigorifiques à quai et sur les navires : alimentation électrique, excursions de température et réclamations qui s'ensuivent
Secteur d'activité Logistique et maritime S'appuie sur le pack Logistique et maritime
Propriétaire (Owner) La personne qui le crée Verrouillé dans l'assistant
Unités Rotterdam (pilote) Felixstowe après le pilote
Modèle domain-pack@1.6.0 Verrouillé ; les mises à niveau arrivent sous forme de modifications soumises à examen
Règles associées Accord ATP, bonnes pratiques de distribution de l'UE, registres de sécurité alimentaire Chaque règle devient une page dans la carte des preuves du pack

L'assistant dans le panneau latéral a suggéré la dernière ligne, y compris le fait que les réclamations sur le fret réutilisent les mêmes relevés d'excursion. Un encadré au bas de la page précise que rien n'est encore créé. Le dépôt, l'espace de développement et les branches de données ne sont créés que lorsque vous cliquez sur Créer à l'étape 3, après avoir pris connaissance du plan. Vous pouvez enregistrer un brouillon et y revenir plus tard.

Étape 2 : le modèle de connaissances

Le modèle de connaissances est l'ensemble des types d'éléments que le pack connaît et la façon dont ils sont liés. Cold chain est parti du modèle de base logistique, logistics-base 4.2, importé depuis le SDK, ce qui nous a donné cinq types de base sur lesquels nous appuyer (Vessel, Port, Container, Carrier et Shipment). Les types de base sont en lecture seule dans l'assistant. Si l'un d'eux doit être modifié, il l'est dans le pack auquel il appartient.

Nous avons ajouté cinq types qui nous sont propres :

Type En quoi cela consiste Propriétés
Conteneur frigorifique Un conteneur frigorifique 9
Escale de navire Un navire à un poste d'amarrage 6
Écart de température Une température hors de ses limites 8
Alimentation électrique Un point d'alimentation électrique à quai ou à bord 4
Rattacher Somme réclamée pour de la marchandise avariée 7
Nouveau pack métier : modèle de connaissances
Nouveau pack métier : modèle de connaissances
Le graphe de connaissances avec cinq types de base et cinq nouveaux types. Regardez les propriétés d'Excursion sur la droite : chaque propriété reçoit sa classe dès sa création, et l'encadré indique que les montants des réclamations sont de nature commerciale, de sorte que les vues métier des techniciens ne peuvent pas les afficher.

Chaque propriété est classée au moment où vous la créez. « Signalé par » sur une Excursion a un caractère personnel. « Valeur de la marchandise à risque » ainsi que le montant et le règlement d'une réclamation ont un caractère commercial. Cela ressemblait à de la paperasserie le premier jour, mais nous a sauvés deux fois par la suite, car les classes déterminent ce qu'une vue métier peut afficher, ce qu'une copie masquée remplace et ce qu'une ligne de journal dissimule.

Deux de nos relations rejoignent le modèle de base : une Reefer unit est branchée sur une Power supply, et une Claim fait référence à un Shipment. Le modèle de base lui-même n'est pas modifié. Une propriété que vous retirez demeure dans la version 1.0 du modèle et ne disparaît que dans une version ultérieure, afin que rien de ce qui était vrai pour les anciens enregistrements ne cesse d'être lisible.

Étape 3 : vérifier et créer

L'étape 3 est le plan. Il dresse la liste de ce qui sera créé, des portées que le manifeste déclarera, des branches de données et de l'espace de développement. Vous confirmez le plan avec votre clé d'accès, et le plan reçoit une empreinte numérique. La création suit alors ce plan à la lettre, une étape à la fois, et vous pouvez vous arrêter à n'importe quelle étape tout en conservant ce qui a déjà été créé.

Le plan pour Cold chain déclarait quatre portées :

Portée Pourquoi le pack en a besoin
Lire la télémétrie des conteneurs frigorifiques Relevés d'alimentation électrique et de température
Écrire des excursions Enregistre une excursion lorsque les limites sont franchies
Lire les expéditions Lie une réclamation à son expédition
Rédiger des brouillons de notes de réclamation Brouillons uniquement ; c'est une personne qui procède à l'envoi

Ses magasins de données étaient le graphe et les enregistrements. Il n'avait aucune adresse sortante et utilisait le profil de bac à sable Standard. L'espace de développement disposait de 4 cœurs, de 16 GiB de mémoire et de 50 GiB de stockage, d'un réseau fermé à l'exception de ce que déclare le manifeste, d'images signées uniquement et d'une expiration après 7 jours d'inactivité. Lorsqu'il prend fin, sa définition reste dans le dépôt, ce qui vous permet de le recréer à partir de là.

Les trois branches de données provenaient du générateur synthétique. Aucune donnée client n'a été copiée. Une copie masquée de Rotterdam nécessite l'accord du propriétaire des données, qui chez Larkfield est Priya Natarajan, et vous devez en faire la demande séparément.

Le manifeste du pack

Le dépôt contient le manifeste du pack, pack.json. Il indique le nom du pack, sa version, le pack dont il hérite (le cas échéant), ses groupes et son vocabulaire. Un groupe est soit une vue métier, c'est-à-dire ce qu'un rôle voit à l'intérieur du pack, soit un élément partagé, qui s'exécute sur l'ensemble des vues métier. Voici le cœur du nôtre :

{
  "id": "cold-chain",
  "name": "Cold chain",
  "version": "0.4.0",
  "clusters": [
    {
      "id": "CC01",
      "kind": "lens",
      "name": "Reefer technician",
      "seats": "Technicians on the quay",
      "purpose": "Which reefers have lost power or warmed up, and what to do next.",
      "lexicon": ["cold"],
      "menu": [],
      "screens": []
    },
    {
      "id": "CC02",
      "kind": "lens",
      "name": "Cold-chain controller",
      "seats": "Controllers in the operations office",
      "purpose": "Every excursion from first reading to closed claim, with its evidence.",
      "lexicon": ["cold"],
      "menu": [],
      "screens": []
    }
  ],
  "lexicon": {
    "core": [],
    "cold": [
      ["excursion", "a time when the temperature left its limits", ""],
      ["set point", "the temperature a reefer is told to hold", ""],
      ["shore power", "electricity from the quay rather than the ship", ""]
    ]
  }
}

Le lexique contient les termes propres au pack accompagnés d'une définition simple pour chacun, assez courte pour être lue sur un téléphone.

Outre pack.json, le manifeste déclare également ce à quoi le pack peut accéder : ses portées, ses magasins de données, ses adresses sortantes et son profil de bac à sable. Nexus accorde exactement cela et rien de plus. Chaque appel d'outil est vérifié par rapport aux portées déclarées, et toute adresse externe est bloquée à moins de figurer dans la liste. Vous pouvez consulter la déclaration, ainsi que les différences par rapport à la dernière version, sur la page Manifeste et autorisations du pack.

Vues métier : ce que voit chaque rôle

Une vue métier ne peut que restreindre ce qu'affiche sa vue de base, et cette seule règle a façonné notre conception plus que toute autre. Une vue métier affiche une partie de ce que montre sa vue de base, et les autorisations proviennent toujours des rôles : une vue métier décide de ce qu'un rôle voit dans le pack, et non de ce qu'il est autorisé à faire.

La vue métier Technicien frigoriste restreint Contrôleur des opérations, la vue de base que Larkfield utilise déjà pour le travail logistique. Dans le Constructeur de vues métier, vous cochez les cartes, les champs et les actions que la vue affiche. Les éléments que la vue de base n'affiche pas sont verrouillés.

Composant Technicien frigoriste affiche Laissé de côté
Cartes Conteneurs frigorifiques à quai, excursions ouvertes, points d'alimentation électrique, escales du jour Tout ce qui concerne les réclamations
Champs État de l'alimentation, point de consigne, dernier relevé, température la plus élevée Montant de la réclamation (absent de la vue de base), champs personnels (désactivés par défaut)
Actions Enregistrer la cause d'une excursion, demander une vérification de l'alimentation Modifier un point de consigne et clôturer une excursion (contrôleurs uniquement), rédiger un brouillon de note de réclamation
Générateur de prismes
Générateur de prismes
Le Constructeur de vues métier pour Technicien frigoriste, coché par rapport à sa vue de base. L'encadré en bas à gauche montre le refus que vous obtenez si vous cochez le montant de la réclamation : la vue de base ne l'affiche pas, cette vue ne peut donc pas l'afficher non plus.

J'ai tout de même essayé d'ajouter le montant de la réclamation à la vue du technicien, car un technicien l'avait demandé. Le constructeur a refusé avec LENS_CANNOT_WIDEN et n'a rien enregistré. Il n'y a aucun contournement possible à l'intérieur de la vue métier : la solution consiste à créer une vue sur une base plus large, ce qui constitue une demande différente sur laquelle statue l'administrateur de l'organisation. Nous l'avons laissé de côté.

Masquer un élément dans une vue métier ne le supprime pas de Nexus. Cela signifie simplement que ce rôle ne le voit pas. Le constructeur indique combien de personnes une vue métier touchera lors du pilote (29, dans notre cas) et conserve un journal de chaque Ajout, Modification et Retrait. Une vue métier est définie une seule fois pour l'organisation et attribuée par unité à un rôle de la plateforme, de sorte que la même vue Technicien frigoriste peut être donnée aux techniciens de Rotterdam ce mois-ci et à ceux de Felixstowe le mois prochain.

Une compétence pour rédiger des notes de réclamation

Les contrôleurs voulaient un premier brouillon de la note envoyée au propriétaire de la marchandise après une excursion. Il s'agit d'un travail rédactionnel, qui s'exécute donc sur un modèle, et la question était de savoir où le placer.

Il existe deux types de compétences dans Nexus, et la différence a son importance ici. Une compétence de manifeste est une ligne typée dans le fichier skills[] d'un plugin, distribuée par la plateforme. Une compétence du Skills Engine est un paquet SKILL.md situé dans la bibliothèque de compétences de l'organisation, que les agents, les boutons d'IA (intelligence artificielle), les flux de travail et les outils pour développeurs exécutent tous de la même manière. Le chapitre 2.20, Compétences, traite des deux.

Le niveau de confiance de notre plugin est community, et un plugin communautaire ne peut déclarer que des compétences de manifeste qui ne font pas appel à un modèle (host_callback et plugin_queue). Les deux niveaux qui accèdent à l'AI Provider Router, tool_using et llm_only, nécessitent le niveau de confiance core ou verified. La rédaction des brouillons de notes de réclamation est donc devenue une compétence du Skills Engine, et le routeur choisit le modèle dans le propre pool de Larkfield :

---
name: draft-claim-note
description: Draft a note to a cargo owner about one reefer excursion, from the excursion record and its readings. Drafts only; a person reviews and sends.
allowed-tools: Read, Grep
triggers:
  - /draft-claim-note
capabilities:
  - name: draft_note
    description: Write a first draft for one excursion
version: 1.0.0
---

# Draft a claim note

Use this when a controller asks for a note about one excursion.

## Steps

1. Read the excursion: unit, start, length, highest temperature and cause.
2. Read the shipment it belongs to, for the cargo owner's name.
3. Write four short paragraphs: what happened, when, what the readings show, what happens next.
4. Never state a claim amount. Never send anything.

Le paquet se trouve dans skills/draft-claim-note/ au sein du dépôt, le nom du dossier étant égal au nom de la compétence. Nous l'avons validé et téléversé depuis le terminal :

npm run skill:validate skills/draft-claim-note
npm run skill:upload skills/draft-claim-note --dry-run
npm run skill:upload skills/draft-claim-note

Téléverser deux fois le même contenu renvoie la version existante plutôt qu'une nouvelle (CONTENT_HASH_ALREADY_PUBLISHED), il est donc sans risque de relancer le téléversement. Avant qu'une version ne soit publiée, le Skills Engine exécute ses cas de test, un essai à blanc en arrière-plan sur des travaux antérieurs et une évaluation à l'aveugle par un modèle d'une autre entreprise, en indiquant la durée et le coût de chaque exécution.

Le plugin complet

Le pack avait également besoin de code fonctionnant en permanence : un lecteur pour le flux de télémétrie des conteneurs frigorifiques et un processus d'écriture qui ouvre un enregistrement d'excursion lorsqu'un relevé franchit ses limites. Un tel code a sa place dans un plugin de service complet, et nous en avons généré la structure de base avec la commande propre au SDK, qui écrit toute l'arborescence de référence en y substituant le nom :

npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin scaffold cold-chain --tier full-service
cd cold-chain
npm install
npm ci
npm run typecheck && npm test && npm run build
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test

Le SDK s'installe depuis https://registry.adverant.ai/npm/ à l'aide du jeton de récupération disponible sur la page Jetons de récupération et commandes d'installation de votre compte Adverant. Validez dans le dépôt le fichier package-lock.json généré lors de la première installation ; la construction de l'image exécute npm ci et échoue s'il est absent.

Voici la partie de notre fichier nexus.manifest.json qui diffère du modèle. Il ne s'agit pas du fichier complet : les blocs description, author, license, runtime, backend et frontend de la structure générée restent tels quels, et le validateur refuse un manifeste de service complet s'ils n'y figurent pas. Les trois phrases architecture constituent la règle que chaque plugin réénonce, et le validateur en vérifie la formulation exacte. UNO, dans la première phrase, désigne le moteur de flux de travail :

{
  "manifestVersion": "2",
  "name": "cold-chain",
  "displayName": "Cold chain",
  "version": "0.4.0",
  "tier": "full-service",
  "trust": "community",
  "architecture": {
    "compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
    "ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
    "deploy": "Deploy is through the installation's release channels only."
  },
  "api": {
    "version": "1",
    "basePath": "/",
    "endpoints": [
      { "method": "GET", "path": "/health", "summary": "Liveness", "auth": "public", "allowAnonymous": true },
      { "method": "GET", "path": "/api/excursions", "summary": "List the unit's excursions", "auth": "scope", "right": "excursion.read", "needsUnit": true },
      { "method": "POST", "path": "/api/excursions", "summary": "Record an excursion", "auth": "scope", "right": "excursion.create", "needsUnit": true },
      { "method": "POST", "path": "/internal/skills/excursion_open", "summary": "host_callback receiver the platform POSTs to", "auth": "internal" }
    ]
  },
  "rights": {
    "excursion.read": { "summary": "Read the unit's excursions.", "roles": ["owner", "admin", "member", "viewer"] },
    "excursion.create": { "summary": "Record an excursion.", "roles": ["owner", "admin", "member"] }
  },
  "skills": [
    {
      "id": "excursion_open",
      "displayName": "Open an excursion",
      "description": "Open an excursion record when a reading breaks its set point limits. No model; runs in the plugin's own backend.",
      "tier": "host_callback",
      "classification": "tenant",
      "dataResidency": "eu",
      "inputSchema": { "type": "object", "properties": { "readingId": { "type": "string" } }, "required": ["readingId"] },
      "outputSchema": { "type": "object", "properties": { "opened": { "type": "boolean" } }, "required": ["opened"] },
      "hostCallback": {
        "service": "cold-chain",
        "port": 8080,
        "path": "/internal/skills/excursion_open",
        "maxRequestBytes": 65536,
        "maxResponseBytes": 16384,
        "tenantHeader": "X-Organization-ID"
      },
      "timeoutMs": 10000
    }
  ],
  "changePolicy": {
    "enabled": true,
    "classes": ["website", "bff", "migration"],
    "approvals": { "website": 1, "bff": 1, "migration": 2 }
  }
}

excursion_open est une compétence de manifeste de niveau host_callback : la plateforme envoie les données d'entrée à notre propre Service, à l'intérieur de notre espace de noms, et jamais à un hôte que nous désignons. La route réceptrice est déclarée auth: internal et protégée par serviceMiddleware du SDK, la forme Express du garde, qui refuse tout jeton d'appel émis pour un autre plugin, une autre organisation, une autre compétence ou une autre route. Son classification est tenant, ce qui correspond au plafond pour un plugin communautaire. Le chapitre 2.27, Scénarios de construction, détaille pas à pas une compétence host_callback à part entière.

Deux habitudes prises à cette étape méritent d'être reproduites. Chaque table comporte organization_id, owner_user_id et business_unit_id dès la première migration, car ajouter un axe plus tard implique une migration sur des lignes en production. Et nous avons exécuté nexus-gates localement avant chaque envoi vers le dépôt, puisque c'est la même commande que le pipeline exécute ; une exécution qui n'a rien examiné se termine avec le code 2 et l'indique clairement. Le chapitre 2.19, Les règles dont hérite chaque extension, dresse la liste des points de contrôle.

Données d'exemple pour les tests

La page Données d'exemple pour les tests propose trois types de branches :

Type Contenu Qui donne son accord
Synthétique Données générées à partir de volumes et de formes que vous définissez ; rien ne provient d'une unité réelle Personne ; elles vous appartiennent
Copie masquée Une copie d'une unité où les champs personnels, sensibles et commerciaux sont remplacés Le propriétaire des données (Priya Natarajan pour Rotterdam)
Schéma uniquement La structure des magasins de données, sans aucune ligne Personne ; pour les migrations

Nous avons généré une semaine chargée : environ 7 excursions pour 100 conteneurs frigorifiques, ce qui correspond à un mois d'août chargé à Rotterdam. Les cas particuliers importaient davantage que le volume. Nous avons demandé une perte d'alimentation pendant le déchargement, une porte laissée ouverte, une interruption de capteur et deux réclamations pour une même excursion. La page peut suggérer des cas particuliers à partir des causes d'excursion présentes dans le modèle de connaissances, mais jamais à partir d'enregistrements réels.

Chaque ensemble de volumes et de formes est enregistré sous forme de graine, telle que cold-chain-busy-01, avec son empreinte numérique. La même graine produit les mêmes données, de sorte que chaque exécution de test sur chaque branche voit exactement la même semaine. C'est ce qui a rendu nos 66 tests reproductibles.

Une branche a une durée de vie de 72 heures par défaut et de 14 jours au maximum. J'ai demandé à conserver notre branche de semaine chargée pendant 30 jours lors d'une longue révision, et la page a refusé avec BRANCH_LIFE_EXCEEDED. La solution est celle que suggère l'encadré : conservez la graine et créez une nouvelle branche à partir d'elle lorsque vous en avez besoin. Une copie masquée obéit aux mêmes limites, et sa demande doit comporter un motif ainsi qu'une durée maximale de 14 jours.

Prévisualiser un prisme en tant qu'utilisateur

Avant que quiconque à Rotterdam ne voie Cold chain, nous l'avons examiné comme ils le feraient. Prévisualiser une vue métier en tant qu'utilisateur affiche le pack exactement comme le voit un rôle donné, sur une branche de données, à l'intérieur d'un cadre de prévisualisation en pointillés.

Prévisualiser une vue métier en tant qu'utilisateur
Prévisualiser un prisme en tant qu'utilisateur
Cold chain tel que le voit un technicien frigoriste de Rotterdam, sur une branche synthétique. Remarquez la colonne de réclamation marquée « masqué par la vue métier » sur chaque excursion ouverte, ainsi que le panneau latéral qui indique ce que cette vue masque et pourquoi.

Trois règles permettent d'utiliser les prévisualisations librement et en toute sécurité. Une prévisualisation utilise une branche de données, jamais l'unité en production. Vos propres autorisations n'y filtrent pas, de sorte que vous voyez ce que le rôle voit et non ce que vous pouvez voir. Enfin, elle prend fin au bout de 30 minutes. Faire pointer une prévisualisation vers une unité en production est refusé avec CONNECTION_SCOPE_EXCEEDED ; si vous avez besoin de formes de données réelles, demandez une copie masquée au propriétaire des données et effectuez la prévisualisation sur celle-ci.

C'est grâce à la prévisualisation que nous avons repéré une véritable erreur. Le graphique de température sur la vue du technicien affichait le point de consigne, alors que la modification du point de consigne était réservée aux seuls contrôleurs. Le graphique ne posait pas de problème ; le bouton de modification situé en dessous, si. La version 0.3.2 a masqué la modification du point de consigne aux techniciens, et c'est dans la prévisualisation que nous l'avons découvert.

Modifier le modèle de connaissances après sa livraison

À la version 0.4.0, nous avions besoin d'un type Inspection pour les inspections avant départ, et la relation « Excursion a causé Claim » se lisait mieux sous la forme « Excursion a conduit à Claim ». Faire passer le modèle de la version 1.3 à la version 1.4 constitue une modification du modèle de connaissances, et la page Modifications du modèle de connaissances affiche ses différences, ce qu'elle affecterait et son état d'avancement.

La modification circule sous la forme d'une demande de modification du graphe. Son essai à blanc compte ce qu'elle affecterait sur la copie masquée de Rotterdam, sous forme de totaux : pour nous, 1 284 liens renommés et aucune suppression. Deux réviseurs l'approuvent, puis le pipeline l'applique à la préproduction, et ensuite au pilote. Personne n'écrit manuellement dans le graphe partagé ; toute tentative est refusée et enregistrée. Trois questions enregistrées utilisaient l'expression « a causé », et la modification comportait une réécriture automatique pour chacune d'elles, que la page a répertoriée. Les filtres des vues métier n'ont pas changé, car les deux vues se contentaient toujours de restreindre l'affichage.

Promouvoir en production

Chaque version suit un chemin unique : espace de développement, préproduction, unité pilote, puis toutes les unités. Chaque étape comporte des points de contrôle, et rien ne peut en contourner un.

Vers Contrôles
Préproduction Tous les tests réussissent ; contrôles de qualité ; manifeste inchangé ou élargissement accepté ; image signée
Pilote (Rotterdam) Essai à blanc de la modification du modèle sur la copie masquée sans erreur ; vérification des règles de politique sur les vues métier et les portées ; deux réviseurs distincts de l'auteur, dont le propriétaire des données
Toutes les unités 14 jours dans le pilote ; taux d'erreur inférieur à 1 sur 1 000, mesuré dans le pilote ; accord de chaque administrateur d'unité pour son unité ; deux réviseurs distincts de l'auteur
Environnements et promotion
Environnements et promotion
Cold chain 0.3.2 en attente de son second réviseur au point de contrôle du pilote. L'encadré sur la droite montre le refus opposé à une tentative de promotion directe depuis un espace de développement vers toutes les unités.

J'ai tenté le raccourci une fois, un vendredi, pour un correctif d'une seule ligne : promouvoir la version 0.4.0-dev depuis mon espace de développement vers toutes les unités. Cela a été refusé avec GATE_CANNOT_BE_SKIPPED, et rien n'a été promu. L'encadré vous invite à promouvoir plutôt vers l'étape suivante, et c'est la seule réponse possible.

L'examen de mise en production proprement dit, les preuves que lit un second réviseur et les canaux que choisissent les unités sont détaillés au chapitre 2.28, Publier votre extension. Deux éléments issus de ce chapitre ont leur place ici, car ils façonnent la manière dont vous planifiez une solution verticale. L'auteur ne compte jamais comme réviseur, de sorte qu'une équipe de deux personnes a besoin d'une troisième personne pour chaque publication. De plus, chaque environnement conserve la version précédente pendant 30 jours ; revenir en arrière est donc une modification soumise à examen que le pipeline exécute en une minute environ.

Étendre un pack existant

Toutes les solutions verticales ne partent pas de zéro. Un pack peut hériter d'un autre et n'ajouter que ce qui diffère. Le pack Banque et paiements, qu'utilise Larchmont Bank, en est l'exemple le plus clair dans le catalogue. Son manifeste commence ainsi :

{
  "id": "fintech",
  "name": "Banking and payments",
  "version": "0.1",
  "inherits": "insurance",
  "clusters": [
    {
      "id": "FL01",
      "kind": "lens",
      "name": "Lending decisions",
      "seats": "Credit analysts, underwriters of loans, credit committee",
      "purpose": "Whether to lend, how much, at what price, and writing down why.",
      "lexicon": ["fin"],
      "menu": [],
      "screens": []
    }
  ],
  "lexicon": {
    "core": [],
    "fin": [
      ["APR", "the yearly cost of borrowing, fees included", "exact"],
      ["mandate", "the most one person may lend alone", ""]
    ]
  }
}

inherits désigne le pack sur lequel il s'appuie. Banque et paiements conserve la structure du pack Assurance, ses groupes de conversation partagés et son vocabulaire de base, et y ajoute trois vues métier qui lui sont propres : Décisions de prêt, Litiges liés aux cartes et Mon compte. Le troisième élément de chaque entrée du lexique est exact pour un terme qui doit être affiché tel qu'il est écrit, comme APR (taux annuel effectif global), plutôt que reformulé.

Il y a certaines choses que vous ne pouvez pas faire par héritage. Un pack ne modifie jamais l'interface globale, les composants ou les règles d'écriture ; un pack enfant ne peut donc pas modifier le style de la console. Un régime réglementaire dont plusieurs packs ont besoin prend la forme d'une vue métier partagée unique plutôt que d'une copie dans chacun d'eux : le registre des technologies externalisées sert ainsi à la fois Assurance et Banque et paiements. Si votre pack enfant a besoin d'une vue métier qui existe déjà en tant que vue partagée, utilisez-la au lieu de concevoir la vôtre.

L'octroi de licences suit l'héritage. Un pack fait l'objet d'une licence en complément d'Enterprise et peut nécessiter des modules complémentaires, et le document de licence mentionne ces dépendances. Le pack Assurance nécessite Salles de décision et enregistrements scellés ; par conséquent, un client qui prend une licence pour un pack qui en hérite a également besoin de ce module complémentaire, et la console refuse d'émettre une licence qui l'omettrait. Les écrans pour téléphone d'un pack nécessitent également le module complémentaire Applications mobiles. Vérifiez toute la chaîne des prérequis avant de promettre une date à un client.

Ajouter un prisme à un pack déjà livré

Le plus petit travail vertical consiste à créer une nouvelle vue sur un pack que vous n'avez pas écrit. Six mois après le début du pilote, l'équipe des sinistres maritimes de Larkfield souhaitait disposer de sa propre vue au sein de Cold chain : excursions et réclamations, sans prises d'alimentation, sans points de consigne. Nous n'avons pas touché au code du pack. Une vue correspond à une ligne dans le registre des vues de l'organisation, détenue par le pack ; nous l'avons donc initiée à partir du parcours de référence de vue sous Démarrer un nouveau projet et façonnée dans le Constructeur de vues en prenant la vue du contrôleur Cold-chain comme base. La même règle qu'auparavant s'applique : la nouvelle vue peut masquer ce que sa base affiche et ne peut jamais en montrer davantage. Elle est définie une seule fois pour l'organisation et attribuée à un rôle de plateforme dans chaque unité. Une attribution est retirée, jamais supprimée, et accorder à nouveau la vue crée une nouvelle attribution, de sorte que l'historique indiquant qui détenait quelle vue et à quel moment reste lisible. Le registre compte le nombre de personnes ayant détenu une vue chaque mois, jamais leur identité.

La page Les vues et qui les voit affiche le résultat sous la forme d'une matrice croisant les vues par unité et par rôle, avec les options Ajouter, Modifier et Retirer dans chaque cellule. Prévisualisez la nouvelle vue sous l'identité d'une personne avant de l'attribuer, exactement comme indiqué ci-dessus.

Ce que cela a coûté, en toute transparence

Un pack touche aux enregistrements d'un client ; la plateforme ralentit donc volontairement certaines opérations, et vous devez les anticiper dès le premier jour.

  1. Une copie masquée nécessite l'accord du propriétaire des données à chaque fois. La nôtre a mis une journée à arriver la première fois, car Priya souhaitait d'abord lire le modèle de connaissances. Commencez avec des données synthétiques et faites votre demande tôt.
  2. L'auteur ne peut pas approuver sa propre publication, et les demandes expirent après 3 jours. Si vos réviseurs sont occupés, votre publication attend.
  3. Une publication qui demande plus d'autorisations que la précédente, comme l'envoi d'e-mails ou l'accès à une adresse externe, est bloquée jusqu'à ce que deux réviseurs acceptent le manifeste élargi. Le Chapitre 2.28, Publier votre extension, présente la page Manifeste et autorisations qui vous en informe avant même votre demande.
  4. Une vue ne peut pas afficher ce que sa vue de base masque. Si un rôle a réellement besoin d'en voir plus, cela relève d'une discussion avec l'administrateur de l'organisation, et non d'un paramètre.

Aucun de ces points ne nous a freinés deux fois. La deuxième publication de Cold chain a pris une semaine entre le premier commit et le pilote de Rotterdam, l'essentiel de ce temps ayant été consacré à l'exécution des 66 tests sur trois branches et à la lecture des preuves par deux personnes.