PrijavaRezervirajte predstavitev

Poglavje 2.23

Domenski paketi

Iz česa je sestavljen domenski paket in kaj določa njegova datoteka pack.json; leče in register leč; modeli znanja, priključki in mobilne prekrivne plasti; kako se paket licencira in vklopi za posamezno enoto ter deset paketov, ki jih dobavlja Adverant.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

19 min branja

Paket, ki sem ga zgradil pri Corrán Orbital, se je začel kot dva vtičnika in ducat veščin za Skills Engine, ki jih je uporabljala le naša ekipa na zemeljski postaji. Ko je enota za vodenje misij prosila za isto stvar, sem imel izbiro: skopirati vse skupaj in vzdrževati vse v dveh izvodih ali pa to spremeniti v domenski paket z enim modelom znanja in dvema lečama, ki se vklopita glede na enoto. Potreboval sem teden dni, da sem iz tega naredil paket. Jutri bi se odločil enako, naslednjič pa bi začel kar s paketom.

Domenski paket v Nexus prinaša način dela posamezne panoge. Vsebuje vrste entitet te panoge in kako se povezujejo ter kaj vidi posamezna vloga. Prinaša predloge in delovne tokove, ki jih ljudje uporabljajo vsak dan, dokazila, ki jih zahtevajo pravila panoge, in zaslone, ki delujejo na telefonu brez signala. Nikoli ne spremeni lupine ali njenih komponent in nikoli pravil pisanja. Nova panoga je paket, ne aplikacija.

Iz česa je paket sestavljen

V ozadju je paket sestavljen iz štirih stvari in nobena od njih ni koda za posamezen paket v platformi:

  1. Sveženj skupin funkcij pri preverjanju upravičenosti. Kontrolniki paketa pripadajo naboru skupin funkcij. O vsaki vrstici menija in zavihku podokna, ki ju doda paket, nato odloča enak mehanizem kot o preostalem delu sistema Nexus: upravičeno, prikazano kot dražilnik ali skrito.
  2. Manifest paketa, pack.json, ki deklarira gruče zaslonov paketa in njegovo besedišče, njegove leče in njegove zaslone za telefone.
  3. Zaprti moduli, ki sami preverjajo svojo dodelitev. Strežniška koda, ki sprejema odločitve, kot so prevedeni možgani paketa, nosi preverjevalnik licence v sebi in sama preveri podpisano licenco. Nič zunaj modula ga ne more vklopiti.
  4. Kataloški vnos, tako da se paket prikaže na strani Domenski paketi s tem, kar prinaša, in tem, kar potrebuje.

Nad tem so deli, ki jih ljudje vidijo: model znanja in leče; predloge, delovni tokovi in veščine za Skills Engine; bralni konektorji v sisteme, ki že hranijo zapise, preslikava dokazil od vsakega pravila do zapisov, ki nanj odgovarjajo, in mobilna prekrivna plast.

Domenski paketi
Domenski paketi
Stran Domenski paketi navaja vseh deset paketov s tem, kaj vsak potrebuje in kje deluje. Paket dodeli samo Adverant; vi se odločite, v katerih enotah bo deloval.

Datoteka pack.json

Tukaj je manifest paketa Bančništvo in plačila, skrajšan na eno lečo z enim sedežem in dvema izrazoma. ID njegove datoteke je fintech, name pa hrani delovno ime paketa; konzola in katalog ga prikazujeta kot Bančništvo in plačila.

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

Polja, od zgoraj navzdol:

Polje Kaj navaja
id ID paketa, z malimi črkami
name Njegovo delovno ime
version Lastna različica paketa
inherits Paket, na katerem ta gradi. Bančništvo in plačila deduje od paketa Zavarovalništvo, ki hrani skupne gruče, ki jih uporablja vsak paket, kot so pogovor in nastavitve. Nov paket doda svoje leče, skupne gruče pa prepusti paketu, od katerega deduje
screenCount Koliko zaslonov določa paket
clusters[] Skupine zaslonov paketa. Vsaka ima id, kind, name, seats, ki mu je namenjena, svoj purpose, nabore lexicon, iz katerih prihajajo njene besede, svoj menu in svoje screens, pri čemer ima vsak svoj id, title, who in čemu so doing
clusters[].kind shared za gručo, ki jo lahko doseže vsaka leča (recimo pogovor); lens za lastne zaslone ene vloge. scope gruče pove, ali pripada jedru (core) ali panogi (domain)
lexicon Besede paketa v poimenovanih naborih. Vsak izraz ima preprosto razlago, ki jo novinec lahko prebere, tretje mesto pa je exact za izraz, ki ga je treba uporabiti dobesedno, kot je regulativna številka
world Vzorčni svet izmišljenih najemnikov in sedežev, ki ga uporabljajo zasloni in testi paketa, ter njegove podatkovne veje
world.tenants[].plan areas naročniškega paketa: gruče in leče, ki jih odpre naročniški paket tega najemnika, izmed of
world.tenants[].ai Pravilnik organizacije o UI (umetni inteligenci) za paket: ali so dovoljeni modeli na napravi (onDevice), kam lahko gredo osebni podatki v model v oblaku (personalDataToCloudModels, kot je uk-only ali eu-only) in ali zapečatenje zapisa zahteva odpremo UNO (sealRequiresUno)
world.seats[] Sedež ene osebe: njen title, lens, ki jo ima, skupne clusters, ki jih prav tako doseže, njen zaslon home, njen posture (desk, field ali consumer) in v celotni datoteki njene authority, omejitve, znotraj katerih deluje

Dve pravili določata, kaj sme vsebovati datoteka pack.json. Predpis je poimenovan z običajnimi besedami in razlago, nikoli le kot gola kratica. In nič v datoteki ni koda: gre za berljivo definicijo, ki jo strežnik in aplikacije tolmačijo, zato nikoli ne vsebuje pravila ali poziva in nikoli prevedenih možganov.

Deljene leče

Nekateri režimi pripadajo več panogam. Register zunanjega izvajanja tehnologije služi paketoma Zavarovalništvo ter Bančništvo in plačila; ure za incidente (odštevanja do poročil, ki jih regulator pričakuje po incidentu) služijo tako paketu Kritična infrastruktura in energetika kot paketu Državna uprava in javni sektor. Režim, ki ga uporablja več paketov, je napisan enkrat kot skupna leča. Vsak paket, ki ga potrebuje, ga vključi. Ko se pravilo spremeni, se spremeni na enem mestu.

Leča pogled le zoži

Leča je tisto, kar ena vloga vidi znotraj paketa ali platforme: katere kartice in polja ter katera dejanja. Vedno je definirana kot zožitev osnovne leče. Leča z osnovo ne prikazuje nobene vrste entitet, ki je ne prikazuje njena osnova, in ne odpira nobenega področja, ki ga ne odpira njena osnova, hkrati pa ne more iste vrste hkrati prikazati in skriti. Dovoljenja še vedno izhajajo iz vlog; leča spremeni pogled, nikoli pa tistega, kar oseba sme storiti.

Če jo poskusite razširiti, je odgovor LENS_CANNOT_WIDEN (422) in nič se ne shrani. V gradniku leč se to za lečo tehnika hladilnih zabojnikov, zgrajeno na osnovi kontrolorja operacij, ki ne prikazuje zneskov zahtevkov, glasi: »Zneska zahtevka ni mogoče dodati tej leči«. Rešitev je druga osnovna leča, kar pomeni drugo zahtevo tistemu, ki je lastnik osnove.

Graditelj pogledov
Graditelj pogledov
Gradnik leč navaja, kaj vloga vidi, kartico za kartico in polje za poljem, označeno glede na osnovno lečo, ki jo zožuje. Poskus prikaza polja, ki ga osnova skriva, je zavrnjen z razlogom in imenom tistega, ki lahko spremeni osnovo.

Pravilo se hrani v podatkovni zbirki, ne le v poti. Leče vsake organizacije se nahajajo v štirih tabelah sheme registra vtičnikov:

Tabela Kaj vsebuje
plugins.lenses Ena leča enega lastnika, paketa (owner_kind pack) ali platforme (platform): njen slug in name, njen base_lens_id, vrste, ki jih shows in hides, področja, ki jih opens, njen status (active ali withdrawn) in njen version
plugins.lens_grants Leča, dodeljena eni vlogi (owner, admin, member, viewer, developer ali billing_admin) v eni poslovni enoti
plugins.lens_changes Vsaka sprememba leče ali njenih dodelitev, shranjena kot stanje prej in potem, skupaj s tem, kdo jo je naredil in zakaj. Samo za dodajanje
plugins.lens_holder_months Koliko ljudi je imelo lečo v enoti vsak mesec. Število, nikoli kdo

Sprožilec zavrne vsako lečo, ki prikazuje več kot njena osnova, in zavrne spremembo osnove, zaradi katere bi leča, zgrajena na njej, prikazovala več kot osnova. Nič se ne izbriše. Leče in dodelitve se umaknejo, ponovna dodelitev leče pa je nova vrstica; sprememba se nikoli ne prepiše in število preteklega meseca se nikoli ne spremeni. Vsaka vrstica navaja lečo lastne organizacije prek sestavljenega ključa, tako da dodelitev ne more kazati v drugo organizacijo.

Konzola in vaša lastna orodja dosežejo register prek /api/v1/lenses z lastnim imetniškim žetonom osebe. Organizacija in oseba ter sedež v enoti izhajajo iz preverjenega žetona in iz ničesar drugega.

Metoda in pot Kaj naredi
GET / Leče, filtrirane po owner_kind, owner_id in status, z njihovimi dodelitvami na vašem sedežu
POST / Dodajanje leče: owner_kind, owner_id, slug, name, shows ter izbirno description, base_lens_id, hides, opens in reason
GET /owners/:kind/:id Leče paketa ali platforme in katera od njih prikazuje posamezno vrsto
GET /owners/:kind/:id/grants Leča po enoti: vloge, ki jim je dodeljena posamezna leča, in ljudje, ki jih doseže
GET /owners/:kind/:id/holders Ljudje, ki imajo lečo vsak mesec (months, privzeto šest)
POST /owners/:kind/:id/holders/count Zabeleži števila tega meseca
GET /owners/:kind/:id/changes Zgodovina sprememb lastnikovih leč (limit, privzeto 50)
GET /:lensId Ena leča s svojo osnovo in lečami, ki jo zožujejo, ter njenimi dodelitvami in spremembami
PATCH /:lensId Sprememba leče: name, description, shows, hides, opens, reason
POST /:lensId/withdraw Umik leče in z njo njenih dodelitev. Leče, ki jo zožuje druga aktivna leča, ni mogoče umakniti, dokler ni umaknjena tista
POST /:lensId/grants Dodelitev leče: business_unit_id, role, reason
POST /:lensId/grants/:grantId/withdraw Umik ene dodelitve

:kind je pack ali platform. Vsaka zavrnitev vsebuje kodo s stavkom in naslednjim korakom, nepričakovana napaka pa odgovori s UNHANDLED_ERROR, pri čemer je njen vzrok v dnevniku storitve, nikoli v odgovoru.

Model znanja, priključki in prevedeni možgani

Model znanja predstavlja vrste entitet, ki jih paket pozna, in kako se povezujejo. Je različičen in paket običajno gradi na osnovnem modelu iz paketa, od katerega deduje: paket hladne verige na osnovnem logističnem modelu doda pet vrst (med njimi hladilno enoto in postanek plovila) ter dve od njih poveže v osnovo, ne da bi spremenil samo osnovo. Vsaka lastnost je klasificirana ob nastanku, tako da so osebna in komercialna polja znana, preden jih uporabi katera koli leča ali podatkovna veja. Leča za tehnike nato ne more prikazati zneska zahtevka, ki je klasificiran kot komercialen. Umaknjena lastnost ostane v različici, ki jo je imela, in izpade šele v poznejši različici. Priprava nove različice najprej kopira znanje, pot nazaj pa ostane odprta določeno obdobje.

Konektorji prinašajo zapise iz sistemov, ki jih že hranijo: upravljanje polic, sistem za zahtevke, poštna mapa z datotekami, ki jih pošiljajo partnerji. Vsak je samo za branje, deluje po lastnem urniku in ima gumb za testiranje. Zapisi se ob vstopu preslikajo v besedišče paketa in pristanejo v modelu znanja, ki ga berejo leče; odgovori pomočnika se sklicujejo nanj. Iz sistema Nexus se nič ne zapiše nazaj v izvorni sistem.

Prevedeni možgani so deli paketa, ki sprejemajo odločitve: na primer možgani za ocenjevanje tveganj in možgani za zahtevke v paketu Zavarovalništvo. Na strežniku delujejo kot prevedeni, licencirani moduli, pri čemer vsak sam preverja licenco, in nikoli niso poslani na telefon ali v brskalnik.

Model znanja in konektorji
Model znanja in konektorji
Model znanja in konektorji prikazuje različico modela in besedišče paketa skupaj z lastnimi izrazi organizacije ter testira vsak bralni konektor. V sistemih za police ali zahtevke se iz sistema Nexus nič ne spremeni.

Mobilna prekrivna plast in polja za delo brez povezave

Paket deklarira svoje zaslone za telefone v istem manifestu kot mobilno prekrivno plast: katere kartice in koraki zajema se prikažejo na telefonih in za katere vloge. Skrbnik nato nastavi pravila na telefonih za posamezno organizacijo, na primer kako dolgo lahko zajemi čakajo brez povezave, ali vsaka fotografija vsebuje podatke o tem, kje je bila posneta, in ali odobritve potrebujejo potrdilo o identiteti (passkey). Nastavljanje ostane na računalniku; skrbnik vidi tisto, kar pošiljajo telefoni, kot imena in števila, nikoli pa samih fotografij ali zapiskov.

Vsako polje, ki ga zaslon telefona ponuja brez signala, deklarira enega od treh razredov in zaslon prikaže katerega:

Razred Kaj se z njim zgodi Primeri
Ustvarjeno brez povezave Shranjeno na telefonu in združeno, ko se telefon znova poveže Zapiski, fotografije, odčitki
Predlagano brez povezave Poslano kot predlog, o katerem odloči pisarna. Strežnik ga nikoli ne združi; ponovno ga izvede prek lastnih preverjanj pooblastil Znesek, ugotovitev, sprememba rezervacije, odločitev
Nikoli brez povezave Na terenu ni mogoče. Izrisano kot vrstica z razlogom, nikoli kot gumb Podpis, pečat, preverjanje pooblastil, preverjanje glede na seznam sankcij

Prekrivne plasti ne vsebujejo nobenih pravil in nobenih pozivov, pa tudi nobenih možganov. So berljive definicije zaslonov in vse, kar sprejema odločitve, ostane na strežniku. Zasloni za telefone iz paketa se odprejo samo znotraj telefonskih aplikacij Nexus, in le ko ima organizacija tako paket kot dodatek Mobilne aplikacije.

Mobilna prekrivna plast
Mobilna prekrivna plast
Mobilna prekrivna plast izbere, katere kartice paketa in koraki zajema se prikažejo na telefonih in za katere vloge. Zajemi čakajo brez povezave tako dolgo, kot dovoljuje organizacija, odobritve pa potrebujejo potrdilo o identiteti (passkey). Predogled prikazuje natančno tisto, kar vidi ena vloga.

Upravičenost: kdo ima paket in kje se izvaja

Paket je licenciran, nikoli vklopljen s konfiguracijo. Tri plasti odločajo, kdo ga vidi.

Licenca. Podpisani licenčni dokument poleg skupin funkcij grants in add_ons vsebuje seznam domain_packs matričnih ID-jev (največ 100, lahko tudi prazen). Konzola Adverant ne bo izdala paketa brez dodatkov, ki jih ta potrebuje: paketa, ki zahteva Odločevalnice in zapečatene zapise, ni mogoče izdati za licenco brez tega. Skupine funkcij v licenci se dodelijo bodisi celotni namestitvi bodisi imenovanim organizacijam, preverjanje upravičenosti pa odgovarja za posamezno organizacijo. Če odstranite dodelitev, vsaka leča in zaslon za telefon v paketu postaneta dražilnik, zapisi pa se ohranijo.

Preverjanje upravičenosti. Za vsako organizacijo in naročniški paket, vsako vlogo in vsako osebo preverjanje upravičenosti odloči, ali je kontrolnik, ki ga doda paket, upravičen, prikazan kot dražilnik, skrit ali zavrnjen s kodo. Usmerja vrstice menija in zavihke podoken ter preverjanja poti in odpreme. Zaprti modul ostaja avtoriteta za lastno dodelitev.

Enote in leče. Znotraj organizacije, ki ima paket, skrbnik odloči, kje bo deloval. Paket se za enoto vklopi postopoma, nikoli za celotno enoto naenkrat: preverjanje licence, pilotna skupina, prednastavitev nastavitev, nato pa razširitev na vse v enoti na datum, ki ga izbere skrbnik. Preden se kar koli spremeni, stran po vlogah prikaže, kdo kaj pridobi. Leče se nato dodelijo po vlogah in po enotah v eni matriki. Če paket za enoto pozneje izklopite, se ohranijo vsi zapisi, ki so jih ljudje ustvarili; leče in predloge izginejo, nič drugega pa se ne spremeni.

Vklop domene za enoto
Vklop domene za enoto
Vklop domene za enoto poteka postopoma, od preverjanja licence prek pilotne skupine do celotne enote. Skrbnik vidi, kdo kaj pridobi, preden se kar koli spremeni, nastavitve pilotne skupine pa se prenesejo nespremenjene.

Deset paketov

Adverant dobavlja deset domenskih paketov. Vsak potrebuje osnovno licenco Enterprise, nekateri pa potrebujejo dodatke. Zasloni za telefone vsakega paketa potrebujejo tudi dodatek Mobilne aplikacije.

Paket Matrični ID Kaj prinaša Potrebuje tudi
Zavarovalništvo insurance Zavarovalniške leče za ocenjevanje tveganj, zahtevke, pozavarovanje, Lloyd's in prenesena pooblastila, med drugim; tok za goljufije in preiskave; uporabniške poti in nastavitve zavarovalniške izložbe; prevedene možgane za zavarovalništvo Odločevalnice in zapečateni zapisi
Bančništvo in plačilni promet financial-services Register zunanjega izvajanja tehnologije; ure in poročila o tehnoloških incidentih; izstopni načrti za kritične ponudnike; odločitve o posojilih; spori glede kartic Nič poleg osnove
Kapitalski trgi in upravljanje premoženja capital-markets Leče za raziskovalnega analitika, upravljavca portfelja, nadzor in skladnost ter poročanje strankam; snemanje klicev na trgovalnih mizah; raziskave, zadržane za zidom do objave; predloge za dnevnik prečkanja zidu, pregled klicev in objavo raziskav. Telefoni prejmejo jutranje poročilo in odobritve objav ter opozorila nadzora, nikoli pa naročil Odločevalnice in zapečateni zapisi
Državna uprava in javni sektor government Zahtevki za nadomestila in upravičenosti; vloge za prostorsko načrtovanje; zahteve za informacije Nič poleg osnove
Zdravstvo healthcare-providers Dostop do kartotek pacientov in njihova souporaba ter zahteve za informacije. Brez podpore za klinično odločanje Nič poleg osnove
Vede o življenju life-sciences Odstopanja in korektivni ukrepi; pregled zapisov o serijah; validiran nadzor sprememb Nič poleg osnove
Kritična infrastruktura in energetika energy-and-utilities Ure in poročila o incidentih; inšpekcijski pregledi in napake; delovni nalogi Nič poleg osnove
Obramba in varnost defence-and-mission Terenska poročila, združena z opozorili platforme; oznake za souporabo; poročanja po akciji. Njegova različica za telefon se namesti samo prek upravljanja naprav Nexus Edge, za opozorila platforme
Pravne in strokovne storitve legal Leče za pravnega strokovnjaka, ki ustvarja prihodke, pravnika za upravljanje znanja, navzkrižje interesov in tveganja ter obračunavanje; preverjanje navzkrižja interesov ob vsaki novi zadevi; etični zidovi, ki jih lahko umakneta le dva partnerja; predloge za preverjanje nove zadeve, gradnik zidov in opomnike za zidove. Telefoni prejmejo zajem časa in posodobitve zadev z odobritvami, nikoli pa zaupnih datotek Odločitvene sobe in zapečatene evidence ter Pošto (Mail)
Logistika in pomorstvo logistics-and-maritime Leče za kontrolorja operacij, carinika, upravljavca prevoznikov in pristaniškega inšpektorja; carinske deklaracije in zadržanja; preverjanja sankcij pred prvo rezervacijo, pri čemer vsako zadržanje sprosti oseba; model znanja za pristanišča in plovila, prevoznike in zadržanja. Telefoni prejmejo inšpekcijske preglede skladiščnih prostorov in privezov ter carinska zadržanja skupaj z ugotovitvami dronov Zemljevid in GeoUI

Harrow Port Authority uporablja paket Logistika in pomorstvo, in ta je tisti, ki bi ga na vašem mestu prebral najprej, če gradite svojega: njegov model znanja je osnova, na kateri gradi zgornji primer hladne verige.

Izdelava lastnega paketa

V izdaji Enterprise razvijalec začne paket po zlati poti v razdelku Začni nekaj novega, v treh korakih. »O paketu« poimenuje paket, njegove enote, paket, na katerem gradi, in pravila, za katera mora izkazovati dokazila. »Model znanja« doda nove vrste entitet nad osnovni model. »Preglej in ustvari« prikaže načrt in mu nato sledi. Iz predloge paketa ustvari skladišče z manifestom, ki deklarira, kaj paket sme doseči, in njegove teste; nato razvojni prostor s sintetičnimi podatkovnimi vejami; nato pa osnutek kataloškega vnosa, ki ga lahko vidite samo vi. Nič se ne ustvari, dokler na zadnjem koraku ne pritisnete Ustvari. Poglavje 2.24, Gradnja prilagojene vertikale od začetka do konca, vas popelje skozi celotno pot.

Koliko vas stane paket

Paket je najdražja razširitev za lastništvo. Njegov model znanja ima različice, od katerih so ljudje odvisni, zato lastnost, ki jo obžalujete, ostane v različici, s katero je bila izdana. Njegove leče lahko samo odvzemajo, zato vloga, ki potrebuje več, pomeni pogovor o osnovni leči. Njegova preslikava dokazil imenuje pravila, ki jih mora potrditi vaš lastni pravni svetovalec, preden se kdor koli zanese nanjo. In stranka ga dobi samo prek svoje licence: zgradite lahko najboljši paket v panogi, pa ga še vedno ne morete vklopiti za niti eno enoto, dokler ga ne vsebuje licenca organizacije. V zameno pa vas trideseta enota, ki ga želi, stane le en preklop in pilotno skupino.