ВходЗапазете среща

Глава 2.23

Браншови пакети

От какво се състои един браншов пакет и какво описва неговият pack.json; призми и регистърът на призмите; модели на знания, конектори и мобилни наслагвания; как се лицензира и включва пакет за дадено звено; и десетте пакета, които Adverant доставя.

Тази страница е преведена от ИИ от английския оригинал. Ако нещо е неясно, английската страница е референтна. Прочетете тази страница на английски

19 минути за четене

Пакетът, който изградих в Corrán Orbital, започна като две приставки и дузина умения от Skills Engine, използвани само от екипа ни на наземната станция. Когато звеното за управление на мисиите поиска същото, имах избор: да копирам всичко и да поддържам по две от всяко нещо, или да го превърна в домейн пакет с един модел на знания и две призма-изгледи (lenses), включвани за всяко звено. Отне ми седмица да го направя на пакет. Утре отново бих направил същия избор, а следващия път бих започнал направо с пакета.

Домейн пакетът пренася начина на работа на един бранш в Nexus. Той съдържа видовете обекти в бранша и как се свързват помежду си, както и какво вижда всяка роля. Носи шаблоните и работните потоци, които хората използват всеки ден, доказателствата, които правилата в бранша изискват, и екраните, които работят на телефон без обхват. Той никога не променя обвивката или нейните компоненти, нито правилата за писане. Новият бранш е пакет, а не приложение.

От какво се състои един пакет

Отвътре пакетът представлява четири неща и нито едно от тях не е специфичен за пакета код в платформата:

  1. Пакет от групи функции в проверката за права. Контролите на пакета принадлежат към набор от групи функции. Всеки ред в менюто и раздел в панела, които пакетът добавя, се определят от същия механизъм като останалата част от Nexus: с предоставени права, показани като тийзър или скрити.
  2. Манифест на пакета, pack.json, който декларира клъстерите от екрани на пакета и неговите термини, неговите призма-изгледи и екраните му за телефон.
  3. Затворени модули, които сами проверяват предоставените си права. Сървърният код, който взема решения, като например компилираните мозъци на пакета, носи в себе си верификатора на лиценза и сам проверява подписания лиценз. Нищо извън модула не може да го включи.
  4. Запис в каталога, така че пакетът да се появява на страницата с домейн пакети заедно с това, което носи, и това, от което се нуждае.

Върху тях стоят частите, които хората виждат: моделът на знания и призма-изгледите; шаблоните, работните потоци и уменията от Skills Engine; конекторите само за четене към системите, които вече съхраняват записите, картата на доказателствата от всяко правило към записите, които му отговарят, и мобилното наслагване.

Браншови пакети
Браншови пакети
Страницата с домейн пакети изброява всичките десет пакета с това, от което се нуждае всеки, и къде работи. Само Adverant предоставя права за пакет; Вие решавате в кои звена да работи той.

Файлът pack.json

Ето манифеста на пакета „Банкиране и плащания“, съкратен до един призма-изглед с едно работно място и два термина. Идентификаторът на файла му е fintech, а name съдържа работното име на пакета; конзолата и каталогът го показват като „Банкиране и плащания“.

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

Полетата, от горе надолу:

Поле Какво гласи
id Идентификаторът на пакета, с малки букви
name Работното му име
version Собствената версия на пакета
inherits Пакетът, върху който се надгражда този. „Банкиране и плащания“ наследява от „Застраховане“, който съдържа споделените клъстери, използвани от всеки пакет, като например разговорите и настройките. Новият пакет добавя своите призма-изгледи и оставя споделените клъстери на пакета, от който наследява
screenCount Колко екрана дефинира пакетът
clusters[] Групите от екрани на пакета. Всяка има id, kind, name, seats, за която е предназначена, свой purpose, наборите lexicon, от които идват термините ѝ, свои menu и screens, всеки с id, title, who и за какво са doing
clusters[].kind shared за клъстер, до който всеки призма-изглед има достъп (например разговора); lens за собствените екрани на една роля. scope на клъстера указва дали той принадлежи към ядрото (core) или към бранша (domain)
lexicon Термините на пакета в именувани набори. Всеки термин има кратко обяснение на достъпен език, което новодошъл може да прочете, а третата позиция е exact за термин, който трябва да се използва дословно, като например регулаторен показател
world Примерният свят от фиктивни наематели и работни места, които екраните и тестовете на пакета използват, и неговите разклонения на данни
world.tenants[].plan areas на плана: клъстерите и призма-изгледите, които планът на този наемател отваря, измежду of
world.tenants[].ai Политиката за ИИ (изкуствен интелект) на организацията за пакета: дали са разрешени модели на самото устройство (onDevice), къде личните данни могат да отиват към облачен модел (personalDataToCloudModels, като например uk-only или eu-only) и дали запечатването на запис изисква UNO диспечиране (sealRequiresUno)
world.seats[] Работното място на един човек: неговият title, lens, който заема, споделените clusters, до които също има достъп, неговият home екран, неговият posture (desk, field или consumer) и, в пълния файл, неговите authority – границите, в които действа

Две правила определят какво може да съдържа един pack.json. Регулацията се назовава с прости думи и обяснение, никога само като гола абревиатура. И нищо във файла не е код: това е четима дефиниция, която сървърът и приложенията интерпретират, така че никога не съдържа правило или промпт, нито компилиран мозък.

Споделени призми

Някои режими принадлежат на няколко бранша. Регистърът на възложените на външни изпълнители технологии обслужва „Застраховане“ и „Банкиране и плащания“; часовниците за инциденти (обратното броене до докладите, които регулаторът очаква след инцидент) обслужват както „Критична инфраструктура и енергетика“, така и „Държавно управление и публичен сектор“. Режим, който се използва от няколко пакета, се записва веднъж като споделен призма-изглед. Всеки пакет, който се нуждае от него, го включва. Когато правилото се промени, то се променя на едно място.

Призмата само стеснява изгледа

Призма-изгледът (lens) е това, което една роля вижда в рамките на пакет или платформа: кои карти и полета и кои действия. Той винаги се дефинира като стесняване на базов призма-изглед. Призма-изглед с база не показва вид обект, който базата му не показва, и не отваря област, която базата му не отваря, и не може едновременно да показва и скрива един и същ вид. Правата за достъп все така идват от ролите; призма-изгледът променя изгледа, но никога това, което човек може да прави.

Опитайте да разширите такъв и отговорът е LENS_CANNOT_WIDEN (422), без нищо да бъде запазено. В конструктора на призма-изгледи това гласи, за призма-изглед на техник на хладилни контейнери, изграден върху база на оперативен диспечер, която не показва суми по претенции: „Сумата по претенцията не може да бъде добавена към този призма-изглед“. Решението е различен базов призма-изглед, което представлява различна заявка към собственика на базата.

Конструктор на призми
Конструктор на призми
Конструкторът на призма-изгледи изброява какво вижда дадена роля, карта по карта и поле по поле, отметнати спрямо базовия призма-изглед, който стеснява. Опитът да се покаже поле, което базата скрива, се отхвърля с посочване на причината и името на този, който може да промени базата.

Правилото се поддържа в базата данни, а не само в маршрута. Призма-изгледите на всяка организация се намират в четири таблици от схемата на регистъра на приставките:

Таблица Какво съдържа
plugins.lenses Един призма-изглед на един собственик, пакет (owner_kind pack) или платформа (platform): неговите slug и name, неговият base_lens_id, видовете, които shows и hides, областите, които opens, неговият status (active или withdrawn) и неговият version
plugins.lens_grants Призма-изглед, даден на една роля (owner, admin, member, viewer, developer или billing_admin) в едно бизнес звено
plugins.lens_changes Всяка промяна в призма-изглед или предоставените му права, запазена като състояние преди и след, с информация кой я е направил и защо. Само с добавяне
plugins.lens_holder_months Колко души са имали даден призма-изглед в звено всеки месец. Брой, никога кои са

Тригер отхвърля всеки призма-изглед, който показва повече от своята база, и отхвърля промяна в база, която би оставила изграден върху нея призма-изглед да показва повече от нея. Нищо не се изтрива. Призма-изгледите и предоставените права се оттеглят, а повторното даване на призма-изглед е нов ред; промяната никога не се презаписва и броят за минал месец никога не се променя. Всеки ред се позовава на призма-изглед от собствената си организация чрез съставен ключ, така че предоставеното право не може да сочи между различни организации.

Конзолата и собствените Ви инструменти достигат до регистъра чрез /api/v1/lenses със собствения токен на приносител на лицето. Организацията, лицето и работното място в звеното идват от верифицирания токен и от нищо друго.

Метод и път Какво прави
GET / Призма-изгледи, филтрирани по owner_kind, owner_id и status, с техните предоставени права във Вашето работно място
POST / Добавяне на призма-изглед: owner_kind, owner_id, slug, name, shows и по избор description, base_lens_id, hides, opens и reason
GET /owners/:kind/:id Призма-изгледите на пакет или платформа и кой от тях показва всеки вид
GET /owners/:kind/:id/grants Призма-изглед по звено: ролите, на които е даден всеки призма-изглед, и хората, до които достига
GET /owners/:kind/:id/holders Хора, притежаващи призма-изглед всеки месец (months, шест по подразбиране)
POST /owners/:kind/:id/holders/count Записване на бройките за този месец
GET /owners/:kind/:id/changes Историята на промените на призма-изгледите на собственика (limit, 50 по подразбиране)
GET /:lensId Един призма-изглед с неговата база и призма-изгледите, които го стесняват, както и неговите предоставени права и промени
PATCH /:lensId Промяна на призма-изглед: name, description, shows, hides, opens, reason
POST /:lensId/withdraw Оттегляне на призма-изглед и предоставените за него права заедно с него. Призма-изглед, който се стеснява от друг активен призма-изглед, не може да бъде оттеглен, докато другият не бъде оттеглен
POST /:lensId/grants Даване на призма-изглед: business_unit_id, role, reason
POST /:lensId/grants/:grantId/withdraw Оттегляне на едно предоставено право

:kind е pack или platform. Всеки отказ съдържа код с изречение и следваща стъпка, а неочакваният срив връща отговор UNHANDLED_ERROR с причината в журнала на услугата, никога в самия отговор.

Модел на знания, конектори и компилирани ядра

Моделът на знания представлява видовете обекти, които пакетът познава, и как те се свързват. Той има версии и един пакет обикновено надгражда базов модел от пакета, от който наследява: пакет за хладилна верига върху базовия модел за логистика добавя пет вида (сред които хладилен агрегат и посещение на кораб) и свързва два от тях в базата, без да променя самата база. Всяко свойство се класифицира при създаването си, така че личните и търговските полета са известни, преди който и да е призма-изглед или разклонение на данни да ги използва. Така призма-изглед за техници не може да покаже сума по претенция, която е класифицирана като търговска. Оттеглено свойство остава във версията, в която го е имало, и отпада едва в по-късна версия. Подготовката на нова версия първо копира знанията, а пътят за връщане назад остава отворен за определен период.

Конекторите внасят записи от системите, които вече ги съхраняват: администриране на полици, система за претенции, пощенска папка с файлове, изпращани от партньори. Всеки е само за четене, работи по собствен график и има бутон за тестване. Записите се съпоставят с термините на пакета при влизане и попадат в модела на знания, който призма-изгледите четат; отговорите на асистента се позовават на него. Нищо не се записва обратно в изходната система от Nexus.

Компилираните мозъци са частите от пакета, които вземат решения: например мозъкът за оценка на риска и мозъкът за претенции на пакета „Застраховане“. Те работят на сървъра като компилирани, лицензирани модули, като всеки сам проверява лиценза си, и никога не се изпращат към телефон или браузър.

Модел на знания и конектори
Модел на знания и конектори
„Модел на знания и конектори“ показва версията на модела и речника на пакета със собствените термини на организацията и тества всеки конектор само за четене. Нищо в системите за полици или претенции не се променя от Nexus.

Мобилното наслагване и полетата за работа офлайн

Пакетът декларира своите екрани за телефон в същия манифест като мобилно наслагване: кои карти и стъпки за въвеждане се появяват на телефоните и за кои роли. След това администраторът задава правилата за телефоните за всяка организация, като например колко дълго въведените данни могат да чакат офлайн, дали всяка снимка носи информация къде е направена и дали одобренията изискват ключ за достъп (passkey). Настройването остава на компютър; администраторът вижда това, което телефоните изпращат, като имена и бройки, но никога самите снимки или бележки.

Всяко поле, което екранът на телефона предлага без обхват, декларира един от три класа и екранът показва кой е той:

Клас Какво се случва с него Примери
Създадено офлайн Запазва се на телефона и се слива, когато телефонът се свърже отново Бележки, снимки, отчитания
Предложено офлайн Изпраща се като предложение, за което офисът взема решение. Сървърът никога не го слива; той го възпроизвежда през собствените си проверки за правомощия Сума, констатация, промяна на резерв, решение
Никога офлайн Не е възможно на терен. Изобразява се като ред с причината за това, никога като бутон Подпис, печат, проверка на правомощия, проверка срещу санкционен списък

Наслагванията не носят правила, нито промптове, нито пък мозъци. Те са четими дефиниции на екрани и всичко, което взема решения, остава на сървъра. Екраните за телефон на даден пакет се отварят само вътре в телефонните приложения на Nexus и само когато организацията притежава както пакета, така и добавката „Мобилни приложения“.

Мобилно наслагване
Мобилно наслагване
Мобилното наслагване избира кои карти от пакета и стъпки за въвеждане да се появяват на телефоните и за кои роли. Въведените данни чакат офлайн толкова дълго, колкото организацията позволява, а одобренията изискват ключ за достъп. Предварителният преглед показва точно какво вижда една роля.

Права на ползване: кой притежава пакета и къде се изпълнява той

Пакетът се лицензира, никога не се включва чрез конфигурация. Три слоя решават кой го вижда.

Лицензът. Подписаният лицензионен документ съдържа списък domain_packs с матрични идентификатори (най-много 100, възможно е и да е празен), наред със своите grants и add_ons за групи функции. Конзолата на Adverant няма да издаде пакет без добавките, от които той се нуждае: пакет, който изисква „Зали за решения и запечатани записи“, не може да бъде издаден към лиценз без тази добавка. Групите функции в лиценза се предоставят или за цялата инсталация, или за посочени организации, а проверката за права отговаря за всяка организация поотделно. Премахнете предоставеното право и всеки призма-изглед и екран за телефон на пакета се превръща в тийзър, като записите му се запазват.

Проверката за права. За всяка организация и план, всяка роля и всяко лице проверката за права решава дали дадена контрола, която пакетът добавя, е с предоставени права, показана като тийзър, скрита или отказана с код. Тя управлява редовете в менюто и разделите в панела, както и проверките на маршрутите и диспечирането. Затвореният модул остава авторитетният източник за собственото си предоставено право.

Звена и призма-изгледи. В рамките на организация, която притежава пакета, администраторът решава къде да работи той. Пакетът се включва за дадено звено на етапи, никога за цялото звено наведнъж: проверка на лиценза, пилотна група, предварително зададени настройки, след което разширяване към всички в звеното на дата, избрана от администратора. Преди да се промени каквото и да било, страницата показва кой какво получава, по роли. След това призма-изгледите се дават по роли и по звена в една матрица. Изключването на пакета за дадено звено по-късно запазва всеки запис, който хората са направили; призма-изгледите и шаблоните изчезват и нищо друго не се променя.

Включване на браншови пакет за звено
Включване на браншови пакет за звено
Включването на домейн за дадено звено преминава на етапи – от проверката на лиценза през пилотна група до цялото звено. Администраторът вижда кой какво получава, преди да се промени каквото и да било, а настройките от пилотната фаза се пренасят непроменени.

Десетте пакета

Adverant доставя десет домейн пакета. Всеки от тях се нуждае от базовия лиценз Enterprise, а някои се нуждаят от добавки. Екраните за телефон на всеки пакет се нуждаят също и от добавката „Мобилни приложения“.

Пакет Матричен идентификатор Какво носи От какво още се нуждае
Застраховане insurance Застрахователни призма-изгледи за оценка на риска, претенции, презастраховане, Lloyd's и делегирани правомощия, наред с други; потока за измами и разследвания; пътеки и настройки на застрахователната витрина; компилираните мозъци за застраховане Зали за решения и запечатани записи
Банкиране и разплащания financial-services Регистър на възложените на външни изпълнители технологии; часовници и доклади за технологични инциденти; планове за изход при критични доставчици; решения за кредитиране; оспорвания на картови плащания Нищо извън базата
Капиталови пазари и управление на активи capital-markets Призма-изгледи за анализатора на проучвания, портфолио мениджъра, наблюдението и съответствието и отчитането пред клиенти; записване на разговорите на бюрата за търговия; проучвания, държани зад информационна стена до публикуването им; шаблони за дневника за преминаване на стената, преглед на разговори и публикуване на проучвания. Телефоните получават сутрешния брифинг и одобренията за публикуване, както и известията от наблюдението, но никога поръчки Зали за решения и запечатани записи
Държавно управление и публичен сектор government Претенции за обезщетения и права; заявления за устройствено планиране; заявления за достъп до информация Нищо извън базата
Здравеопазване healthcare-providers Достъп и споделяне на пациентски досиета и заявления за достъп до информация. Без подпомагане на клинични решения Нищо извън базата
Науки за живота life-sciences Отклонения и коригиращи действия; преглед на партидни досиета; валидиран контрол на промените Нищо извън базата
Критична инфраструктура и енергетика energy-and-utilities Часовници и доклади за инциденти; инспекции и дефекти; работни поръчки Нищо извън базата
Отбрана и сигурност defence-and-mission Доклади от терен, обединени с известия от платформата; маркировки за споделяне; дебрифинги. Версията му за телефон се инсталира само чрез управление на устройствата Nexus Edge, за известията от платформата
Правни и професионални услуги legal Призма-изгледи за юриста, работещ по дела, юриста по управление на знанията, конфликти и риск и фактуриране; проверка за конфликт на интереси при всеки нов казус; етични стени, вдигани само от двама съдружници; шаблони за проверка на нов казус, конструктор на стени и напомняния за стени. Телефоните получават отчитане на времето и актуализации по казуси с одобрения, но никога поверителни файлове Зали за решения и запечатани записи, както и Поща
Логистика и морски транспорт logistics-and-maritime Призма-изгледи за оперативния диспечер, митническия служител, мениджъра по превозвачите и пристанищния инспектор; митнически декларации и задържания; проверки за санкции преди първата резервация, като човек освобождава всяко задържане; модел на знания за пристанища и кораби, превозвачи и задържания. Телефоните получават инспекции на площадки и кейови места и митнически задържания, с констатации от дронове Карта и GeoAI

Harrow Port Authority използва пакета „Логистика и морско дело“ и това е този, който бих прочел първо, ако изграждате свой собствен: неговият модел на знания е базата, върху която надгражда примерът с хладилната верига по-горе.

Създаване на собствен пакет

В Enterprise разработчикът започва пакет от „златния път“ в „Започнете нещо ново“ в три стъпки. „За него“ назовава пакета, неговите звена, пакета, върху който надгражда, и правилата, за които трябва да показва доказателства. „Модел на знания“ добавя новите видове обекти върху базовия модел. „Преглед и създаване“ показва плана и след това го следва. Той създава хранилище от шаблона за пакет с манифест, деклариращ до какво има достъп пакетът, и неговите тестове; след това среда за разработка със синтетични разклонения на данни; след това чернова на запис в каталога, която само Вие можете да виждате. Нищо не се създава, докато не натиснете „Създаване“ на последната стъпка. Глава 2.24, „Изграждане на персонализиран вертикален пакет от край до край“, преминава през целия път.

Какво Ви струва един пакет

Пакетът е най-скъпото разширение за притежаване. Неговият модел на знания има версии, от които хората зависят, така че свойство, за което съжалявате, остава във версията, с която е доставено. Неговите призма-изгледи могат само да отнемат, така че роля, която се нуждае от повече, означава разговор за базовия призма-изглед. Неговата карта на доказателствата назовава правила, които собственият Ви юрисконсулт трябва да потвърди, преди някой да се осланя на нея. А клиентът го получава само чрез своя лиценз: можете да изградите най-добрия пакет в бранша и пак да не го включите за нито едно звено, докато лицензът на организацията не го съдържа. В замяна на това тридесетото звено, което го поиска, Ви струва един превключвател и една пилотна фаза.