Version 1.0.0-alpha.1senaste
Kapitel 2.23
Domänpaket
Vad ett domänpaket består av och vad dess pack.json anger; linser och linsregistret; kunskapsmodeller, anslutningar och mobila överlägg; hur ett paket licensieras och aktiveras för en enhet; samt de tio paket som Adverant levererar.
Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

Det paket jag byggde på Corrán Orbital började som två insticksprogram och ett dussin färdigheter i Skills Engine som bara vårt markstationsteam använde. När enheten för uppdragsdrift bad om samma sak hade jag ett val: kopiera alltihop och underhålla dubbla uppsättningar av allt, eller göra om det till ett domänpaket med en kunskapsmodell och två vyer, aktiverade per enhet. Det tog mig en vecka att göra det till ett paket. Jag skulle göra samma val igen imorgon, och nästa gång skulle jag börja med paketet.
Ett domänpaket för in en branschs arbetssätt i Nexus. Det rymmer branschens objekttyper och hur de hänger ihop, samt vad varje roll ser. Det innehåller de mallar och arbetsflöden som medarbetarna använder varje dag, de underlag som branschens regler kräver och de skärmbilder som fungerar på en telefon utan täckning. Det ändrar aldrig skalet eller dess komponenter, och aldrig skrivreglerna. En ny bransch är ett paket, inte en app.
Vad ett paket består av
Under ytan består ett paket av fyra saker, och ingen av dem är paketspecifik kod i plattformen:
- Ett paket med funktionsgrupper i behörighetskontrollen. Paketets kontroller tillhör en uppsättning funktionsgrupper. Varje menyrad och panelflik som paketet lägger till styrs sedan av samma mekanism som resten av Nexus: berättigad, visad som förhandstitt eller dold.
- Ett paketmanifest,
pack.json, som deklarerar paketets kluster av skärmbilder och dess ord, dess vyer och dess telefonskärmbilder. - Slutna moduler som verifierar sin egen tilldelning. Den serverkod som fattar beslut, såsom ett pakets kompilerade hjärnor, bär licensverifieraren inom sig och kontrollerar själv den signerade licensen. Ingenting utanför modulen kan slå på den.
- En katalogpost, så att paketet visas på sidan Domänpaket med vad det tillför och vad det kräver.
Ovanpå dessa ligger de delar som användarna ser: kunskapsmodellen och vyerna; mallar, arbetsflöden och färdigheter i Skills Engine; skrivskyddade anslutningar till de system som redan håller posterna, en beviskarta från varje regel till de poster som besvarar den, samt ett mobilt överlägg.
Filen pack.json
Här är manifestet för paketet Bank och betalningar, nedbantat till en vy med en plats och två termer. Dess fil-id är fintech, och name innehåller paketets arbetsnamn; konsolen och katalogen visar det som Bank och betalningar.
{
"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"
}
]
}
}Fälten, uppifrån och ned:
| Fält | Vad det anger |
|---|---|
id |
Paketets id, med gemener |
name |
Dess arbetsnamn |
version |
Paketets egen version |
inherits |
Det paket som detta bygger på. Bank och betalningar ärver från Försäkring, som innehåller de delade kluster som varje paket använder, såsom konversationen och inställningarna. Ett nytt paket lägger till sina vyer och överlåter de delade klustren till det paket det ärver från |
screenCount |
Hur många skärmbilder paketet definierar |
clusters[] |
Paketets grupper av skärmbilder. Var och en har ett id, ett kind, en name, vilken seats den är till för, sin purpose, de lexicon-uppsättningar dess ord kommer från, sitt menu och sina screens, var och en med ett id, en title, who och vad de är doing |
clusters[].kind |
shared för ett kluster som varje vy kan nå (exempelvis konversationen); lens för en rolls egna skärmbilder. Ett klusters scope anger om det tillhör kärnan (core) eller branschen (domain) |
lexicon |
Paketets ord, i namngivna uppsättningar. Varje term har en enkel förklaring som en nyanställd kan läsa, och den tredje platsen är exact för en term som måste användas ordagrant, såsom en regulatorisk siffra |
world |
Exempelvärlden med fiktiva klientorganisationer och platser som paketets skärmbilder och tester använder, samt dess datagrenar |
world.tenants[].plan |
Planens areas: de kluster och vyer som denna klientorganisations plan öppnar, av of |
world.tenants[].ai |
Organisationens AI-policy (artificiell intelligens) för paketet: huruvida lokala modeller på enheten är tillåtna (onDevice), var personuppgifter får skickas till en molnmodell (personalDataToCloudModels, såsom uk-only eller eu-only), och huruvida försegling av en post kräver UNO-utskick (sealRequiresUno) |
world.seats[] |
En persons plats: dennas title, den lens personen innehar, de delade clusters personen också når, dennas home-skärmbild, dennas posture (desk, field eller consumer) och, i den fullständiga filen, dennas authority, de gränser inom vilka personen agerar |
Två regler styr vad en pack.json får innehålla. Ett regelverk namnges i klarspråk med en förklaring, aldrig som enbart en förkortning. Och ingenting i filen är kod: det är en läsbar definition som servern och apparna tolkar, så den innehåller aldrig en regel eller en prompt, och aldrig en kompilerad hjärna.
Delade linser
Vissa regelverk hör till flera branscher. Ett register över utkontrakterad teknik betjänar Försäkring samt Bank och betalningar; incidentklockor (nedräkningarna till de rapporter en tillsynsmyndighet förväntar sig efter en incident) betjänar både Kritisk infrastruktur och energi samt Myndigheter och offentlig sektor. Ett regelverk som flera paket använder skrivs en gång som en delad vy. Varje paket som behöver den inkluderar den. När regeln ändras, ändras den på ett ställe.
En lins begränsar endast
En vy är vad en roll ser inuti ett paket eller en plattform: vilka kort och fält, och vilka åtgärder. Den definieras alltid som en avgränsning av en basvy. En vy med en bas visar ingen objekttyp som dess bas inte visar och öppnar inget område som dess bas inte öppnar, och den kan inte både visa och dölja samma typ. Behörigheter kommer fortfarande från roller; en vy ändrar visningen, aldrig vad en person får göra.
Försöker ni bredda en blir svaret LENS_CANNOT_WIDEN (422), utan att något sparas. I vybyggaren lyder det, för en kylcontainerteknikervy byggd på en driftledarbas som inte visar skadebelopp: "Skadebelopp kan inte läggas till i denna vy". Lösningen är en annan basvy, vilket innebär en annan begäran till den som äger basen.
Regeln upprätthålls i databasen, inte bara i rutten. Varje organisations vyer ligger i fyra tabeller i insticksregistrets schema:
| Tabell | Vad den innehåller |
|---|---|
plugins.lenses |
En vy tillhörande en ägare, ett paket (owner_kind pack) eller en plattform (platform): dess slug och name, dess base_lens_id, de typer den shows och hides, de områden den opens, dess status (active eller withdrawn) och dess version |
plugins.lens_grants |
En vy tilldelad en roll (owner, admin, member, viewer, developer eller billing_admin) i en affärsenhet |
plugins.lens_changes |
Varje ändring av en vy eller dess tilldelningar, sparad som före och efter med vem som gjorde den och varför. Endast tillägg |
plugins.lens_holder_months |
Hur många personer som innehade en vy i en enhet varje månad. Ett antal, aldrig vilka |
En utlösare nekar varje vy som visar mer än sin bas, och nekar en ändring av en bas som skulle göra att en vy byggd på den visar mer än basen gör. Ingenting raderas. Vyer och tilldelningar återkallas, och att tilldela en vy igen skapar en ny rad; en ändring skrivs aldrig om, och en tidigare månads antal ändras aldrig. Varje rad hänvisar till en vy i den egna organisationen genom en sammansatt nyckel, så en tilldelning kan inte peka över organisationsgränser.
Konsolen och era egna verktyg når registret genom /api/v1/lenses, med personens egen innehavartoken. Organisationen och personen, samt enhetsplatsen, kommer från den verifierade token och från ingenting annat.
| Metod och sökväg | Vad den gör |
|---|---|
GET / |
Vyer, filtrerade efter owner_kind, owner_id och status, med sina tilldelningar på er plats |
POST / |
Lägg till en vy: owner_kind, owner_id, slug, name, shows, och valfritt description, base_lens_id, hides, opens och reason |
GET /owners/:kind/:id |
Ett pakets eller en plattforms vyer, och vilken av dem som visar varje typ |
GET /owners/:kind/:id/grants |
Vy per enhet: de roller som tilldelats varje vy och de personer den når |
GET /owners/:kind/:id/holders |
Personer som innehar en vy varje månad (months, sex som standard) |
POST /owners/:kind/:id/holders/count |
Registrera denna månads antal |
GET /owners/:kind/:id/changes |
Ändringshistoriken för ägarens vyer (limit, 50 som standard) |
GET /:lensId |
En vy med sin bas och de vyer som avgränsar den, samt dess tilldelningar och ändringar |
PATCH /:lensId |
Ändra en vy: name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Återkalla en vy, och dess tilldelningar med den. En vy som en annan aktiv vy avgränsar kan inte återkallas förrän den andra har återkallats |
POST /:lensId/grants |
Tilldela en vy: business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Återkalla en tilldelning |
:kind är pack eller platform. Varje nekande bär en kod med en mening och ett nästa steg, och ett oväntat fel svarar UNHANDLED_ERROR med orsaken i tjänsteloggfilen, aldrig i svaret.
Kunskapsmodell, anslutningar och kompilerade hjärnor
Kunskapsmodellen är de objekttyper som paketet känner till och hur de hänger ihop. Den är versionshanterad, och ett paket bygger vanligtvis på en basmodell från det paket det ärver från: ett kylkedjepaket på logistikbasmodellen lägger till fem typer (bland dem kylcontainerenhet och fartygsanlöp) och länkar in två av dem i basen utan att ändra själva basen. Varje egenskap klassificeras när den skapas, så att personuppgiftsfälten och de kommersiella fälten är kända innan någon vy eller datagren använder dem. En vy för tekniker kan därmed inte visa ett skadebelopp som är klassificerat som kommersiellt. En återkallad egenskap ligger kvar i den version som hade den och försvinner först i en senare version. När en ny version förbereds kopieras kunskapen först, och vägen tillbaka hålls öppen under en fastställd period.
Anslutningar hämtar in poster från de system som redan håller dem: försäkringsadministration, ett skadesystem, en e-postmapp med filer som partner skickar. Var och en är skrivskyddad, körs enligt sitt eget schema och har en testknapp. Poster mappas till paketets ord på vägen in och landar i den kunskapsmodell som vyerna läser; assistentens svar hänvisar till den. Ingenting skrivs tillbaka till källsystemet från Nexus.
Kompilerade hjärnor är de delar av ett paket som fattar beslut: Försäkringspaketets hjärna för riskbedömning och dess skadehjärna, till exempel. De körs på servern som kompilerade, licensierade moduler där var och en verifierar licensen själv, och de skickas aldrig till en telefon eller en webbläsare.
Det mobila överlägget och offlinefält
Ett paket deklarerar sina telefonskärmbilder i samma manifest, som ett mobilt överlägg: vilka kort och insamlingssteg som visas på telefoner, och för vilka roller. En administratör anger sedan reglerna på telefoner per organisation, såsom hur länge insamlade uppgifter får vänta offline, huruvida varje foto bär med sig var det togs och huruvida godkännanden kräver en passnyckel. Konfigureringen sker på en dator; administratören ser vad telefoner skickar som namn och antal, aldrig själva fotona eller anteckningarna.
Varje fält som en telefonskärmbild erbjuder utan täckning deklarerar en av tre klasser, och skärmbilden visar vilken:
| Klass | Vad som händer med det | Exempel |
|---|---|---|
| Skapat offline | Sparas på telefonen och slås samman när telefonen återansluter | Anteckningar, foton, mätvärden |
| Föreslaget offline | Skickas som ett förslag som kontoret beslutar om. Servern slår aldrig samman det; den spelar upp det genom sina egna behörighetskontroller | Ett belopp, en iakttagelse, en reservändring, ett beslut |
| Aldrig offline | Inte möjligt ute i fält. Ritas som en rad med sin orsak, aldrig som en knapp | En signatur, en försegling, en behörighetskontroll, en kontroll mot en sanktionslista |
Överlägg innehåller inga regler och inga prompter, och inga hjärnor heller. De är läsbara skärmbildsdefinitioner, och allt som fattar beslut stannar på servern. Ett pakets telefonskärmbilder öppnas endast inuti Nexus telefonappar, och endast när organisationen innehar både paketet och tillägget Mobilappar.
Berättigande: vem som har paketet och var det körs
Ett paket är licensierat och slås aldrig på genom konfiguration. Tre lager avgör vem som ser det.
Licensen. Det signerade licensdokumentet bär en domain_packs-lista med matris-id:n (högst 100, eventuellt tom), bredvid sina grants och add_ons för funktionsgrupper. Adverants konsol utfärdar inte ett paket utan de tillägg det kräver: ett paket som kräver Beslutsrum och förseglade poster kan inte utfärdas till en licens utan detta. Funktionsgrupper i en licens tilldelas antingen hela installationen eller namngivna organisationer, och behörighetskontrollen svarar per organisation. Tar ni bort tilldelningen blir varje vy och telefonskärmbild i paketet en förhandstitt, medan dess poster bevaras.
Behörighetskontrollen. För varje organisation och plan, varje roll och varje person avgör behörighetskontrollen huruvida en kontroll som paketet lägger till är berättigad, visas som en förhandstitt, är dold eller nekas med en kod. Den styr menyraderna och panelflikarna samt rutt- och utskickskontrollerna. Den slutna modulen förblir auktoriteten för sin egen tilldelning.
Enheter och vyer. Inuti en organisation som har paketet bestämmer en administratör var det ska köras. Ett paket slås på för en enhet i etapper, aldrig för hela enheten på en gång: licenskontrollen, en pilotgrupp, en förinställning av inställningar och därefter breddning till alla i enheten på ett datum som administratören väljer. Innan någonting ändras visar sidan vem som får vad, per roll. Vyer tilldelas sedan per roll och per enhet, i en matris. Om paketet senare slås av för en enhet bevaras varje post som användarna har skapat; vyerna och mallarna försvinner, och ingenting annat ändras.
De tio paketen
Adverant levererar tio domänpaket. Vart och ett kräver baslicensen Enterprise och vissa kräver tillägg. Varje pakets telefonskärmbilder kräver dessutom tillägget Mobilappar.
| Paket | Matris-id | Vad det tillför | Det kräver även |
|---|---|---|---|
| Försäkring | insurance |
Försäkringsvyer för bland annat riskbedömning, skador, återförsäkring, Lloyd's och delegerad behörighet; flödet för bedrägeri och utredningar; kundresor och inställningar för försäkringsbutik; de kompilerade hjärnorna för försäkring | Beslutsrum och förseglade poster |
| Bank och betalningar | financial-services |
Ett register över utkontrakterad teknik; klockor och rapporter för teknikincidenter; exitplaner för kritiska leverantörer; kreditbeslut; kortreklamationer | Ingenting utöver basen |
| Kapitalmarknader och kapitalförvaltning | capital-markets |
Vyer för aktieanalytikern, portföljförvaltaren, övervakning och regelefterlevnad samt kundrapportering; samtal vid handelsbord inspelade; analys hållen bakom en informationsmur fram till publicering; mallar för loggen över murpassering, samtalsgranskning och analyspublicering. Telefoner får morgonöversikten och publiceringsgodkännanden samt övervakningslarm, aldrig ordrar | Beslutsrum och förseglade poster |
| Myndigheter och offentlig sektor | government |
Ansökningar om förmåner och ersättningar; bygglovsansökningar; begäranden om allmänna handlingar | Ingenting utöver basen |
| Hälso- och sjukvård | healthcare-providers |
Åtkomst till och delning av patientjournaler samt informationsbegäranden. Inget kliniskt beslutsstöd | Ingenting utöver basen |
| Life science | life-sciences |
Avvikelser och korrigerande åtgärder; granskning av batchdokumentation; validerad ändringskontroll | Ingenting utöver basen |
| Kritisk infrastruktur och energi | energy-and-utilities |
Incidentklockor och rapporter; inspektioner och defekter; arbetsordrar | Ingenting utöver basen |
| Försvar och säkerhet | defence-and-mission |
Fältrapporter sammanfogade med plattformslarm; delningsmarkeringar; avrapporteringar. Dess telefonversion installeras endast genom enhetshantering | Nexus Edge, för plattformslarmen |
| Juridik och konsulttjänster | legal |
Vyer för juristen, kunskapsjuristen, jäv och risk samt fakturering; en jävskontroll vid varje nytt ärende; etiska murar som endast kan hävas av två delägare; mallar för kontroll av nytt ärende, murbyggaren och murpåminnelser. Telefoner får tidsregistrering och ärendeuppdateringar med godkännanden, aldrig sekretessbelagda filer | Decision rooms and sealed records samt Mail |
| Logistik och sjöfart | logistics-and-maritime |
Vyer för driftledaren, tulltjänstemannen, transportörsansvarig och hamninspektören; tulldeklarationer och tullspärrar; sanktionskontroller före den första bokningen, där en person frigör varje spärr; en kunskapsmodell över hamnar och fartyg, transportörer och spärrar. Telefoner får bangårds- och kajinspektioner samt tullspärrar, med drönariakttagelser | Karta och GeoAI |
Harrow Port Authority kör paketet Logistik och sjöfart, och det är det jag skulle läsa först om ni bygger ett eget: dess kunskapsmodell är den bas som kylkedjeexemplet ovan bygger på.
Bygga ett eget
På Enterprise startar en utvecklare ett paket från standardvägen i Starta något nytt, i tre steg. "Om paketet" namnger paketet, dess enheter, det paket det bygger på och de regler det måste uppvisa underlag för. "Kunskapsmodell" lägger till de nya objekttyperna ovanpå basmodellen. "Granska och skapa" visar planen och följer den sedan. Den skapar ett kodförråd från paketmallen med ett manifest som deklarerar vad paketet får nå, samt dess tester; därefter en utvecklingsyta med syntetiska datagrenar; och sedan ett utkast till katalogpost som bara ni kan se. Ingenting skapas förrän ni trycker på Skapa i det sista steget. Kapitel 2.24, Bygga en anpassad vertikal från början till slut, går igenom hela vägen.
Vad ett paket kostar dig
Ett paket är den dyraste utökningen att äga. Dess kunskapsmodell har versioner som användarna är beroende av, så en egenskap ni ångrar ligger kvar i den version som levererade den. Dess vyer kan bara ta bort, så en roll som behöver mer innebär ett samtal om basvyn. Dess beviskarta namnger regler som era egna bolagsjurister måste bekräfta innan någon förlitar sig på den. Och en kund får det endast genom sin licens: ni kan bygga det bästa paketet i branschen och ändå inte slå på det för en enda enhet förrän organisationens licens bär det. I gengäld kostar den trettionde enheten som vill ha det er ett reglage och en pilot.




