Verzia 1.0.0-alpha.1najnovšia
Kapitola 2.23
Doménové balíky
Z čoho sa skladá doménový balík a čo uvádza jeho súbor pack.json; optiky (lenses) a register optík; znalostné modely, konektory a mobilné prekrytia; ako sa balík licencuje a zapína pre organizačnú jednotku; a desať balíkov, ktoré dodáva spoločnosť Adverant.
Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

Balík, ktorý som vytvoril v spoločnosti Corrán Orbital, začal ako dva pluginy a tucet zručností Skills Engine, ktoré používal iba náš tím pozemnej stanice. Keď o to isté požiadalo oddelenie riadenia misií, mal som na výber: všetko skopírovať a udržiavať všetko dvakrát, alebo z toho urobiť doménový balík s jedným znalostným modelom a dvoma pohľadmi, zapínanými pre každú jednotku zvlášť. Premena na balík mi trvala týždeň. Zajtra by som sa rozhodol rovnako a nabudúce by som začal rovno balíkom.
Doménový balík prináša do Nexus spôsob práce jedného odvetvia. Obsahuje druhy vecí daného odvetvia, ich vzájomné prepojenia a to, čo vidí každá rola. Nesie šablóny a pracovné postupy, ktoré ľudia používajú každý deň, dôkazy, ktoré vyžadujú pravidlá odvetvia, a obrazovky, ktoré fungujú na telefóne bez signálu. Nikdy nemení shell ani jeho komponenty a nikdy nemení pravidlá písania. Nové odvetvie je balík, nie aplikácia.
Z čoho sa balík skladá
V podstate je balík tvorený štyrmi vecami a žiadna z nich nie je kód špecifický pre balík v platforme:
- Zväzok skupín funkcií v kontrole oprávnení. Ovládacie prvky balíka patria do množiny skupín funkcií. O každom riadku ponuky a karte panelu, ktoré balík pridá, potom rozhoduje rovnaký mechanizmus ako vo zvyšku Nexus: oprávnené, zobrazené ako ukážka alebo skryté.
- Manifest balíka,
pack.json, ktorý deklaruje zoskupenia obrazoviek balíka a jeho pojmy, jeho pohľady a jeho obrazovky pre telefón. - Uzavreté moduly, ktoré si samy overujú svoje oprávnenie. Serverový kód, ktorý rozhoduje, napríklad skompilované mozgy balíka, má overovač licencie v sebe a podpísanú licenciu kontroluje sám. Nič mimo modulu ho nemôže zapnúť.
- Záznam v katalógu, aby sa balík zobrazil na stránke Doménové balíky spolu s tým, čo prináša a čo potrebuje.
Nad nimi sú časti, ktoré ľudia vidia: znalostný model a pohľady; šablóny, pracovné postupy a zručnosti Skills Engine; konektory iba na čítanie do systémov, ktoré už záznamy uchovávajú, mapa dôkazov od každého pravidla k záznamom, ktoré naň odpovedajú, a mobilná nadstavba.
Súbor pack.json
Tu je manifest balíka Bankovníctvo a platby, skrátený na jeden pohľad s jedným miestom a dva pojmy. Jeho ID súboru je fintech a name obsahuje pracovný názov balíka; konzola a katalóg ho zobrazujú ako Bankovníctvo a platby.
{
"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"
}
]
}
}Polia zhora nadol:
| Pole | Čo uvádza |
|---|---|
id |
ID balíka, malými písmenami |
name |
Jeho pracovný názov |
version |
Vlastná verzia balíka |
inherits |
Balík, na ktorom tento stavia. Bankovníctvo a platby dedí z balíka Poisťovníctvo, ktorý obsahuje spoločné zoskupenia, ktoré používa každý balík, napríklad konverzáciu a nastavenia. Nový balík pridáva svoje pohľady a spoločné zoskupenia ponecháva na balík, z ktorého dedí |
screenCount |
Koľko obrazoviek balík definuje |
clusters[] |
Skupiny obrazoviek balíka. Každá má id, kind, name, seats, pre ktorú je určená, svoje purpose, množiny lexicon, z ktorých pochádzajú jej pojmy, svoje menu a svoje screens, každé s id, title, who a tým, na čo doing |
clusters[].kind |
shared pre zoskupenie, ku ktorému má prístup každý pohľad (napríklad konverzácia); lens pre vlastné obrazovky jednej roly. scope zoskupenia určuje, či patrí do jadra (core) alebo do odvetvia (domain) |
lexicon |
Pojmy balíka v pomenovaných množinách. Každý pojem má jednoduché vysvetlenie, ktoré si prečíta aj nováčik, a tretia pozícia je exact pre pojem, ktorý sa musí použiť doslovne, napríklad regulačný ukazovateľ |
world |
Vzorový svet fiktívnych tenantov a miest, ktorý používajú obrazovky a testy balíka, a jeho dátové vetvy |
world.tenants[].plan |
areas plánu: zoskupenia a pohľady, ktoré plán tohto tenanta otvára, z of |
world.tenants[].ai |
Politika AI (umelej inteligencie) organizácie pre balík: či sú povolené modely v zariadení (onDevice), kam môžu osobné údaje smerovať do cloudového modelu (personalDataToCloudModels, napríklad uk-only alebo eu-only) a či zapečatenie záznamu vyžaduje odoslanie UNO (sealRequiresUno) |
world.seats[] |
Miesto jednej osoby: jej title, lens, ktorú zastáva, spoločné clusters, ku ktorým má tiež prístup, jej home obrazovka, jej posture (desk, field alebo consumer) a v úplnom súbore jej authority, teda limity, v rámci ktorých koná |
Čo môže pack.json obsahovať, upravujú dve pravidlá. Predpis sa uvádza jednoduchými slovami s vysvetlením, nikdy ako holá skratka. A nič v súbore nie je kód: je to čitateľná definícia, ktorú interpretujú server a aplikácie, takže nikdy neobsahuje pravidlo ani prompt a nikdy skompilovaný mozog.
Zdieľané optiky (lenses)
Niektoré režimy patria do viacerých odvetví. Register outsourcovaných technológií slúži balíkom Poisťovníctvo aj Bankovníctvo a platby; lehoty incidentov (odpočty do hlásení, ktoré regulátor po incidente očakáva) slúžia balíkom Kritická infraštruktúra a energetika aj Verejná správa a verejný sektor. Režim, ktorý používa viacero balíkov, sa napíše raz ako spoločný pohľad. Každý balík, ktorý ho potrebuje, ho zahrnie. Keď sa pravidlo zmení, zmení sa na jednom mieste.
Optika rozsah iba zužuje
Pohľad je to, čo jedna rola vidí v rámci balíka alebo platformy: ktoré karty a polia a ktoré akcie. Vždy je definovaný ako zúženie základného pohľadu. Pohľad so základom nezobrazuje žiadny druh, ktorý jeho základ nezobrazuje, neotvára žiadnu oblasť, ktorú jeho základ neotvára, a nemôže ten istý druh zároveň zobrazovať aj skrývať. Oprávnenia stále pochádzajú z rolí; pohľad mení zobrazenie, nikdy to, čo osoba smie robiť.
Ak sa ho pokúsite rozšíriť, odpoveďou je LENS_CANNOT_WIDEN (422) a nič sa neuloží. V nástroji na tvorbu pohľadov to pre pohľad technika chladiarenských jednotiek postavený na základe operačného dispečera, ktorý nezobrazuje sumy poistných nárokov, znie: „Sumu poistného nároku nemožno pridať do tohto pohľadu“. Riešením je iný základný pohľad, čo je iná požiadavka na toho, kto vlastní základ.
Pravidlo je uložené v databáze, nielen v ceste. Pohľady každej organizácie sú v štyroch tabuľkách schémy registra pluginov:
| Tabuľka | Čo obsahuje |
|---|---|
plugins.lenses |
Jeden pohľad jedného vlastníka, balíka (owner_kind pack) alebo platformy (platform): jeho slug a name, jeho base_lens_id, druhy, ktoré shows a hides, oblasti, ktoré opens, jeho status (active alebo withdrawn) a jeho version |
plugins.lens_grants |
Pohľad pridelený jednej role (owner, admin, member, viewer, developer alebo billing_admin) v jednej obchodnej jednotke |
plugins.lens_changes |
Každá zmena pohľadu alebo jeho pridelení, uchovaná ako stav pred a po, s tým, kto ju urobil a prečo. Iba na pridávanie |
plugins.lens_holder_months |
Koľko ľudí malo pohľad v jednotke každý mesiac. Počet, nikdy kto |
Spúšťač odmietne každý pohľad, ktorý zobrazuje viac ako jeho základ, a odmietne zmenu základu, po ktorej by pohľad na ňom postavený zobrazoval viac ako základ. Nič sa nemaže. Pohľady a pridelenia sa odvolávajú a opätovné pridelenie pohľadu je nový riadok; zmena sa nikdy neprepisuje a počet za minulý mesiac sa nikdy nemení. Každý riadok odkazuje na pohľad vlastnej organizácie prostredníctvom zloženého kľúča, takže pridelenie nemôže smerovať do inej organizácie.
Konzola a vaše vlastné nástroje pristupujú k registru cez /api/v1/lenses s vlastným bearer tokenom osoby. Organizácia, osoba a miesto v jednotke pochádzajú z overeného tokenu a z ničoho iného.
| Metóda a cesta | Čo robí |
|---|---|
GET / |
Pohľady filtrované podľa owner_kind, owner_id a status s ich prideleniami vo vašom mieste |
POST / |
Pridanie pohľadu: owner_kind, owner_id, slug, name, shows a voliteľne description, base_lens_id, hides, opens a reason |
GET /owners/:kind/:id |
Pohľady balíka alebo platformy a ktorý z nich zobrazuje jednotlivé druhy |
GET /owners/:kind/:id/grants |
Pohľad podľa jednotky: roly, ktorým bol pridelený každý pohľad, a ľudia, ku ktorým sa dostane |
GET /owners/:kind/:id/holders |
Ľudia s pohľadom za každý mesiac (months, predvolene šesť) |
POST /owners/:kind/:id/holders/count |
Zaznamenanie počtov za tento mesiac |
GET /owners/:kind/:id/changes |
História zmien pohľadov vlastníka (limit, predvolene 50) |
GET /:lensId |
Jeden pohľad s jeho základom a pohľadmi, ktoré ho zužujú, a s jeho prideleniami a zmenami |
PATCH /:lensId |
Zmena pohľadu: name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Odvolanie pohľadu a spolu s ním aj jeho pridelení. Pohľad, ktorý zužuje iný aktívny pohľad, nemožno odvolať, kým nie je odvolaný ten druhý |
POST /:lensId/grants |
Pridelenie pohľadu: business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Odvolanie jedného pridelenia |
:kind je pack alebo platform. Každé odmietnutie nesie kód s vetou a ďalším krokom a na neočakávané zlyhanie sa odpovedá UNHANDLED_ERROR, pričom jeho príčina je v protokole služby, nikdy v odpovedi.
Znalostný model, konektory a kompilované mozgy
Znalostný model sú druhy vecí, ktoré balík pozná, a ich vzájomné prepojenia. Je verzovaný a balík zvyčajne stavia na základnom modeli z balíka, z ktorého dedí: balík chladiaceho reťazca na základnom modeli logistiky pridáva päť druhov (medzi nimi chladiarenskú jednotku a zastávku plavidla) a dva z nich prepája so základom bez toho, aby základ menil. Každá vlastnosť sa klasifikuje pri vytvorení, takže osobné a obchodné polia sú známe skôr, ako ich použije akýkoľvek pohľad alebo dátová vetva. Pohľad pre technikov potom nemôže zobraziť sumu poistného nároku klasifikovanú ako obchodnú. Odvolaná vlastnosť zostáva vo verzii, ktorá ju mala, a odchádza až v neskoršej verzii. Pri príprave novej verzie sa najprv skopírujú znalosti a cesta späť zostáva otvorená počas stanoveného obdobia.
Konektory prinášajú záznamy zo systémov, ktoré ich už uchovávajú: správy poistných zmlúv, systému poistných udalostí, poštového priečinka so súbormi, ktoré posielajú partneri. Každý je iba na čítanie, beží podľa vlastného plánu a má tlačidlo na test. Záznamy sa pri načítaní mapujú na pojmy balíka a ukladajú sa do znalostného modelu, z ktorého čítajú pohľady; odpovede asistenta naň odkazujú. Z Nexus sa nič nezapisuje späť do zdrojového systému.
Skompilované mozgy sú časti balíka, ktoré rozhodujú, napríklad upisovací mozog a mozog poistných udalostí balíka Poisťovníctvo. Bežia na serveri ako skompilované licencované moduly, z ktorých každý si licenciu overuje sám, a nikdy sa nedodávajú do telefónu ani prehliadača.
Mobilné prekrytie a polia pre režim offline
Balík deklaruje svoje obrazovky pre telefón v tom istom manifeste ako mobilnú nadstavbu: ktoré karty a kroky zachytávania sa zobrazujú na telefónoch a pre ktoré roly. Správca potom pre každú organizáciu nastaví pravidlá na telefónoch, napríklad ako dlho môžu záznamy čakať offline, či každá fotografia nesie miesto, kde bola nasnímaná, a či schválenia vyžadujú prístupový kľúč (passkey). Nastavenie zostáva na počítači; správca vidí, čo telefóny posielajú, ako názvy a počty, nikdy samotné fotografie ani poznámky.
Každé pole, ktoré obrazovka telefónu ponúka bez signálu, deklaruje jednu z troch tried a obrazovka ukazuje ktorú:
| Trieda | Čo sa s ním stane | Príklady |
|---|---|---|
| Vytvorené offline | Uloží sa v telefóne a zlúči sa, keď sa telefón znova pripojí | Poznámky, fotografie, odčítané hodnoty |
| Navrhnuté offline | Odošle sa ako návrh, o ktorom rozhodne kancelária. Server ho nikdy nezlúči; prehrá ho cez vlastné kontroly oprávnení | Suma, zistenie, zmena rezervy, rozhodnutie |
| Nikdy offline | V teréne nemožné. Zobrazí sa ako riadok s dôvodom, nikdy ako tlačidlo | Podpis, pečať, kontrola oprávnení, kontrola voči sankčnému zoznamu |
Nadstavby neobsahujú žiadne pravidlá ani prompty, a ani mozgy. Sú to čitateľné definície obrazoviek a všetko, čo rozhoduje, zostáva na serveri. Obrazovky balíka pre telefón sa otvárajú iba v telefónnych aplikáciách Nexus a iba vtedy, keď organizácia má balík aj doplnok Mobilné aplikácie.
Oprávnenie: kto má balík a kde beží
Balík je licencovaný, nikdy sa nezapína konfiguráciou. O tom, kto ho vidí, rozhodujú tri vrstvy.
Licencia. Podpísaný licenčný dokument nesie zoznam domain_packs s ID matice (najviac 100, prípadne prázdny) vedľa svojich skupín funkcií grants a add_ons. Konzola Adverant nevydá balík bez doplnkov, ktoré potrebuje: balík, ktorý vyžaduje Rozhodovacie miestnosti a zapečatené záznamy, nemožno vydať k licencii bez nich. Skupiny funkcií v licencii sa udeľujú buď celej inštalácii, alebo menovite uvedeným organizáciám a kontrola oprávnení odpovedá pre každú organizáciu zvlášť. Ak oprávnenie odstránite, každý pohľad a každá obrazovka balíka pre telefón sa zmení na ukážku, pričom jeho záznamy sa zachovajú.
Kontrola oprávnení. Pre každú organizáciu a plán, každú rolu a každú osobu kontrola oprávnení rozhoduje, či je ovládací prvok, ktorý balík pridáva, oprávnený, zobrazený ako ukážka, skrytý alebo odmietnutý s kódom. Riadi riadky ponuky a karty panelov, ako aj kontroly smerovania a odosielania. Uzavretý modul zostáva autoritou pre svoje vlastné udelenie.
Jednotky a pohľady. V rámci organizácie, ktorá má balík, administrátor rozhoduje, kde sa spustí. Balík sa pre jednotku zapína postupne, nikdy nie pre celú jednotku naraz: kontrola licencie, pilotná skupina, predvoľba nastavení a potom rozšírenie na všetkých v jednotke k dátumu, ktorý si administrátor zvolí. Skôr než sa čokoľvek zmení, stránka zobrazí, kto čo získa, podľa rolí. Pohľady sa potom prideľujú podľa roly a podľa jednotky v jednej matici. Ak balík pre jednotku neskôr vypnete, všetky záznamy, ktoré ľudia vytvorili, zostanú zachované; pohľady a šablóny zmiznú a nič iné sa nezmení.
Desať balíkov
Adverant dodáva desať doménových balíkov. Každý z nich vyžaduje základnú licenciu Enterprise a niektoré vyžadujú doplnky. Obrazovky každého balíka pre telefóny navyše vyžadujú doplnok Mobilné aplikácie.
| Balík | ID v matici | Čo prináša | Vyžaduje aj |
|---|---|---|---|
| Poisťovníctvo | insurance |
Poisťovacie pohľady okrem iného pre upisovanie, poistné udalosti, zaistenie, Lloyd's a delegované oprávnenia; postup pre podvody a vyšetrovanie; cesty a nastavenia poisťovacej predajne; skompilované mozgy pre poisťovníctvo | Rozhodovacie miestnosti a zapečatené záznamy |
| Bankovníctvo a platby | financial-services |
Register outsourcovaných technológií; lehoty a hlásenia technologických incidentov; plány ukončenia pre kritických poskytovateľov; rozhodnutia o úveroch; spory týkajúce sa kariet | Nič nad rámec základu |
| Kapitálové trhy a správa aktív | capital-markets |
Pohľady pre výskumného analytika, portfóliového manažéra, dohľad a compliance a reporting pre klientov; nahrávanie hovorov na obchodných deskoch; výskum držaný za informačnou bariérou až do zverejnenia; šablóny pre denník prekročení bariéry, kontrolu hovorov a zverejnenie výskumu. Telefóny dostávajú rannú informačnú správu a schvaľovanie zverejnení, ako aj upozornenia dohľadu, nikdy nie pokyny | Rozhodovacie miestnosti a zapečatené záznamy |
| Štátna správa a verejný sektor | government |
Žiadosti o dávky a nároky; žiadosti o povolenie stavby; žiadosti o informácie | Nič nad rámec základu |
| Zdravotníctvo | healthcare-providers |
Prístup k záznamom pacientov a ich zdieľanie a žiadosti o informácie. Bez podpory klinického rozhodovania | Nič nad rámec základu |
| Vedy o živej prírode (Life sciences) | life-sciences |
Odchýlky a nápravné opatrenia; kontrola záznamov o šaržiach; validované riadenie zmien | Nič nad rámec základu |
| Kritická infraštruktúra a energetika | energy-and-utilities |
Lehoty a hlásenia incidentov; inšpekcie a chyby; pracovné príkazy | Nič nad rámec základu |
| Obrana a bezpečnosť | defence-and-mission |
Terénne hlásenia spojené s upozorneniami platformy; označenia zdieľania; vyhodnotenia. Jeho verzia pre telefóny sa inštaluje iba prostredníctvom správy zariadení | Nexus Edge pre upozornenia platformy |
| Právne a profesionálne služby | legal |
Pohľady pre fakturujúceho právnika, znalostného právnika, konflikty a riziká a fakturáciu; kontrola konfliktov pri každej novej veci; etické bariéry, ktoré môžu zrušiť iba dvaja partneri; šablóny pre kontrolu novej veci, tvorbu bariér a pripomienky bariér. Telefóny dostávajú zaznamenávanie času a aktualizácie vecí so schvaľovaním, nikdy nie privilegované súbory | Rozhodovacie miestnosti a zapečatené záznamy a Pošta |
| Logistika a námorná doprava | logistics-and-maritime |
Pohľady pre prevádzkového kontrolóra, colníka, manažéra dopravcov a prístavného inšpektora; colné vyhlásenia a zadržania; kontroly sankcií pred prvou rezerváciou, pričom každé zadržanie uvoľňuje človek; znalostný model prístavov a plavidiel, dopravcov a zadržaní. Telefóny dostávajú inšpekcie areálu a kotvísk a colné zadržania spolu so zisteniami z dronov | Mapa a GeoAI |
Harrow Port Authority používa balík Logistika a námorná doprava a ak vytvárate vlastný, odporúčam prečítať si ho ako prvý: jeho znalostný model je základom, na ktorom stavia vyššie uvedený príklad chladiaceho reťazca.
Zostavenie vlastného balíka
V edícii Enterprise vývojár začína balík zo zlatej cesty v časti Začať niečo nové v troch krokoch. „O balíku“ pomenúva balík, jeho jednotky, balík, na ktorom stavia, a pravidlá, pre ktoré musí preukázať dôkazy. „Znalostný model“ pridáva nové druhy vecí nad základný model. „Kontrola a vytvorenie“ zobrazí plán a potom ho vykoná. Z šablóny balíka vytvorí repozitár s manifestom, ktorý deklaruje, k čomu má balík prístup, a s jeho testami; potom vývojový priestor s vetvami syntetických údajov; potom koncept položky katalógu, ktorý vidíte iba vy. Nič sa nevytvorí, kým v poslednom kroku nestlačíte Vytvoriť. Kapitola 2.24, Vytvorenie vlastného vertikálneho riešenia od začiatku do konca, prechádza celou cestou.
Čo vás balík stojí
Balík je rozšírenie s najvyššími nákladmi na vlastníctvo. Jeho znalostný model má verzie, na ktorých ľudia závisia, takže vlastnosť, ktorú ľutujete, zostáva vo verzii, ktorá ju priniesla. Jeho pohľady môžu iba uberať, takže rola, ktorá potrebuje viac, znamená diskusiu o základnom pohľade. Jeho mapa dôkazov uvádza pravidlá, ktoré musí potvrdiť váš vlastný právny poradca, skôr než sa na ňu ktokoľvek spoľahne. A zákazník ho získa iba prostredníctvom svojej licencie: môžete vytvoriť najlepší balík v odvetví a napriek tomu ho nezapnúť ani pre jednu jednotku, kým ho licencia organizácie nezahŕňa. Na oplátku vás tridsiata jednotka, ktorá ho chce, stojí jedno prepnutie a pilot.




