Version 1.0.0-alpha.1seneste
Kapitel 2.23
Domænepakker
Hvad en domænepakke består af, og hvad dens pack.json angiver; linser og linseregistret; vidensmodeller, konnektorer og mobile overlejringer; hvordan en pakke licenseres og aktiveres for en enhed; og de ti pakker Adverant leverer.
Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

Den pakke, jeg byggede hos Corrán Orbital, begyndte som to plugins og et dusin færdigheder i Skills Engine, som kun vores jordstationsteam brugte. Da enheden for missionsdrift bad om det samme, stod jeg over for et valg: kopiere det hele og vedligeholde to af alting, eller omdanne det til en domænepakke med én vidensmodel og to linser, der slås til pr. enhed. Det tog mig en uge at gøre det til en pakke. Jeg ville træffe det samme valg igen i morgen, og næste gang ville jeg begynde med pakken.
En domænepakke bringer en branches arbejdsform ind i Nexus. Den rummer branchens typer af objekter, hvordan de hænger sammen, og hvad hver rolle ser. Den indeholder de skabeloner og arbejdsgange, folk bruger hver dag, den dokumentation, som branchens regler kræver, samt de skærmbilleder, der fungerer på en telefon uden dækning. Den ændrer aldrig skallen eller dens komponenter, og aldrig skrivereglerne. En ny branche er en pakke, ikke en app.
Hvad en pakke består af
Nedenunder består en pakke af fire ting, og ingen af dem er pakkespecifik kode i platformen:
- En samling funktionsgrupper i rettighedstjekket. Pakkens kontrolelementer tilhører et sæt funktionsgrupper. Hver menurække og hvert panel-faneblad, som pakken tilføjer, afgøres derefter af den samme mekanisme som i resten af Nexus: berettiget, vist som forsmag eller skjult.
- Et pakkemanifest,
pack.json, som erklærer pakkens klynger af skærmbilleder og dens ordforråd, dens linser og dens telefonskærmbilleder. - Lukkede moduler, der selv verificerer deres tildeling. Den serverkode, der træffer beslutninger, såsom en pakkes kompilerede hjerner, bærer licensverifikatoren indeni sig og kontrollerer selv den signerede licens. Intet uden for modulet kan slå det til.
- En katalogpost, så pakken vises på siden Domænepakker med det, den tilfører, og det, den kræver.
Oven på disse ligger de dele, folk ser: vidensmodellen og linserne; skabeloner, arbejdsgange og færdigheder i Skills Engine; skrivebeskyttede forbindelser til de systemer, der allerede rummer registreringerne, et dokumentationskort fra hver regel til de registreringer, der opfylder den, samt en mobiloverlejring.
Filen pack.json
Her er manifestet for pakken Bank og betalinger, beskåret til én linse med én plads og to begreber. Dets fil-id er fintech, og name indeholder pakkens arbejdsnavn; konsollen og kataloget 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"
}
]
}
}Felterne, oppefra og ned:
| Felt | Hvad der står i den |
|---|---|
id |
Pakkens id, med små bogstaver |
name |
Dens arbejdsnavn |
version |
Pakkens egen version |
inherits |
Den pakke, som denne bygger videre på. Bank og betalinger arver fra Forsikring, som rummer de delte klynger, alle pakker bruger, såsom samtalen og indstillingerne. En ny pakke tilføjer sine linser og overlader de delte klynger til den pakke, den arver fra |
screenCount |
Hvor mange skærmbilleder pakken definerer |
clusters[] |
Pakkens grupper af skærmbilleder. Hver har et id, et kind, et name, den seats den er til, sin purpose, de lexicon-sæt dens ord kommer fra, sin menu og sine screens, hver med et id, et title, who og hvad de er doing |
clusters[].kind |
shared for en klynge, som enhver linse kan nå (f.eks. samtalen); lens for én rolles egne skærmbilleder. En klynges scope angiver, om den tilhører kernen (core) eller branchen (domain) |
lexicon |
Pakkens ord, i navngivne sæt. Hvert begreb har en enkel forklaring, som en ny medarbejder kan læse, og den tredje plads er exact for et begreb, der skal bruges ordret, såsom et lovbestemt nøgletal |
world |
Den eksempelverden af fiktive lejere og pladser, som pakkens skærmbilleder og test bruger, samt dens datagrene |
world.tenants[].plan |
Planens areas: de klynger og linser, som denne lejers plan åbner, ud af of |
world.tenants[].ai |
Organisationens AI-politik (kunstig intelligens) for pakken: om modeller på selve enheden er tilladt (onDevice), hvor personoplysninger må sendes hen til en cloud-model (personalDataToCloudModels, såsom uk-only eller eu-only), og om forsegling af en registrering kræver UNO-afsendelse (sealRequiresUno) |
world.seats[] |
Én persons plads: vedkommendes title, den lens vedkommende har, de delte clusters vedkommende også kan nå, vedkommendes home-skærmbillede, vedkommendes posture (desk, field eller consumer) og, i den fulde fil, vedkommendes authority, de grænser vedkommende handler inden for |
To regler styrer, hvad en pack.json må indeholde. En forordning eller et regelsæt nævnes med almindelige ord og en forklaring, aldrig blot som en forkortelse. Og intet i filen er kode: det er en læsbar definition, som serveren og appsene fortolker, så den indeholder aldrig en regel eller en prompt, og aldrig en kompileret hjerne.
Delte linser
Nogle regelsæt hører til flere brancher. Et register over outsourcet teknologi tjener både Forsikring og Bank og betalinger; hændelsesure (nedtællingerne til de indberetninger, en tilsynsmyndighed forventer efter en hændelse) tjener både Kritisk infrastruktur og energi samt Stat og offentlig sektor. Et regelsæt, som flere pakker bruger, skrives én gang som en delt linse. Hver pakke, der har brug for det, inkluderer det. Når reglen ændres, ændres den ét sted.
En linse indsnævrer kun
En linse er det, én rolle ser inde i en pakke eller en platform: hvilke kort og felter, og hvilke handlinger. Den defineres altid som en indsnævring af en basislinse. En linse med en basis viser ingen type objekt, som dens basis ikke viser, og åbner intet område, som dens basis ikke åbner, og den kan ikke både vise og skjule den samme type. Tilladelser kommer stadig fra roller; en linse ændrer visningen, aldrig hvad en person må gøre.
Forsøger man at udvide en, er svaret LENS_CANNOT_WIDEN (422), og intet gemmes. I linsebyggeren lyder det, for en køleteknikerlinse bygget på en driftscontroller-basis, der ikke viser skadesbeløb: "Skadesbeløb kan ikke føjes til denne linse". Løsningen er en anden basislinse, hvilket er en anden anmodning til den, der ejer basissen.
Reglen håndhæves i databasen, ikke kun i ruten. Hver organisations linser ligger i fire tabeller i plugin-registrets skema:
| Tabel | Hvad den indeholder |
|---|---|
plugins.lenses |
Én linse tilhørende én ejer, en pakke (owner_kind pack) eller en platform (platform): dens slug og name, dens base_lens_id, de typer den shows og hides, de områder den opens, dens status (active eller withdrawn) og dens version |
plugins.lens_grants |
En linse tildelt én rolle (owner, admin, member, viewer, developer eller billing_admin) i én forretningsenhed |
plugins.lens_changes |
Enhver ændring af en linse eller dens tildelinger, gemt som før og efter med hvem der foretog den og hvorfor. Kun tilføjelse |
plugins.lens_holder_months |
Hvor mange personer der havde en linse i en enhed hver måned. Et antal, aldrig hvem |
En trigger afviser enhver linse, der viser mere end sin basis, og afviser en ændring af en basis, som ville efterlade en linse bygget på den med at vise mere, end basissen gør. Intet slettes. Linser og tildelinger trækkes tilbage, og at tildele en linse igen er en ny række; en ændring omskrives aldrig, og en tidligere måneds optælling ændres aldrig. Hver række henviser til en linse i sin egen organisation via en sammensat nøgle, så en tildeling ikke kan pege på tværs af organisationer.
Konsollen og dine egne værktøjer tilgår registret via /api/v1/lenses med personens eget ihændehavertoken. Organisationen og personen samt enhedspladsen kommer fra det verificerede token og intet andet sted fra.
| Metode og sti | Hvad den gør |
|---|---|
GET / |
Linser, filtreret efter owner_kind, owner_id og status, med deres tildelinger på din plads |
POST / |
Tilføj en linse: owner_kind, owner_id, slug, name, shows og valgfrit description, base_lens_id, hides, opens og reason |
GET /owners/:kind/:id |
En pakkes eller platforms linser, og hvilke af dem der viser hver type |
GET /owners/:kind/:id/grants |
Linse pr. enhed: de roller, der har fået hver linse, og de personer, den når ud til |
GET /owners/:kind/:id/holders |
Personer med en linse hver måned (months, seks som standard) |
POST /owners/:kind/:id/holders/count |
Registrer denne måneds optællinger |
GET /owners/:kind/:id/changes |
Ændringshistorikken for ejerens linser (limit, 50 som standard) |
GET /:lensId |
Én linse med dens basis og de linser, der indsnævrer den, samt dens tildelinger og ændringer |
PATCH /:lensId |
Ændr en linse: name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Træk en linse tilbage, og dens tildelinger med den. En linse, som en anden aktiv linse indsnævrer, kan ikke trækkes tilbage, før den anden er det |
POST /:lensId/grants |
Tildel en linse: business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Træk én tildeling tilbage |
:kind er pack eller platform. Enhver afvisning indeholder en kode med en sætning og et næste skridt, og en uventet fejl svarer UNHANDLED_ERROR med årsagen i serviceloggen, aldrig i svaret.
Vidensmodel, konnektorer og kompilerede hjerner
Vidensmodellen er de typer af objekter, pakken kender, og hvordan de er forbundet. Den er versioneret, og en pakke bygger som regel videre på en basismodel fra den pakke, den arver fra: en kølekædepakke oven på logistikbasismodellen tilføjer fem typer (herunder køleenhed og skibsanløb) og knytter to af dem ind i basissen uden at ændre selve basissen. Hver egenskab klassificeres, når den oprettes, så de personhenførbare felter og de forretningsmæssige er kendt, før nogen linse eller datagren bruger dem. En linse til teknikere kan derefter ikke vise et skadesbeløb, der er klassificeret som forretningsmæssigt. En tilbagetrukket egenskab bliver i den version, der havde den, og udgår først i en senere version. Klargøring af en ny version kopierer først videnen, og vejen tilbage holdes åben i en fastsat periode.
Forbindelser henter registreringer ind fra de systemer, der allerede rummer dem: policeadministration, et skadessystem, en mailmappe med filer, som partnere sender. Hver enkelt er skrivebeskyttet, kører efter sin egen tidsplan og har en testknap. Registreringer knyttes til pakkens ord på vej ind og lander i den vidensmodel, som linserne læser; assistentens svar henviser til den. Intet skrives tilbage til kildesystemet fra Nexus.
Kompilerede hjerner er de dele af en pakke, der træffer beslutninger: f.eks. Forsikringspakkens tegningshjerne og dens skadeshjerne. De kører på serveren som kompilerede, licenserede moduler, der hver især selv verificerer licensen, og de sendes aldrig ud til en telefon eller en browser.
Den mobile overlejring og offline-felter
En pakke erklærer sine telefonskærmbilleder i det samme manifest som en mobiloverlejring: hvilke kort og registreringstrin der vises på telefoner, og for hvilke roller. En administrator fastsætter derefter reglerne på telefoner pr. organisation, såsom hvor længe registreringer må vente offline, om hvert foto gemmer, hvor det blev taget, og om godkendelser kræver en adgangsnøgle (passkey). Opsætningen bliver på en computer; administratoren ser det, telefonerne sender, som navne og antal, aldrig selve fotosene eller noterne.
Hvert felt, et telefonskærmbillede tilbyder uden dækning, erklærer en af tre klasser, og skærmbilledet viser hvilken:
| Klasse | Hvad der sker med det | Eksempler |
|---|---|---|
| Oprettet offline | Gemmes på telefonen og flettes ind, når telefonen får forbindelse igen | Noter, fotos, aflæsninger |
| Foreslået offline | Sendes som et forslag, som kontoret tager stilling til. Serveren fletter det aldrig ind; den afvikler det gennem sine egne beføjelsestjek | Et beløb, en konstatering, en reserveændring, en beslutning |
| Aldrig offline | Ikke muligt ude i marken. Tegnes som en række med årsagen, aldrig som en knap | En underskrift, en forsegling, et beføjelsestjek, et tjek mod en sanktionsliste |
Overlejringer indeholder ingen regler og ingen prompter, og heller ingen hjerner. De er læsbare skærmbillededefinitioner, og alt, der træffer beslutninger, bliver på serveren. En pakkes telefonskærmbilleder åbnes kun inde i Nexus-telefonappsene, og kun når organisationen har både pakken og tilføjelsen Mobilapps.
Rettigheder: hvem der har pakken, og hvor den kører
En pakke er licenseret og slås aldrig til via konfiguration. Tre lag afgør, hvem der ser den.
Licensen. Det signerede licensdokument indeholder en domain_packs-liste over matrix-id'er (højst 100, eventuelt tom) ved siden af dets funktionsgruppe-grants og add_ons. Adverants konsol udsteder ikke en pakke uden de tilføjelser, den kræver: en pakke, der kræver Beslutningsrum og forseglede registreringer, kan ikke udstedes til en licens uden denne. Funktionsgrupper i en licens tildeles enten hele installationen eller navngivne organisationer, og rettighedstjekket svarer pr. organisation. Fjerner man tildelingen, bliver hver linse og hvert telefonskærmbillede i pakken til en forsmag, mens registreringerne bevares.
Rettighedstjekket. For hver organisation og plan, hver rolle og hver person afgør rettighedstjekket, om et kontrolelement, som pakken tilføjer, er berettiget, vises som en forsmag, skjules eller afvises med en kode. Det styrer menurækkerne og panel-fanebladene samt rute- og afsendelsestjekkene. Det lukkede modul forbliver autoriteten for sin egen tildeling.
Enheder og linser. Inde i en organisation, der har pakken, bestemmer en administrator, hvor den kører. En pakke slås til for en enhed i etaper, aldrig for hele enheden på én gang: licenstjekket, en pilotgruppe, en forudindstilling af indstillinger og derefter udvidelse til alle i enheden på en dato, som administratoren vælger. Før noget ændres, viser siden, hvem der får hvad, opdelt efter rolle. Linser tildeles derefter pr. rolle og pr. enhed i én samlet matrix. Slår man senere pakken fra for en enhed, bevares alle de registreringer, folk har oprettet; linserne og skabelonerne forsvinder, og intet andet ændres.
De ti pakker
Adverant leverer ti domænepakker. Hver enkelt kræver Enterprise-basislicensen, og nogle kræver tilføjelser. Alle pakkers telefonskærmbilleder kræver desuden tilføjelsen Mobilapps.
| Pakke | Matrix-id | Hvad den tilfører | Den kræver også |
|---|---|---|---|
| Forsikring | insurance |
Forsikringslinser til bl.a. tegning, skader, genforsikring, Lloyd's og delegeret tegningsret; arbejdsgangen for svig og undersøgelser; kunderejser og indstillinger for forsikringsbutikken; de kompilerede forsikringshjerner | Beslutningsrum og forseglede optegnelser |
| Bankvæsen og betalinger | financial-services |
Et register over outsourcet teknologi; hændelsesure og indberetninger for teknologihændelser; exitplaner for kritiske leverandører; kreditbeslutninger; kortindsigelser | Intet ud over basissen |
| Kapitalmarkeder og kapitalforvaltning | capital-markets |
Linser til aktieanalytikeren, porteføljeforvalteren, overvågning og compliance samt kunderapportering; optagelse af opkald ved handelsborde; analyse opbevaret bag en informationsmur indtil frigivelse; skabeloner til murkrydsningsloggen, opkaldsgennemgang og frigivelse af analyse. Telefoner får morgenbriefingen og frigivelsesgodkendelser samt overvågningsalarmer, aldrig ordrer | Beslutningsrum og forseglede optegnelser |
| Stat og offentlig sektor | government |
Ansøgninger om ydelser og rettigheder; byggetilladelser og planansøgninger; anmodninger om aktindsigt | Intet ud over basissen |
| Sundhedsvæsen | healthcare-providers |
Adgang til og deling af patientjournaler samt anmodninger om oplysninger. Ingen klinisk beslutningsstøtte | Intet ud over basissen |
| Life science | life-sciences |
Afvigelser og korrigerende handlinger; gennemgang af batchregistreringer; valideret ændringsstyring | Intet ud over basissen |
| Kritisk infrastruktur og energi | energy-and-utilities |
Hændelsesure og indberetninger; inspektioner og mangler; arbejdsordrer | Intet ud over basissen |
| Forsvar og sikkerhed | defence-and-mission |
Feltrapporter sammensmeltet med platformalarmer; delingsmærkninger; debriefinger. Dens telefonversion installeres kun via enhedsstyring | Nexus Edge, til platformalarmerne |
| Juridisk rådgivning og liberale erhverv | legal |
Linser til sagsbehandleren (fee earner), vidensadvokaten, interessekonflikter og risiko samt fakturering; et konflikttjek ved hver ny sag; etiske mure, der kun kan ophæves af to partnere; skabeloner til tjek ved ny sag, murbyggeren og murpåmindelser. Telefoner får tidsregistrering og sagsopdateringer med godkendelser, aldrig fortrolige sagsakter | Beslutningsrum og forseglede optegnelser samt Mail |
| Logistik og søfart | logistics-and-maritime |
Linser til driftscontrolleren, toldmedarbejderen, den transportøransvarlige og havneinspektøren; toldangivelser og tilbageholdelser; sanktionstjek før den første booking, hvor en person frigiver hver tilbageholdelse; en vidensmodel over havne og fartøjer, transportører og tilbageholdelser. Telefoner får plads- og kajinspektioner samt toldtilbageholdelser med droneobservationer | Kort og GeoAI |
Harrow Port Authority kører pakken Logistik og søfart, og det er den, jeg ville læse først, hvis du skal bygge din egen: dens vidensmodel er den basis, som kølekædeeksemplet ovenfor bygger videre på.
Byg jeres egen
På Enterprise starter en udvikler en pakke fra standardforløbet i Start noget nyt i tre trin. "Om pakken" navngiver pakken, dens enheder, den pakke den bygger videre på, og de regler den skal kunne fremvise dokumentation for. "Vidensmodel" tilføjer de nye typer af objekter oven på basismodellen. "Gennemse og opret" viser planen og følger den derefter. Den opretter et kodelager ud fra pakkeskabelonen med et manifest, der erklærer, hvad pakken må tilgå, samt dens test; derefter et udviklingsmiljø med syntetiske datagrene; og derefter en kladde til en katalogpost, som kun du kan se. Intet oprettes, før du trykker på Opret på det sidste trin. Kapitel 2.24, Opbygning af en skræddersyet brancheløsning fra ende til anden, gennemgår hele forløbet.
Hvad en pakke koster jer
En pakke er den dyreste udvidelse at eje. Dens vidensmodel har versioner, som folk er afhængige af, så en egenskab, du fortryder, bliver i den version, den blev leveret i. Dens linser kan kun fjerne elementer, så en rolle, der har brug for mere, kræver en drøftelse om basislinsen. Dens dokumentationskort navngiver regler, som jeres egne jurister skal bekræfte, før nogen støtter sig til det. Og en kunde får den kun gennem sin licens: du kan bygge den bedste pakke i branchen og alligevel ikke slå den til for en eneste enhed, før organisationens licens indeholder den. Til gengæld koster den tredivte enhed, der ønsker den, dig blot ét klik og et pilotforløb.




