Verze 1.0.0-alpha.1nejnovější
Kapitola 2.24
Kompletní vytvoření vlastní vertikály od začátku do konce
Praktická ukázka sestavení doménového balíčku Cold chain, od prvního zadání až po vydání běžící v každé jednotce, včetně znalostního modelu, pohledů, dovednosti, plnohodnotného pluginu a vzorových dat. Následuje postup, jak rozšířit již existující balíček a jak přidat pohled do již vydaného balíčku.
Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

Jsem Mateo Ruiz, vývojář ve společnosti Corrán Orbital. Většinu týdne trávím nad naším vlastním softwarem pro užitečná zatížení, tato kapitola však pojednává o zakázce, kterou jsme realizovali pro zákazníka. Larkfield & Vane pojišťuje náklad a stále větší část z něj se přepravuje v chladírenských kontejnerech. Když chladírenský kontejner na nábřeží ztratí napájení z pobřežní sítě, teplota stoupá, náklad se kazí a o několik týdnů později přichází pojistná událost. Larkfield chtěl, aby jeho lidé viděli tento řetězec v Nexus jako jeden celek, od výpadku napájení až po pojistnou událost, přičemž každá role vidí pouze svou část. Tak vznikl balíček Cold chain.
Následuje popis sestavení v pořadí, v jakém jsme ho prováděli, včetně obrazovek, souborů a příkazů. Chyby jsem zde ponechal, protože dvě odmítnutí, na která jsme narazili, nás o platformě naučila více než bezproblémový průběh. Referenční materiály jsou v předchozích kapitolách a místo jejich opakování na ně odkazuji. Nejvíce jsem se opíral o kapitolu 2.18, Model rozšíření, a kapitolu 2.23, Doménové balíčky, a vedle nich jsem měl otevřenou kapitolu 2.21, Plugin SDK, kvůli samotné sadě pro vývoj softwaru.
Zadání a rozdělení rolí
Larkfield mi na dobu trvání projektu přidělil vývojářské místo ve své organizaci. To je důležité, protože soukromý balíček pro jednoho zákazníka se sestavuje v instalaci tohoto zákazníka, v jeho vývojových prostorech a datových větvích a se schválením jeho lidí. Balíček určený pro mnoho zákazníků se sestavuje jinak, na clusteru vydavatele pouze s ukázkovými daty, a tomuto případu se věnuje kapitola 2.25, Sestavení pro jednotlivé edice.
Zadání se vešlo na jednu stránku:
- Chladírenské kontejnery na nábřeží a na plavidlech: jejich napájení, jejich teplotní odchylky a pojistné události, které následují.
- Pro začátek dvě role: technik chladírenských kontejnerů na nábřeží a kontrolor chladicího řetězce v kanceláři.
- Pilotní provoz, který nejprve běží v jednotce Rotterdam a poté přejde do Felixstowe.
- Doklady pro tři soubory pravidel: dohodu ATP pro potraviny podléhající zkáze, správnou distribuční praxi EU pro léčivé přípravky a záznamy o bezpečnosti potravin podle HACCP (analýza rizik a kritické kontrolní body). Pojistné události podle Haagsko-visbyských pravidel využívají stejné záznamy o odchylkách, proto jsme si je poznamenali na dobu po pilotním provozu.
Doménové balíčky jsou funkcí edice Enterprise. Larkfield používá Enterprise, takže cesta doménového balíčku pro mě byla otevřená. V edici Community se zlatá cesta pro balíček vůbec nenabízí.
Začněte na doporučené cestě
Vše začíná na stránce Začít něco nového. Nabízí šest zlatých cest: plugin, doménový balíček, lens, platforma, skill a workflow. Každá z nich vytvoří z verzované šablony repozitář, manifest deklarující, co daná věc potřebuje, testy, vývojový prostor a datové větve. Tytéž cesty fungují v konzoli, na příkazovém řádku i z vašeho IDE (integrovaného vývojového prostředí), kde nástroj Workbench nexus.create dělá totéž s plánem, který nejprve potvrdíte.
nexus create a její pevně nastavená šablona. Všimněte si štítku v dolní části: manifest je vynucován, nikoli pouze doporučen, a vydání, které žádá o více, je pozdrženo, dokud jej nezkontrolují dvě osoby.Z této stránky jsme zvolili cestu doménového balíčku, balíček jsme pojmenovali cold-chain a jeho první jednotku Rotterdam. Výsledek uvádí pevně nastavenou šablonu domain-pack@1.6.0 a vypisuje, co vytvořil: repozitář, manifest deklarující čtyři rozsahy, dvě úložiště a žádné odchozí adresy, 66 testů ze šablony, vývojový prostor v Rotterdamu, tři syntetické datové větve a koncept záznamu ve vlastním katalogu společnosti Larkfield, který jsem viděl pouze já. Verze šablony je pevně nastavena a její pozdější upgrade přichází jako kontrolovaná změna jako kterákoli jiná, takže se nikomu balíček nezmění jen proto, že se změnila šablona. Pro náš první balíček jsem přesto použil průvodce v konzoli, protože plán zobrazí dříve, než cokoli vytvoří.
Krok 1: určete, k čemu balíček slouží
Průvodce Nový doménový balíček má tři kroky: o balíčku, znalostní model a kontrola a vytvoření. Krok 1 se ptá na několik věcí, které určují vše, co následuje.
| Pole | Co jsme zadali | Poznámka |
|---|---|---|
| Název | Cold chain | Používá se pro repozitář a katalog |
| K čemu slouží | Chladírenské kontejnery na nábřeží a na plavidlech: napájení, teplotní odchylky a pojistné události, které následují | |
| Odvětví | Logistika a námořní doprava | Navazuje na balíček Logistika a námořní doprava |
| Vlastník | Osoba, která jej vytváří | V průvodci uzamčeno |
| Jednotky | Rotterdam (pilotní provoz) | Felixstowe po pilotním provozu |
| Šablona | domain-pack@1.6.0 |
Uzamčeno; upgrady přicházejí jako kontrolované změny |
| Pravidla, která mapuje | Dohoda ATP, správná distribuční praxe EU, záznamy o bezpečnosti potravin | Každé pravidlo se stane stránkou v mapě dokladů balíčku |
Poslední řádek navrhl asistent v doku, včetně poznámky, že pojistné události týkající se nákladu znovu využívají stejné záznamy o odchylkách. Štítek v dolní části stránky uvádí, že zatím nic není vytvořeno. Repozitář, vývojový prostor a datové větve se vytvoří až po stisknutí tlačítka Vytvořit v kroku 3, poté co plán uvidíte. Můžete uložit koncept a vrátit se k němu.
Krok 2: znalostní model
Znalostní model je soubor druhů věcí, o kterých balíček ví, a způsobů, jakými jsou propojeny. Cold chain vycházel ze základního logistického modelu logistics-base 4.2 importovaného ze SDK, který nám poskytl pět základních druhů, na nichž jsme mohli stavět (Vessel, Port, Container, Carrier a Shipment). Základní druhy jsou v průvodci jen pro čtení. Pokud je třeba některý změnit, mění se v balíčku, který jej vlastní.
Přidali jsme pět vlastních druhů:
| Druh | Co to je | Vlastnosti |
|---|---|---|
| Chladírenská jednotka | Chladírenský kontejner | 9 |
| Zastávka plavidla | Jedno plavidlo u jednoho kotviště | 6 |
| Odchylka | Teplota mimo stanovené meze | 8 |
| Napájení | Přípojné místo pobřežního nebo lodního napájení | 4 |
| Nárokování | Peníze požadované za zkažený náklad | 7 |
Každé vlastnosti se třída přiřadí již při jejím vytváření. „Nahlásil“ u Odchylky je osobní údaj. „Hodnota ohroženého nákladu“ a částka a vypořádání pojistné události jsou obchodní. První den to působilo jako papírování, později nás to však dvakrát zachránilo, protože třídy rozhodují o tom, co smí lens zobrazit, co maskovaná kopie nahradí a co řádek protokolu skryje.
Dvě z našich relací zasahují do základního modelu: Chladírenská jednotka je připojena k Napájení a Pojistná událost odkazuje na Shipment. Samotný základní model se nemění. Vlastnost, kterou stáhnete, zůstává ve verzi 1.0 modelu a odstraní se až v pozdější verzi, takže nic, co platilo o starých záznamech, nepřestane být čitelné.
Krok 3: kontrola a vytvoření
Krok 3 je plán. Uvádí, co bude vytvořeno, rozsahy, které manifest deklaruje, datové větve a vývojový prostor. Plán potvrdíte svým přístupovým klíčem a plán získá otisk. Vytváření pak tento plán přesně následuje, krok za krokem, a můžete se zastavit u kteréhokoli kroku a ponechat si to, co již bylo vytvořeno.
Plán pro Cold chain deklaroval čtyři rozsahy:
| Rozsah | Proč jej balíček potřebuje |
|---|---|
| Čtení telemetrie chladírenských kontejnerů | Údaje o napájení a teplotě |
| Zápis odchylek | Zaznamená odchylku při překročení mezí |
| Čtení zásilek | Propojí pojistnou událost s její zásilkou |
| Koncepty poznámek k pojistným událostem | Pouze koncepty; odesílá člověk |
Jeho úložišti byly graf a záznamy. Neměl žádné odchozí adresy a měl profil sandboxu Standard. Vývojový prostor měl 4 jádra, 16 GiB paměti a 50 GiB úložiště, síť uzavřenou s výjimkou toho, co deklaruje manifest, pouze podepsané image a ukončení po 7 dnech nečinnosti. Po jeho ukončení zůstává jeho definice v repozitáři, takže jej odtud vytvoříte znovu.
Tři datové větve pocházely ze syntetického generátoru. Nebyla zkopírována žádná zákaznická data. Maskovaná kopie Rotterdamu vyžaduje souhlas vlastníka dat, kterým je ve společnosti Larkfield Priya Natarajan, a žádá se o něj samostatně.
Manifest balíčku
Repozitář obsahuje manifest balíčku pack.json. Uvádí název balíčku, jeho verzi, balíček, ze kterého dědí (pokud nějaký), jeho clustery a jeho slova. Cluster je buď lens, tedy to, co jedna role vidí uvnitř balíčku, nebo sdílený, který prochází všemi lensy. Zde je jádro našeho 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", ""]
]
}
}Lexikon obsahuje vlastní slova balíčku, každé s jednoduchým výkladem, dostatečně krátkým pro čtení na telefonu.
Vedle pack.json manifest deklaruje také to, k čemu má balíček přístup: jeho rozsahy, úložiště, odchozí adresy a profil sandboxu. Nexus udělí přesně to a nic víc. Každé volání nástroje se kontroluje vůči deklarovaným rozsahům a externí adresa je blokována, pokud není uvedena. Deklaraci i změnu oproti poslednímu vydání si můžete přečíst na stránce balíčku Manifest a oprávnění.
Pohledy: co vidí jednotlivé role
Lens může vždy pouze zúžit to, co zobrazuje jeho základ, a toto jediné pravidlo ovlivnilo náš návrh více než kterékoli jiné. Lens zobrazuje část toho, co zobrazuje jeho základní lens, a oprávnění stále vycházejí z rolí: lens rozhoduje o tom, co role v balíčku vidí, nikoli o tom, co smí dělat.
Lens Technik chladírenských kontejnerů zužuje lens Provozní kontrolor, základní lens, který Larkfield již používá pro logistickou práci. V nástroji Lens builder zaškrtnete karty, pole a akce, které lens zobrazuje. Položky, které základ nezobrazuje, jsou uzamčeny.
| Část | Technik chladírenských kontejnerů zobrazuje | Vynecháno |
|---|---|---|
| Karty | Chladírenské jednotky na nábřeží, otevřené odchylky, přípojná místa napájení, dnešní zastávky plavidel | Cokoli týkající se pojistných událostí |
| Pole | Stav napájení, nastavená hodnota, poslední údaj, nejvyšší teplota | Částka pojistné události (není v základním lensu), osobní pole (ve výchozím nastavení vypnuta) |
| Akce | Zaznamenat příčinu odchylky, požádat o kontrolu napájení | Změnit nastavenou hodnotu a uzavřít odchylku (pouze kontroloři), vytvořit koncept poznámky k pojistné události |
Přesto jsem se pokusil přidat částku pojistné události do lensu pro techniky, protože o ni jeden technik požádal. Builder odmítl s chybou LENS_CANNOT_WIDEN a nic neuložil. Uvnitř lensu neexistuje žádné obejití: cestou vpřed je lens na širším základu, což je jiný požadavek, o kterém rozhoduje administrátor organizace. Vynechali jsme ji.
Skrytí něčeho v lensu to z Nexus neodstraní. Znamená to, že tato role to nevidí. Builder ukazuje, kolik lidí lens v pilotním provozu osloví (v našem případě 29), a vede protokol každého přidání, změny a stažení. Lens se definuje jednou pro organizaci a uděluje se pro jednotlivé jednotky roli platformy, takže tentýž lens Technik chladírenských kontejnerů lze tento měsíc přidělit technikům v Rotterdamu a příští měsíc technikům ve Felixstowe.
Dovednost pro přípravu návrhů záznamů o škodách
Kontroloři chtěli první koncept poznámky, která po odchylce odchází vlastníkovi nákladu. To je jazyková práce, takže běží na modelu, a otázkou bylo, kam ji umístit.
V Nexus existují dva druhy skillů a rozdíl mezi nimi je zde podstatný. Manifestový skill je typovaný řádek v souboru skills[] pluginu, který spouští platforma. Skill Skills Engine je balíček SKILL.md v knihovně skillů organizace, který agenti, tlačítka AI (umělé inteligence), workflow i vývojářské nástroje spouštějí stejným způsobem. Oběma se věnuje kapitola 2.20, Skills.
Důvěryhodnost našeho pluginu je community a komunitní plugin smí deklarovat pouze manifestové skilly, které nepřistupují k modelu (host_callback a plugin_queue). Dvě úrovně, které přistupují k AI Provider Router, tool_using a llm_only, vyžadují důvěryhodnost core nebo verified. Vytváření konceptů poznámek k pojistným událostem se proto stalo skillem Skills Engine a router vybírá model z vlastního fondu společnosti 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íček se nachází v skills/draft-claim-note/ v repozitáři, přičemž název složky odpovídá názvu skillu. Ověřili jsme jej a nahráli 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-noteOpakované nahrání stejného obsahu vrátí existující verzi namísto nové (CONTENT_HASH_ALREADY_PUBLISHED), takže opakované spuštění nahrávání je bezpečné. Před vydáním verze spustí Skills Engine její testovací případy, zkušební běh ve stínovém režimu na minulé práci a slepou kontrolu modelem od jiné společnosti, s časem a náklady každého běhu.
Plnohodnotný plugin
Balíček také potřeboval kód, který běží nepřetržitě: čtečku datového toku telemetrie chladírenských kontejnerů a zapisovač, který otevře záznam o odchylce, když údaj překročí své meze. Takový kód patří do plnohodnotného servisního pluginu a jeho kostru jsme vytvořili vlastním příkazem SDK, který zapíše celý referenční strom s dosazeným názvem:
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 se instaluje z https://registry.adverant.ai/npm/ pomocí tokenu pro stahování ze stránky Tokeny pro stahování a instalační příkazy ve vašem účtu Adverant. Soubor package-lock.json, který zapíše první instalace, zapište do repozitáře commitem; sestavení image spouští npm ci a bez něj odmítne pokračovat.
Zde je ta část našeho nexus.manifest.json, která se liší od šablony. Nejde o celý soubor: bloky description, author, license, runtime, backend a frontend ze šablony zůstávají beze změny a validátor manifest plnohodnotné služby bez nich odmítne. Tři věty architecture jsou pravidla, která každý plugin opakuje, a validátor kontroluje jejich znění. UNO v první z nich je engine pracovních postupů:
{
"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 úrovní host_callback: platforma odesílá vstup naší vlastní službě (Service) uvnitř našeho namespace a nikdy na hostitele, kterého určíme. Přijímací trasa je deklarována jako auth: internal a chráněna pomocí serviceMiddleware ze SDK, tedy podoby této ochrany pro Express, která odmítne volací token vydaný pro jakýkoli jiný plugin, organizaci, skill nebo trasu. Její classification je tenant, což je horní hranice pro komunitní plugin. Kapitola 2.27, Scénáře sestavení, samostatně popisuje skill host_callback.
Dva návyky z této fáze stojí za převzetí. Každá tabulka nese organization_id, owner_user_id a business_unit_id již od první migrace, protože pozdější přidání osy znamená migraci nad živými řádky. A před každým pushem jsme lokálně spouštěli nexus-gates, protože jde o stejný příkaz, který spouští pipeline; běh, který nic neprověřil, skončí s kódem 2 a oznámí to. Kapitola 2.19, Pravidla, která dědí každé rozšíření, uvádí jednotlivé brány.
Vzorová data pro testování
Stránka Ukázková data pro testování nabízí tři druhy větví:
| Druh | Co obsahuje | Kdo dává souhlas |
|---|---|---|
| Syntetická | Data generovaná z počtů a tvarů, které nastavíte; nic nepochází ze skutečné jednotky | Nikdo; je vaše |
| Maskovaná kopie | Kopie jednotky s nahrazenými osobními, citlivými a obchodními poli | Vlastník dat (pro Rotterdam Priya Natarajan) |
| Pouze schéma | Struktura úložišť bez řádků | Nikdo; pro migrace |
Vygenerovali jsme rušný týden: zhruba 7 odchylek na každých 100 chladicích kontejnerů, což odpovídá rušnému srpnu v Rotterdamu. Neobvyklé případy byly důležitější než objem. Požadovali jsme výpadek napájení během vykládky, ponechané otevřené dveře, výpadek senzoru a dva nároky na jednu odchylku. Stránka umí navrhnout neobvyklé případy podle příčin odchylek ve znalostním modelu, nikdy ze skutečných záznamů.
Každá sada počtů a tvarů se ukládá jako seed, například cold-chain-busy-01, spolu se svým otiskem. Stejný seed dává stejná data, takže každý testovací běh v každé větvi vidí stejný týden. Díky tomu bylo našich 66 testů opakovatelných.
Větev ve výchozím nastavení existuje 72 hodin a nejvýše 14 dní. Během dlouhé revize jsem požádal o ponechání naší rušné větve na 30 dní a stránka to odmítla s BRANCH_LIFE_EXCEEDED. Řešení je to, které navrhuje štítek: ponechte si seed a v případě potřeby z něj vytvořte novou větev. Maskovaná kopie se řídí stejnými limity a její žádost obsahuje důvod a dobu trvání až 14 dní.
Náhled pohledu z pozice konkrétní osoby
Než Cold chain uviděl kdokoli v Rotterdamu, prohlédli jsme si jej tak, jak by ho viděli oni. Funkce Náhled pohledu jako konkrétní osoba vykreslí balíček přesně tak, jak jej vidí zvolená role, na datové větvi a uvnitř přerušovaného rámečku náhledu.
Díky třem pravidlům lze náhledy bezpečně používat bez omezení. Náhled používá datovou větev, nikdy živou jednotku. Vaše vlastní oprávnění se do něj nepromítají, takže vidíte to, co vidí role, nikoli to, co můžete vidět vy. A po 30 minutách končí. Nasměrování náhledu na živou jednotku je odmítnuto s CONNECTION_SCOPE_EXCEEDED; potřebujete-li skutečné tvary dat, požádejte vlastníka dat o maskovanou kopii a náhled spusťte na ní.
Právě v náhledu jsme odhalili skutečnou chybu. Teplotní graf v pohledu technika zobrazoval nastavenou hodnotu a úpravy nastavené hodnoty měly být vyhrazeny pouze dispečerům. Graf byl v pořádku; tlačítko úprav pod ním nikoli. Verze 0.3.2 skryla úpravy nastavené hodnoty před techniky a chybu jsme našli právě v náhledu.
Změna znalostního modelu po vydání
Ve verzi 0.4.0 jsme potřebovali druh Inspection pro kontroly před cestou a vztah „Excursion caused Claim“ zněl lépe jako „Excursion led to Claim“. Přechod modelu z 1.3 na 1.4 je změnou znalostního modelu a stránka Změny znalostního modelu zobrazuje její rozdíl, co by ovlivnila a v jaké fázi se nachází.
Změna putuje jako žádost o změnu grafu. Její zkušební běh spočítá, co by ovlivnila v maskované kopii z Rotterdamu, a to formou počtů: v našem případě 1 284 přejmenovaných vazeb a nic odstraněného. Schvalují ji dva revidenti a pipeline ji aplikuje na staging a poté na pilot. Nikdo nezapisuje do sdíleného grafu ručně; takový pokus je odmítnut a zaznamenán. Tři uložené dotazy používaly slovo „caused“ a změna pro každý z nich obsahovala automatický přepis, který stránka vypsala. Filtry pohledů se nezměnily, protože oba pohledy stále pouze zužovaly.
Povýšení do produkce
Každé vydání se pohybuje po jedné cestě: vývojový prostor, staging, pilotní jednotka a poté všechny jednotky. Každý krok má brány a žádnou nelze přeskočit.
| Do | Brány |
|---|---|
| Staging | Všechny testy projdou; kontroly kvality; manifest beze změny nebo přijaté rozšíření; podepsaný image |
| Pilot (Rotterdam) | Zkušební běh změny modelu na maskované kopii bez chyb; kontrola zásad pro pravidla pohledů a rozsahu; dva revidenti, kteří nejsou autory, z nichž jeden je vlastník dat |
| Všechny jednotky | 14 dní v pilotu; chyby pod 1 z 1 000, počítané v pilotu; souhlas administrátora každé jednotky za jeho jednotku; dva revidenti, kteří nejsou autory |
Zkratku jsem jednou zkusil, v pátek, kvůli jednořádkové opravě: povýšit 0.4.0-dev z mého vývojového prostoru do všech jednotek. Bylo to odmítnuto s GATE_CANNOT_BE_SKIPPED a nic nebylo povýšeno. Štítek vám místo toho doporučí povýšit do dalšího kroku a jiná odpověď neexistuje.
Samotná revize vydání, podklady, které čte druhý revident, a kanály, které si jednotky volí, jsou popsány v kapitole 2.28, Vydání vašeho rozšíření. Dvě skutečnosti z ní patří sem, protože ovlivňují, jak vertikálu plánujete. Autor se nikdy nepočítá jako revident, takže dvoučlenný tým potřebuje pro každé vydání třetí osobu. A každé prostředí uchovává předchozí verzi po dobu 30 dní, takže vrácení zpět je revidovaná změna, kterou pipeline provede přibližně za minutu.
Rozšíření již existujícího balíčku
Ne každá vertikála začíná od nuly. Balíček může dědit z jiného a přidat jen to, co se liší. Nejzřetelnějším příkladem v katalogu je balíček Bankovnictví a platby, který provozuje Larchmont Bank. Jeho manifest začíná 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 uvádí balíček, na kterém staví. Bankovnictví a platby zachovává strukturu balíčku Pojišťovnictví, jeho sdílené konverzační clustery a základní pojmy a přidává tři vlastní pohledy: Úvěrová rozhodnutí, Reklamace karet a Můj účet. Třetí prvek každé položky lexikonu je exact pro termín, který musí být zobrazen tak, jak je zapsán, například APR (roční procentní sazba), a nesmí být přeformulován.
Některé věci děděním udělat nelze. Balíček nikdy nemění shell, komponenty ani pravidla psaní, takže podřízený balíček nemůže změnit vzhled konzole. Regulatorní režim, který potřebuje více balíčků, je jeden sdílený pohled, nikoli kopie v každém z nich: registr outsourcovaných technologií slouží balíčku Pojišťovnictví i balíčku Bankovnictví a platby. Pokud váš podřízený balíček potřebuje pohled, který již existuje jako sdílený, použijte jej místo vytváření vlastního.
Licencování se řídí dědičností. Balíček se licencuje nad edicí Enterprise a může vyžadovat doplňky, přičemž licenční dokument tyto závislosti obsahuje. Pojišťovnictví vyžaduje Rozhodovací místnosti a zapečetěné záznamy, takže zákazník, který licencuje balíček z něj dědící, potřebuje i tento doplněk, a konzole odmítne vydat licenci, která jej vynechává. Obrazovky balíčku pro telefony navíc vyžadují doplněk Mobilní aplikace. Než zákazníkovi slíbíte termín, ověřte celý řetězec požadavků.
Přidání pohledu do již vydaného balíčku
Nejmenší vertikální prací je nový pohled v balíčku, který jste nenapsali. Šest měsíců po zahájení pilotu chtěl tým námořních pojistných událostí společnosti Larkfield vlastní pohled v rámci Cold chain: odchylky a nároky, žádné napájecí body, žádné nastavené hodnoty. Kódu balíčku jsme se nedotkli. Pohled je řádek v registru pohledů organizace, který vlastní balíček, takže jsme jej založili ze zlaté cesty pro pohledy na stránce Začít něco nového a v Návrháři pohledů jsme jej upravili s pohledem Cold-chain controller jako základem. Platí stejné pravidlo jako dříve: nový pohled může skrýt to, co zobrazuje jeho základ, ale nikdy nemůže zobrazit více. Definuje se jednou pro celou organizaci a v každé jednotce se přiděluje roli platformy. Přidělení se odvolává, nikdy nemaže, a opětovné udělení pohledu vytvoří nové přidělení, takže zůstává dohledatelné, kdo měl který pohled a kdy. Registr počítá, kolik lidí mělo pohled v každém měsíci, nikdy však kdo.
Stránka Pohledy a kdo je vidí zobrazuje výsledek jako matici pohledů podle jednotky a role s akcemi Přidat, Změnit a Odvolat v každé buňce. Před přidělením si nový pohled prohlédněte pomocí funkce Náhled pohledu jako konkrétní osoba, přesně jako výše.
Skutečné náklady bez příkras
Balíček pracuje se záznamy zákazníka, proto platforma některé věci záměrně zpomaluje a měli byste s tím počítat od prvního dne.
- Maskovaná kopie vyžaduje pokaždé souhlas vlastníka dat. Ten náš napoprvé trval den, protože Priya si chtěla nejprve přečíst znalostní model. Začněte se syntetickými daty a žádejte včas.
- Autor nemůže schválit své vlastní vydání a žádosti po 3 dnech vyprší. Pokud jsou vaši revidenti vytížení, vaše vydání čeká.
- Vydání, které požaduje více než předchozí, například odesílání pošty nebo jednu externí adresu, je pozdrženo, dokud rozšířený manifest nepřijmou dva revidenti. Kapitola 2.28, Vydání vašeho rozšíření, ukazuje stránku Manifest a oprávnění, která vás na to upozorní dříve, než požádáte.
- Pohled nemůže zobrazit to, co jeho základní pohled skrývá. Pokud role skutečně potřebuje více, je to věc rozhovoru s administrátorem organizace, nikoli nastavení.
Žádná z těchto věcí nás nezdržela dvakrát. Druhé vydání Cold chain trvalo od prvního commitu po pilot v Rotterdamu týden, z čehož většinu zabralo 66 testů běžících proti třem větvím a dva lidé čtoucí podklady.




