Wersja 1.0.0-alpha.1najnowsza
Rozdział 2.23
Pakiety domenowe
Z czego składa się pakiet domenowy i co zawiera jego plik pack.json; soczewki (lenses) i rejestr soczewek; modele wiedzy, konektory i nakładki mobilne; jak pakiet jest licencjonowany i włączany dla jednostki; oraz dziesięć pakietów dostarczanych przez Adverant.
Ta strona została przetłumaczona przez AI z angielskiego oryginału. W razie jakichkolwiek niejasności wersją wiążącą jest strona w języku angielskim. Przeczytaj tę stronę po angielsku

Pakiet, który zbudowałem w Corrán Orbital, zaczynał jako dwie wtyczki i kilkanaście umiejętności Skills Engine, z których korzystał wyłącznie nasz zespół stacji naziemnej. Gdy dział operacji misji poprosił o to samo, miałem wybór: skopiować całość i utrzymywać wszystko w dwóch egzemplarzach albo przekształcić to w pakiet domenowy z jednym modelem wiedzy i dwiema soczewkami, włączanymi dla każdej jednostki osobno. Przekształcenie tego w pakiet zajęło mi tydzień. Jutro dokonałbym tego samego wyboru, a następnym razem zacząłbym od pakietu.
Pakiet domenowy wnosi do Nexus sposób pracy jednej branży. Zawiera rodzaje obiektów tej branży i powiązania między nimi oraz to, co widzi każda rola. Obejmuje szablony i przepływy pracy, z których ludzie korzystają na co dzień, dowody wymagane przez przepisy branży oraz ekrany działające na telefonie bez zasięgu. Nigdy nie zmienia powłoki ani jej komponentów, ani zasad redakcyjnych. Nowa branża to pakiet, a nie aplikacja.
Z czego składa się pakiet
W gruncie rzeczy pakiet składa się z czterech elementów i żaden z nich nie jest kodem platformy przeznaczonym dla konkretnego pakietu:
- Zestaw grup funkcji w kontroli uprawnień. Elementy sterujące pakietu należą do zestawu grup funkcji. O każdym wierszu menu i każdej karcie panelu dodanej przez pakiet decyduje więc ten sam mechanizm co w pozostałej części Nexus: element jest dostępny w ramach uprawnień, wyświetlany jako zapowiedź albo ukryty.
- Manifest pakietu,
pack.json, który deklaruje klastry ekranów pakietu i jego słownictwo, jego soczewki oraz ekrany telefonu. - Zamknięte moduły, które same weryfikują swoje uprawnienie. Kod serwerowy podejmujący decyzje, taki jak skompilowane mózgi pakietu, zawiera weryfikator licencji i samodzielnie sprawdza podpisaną licencję. Nic spoza modułu nie może go włączyć.
- Wpis w katalogu, dzięki któremu pakiet pojawia się na stronie Pakiety domenowe wraz z informacją, co wnosi i czego wymaga.
Na nich opierają się elementy widoczne dla użytkowników: model wiedzy i soczewki; szablony, przepływy pracy i umiejętności Skills Engine; konektory tylko do odczytu do systemów, które już przechowują rekordy, mapa dowodów łącząca każdy przepis z rekordami, które na niego odpowiadają, oraz nakładka mobilna.
Plik pack.json
Oto manifest pakietu Bankowość i płatności, skrócony do jednej soczewki z jednym stanowiskiem oraz dwóch terminów. Jego identyfikator pliku to fintech, a name zawiera roboczą nazwę pakietu; konsola i katalog wyświetlają go jako Bankowość i płatności.
{
"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"
}
]
}
}Pola, od góry do dołu:
| Pole | Co określa |
|---|---|
id |
Identyfikator pakietu, małymi literami |
name |
Jego nazwa robocza |
version |
Własna wersja pakietu |
inherits |
Pakiet, na którym ten pakiet się opiera. Bankowość i płatności dziedziczy po pakiecie Ubezpieczenia, który zawiera wspólne klastry używane przez każdy pakiet, takie jak rozmowa i ustawienia. Nowy pakiet dodaje swoje soczewki, a wspólne klastry pozostawia pakietowi, po którym dziedziczy |
screenCount |
Liczba ekranów zdefiniowanych przez pakiet |
clusters[] |
Grupy ekranów pakietu. Każda ma id, kind, name, seats, dla którego jest przeznaczona, swój purpose, zestawy lexicon, z których pochodzi jej słownictwo, swój menu oraz swoje screens, każde z id, title, who i tym, do czego doing |
clusters[].kind |
shared dla klastra dostępnego z każdej soczewki (na przykład rozmowy); lens dla własnych ekranów jednej roli. Pole scope klastra określa, czy należy on do rdzenia (core), czy do branży (domain) |
lexicon |
Słownictwo pakietu w nazwanych zestawach. Każdy termin ma proste objaśnienie zrozumiałe dla nowej osoby, a trzecie pole ma wartość exact dla terminu, którego należy używać dosłownie, na przykład wartości regulacyjnej |
world |
Przykładowy świat fikcyjnych dzierżawców i stanowisk używany przez ekrany i testy pakietu oraz jego gałęzie danych |
world.tenants[].plan |
areas planu: klastry i soczewki otwierane przez plan tego dzierżawcy, spośród of |
world.tenants[].ai |
Polityka AI (sztucznej inteligencji) organizacji dla pakietu: czy dozwolone są modele działające na urządzeniu (onDevice), dokąd dane osobowe mogą trafiać do modelu w chmurze (personalDataToCloudModels, na przykład uk-only lub eu-only) oraz czy zapieczętowanie rekordu wymaga wysyłki UNO (sealRequiresUno) |
world.seats[] |
Stanowisko jednej osoby: jej title, lens, które posiada, wspólne clusters, do których również ma dostęp, jej ekran home, jej posture (desk, field lub consumer) oraz, w pełnym pliku, jej authority, czyli limity, w ramach których działa |
Dwie zasady określają, co może zawierać plik pack.json. Przepis jest nazywany prostymi słowami z objaśnieniem, nigdy samym skrótowcem. Ponadto nic w pliku nie jest kodem: jest to czytelna definicja interpretowana przez serwer i aplikacje, więc nigdy nie zawiera reguły ani promptu, ani skompilowanego mózgu.
Współdzielone soczewki
Niektóre reżimy regulacyjne dotyczą kilku branż. Rejestr outsourcowanych technologii służy pakietom Ubezpieczenia oraz Bankowość i płatności; zegary incydentów (odliczania do raportów, których regulator oczekuje po incydencie) służą pakietom Infrastruktura krytyczna i energetyka oraz Administracja rządowa i sektor publiczny. Reżim używany przez kilka pakietów jest zapisywany raz jako wspólna soczewka. Każdy pakiet, który go potrzebuje, dołącza go. Gdy przepis się zmienia, zmienia się w jednym miejscu.
Soczewka wyłącznie zawęża
Soczewka to to, co widzi jedna rola w pakiecie lub platformie: które karty i pola oraz które działania. Zawsze jest definiowana jako zawężenie soczewki bazowej. Soczewka z bazą nie pokazuje żadnego rodzaju obiektu, którego nie pokazuje jej baza, nie otwiera żadnego obszaru, którego nie otwiera jej baza, i nie może jednocześnie pokazywać i ukrywać tego samego rodzaju. Uprawnienia nadal wynikają z ról; soczewka zmienia widok, nigdy zaś to, co dana osoba może robić.
Próba jej poszerzenia kończy się odpowiedzią LENS_CANNOT_WIDEN (422) i niczego nie zapisuje. W kreatorze soczewek dla soczewki technika kontenerów chłodniczych zbudowanej na bazie kontrolera operacyjnego, która nie pokazuje kwot roszczeń, brzmi to: „Kwoty roszczenia nie można dodać do tej soczewki”. Rozwiązaniem jest inna soczewka bazowa, co oznacza inny wniosek do właściciela bazy.
Reguła jest egzekwowana w bazie danych, a nie tylko w trasie. Soczewki każdej organizacji znajdują się w czterech tabelach schematu rejestru wtyczek:
| Tabela | Co zawiera |
|---|---|
plugins.lenses |
Jedna soczewka jednego właściciela, pakietu (owner_kind pack) lub platformy (platform): jej slug i name, jej base_lens_id, rodzaje, które shows i hides, obszary, które opens, jej status (active lub withdrawn) oraz jej version |
plugins.lens_grants |
Soczewka przyznana jednej roli (owner, admin, member, viewer, developer lub billing_admin) w jednej jednostce biznesowej |
plugins.lens_changes |
Każda zmiana soczewki lub jej przydziałów, zapisana jako stan przed i po, wraz z informacją, kto ją wprowadził i dlaczego. Tylko do dopisywania |
plugins.lens_holder_months |
Liczba osób, które w danym miesiącu korzystały z soczewki w jednostce. Liczba, nigdy tożsamość |
Wyzwalacz odrzuca każdą soczewkę, która pokazuje więcej niż jej baza, oraz odrzuca zmianę bazy, po której zbudowana na niej soczewka pokazywałaby więcej niż baza. Nic nie jest usuwane. Soczewki i przydziały są wycofywane, a ponowne przyznanie soczewki to nowy wiersz; zmiana nigdy nie jest nadpisywana, a liczba z minionego miesiąca nigdy nie jest zmieniana. Każdy wiersz odwołuje się do soczewki własnej organizacji za pomocą klucza złożonego, więc przydział nie może wskazywać na inną organizację.
Konsola i Państwa własne narzędzia łączą się z rejestrem przez /api/v1/lenses, przy użyciu tokenu okaziciela danej osoby. Organizacja i osoba oraz stanowisko w jednostce pochodzą ze zweryfikowanego tokenu i z niczego innego.
| Metoda i ścieżka | Co robi |
|---|---|
GET / |
Soczewki, filtrowane według owner_kind, owner_id i status, wraz z ich przydziałami w Państwa stanowisku |
POST / |
Dodanie soczewki: owner_kind, owner_id, slug, name, shows oraz opcjonalnie description, base_lens_id, hides, opens i reason |
GET /owners/:kind/:id |
Soczewki pakietu lub platformy oraz informacja, która z nich pokazuje każdy rodzaj |
GET /owners/:kind/:id/grants |
Soczewki według jednostki: role, którym przyznano każdą soczewkę, i osoby, do których dociera |
GET /owners/:kind/:id/holders |
Osoby korzystające z soczewki w poszczególnych miesiącach (months, domyślnie sześć) |
POST /owners/:kind/:id/holders/count |
Zapisanie liczb z bieżącego miesiąca |
GET /owners/:kind/:id/changes |
Historia zmian soczewek właściciela (limit, domyślnie 50) |
GET /:lensId |
Jedna soczewka wraz z jej bazą i zawężającymi ją soczewkami oraz jej przydziałami i zmianami |
PATCH /:lensId |
Zmiana soczewki: name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Wycofanie soczewki wraz z jej przydziałami. Soczewki zawężanej przez inną aktywną soczewkę nie można wycofać, dopóki tamta nie zostanie wycofana |
POST /:lensId/grants |
Przyznanie soczewki: business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Wycofanie jednego przydziału |
:kind ma wartość pack lub platform. Każda odmowa zawiera kod ze zdaniem objaśnienia i kolejnym krokiem, a nieoczekiwany błąd zwraca UNHANDLED_ERROR, przy czym jego przyczyna trafia do dziennika usługi, nigdy do odpowiedzi.
Model wiedzy, konektory i skompilowane mózgi
Model wiedzy to rodzaje obiektów znane pakietowi i powiązania między nimi. Jest wersjonowany, a pakiet zwykle opiera się na modelu bazowym pakietu, po którym dziedziczy: pakiet łańcucha chłodniczego oparty na bazowym modelu logistycznym dodaje pięć rodzajów (między innymi kontener chłodniczy i zawinięcie statku) i łączy dwa z nich z bazą, nie zmieniając samej bazy. Każda właściwość jest klasyfikowana w chwili utworzenia, dzięki czemu pola osobowe i handlowe są znane, zanim użyje ich jakakolwiek soczewka lub gałąź danych. Soczewka dla techników nie może więc pokazać kwoty roszczenia sklasyfikowanej jako handlowa. Wycofana właściwość pozostaje w wersji, która ją zawierała, i znika dopiero w późniejszej wersji. Przygotowanie nowej wersji najpierw kopiuje wiedzę, a droga powrotu pozostaje otwarta przez ustalony okres.
Konektory pobierają rekordy z systemów, które już je przechowują: systemu administrowania polisami, systemu obsługi roszczeń, folderu pocztowego z plikami przesyłanymi przez partnerów. Każdy działa tylko do odczytu, według własnego harmonogramu i ma przycisk testu. Rekordy są mapowane na słownictwo pakietu podczas pobierania i trafiają do modelu wiedzy, z którego korzystają soczewki; odpowiedzi asystenta powołują się na niego. Nexus niczego nie zapisuje z powrotem w systemie źródłowym.
Skompilowane mózgi to części pakietu, które podejmują decyzje: na przykład mózg underwritingowy i mózg roszczeń pakietu Ubezpieczenia. Działają na serwerze jako skompilowane, licencjonowane moduły, z których każdy sam weryfikuje licencję, i nigdy nie są dostarczane na telefon ani do przeglądarki.
Nakładka mobilna i pola offline
Pakiet deklaruje swoje ekrany telefonu w tym samym manifeście, jako nakładkę mobilną: które karty i kroki rejestracji pojawiają się na telefonach i dla których ról. Następnie administrator ustala reguły dla telefonów w każdej organizacji, na przykład jak długo rejestracje mogą czekać w trybie offline, czy każde zdjęcie zawiera miejsce jego wykonania oraz czy zatwierdzenia wymagają klucza dostępu. Konfiguracja odbywa się na komputerze; administrator widzi to, co wysyłają telefony, w postaci nazw i liczb, nigdy samych zdjęć ani notatek.
Każde pole oferowane przez ekran telefonu bez zasięgu deklaruje jedną z trzech klas, a ekran pokazuje, którą:
| Klasa | Co się z nim dzieje | Przykłady |
|---|---|---|
| Tworzone offline | Zapisywane na telefonie i scalane po ponownym połączeniu telefonu | Notatki, zdjęcia, odczyty |
| Proponowane offline | Wysyłane jako propozycja, o której decyduje biuro. Serwer nigdy jej nie scala; odtwarza ją przez własne kontrole uprawnień | Kwota, ustalenie, zmiana rezerwy, decyzja |
| Nigdy offline | Niemożliwe w terenie. Wyświetlane jako wiersz z podaniem powodu, nigdy jako przycisk | Podpis, pieczęć, kontrola uprawnień, sprawdzenie na liście sankcyjnej |
Nakładki nie zawierają reguł ani promptów, ani też mózgów. Są czytelnymi definicjami ekranów, a wszystko, co podejmuje decyzje, pozostaje na serwerze. Ekrany telefonu pakietu otwierają się wyłącznie w aplikacjach telefonicznych Nexus i tylko wtedy, gdy organizacja posiada zarówno pakiet, jak i dodatek Aplikacje mobilne.
Uprawnienia: kto ma pakiet i gdzie jest on uruchamiany
Pakiet jest licencjonowany, nigdy nie jest włączany konfiguracją. O tym, kto go widzi, decydują trzy warstwy.
Licencja. Podpisany dokument licencji zawiera listę domain_packs identyfikatorów macierzy (najwyżej 100, może być pusta) obok grants i add_ons grup funkcji. Konsola Adverant nie wyda pakietu bez wymaganych przez niego dodatków: pakietu wymagającego dodatku Pokoje decyzyjne i zapieczętowanych rekordów nie można wydać w ramach licencji, która go nie obejmuje. Grupy funkcji w licencji są przyznawane całej instalacji albo wskazanym organizacjom, a kontrola uprawnień udziela odpowiedzi dla każdej organizacji osobno. Po usunięciu przydziału każda soczewka i każdy ekran telefonu pakietu stają się zapowiedzią, a ich rekordy zostają zachowane.
Kontrola uprawnień. Dla każdej organizacji i planu, każdej roli i każdej osoby kontrola uprawnień decyduje, czy element sterujący dodawany przez pakiet jest uprawniony, wyświetlany jako zapowiedź, ukryty, czy odrzucany z kodem. Steruje ona pozycjami menu i kartami paneli oraz kontrolami tras i wywołań. Zamknięty moduł pozostaje jedynym źródłem rozstrzygającym o własnym uprawnieniu.
Jednostki i widoki. W organizacji, która posiada pakiet, administrator decyduje, gdzie on działa. Pakiet jest włączany dla jednostki etapami, nigdy dla całej jednostki naraz: kontrola licencji, grupa pilotażowa, ustawienia wstępne, a następnie rozszerzenie na wszystkich w jednostce w dniu wybranym przez administratora. Zanim cokolwiek się zmieni, strona pokazuje, kto co zyskuje, według ról. Widoki są następnie przydzielane według ról i jednostek w jednej macierzy. Późniejsze wyłączenie pakietu dla jednostki zachowuje wszystkie rekordy utworzone przez użytkowników; widoki i szablony znikają, a nic innego się nie zmienia.
Dziesięć pakietów
Adverant dostarcza dziesięć pakietów domenowych. Każdy z nich wymaga podstawowej licencji Enterprise, a niektóre wymagają dodatków. Ekrany na telefony każdego pakietu wymagają również dodatku Mobile apps.
| Pakiet | Identyfikator w macierzy | Co zapewnia | Wymaga również |
|---|---|---|---|
| Ubezpieczenia | insurance |
Widoki ubezpieczeniowe m.in. dla underwritingu, szkód, reasekuracji, Lloyd's i upoważnień delegowanych; proces wykrywania nadużyć i dochodzeń; ścieżki i ustawienia sklepu ubezpieczeniowego; skompilowane mózgi dla ubezpieczeń | Pokoje decyzyjne i zapieczętowane rekordy |
| Bankowość i płatności | financial-services |
Rejestr outsourcingu technologii; terminy i raporty incydentów technologicznych; plany wyjścia dla kluczowych dostawców; decyzje kredytowe; spory dotyczące kart | Nic poza licencją podstawową |
| Rynki kapitałowe i zarządzanie aktywami | capital-markets |
Widoki dla analityka badań, zarządzającego portfelem, nadzoru i compliance oraz raportowania dla klientów; nagrywane rozmowy na desce transakcyjnych; analizy objęte barierą informacyjną do momentu publikacji; szablony rejestru przekroczeń bariery, przeglądu rozmów i publikacji analiz. Na telefonach dostępne są poranny briefing i zatwierdzanie publikacji, a także alerty nadzoru, nigdy zlecenia | Pokoje decyzyjne i zapieczętowane rekordy |
| Administracja rządowa i sektor publiczny | government |
Wnioski o świadczenia i uprawnienia; wnioski planistyczne; wnioski o udostępnienie informacji | Nic poza licencją podstawową |
| Ochrona zdrowia | healthcare-providers |
Dostęp do dokumentacji pacjentów i jej udostępnianie oraz wnioski o udostępnienie informacji. Bez wsparcia decyzji klinicznych | Nic poza licencją podstawową |
| Nauki o życiu (life sciences) | life-sciences |
Odchylenia i działania korygujące; przegląd dokumentacji serii; walidowana kontrola zmian | Nic poza licencją podstawową |
| Infrastruktura krytyczna i energetyka | energy-and-utilities |
Terminy i raporty incydentów; inspekcje i usterki; zlecenia prac | Nic poza licencją podstawową |
| Obronność i bezpieczeństwo | defence-and-mission |
Raporty terenowe połączone z alertami platformy; oznaczenia udostępniania; odprawy. Wersja na telefony jest instalowana wyłącznie przez system zarządzania urządzeniami | Nexus Edge, dla alertów platformy |
| Usługi prawne i profesjonalne | legal |
Widoki dla prawnika rozliczającego czas, prawnika ds. wiedzy, konfliktów i ryzyka oraz rozliczeń; kontrola konfliktu interesów przy każdej nowej sprawie; bariery etyczne znoszone wyłącznie przez dwóch partnerów; szablony kontroli nowej sprawy, kreatora barier i przypomnień o barierach. Na telefonach dostępna jest rejestracja czasu oraz aktualizacje spraw z zatwierdzeniami, nigdy pliki objęte tajemnicą | Pokoje decyzyjne i zapieczętowane rekordy oraz Poczta |
| Logistyka i gospodarka morska | logistics-and-maritime |
Widoki dla kontrolera operacji, funkcjonariusza celnego, menedżera przewoźników i inspektora portowego; zgłoszenia celne i wstrzymania; kontrole sankcyjne przed pierwszą rezerwacją, przy czym każde wstrzymanie zwalnia człowiek; model wiedzy obejmujący porty i statki, przewoźników i wstrzymania. Na telefonach dostępne są inspekcje placów i nabrzeży oraz wstrzymania celne wraz z ustaleniami z dronów | Mapa i GeoAI |
Harrow Port Authority korzysta z pakietu Logistyka i transport morski i to od niego radziłbym zacząć lekturę, jeśli budują Państwo własny pakiet: jego model wiedzy stanowi podstawę, na której opiera się powyższy przykład łańcucha chłodniczego.
Budowanie własnego rozwiązania
W planie Enterprise programista rozpoczyna tworzenie pakietu ze sprawdzonej ścieżki w sekcji Rozpocznij coś nowego, w trzech krokach. „O pakiecie” określa nazwę pakietu, jego jednostki, pakiet, na którym się opiera, oraz przepisy, dla których musi przedstawić dowody. „Model wiedzy” dodaje nowe rodzaje obiektów do modelu bazowego. „Przegląd i utworzenie” pokazuje plan, a następnie go realizuje. Tworzy repozytorium z szablonu pakietu wraz z manifestem deklarującym, do czego pakiet może mieć dostęp, oraz jego testami; następnie przestrzeń deweloperską z gałęziami danych syntetycznych; następnie roboczy wpis w katalogu widoczny tylko dla Państwa. Nic nie zostaje utworzone, dopóki nie naciśną Państwo przycisku Utwórz w ostatnim kroku. Rozdział 2.24, Budowa niestandardowego pakietu branżowego od początku do końca, omawia całą ścieżkę.
Ile kosztuje Państwa pakiet
Pakiet to najdroższe w utrzymaniu rozszerzenie. Jego model wiedzy ma wersje, od których zależą użytkownicy, więc właściwość, której Państwo żałują, pozostaje w wersji, w której została wydana. Jego widoki mogą jedynie ograniczać, więc rola, która potrzebuje więcej, oznacza rozmowę o widoku bazowym. Jego mapa dowodów wskazuje przepisy, które Państwa radca prawny musi potwierdzić, zanim ktokolwiek zacznie na niej polegać. A klient otrzymuje go wyłącznie w ramach swojej licencji: mogą Państwo zbudować najlepszy pakiet w branży, a mimo to nie włączyć go dla żadnej jednostki, dopóki licencja organizacji go nie obejmuje. W zamian trzydziesta jednostka, która go potrzebuje, kosztuje Państwa jedno przełączenie i pilotaż.




