Přihlásit seDomluvit prezentaci

Kapitola 2.23

Oborové balíčky

Z čeho se skládá oborový balíček a co říká jeho soubor pack.json; optiky a registr optik; znalostní modely, konektory a mobilní překryvné vrstvy; jak je balíček licencován a zapnut pro jednotku; a deset balíčků, které dodává Adverant.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

19 min čtení

Balíček, který jsem vytvořil ve společnosti Corrán Orbital, začal jako dva pluginy a tucet dovedností Skills Engine, které používal pouze náš tým pozemní stanice. Když o totéž požádala jednotka řízení misí, měl jsem na výběr: zkopírovat vše a udržovat všechno dvakrát, nebo z toho udělat oborový balíček s jedním znalostním modelem a dvěma pohledy, zapínanými pro jednotlivé jednotky. Převést to na balíček mi trvalo týden. Zítra bych se rozhodl stejně a příště bych začal rovnou balíčkem.

Oborový balíček přináší do Nexus způsob práce jednoho odvětví. Obsahuje druhy věcí daného odvětví a jejich vzájemné vazby a také to, co vidí jednotlivé role. Nese šablony a pracovní postupy, které lidé používají každý den, doklady, které vyžadují pravidla odvětví, a obrazovky, které fungují na telefonu bez signálu. Nikdy nemění prostředí ani jeho komponenty a nikdy ani pravidla psaní. Nové odvětví je balíček, nikoli aplikace.

Z čeho se balíček skládá

V základu tvoří balíček čtyři věci a žádná z nich není kódem platformy specifickým pro daný balíček:

  1. Sada skupin funkcí v kontrole oprávnění. Ovládací prvky balíčku patří do sady skupin funkcí. O každém řádku nabídky a každé kartě panelu, které balíček přidá, pak rozhoduje stejný mechanismus jako ve zbytku Nexus: oprávněno, zobrazeno jako ukázka, nebo skryto.
  2. Manifest balíčku, pack.json, který deklaruje shluky obrazovek balíčku a jeho slova, jeho pohledy a jeho obrazovky pro telefon.
  3. Uzavřené moduly, které samy ověřují své oprávnění. Serverový kód, který rozhoduje, například kompilované mozky balíčku, nese ověřovač licence v sobě a podepsanou licenci kontroluje sám. Nic mimo modul jej nemůže zapnout.
  4. Položka katalogu, aby se balíček zobrazil na stránce Oborové balíčky spolu s tím, co přináší a co potřebuje.

Nad tím vším stojí části, které lidé vidí: znalostní model a pohledy; šablony, pracovní postupy a dovednosti Skills Engine; konektory jen pro čtení do systémů, které již záznamy uchovávají, mapa dokladů od každého pravidla k záznamům, které na něj odpovídají, a mobilní překryv.

Oborové balíčky
Oborové balíčky
Stránka Oborové balíčky uvádí všech deset balíčků spolu s tím, co každý potřebuje a kde běží. Balíček uděluje pouze Adverant; vy rozhodujete, ve kterých jednotkách poběží.

Soubor pack.json

Zde je manifest balíčku Bankovnictví a platby, zkrácený na jeden pohled s jedním místem a dva termíny. Jeho id souboru je fintech a name obsahuje pracovní název balíčku; konzole a katalog jej zobrazují jako Bankovnictví 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"
      }
    ]
  }
}

Pole, shora dolů:

Pole Co uvádí
id Id balíčku, malými písmeny
name Jeho pracovní název
version Vlastní verze balíčku
inherits Balíček, na kterém tento staví. Bankovnictví a platby dědí z balíčku Pojišťovnictví, který obsahuje sdílené shluky používané všemi balíčky, například konverzaci a nastavení. Nový balíček přidává své pohledy a sdílené shluky ponechává balíčku, ze kterého dědí
screenCount Kolik obrazovek balíček definuje
clusters[] Skupiny obrazovek balíčku. Každá má id, kind, name, seats, pro který je určena, své purpose, sady lexicon, ze kterých pocházejí její slova, své menu a své screens, každé s id, title, who a tím, k čemu doing
clusters[].kind shared pro shluk, ke kterému má přístup každý pohled (například konverzace); lens pro vlastní obrazovky jedné role. scope shluku udává, zda patří k jádru (core), nebo k odvětví (domain)
lexicon Slova balíčku v pojmenovaných sadách. Každý termín má srozumitelné vysvětlení, které přečte i nováček, a třetí pozice je exact pro termín, který se musí použít doslovně, například regulatorní údaj
world Ukázkový svět fiktivních tenantů a míst, který používají obrazovky a testy balíčku, a jeho datové větve
world.tenants[].plan areas plánu: shluky a pohledy, které plán tohoto tenanta otevírá, z celkového počtu of
world.tenants[].ai Zásady organizace pro AI (umělou inteligenci) v balíčku: zda jsou povoleny modely v zařízení (onDevice), kam smějí osobní údaje putovat do cloudového modelu (personalDataToCloudModels, například uk-only nebo eu-only) a zda zapečetění záznamu vyžaduje odeslání UNO (sealRequiresUno)
world.seats[] Místo jedné osoby: její title, lens, které zastává, sdílené clusters, ke kterým má rovněž přístup, její obrazovka home, její posture (desk, field nebo consumer) a v úplném souboru její authority, tedy limity, v jejichž rámci jedná

Co smí pack.json obsahovat, určují dvě pravidla. Předpis se uvádí srozumitelnými slovy s vysvětlením, nikdy jako holá zkratka. A nic v souboru není kód: je to čitelná definice, kterou interpretuje server a aplikace, takže nikdy neobsahuje pravidlo ani prompt a nikdy kompilovaný mozek.

Sdílené optiky

Některé režimy patří do více odvětví. Registr outsourcovaných technologií slouží balíčkům Pojišťovnictví i Bankovnictví a platby; lhůty incidentů (odpočty do hlášení, která regulátor po incidentu očekává) slouží balíčkům Kritická infrastruktura a energetika i Státní správa a veřejný sektor. Režim, který používá více balíčků, se zapisuje jednou jako sdílený pohled. Každý balíček, který jej potřebuje, jej zahrnuje. Když se pravidlo změní, změní se na jednom místě.

Optika pouze zužuje

Pohled je to, co jedna role vidí v rámci balíčku nebo platformy: které karty a pole a které akce. Vždy je definován jako zúžení základního pohledu. Pohled se základem nezobrazuje žádný druh věci, který jeho základ nezobrazuje, neotevírá žádnou oblast, kterou jeho základ neotevírá, a nemůže tentýž druh současně zobrazovat i skrývat. Oprávnění stále vycházejí z rolí; pohled mění zobrazení, nikdy to, co smí osoba dělat.

Pokusíte-li se pohled rozšířit, odpovědí je LENS_CANNOT_WIDEN (422) a nic se neuloží. V nástroji pro tvorbu pohledů to u pohledu technika chladírenských kontejnerů postaveného na základu operačního dispečera, který nezobrazuje částky pojistných událostí, zní: „Částku pojistné události nelze do tohoto pohledu přidat“. Řešením je jiný základní pohled, což je jiná žádost tomu, kdo základ vlastní.

Nástroj pro tvorbu pohledů
Nástroj pro tvorbu pohledů
Nástroj pro tvorbu pohledů uvádí, co role vidí, kartu po kartě a pole po poli, zaškrtnuté vůči základnímu pohledu, který zužuje. Pokus zobrazit pole, které základ skrývá, je odmítnut s uvedením důvodu a jména toho, kdo může základ změnit.

Pravidlo je uloženo v databázi, nejen v cestě. Pohledy každé organizace jsou uloženy ve čtyřech tabulkách schématu registru pluginů:

Tabulka Co obsahuje
plugins.lenses Jeden pohled jednoho vlastníka, balíčku (owner_kind pack) nebo platformy (platform): jeho slug a name, jeho base_lens_id, druhy, které shows a hides, oblasti, které opens, jeho status (active nebo withdrawn) a jeho version
plugins.lens_grants Pohled přidělený jedné roli (owner, admin, member, viewer, developer nebo billing_admin) v jedné obchodní jednotce
plugins.lens_changes Každá změna pohledu nebo jeho přidělení, uchovaná jako stav před a po spolu s tím, kdo ji provedl a proč. Pouze přidávání
plugins.lens_holder_months Kolik lidí mělo pohled v jednotce v každém měsíci. Počet, nikdy kdo

Spouštěč odmítne každý pohled, který zobrazuje více než jeho základ, a odmítne změnu základu, po které by pohled na něm postavený zobrazoval více než základ. Nic se nemaže. Pohledy a přidělení se odvolávají a opětovné přidělení pohledu je nový řádek; změna se nikdy nepřepisuje a počet za minulý měsíc se nikdy nemění. Každý řádek odkazuje na pohled vlastní organizace prostřednictvím složeného klíče, takže přidělení nemůže ukazovat napříč organizacemi.

Konzole i vaše vlastní nástroje přistupují k registru přes /api/v1/lenses s vlastním nosným tokenem dané osoby. Organizace a osoba i místo v jednotce pocházejí z ověřeného tokenu a z ničeho jiného.

Metoda a cesta Co dělá
GET / Pohledy filtrované podle owner_kind, owner_id a status s jejich přiděleními ve vašem místě
POST / Přidání pohledu: owner_kind, owner_id, slug, name, shows a volitelně description, base_lens_id, hides, opens a reason
GET /owners/:kind/:id Pohledy balíčku nebo platformy a který z nich zobrazuje jednotlivé druhy
GET /owners/:kind/:id/grants Pohledy podle jednotky: role, kterým je každý pohled přidělen, a lidé, kterých se týká
GET /owners/:kind/:id/holders Lidé s pohledem v jednotlivých měsících (months, výchozí hodnota šest)
POST /owners/:kind/:id/holders/count Zaznamenání počtů za tento měsíc
GET /owners/:kind/:id/changes Historie změn pohledů vlastníka (limit, výchozí hodnota 50)
GET /:lensId Jeden pohled s jeho základem a pohledy, které jej zužují, a s jeho přiděleními a změnami
PATCH /:lensId Změna pohledu: name, description, shows, hides, opens, reason
POST /:lensId/withdraw Odvolání pohledu a s ním i jeho přidělení. Pohled, který je zužován jiným aktivním pohledem, nelze odvolat, dokud není odvolán tento pohled
POST /:lensId/grants Přidělení pohledu: business_unit_id, role, reason
POST /:lensId/grants/:grantId/withdraw Odvolání jednoho přidělení

:kind je pack nebo platform. Každé odmítnutí nese kód s větou a dalším krokem a neočekávané selhání odpovídá UNHANDLED_ERROR s příčinou v protokolu služby, nikdy v odpovědi.

Znalostní model, konektory a kompilované mozky

Znalostní model tvoří druhy věcí, které balíček zná, a jejich vzájemné propojení. Je verzovaný a balíček obvykle staví na základním modelu balíčku, ze kterého dědí: balíček chladírenského řetězce postavený na základním modelu logistiky přidává pět druhů (mimo jiné chladírenskou jednotku a zastávku plavidla) a dva z nich propojuje se základem, aniž by měnil samotný základ. Každá vlastnost je klasifikována již při vytvoření, takže osobní a obchodní pole jsou známa dříve, než je použije jakýkoli pohled nebo datová větev. Pohled pro techniky pak nemůže zobrazit částku pojistné události klasifikovanou jako obchodní. Odvolaná vlastnost zůstává ve verzi, která ji měla, a mizí až v pozdější verzi. Příprava nové verze nejprve zkopíruje znalosti a cesta zpět zůstává otevřená po stanovenou dobu.

Konektory přenášejí záznamy ze systémů, které je již uchovávají: správy pojistných smluv, systému pojistných událostí, poštovní složky se soubory, které posílají partneři. Každý je jen pro čtení, běží podle vlastního plánu a má testovací tlačítko. Záznamy se při načítání mapují na slova balíčku a ukládají se do znalostního modelu, ze kterého čtou pohledy; odpovědi asistenta na něj odkazují. Z Nexus se do zdrojového systému nic nezapisuje.

Kompilované mozky jsou části balíčku, které rozhodují: například upisovací mozek a mozek pojistných událostí balíčku Pojišťovnictví. Běží na serveru jako kompilované licencované moduly, z nichž každý sám ověřuje licenci, a nikdy se nedodávají do telefonu ani prohlížeče.

Znalostní model a konektory
Znalostní model a konektory
Stránka Znalostní model a konektory zobrazuje verzi modelu a slovník balíčku s vlastními termíny organizace a testuje každý konektor jen pro čtení. V systémech pojistných smluv ani pojistných událostí se z Nexus nic nemění.

Mobilní překryvná vrstva a offline pole

Balíček deklaruje své obrazovky pro telefon ve stejném manifestu jako mobilní překryv: které karty a kroky záznamu se zobrazují na telefonech a pro které role. Administrátor pak pro každou organizaci nastaví pravidla na telefonech, například jak dlouho mohou záznamy čekat offline, zda každá fotografie nese místo, kde byla pořízena, a zda schválení vyžadují přístupový klíč. Nastavení probíhá na počítači; administrátor vidí, co telefony odesílají, jako názvy a počty, nikdy samotné fotografie či poznámky.

Každé pole, které obrazovka telefonu nabízí bez signálu, deklaruje jednu ze tří tříd a obrazovka ukazuje, kterou:

Třída Co se s ním stane Příklady
Vytvořeno offline Uloženo v telefonu a sloučeno po opětovném připojení telefonu Poznámky, fotografie, odečty
Navrženo offline Odesláno jako návrh, o kterém rozhodne kancelář. Server jej nikdy neslučuje; přehrává jej prostřednictvím vlastních kontrol oprávnění Částka, zjištění, změna rezervy, rozhodnutí
Nikdy offline V terénu není možné. Zobrazeno jako řádek s důvodem, nikdy jako tlačítko Podpis, pečeť, kontrola oprávnění, kontrola vůči sankčnímu seznamu

Překryvy neobsahují žádná pravidla ani prompty a ani mozky. Jsou to čitelné definice obrazovek a vše, co rozhoduje, zůstává na serveru. Obrazovky balíčku pro telefon se otevírají pouze v telefonních aplikacích Nexus, a to jen tehdy, když organizace má balíček i doplněk Mobilní aplikace.

Mobilní nadstavba
Mobilní nadstavba
Mobilní překryv určuje, které karty balíčku a kroky záznamu se zobrazují na telefonech a pro které role. Záznamy čekají offline tak dlouho, jak organizace povolí, a schválení vyžadují přístupový klíč. Náhled přesně ukazuje, co vidí jedna role.

Oprávnění: kdo má balíček a kde běží

Balíček je licencován, nikdy se nezapíná konfigurací. O tom, kdo jej vidí, rozhodují tři vrstvy.

Licence. Podepsaný licenční dokument nese seznam domain_packs s id matice (nejvýše 100, případně prázdný) vedle svých skupin funkcí grants a add_ons. Konzole Adverant nevydá balíček bez doplňků, které potřebuje: balíček vyžadující Rozhodovací místnosti a zapečetěné záznamy nelze vydat k licenci, která je nemá. Skupiny funkcí v licenci se udělují buď celé instalaci, nebo jmenovaným organizacím, a kontrola oprávnění odpovídá pro každou organizaci zvlášť. Odeberete-li oprávnění, každý pohled a každá obrazovka telefonu daného balíčku se stane ukázkou a jeho záznamy zůstanou zachovány.

Kontrola oprávnění. Pro každou organizaci a tarif, každou roli a každou osobu kontrola oprávnění rozhoduje, zda je ovládací prvek přidaný balíčkem oprávněný, zobrazený jako ukázka, skrytý, nebo odmítnutý s kódem. Řídí řádky nabídky a karty panelů a také kontroly tras a odesílání. Uzavřený modul zůstává autoritou pro své vlastní udělení.

Jednotky a pohledy. V organizaci, která balíček má, rozhoduje administrátor, kde poběží. Balíček se pro jednotku zapíná postupně, nikdy pro celou jednotku najednou: kontrola licence, pilotní skupina, předvolba nastavení a poté rozšíření na všechny v jednotce k datu, které administrátor zvolí. Než se cokoli změní, stránka ukáže, kdo co získá, podle rolí. Pohledy se pak přidělují pro každou roli a jednotku v jedné matici. Pozdější vypnutí balíčku pro jednotku zachová všechny záznamy, které lidé vytvořili; pohledy a šablony zmizí a nic jiného se nezmění.

Zapnutí oboru pro útvar
Zapnutí oboru pro útvar
Zapnutí domény pro jednotku probíhá postupně, od kontroly licence přes pilotní skupinu až po celou jednotku. Administrátor vidí, kdo co získá, dříve než se cokoli změní, a nastavení z pilotu se přenášejí beze změny.

Deset balíčků

Adverant dodává deset doménových balíčků. Každý vyžaduje základní licenci Enterprise a některé vyžadují doplňky. Obrazovky pro telefony každého balíčku navíc vyžadují doplněk Mobilní aplikace.

Balíček Id v matici Co přináší Dále vyžaduje
Pojišťovnictví insurance Pojišťovací pohledy mimo jiné pro upisování, škody, zajištění, Lloyd's a delegované pravomoci; tok pro podvody a šetření; cesty a nastavení pojišťovacího obchodu; zkompilované pojišťovací mozky Rozhodovací místnosti a zapečetěné záznamy
Bankovnictví a platby financial-services Registr outsourcovaných technologií; lhůty a hlášení technologických incidentů; plány odchodu pro kritické poskytovatele; úvěrová rozhodnutí; spory u karet Nic nad rámec základu
Kapitálové trhy a správa aktiv capital-markets Pohledy pro výzkumného analytika, portfolio manažera, dohled a compliance a reporting klientům; nahrávání hovorů na obchodních stolech; výzkum držený za informační bariérou až do zveřejnění; šablony pro záznam překročení bariéry, kontrolu hovorů a zveřejnění výzkumu. Telefony dostávají ranní přehled a schvalování zveřejnění i upozornění dohledu, nikdy pokyny k obchodům Rozhodovací místnosti a zapečetěné záznamy
Státní správa a veřejný sektor government Žádosti o dávky a nároky; žádosti o povolení staveb; žádosti o informace Nic nad rámec základu
Zdravotnictví healthcare-providers Přístup k záznamům pacientů a jejich sdílení a žádosti o informace. Bez podpory klinického rozhodování Nic nad rámec základu
Vědy o živé přírodě (Life sciences) life-sciences Odchylky a nápravná opatření; kontrola záznamů o šaržích; validované řízení změn Nic nad rámec základu
Kritická infrastruktura a energetika energy-and-utilities Lhůty a hlášení incidentů; inspekce a závady; pracovní příkazy Nic nad rámec základu
Obrana a bezpečnost defence-and-mission Terénní hlášení sloučená s upozorněními platformy; označení pro sdílení; vyhodnocení. Jeho verze pro telefony se instaluje pouze prostřednictvím správy zařízení Nexus Edge, pro upozornění platformy
Právní a profesní služby legal Pohledy pro vykazujícího advokáta, znalostního právníka, konflikty a rizika a fakturaci; kontrola střetu zájmů u každé nové věci; etické bariéry rušené pouze dvěma partnery; šablony pro kontrolu nové věci, tvůrce bariér a připomínky bariér. Telefony dostávají záznam času a aktualizace věcí se schvalováním, nikdy privilegované soubory Rozhodovací místnosti a zapečetěné záznamy a Poštu
Logistika a námořní doprava logistics-and-maritime Pohledy pro provozního dispečera, celníka, manažera dopravců a přístavního inspektora; celní prohlášení a zadržení; kontroly sankcí před první rezervací, přičemž každé zadržení uvolňuje člověk; znalostní model přístavů a plavidel, dopravců a zadržení. Telefony dostávají inspekce překladišť a kotvišť a celní zadržení, včetně zjištění z dronů Mapa a GeoAI

Harrow Port Authority používá balíček Logistika a námořní doprava a je to ten, který bych si přečetl jako první, pokud stavíte vlastní: jeho znalostní model je základem, na kterém staví výše uvedený příklad chladového řetězce.

Tvorba vlastního řešení

V edici Enterprise vývojář zakládá balíček ze zlaté cesty v části Začít něco nového, ve třech krocích. „O balíčku“ pojmenuje balíček, jeho jednotky, balíček, na kterém staví, a pravidla, pro která musí doložit důkazy. „Znalostní model“ přidá nové druhy věcí nad základní model. „Kontrola a vytvoření“ zobrazí plán a poté jej provede. Vytvoří repozitář ze šablony balíčku s manifestem deklarujícím, k čemu smí balíček přistupovat, a jeho testy; poté vývojový prostor s větvemi syntetických dat; poté koncept položky katalogu, který vidíte pouze vy. Nic se nevytvoří, dokud v posledním kroku nestisknete Vytvořit. Kapitola 2.24, Vytvoření vlastní vertikály od začátku do konce, prochází celou cestu.

Kolik vás balíček stojí

Balíček je rozšíření, jehož vlastnictví je nejnákladnější. Jeho znalostní model má verze, na kterých lidé závisejí, takže vlastnost, které litujete, zůstane ve verzi, která ji přinesla. Jeho pohledy mohou pouze ubírat, takže role, která potřebuje víc, znamená diskusi o základním pohledu. Jeho mapa důkazů jmenuje pravidla, která musí potvrdit váš vlastní právní poradce, než se na ni kdokoli spolehne. A zákazník jej získá pouze prostřednictvím své licence: můžete vytvořit nejlepší balíček v oboru, a přesto jej nezapnete ani pro jedinou jednotku, dokud jej licence organizace nezahrnuje. Na oplátku vás třicátá jednotka, která o něj stojí, stojí jedno přepnutí a pilot.