Versjon 1.0.0-alpha.1nyeste
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

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:
- 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.
- Et pakkemanifest,
pack.json, som deklarerer pakkens klynger av skjermbilder og dens ord, dens linser og dens telefonskjermer. - 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å.
- 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.
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.
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.
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.
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.
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.




