Версія 1.0.0-alpha.1найновіша
Розділ 2.23
Галузеві пакети
З чого складається галузевий пакет і що містить його файл pack.json; лінзи (lenses) та реєстр лінз; моделі знань, конектори та мобільні накладки; як пакет ліцензується і вмикається для підрозділу; а також десять пакетів, які постачає Adverant.
Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

Пакет, який я створив у Corrán Orbital, починався як два плагіни та десяток навичок Skills Engine, якими користувалася лише наша команда наземної станції. Коли підрозділ управління польотами попросив про те саме, у мене був вибір: скопіювати все й підтримувати дві версії всього, або перетворити це на галузевий пакет з однією моделлю знань і двома лінзами, що вмикаються окремо для кожного підрозділу. Мені знадобився тиждень, щоб зробити з цього пакет. Завтра я зробив би такий самий вибір, а наступного разу одразу починав би з пакета.
Галузевий пакет переносить спосіб роботи окремої галузі в Nexus. Він містить типи об'єктів цієї галузі, зв'язки між ними, а також те, що бачить кожна роль. Він включає шаблони та робочі процеси, якими люди користуються щодня, доказову базу, якої вимагають галузеві правила, а також екрани, що працюють на телефоні без зв'язку. Він ніколи не змінює оболонку чи її компоненти, а також правила написання. Нова галузь — це пакет, а не окремий застосунок.
З чого складається пакет
В основі пакета лежать чотири складові, і жодна з них не є кодом, написаним спеціально під пакет у самій платформі:
- Набір груп функцій у перевірці прав доступу. Елементи керування пакета належать до набору груп функцій. Кожен рядок меню та вкладка панелі, які додає пакет, визначаються тим самим механізмом, що й решта Nexus: доступно за правом, показано як тизер або приховано.
- Маніфест пакета,
pack.json, який оголошує кластери екранів пакета та його терміни, його лінзи та екрани для телефона. - Закриті модулі, які самостійно перевіряють власний дозвіл. Серверний код, який ухвалює рішення, наприклад скомпільовані ядра логіки пакета, містить усередині верифікатор ліцензії та сам перевіряє підписану ліцензію. Ніщо ззовні модуля не може його увімкнути.
- Запис у каталозі, завдяки якому пакет з'являється на сторінці «Галузеві пакети» з описом того, що він додає і чого потребує.
Поверх цього розташовані частини, які бачать користувачі: модель знань і лінзи; шаблони, робочі процеси та навички Skills Engine; конектори лише для читання до систем, де вже зберігаються записи, карта доказів від кожного правила до записів, які йому відповідають, а також мобільний оверлей.
Файл 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_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 з особистим bearer-токеном користувача. Організація, особа та робоче місце в підрозділі визначаються виключно з перевіреного токена і ні з чого іншого.
| Метод і шлях | Що він робить |
|---|---|
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, причому його причина записується в журнал сервісу і ніколи не передається у відповіді.
Модель знань, конектори та скомпільовані бази знань (brains)
Модель знань — це типи об'єктів, про які знає пакет, і те, як вони пов'язані між собою. Вона підтримує версійність, і пакет зазвичай будується на базовій моделі з пакета, від якого він успадковується: пакет холодового ланцюга на базовій моделі логістики додає п'ять типів (серед яких рефрижераторна установка та суднозахід) і пов'язує два з них із базою, не змінюючи самої бази. Кожна властивість класифікується під час створення, тому персональні та комерційні поля відомі ще до того, як їх використає будь-яка лінза чи гілка даних. Відтак лінза для техніків не зможе показати суму вимоги, класифіковану як комерційна. Відкликана властивість залишається у версії, де вона була, і зникає лише в наступній версії. Під час підготовки нової версії спочатку копіюються знання, а можливість відкату залишається відкритою протягом установленого періоду.
Конектори імпортують записи із систем, де вони вже зберігаються: системи адміністрування полісів, системи врегулювання вимог, поштової теки з файлами, які надсилають партнери. Кожен конектор працює лише на читання, запускається за власним розкладом і має кнопку перевірки. Під час входу записи зіставляються з термінами пакета й потрапляють у модель знань, яку читають лінзи; відповіді асистента посилаються на неї. Із 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 |
Лінзи для юриста, що веде справи клієнтів (fee earner), юриста з управління знаннями, фахівця з конфліктів інтересів і ризиків, а також білінгу; перевірка конфлікту інтересів під час відкриття кожної нової справи; етичні бар'єри, які знімаються лише двома партнерами; шаблони для перевірки нової справи, конструктора бар'єрів і нагадувань про бар'єри. На телефони доступні облік часу та оновлення щодо справ із погодженнями, але ніколи — файли, захищені адвокатською таємницею | Кімнати рішень та запечатані записи (Decision rooms and sealed records), а також Пошта (Mail) |
| Логістика та морські перевезення | logistics-and-maritime |
Лінзи для контролера операцій, митного інспектора, менеджера по роботі з перевізниками та портового інспектора; митні декларації та затримання вантажів; перевірки за санкційними списками перед першим бронюванням, де кожне затримання знімає відповідальна особа; модель знань портів і суден, перевізників і затримань. На телефонах доступні інспекції терміналів і причалів, а також митні затримання з даними огляду дронами | Карта та GeoAI |
Harrow Port Authority використовує пакет «Логістика та морські перевезення», і саме з ним я раджу ознайомитися насамперед, якщо ви створюєте власний пакет: його модель знань є базою, на якій побудовано наведений вище приклад холодового ланцюга.
Створення власного рішення
У версії Enterprise розробник починає створення пакета за еталонним маршрутом у розділі «Почати щось нове» у три кроки. Крок «Про пакет» задає назву пакета, його підрозділи, пакет, на якому він базується, і правила, відповідність яким він має підтверджувати доказами. Крок «Модель знань» додає нові типи об'єктів поверх базової моделі. Крок «Перевірка та створення» показує план, а потім виконує його. Він створює репозиторій із шаблону пакета з маніфестом, який оголошує, до чого пакет може мати доступ, і його тестами; потім — середовище розробки із синтетичними гілками даних; а після цього — чернетку запису в каталозі, яку бачите лише ви. Нічого не створюється, доки ви не натиснете «Створити» на останньому кроці. Розділ 2.24 «Створення власного галузевого рішення від початку до кінця» детально описує весь цей шлях.
Скільки вам коштує пакет
Пакет — це найдорожче в обслуговуванні розширення. Його модель знань має версії, від яких залежать користувачі, тому властивість, про додавання якої ви пошкодували, залишиться у версії, з якою вона вийшла. Його лінзи можуть лише обмежувати, тому якщо ролі потрібно більше даних, доведеться обговорювати зміну базової лінзи. Його карта доказів посилається на правила, які мають затвердити ваші власні юристи, перш ніж хтось почне на неї покладатися. А клієнт отримує пакет лише через свою ліцензію: ви можете створити найкращий пакет у галузі, але все одно не зможете увімкнути його для жодного підрозділу, доки він не з'явиться в ліцензії організації. Натомість тридцятий підрозділ, який захоче його отримати, коштуватиме вам лише одного перемикача та запуску пілотної групи.




