Версія 1.0.0-alpha.1найновіша
Розділ 2.24
Повний цикл створення власної галузевої вертикалі
Практичний приклад збирання галузевого пакета для холодового ланцюга (Cold chain): від першого технічного завдання до релізу, що працює в кожному підрозділі, включно з моделлю знань, лінзами, навичкою, повнофункціональним плагіном і тестовими даними. А також про те, як розширити вже наявний пакет і як додати лінзу до вже випущеного пакета.
Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

Я Матео Руїс (Mateo Ruiz), розробник у Corrán Orbital. Більшу частину тижня я працюю над нашим власним програмним забезпеченням для корисного навантаження, але цей розділ присвячено проєкту, який ми виконали для клієнта. Компанія Larkfield & Vane страхує вантажі, і дедалі більша їх частка перевозиться в рефрижераторних контейнерах. Коли рефрижератор втрачає берегове живлення на причалі, температура піднімається, вантаж псується, а через кілька тижнів надходить страхова вимога. У Larkfield хотіли, щоб їхні співробітники бачили цей ланцюжок у Nexus як єдине ціле — від збою живлення до страхової вимоги, причому кожна роль мала бачити лише свою частину. Так з'явився пакет Cold chain.
Далі описано процес розробки в тому порядку, у якому ми його виконували, з екранами, файлами та командами. Я залишив опис наших помилок, оскільки дві отримані відмови системи навчили нас більшого про платформу, ніж успішний сценарій. Довідкові матеріали наведено в попередніх розділах, тому я посилаюся на них, а не повторюю. Найбільше я спирався на розділ 2.18 «Модель розширень» і розділ 2.23 «Галузеві пакети», тримаючи поруч відкритим розділ 2.21 «Plugin SDK» щодо самого набору засобів розробки ПЗ.
Технічне завдання та розподіл ролей
Компанія Larkfield надала мені місце розробника у своїй організації на час реалізації проєкту. Це важливо, оскільки приватний пакет для одного клієнта створюється всередині інсталяції цього клієнта, у його середовищах розробки та гілках даних, з дозволу його співробітників. Пакет, призначений для багатьох клієнтів, створюється інакше — у кластері видавця лише з тестовими даними, і цей випадок розглянуто в розділі 2.25 «Розробка для кожної редакції».
Технічне завдання вмістилося на одній сторінці:
- Рефрижераторні контейнери на причалі та на суднах: їхнє живлення, температурні відхилення та подальші страхові вимоги.
- Дві ролі для початку: технік з обслуговування рефрижераторів на причалі та контролер холодового ланцюга в офісі.
- Пілотний проєкт, який спочатку запускається в підрозділі в Rotterdam, а потім переходить до Felixstowe.
- Доказова база для трьох наборів правил: угоди ATP щодо швидкопсувних харчових продуктів, належної практики дистрибуції (GDP) ЄС для лікарських засобів та записів про безпечність харчових продуктів за системою HACCP (аналіз небезпечних чинників та критичні точки контролю). Страхові вимоги за правилами Гаага-Вісбі використовують ті самі записи про температурні відхилення, тому ми взяли їх до уваги на етап після пілотного проєкту.
Галузеві пакети — це можливість редакції Enterprise. Оскільки Larkfield використовує Enterprise, шлях створення галузевого пакета був для мене відкритим. У редакції Community типовий маршрут (golden path) для створення пакета взагалі не пропонується.
Початок за оптимальним сценарієм
Усе починається на сторінці «Почати щось нове» (Start something new). Вона пропонує шість типових маршрутів: плагін, галузевий пакет, проєкція (lens), платформа, навичка та робочий процес. Кожен із них створює репозиторій із версіонованого шаблону, маніфест з описом потреб компонента, тести, середовище розробки та гілки даних. Ці самі маршрути працюють у консолі, у командному рядку та з вашого IDE (інтегрованого середовища розробки), де інструмент Workbench nexus.create виконує ту саму роботу за планом, який ви попередньо підтверджуєте.
nexus create та закріпленого шаблону. Зверніть увагу на плашку внизу: маніфест є обов'язковим до виконання, а не рекомендаційним, і реліз, який запитує додаткові дозволи, затримується, доки його не перевірять дві особи.На тій сторінці ми обрали маршрут галузевого пакета, назвавши пакет cold-chain, а його перший підрозділ — Rotterdam. У результаті зазначається закріплений шаблон domain-pack@1.6.0 і перелічується створене: репозиторій, маніфест, що оголошує чотири області дії (scopes), два сховища й жодної вихідної адреси, 66 тестів із шаблону, середовище розробки в Rotterdam, три гілки синтетичних даних і чернетка запису у власному каталозі Larkfield, яку бачив лише я. Версію шаблону закріплено, і її подальше оновлення надходить як звичайна зміна, що потребує перевірки, тож нічий пакет не зміниться несподівано через оновлення шаблону. Утім, для нашого першого пакета я скористався майстром у консолі, оскільки він показує план перед тим, як щось створювати.
Крок 1: визначте призначення пакета
Майстер створення нового галузевого пакета (New domain pack) складається з трьох кроків: загальні відомості, модель знань та перевірка і створення. На кроці 1 запитується декілька параметрів, які визначають усе подальше.
| Поле | Що ми ввели | Примітка |
|---|---|---|
| Назва | Cold chain | Використовується для репозиторію та каталогу |
| Призначення | Рефрижераторні контейнери на причалі та на суднах: живлення, температурні відхилення та подальші страхові вимоги | |
| Галузь | Логістика та морські перевезення | Базується на пакеті Logistics and maritime |
| Власник (Owner) | Особа, яка створює | Зафіксовано в майстрі |
| Підрозділи | Rotterdam (пілотний) | Felixstowe після пілотного проєкту |
| Шаблон | domain-pack@1.6.0 |
Зафіксовано; оновлення надходять як зміни з перевіркою |
| Правила, які він відображає | Угода ATP, належна практика дистрибуції ЄС, записи про безпечність харчових продуктів | Кожне правило стає сторінкою на карті доказової бази пакета |
Асистент на бічній панелі запропонував останній рядок, зокрема зауваживши, що вимоги щодо вантажу повторно використовують ті самі записи про температурні відхилення. Плашка внизу сторінки повідомляє, що ще нічого не створено. Репозиторій, середовище розробки та гілки даних створюються лише тоді, коли ви натискаєте «Створити» (Create) на кроці 3 після перегляду плану. Ви можете зберегти чернетку й повернутися пізніше.
Крок 2: модель знань
Модель знань — це набір типів сутностей, про які знає пакет, та зв'язків між ними. Пакет Cold chain починався з базової моделі логістики logistics-base 4.2, імпортованої з SDK, яка надала нам п'ять базових типів для подальшої розбудови (Vessel, Port, Container, Carrier і Shipment). Базові типи в майстрі доступні лише для читання. Якщо один із них потрібно змінити, він змінюється в пакеті, якому належить.
Ми додали п'ять власних типів:
| Тип | Що це таке | Властивості |
|---|---|---|
| Рефрижераторна установка | Рефрижераторний контейнер | 9 |
| Захід судна | Одне судно біля одного причалу | 6 |
| Температурне відхилення | Температура за межами допустимих значень | 8 |
| Електроживлення | Берегова або суднова точка живлення | 4 |
| Прив'язка (Claim) | Кошти, запитані за зіпсований вантаж | 7 |
Кожній властивості призначається клас під час її створення. Властивість «Ким повідомлено» (Reported by) у типі Excursion є персональною. «Вартість вантажу під ризиком» (Cargo value at risk), а також сума вимоги та врегулювання є комерційними. Першого дня це здавалося зайвою бюрократією, але пізніше двічі нас виручило, оскільки класи визначають, що може показувати проєкція, що замінюється в маскованій копії та що приховується в рядку журналу.
Два наші зв'язки ведуть до базової моделі: Reefer unit підключається до Power supply, а Claim посилається на Shipment. Сама базова модель не змінюється. Властивість, яку ви вилучаєте, залишається у версії 1.0 моделі та зникає лише в пізнішій версії, тож жодні дані зі старих записів не втрачають придатності для читання.
Крок 3: перевірка та створення
Крок 3 — це план. У ньому перелічено, що буде створено, які області дії оголосить маніфест, гілки даних і середовище розробки. Ви підтверджуєте план за допомогою свого ключа доступу (passkey), і план отримує цифровий відбиток. Подальше створення відбувається точно за цим планом, крок за кроком, і ви можете зупинитися на будь-якому кроці, зберігши вже створене.
План для Cold chain оголошував чотири області дії:
| Область дії | Навіщо це потрібно пакету |
|---|---|
| Читання телеметрії рефрижераторів | Показники живлення та температури |
| Запис температурних відхилень | Реєструє відхилення у разі порушення допустимих меж |
| Читання відправлень | Пов'язує вимогу з відповідним відправленням |
| Створення чернеток повідомлень про вимоги | Лише чернетки; надсилає людина |
Його сховищами були граф і записи. Він не мав вихідних адрес і використовував профіль пісочниці Standard. Середовище розробки мало 4 ядра, 16 GiB пам'яті та 50 GiB сховища, закриту мережу (за винятком оголошеного в маніфесті), підтримку лише підписаних образів і припинення роботи після 7 днів простою. Коли воно завершує роботу, його визначення залишається в репозиторії, тож ви можете створити його знову звідти.
Три гілки даних надійшли із синтетичного генератора. Жодні дані клієнта не копіювалися. Маскована копія підрозділу Rotterdam потребує згоди власника даних, яким у Larkfield є Прія Натараджан (Priya Natarajan), і ви запитуєте цей дозвіл окремо.
Маніфест пакета
Репозиторій містить маніфест пакета — pack.json. У ньому зазначається назва пакета, його версія, пакет, від якого він успадковує дані (якщо такий є), його кластери та словник. Кластер є або проєкцією (тобто тим, що бачить одна роль усередині пакета), або спільним компонентом, який працює в усіх проєкціях. Ось основа нашого маніфесту:
{
"id": "cold-chain",
"name": "Cold chain",
"version": "0.4.0",
"clusters": [
{
"id": "CC01",
"kind": "lens",
"name": "Reefer technician",
"seats": "Technicians on the quay",
"purpose": "Which reefers have lost power or warmed up, and what to do next.",
"lexicon": ["cold"],
"menu": [],
"screens": []
},
{
"id": "CC02",
"kind": "lens",
"name": "Cold-chain controller",
"seats": "Controllers in the operations office",
"purpose": "Every excursion from first reading to closed claim, with its evidence.",
"lexicon": ["cold"],
"menu": [],
"screens": []
}
],
"lexicon": {
"core": [],
"cold": [
["excursion", "a time when the temperature left its limits", ""],
["set point", "the temperature a reefer is told to hold", ""],
["shore power", "electricity from the quay rather than the ship", ""]
]
}
}Лексикон містить власні терміни пакета з простим поясненням для кожного — достатньо коротким, щоб прочитати на екрані телефона.
Окрім pack.json, маніфест також оголошує, до чого пакет може звертатися: його області дії, сховища, вихідні адреси та профіль пісочниці. Nexus надає доступ виключно до цього й нічого більше. Кожен виклик інструменту перевіряється на відповідність оголошеним областям дії, а зовнішня адреса блокується, якщо її немає в списку. Ознайомитися з цією декларацією та змінами порівняно з попереднім релізом можна на сторінці «Маніфест і дозволи» (Manifest and permissions) пакета.
Лінзи: що бачить кожна роль
Проєкція може лише звужувати те, що показує її базова проєкція, і це єдине правило вплинуло на нашу архітектуру більше за будь-яке інше. Проєкція відображає частину того, що показує її базова проєкція, а дозволи, як і раніше, визначаються ролями: проєкція вирішує, що роль бачить у пакеті, а не те, що їй дозволено робити.
Проєкція Reefer technician звужує базову проєкцію Operations controller, яку Larkfield уже використовує для логістичних операцій. У конструкторі проєкцій (Lens builder) ви позначаєте картки, поля та дії, які має показувати проєкція. Елементи, які базова проєкція не показує, заблоковано.
| Компонент | Що показує проєкція Reefer technician | Що виключено |
|---|---|---|
| Картки | Рефрижераторні установки на причалі, відкриті відхилення, точки живлення, заходи суден сьогодні | Усе, що стосується страхових вимог |
| Поля | Стан живлення, задана температура, останній показник, найвища температура | Сума вимоги (відсутня в базовій проєкції), персональні поля (вимкнено за замовчуванням) |
| Дії | Записати причину відхилення, подати запит на перевірку живлення | Змінити задану температуру та закрити відхилення (лише для контролерів), створити чернетку повідомлення про вимогу |
Я все одно спробував додати суму вимоги до проєкції техніка, бо про це попросив один із техніків. Конструктор відмовив із помилкою LENS_CANNOT_WIDEN і нічого не зберіг. Обхідного шляху всередині проєкції не існує: єдиний варіант — створити проєкцію на ширшій базі, а це інший запит, який розглядає адміністратор організації. Ми залишили це поле поза проєкцією.
Приховування чогось у проєкції не видаляє ці дані з Nexus. Це лише означає, що ця роль їх не бачить. Конструктор показує, скількох людей охопить проєкція в пілотному проєкті (29 у нашому випадку), і веде журнал кожного додавання, зміни та вилучення. Проєкція визначається один раз для організації та надається в межах кожного підрозділу певній ролі платформи, тож ту саму проєкцію Reefer technician можна надати технікам у Rotterdam цього місяця, а наступного — у Felixstowe.
Навичка для складання чернеток нотаток за претензіями
Контролери хотіли мати першу чернетку повідомлення, яке надсилається власнику вантажу після температурного відхилення. Це робота з текстом, тому вона виконується мовною моделлю, і питання полягало в тому, де її розмістити.
У Nexus є два типи навичок, і різниця між ними тут має значення. Навичка маніфесту — це типізований рядок у файлі skills[] плагіна, який викликається платформою. Навичка Skills Engine — це пакет SKILL.md у бібліотеці навичок організації, який агенти, кнопки ШІ (штучного інтелекту), робочі процеси та інструменти розробника запускають в однаковий спосіб. Обидва типи описано в розділі 2.20 «Навички».
Рівень довіри нашого плагіна — community, а плагін рівня спільноти може оголошувати лише ті навички маніфесту, які не звертаються до моделі (host_callback та plugin_queue). Два рівні, які звертаються до AI Provider Router — tool_using та llm_only, — потребують рівня довіри core або verified. Тому створення чернеток повідомлень про вимоги стало навичкою Skills Engine, і маршрутизатор обирає модель із власного пулу Larkfield:
---
name: draft-claim-note
description: Draft a note to a cargo owner about one reefer excursion, from the excursion record and its readings. Drafts only; a person reviews and sends.
allowed-tools: Read, Grep
triggers:
- /draft-claim-note
capabilities:
- name: draft_note
description: Write a first draft for one excursion
version: 1.0.0
---
# Draft a claim note
Use this when a controller asks for a note about one excursion.
## Steps
1. Read the excursion: unit, start, length, highest temperature and cause.
2. Read the shipment it belongs to, for the cargo owner's name.
3. Write four short paragraphs: what happened, when, what the readings show, what happens next.
4. Never state a claim amount. Never send anything.Пакет розміщується в каталозі skills/draft-claim-note/ у репозиторії, причому назва папки збігається з назвою навички. Ми перевірили та завантажили його з термінала:
npm run skill:validate skills/draft-claim-note
npm run skill:upload skills/draft-claim-note --dry-run
npm run skill:upload skills/draft-claim-noteПовторне завантаження того самого вмісту повертає наявну версію, а не створює нову (CONTENT_HASH_ALREADY_PUBLISHED), тому повторний запуск завантаження є безпечним. Перш ніж версія вийде в реліз, Skills Engine запускає її тестові сценарії, пробний тіньовий прогін на минулих завданнях і сліпе рецензування моделлю від іншої компанії з фіксацією часу та вартості кожного запуску.
Повнофункціональний плагін
Пакету також знадобився код, який працює постійно: засіб читання потоку телеметрії рефрижераторів і засіб запису, який відкриває запис про температурне відхилення, коли показник виходить за допустимі межі. Такий код належить до повнофункціонального сервісного плагіна, і ми згенерували його каркас за допомогою власної команди SDK, яка створює все еталонне дерево каталогів із підставленою назвою:
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin scaffold cold-chain --tier full-service
cd cold-chain
npm install
npm ci
npm run typecheck && npm test && npm run build
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testSDK встановлюється з https://registry.adverant.ai/npm/ за допомогою токена завантаження зі сторінки «Токени завантаження та команди встановлення» (Pull tokens and install commands) вашого облікового запису Adverant. Зафіксуйте в репозиторії файл package-lock.json, створений під час першого встановлення; збирання образу запускає npm ci і відмовляється працювати без нього.
Ось частина нашого файлу nexus.manifest.json, яка відрізняється від шаблону. Це не весь файл: згенеровані каркасом блоки description, author, license, runtime, backend та frontend залишаються без змін, і валідатор відхиляє маніфест повнофункціонального сервісу без них. Три речення architecture — це правило, яке повторює кожен плагін, і валідатор перевіряє точність формулювання. UNO у першому з них — це рушій робочих процесів:
{
"manifestVersion": "2",
"name": "cold-chain",
"displayName": "Cold chain",
"version": "0.4.0",
"tier": "full-service",
"trust": "community",
"architecture": {
"compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
"ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
"deploy": "Deploy is through the installation's release channels only."
},
"api": {
"version": "1",
"basePath": "/",
"endpoints": [
{ "method": "GET", "path": "/health", "summary": "Liveness", "auth": "public", "allowAnonymous": true },
{ "method": "GET", "path": "/api/excursions", "summary": "List the unit's excursions", "auth": "scope", "right": "excursion.read", "needsUnit": true },
{ "method": "POST", "path": "/api/excursions", "summary": "Record an excursion", "auth": "scope", "right": "excursion.create", "needsUnit": true },
{ "method": "POST", "path": "/internal/skills/excursion_open", "summary": "host_callback receiver the platform POSTs to", "auth": "internal" }
]
},
"rights": {
"excursion.read": { "summary": "Read the unit's excursions.", "roles": ["owner", "admin", "member", "viewer"] },
"excursion.create": { "summary": "Record an excursion.", "roles": ["owner", "admin", "member"] }
},
"skills": [
{
"id": "excursion_open",
"displayName": "Open an excursion",
"description": "Open an excursion record when a reading breaks its set point limits. No model; runs in the plugin's own backend.",
"tier": "host_callback",
"classification": "tenant",
"dataResidency": "eu",
"inputSchema": { "type": "object", "properties": { "readingId": { "type": "string" } }, "required": ["readingId"] },
"outputSchema": { "type": "object", "properties": { "opened": { "type": "boolean" } }, "required": ["opened"] },
"hostCallback": {
"service": "cold-chain",
"port": 8080,
"path": "/internal/skills/excursion_open",
"maxRequestBytes": 65536,
"maxResponseBytes": 16384,
"tenantHeader": "X-Organization-ID"
},
"timeoutMs": 10000
}
],
"changePolicy": {
"enabled": true,
"classes": ["website", "bff", "migration"],
"approvals": { "website": 1, "bff": 1, "migration": 2 }
}
}excursion_open — це навичка маніфесту з рівнем host_callback: платформа надсилає вхідні дані до нашого власного сервісу всередині нашого простору імен і ніколи — на вказаний нами хост. Маршрут приймача оголошено як auth: internal і захищено за допомогою serviceMiddleware з SDK (варіант захисного механізму для Express), який відхиляє токен виклику, випущений для будь-якого іншого плагіна, організації, навички або маршруту. Його classification має значення tenant, що є максимально допустимим для плагіна спільноти. У розділі 2.27 «Сценарії збирання» окремо розглянуто навичку типу host_callback.
Дві практики з цього етапу варто перейняти. Кожна таблиця містить organization_id, owner_user_id та business_unit_id починаючи з першої міграції, оскільки додавання виміру пізніше потребуватиме міграції робочих рядків. Крім того, ми запускали nexus-gates локально перед кожним відправленням коду (push), адже це та сама команда, яку запускає конвеєр; запуск, який нічого не перевірив, завершується з кодом 2 і повідомляє про це. Контрольні шлюзи перелічено в розділі 2.19 «Правила, які успадковує кожне розширення».
Тестові дані для перевірки
Сторінка «Тестові дані для перевірки» (Sample data for testing) пропонує три типи гілок:
| Тип | Що містить | Хто погоджує |
|---|---|---|
| Синтетичні дані | Дані, згенеровані на основі заданих вами кількостей і структур; жодні дані не беруться з реального підрозділу | Ніхто; вони ваші |
| Маскована копія | Копія підрозділу із заміненими персональними, чутливими та комерційними полями | Власник даних (Priya Natarajan для Rotterdam) |
| Лише схема | Структура сховищ без рядків | Ніхто; для міграцій |
Ми згенерували завантажений тиждень: близько 7 температурних відхилень на кожні 100 рефрижераторів — саме так виглядає насичений серпень у Rotterdam. Нетипові випадки мали більше значення, ніж обсяг. Ми задали втрату живлення під час розвантаження, залишені відчиненими двері, пропуск даних датчика та дві страхові вимоги для одного відхилення. Сторінка може пропонувати нетипові випадки на основі причин відхилень із моделі знань, але ніколи — з реальних записів.
Кожен набір кількостей і структур зберігається як початкове значення (seed), наприклад cold-chain-busy-01, зі своїм цифровим відбитком. Одне й те саме початкове значення дає однакові дані, тому кожен запуск тестів у кожній гілці бачить той самий тиждень. Саме це забезпечило відтворюваність наших 66 тестів.
Гілка існує 72 години за замовчуванням і щонайбільше 14 днів. Я попросив залишити нашу гілку із завантаженим тижнем на 30 днів під час тривалої перевірки, і сторінка відмовила з кодом BRANCH_LIFE_EXCEEDED. Рішення полягає в тому, що пропонує плашка: зберегти початкове значення і створити з нього нову гілку, коли вона вам знадобиться. Маскована копія підпорядковується тим самим обмеженням, а запит на її створення має містити причину та термін дії до 14 днів.
Попередній перегляд лінзи від імені користувача
Перш ніж хтось у Rotterdam побачив пакет Cold chain, ми подивилися на нього їхніми очима. Функція «Попередній перегляд проєкції від імені користувача» (Preview a lens as a person) відображає пакет точно так, як його бачить обрана роль, у гілці даних усередині пунктирної рамки попереднього перегляду.
Три правила роблять попередній перегляд безпечним для вільного використання. Попередній перегляд використовує гілку даних, і ніколи — робочий підрозділ. Ваші власні дозволи не проникають у нього, тому ви бачите лише те, що бачить роль, а не те, що доступно вам. І сеанс завершується через 30 хвилин. Спроба спрямувати попередній перегляд на робочий підрозділ відхиляється з кодом CONNECTION_SCOPE_EXCEEDED; якщо вам потрібні реальні структури даних, попросіть у власника даних масковану копію та запустіть попередній перегляд на ній.
Саме під час попереднього перегляду ми виявили справжню помилку. Графік температури в поданні техніка показував задану температуру, тоді як редагування заданої температури призначалося лише для контролерів. Із самим графіком усе було гаразд, а от із кнопкою редагування під ним — ні. У версії 0.3.2 редагування заданої температури було приховано від техніків, і виявили ми це саме завдяки попередньому перегляду.
Зміна моделі знань після випуску
До версії 0.4.0 нам знадобився тип Inspection для передрейсових перевірок, а зв'язок «Excursion спричинило Claim» (Excursion caused Claim) краще звучав як «Excursion призвело до Claim» (Excursion led to Claim). Перехід моделі з версії 1.3 на 1.4 є зміною моделі знань, і сторінка «Зміни моделі знань» (Knowledge model changes) показує різницю (diff), на що ця зміна вплине і на якому етапі впровадження вона перебуває.
Зміна проходить як запит на зміну графа. Його пробний прогін підраховує, на що це вплине в маскованій копії Rotterdam у кількісному вираженні: у нашому випадку перейменовано 1,284 зв'язки й нічого не видалено. Два рецензенти затверджують зміну, і конвеєр застосовує її до тестового середовища (staging), а потім до пілотного підрозділу. Ніхто не записує дані у спільний граф вручну; така спроба відхиляється і фіксується в журналі. Три збережені запитання використовували слово «caused», і зміна містила автоматичне перезаписування для кожного з них, що було відображено на сторінці. Фільтри проєкцій не змінилися, оскільки обидві проєкції, як і раніше, лише звужували дані.
Перенесення у продуктивне середовище
Кожен реліз рухається одним шляхом: середовище розробки, тестове середовище (staging), пілотний підрозділ, а потім усі підрозділи. Кожен крок має контрольні шлюзи, і жоден із них не можна пропустити.
| Куди | Шлюзи |
|---|---|
| Тестове середовище (Staging) | Усі тести пройдено; перевірки якості; маніфест без змін або розширення прав прийнято; підписаний образ |
| Пілотний підрозділ (Rotterdam) | Пробний прогін зміни моделі на маскованій копії без помилок; перевірка політик щодо правил проєкцій та областей дії; два рецензенти, які не є автором, один із яких — власник даних |
| Усі підрозділи | 14 днів у пілотному підрозділі; рівень помилок менше ніж 1 на 1,000 за підрахунками в пілотному підрозділі; згода адміністратора кожного підрозділу для свого підрозділу; два рецензенти, які не є автором |
Одного разу в п'ятницю я спробував скоротити шлях заради виправлення в один рядок: просунути версію 0.4.0-dev зі свого середовища розробки одразу в усі підрозділи. Запит було відхилено з помилкою GATE_CANNOT_BE_SKIPPED, і нічого не просунулося. Плашка повідомляє, що натомість потрібно перейти до наступного кроку, і це єдиний можливий варіант.
Сама перевірка релізу, доказова база, з якою ознайомлюється другий рецензент, а також канали, які обирають підрозділи, описані в розділі 2.28 «Випуск вашого розширення». Тут варто згадати два факти звідти, оскільки вони визначають те, як ви плануєте галузеве рішення. Автор ніколи не може бути рецензентом, тому команді з двох осіб для кожного релізу потрібна третя людина. Крім того, кожне середовище зберігає попередню версію протягом 30 днів, тож відкат — це перевірена зміна, яку конвеєр виконує приблизно за хвилину.
Розширення вже наявного пакета
Не кожне галузеве рішення починається з нуля. Пакет може успадковувати інший пакет і додавати лише відмінності. Пакет Banking and payments, який використовує Larchmont Bank, є найнаочнішим прикладом у каталозі. Його маніфест починається так:
{
"id": "fintech",
"name": "Banking and payments",
"version": "0.1",
"inherits": "insurance",
"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": []
}
],
"lexicon": {
"core": [],
"fin": [
["APR", "the yearly cost of borrowing, fees included", "exact"],
["mandate", "the most one person may lend alone", ""]
]
}
}Параметр inherits вказує назву пакета, на якому він базується. Пакет Banking and payments зберігає структуру пакета Insurance, його спільні кластери діалогів і базовий словник, додаючи три власні проєкції: Lending decisions, Card disputes та My account. Третім елементом кожного запису в лексиконі є exact для терміна, який має відображатися точно так, як написано, наприклад APR (річна відсоткова ставка), без перефразування.
Деякі речі не можна зробити через успадкування. Пакет ніколи не змінює оболонку, компоненти чи правила написання тексту, тому дочірній пакет не може змінити стиль консолі. Режим регулювання, потрібний кільком пакетам, реалізується як одна спільна проєкція, а не як копія в кожному з них: реєстр переданих на аутсорсинг технологій обслуговує як пакет Insurance, так і Banking and payments. Якщо вашому дочірньому пакету потрібна проєкція, яка вже існує як спільна, використовуйте її замість того, щоб створювати власну.
Ліцензування повторює структуру успадкування. Пакет ліцензується поверх редакції Enterprise і може потребувати додаткових модулів (add-ons), а документ ліцензії містить ці залежності. Пакет Insurance потребує модуля Decision rooms and sealed records, тому клієнту, який ліцензує пакет, що успадковує його, також знадобиться цей додатковий модуль, і консоль відмовиться видати ліцензію без нього. Для екранів пакета, призначених для телефонів, також потрібен додатковий модуль Mobile apps. Перевіряйте весь ланцюжок вимог, перш ніж обіцяти клієнту дату запуску.
Додавання лінзи до вже випущеного пакета
Найменша галузева робота — це нова лінза для пакета, який писали не ви. Через шість місяців після початку пілоту команда морських претензій Larkfield захотіла мати власну лінзу в Cold chain: відхилення та претензії, без точок живлення та без заданих значень. Ми не торкалися коду пакета. Лінза — це рядок у реєстрі лінз організації, що належить пакету, тож ми створили її за еталонним шляхом для лінз на сторінці «Почати щось нове» й налаштували в конструкторі лінз, узявши за основу лінзу контролера Cold chain. Діє те саме правило, що й раніше: нова лінза може приховати те, що показує базова, але ніколи не може показати більше. Її визначають один раз для організації та надають ролі платформи в кожному підрозділі. Надання відкликають, а не видаляють, а повторне надання лінзи створює нове надання, тож завжди можна прочитати, хто й коли мав яку лінзу. Реєстр рахує, скільки людей мали лінзу щомісяця, але ніколи не фіксує, хто саме.
Сторінка «Лінзи та хто їх бачить» показує результат у вигляді матриці «лінза — підрозділ і роль» з діями «Додати», «Змінити» та «Відкликати» в кожній клітинці. Перш ніж надати нову лінзу, перегляньте її від імені конкретної особи, точно так, як описано вище.
Реальна вартість розробки
Пакет працює із записами клієнта, тому платформа навмисно сповільнює деякі процеси, і вам слід враховувати це з першого дня.
- Для замаскованої копії щоразу потрібна згода власника даних. Уперше наша надійшла лише через день, бо Priya спершу хотіла прочитати модель знань. Почніть із синтетичних даних і подавайте запит заздалегідь.
- Автор не може схвалити власний випуск, а запити втрачають чинність через 3 дні. Якщо ваші рецензенти зайняті, ваш випуск чекає.
- Випуск, який запитує більше, ніж попередній, наприклад надсилання пошти або одну зовнішню адресу, затримується, доки два рецензенти не приймуть розширений маніфест. У розділі 2.28 «Випуск вашого розширення» показано сторінку «Маніфест і дозволи», яка повідомляє вам про це ще до подання запиту.
- Лінза не може показати те, що приховує її базова лінза. Якщо ролі справді потрібно більше, це питання для обговорення з адміністратором організації, а не налаштування.
Жодне з цього не завадило нам удруге. Другий випуск Cold chain зайняв тиждень від першого коміту до пілоту в Роттердамі, переважно на виконання 66 тестів у трьох гілках і на те, щоб двоє людей прочитали докази.




