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

Глава 2.24

Цялостно изграждане на персонализирано вертикално решение

Практически пример за изграждане на домейн пакета за хладилна верига (Cold chain) – от първоначалното задание до работещо издание за всяко звено, заедно с неговия модел на знания, лещи (lenses), умение, плъгин с пълна функционалност и примерни данни. След това – как да разширите вече съществуващ пакет и как да добавите леща към вече публикуван такъв.

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

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

Аз съм Матео Руис, разработчик в Corrán Orbital. По-голямата част от седмицата ми отива за собствения ни софтуер за полезни товари, но тази глава е за задача, която изпълнихме за клиент. Larkfield & Vane застрахова товари, а нарастващ дял от тях пътува в хладилни контейнери. Когато хладилен контейнер загуби брегово захранване на кея, температурата се покачва, товарът се разваля и седмици по-късно следва претенция. Larkfield искаха служителите им да виждат тази верига като едно цяло в Nexus, от повредата в захранването до претенцията, като всяка роля вижда само своята част. Така се появи пакетът Cold chain.

По-нататък описвам изграждането в реда, в който го извършихме, с екраните, файловете и командите. Запазил съм и грешките, защото два от отказите, на които попаднахме, ни научиха повече за платформата, отколкото безпроблемният път. Справочните материали се намират в главите преди тази и аз препращам към тях, вместо да ги повтарям. Най-много разчитах на глава 2.18, Моделът за разширения, и глава 2.23, Домейн пакети, като глава 2.21, Plugin SDK, беше отворена до тях за самия комплект за разработка на софтуер.

Път от ляво надясно, състоящ се от осем полета: „Brief“, „Golden path“, „Knowledge model“, „Lenses“, „Skill and plugin“, „Sample data and preview“, „Release review“, „Promotion“. Под последното поле втори ред от четири по-малки полета, свързани със стрелки, показва стъпките за повишаване: „Dev space“, „Staging“, „Pilot unit (Rotterdam)“, „All units“, с икона на катинар върху всяка стрелка с надпис „gate“. Пунктирана стрелка направо от „Dev space“ към „All units“ е зачертана и означена с GATE_CANNOT_BE_SKIPPED.
Изграждането на Cold chain – от заданието до всяко звено.

Заданието и кой какво прави

Larkfield ми дадоха място за разработчик в своята организация за срока на проекта. Това е важно, защото частен пакет за един клиент се изгражда в инсталацията на този клиент, в нейните пространства за разработка и клонове с данни, с одобренията на нейните служители. Пакет, предназначен за много клиенти, се изгражда по различен начин – в клъстер на издателя само с примерни данни, и този случай е разгледан в глава 2.25, Изграждане за всяко издание.

Заданието се побра на една страница:

  • Хладилни контейнери на кея и на плавателни съдове: тяхното захранване, температурните им отклонения и претенциите, които следват.
  • Две роли за начало: техник по хладилни контейнери на кея и контрольор на студената верига в офиса.
  • Пилотен проект, който първо работи в звеното в Ротердам, а след това преминава във Фликстоу.
  • Доказателства за три набора правила: споразумението ATP за бързоразвалящи се храни, добрата дистрибуторска практика на ЕС за лекарствени продукти и записите за безопасност на храните по HACCP (анализ на опасностите и критични контролни точки). Претенциите по правилата Хага-Висби използват същите записи за отклонения, затова ги отбелязахме за след пилотния проект.

Домейн пакетите са възможност на Enterprise. Larkfield работят с Enterprise, така че пътят за домейн пакет беше отворен за мен. В Community златният път за пакет изобщо не се предлага.

Започнете от препоръчителния път (golden path)

Всичко започва от страницата Започнете нещо ново. Тя предлага шест златни пътя: плъгин, домейн пакет, лещa, платформа, умение и работен процес. Всеки от тях създава хранилище от версиониран шаблон, манифест, който декларира от какво се нуждае създаденото, тестове, пространство за разработка и клонове с данни. Същите пътища работят в конзолата, в командния ред и от вашата IDE (интегрирана среда за разработка), където инструментът на Workbench nexus.create върши същата работа с план, който първо потвърждавате.

Започнете нещо ново
Започнете нещо ново
Шестте златни пътя, всеки с това, което създава, своята команда nexus create и своя фиксиран шаблон. Обърнете внимание на табелката в долната част: манифестът се налага принудително, а не е препоръчителен, и издание, което изисква повече, се задържа, докато двама души не го прегледат.

От тази страница избрахме пътя за домейн пакет, като нарекохме пакета cold-chain, а първото му звено – Rotterdam. Резултатът посочва фиксирания шаблон, domain-pack@1.6.0, и изброява създаденото: хранилището, манифест, деклариращ четири обхвата, две хранилища за данни и нито един външен адрес, 66 теста от шаблона, пространство за разработка в Ротердам, три клона със синтетични данни и чернова на запис в собствения каталог на Larkfield, видима само за мен. Версията на шаблона е фиксирана, а надграждането ѝ по-късно пристига като прегледана промяна, както всяка друга, така че ничий пакет не се променя изневиделица само защото шаблонът се е променил. Въпреки това използвах съветника в конзолата за първия ни пакет, защото той показва плана, преди да създаде каквото и да било.

Стъпка 1: опишете за какво служи пакетът

Съветникът Нов домейн пакет има три стъпки: описание, модел на знанието, и преглед и създаване. Стъпка 1 задава малкото въпроси, които определят всичко след нея.

Поле Какво въведохме Бележка
Име Cold chain Използва се за хранилището и каталога
За какво служи Хладилни контейнери на кея и на плавателни съдове: захранване, температурни отклонения и претенциите, които следват
Отрасъл Логистика и морски транспорт Надгражда пакета Logistics and maritime
Собственик (Owner) Лицето, което го създава Заключено в съветника
Звена Ротердам (пилотен проект) Фликстоу след пилотния проект
Шаблон domain-pack@1.6.0 Заключен; надгражданията идват като прегледани промени
Правила, които обхваща Споразумение ATP, добра дистрибуторска практика на ЕС, записи за безопасност на храните Всяко правило става страница в картата на доказателствата на пакета

Асистентът в страничния панел предложи последния ред, включително уточнението, че претенциите за товари използват повторно същите записи за отклонения. Табелка в долната част на страницата съобщава, че все още нищо не е създадено. Хранилището, пространството за разработка и клоновете с данни се създават едва когато натиснете Създаване на стъпка 3, след като сте видели плана. Можете да запазите чернова и да се върнете по-късно.

Стъпка 2: моделът на знания

Моделът на знанието е наборът от видове обекти, за които пакетът знае, и начинът, по който те са свързани. Cold chain започна от базовия логистичен модел, logistics-base 4.2, импортиран от SDK, който ни даде пет базови вида, върху които да надграждаме (Vessel, Port, Container, Carrier и Shipment). Базовите видове са само за четене в съветника. Ако някой от тях трябва да се промени, той се променя в пакета, който го притежава.

Добавихме пет собствени вида:

Вид Какво представлява Свойства
Хладилен контейнер Контейнер с хладилна инсталация 9
Посещение на съд Един съд на един кейов пост 6
Отклонение Температура извън допустимите граници 8
Захранване Точка за брегово или корабно захранване 4
Придобиване Сума, поискана за развален товар 7
Нов домейн пакет: модел на знанието
Нов домейн пакет: модел на знания
Графът на знанието с пет базови и пет нови вида. Разгледайте свойствата на Отклонение вдясно: всяко свойство получава своя клас още при създаването си, а табелката указва, че сумите по претенции са търговски, така че лещите за техници не могат да ги показват.

Всяко свойство се класифицира още при създаването му. „Докладвано от“ при Отклонение е лично. „Стойност на застрашения товар“, както и сумата и уреждането на претенция, са търговски. В първия ден това изглеждаше като бюрокрация, но по-късно ни спаси два пъти, защото класовете определят какво може да показва една леща, какво се заменя в маскирано копие и какво се скрива в ред от журнала.

Две от нашите връзки достигат до базовия модел: Хладилен контейнер е включен към Захранване, а Претенция се отнася до Shipment. Самият базов модел не се променя. Оттеглено свойство остава във версия 1.0 на модела и отпада едва в по-късна версия, така че нищо, което е било вярно за старите записи, не престава да бъде четимо.

Стъпка 3: преглед и създаване

Стъпка 3 е планът. Той изброява какво ще бъде създадено, обхватите, които манифестът ще декларира, клоновете с данни и пространството за разработка. Потвърждавате плана с вашия ключ за достъп (passkey) и планът получава отпечатък. След това създаването следва точно този план, стъпка по стъпка, и можете да спрете на всяка стъпка и да запазите създаденото.

Планът за Cold chain декларираше четири обхвата:

Обхват Защо е нужен на пакета
Четене на телеметрията на хладилните контейнери Показания за захранване и температура
Записване на отклонения Записва отклонение при нарушаване на границите
Четене на пратки Свързва претенция с нейната пратка
Чернови на бележки по претенции Само чернови; изпраща човек

Хранилищата му за данни бяха графът и записите. Нямаше външни адреси и използваше профила на изолирана среда Standard. Пространството за разработка беше с 4 ядра, 16 GiB памет и 50 GiB хранилище, мрежа, затворена за всичко освен декларираното в манифеста, само подписани образи и прекратяване след 7 дни бездействие. Когато бъде прекратено, дефиницията му остава в хранилището, така че го създавате отново оттам.

Трите клона с данни бяха получени от генератора на синтетични данни. Не бяха копирани клиентски данни. Маскирано копие на Ротердам изисква съгласието на собственика на данните, който в 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 предоставя точно това и нищо повече. Всяко извикване на инструмент се проверява спрямо декларираните обхвати, а външен адрес се блокира, освен ако не е изброен. Можете да прочетете декларацията, както и промяната спрямо последното издание, на страницата Манифест и разрешения на пакета.

Лещи: какво вижда всяка роля

Една леща може единствено да стеснява това, което показва нейната база, и това едно правило оформи нашия дизайн повече от всяко друго. Лещата показва част от това, което показва базовата ѝ леща, а разрешенията продължават да произтичат от ролите: лещата определя какво вижда дадена роля в пакета, а не какво ѝ е позволено да прави.

Лещата Техник по хладилни контейнери стеснява Оперативен контрольор – базовата леща, която Larkfield вече използват за логистична работа. В Конструктора на лещи отмятате картите, полетата и действията, които лещата показва. Елементите, които базата не показва, са заключени.

Част Техник по хладилни контейнери показва Изключено
Карти Хладилни контейнери на кея, отворени отклонения, точки за захранване, посещения на съдове днес Всичко, свързано с претенции
Полета Състояние на захранването, зададена стойност, последно показание, най-висока температура Сума на претенцията (не е в базовата леща), лични полета (изключени по подразбиране)
Действия Записване на причина за отклонение, заявяване на проверка на захранването Промяна на зададена стойност и затваряне на отклонение (само за контрольори), чернова на бележка по претенция
Конструктор на призми
Конструктор на призми
Конструкторът на лещи за Техник по хладилни контейнери, отметнат спрямо своята базова леща. Табелката долу вляво е отказът, който получавате, ако отметнете сума на претенцията: базовата леща не я показва, затова и тази леща не може.

Въпреки това се опитах да добавя сумата на претенцията към лещата за техници, защото един техник я беше поискал. Конструкторът отказа с LENS_CANNOT_WIDEN и не запази нищо. В рамките на лещата няма заобиколен път: изходът е леща върху по-широка база – отделна заявка, по която решава администраторът на организацията. Изключихме я.

Скриването на нещо в леща не го премахва от Nexus. Означава, че тази роля не го вижда. Конструкторът показва до колко души ще достигне една леща в пилотния проект (в нашия случай 29) и води журнал на всяко Добавяне, Промяна и Оттегляне. Лещата се дефинира веднъж за организацията и се предоставя за всяко звено на роля в платформата, така че една и съща леща Техник по хладилни контейнери може да бъде дадена на техниците в Ротердам този месец, а на тези във Фликстоу – следващия.

Умение за изготвяне на бележки по претенции

Контрольорите искаха първа чернова на бележката, която се изпраща на собственика на товара след отклонение. Това е работа с език, затова се изпълнява от модел, а въпросът беше къде да бъде разположена.

В 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-test

SDK се инсталира от https://registry.adverant.ai/npm/ с токена за изтегляне от страницата Токени за изтегляне и команди за инсталиране във вашия акаунт в Adverant. Направете commit на файла 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: платформата изпраща входните данни до нашата собствена Service, в рамките на нашия namespace, и никога до хост, който сме посочили. Маршрутът на получателя е деклариран като 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, Правилата, които всяко разширение наследява, изброява контролните точки.

Примерни данни за тестване

Страницата „Примерни данни за тестване“ предлага три вида клонове:

Вид Какво съдържа Кой одобрява
Синтетични Данни, генерирани от зададени от Вас бройки и структури; нищо не идва от реално звено Никой; те са Ваши
Маскирано копие Копие на звено, в което личните, чувствителните и търговските полета са заменени Собственикът на данните (Priya Natarajan за Rotterdam)
Само схема Структурата на хранилищата, без редове Никой; за миграции

Генерирахме натоварена седмица: около 7 отклонения на всеки 100 хладилни контейнера, което отговаря на натоварен август в Rotterdam. Необичайните случаи имаха по-голямо значение от обема. Поискахме загуба на захранване по време на разтоварване, оставена отворена врата, прекъсване в данните от сензор и две претенции за едно отклонение. Страницата може да предлага необичайни случаи въз основа на причините за отклонения в модела на знанието, но никога от реални записи.

Всеки набор от бройки и структури се запазва като seed, например cold-chain-busy-01, заедно с неговия отпечатък. Един и същ seed дава едни и същи данни, така че всяко тестово изпълнение във всеки клон вижда една и съща седмица. Именно това направи нашите 66 теста повторяеми.

Един клон съществува по подразбиране 72 часа и най-много 14 дни. Поисках да запазим натоварения ни клон за 30 дни по време на дълъг преглед и страницата отказа с BRANCH_LIFE_EXCEEDED. Решението е това, което предлага съобщението: запазете seed-а и създавайте нов клон от него, когато Ви потрябва. Маскираното копие следва същите ограничения, а заявката за него съдържа причина и срок до 14 дни.

Преглед на леща от името на конкретен потребител

Преди някой в Rotterdam да види Cold chain, ние го разгледахме така, както биха го видели те. „Преглед на изглед като конкретно лице“ показва пакета точно както го вижда избрана роля, върху клон с данни, в рамка за преглед с пунктирана граница.

Преглед на изглед като конкретно лице
Преглед на леща от името на конкретен потребител
Cold chain така, както го вижда техник по хладилни контейнери в Rotterdam, върху синтетичен клон. Обърнете внимание на колоната за претенции, отбелязана като „скрито от изгледа“ при всяко отворено отклонение, и на страничния панел, който посочва какво скрива този изглед и защо.

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

Именно в прегледа открихме истинска грешка. Температурната диаграма в изгледа за техници показваше зададената стойност, а редакцията на зададените стойности беше предназначена само за контрольорите. Диаграмата беше наред; бутонът за редакция под нея не беше. Версия 0.3.2 скри редакцията на зададените стойности от техниците, а грешката открихме в прегледа.

Промяна на модела на знания след пускането му

До версия 0.4.0 се нуждаехме от вид Inspection за проверки преди рейс, а релацията „Excursion caused Claim“ звучеше по-добре като „Excursion led to Claim“. Преминаването на модела от 1.3 към 1.4 е промяна в модела на знанието, а страницата „Промени в модела на знанието“ показва разликите, какво би засегнала промяната и на какъв етап е тя.

Промяната се придвижва като заявка за промяна на графа. Пробното ѝ изпълнение преброява какво би засегнала върху маскираното копие на Rotterdam, под формата на бройки: в нашия случай 1,284 преименувани връзки и нищо премахнато. Двама рецензенти я одобряват, а конвейерът я прилага към staging, а след това към пилотното звено. Никой не записва ръчно в споделения граф; всеки опит се отказва и се записва. Три запазени въпроса използваха думата „caused“ и промяната включваше автоматично пренаписване за всеки от тях, което страницата изброи. Филтрите на изгледите не се промениха, тъй като и двата изгледа продължаваха единствено да стесняват.

Прехвърляне в продукционна среда

Всяко издание преминава по един и същ път: dev пространство, staging, пилотно звено, след това всички звена. Всяка стъпка има контролни точки и нищо не пропуска нито една от тях.

Към Контролни точки
Staging Всички тестове са успешни; проверки за качество; манифестът е непроменен или разширяването е прието; подписан образ
Пилотно звено (Rotterdam) Пробно изпълнение на промяната в модела върху маскираното копие без грешки; проверка на политиките за правилата за изгледи и обхват; двама рецензенти, които не са авторът, единият от тях – собственикът на данните
Всички звена 14 дни в пилотното звено; грешки под 1 на 1,000, отчетени в пилотното звено; всеки администратор на звено дава съгласие за своето звено; двама рецензенти, които не са авторът
Среди и повишаване
Среди и повишаване
Cold chain 0.3.2 очаква втория си рецензент на контролната точка за пилотното звено. Съобщението вдясно е отказът при опит за повишаване директно от dev пространство към всички звена.

Веднъж опитах прекия път, в петък, за поправка от един ред: да повиша 0.4.0-dev от моето 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 и може да изисква добавки, а лицензионният документ съдържа тези зависимости. Insurance изисква Decision rooms и запечатани записи, така че клиент, който лицензира пакет, наследяващ го, също се нуждае от тази добавка, а конзолата отказва да издаде лиценз, който я пропуска. Екраните на пакета за телефон изискват и добавката Mobile apps. Проверете веригата от изисквания, преди да обещаете дата на клиент.

Добавяне на леща към вече пуснат пакет

Най-малката вертикална задача е нова леща върху пакет, който не сте писали вие. Шест месеца след началото на пилотния проект екипът по морски щети на Larkfield поиска собствена леща в рамките на Cold chain: само отклонения и щети, без точки на захранване и без зададени стойности. Не пипнахме кода на пакета. Лещата е ред в регистъра на лещите на организацията, притежаван от пакета, затова я стартирахме от златния път за лещи на страницата Start something new и я оформихме в Lens builder спрямо базовата леща Cold-chain controller. Важи същото правило както преди: новата леща може да скрие това, което базовата ѝ показва, но никога не може да покаже повече. Тя се дефинира веднъж за организацията и се предоставя на платформена роля във всяко звено. Предоставеният достъп се оттегля, но никога не се изтрива, а повторното даване на лещата създава ново предоставяне, така че информацията кой коя леща е ползвал и кога остава проследима. Регистърът отчита колко души са ползвали дадена леща всеки месец, но никога кои са те.

Страницата Lenses and who sees them показва резултата като матрица на лещите по звена и роли, с опции Add, Change и Withdraw във всяка клетка. Прегледайте новата леща през погледа на конкретен потребител, преди да я предоставите, точно както е описано по-горе.

Какво струваше реално

Един пакет докосва записите на клиента, затова платформата умишлено забавя някои неща и трябва да планирате това още от първия ден.

  1. Маскираното копие изисква съгласието на собственика на данните всеки път. Нашето отне един ден, за да пристигне първия път, защото Priya искаше първо да прочете модела на знания. Започнете със синтетични данни и заявете достъп рано.
  2. Авторът не може сам да одобри своето издание, а заявките изтичат след 3 дни. Ако рецензентите ви са заети, изданието ви чака.
  3. Издание, което изисква повече права от предишното – като например изпращане на поща или достъп до един външен адрес – се задържа, докато двама рецензенти не приемат разширения манифест. Глава 2.28, Releasing your extension, показва страницата Manifest and permissions, която ви информира за това, преди да изпратите заявката.
  4. Една леща не може да покаже това, което нейната базова леща скрива. Ако дадена роля наистина се нуждае от повече, това е въпрос на разговор с администратора на организацията, а не на настройка.

Нито едно от тези неща не ни забави втори път. Второто издание на Cold chain отне една седмица от първия комит до пилотния проект в Rotterdam, като по-голямата част от времето отиде за изпълнението на 66-те теста срещу три клона и за прегледа на доказателствата от двама души.