Prihlásiť saRezervovať brífing

Kapitola 2.24

Kompletné zostavenie vlastného odvetvového riešenia

Praktické zostavenie doménového balíka Chladiarenský reťazec, od prvého zadania až po vydanie bežiace pre každú jednotku, vrátane jeho znalostného modelu, pohľadov, zručnosti, komplexného zásuvného modulu a ukážkových dát. Následne sa dozviete, ako rozšíriť už existujúci balík a ako pridať pohľad do balíka, ktorý už bol vydaný.

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

19 min čítania

Som Mateo Ruiz, vývojár v spoločnosti Corrán Orbital. Väčšinu týždňa venujem nášmu vlastnému softvéru pre užitočné zaťaženie, táto kapitola je však o zákazke, ktorú sme robili pre zákazníka. Larkfield & Vane poisťuje náklad a čoraz väčšia časť z neho sa prepravuje v chladiarenských kontajneroch. Keď chladiarenský kontajner na nábreží stratí pobrežné napájanie, teplota stúpa, náklad sa pokazí a o niekoľko týždňov neskôr nasleduje poistná udalosť. Larkfield chcel, aby jeho ľudia videli tento reťazec v Nexus ako jeden celok, od poruchy napájania až po poistnú udalosť, pričom každá rola vidí len svoju časť. Tak vznikol balík Cold chain.

Ďalej nasleduje zostavenie v poradí, v akom sme ho robili, s obrazovkami, súbormi a príkazmi. Chyby som ponechal, pretože dve odmietnutia, na ktoré sme narazili, nás o platforme naučili viac než bezproblémový postup. Referenčný materiál sa nachádza v predchádzajúcich kapitolách a namiesto jeho opakovania na ne odkazujem. Najviac som sa opieral o kapitolu 2.18, Model rozšírení, a kapitolu 2.23, Doménové balíky, pričom vedľa nich som mal otvorenú kapitolu 2.21, Plugin SDK, kvôli samotnej súprave na vývoj softvéru.

Cesta ôsmich políčok zľava doprava: „Zadanie“, „Zlatá cesta“, „Znalostný model“, „Šošovky“, „Skill a plugin“, „Vzorové údaje a náhľad“, „Kontrola vydania“, „Povýšenie“. Pod posledným políčkom druhý rad štyroch menších políčok spojených šípkami zobrazuje kroky povýšenia: „Vývojový priestor“, „Staging“, „Pilotná jednotka (Rotterdam)“, „Všetky jednotky“, s ikonou zámky na každej šípke označenej „brána“. Čiarkovaná šípka z „Vývojový priestor“ priamo na „Všetky jednotky“ je prečiarknutá a označená GATE_CANNOT_BE_SKIPPED.
Zostavenie balíka Cold chain, od zadania po každú jednotku.

Zadanie a rozdelenie úloh

Larkfield mi na dobu trvania projektu pridelil vývojárske miesto vo svojej organizácii. Je to dôležité, pretože súkromný balík pre jedného zákazníka sa zostavuje v inštalácii tohto zákazníka, v jeho vývojových priestoroch a dátových vetvách, so schváleniami jeho ľudí. Balík určený pre mnohých zákazníkov sa zostavuje inak, na klastri vydavateľa len so vzorovými údajmi, a tento prípad pokrýva kapitola 2.25, Zostavovanie pre jednotlivé edície.

Zadanie sa zmestilo na jednu stranu:

  • Chladiarenské kontajnery na nábreží a na plavidlách: ich napájanie, ich teplotné odchýlky a poistné udalosti, ktoré po nich nasledujú.
  • Na začiatok dve roly: technik chladiarenských kontajnerov na nábreží a kontrolór chladiarenského reťazca v kancelárii.
  • Pilotná prevádzka, ktorá beží najprv v jednotke Rotterdam a potom prejde do Felixstowe.
  • Dôkazy pre tri súbory pravidiel: dohodu ATP pre rýchlo sa kaziace potraviny, správnu distribučnú prax EÚ pre lieky a záznamy o bezpečnosti potravín podľa HACCP (analýza rizík a kritické kontrolné body). Nároky podľa Haagsko-Visbyských pravidiel využívajú rovnaké záznamy o odchýlkach, preto sme si ich poznačili na obdobie po pilotnej prevádzke.

Doménové balíky sú funkciou edície Enterprise. Larkfield používa Enterprise, takže cesta doménového balíka mi bola otvorená. V edícii Community sa zlatá cesta pre balík vôbec neponúka.

Začnite ideálnou cestou

Všetko sa začína na stránke Začať niečo nové. Ponúka šesť zlatých ciest: plugin, doménový balík, šošovka, platforma, zručnosť a pracovný postup. Každá z nich vytvorí repozitár z verzionovanej šablóny, manifest, ktorý deklaruje, čo daná vec potrebuje, testy, vývojový priestor a dátové vetvy. Rovnaké cesty fungujú v konzole, v príkazovom riadku aj vo vašom IDE (integrované vývojové prostredie), kde nástroj Workbench nexus.create robí to isté s plánom, ktorý najprv potvrdíte.

Začať niečo nové
Začať niečo nové
Šesť zlatých ciest, každá s tým, čo vytvára, so svojím príkazom nexus create a svojou pripnutou šablónou. Všimnite si štítok v dolnej časti: manifest sa vynucuje, nie je len odporúčaním, a vydanie, ktoré žiada viac, sa pozdrží, kým ho neskontrolujú dvaja ľudia.

Z tejto stránky sme zvolili cestu doménového balíka, balík sme pomenovali cold-chain a jeho prvú jednotku Rotterdam. Výsledok uvádza pripnutú šablónu, domain-pack@1.6.0, a zoznam toho, čo vytvoril: repozitár, manifest deklarujúci štyri rozsahy, dve úložiská a žiadne odchádzajúce adresy, 66 testov zo šablóny, vývojový priestor v Rotterdame, tri syntetické dátové vetvy a návrh položky vo vlastnom katalógu Larkfield, ktorý som videl len ja. Verzia šablóny je pripnutá a jej neskoršia aktualizácia prichádza ako kontrolovaná zmena ako každá iná, takže sa nikomu balík nezmení len preto, že sa zmenila šablóna. Pre náš prvý balík som aj tak použil sprievodcu v konzole, pretože ukáže plán skôr, než čokoľvek vytvorí.

Krok 1: uveďte, na čo balík slúži

Sprievodca Nový doménový balík má tri kroky: o balíku, znalostný model a kontrola a vytvorenie. Krok 1 sa pýta na niekoľko vecí, ktoré určujú všetko ďalšie.

Pole Čo sme zadali Poznámka
Názov Cold chain Používa sa pre repozitár a katalóg
Na čo slúži Chladiarenské kontajnery na nábreží a na plavidlách: napájanie, teplotné odchýlky a poistné udalosti, ktoré po nich nasledujú
Odvetvie Logistika a námorná doprava Stavia na balíku Logistika a námorná doprava
Vlastník Osoba, ktorá ho vytvára V sprievodcovi uzamknuté
Jednotky Rotterdam (pilot) Felixstowe po pilotnej prevádzke
Šablóna domain-pack@1.6.0 Uzamknutá; aktualizácie prichádzajú ako kontrolované zmeny
Pravidlá, ktoré mapuje Dohoda ATP, správna distribučná prax EÚ, záznamy o bezpečnosti potravín Každé pravidlo sa stane stránkou v mape dôkazov balíka

Posledný riadok navrhol asistent v paneli vrátane poznámky, že nároky za náklad opätovne využívajú rovnaké záznamy o odchýlkach. Štítok v dolnej časti stránky uvádza, že zatiaľ sa nič nevytvorilo. Repozitár, vývojový priestor a dátové vetvy sa vytvoria až po stlačení tlačidla Vytvoriť v kroku 3, keď si pozriete plán. Môžete uložiť koncept a vrátiť sa k nemu.

Krok 2: znalostný model

Znalostný model je súbor druhov vecí, o ktorých balík vie, a spôsobu, ako sú prepojené. Cold chain vychádzal zo základného logistického modelu logistics-base 4.2 importovaného zo SDK, ktorý nám poskytol päť základných druhov, na ktorých sme mohli stavať (Vessel, Port, Container, Carrier a Shipment). Základné druhy sú v sprievodcovi len na čítanie. Ak je potrebné niektorý zmeniť, zmení sa v balíku, ktorý ho vlastní.

Pridali sme päť vlastných druhov:

Druh Čo to je Vlastnosti
Chladiarenská jednotka Chladiarenský kontajner 9
Zastavenie plavidla Jedno plavidlo pri jednom kotvisku 6
Odchýlka Teplota mimo svojich limitov 8
Zdroj napájania Pobrežný alebo lodný bod napájania 4
Nárokovanie Peniaze požadované za pokazený náklad 7
Nový doménový balík: znalostný model
Nový doménový balík: znalostný model
Znalostný graf s piatimi základnými a piatimi novými druhmi. Pozrite sa na vlastnosti druhu Odchýlka vpravo: každá vlastnosť nesie svoju triedu už pri vytvorení a štítok uvádza, že sumy nárokov sú obchodné, takže ich šošovky technikov nemôžu zobraziť.

Každá vlastnosť sa klasifikuje pri vytvorení. „Nahlásil“ pri Odchýlke je osobný údaj. „Hodnota ohrozeného nákladu“ a suma a vyrovnanie nároku sú obchodné údaje. Prvý deň to pôsobilo ako byrokracia, neskôr nás to však dvakrát zachránilo, pretože triedy rozhodujú o tom, čo môže šošovka zobraziť, čo maskovaná kópia nahradí a čo riadok protokolu skryje.

Dva z našich vzťahov siahajú do základného modelu: Chladiarenská jednotka je pripojená k Zdroju napájania a Nárok odkazuje na Shipment. Samotný základný model sa nemení. Vlastnosť, ktorú stiahnete, zostáva vo verzii 1.0 modelu a vypadne až v niektorej neskoršej verzii, takže nič, čo platilo pre staré záznamy, neprestane byť čitateľné.

Krok 3: kontrola a vytvorenie

Krok 3 je plán. Uvádza, čo sa vytvorí, rozsahy, ktoré manifest deklaruje, dátové vetvy a vývojový priestor. Plán potvrdíte svojím prístupovým kľúčom (passkey) a plán dostane odtlačok. Vytváranie potom presne sleduje tento plán, krok za krokom, a v ktoromkoľvek kroku ho môžete zastaviť a ponechať si, čo sa vytvorilo.

Plán pre Cold chain deklaroval štyri rozsahy:

Rozsah Prečo ho balík potrebuje
Čítanie telemetrie chladiarenských kontajnerov Údaje o napájaní a teplote
Zápis odchýlok Zaznamená odchýlku pri prekročení limitov
Čítanie zásielok Prepojí nárok s jeho zásielkou
Návrhy poznámok k nárokom Len návrhy; odosiela človek

Jeho úložiskami boli graf a záznamy. Nemal žiadne odchádzajúce adresy a mal profil sandboxu Standard. Vývojový priestor dostal 4 jadrá, 16 GiB pamäte a 50 GiB úložiska, sieť uzavretú okrem toho, čo deklaruje manifest, len podpísané obrazy a ukončenie po 7 dňoch nečinnosti. Keď sa ukončí, jeho definícia zostáva v repozitári, takže ho odtiaľ vytvoríte znova.

Tri dátové vetvy pochádzali zo syntetického generátora. Neskopírovali sa žiadne údaje zákazníkov. Maskovaná kópia Rotterdamu vyžaduje súhlas vlastníka údajov, ktorým je v spoločnosti Larkfield Priya Natarajan, a o ten žiadate samostatne.

Manifest balíka

Repozitár obsahuje manifest balíka, pack.json. Uvádza názov balíka, jeho verziu, balík, z ktorého dedí (ak nejaký), jeho klastre a jeho slová. Klaster je buď šošovka, teda to, čo jedna rola v balíku vidí, alebo zdieľaný klaster, ktorý pôsobí naprieč všetkými šošovkami. Tu je jadro nášho manifestu:

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

Lexikón obsahuje vlastné slová balíka s jednoduchým vysvetlením ku každému, dostatočne krátkym na čítanie v telefóne.

Vedľa pack.json manifest deklaruje aj to, k čomu môže balík pristupovať: jeho rozsahy, úložiská, odchádzajúce adresy a profil sandboxu. Nexus udelí presne to a nič viac. Každé volanie nástroja sa kontroluje voči deklarovaným rozsahom a vonkajšia adresa sa blokuje, pokiaľ nie je uvedená. Deklaráciu aj zmenu oproti poslednému vydaniu si môžete prečítať na stránke Manifest a oprávnenia balíka.

Pohľady: čo vidí každá rola

Šošovka môže to, čo zobrazuje jej základ, vždy iba zúžiť, a toto jediné pravidlo ovplyvnilo náš návrh viac než ktorékoľvek iné. Šošovka zobrazuje časť toho, čo zobrazuje jej základná šošovka, a oprávnenia stále pochádzajú z rolí: šošovka rozhoduje o tom, čo rola v balíku vidí, nie o tom, čo smie robiť.

Šošovka Technik chladiarenských kontajnerov zužuje šošovku Operačný kontrolór, základnú šošovku, ktorú Larkfield už používa na logistickú prácu. V nástroji Lens builder zaškrtnete karty, polia a akcie, ktoré šošovka zobrazuje. Položky, ktoré základ nezobrazuje, sú uzamknuté.

Časť Technik chladiarenských kontajnerov zobrazuje Vynechané
Karty Chladiarenské jednotky na nábreží, otvorené odchýlky, body napájania, dnešné zastavenia plavidiel Čokoľvek o nárokoch
Polia Stav napájania, nastavená hodnota, posledné meranie, najvyššia teplota Suma nároku (nie je v základnej šošovke), osobné polia (predvolene vypnuté)
Akcie Zaznamenať príčinu odchýlky, požiadať o kontrolu napájania Zmeniť nastavenú hodnotu a uzavrieť odchýlku (len kontrolóri), pripraviť návrh poznámky k nároku
Nástroj na tvorbu pohľadov
Nástroj na tvorbu pohľadov
Lens builder pre šošovku Technik chladiarenských kontajnerov, zaškrtnutý voči jej základnej šošovke. Štítok vľavo dole je odmietnutie, ktoré dostanete pri zaškrtnutí sumy nároku: základná šošovka ju nezobrazuje, takže táto šošovka nemôže.

Aj tak som skúsil pridať sumu nároku do šošovky technika, pretože o to technik požiadal. Nástroj to odmietol s LENS_CANNOT_WIDEN a nič neuložil. V rámci šošovky neexistuje žiadne obídenie: cestou vpred je šošovka na širšom základe, čo je iná požiadavka, o ktorej rozhoduje správca organizácie. Vynechali sme ju.

Skrytie niečoho v šošovke to z Nexus neodstráni. Znamená to, že táto rola to nevidí. Nástroj ukazuje, ku koľkým ľuďom sa šošovka v pilotnej prevádzke dostane (v našom prípade 29), a vedie protokol každého pridania, zmeny a stiahnutia. Šošovka sa definuje raz pre organizáciu a prideľuje sa pre každú jednotku platformovej role, takže tú istú šošovku Technik chladiarenských kontajnerov možno tento mesiac prideliť technikom v Rotterdame a budúci mesiac technikom vo Felixstowe.

Zručnosť na prípravu záznamov o škodových udalostiach

Kontrolóri chceli prvý návrh poznámky, ktorá ide vlastníkovi nákladu po odchýlke. To je jazyková práca, takže beží na modeli, a otázkou bolo, kam ju umiestniť.

V Nexus existujú dva druhy zručností a rozdiel je tu dôležitý. Zručnosť manifestu je typovaný riadok v skills[] pluginu, ktorý odosiela platforma. Zručnosť Skills Engine je balík SKILL.md v knižnici zručností organizácie, ktorý agenti, tlačidlá AI (umelá inteligencia), pracovné postupy a vývojárske nástroje spúšťajú rovnakým spôsobom. Obe pokrýva kapitola 2.20, Zručnosti.

Dôveryhodnosť nášho pluginu je community a komunitný plugin môže deklarovať len zručnosti manifestu, ktoré nepristupujú k modelu (host_callback a plugin_queue). Dve úrovne, ktoré pristupujú k AI Provider Router, tool_using a llm_only, vyžadujú dôveryhodnosť core alebo verified. Preto sa z navrhovania poznámok k nárokom stala zručnosť Skills Engine a smerovač vyberá model z vlastného fondu 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.

Balík sa nachádza v skills/draft-claim-note/ v repozitári, pričom názov priečinka sa zhoduje s názvom zručnosti. Overili a nahrali sme ho z terminálu:

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

Opakované nahranie rovnakého obsahu vráti existujúcu verziu namiesto novej (CONTENT_HASH_ALREADY_PUBLISHED), takže opätovné spustenie nahrávania je bezpečné. Pred vydaním verzie Skills Engine spustí jej testovacie prípady, skúšobný beh v tieňovom režime na minulej práci a slepú kontrolu modelom od inej spoločnosti, s časom a nákladmi každého behu.

Komplexný zásuvný modul

Balík potreboval aj kód, ktorý beží neustále: čítač telemetrického kanála chladiarenských kontajnerov a zapisovač, ktorý otvorí záznam o odchýlke, keď meranie prekročí svoje limity. Takýto kód patrí do plnohodnotného servisného pluginu a jeho kostru sme vytvorili vlastným príkazom SDK, ktorý zapíše celý referenčný strom s dosadeným názvom:

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 sa inštaluje z https://registry.adverant.ai/npm/ pomocou tokenu na sťahovanie zo stránky Tokeny na sťahovanie a inštalačné príkazy vo vašom účte Adverant. Commitnite súbor package-lock.json, ktorý zapíše prvá inštalácia; zostavenie obrazu spúšťa npm ci a bez neho odmietne pokračovať.

Tu je časť nášho súboru nexus.manifest.json, ktorá sa líši od šablóny. Nie je to celý súbor: bloky description, author, license, runtime, backend a frontend zo základnej kostry zostávajú nezmenené a validátor odmietne manifest plnej služby bez nich. Tri vety architecture sú pravidlá, ktoré každý plugin opakuje, a validátor kontroluje ich znenie. UNO v prvej z nich je workflow engine:

{
  "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 je skill manifestu s úrovňou host_callback: platforma odošle vstup našej vlastnej službe (Service) v rámci nášho namespace a nikdy nie na hostiteľa, ktorého určíme. Prijímacia trasa je deklarovaná ako auth: internal a chránená pomocou serviceMiddleware zo SDK, čo je Express forma ochrany, ktorá odmietne volací token vydaný pre akýkoľvek iný plugin, organizáciu, skill alebo trasu. Jej classification je tenant, čo je strop pre komunitný plugin. Kapitola 2.27, Scenáre zostavenia, samostatne popisuje skill host_callback.

Z tejto fázy sa oplatí prevziať dva návyky. Každá tabuľka obsahuje organization_id, owner_user_id a business_unit_id od prvej migrácie, pretože pridanie osi neskôr znamená migráciu nad živými riadkami. A pred každým pushom sme lokálne spustili nexus-gates, keďže ide o rovnaký príkaz, aký spúšťa pipeline; beh, ktorý nič neskontroloval, skončí s kódom 2 a oznámi to. Kapitola 2.19, Pravidlá, ktoré dedí každé rozšírenie, uvádza zoznam kontrolných brán.

Ukážkové dáta na testovanie

Stránka Vzorové údaje na testovanie ponúka tri druhy vetiev:

Druh Čo obsahuje Kto súhlasí
Syntetické Údaje vygenerované z počtov a tvarov, ktoré nastavíte; nič nepochádza zo skutočnej jednotky Nikto; je vaša
Maskovaná kópia Kópia jednotky s nahradenými osobnými, citlivými a obchodnými poliami Vlastník údajov (Priya Natarajan pre Rotterdam)
Iba schéma Tvar úložísk bez riadkov Nikto; na migrácie

Vygenerovali sme rušný týždeň: približne 7 odchýlok na každých 100 chladiacich kontajnerov, čo zodpovedá rušnému augustu v Rotterdame. Neobvyklé prípady boli dôležitejšie než objem. Požiadali sme o výpadok napájania počas vykládky, nechané otvorené dvere, výpadok senzora a dve reklamácie k jednej odchýlke. Stránka dokáže navrhnúť neobvyklé prípady na základe príčin odchýlok v znalostnom modeli, nikdy nie zo skutočných záznamov.

Každá sada počtov a tvarov sa uloží ako seed, napríklad cold-chain-busy-01, spolu s jeho odtlačkom. Rovnaký seed poskytne rovnaké údaje, takže každý testovací beh v každej vetve vidí rovnaký týždeň. Práve vďaka tomu boli našich 66 testov opakovateľné.

Vetva štandardne existuje 72 hodín a najviac 14 dní. Počas dlhej kontroly som požiadal o ponechanie našej rušnej vetvy na 30 dní a stránka to odmietla s BRANCH_LIFE_EXCEEDED. Riešenie je to, ktoré navrhuje hlásenie: ponechajte si seed a keď ho potrebujete, vytvorte z neho novú vetvu. Maskovaná kópia sa riadi rovnakými limitmi a jej žiadosť obsahuje dôvod a dĺžku najviac 14 dní.

Náhľad pohľadu v mene konkrétnej osoby

Skôr než ktokoľvek v Rotterdame videl Cold chain, pozreli sme sa naň tak, ako by ho videli oni. Funkcia Náhľad šošovky ako konkrétna osoba vykreslí balík presne tak, ako ho vidí zvolená rola, na dátovej vetve, v čiarkovanom rámci náhľadu.

Náhľad šošovky ako konkrétna osoba
Náhľad pohľadu v mene konkrétnej osoby
Cold chain tak, ako ho vidí technik chladiacich kontajnerov v Rotterdame, na syntetickej vetve. Všimnite si stĺpec reklamácie označený „skryté šošovkou“ pri každej otvorenej odchýlke a bočný panel, ktorý uvádza, čo táto šošovka skrýva a prečo.

Vďaka trom pravidlám možno náhľady bezpečne voľne používať. Náhľad používa dátovú vetvu, nikdy nie živú jednotku. Vaše vlastné oprávnenia sa doň nepremietajú, takže vidíte to, čo vidí rola, a nie to, čo môžete vidieť vy. A po 30 minútach sa ukončí. Nasmerovanie náhľadu na živú jednotku sa odmietne s CONNECTION_SCOPE_EXCEEDED; ak potrebujete skutočné tvary, požiadajte vlastníka údajov o maskovanú kópiu a zobrazte náhľad na nej.

Práve v náhľade sme zachytili skutočnú chybu. Graf teploty v zobrazení technika ukazoval nastavenú hodnotu a úpravy nastavenej hodnoty boli určené len pre kontrolórov. Graf bol v poriadku; tlačidlo úprav pod ním nie. Verzia 0.3.2 skryla úpravy nastavenej hodnoty pred technikmi a práve v náhľade sme to zistili.

Zmena znalostného modelu po vydaní

Vo verzii 0.4.0 sme potrebovali druh Inspection pre kontroly pred prepravou a vzťah „Excursion caused Claim“ znel lepšie ako „Excursion led to Claim“. Presun modelu z 1.3 na 1.4 je zmena znalostného modelu a stránka Zmeny znalostného modelu zobrazuje jej rozdiel, čoho by sa dotkla a kde sa na svojej ceste nachádza.

Zmena putuje ako žiadosť o zmenu grafu. Jej skúšobný beh spočíta, čoho by sa dotkla v maskovanej kópii Rotterdamu, vo forme počtov: v našom prípade 1 284 premenovaných prepojení a žiadne odstránené. Schvália ju dvaja recenzenti a pipeline ju aplikuje na staging, potom na pilot. Nikto nezapisuje do zdieľaného grafu ručne; pokus sa odmietne a zaznamená. Tri uložené otázky používali slovo „caused“ a zmena pre každú z nich obsahovala automatické prepísanie, ktoré stránka uviedla. Filtre šošoviek sa nezmenili, pretože obe šošovky stále iba zužovali.

Povýšenie do produkcie

Každé vydanie prechádza jednou cestou: vývojový priestor, staging, pilotná jednotka a potom všetky jednotky. Každý krok má kontrolné brány a nič žiadnu nepreskočí.

Do Kontrolné brány
Staging Všetky testy prejdú; kontroly kvality; manifest nezmenený alebo rozšírenie prijaté; podpísaný image
Pilot (Rotterdam) Skúšobný beh zmeny modelu na maskovanej kópii bez chýb; kontrola politík pre pravidlá šošoviek a rozsahu; dvaja recenzenti, ktorí nie sú autorom, jeden z nich vlastník údajov
Všetky jednotky 14 dní v pilote; chyby pod 1 z 1 000, počítané v pilote; každý administrátor jednotky súhlasí za svoju jednotku; dvaja recenzenti, ktorí nie sú autorom
Prostredia a povýšenie
Prostredia a povýšenie
Cold chain 0.3.2 čaká pri bráne pilotu na svojho druhého recenzenta. Hlásenie vpravo je odmietnutie pokusu o povýšenie priamo z vývojového priestoru na všetky jednotky.

Raz, v piatok, som skúsil skratku pre jednoriadkovú opravu: povýšiť 0.4.0-dev z môjho vývojového priestoru na všetky jednotky. Bolo to odmietnuté s GATE_CANNOT_BE_SKIPPED a nič nebolo povýšené. Hlásenie vám odporučí povýšiť namiesto toho na ďalší krok a iná odpoveď neexistuje.

Samotná kontrola vydania, dôkazy, ktoré číta druhý recenzent, a kanály, ktoré si jednotky volia, sú v kapitole 2.28, Vydanie vášho rozšírenia. Dve skutočnosti z nej patria sem, pretože ovplyvňujú, ako plánujete vertikálu. Autor sa nikdy nepočíta ako recenzent, takže dvojčlenný tím potrebuje pri každom vydaní tretiu osobu. A každé prostredie uchováva predchádzajúcu verziu 30 dní, takže návrat k nej je skontrolovaná zmena, ktorú pipeline vykoná približne za minútu.

Rozšírenie už existujúceho balíka

Nie každá vertikála začína od nuly. Balík môže dediť z iného a pridať iba to, čo je odlišné. Balík Banking and payments, ktorý prevádzkuje Larchmont Bank, je v katalógu najnázornejším príkladom. Jeho manifest začína takto:

{
  "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 určuje balík, na ktorom stavia. Banking and payments zachováva tvar balíka Insurance, jeho zdieľané konverzačné zoskupenia a základné výrazy a pridáva tri vlastné šošovky: Lending decisions, Card disputes a My account. Tretí prvok každej položky lexikónu je exact pre výraz, ktorý sa musí zobraziť tak, ako je napísaný, napríklad APR (ročná percentuálna miera nákladov), a nie preformulovaný.

Niektoré veci dedením urobiť nemožno. Balík nikdy nemení shell, komponenty ani pravidlá písania, takže podriadený balík nemôže zmeniť štýl konzoly. Režim, ktorý potrebuje viacero balíkov, je jedna zdieľaná šošovka, a nie kópia v každom z nich: register outsourcovaných technológií slúži balíku Insurance aj Banking and payments. Ak váš podriadený balík potrebuje šošovku, ktorá už existuje ako zdieľaná šošovka, použite ju namiesto vytvárania vlastnej.

Licencovanie sa riadi dedením. Balík sa licencuje nad edíciou Enterprise a môže vyžadovať doplnky, pričom licenčný dokument tieto závislosti obsahuje. Insurance vyžaduje doplnok Decision rooms and sealed records, takže zákazník licencujúci balík, ktorý z neho dedí, potrebuje tento doplnok tiež, a konzola odmietne vydať licenciu, ktorá ho vynecháva. Obrazovky balíka pre telefón navyše vyžadujú doplnok Mobile apps. Skôr než zákazníkovi prisľúbite termín, skontrolujte reťazec požiadaviek.

Pridanie pohľadu do balíka, ktorý už bol vydaný

Najmenšou prácou na vertikále je nová šošovka na balíku, ktorý ste nenapísali. Šesť mesiacov po začatí pilotu chcel tím Larkfield pre námorné poistné udalosti vlastnú šošovku v rámci Cold chain: odchýlky a reklamácie, bez napájacích bodov a nastavených hodnôt. Kódu balíka sme sa nedotkli. Šošovka je riadok v registri šošoviek organizácie, vlastnený balíkom, takže sme ju založili zo zlatej cesty pre šošovky na stránke Start something new a v Lens builderi sme ju vytvarovali s šošovkou Cold-chain controller ako základom. Platí rovnaké pravidlo ako predtým: nová šošovka môže skryť to, čo jej základ zobrazuje, a nikdy nemôže zobraziť viac. Definuje sa raz pre organizáciu a v každej jednotke sa udelí niektorej role platformy. Udelenie sa odvoláva, nikdy nemaže, a opätovné pridelenie šošovky vytvorí nové udelenie, takže zostáva čitateľné, kto mal ktorú šošovku a kedy. Register počíta, koľko ľudí malo šošovku v každom mesiaci, nikdy nie kto.

Stránka Šošovky a kto ich vidí zobrazuje výsledok ako maticu šošoviek podľa jednotky a roly s akciami Add, Change a Withdraw v každej bunke. Pred udelením novej šošovky si zobrazte jej náhľad ako konkrétna osoba, presne ako vyššie.

Koľko to reálne stálo

Balík pracuje so záznamami zákazníka, preto platforma niektoré veci zámerne spomaľuje a s tým by ste mali počítať od prvého dňa.

  1. Maskovaná kópia vyžaduje zakaždým súhlas vlastníka údajov. Tá naša prvýkrát prišla až po dni, pretože Priya si chcela najprv prečítať znalostný model. Začnite so syntetickými údajmi a požiadajte včas.
  2. Autor nemôže schváliť vlastné vydanie a žiadosti po 3 dňoch prepadnú. Ak sú vaši recenzenti zaneprázdnení, vaše vydanie čaká.
  3. Vydanie, ktoré žiada viac než predchádzajúce, napríklad odosielanie pošty alebo jednu externú adresu, sa pozdrží, kým dvaja recenzenti neprijmú rozšírený manifest. Kapitola 2.28, Vydanie vášho rozšírenia, ukazuje stránku Manifest a oprávnenia, ktorá vás na to upozorní skôr, než o to požiadate.
  4. Šošovka nemôže zobraziť to, čo jej základná šošovka skrýva. Ak rola skutočne potrebuje viac, je to vec rozhovoru s administrátorom organizácie, nie nastavenia.

Nič z toho nám neprekážalo dvakrát. Druhé vydanie Cold chain trvalo od prvého commitu po pilot v Rotterdame týždeň, z toho väčšinu zabralo 66 testov bežiacich proti trom vetvám a dvaja ľudia čítajúci dôkazy.