Logg innBestill en gjennomgang

Kapittel 2.23

Domenepakker

Hva en domenepakke består av og hva pack.json sier; linser og linseregisteret; kunnskapsmodeller, koblinger og mobiloverlegg; hvordan en pakke lisensieres og slås på for en enhet; og de ti pakkene Adverant leverer.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

19 minutter å lese

Pakken jeg bygde hos Corrán Orbital startet som to programtillegg og et dusin Skills Engine-ferdigheter som bare bakkestasjonsteamet vårt brukte. Da oppdragsoperasjonsenheten ba om det samme, hadde jeg et valg: kopiere alt sammen og vedlikeholde to av alt, eller gjøre det om til en domenepakke med én kunnskapsmodell og to linser, slått på per enhet. Det tok meg en uke å lage en pakke av det. Jeg ville tatt det samme valget igjen i morgen, og jeg ville startet med pakken neste gang.

En domenepakke bringer én bransjes arbeidsmåte til Nexus. Den inneholder bransjens typer objekter og hvordan de henger sammen, og hva hver rolle ser. Den har med seg malene og arbeidsflytene folk bruker hver dag, dokumentasjonen som bransjens regler krever, og skjermbildene som fungerer på en telefon uten dekning. Den endrer aldri skallet eller komponentene i det, og aldri skrivereglene. En ny bransje er en pakke, ikke en app.

Hva en pakke består av

Under panseret består en pakke av fire ting, og ingen av dem er pakkespesifikk kode i plattformen:

  1. En funksjonsgruppepakke i rettighetskontrollen. Pakkens kontroller tilhører et sett med funksjonsgrupper. Hver menyrad og panelfane som pakken legger til, avgjøres deretter av samme mekanisme som resten av Nexus: berettiget, vist som en smakebit, eller skjult.
  2. Et pakkemanifest, pack.json, som deklarerer pakkens klynger av skjermbilder og dens ord, dens linser og dens telefonskjermer.
  3. Lukkede moduler som verifiserer sin egen tildeling. Serverkoden som tar beslutninger, slik som en pakkes kompilerte hjerner, bærer lisensverifikatoren inni seg og kontrollerer den signerte lisensen selv. Ingenting utenfor modulen kan slå den på.
  4. En katalogoppføring, slik at pakken vises på siden Domenepakker med hva den inneholder og hva den krever.

Oppå disse ligger delene folk ser: kunnskapsmodellen og linsene; maler, arbeidsflyter og Skills Engine-ferdigheter; skrivebeskyttede tilkoblinger til systemene som allerede har oppføringene, et dokumentasjonskart fra hver regel til oppføringene som besvarer den, og et mobiloverlegg.

Bransjepakker
Domenepakker
Siden Domenepakker lister opp alle de ti pakkene med hva hver av dem krever og hvor den kjører. Bare Adverant tildeler en pakke; du bestemmer hvilke enheter den kjører i.

Filen pack.json

Her er manifestet for pakken Bank og betalinger, kortet ned til én linse med én plass, og to termer. Fil-ID-en er fintech, og name inneholder pakkens arbeidsnavn; konsollen og katalogen viser den som Bank og betalinger.

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

Feltene, fra øverst til nederst:

Felt Hva det sier
id Pakkens ID, med små bokstaver
name Dens arbeidsnavn
version Pakkens egen versjon
inherits Pakken som denne bygger på. Bank og betalinger arver fra Forsikring, som inneholder de delte klyngene hver pakke bruker, slik som samtalen og innstillinger. En ny pakke legger til sine linser og overlater de delte klyngene til pakken den arver fra
screenCount Hvor mange skjermbilder pakken definerer
clusters[] Pakkens grupper av skjermbilder. Hver har en id, en kind, en name, hvilken seats den er for, sin purpose, lexicon-settene ordene kommer fra, sine menu og sine screens, hver med en id, en title, who og hva de er doing
clusters[].kind shared for en klynge hver linse kan nå (for eksempel samtalen); lens for én rolles egne skjermbilder. En klynges scope sier om den tilhører kjernen (core) eller bransjen (domain)
lexicon Pakkens ord, i navngitte sett. Hver term har en enkel forklaring som en nybegynner kan lese, og den tredje plassen er exact for en term som må brukes ordrett, slik som et regulatorisk nøkkeltall
world Eksempelverdenen av fiktive leietakere og plasser som pakkens skjermbilder og tester bruker, og dens datagrener
world.tenants[].plan Planens areas: klyngene og linsene denne leietakerens plan åpner, ut av of
world.tenants[].ai Organisasjonens retningslinjer for KI (kunstig intelligens) for pakken: om modeller på enheten er tillatt (onDevice), hvor personopplysninger kan sendes til en skymodell (personalDataToCloudModels, slik som uk-only eller eu-only), og om forsegling av en oppføring krever UNO-utsendelse (sealRequiresUno)
world.seats[] Én persons plass: vedkommendes title, hvilken lens de har, de delte clusters de også når, deres home-skjermbilde, deres posture (desk, field eller consumer) og, i den fullstendige filen, deres authority, grensene de handler innenfor

To regler styrer hva en pack.json kan inneholde. Et regelverk navngis med vanlige ord og en forklaring, aldri kun som en forkortelse. Og ingenting i filen er kode: det er en lesbar definisjon som serveren og appene tolker, så den inneholder aldri en regel eller en instruks, og aldri en kompilert hjerne.

Delte linser

Noen regimer tilhører flere bransjer. Et register over utkontraktert teknologi betjener Forsikring samt Bank og betalinger; hendelsesklokker (nedtellingene til rapportene en tilsynsmyndighet forventer etter en hendelse) betjener både Kritisk infrastruktur og energi samt Offentlig sektor og forvaltning. Et regime som flere pakker bruker, skrives én gang som en delt linse. Hver pakke som trenger den, inkluderer den. Når regelen endres, endres den på ett sted.

En linse bare innsnevrer

En linse er det én rolle ser inne i en pakke eller en plattform: hvilke kort og felt, og hvilke handlinger. Den defineres alltid som en innsnevring av en basislinse. En linse med en basis viser ingen type objekt som basisen ikke viser, og åpner intet område som basisen ikke åpner, og den kan ikke både vise og skjule samme type. Tillatelser kommer fortsatt fra roller; en linse endrer visningen, aldri hva en person har lov til å gjøre.

Prøver du å utvide en, er svaret LENS_CANNOT_WIDEN (422), uten at noe lagres. I linsebyggeren lyder det, for en kjøleteknikerlinse bygget på en driftslederbasis som ikke viser kravbeløp: «Kravbeløp kan ikke legges til i denne linsen». Løsningen er en annen basislinse, som er en annen forespørsel til den som eier basisen.

Linsebygger
Linsebygger
Linsebyggeren lister opp hva en rolle ser, kort for kort og felt for felt, avkrysset mot basislinsen den snevrer inn. Forsøk på å vise et felt som basisen skjuler, avvises med årsaken og navnet på den som kan endre basisen.

Regelen ligger i databasen, ikke bare i ruten. Hver organisasjons linser lever i fire tabeller i skjemaet til programtilleggsregisteret:

Tabell Hva den inneholder
plugins.lenses Én linse for én eier, en pakke (owner_kind pack) eller en plattform (platform): dens slug og name, dens base_lens_id, typene den shows og hides, områdene den opens, dens status (active eller withdrawn) og dens version
plugins.lens_grants En linse gitt til én rolle (owner, admin, member, viewer, developer eller billing_admin) i én forretningsenhet
plugins.lens_changes Hver endring i en linse eller dens tildelinger, lagret som før og etter med hvem som gjorde det og hvorfor. Kun tillegg
plugins.lens_holder_months Hvor mange personer som hadde en linse i en enhet hver måned. Et antall, aldri hvem

En utløser avviser enhver linse som viser mer enn basisen sin, og avviser en endring i en basis som ville føre til at en linse bygget på den viser mer enn den selv gjør. Ingenting slettes. Linser og tildelinger trekkes tilbake, og å gi en linse på nytt gir en ny rad; en endring skrives aldri om, og en tidligere måneds antall endres aldri. Hver rad viser til en linse i sin egen organisasjon gjennom en sammensatt nøkkel, slik at en tildeling ikke kan peke på tvers av organisasjoner.

Konsollen og dine egne verktøy når registeret gjennom /api/v1/lenses, med personens eget ihændehavertoken. Organisasjonen og personen, samt enhetsplassen, kommer fra det verifiserte tokenet og fra ingenting annet.

Metode og sti Hva den gjør
GET / Linser, filtrert etter owner_kind, owner_id og status, med sine tildelinger på din plass
POST / Legg til en linse: owner_kind, owner_id, slug, name, shows, og valgfritt description, base_lens_id, hides, opens og reason
GET /owners/:kind/:id En pakkes eller plattforms linser, og hvilke av dem som viser hver type
GET /owners/:kind/:id/grants Linse per enhet: rollene som er gitt hver linse og personene den når
GET /owners/:kind/:id/holders Personer som har en linse hver måned (months, seks som standard)
POST /owners/:kind/:id/holders/count Registrer denne månedens antall
GET /owners/:kind/:id/changes Endringshistorikken for eierens linser (limit, 50 som standard)
GET /:lensId Én linse med sin basis og linsene som snevrer den inn, samt dens tildelinger og endringer
PATCH /:lensId Endre en linse: name, description, shows, hides, opens, reason
POST /:lensId/withdraw Trekk tilbake en linse, og dens tildelinger med den. En linse som en annen aktiv linse snevrer inn, kan ikke trekkes tilbake før den andre er det
POST /:lensId/grants Gi en linse: business_unit_id, role, reason
POST /:lensId/grants/:grantId/withdraw Trekk tilbake én tildeling

:kind er pack eller platform. Hver avvisning inneholder en kode med en setning og et neste steg, og en uventet feil svarer UNHANDLED_ERROR med årsaken i tjenesteloggen, aldri i svaret.

Kunnskapsmodell, koblinger og kompilerte hjerner

Kunnskapsmodellen er typene objekter pakken kjenner til og hvordan de henger sammen. Den er versjonert, og en pakke bygger vanligvis på en basismodell fra pakken den arver fra: en kjølekjedepakke på basismodellen for logistikk legger til fem typer (blant annet kjøleenhet og skipsanløp) og kobler to av dem inn i basisen uten å endre selve basisen. Hver egenskap klassifiseres når den opprettes, slik at de personlige feltene og de kommersielle er kjent før noen linse eller datagren bruker dem. En linse for teknikere kan dermed ikke vise et kravbeløp som er klassifisert som kommersielt. En tilbaketrukket egenskap forblir i versjonen som hadde den, og forsvinner først i en senere versjon. Klargjøring av en ny versjon kopierer kunnskapen først, og veien tilbake holdes åpen i en fastsatt periode.

Tilkoblinger henter inn oppføringer fra systemene som allerede har dem: poliseadministrasjon, et skadesystem, en e-postmappe med filer som partnere sender. Hver av dem er skrivebeskyttet, kjører etter sin egen tidsplan og har en testknapp. Oppføringer tilordnes pakkens ord på vei inn og lander i kunnskapsmodellen som linsene leser; assistentens svar viser til den. Ingenting skrives tilbake til kildesystemet fra Nexus.

Kompilerte hjerner er de delene av en pakke som tar beslutninger: forsikringspakkens tegningshjerne og dens skadehjerne, for eksempel. De kjører på serveren som kompilerte, lisensierte moduler, der hver enkelt verifiserer lisensen selv, og de sendes aldri til en telefon eller en nettleser.

Kunnskapsmodell og tilkoblinger
Kunnskapsmodell og tilkoblinger
Kunnskapsmodell og tilkoblinger viser pakkens modellversjon og ordforråd, med organisasjonens egne termer, og tester hver skrivebeskyttede tilkobling. Ingenting i polise- eller skadesystemene endres fra Nexus.

Mobiloverlegget og frakoblede felt

En pakke deklarerer telefonskjermene sine i det samme manifestet, som et mobiloverlegg: hvilke kort og registreringstrinn som vises på telefoner, og for hvilke roller. En administrator setter deretter reglene på telefoner per organisasjon, slik som hvor lenge registreringer kan vente frakoblet, om hvert bilde inneholder hvor det ble tatt, og om godkjenninger krever en passnøkkel. Oppsettet forblir på en datamaskin; administratoren ser hva telefoner sender som navn og antall, aldri selve bildene eller notatene.

Hvert felt en telefonskjerm tilbyr uten dekning, deklarerer én av tre klasser, og skjermen viser hvilken:

Klasse Hva som skjer med det Eksempler
Opprettet frakoblet Lagret på telefonen og flettet inn når telefonen kobler til igjen Notater, bilder, avlesninger
Foreslått frakoblet Sendt som et forslag som kontoret avgjør. Serveren fletter det aldri inn; den spiller det av på nytt gjennom sine egne fullmaktskontroller Et beløp, et funn, en reserveendring, en beslutning
Aldri frakoblet Ikke mulig der ute. Tegnet som en rad med sin årsak, aldri som en knapp En signatur, et segl, en fullmaktskontroll, en kontroll mot en sanksjonsliste

Overlegg inneholder ingen regler og ingen instrukser, og heller ingen hjerner. De er lesbare skjermdefinisjoner, og alt som tar beslutninger forblir på serveren. En pakkes telefonskjermer åpnes bare inne i Nexus-telefonappene, og bare når organisasjonen har både pakken og tillegget Mobilapper.

Mobiloverlegg
Mobiloverlegg
Mobiloverlegget velger hvilke pakkekort og registreringstrinn som vises på telefoner og for hvilke roller. Registreringer venter frakoblet så lenge organisasjonen tillater det, og godkjenninger krever en passnøkkel. Forhåndsvisningen viser nøyaktig hva én rolle ser.

Rettigheter: hvem som har pakken, og hvor den kjører

En pakke er lisensiert, aldri slått på gjennom konfigurasjon. Tre lag avgjør hvem som ser den.

Lisensen. Det signerte lisensdokumentet inneholder en domain_packs-liste over matrise-ID-er (høyst 100, muligens tom), ved siden av funksjonsgruppens grants og add_ons. Adverants konsoll utsteder ikke en pakke uten tilleggene den krever: en pakke som krever Beslutningsrom og forseglede oppføringer, kan ikke utstedes til en lisens uten det. Funksjonsgrupper i en lisens tildeles enten til hele installasjonen eller til navngitte organisasjoner, og rettighetskontrollen svarer per organisasjon. Fjerner du tildelingen, blir hver linse og telefonskjerm i pakken til en smakebit, mens oppføringene beholdes.

Rettighetskontrollen. For hver organisasjon og plan, hver rolle og hver person, avgjør rettighetskontrollen om en kontroll som pakken legger til, er berettiget, vist som en smakebit, skjult eller avvist med en kode. Den styrer menyradene og panelfanene, samt rute- og utsendelseskontrollene. Den lukkede modulen forblir autoriteten for sin egen tildeling.

Enheter og linser. Inne i en organisasjon som har pakken, bestemmer en administrator hvor den kjører. En pakke slås på for en enhet trinnvis, aldri for hele enheten på én gang: lisenskontrollen, en pilotgruppe, en forhåndsinnstilling, og deretter utvidelse til alle i enheten på en dato administratoren velger. Før noe endres, viser siden hvem som får hva, etter rolle. Linser gis deretter per rolle og per enhet, i én matrise. Å slå av pakken for en enhet senere beholder hver oppføring folk har laget; linsene og malene forsvinner, og ingenting annet endres.

Slå på et domene for en enhet
Slå på et domene for en enhet
Å slå på et domene for en enhet foregår i trinn, fra lisenskontrollen via en pilotgruppe til hele enheten. Administratoren ser hvem som får hva før noe endres, og pilotens innstillinger videreføres uendret.

De ti pakkene

Adverant leverer ti domenepakker. Hver av dem krever basislisensen Enterprise, og noen krever tillegg. Hver pakkes telefonskjermer krever også tillegget Mobilapper.

Pakke Matrise-ID Hva den inneholder Den krever også
Forsikring insurance Forsikringslinser for blant annet tegning, skader, gjenforsikring, Lloyd's og delegert fullmakt; flyten for svindel og undersøkelser; kundereiser og innstillinger for forsikringsbutikk; de kompilerte hjernene for forsikring Beslutningsrom og forseglede poster
Bank og betalinger financial-services Et register over utkontraktert teknologi; klokker og rapporter for teknologihendelser; avviklingsplaner for kritiske leverandører; utlånsbeslutninger; korttvister Ingenting utover basisen
Kapitalmarkeder og kapitalforvaltning capital-markets Linser for analysemedarbeideren, porteføljeforvalteren, overvåking og etterlevelse, samt klientrapportering; samtaler ved handelsbord tatt opp; analyse holdt bak en informasjonssperre frem til frigivelse; maler for logg for kryssing av informasjonssperre, samtalegjennomgang og frigivelse av analyse. Telefoner får morgenorienteringen og frigivelsesgodkjenninger samt overvåkingsvarsler, aldri ordrer Beslutningsrom og forseglede poster
Forvaltning og offentlig sektor government Krav om ytelser og rettigheter; byggesøknader; innsynsforespørsler Ingenting utover basisen
Helsevesen healthcare-providers Tilgang til og deling av pasientjournaler, samt innsynsforespørsler. Ingen klinisk beslutningsstøtte Ingenting utover basisen
Livsvitenskap life-sciences Avvik og korrigerende tiltak; gjennomgang av produksjonspartijournaler; validert endringskontroll Ingenting utover basisen
Kritisk infrastruktur og energi energy-and-utilities Hendelsesklokker og -rapporter; inspeksjoner og mangler; arbeidsordrer Ingenting utover basisen
Forsvar og sikkerhet defence-and-mission Feltrapporter slått sammen med plattformvarsler; delingsmerkinger; etterbrifinger. Telefonversjonen installeres kun gjennom enhetsadministrasjon Nexus Edge, for plattformvarslene
Juridiske og profesjonelle tjenester legal Linser for saksbehandleren, kunnskapsadvokaten, interessekonflikter og risiko, samt fakturering; en interessesjekk ved hver ny sak; informasjonssperrer som kun oppheves av to partnere; maler for sjekk av ny sak, byggeren for informasjonssperrer og påminnelser om informasjonssperrer. Telefoner får tidsregistrering og saksoppdateringer med godkjenninger, aldri taushetsbelagte filer Beslutningsrom og forseglede poster, samt E-post
Logistikk og maritim sektor logistics-and-maritime Linser for driftslederen, tolleren, transportøransvarlig og havneinspektøren; tolldeklarasjoner og tilbakeholdelser; sanksjonskontroller før første bestilling, der en person frigir hver tilbakeholdelse; en kunnskapsmodell over havner og fartøyer, transportører og tilbakeholdelser. Telefoner får inspeksjoner av opplagsplass og kaiplass samt tolltilbakeholdelser, med dronefunn Kart og GeoAI

Harrow Port Authority kjører pakken Logistikk og maritimt, og det er den jeg ville lest først hvis du bygger din egen: kunnskapsmodellen dens er basisen som kjølekjedeeksempelet ovenfor bygger på.

Bygge din egen

På Enterprise starter en utvikler en pakke fra standardløpet i Start noe nytt, i tre trinn. «Om den» navngir pakken, dens enheter, pakken den bygger på og reglene den må vise dokumentasjon for. «Kunnskapsmodell» legger til de nye typene objekter på toppen av basismodellen. «Gjennomgå og opprett» viser planen og følger den deretter. Den oppretter et kodelager fra pakkemalen med et manifest som deklarerer hva pakken kan nå, samt testene dens; deretter et utviklingsområde med syntetiske datagrener; deretter et utkast til katalogoppføring som bare du kan se. Ingenting opprettes før du trykker på Opprett i det siste trinnet. Kapittel 2.24, Bygge en tilpasset vertikal fra start til slutt, går gjennom hele løpet.

Hva en pakke koster deg

En pakke er den mest kostbare utvidelsen å eie. Kunnskapsmodellen har versjoner folk er avhengige av, så en egenskap du angrer på, blir værende i versjonen den ble levert i. Linsene kan bare fjerne ting, så en rolle som trenger mer, betyr en samtale om basislinsen. Dokumentasjonskartet navngir regler som dine egne jurister må bekrefte før noen stoler på det. Og en kunde får den kun gjennom lisensen sin: du kan bygge den beste pakken i bransjen og likevel ikke slå den på for en eneste enhet før organisasjonens lisens inneholder den. Til gjengjeld koster den trettiende enheten som ønsker den, deg bare én bryter og en pilot.