Version 1.0.0-alpha.1dernière version
Chapitre 2.23
Packs métier
De quoi est fait un pack métier et ce que contient son fichier pack.json ; les prismes et le registre des prismes ; les modèles de connaissances, les connecteurs et les surcouches mobiles ; comment un pack est concédé sous licence et activé pour une unité ; et les dix packs fournis par Adverant.
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

Le pack que j'ai créé chez Corrán Orbital a débuté sous la forme de deux plugins et d'une douzaine de compétences du Skills Engine que seule notre équipe de station au sol utilisait. Lorsque l'unité des opérations de mission a demandé la même chose, j'avais le choix : tout copier et maintenir chaque élément en double, ou en faire un pack métier avec un seul modèle de connaissances et deux vues, activé par unité. Il m'a fallu une semaine pour en faire un pack. Je referais le même choix demain, et la prochaine fois, je commencerais directement par le pack.
Un pack métier transpose les méthodes de travail d'un secteur d'activité dans Nexus. Il contient les types d'objets propres au secteur, la façon dont ils sont liés et ce que chaque rôle voit. Il intègre les modèles et les flux de travail utilisés au quotidien, les preuves exigées par la réglementation du secteur, ainsi que les écrans fonctionnant sur téléphone hors réseau. Il ne modifie jamais l'interface principale ou ses composants, ni les règles de rédaction. Un nouveau secteur correspond à un pack, pas à une application.
De quoi est fait un pack
En coulisses, un pack repose sur quatre éléments, et aucun d'eux n'est du code spécifique au pack dans la plateforme :
- Un ensemble de groupes de fonctionnalités dans le contrôle des droits. Les commandes du pack appartiennent à un ensemble de groupes de fonctionnalités. Chaque ligne de menu et chaque onglet de panneau ajouté par le pack est alors régi par le même mécanisme que le reste de Nexus : autorisé, affiché en aperçu ou masqué.
- Un manifeste de pack,
pack.json, qui déclare les groupes d'écrans du pack et son vocabulaire, ses vues et ses écrans mobiles. - Des modules fermés qui vérifient leur propre octroi. Le code serveur qui prend les décisions, tel que les cerveaux compilés d'un pack, intègre le vérificateur de licence et contrôle lui-même la licence signée. Rien en dehors du module ne peut l'activer.
- Une entrée de catalogue, afin que le pack apparaisse sur la page des packs métier avec ce qu'il apporte et ce qu'il requiert.
Par-dessus ces éléments reposent les parties visibles par les utilisateurs : le modèle de connaissances et les vues ; les modèles, les flux de travail et les compétences du Skills Engine ; les connecteurs en lecture seule vers les systèmes qui détiennent déjà les enregistrements, une table de correspondance des preuves reliant chaque règle aux enregistrements qui y répondent, ainsi qu'une surcouche mobile.
Le fichier pack.json
Voici le manifeste du pack Banque et paiements, réduit à une vue avec un poste, et deux termes. Son identifiant de fichier est fintech, et name contient le nom de travail du pack ; la console et le catalogue l'affichent sous le nom Banque et paiements.
{
"id": "fintech",
"name": "Financial services",
"version": "0.1",
"inherits": "insurance",
"screenCount": 10,
"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": [
{ "id": "FL01-A01", "title": "Credit desk today", "who": "Omar Haddad, credit analyst", "doing": "Seeing which applications are waiting and which rule held each one" },
{ "id": "FL01-A04", "title": "Refer to credit committee", "who": "Omar Haddad, credit analyst", "doing": "Sending a loan above his mandate to two people who can decide it" }
]
}
],
"lexicon": {
"core": [],
"fin": [
["affordability", "whether someone can pay it back without hardship", ""],
["mandate", "the most one person may lend alone", ""]
]
},
"world": {
"tenants": [
{
"id": "larchmont",
"name": "Larchmont Bank",
"kind": "bank",
"market": "GB",
"locale": "en-GB",
"people": 212,
"plan": { "areas": ["H", "C", "E", "B", "X", "FL01", "FL02", "FL03"], "of": 12 },
"ai": { "onDevice": "allowed", "personalDataToCloudModels": "uk-only", "sealRequiresUno": true }
}
],
"seats": [
{
"id": "credit-analyst",
"person": "Omar Haddad",
"tenant": "larchmont",
"title": "Credit analyst",
"lens": "FL01",
"clusters": ["C", "E", "B", "X"],
"home": "FL01-A01",
"posture": "desk"
}
]
}
}Les champs, de haut en bas :
| Champ | Ce qu'il indique |
|---|---|
id |
L'identifiant du pack, en minuscules |
name |
Son nom de travail |
version |
La version propre au pack |
inherits |
Le pack sur lequel celui-ci s'appuie. Banque et paiements hérite d'Assurance, qui détient les groupes partagés utilisés par chaque pack, tels que la conversation et les paramètres. Un nouveau pack ajoute ses vues et laisse les groupes partagés au pack dont il hérite |
screenCount |
Le nombre d'écrans définis par le pack |
clusters[] |
Les groupes d'écrans du pack. Chacun possède un id, un kind, un name, le seats auquel il est destiné, son purpose, les ensembles lexicon d'où proviennent ses termes, son menu et ses screens, chacun avec un id, un title, des who et ce pour quoi ils sont doing |
clusters[].kind |
shared pour un groupe accessible par chaque vue (la conversation, par exemple) ; lens pour les écrans propres à un rôle. Le scope d'un groupe indique s'il appartient au socle (core) ou au secteur (domain) |
lexicon |
Le vocabulaire du pack, réparti dans des ensembles nommés. Chaque terme comporte une définition simple qu'un nouvel arrivant peut comprendre, et le troisième emplacement est exact pour un terme qui doit être utilisé mot pour mot, tel qu'un chiffre réglementaire |
world |
L'environnement d'exemple composé de locataires et de postes fictifs qu'utilisent les écrans et les tests du pack, ainsi que ses branches de données |
world.tenants[].plan |
Le areas du forfait : les groupes et les vues que le forfait de ce locataire ouvre, parmi of |
world.tenants[].ai |
La politique d'IA (intelligence artificielle) de l'organisation pour le pack : si les modèles sur l'appareil sont autorisés (onDevice), où les données personnelles peuvent être envoyées vers un modèle cloud (personalDataToCloudModels, tel que uk-only ou eu-only), et si le scellement d'un enregistrement nécessite un envoi UNO (sealRequiresUno) |
world.seats[] |
Le poste d'une personne : son title, la lens qu'elle détient, les clusters partagés auxquels elle accède également, son écran home, son posture (desk, field ou consumer) et, dans le fichier complet, ses authority, les limites dans lesquelles elle agit |
Deux règles régissent ce qu'un fichier pack.json peut contenir. Une réglementation est nommée en toutes lettres avec une définition explicative, jamais sous la forme d'un simple sigle. Et rien dans le fichier n'est du code : il s'agit d'une définition lisible que le serveur et les applications interprètent ; il ne contient donc jamais de règle ou d'invite, ni jamais de cerveau compilé.
Prismes partagés
Certains régimes appartiennent à plusieurs secteurs. Un registre des technologies externalisées sert à la fois aux packs Assurance et Banque et paiements ; les horloges d'incident (les comptes à rebours avant la remise des rapports attendus par un régulateur après un incident) servent à la fois aux packs Infrastructures critiques et énergie et Gouvernement et secteur public. Un régime utilisé par plusieurs packs est écrit une seule fois sous la forme d'une vue partagée. Chaque pack qui en a besoin l'inclut. Lorsque la règle change, elle change à un seul endroit.
Un prisme ne fait que restreindre
Une vue correspond à ce qu'un rôle voit à l'intérieur d'un pack ou d'une plateforme : quelles fiches et quels champs, et quelles actions. Elle est toujours définie comme une restriction d'une vue de base. Une vue rattachée à une base n'affiche aucun type d'objet que sa base n'affiche pas et n'ouvre aucune zone que sa base n'ouvre pas, et elle ne peut pas à la fois afficher et masquer le même type. Les autorisations proviennent toujours des rôles ; une vue modifie l'affichage, jamais ce qu'une personne est autorisée à faire.
Essayez d'en élargir une et la réponse sera LENS_CANNOT_WIDEN (422), sans aucun enregistrement. Dans le générateur de vues, pour une vue de technicien frigoriste construite sur une base de contrôleur des opérations qui n'affiche pas les montants des réclamations, cela se traduit par : « Le montant de la réclamation ne peut pas être ajouté à cette vue ». La solution consiste à utiliser une vue de base différente, ce qui implique une demande différente auprès du responsable de la base.
La règle est conservée dans la base de données, et pas uniquement dans la route. Les vues de chaque organisation résident dans quatre tables du schéma du registre des plugins :
| Tableau | Contenu |
|---|---|
plugins.lenses |
Une vue d'un propriétaire, un pack (owner_kind pack) ou une plateforme (platform) : son slug et son name, sa base_lens_id, les types qu'elle shows et hides, les zones qu'elle opens, son status (active ou withdrawn) et son version |
plugins.lens_grants |
Une vue attribuée à un rôle (owner, admin, member, viewer, developer ou billing_admin) dans une unité opérationnelle |
plugins.lens_changes |
Chaque modification apportée à une vue ou à ses octrois, conservée avec l'état avant et après, l'auteur et le motif. En ajout seul |
plugins.lens_holder_months |
Le nombre de personnes détenant une vue dans une unité chaque mois. Un décompte, jamais l'identité des personnes |
Un déclencheur refuse toute vue qui affiche plus d'éléments que sa base, et refuse toute modification d'une base qui ferait qu'une vue construite sur elle affiche plus d'éléments qu'elle. Rien n'est supprimé. Les vues et les octrois sont retirés, et réattribuer une vue crée une nouvelle ligne ; une modification n'est jamais réécrite, et le décompte d'un mois passé n'est jamais modifié. Chaque ligne cite une vue de sa propre organisation via une clé composite, de sorte qu'un octroi ne peut pas pointer vers une autre organisation.
La console et vos propres outils accèdent au registre via /api/v1/lenses, avec le jeton au porteur propre à la personne. L'organisation et la personne, ainsi que le poste de l'unité, proviennent du jeton vérifié et de rien d'autre.
| Méthode et chemin | Ce qu'il fait |
|---|---|
GET / |
Vues, filtrées par owner_kind, owner_id et status, avec leurs octrois dans votre poste |
POST / |
Ajouter une vue : owner_kind, owner_id, slug, name, shows, et en option description, base_lens_id, hides, opens et reason |
GET /owners/:kind/:id |
Les vues d'un pack ou d'une plateforme, et laquelle d'entre elles affiche chaque type |
GET /owners/:kind/:id/grants |
Vue par unité : les rôles auxquels chaque vue est attribuée et les personnes concernées |
GET /owners/:kind/:id/holders |
Personnes détenant une vue chaque mois (months, six par défaut) |
POST /owners/:kind/:id/holders/count |
Enregistrer les décomptes de ce mois |
GET /owners/:kind/:id/changes |
L'historique des modifications des vues du propriétaire (limit, 50 par défaut) |
GET /:lensId |
Une vue avec sa base et les vues qui la restreignent, ainsi que ses octrois et ses modifications |
PATCH /:lensId |
Modifier une vue : name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Retirer une vue, ainsi que ses octrois. Une vue restreinte par une autre vue active ne peut pas être retirée tant que cette dernière ne l'est pas |
POST /:lensId/grants |
Attribuer une vue : business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Retirer un octroi |
:kind est pack ou platform. Chaque refus comporte un code accompagné d'une phrase et d'une étape suivante, et une défaillance inattendue renvoie UNHANDLED_ERROR avec sa cause dans le journal du service, jamais dans la réponse.
Modèle de connaissances, connecteurs et cerveaux compilés
Le modèle de connaissances correspond aux types d'objets que le pack connaît et à la façon dont ils sont reliés. Il est versionné, et un pack s'appuie généralement sur un modèle de base issu du pack dont il hérite : un pack de chaîne du froid basé sur le modèle de base logistique ajoute cinq types (dont l'unité frigorifique et l'escale de navire) et relie deux d'entre eux à la base sans modifier la base elle-même. Chaque propriété est classée dès sa création, de sorte que les champs personnels et les champs commerciaux sont connus avant même qu'une vue ou une branche de données ne les utilise. Une vue destinée aux techniciens ne peut alors pas afficher un montant de réclamation classé comme commercial. Une propriété retirée reste dans la version qui la contenait et ne disparaît que dans une version ultérieure. La préparation d'une nouvelle version copie d'abord les connaissances, et le retour en arrière reste ouvert pendant une période définie.
Les connecteurs importent les enregistrements depuis les systèmes qui les détiennent déjà : administration des polices, système de gestion des sinistres, dossier de messagerie contenant des fichiers envoyés par des partenaires. Chacun est en lecture seule, s'exécute selon sa propre planification et dispose d'un bouton de test. Les enregistrements sont mis en correspondance avec le vocabulaire du pack à l'entrée et arrivent dans le modèle de connaissances que lisent les vues ; les réponses de l'assistant le citent. Rien n'est réécrit dans le système source depuis Nexus.
Les cerveaux compilés sont les parties d'un pack qui prennent les décisions : le cerveau de souscription du pack Assurance et son cerveau de gestion des sinistres, par exemple. Ils s'exécutent sur le serveur sous forme de modules compilés sous licence, chacun vérifiant lui-même la licence, et ils ne sont jamais transmis à un téléphone ou à un navigateur.
La surcouche mobile et les champs hors ligne
Un pack déclare ses écrans mobiles dans le même manifeste, sous la forme d'une surcouche mobile : quelles fiches et quelles étapes de saisie apparaissent sur les téléphones, et pour quels rôles. Un administrateur définit ensuite les règles sur les téléphones par organisation, par exemple la durée pendant laquelle les saisies peuvent attendre hors ligne, si chaque photo indique le lieu où elle a été prise et si les approbations nécessitent une clé d'accès. La configuration reste sur un ordinateur ; l'administrateur voit ce que les téléphones envoient sous forme de noms et de décomptes, jamais les photos ou les notes elles-mêmes.
Chaque champ proposé par un écran de téléphone hors réseau déclare l'une des trois classes suivantes, et l'écran indique laquelle :
| Classe | Ce qu'il en advient | Exemples |
|---|---|---|
| Rédigé hors ligne | Enregistré sur le téléphone et fusionné lorsque le téléphone se reconnecte | Notes, photos, relevés |
| Proposé hors ligne | Envoyé comme une suggestion sur laquelle le bureau statue. Le serveur ne le fusionne jamais ; il le rejoue à travers ses propres contrôles d'habilitation | Un montant, un constat, une modification de réserve, une décision |
| Jamais hors ligne | Impossible sur le terrain. Affiché sous forme de ligne avec son motif, jamais sous forme de bouton | Une signature, un scellement, un contrôle d'habilitation, une vérification par rapport à une liste de sanctions |
Les surcouches ne contiennent aucune règle, aucune invite, ni aucun cerveau. Ce sont des définitions d'écran lisibles, et tout ce qui prend une décision reste sur le serveur. Les écrans mobiles d'un pack s'ouvrent uniquement dans les applications mobiles Nexus, et seulement lorsque l'organisation détient à la fois le pack et le module complémentaire Applications mobiles.
Droits d'accès : qui dispose du pack et où il s'exécute
Un pack fait l'objet d'une licence, il n'est jamais activé par simple configuration. Trois niveaux déterminent qui le voit.
La licence. Le document de licence signé comporte une liste domain_packs d'identifiants de matrice (100 au maximum, éventuellement vide), à côté de ses groupes de fonctionnalités grants et add_ons. La console d'Adverant n'émettra pas un pack sans les modules complémentaires dont il a besoin : un pack qui requiert Salles de décision et enregistrements scellés ne peut pas être émis pour une licence qui en est dépourvue. Les groupes de fonctionnalités d'une licence sont octroyés soit à l'ensemble de l'installation, soit à des organisations nommées, et le contrôle des droits répond par organisation. Si vous retirez l'octroi, chaque vue et chaque écran mobile du pack devient un aperçu, tout en conservant ses enregistrements.
Le contrôle des droits. Pour chaque organisation et forfait, chaque rôle et chaque personne, le contrôle des droits détermine si une commande ajoutée par le pack est autorisée, affichée en aperçu, masquée ou refusée avec un code. Il pilote les lignes de menu et les onglets de panneau, ainsi que les contrôles de route et d'envoi. Le module fermé reste l'autorité pour son propre octroi.
Unités et vues. Au sein d'une organisation qui dispose du pack, un administrateur décide où il s'exécute. Un pack est activé pour une unité par étapes, jamais pour toute l'unité d'un seul coup : la vérification de la licence, un groupe pilote, un préréglage de paramètres, puis l'élargissement à tout le monde dans l'unité à une date choisie par l'administrateur. Avant que quoi que ce soit ne change, la page affiche qui gagne quoi, par rôle. Les vues sont ensuite attribuées par rôle et par unité, dans une seule matrice. La désactivation ultérieure du pack pour une unité conserve chaque enregistrement créé par les utilisateurs ; les vues et les modèles disparaissent, et rien d'autre ne change.
Les dix packs
Adverant fournit dix packs métier. Chacun nécessite la licence de base Enterprise et certains nécessitent des modules complémentaires. Les écrans mobiles de chaque pack nécessitent également le module complémentaire Applications mobiles.
| Pack | Identifiant de matrice | Ce qu'il apporte | Ce qu'il requiert également |
|---|---|---|---|
| Assurance | insurance |
Des vues d'assurance pour la souscription, les sinistres, la réassurance, le Lloyd's et les autorités déléguées, entre autres ; le flux de fraude et d'enquêtes ; les parcours et paramètres de vitrine d'assurance ; les cerveaux compilés d'assurance | Salles de décision et dossiers scellés |
| Banque et paiements | financial-services |
Un registre des technologies externalisées ; des horloges et rapports d'incidents technologiques ; des plans de sortie pour les prestataires critiques ; des décisions de prêt ; des litiges liés aux cartes | Rien au-delà de la base |
| Marchés de capitaux et gestion d'actifs | capital-markets |
Des vues pour l'analyste de recherche, le gestionnaire de portefeuille, la surveillance et la conformité, et le reporting client ; l'enregistrement des appels sur les tables de négociation ; la recherche maintenue derrière une muraille jusqu'à sa publication ; des modèles pour le journal de franchissement de muraille, l'examen des appels et la publication de recherche. Les téléphones reçoivent le briefing matinal et les approbations de publication ainsi que les alertes de surveillance, jamais les ordres | Salles de décision et dossiers scellés |
| Gouvernement et secteur public | government |
Demandes de prestations et de droits ; demandes d'urbanisme ; demandes d'informations | Rien au-delà de la base |
| Santé | healthcare-providers |
Accès et partage des dossiers des patients, et demandes d'informations. Aucune aide à la décision clinique | Rien au-delà de la base |
| Sciences de la vie | life-sciences |
Écarts et actions correctives ; examen des dossiers de lot ; contrôle validé des modifications | Rien au-delà de la base |
| Infrastructures critiques et énergie | energy-and-utilities |
Horloges et rapports d'incidents ; inspections et défauts ; ordres de travail | Rien au-delà de la base |
| Défense et sécurité | defence-and-mission |
Rapports de terrain fusionnés avec les alertes de la plateforme ; marquages de partage ; débriefings. Sa version mobile est installée uniquement via la gestion des appareils | Nexus Edge, pour les alertes de la plateforme |
| Services juridiques et professionnels | legal |
Des vues pour le professionnel facturant, le juriste gestionnaire des connaissances, les conflits et les risques, et la facturation ; une vérification des conflits à chaque nouveau dossier ; des murailles éthiques levées uniquement par deux associés ; des modèles pour la vérification d'un nouveau dossier, le générateur de muraille et les rappels de muraille. Les téléphones permettent la saisie du temps et les mises à jour des dossiers avec approbations, jamais l'accès aux fichiers couverts par le secret professionnel | Salles de décision et enregistrements scellés, et Courrier |
| Logistique et maritime | logistics-and-maritime |
Des vues pour le contrôleur des opérations, l'agent des douanes, le gestionnaire de transporteurs et l'inspecteur portuaire ; les déclarations et retenues en douane ; les contrôles de sanctions avant la première réservation, avec une personne levant chaque retenue ; un modèle de connaissances des ports et des navires, des transporteurs et des retenues. Les téléphones reçoivent les inspections de parc et de poste d'amarrage ainsi que les retenues en douane, avec les constats par drone | Carte et GeoAI |
Harrow Port Authority exécute le pack Logistique et maritime, et c'est celui que je lirais en premier si vous construisez le vôtre : son modèle de connaissances est la base sur laquelle s'appuie l'exemple de la chaîne du froid ci-dessus.
Construire le vôtre
Sur Enterprise, un développeur démarre un pack à partir du parcours recommandé dans Démarrer quelque chose de nouveau, en trois étapes. « À propos » nomme le pack, ses unités, le pack sur lequel il s'appuie et les règles pour lesquelles il doit fournir des preuves. « Modèle de connaissances » ajoute les nouveaux types d'objets par-dessus le modèle de base. « Vérifier et créer » affiche le plan puis l'exécute. Il crée un dépôt à partir du modèle de pack avec un manifeste déclarant ce à quoi le pack peut accéder, ainsi que ses tests ; puis un espace de développement avec des branches de données synthétiques ; puis un brouillon d'entrée de catalogue que vous seul pouvez voir. Rien n'est créé tant que vous n'avez pas appuyé sur Créer à la dernière étape. Le chapitre 2.24, Construire une solution verticale sur mesure de bout en bout, détaille l'intégralité du parcours.
Ce que vous coûte un pack
Un pack est l'extension la plus coûteuse à posséder. Son modèle de connaissances comporte des versions dont dépendent les utilisateurs, de sorte qu'une propriété que vous regrettez reste dans la version qui l'a livrée. Ses vues ne peuvent que retirer des éléments, de sorte qu'un rôle qui a besoin de plus implique une discussion autour de la vue de base. Sa table de correspondance des preuves cite des règles que votre propre service juridique doit confirmer avant que quiconque ne s'y fie. Et un client ne l'obtient que par le biais de sa licence : vous pouvez construire le meilleur pack du secteur et ne toujours pas pouvoir l'activer pour une seule unité tant que la licence de l'organisation ne l'inclut pas. En contrepartie, la trentième unité qui le demande ne vous coûte qu'une activation et un pilote.




