InloggenBriefing plannen

Hoofdstuk 2.23

Domeinpakketten

Waaruit een domeinpakket bestaat en wat er in het bijbehorende pack.json-bestand staat; lenzen en het lensregister; kennismodellen, connectoren en mobiele overlays; hoe een pakket wordt gelicentieerd en ingeschakeld voor een eenheid; en de tien pakketten die Adverant levert.

Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

19 minuten leestijd

Het pakket dat ik bij Corrán Orbital heb gebouwd, begon als twee plug-ins en een dozijn Skills Engine-vaardigheden die alleen ons grondstationteam gebruikte. Toen de eenheid voor missie-operaties om hetzelfde vroeg, had ik een keuze: alles kopiëren en van alles twee versies onderhouden, of er een domeinpakket van maken met één kennismodel en twee lenzen, ingeschakeld per eenheid. Het kostte me een week om er een pakket van te maken. Ik zou morgen weer dezelfde keuze maken, en de volgende keer zou ik direct met het pakket beginnen.

Een domeinpakket brengt de werkwijze van één sector naar Nexus. Het bevat de soorten objecten van de sector en hoe ze met elkaar verbonden zijn, en wat elke rol ziet. Het bevat de sjablonen en workflows die mensen dagelijks gebruiken, het bewijsmateriaal waar de regels van de sector om vragen, en de schermen die werken op een telefoon zonder bereik. Het verandert nooit de schil of de componenten ervan, en nooit de schrijfregels. Een nieuwe sector is een pakket, geen app.

Waaruit een pakket bestaat

Onder de motorkap bestaat een pakket uit vier dingen, en geen daarvan is pakketspecifieke code in het platform:

  1. Een bundel van functiegroepen in de rechtencontrole. De bedieningselementen van het pakket behoren tot een reeks functiegroepen. Elke menurij en elk paneeltabblad dat het pakket toevoegt, wordt vervolgens bepaald door hetzelfde mechanisme als de rest van Nexus: gerechtigd, getoond als een teaser, of verborgen.
  2. Een pakketmanifest, pack.json, dat de schermclusters en de woorden, de lenzen en de telefoonschermen van het pakket declareert.
  3. Gesloten modules die hun eigen toekenning verifiëren. De servercode die beslissingen neemt, zoals de gecompileerde breinen van een pakket, bevat intern de licentieverificatie en controleert zelf de ondertekende licentie. Niets buiten de module kan deze inschakelen.
  4. Een catalogusvermelding, zodat het pakket op de pagina Domeinpakketten verschijnt met wat het biedt en wat het nodig heeft.

Daarbovenop bevinden zich de onderdelen die mensen zien: het kennismodel en de lenzen; sjablonen, workflows en Skills Engine-vaardigheden; alleen-lezen connectoren naar de systemen die de dossiers al bevatten, een bewijskaart van elke regel naar de dossiers die eraan voldoen, en een mobiele overlay.

Domeinpakketten
Domeinpakketten
De pagina Domeinpakketten vermeldt alle tien pakketten met wat elk pakket nodig heeft en waar het draait. Alleen Adverant kent een pakket toe; u bepaalt in welke eenheden het draait.

Het pack.json-bestand

Hier is het manifest van het pakket Bankwezen en betalingsverkeer, ingekort tot één lens met één werkplek en twee termen. De bestands-id is fintech, en name bevat de werknaam van het pakket; de console en de catalogus tonen het als Bankwezen en betalingsverkeer.

{
  "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"
      }
    ]
  }
}

De velden, van boven naar beneden:

Veld Wat erin staat
id De id van het pakket, in kleine letters
name De werknaam ervan
version De eigen versie van het pakket
inherits Het pakket waarop dit pakket voortbouwt. Bankwezen en betalingsverkeer erft van Verzekeringen, dat de gedeelde clusters bevat die elk pakket gebruikt, zoals het gesprek en de instellingen. Een nieuw pakket voegt zijn eigen lenzen toe en laat de gedeelde clusters over aan het pakket waarvan het erft
screenCount Hoeveel schermen het pakket definieert
clusters[] De schermgroepen van het pakket. Elke groep heeft een id, een kind, een name, de seats waarvoor deze bedoeld is, de purpose, de lexicon-sets waar de woorden uit komen, de menu en de screens, elk met een id, een title, who en waar ze mee doing
clusters[].kind shared voor een cluster dat elke lens kan bereiken (bijvoorbeeld het gesprek); lens voor de eigen schermen van één rol. De scope van een cluster geeft aan of het tot de kern (core) of tot de sector (domain) behoort
lexicon De woorden van het pakket, in benoemde sets. Elke term heeft een duidelijke verklaring die een nieuwkomer kan lezen, en het derde veld is exact voor een term die woord voor woord moet worden gebruikt, zoals een wettelijk cijfer
world De voorbeeldwereld van fictieve tenants en werkplekken die de schermen en tests van het pakket gebruiken, en de gegevensvertakkingen ervan
world.tenants[].plan De areas van het abonnement: de clusters en lenzen die het abonnement van deze tenant opent, uit of
world.tenants[].ai Het AI-beleid (kunstmatige intelligentie) van de organisatie voor het pakket: of modellen op het apparaat zijn toegestaan (onDevice), waar persoonsgegevens naar een cloudmodel mogen gaan (personalDataToCloudModels, zoals uk-only of eu-only), en of het verzegelen van een dossier UNO-verzending vereist (sealRequiresUno)
world.seats[] De werkplek van één persoon: hun title, de lens die zij hebben, de gedeelde clusters die zij ook bereiken, hun home-scherm, hun posture (desk, field of consumer) en, in het volledige bestand, hun authority, de grenzen waarbinnen zij handelen

Twee regels bepalen wat een pack.json mag bevatten. Een voorschrift wordt genoemd in gewone woorden met een verklaring, nooit als een kale afkorting. En niets in het bestand is code: het is een leesbare definitie die de server en de apps interpreteren, dus het bevat nooit een regel of een prompt, en nooit een gecompileerd brein.

Gedeelde lenzen

Sommige regimes behoren tot meerdere sectoren. Een register van uitbestede technologie dient Verzekeringen en Bankwezen en betalingsverkeer; incidentklokken (het aftellen tot de rapporten die een toezichthouder na een incident verwacht) dienen zowel Kritieke infrastructuur en energie als Overheid en publieke sector. Een regime dat door meerdere pakketten wordt gebruikt, wordt eenmalig geschreven als een gedeelde lens. Elk pakket dat het nodig heeft, neemt het op. Wanneer de regel verandert, verandert deze op één plek.

Een lens beperkt alleen maar

Een lens is wat één rol ziet binnen een pakket of een platform: welke kaarten en velden, en welke acties. Het wordt altijd gedefinieerd als een versmalling van een basislens. Een lens met een basis toont geen enkel soort object dat de basis niet toont en opent geen enkel gebied dat de basis niet opent, en kan niet tegelijkertijd hetzelfde soort tonen en verbergen. Machtigingen komen nog steeds voort uit rollen; een lens verandert de weergave, nooit wat een persoon mag doen.

Probeer er een te verbreden en het antwoord is LENS_CANNOT_WIDEN (422), waarbij niets wordt opgeslagen. In de lensbouwer luidt dat, voor een koelcontainertechnicus-lens die is gebouwd op een basis voor een operatiecontroller die geen claimbedragen toont: "Claimbedrag kan niet aan deze lens worden toegevoegd". De oplossing is een andere basislens, wat een ander verzoek inhoudt aan degene die eigenaar is van de basis.

Lensbouwer
Lensbouwer
De lensbouwer vermeldt wat een rol ziet, kaart voor kaart en veld voor veld, afgevinkt tegen de basislens die deze versmalt. Een poging om een veld te tonen dat door de basis wordt verborgen, wordt geweigerd met opgave van de reden en de naam van degene die de basis kan wijzigen.

De regel wordt vastgehouden in de database, niet alleen in de route. De lenzen van elke organisatie bevinden zich in vier tabellen van het schema van het plug-inregister:

Tabel Wat het bevat
plugins.lenses Eén lens van één eigenaar, een pakket (owner_kind pack) of een platform (platform): de slug en name, de base_lens_id, de soorten die het shows en hides, de gebieden die het opens, de status (active of withdrawn) en de version
plugins.lens_grants Een lens toegekend aan één rol (owner, admin, member, viewer, developer of billing_admin) in één bedrijfseenheid
plugins.lens_changes Elke wijziging aan een lens of de toekenningen ervan, bewaard als voor en na, met wie het heeft gedaan en waarom. Alleen toevoegen
plugins.lens_holder_months Hoeveel mensen elke maand een lens hadden in een eenheid. Een aantal, nooit wie

Een trigger weigert elke lens die meer toont dan zijn basis, en weigert een wijziging aan een basis waardoor een lens die erop gebouwd is meer zou tonen dan de basis zelf. Er wordt niets verwijderd. Lenzen en toekenningen worden ingetrokken, en het opnieuw toekennen van een lens is een nieuwe rij; een wijziging wordt nooit herschreven, en het aantal van een voorgaande maand wordt nooit gewijzigd. Elke rij verwijst naar een lens van de eigen organisatie via een samengestelde sleutel, zodat een toekenning niet over organisaties heen kan verwijzen.

De console en uw eigen tools bereiken het register via /api/v1/lenses, met het eigen bearer-token van de persoon. De organisatie en de persoon, en de werkplek binnen de eenheid, komen uit het geverifieerde token en nergens anders vandaan.

Methode en pad Wat deze doet
GET / Lenzen, gefilterd op owner_kind, owner_id en status, met hun toekenningen op uw werkplek
POST / Een lens toevoegen: owner_kind, owner_id, slug, name, shows, en optioneel description, base_lens_id, hides, opens en reason
GET /owners/:kind/:id De lenzen van een pakket of platform, en welke daarvan elk soort toont
GET /owners/:kind/:id/grants Lens per eenheid: de rollen die elke lens hebben gekregen en de mensen die deze bereikt
GET /owners/:kind/:id/holders Mensen die elke maand een lens hebben (months, standaard zes)
POST /owners/:kind/:id/holders/count De aantallen van deze maand vastleggen
GET /owners/:kind/:id/changes De wijzigingsgeschiedenis van de lenzen van de eigenaar (limit, standaard 50)
GET /:lensId Eén lens met zijn basis en de lenzen die deze versmallen, en de toekenningen en wijzigingen ervan
PATCH /:lensId Een lens wijzigen: name, description, shows, hides, opens, reason
POST /:lensId/withdraw Een lens intrekken, en daarmee ook de toekenningen ervan. Een lens die door een andere actieve lens wordt versmald, kan pas worden ingetrokken als die andere lens is ingetrokken
POST /:lensId/grants Een lens toekennen: business_unit_id, role, reason
POST /:lensId/grants/:grantId/withdraw Eén toekenning intrekken

:kind is pack of platform. Elke weigering bevat een code met een zin en een volgende stap, en een onverwachte fout antwoordt UNHANDLED_ERROR met de oorzaak in het servicelogboek, nooit in het antwoord.

Kennismodel, connectoren en gecompileerde breinen

Het kennismodel bestaat uit de soorten objecten die het pakket kent en hoe ze met elkaar verbonden zijn. Het is voorzien van versiebeheer, en een pakket bouwt meestal voort op een basismodel van het pakket waarvan het erft: een koelketenpakket op het logistieke basismodel voegt vijf soorten toe (waaronder koelcontainer en scheepsaanloop) en koppelt twee daarvan aan de basis zonder de basis zelf te wijzigen. Elke eigenschap wordt bij het aanmaken geclassificeerd, zodat de persoonlijke velden en de commerciële velden bekend zijn voordat een lens of gegevensvertakking ze gebruikt. Een lens voor technici kan dan geen claimbedrag tonen dat als commercieel is geclassificeerd. Een ingetrokken eigenschap blijft in de versie waarin deze zat en verdwijnt pas in een latere versie. Bij het klaarzetten van een nieuwe versie wordt eerst de kennis gekopieerd, en de weg terug blijft gedurende een vastgestelde periode open.

Connectoren halen dossiers binnen uit de systemen waarin ze al staan: polisadministratie, een claimsysteem, een mailmap met bestanden die partners sturen. Elke connector is alleen-lezen, draait volgens zijn eigen schema en heeft een testknop. Dossiers worden bij binnenkomst gekoppeld aan de woorden van het pakket en komen terecht in het kennismodel dat door de lenzen wordt gelezen; de antwoorden van de assistent verwijzen ernaar. Vanuit Nexus wordt niets teruggeschreven naar het bronsysteem.

Gecompileerde breinen zijn de onderdelen van een pakket die beslissingen nemen: bijvoorbeeld het acceptatiebrein en het claimbrein van het pakket Verzekeringen. Ze draaien op de server als gecompileerde, gelicentieerde modules, die elk zelf de licentie verifiëren, en ze worden nooit naar een telefoon of een browser gestuurd.

Kennismodel en connectoren
Kennismodel en connectoren
Kennismodel en connectoren toont de modelversie en de woordenlijst van het pakket, met de eigen termen van de organisatie, en test elke alleen-lezen connector. Er wordt vanuit Nexus niets gewijzigd in de polis- of claimsystemen.

De mobiele overlay en offline velden

Een pakket declareert zijn telefoonschermen in hetzelfde manifest, als een mobiele overlay: welke kaarten en vastleggingsstappen op telefoons verschijnen, en voor welke rollen. Een beheerder stelt vervolgens per organisatie de regels op telefoons in, zoals hoe lang vastleggingen offline mogen wachten, of elke foto de locatie bevat waar deze is genomen, en of goedkeuringen een passkey vereisen. Het instellen blijft op een computer gebeuren; de beheerder ziet wat telefoons sturen als namen en aantallen, nooit de foto's of notities zelf.

Elk veld dat een telefoonscherm zonder bereik aanbiedt, declareert een van de drie klassen, en het scherm toont welke:

Klasse Wat ermee gebeurt Voorbeelden
Offline opgesteld Opgeslagen op de telefoon en samengevoegd wanneer de telefoon weer verbinding maakt Notities, foto's, metingen
Offline voorgesteld Verzonden als een suggestie waarover het kantoor beslist. De server voegt het nooit samen; het speelt het opnieuw af via zijn eigen bevoegdheidscontroles Een bedrag, een bevinding, een reservewijziging, een beslissing
Nooit offline Buiten op locatie niet mogelijk. Weergegeven als een rij met de reden, nooit als een knop Een handtekening, een zegel, een bevoegdheidscontrole, een controle tegen een sanctielijst

Overlays bevatten geen regels en geen prompts, en ook geen breinen. Het zijn leesbare schermdefinities, en alles wat beslist blijft op de server. De telefoonschermen van een pakket openen alleen binnen de Nexus-telefoonapps, en alleen wanneer de organisatie zowel het pakket als de add-on Mobiele apps heeft.

Mobiele overlay
Mobiele overlay
De mobiele overlay kiest welke pakketkaarten en vastleggingsstappen op telefoons verschijnen en voor welke rollen. Vastleggingen wachten offline zolang de organisatie dat toestaat en goedkeuringen vereisen een passkey. Het voorbeeld toont precies wat één rol ziet.

Rechten: wie het pakket heeft en waar het draait

Een pakket wordt gelicentieerd, nooit ingeschakeld via configuratie. Drie lagen bepalen wie het ziet.

De licentie. Het ondertekende licentiedocument bevat een domain_packs-lijst van matrix-id's (maximaal 100, mogelijk leeg), naast de functiegroep grants en add_ons. De console van Adverant geeft geen pakket uit zonder de benodigde add-ons: een pakket dat Besluitvormingsruimten en verzegelde dossiers vereist, kan niet aan een licentie worden uitgegeven zonder deze add-on. Functiegroepen in een licentie worden toegekend aan de gehele installatie of aan genoemde organisaties, en de rechtencontrole antwoordt per organisatie. Verwijder de toekenning en elke lens en elk telefoonscherm van het pakket wordt een teaser, waarbij de dossiers behouden blijven.

De rechtencontrole. Voor elke organisatie en elk abonnement, elke rol en elke persoon bepaalt de rechtencontrole of een bedieningselement dat het pakket toevoegt gerechtigd is, wordt getoond als een teaser, verborgen is of wordt geweigerd met een code. Het stuurt de menurijen en paneeltabbladen aan, evenals de route- en verzendingscontroles. De gesloten module blijft de autoriteit voor zijn eigen toekenning.

Eenheden en lenzen. Binnen een organisatie die het pakket heeft, bepaalt een beheerder waar het draait. Een pakket wordt voor een eenheid in fasen ingeschakeld, nooit voor de hele eenheid tegelijk: de licentiecontrole, een pilotgroep, een voorinstelling van instellingen, en vervolgens uitbreiding naar iedereen in de eenheid op een datum die de beheerder kiest. Voordat er iets verandert, toont de pagina wie wat krijgt, per rol. Lenzen worden vervolgens per rol en per eenheid toegekend, in één matrix. Als het pakket later voor een eenheid wordt uitgeschakeld, blijft elk dossier dat mensen hebben gemaakt behouden; de lenzen en sjablonen verdwijnen, en verder verandert er niets.

Een domein inschakelen voor een eenheid
Een domein inschakelen voor een eenheid
Het inschakelen van een domein voor een eenheid verloopt in fasen, van de licentiecontrole via een pilotgroep tot de hele eenheid. De beheerder ziet wie wat krijgt voordat er iets verandert, en de instellingen van de pilot worden ongewijzigd overgenomen.

De tien pakketten

Adverant levert tien domeinpakketten. Elk pakket vereist de Enterprise-basislicentie en sommige vereisen add-ons. De telefoonschermen van elk pakket vereisen ook de add-on Mobiele apps.

Pakket Matrix-id Wat het biedt Wat het ook nodig heeft
Verzekeringen insurance Verzekeringslenzen voor onder meer acceptatie, claims, herverzekering, Lloyd's en gedelegeerde bevoegdheid; de stroom voor fraude en onderzoeken; klantreizen en instellingen voor verzekeringswinkels; de gecompileerde verzekeringsbreinen Besluitvormingsruimtes en verzegelde dossiers
Bankwezen en betalingsverkeer financial-services Een register van uitbestede technologie; klokken en rapporten voor technologie-incidenten; exitplannen voor kritieke aanbieders; kredietbeslissingen; kaartgeschillen Niets buiten de basis
Kapitaalmarkten en vermogensbeheer capital-markets Lenzen voor de onderzoeksanalist, de portefeuillebeheerder, toezicht en naleving, en klantrapportage; gesprekken op handelsdesks opgenomen; onderzoek achter een muur gehouden tot vrijgave; sjablonen voor het muuroverschrijdingslogboek, gespreksbeoordeling en onderzoeksvrijgave. Telefoons krijgen de ochtendbriefing en vrijgavegoedkeuringen evenals toezichtwaarschuwingen, nooit orders Besluitvormingsruimtes en verzegelde dossiers
Overheid en publieke sector government Uitkerings- en aanspraakclaims; vergunningsaanvragen; informatieverzoeken Niets buiten de basis
Gezondheidszorg healthcare-providers Toegang tot en delen van patiëntendossiers, en informatieverzoeken. Geen klinische beslissingsondersteuning Niets buiten de basis
Biowetenschappen life-sciences Afwijkingen en corrigerende maatregelen; beoordeling van batchdossiers; gevalideerd wijzigingsbeheer Niets buiten de basis
Kritieke infrastructuur en energie energy-and-utilities Incidentklokken en -rapporten; inspecties en gebreken; werkorders Niets buiten de basis
Defensie en veiligheid defence-and-mission Veldrapporten samengevoegd met platformwaarschuwingen; deelmarkeringen; debriefings. De telefoonversie hiervan wordt alleen geïnstalleerd via apparaatbeheer Nexus Edge, voor de platformwaarschuwingen
Juridische en zakelijke dienstverlening legal Lenzen voor de declarabele medewerker, de kennisjurist, belangenconflicten en risico, en facturering; een conflictcontrole bij elke nieuwe zaak; ethische muren die alleen door twee partners kunnen worden opgeheven; sjablonen voor een controle bij een nieuwe zaak, de muurbouwer en muurherinneringen. Telefoons krijgen tijdregistratie en zaakupdates met goedkeuringen, nooit vertrouwelijke bestanden Besluitkamers en verzegelde dossiers, en Mail
Logistiek en maritieme sector logistics-and-maritime Lenzen voor de operatiecontroller, de douanebeambte, de vervoerdersmanager en de haveninspecteur; douaneaangiften en -blokkeringen; sanctiecontroles vóór de eerste boeking, waarbij een persoon elke blokkering vrijgeeft; een kennismodel van havens en schepen, vervoerders en blokkeringen. Telefoons krijgen terrein- en ligplaatsinspecties en douaneblokkeringen, met dronebevindingen Kaart en GeoAI

Harrow Port Authority gebruikt het pakket Logistiek en maritiem, en dat is het pakket dat ik als eerste zou lezen als u uw eigen pakket bouwt: het kennismodel ervan is de basis waarop het bovenstaande koelketenvoorbeeld voortbouwt.

Uw eigen pakket bouwen

Op Enterprise start een ontwikkelaar een pakket vanaf het gouden pad in Start iets nieuws, in drie stappen. "Over dit pakket" benoemt het pakket, de eenheden, het pakket waarop het voortbouwt en de regels waarvoor het bewijs moet tonen. "Kennismodel" voegt de nieuwe soorten objecten toe bovenop het basismodel. "Controleren en aanmaken" toont het plan en voert het vervolgens uit. Het maakt een repository aan vanuit het pakketsjabloon met een manifest dat declareert wat het pakket mag bereiken, en de bijbehorende tests; vervolgens een ontwikkelruimte met synthetische gegevensvertakkingen; en daarna een concept-catalogusvermelding die alleen u kunt zien. Er wordt niets aangemaakt totdat u bij de laatste stap op Aanmaken drukt. Hoofdstuk 2.24, Een aangepaste verticale oplossing van begin tot eind bouwen, doorloopt het hele pad.

Wat een pakket u kost

Een pakket is de duurste uitbreiding om in bezit te hebben. Het kennismodel heeft versies waar mensen van afhankelijk zijn, dus een eigenschap waar u spijt van krijgt, blijft in de versie waarin deze is geleverd. De lenzen kunnen alleen dingen weglaten, dus een rol die meer nodig heeft, betekent een gesprek over de basislens. De bewijskaart noemt regels die uw eigen jurist moet bevestigen voordat iemand erop vertrouwt. En een klant krijgt het alleen via zijn licentie: u kunt het beste pakket in de sector bouwen en het toch voor geen enkele eenheid inschakelen totdat de licentie van de organisatie het bevat. Daar staat tegenover dat de dertigste eenheid die het wil, u slechts één schakelaar en een pilot kost.