Različica 1.0.0-alpha.1najnovejša
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

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:
- 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.
- Manifest paketa,
pack.json, ki deklarira gruče zaslonov paketa in njegovo besedišče, njegove leče in njegove zaslone za telefone. - 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.
- 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.
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.
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.
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.
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.
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.




