Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.24
Cjelovita izrada prilagođene vertikale
Razrađena izrada domenskog paketa za hladni lanac (Cold chain), od prvog sažetka do izdanja koje se izvršava za svaku jedinicu, sa svojim modelom znanja, lećama, vještinom, cjelovitim dodatkom (full-service plugin) i oglednim podacima. Zatim kako proširiti paket koji već postoji i kako dodati leću u paket koji je već isporučen.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Ja sam Mateo Ruiz, programer u tvrtki Corrán Orbital. Većinu tjedna radim na našem vlastitom softveru za korisni teret, ali ovo poglavlje govori o poslu koji smo obavili za jednog klijenta. Larkfield & Vane osigurava teret, a sve veći dio tog tereta putuje u rashladnim kontejnerima. Kada rashladni kontejner na obali izgubi napajanje s kopna, temperatura raste, teret se kvari, a nekoliko tjedana kasnije slijedi odštetni zahtjev. Larkfield je želio da njegovi ljudi taj lanac vide kao jednu cjelinu u Nexusu, od kvara napajanja do odštetnog zahtjeva, pri čemu svaka uloga vidi samo svoj dio. Tako je nastao paket Cold chain.
U nastavku je izgradnja opisana redoslijedom kojim smo je proveli, sa zaslonima, datotekama i naredbama. Pogreške sam ostavio, jer su nas dva odbijanja na koja smo naišli naučila više o platformi nego uspješan put. Referentni materijal nalazi se u poglavljima prije ovoga i na njih upućujem umjesto da ih ponavljam. Najviše sam se oslanjao na poglavlje 2.18, Model proširenja, i poglavlje 2.23, Domenski paketi, a uz njih sam imao otvoreno poglavlje 2.21, Plugin SDK, za sam komplet za razvoj softvera.
Sažetak i tko što radi
Larkfield mi je za trajanja projekta dodijelio razvojno mjesto u svojoj organizaciji. To je važno jer se privatni paket za jednog klijenta gradi unutar instalacije tog klijenta, na njegovim razvojnim prostorima i podatkovnim granama, uz odobrenja njegovih ljudi. Paket namijenjen mnogim klijentima gradi se drukčije, na izdavačkom klasteru samo s oglednim podacima, a taj slučaj obrađuje poglavlje 2.25, Izgradnja za svako izdanje.
Zadatak je stao na jednu stranicu:
- Rashladni kontejneri na obali i na brodovima: njihovo napajanje, njihova temperaturna odstupanja i odštetni zahtjevi koji slijede.
- Dvije uloge za početak: tehničar za rashladne kontejnere na obali i kontrolor hladnog lanca u uredu.
- Pilot koji se najprije provodi u jedinici Rotterdam, a zatim prelazi u Felixstowe.
- Dokazi za tri skupa pravila: sporazum ATP za lako pokvarljivu hranu, dobru distribucijsku praksu EU-a za lijekove i evidencije o sigurnosti hrane prema sustavu HACCP (analiza opasnosti i kritične kontrolne točke). Odštetni zahtjevi prema Haaško-visbyjskim pravilima koriste iste evidencije o odstupanjima, pa smo ih zabilježili za razdoblje nakon pilota.
Domenski paketi mogućnost su izdanja Enterprise. Larkfield koristi Enterprise, pa mi je put domenskog paketa bio otvoren. U izdanju Community zlatni put za paket uopće se ne nudi.
Krenite od preporučenog puta (golden path)
Sve počinje na stranici Započnite nešto novo. Ona nudi šest zlatnih putova: dodatak, domenski paket, leću, platformu, vještinu i tijek rada. Svaki od njih stvara repozitorij iz verzioniranog predloška, manifest koji navodi što je potrebno, testove, razvojni prostor i podatkovne grane. Isti putovi rade u konzoli, u naredbenom retku i iz Vašeg IDE-a (integriranog razvojnog okruženja), gdje alat Workbench nexus.create obavlja isti posao uz plan koji najprije potvrđujete.
nexus create i svojim fiksiranim predloškom. Obratite pozornost na pločicu na dnu: manifest se provodi, nije savjetodavan, a izdanje koje traži više zadržava se dok ga ne pregledaju dvije osobe.S te smo stranice odabrali put domenskog paketa, nazvavši paket cold-chain, a njegovu prvu jedinicu Rotterdam. Rezultat navodi fiksirani predložak, domain-pack@1.6.0, i popisuje što je stvoreno: repozitorij, manifest koji navodi četiri opsega, dvije pohrane i nijednu odlaznu adresu, 66 testova iz predloška, razvojni prostor u Rotterdamu, tri sintetičke podatkovne grane i nacrt unosa u Larkfieldovu vlastitom katalogu koji sam mogao vidjeti samo ja. Verzija predloška je fiksirana, a njezina se kasnija nadogradnja pojavljuje kao pregledana promjena kao i svaka druga, pa se ničiji paket ne mijenja samo zato što se promijenio predložak. Za naš prvi paket ipak sam koristio čarobnjak u konzoli jer prikazuje plan prije nego što išta stvori.
1. korak: navedite čemu paket služi
Čarobnjak Novi domenski paket ima tri koraka: o paketu, model znanja te pregled i stvaranje. Prvi korak traži ono malo podataka koji oblikuju sve što slijedi.
| Polje | Što smo unijeli | Napomena |
|---|---|---|
| Naziv | Cold chain | Koristi se za repozitorij i katalog |
| Čemu služi | Rashladni kontejneri na obali i na brodovima: napajanje, temperaturna odstupanja i odštetni zahtjevi koji slijede | |
| Industrija | Logistika i pomorstvo | Nadograđuje se na paket Logistika i pomorstvo |
| Vlasnik | Osoba koja ga stvara | Zaključano u čarobnjaku |
| Jedinice | Rotterdam (pilot) | Felixstowe nakon pilota |
| Predložak | domain-pack@1.6.0 |
Zaključano; nadogradnje stižu kao pregledane promjene |
| Pravila koja mapira | Sporazum ATP, dobra distribucijska praksa EU-a, evidencije o sigurnosti hrane | Svako pravilo postaje stranica u mapi dokaza paketa |
Asistent na bočnoj traci predložio je posljednji redak, uključujući napomenu da odštetni zahtjevi za teret ponovno koriste iste evidencije o odstupanjima. Pločica na dnu stranice kaže da još ništa nije stvoreno. Repozitorij, razvojni prostor i podatkovne grane stvaraju se tek kada pritisnete Stvori u trećem koraku, nakon što ste vidjeli plan. Možete spremiti nacrt i vratiti mu se kasnije.
2. korak: model znanja
Model znanja skup je vrsta stvari o kojima paket zna i načina na koji su povezane. Cold chain je krenuo od osnovnog logističkog modela, logistics-base 4.2, uvezenog iz SDK-a, koji nam je dao pet osnovnih vrsta za nadogradnju (Vessel, Port, Container, Carrier i Shipment). Osnovne su vrste u čarobnjaku samo za čitanje. Ako neku treba promijeniti, mijenja se u paketu koji je posjeduje.
Dodali smo pet vlastitih vrsta:
| Vrsta | Što je to | Svojstva |
|---|---|---|
| Rashladna jedinica | Rashladni kontejner | 9 |
| Pristajanje broda | Jedan brod na jednom vezu | 6 |
| Odstupanje | Temperatura izvan svojih granica | 8 |
| Izvor napajanja | Priključak za napajanje s kopna ili s broda | 4 |
| Preuzimanje vlasništva | Novac zatražen za pokvareni teret | 7 |
Svako svojstvo dobiva klasu u trenutku kada ga stvorite. "Prijavio" kod vrste Odstupanje osobni je podatak. "Vrijednost ugroženog tereta" te iznos i namirenje odštetnog zahtjeva poslovni su podaci. Prvog je dana to djelovalo kao birokracija, a kasnije nas je dvaput spasilo, jer klase određuju što leća smije prikazati, što maskirana kopija zamjenjuje i što redak zapisnika skriva.
Dvije naše relacije sežu u osnovni model: rashladna jedinica priključena je na izvor napajanja, a odštetni zahtjev odnosi se na pošiljku. Sam osnovni model ne mijenja se. Svojstvo koje povučete ostaje u verziji 1.0 modela i nestaje tek u nekoj kasnijoj verziji, pa ništa što je vrijedilo za stare zapise ne prestaje biti čitljivo.
3. korak: pregled i izrada
Treći korak je plan. On navodi što će biti stvoreno, opsege koje će manifest navesti, podatkovne grane i razvojni prostor. Plan potvrđujete svojim pristupnim ključem i plan dobiva otisak. Stvaranje zatim točno slijedi taj plan, korak po korak, a možete se zaustaviti na bilo kojem koraku i zadržati ono što je stvoreno.
Plan za Cold chain naveo je četiri opsega:
| Opseg | Zašto ga paket treba |
|---|---|
| Čitanje telemetrije rashladnih kontejnera | Očitanja napajanja i temperature |
| Zapisivanje odstupanja | Bilježi odstupanje kada se granice prekorače |
| Čitanje pošiljaka | Povezuje odštetni zahtjev s njegovom pošiljkom |
| Nacrti bilješki o odštetnim zahtjevima | Samo nacrti; šalje osoba |
Njegove pohrane bile su graf i zapisi. Nije imao odlaznih adresa i koristio je profil sandboxa Standard. Razvojni prostor dobio je 4 jezgre, 16 GiB memorije i 50 GiB pohrane, mrežu zatvorenu osim za ono što manifest navodi, isključivo potpisane slike i gašenje nakon 7 dana neaktivnosti. Kada se ugasi, njegova definicija ostaje u repozitoriju, pa ga odande ponovno stvarate.
Tri podatkovne grane potječu iz sintetičkog generatora. Nikakvi podaci klijenta nisu kopirani. Za maskiranu kopiju Rotterdama potrebna je suglasnost vlasnika podataka, a to je u Larkfieldu Priya Natarajan, i za nju se traži zasebno.
Manifest paketa
Repozitorij sadrži manifest paketa, pack.json. On navodi naziv paketa, njegovu verziju, paket od kojeg nasljeđuje (ako postoji), njegove klastere i njegove pojmove. Klaster je ili leća, odnosno ono što jedna uloga vidi unutar paketa, ili zajednički klaster, koji se proteže kroz sve leće. Evo jezgre našeg manifesta:
{
"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", ""]
]
}
}Leksikon sadrži vlastite pojmove paketa s jednostavnim objašnjenjem za svaki, dovoljno kratkim da se pročita na telefonu.
Uz pack.json manifest navodi i do čega paket smije doprijeti: njegove opsege, pohrane, odlazne adrese i profil sandboxa. Nexus dodjeljuje točno to i ništa više. Svaki poziv alata provjerava se prema navedenim opsezima, a vanjska adresa blokira se ako nije navedena. Deklaraciju, kao i promjenu u odnosu na posljednje izdanje, možete pročitati na stranici paketa Manifest i dopuštenja.
Leće: što pojedina uloga vidi
Leća može samo suziti ono što prikazuje njezina osnova, i to je jedno pravilo oblikovalo naš dizajn više od ijednog drugog. Leća prikazuje dio onoga što prikazuje njezina osnovna leća, a dopuštenja i dalje proizlaze iz uloga: leća određuje što uloga vidi u paketu, a ne što joj je dopušteno raditi.
Leća Tehničar za rashladne kontejnere sužava leću Kontrolor operacija, osnovnu leću koju Larkfield već koristi za logističke poslove. U Graditelju leća označavate kartice, polja i radnje koje leća prikazuje. Stavke koje osnova ne prikazuje zaključane su.
| Dio | Tehničar za rashladne kontejnere prikazuje | Izostavljeno |
|---|---|---|
| Kartice | Rashladne jedinice na obali, otvorena odstupanja, priključci za napajanje, današnja pristajanja brodova | Sve što se odnosi na odštetne zahtjeve |
| Polja | Stanje napajanja, zadana vrijednost, posljednje očitanje, najviša temperatura | Iznos odštetnog zahtjeva (nije u osnovnoj leći), osobna polja (prema zadanim postavkama isključena) |
| Radnje | Bilježenje uzroka odstupanja, traženje provjere napajanja | Promjena zadane vrijednosti i zatvaranje odstupanja (samo kontrolori), izrada nacrta bilješke o odštetnom zahtjevu |
Ipak sam pokušao dodati iznos odštetnog zahtjeva u tehničarsku leću, jer ga je jedan tehničar zatražio. Graditelj je to odbio porukom LENS_CANNOT_WIDEN i ništa nije spremio. Unutar leće nema zaobilaznog rješenja: put naprijed je leća sa širom osnovom, a to je drugi zahtjev o kojem odlučuje administrator organizacije. Izostavili smo ga.
Skrivanje nečega u leći ne uklanja to iz Nexusa. To znači da ta uloga to ne vidi. Graditelj prikazuje do koliko će ljudi leća doprijeti u pilotu (u našem slučaju 29) i vodi zapisnik svakog dodavanja, promjene i povlačenja. Leća se definira jednom za organizaciju i dodjeljuje po jedinici nekoj ulozi na platformi, pa se ista leća Tehničar za rashladne kontejnere može ovaj mjesec dodijeliti tehničarima u Rotterdamu, a sljedeći mjesec onima u Felixstoweu.
Vještina za sastavljanje bilješki o odštetnim zahtjevima
Kontrolori su željeli prvi nacrt bilješke koja se nakon odstupanja šalje vlasniku tereta. To je jezični posao, pa se izvodi na modelu, a pitanje je bilo gdje ga smjestiti.
U Nexusu postoje dvije vrste vještina i ovdje je razlika važna. Vještina iz manifesta tipizirani je redak u skills[] dodatka, koji raspoređuje platforma. Vještina Skills Engine paket je SKILL.md u knjižnici vještina organizacije, koji agenti, gumbi AI-ja (umjetne inteligencije), tijekovi rada i razvojni alati izvode na isti način. Poglavlje 2.20, Vještine, obrađuje obje.
Razina povjerenja našeg dodatka je community, a dodatak zajednice smije navesti samo vještine iz manifesta koje ne dopiru do modela (host_callback i plugin_queue). Dvije razine koje dopiru do AI Provider Routera, tool_using i llm_only, zahtijevaju povjerenje core ili verified. Stoga je izrada nacrta bilješki o odštetnim zahtjevima postala vještina Skills Engine, a usmjerivač bira model iz Larkfieldova vlastitog skupa:
---
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.Paket se nalazi u skills/draft-claim-note/ u repozitoriju, pri čemu je naziv mape jednak nazivu vještine. Provjerili smo ga i prenijeli iz terminala:
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-notePonovni prijenos istog sadržaja vraća postojeću verziju umjesto nove (CONTENT_HASH_ALREADY_PUBLISHED), pa je ponavljanje prijenosa sigurno. Prije objave verzije Skills Engine izvodi njezine testne slučajeve, probno izvođenje u sjeni na prošlom radu i slijepi pregled koji provodi model druge tvrtke, uz vrijeme i trošak svakog izvođenja.
Cjeloviti dodatak
Paketu je trebao i kod koji radi neprekidno: čitač za tok telemetrije rashladnih kontejnera i zapisivač koji otvara zapis o odstupanju kada očitanje prekorači svoje granice. Takav kod pripada dodatku s punom uslugom, a njegov smo kostur izradili vlastitom naredbom SDK-a, koja zapisuje cijelo referentno stablo sa zamijenjenim nazivom:
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 instalira iz https://registry.adverant.ai/npm/ pomoću tokena za preuzimanje sa stranice Tokeni za preuzimanje i naredbe za instalaciju u Vašem računu Adverant. Potvrdite (commit) datoteku package-lock.json koju zapisuje prva instalacija; izgradnja slike pokreće npm ci i odbija se izvršiti bez nje.
Ovo je dio naše datoteke nexus.manifest.json koji se razlikuje od predloška. To nije cijela datoteka: blokovi description, author, license, runtime, backend i frontend iz predloška ostaju kakvi jesu, a validator odbija manifest punog servisa bez njih. Tri rečenice architecture pravilo su koje svaki dodatak ponavlja, a validator provjerava njihovu formulaciju. UNO u prvoj od njih je mehanizam tijekova rada:
{
"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 vještina iz manifesta s razinom host_callback: platforma šalje ulaz našem vlastitom Serviceu, unutar našeg imenskog prostora, i nikada na host koji mi navedemo. Ruta primatelja deklarirana je kao auth: internal i zaštićena SDK-ovim serviceMiddleware, Express oblikom zaštite, koji odbija token poziva izdan za bilo koji drugi dodatak, organizaciju, vještinu ili rutu. Njezin classification je tenant, što je gornja granica za dodatak zajednice. Poglavlje 2.27, Izrada scenarija, zasebno prolazi kroz vještinu host_callback.
Dvije navike iz ove faze vrijedi preuzeti. Svaka tablica od prve migracije sadrži organization_id, owner_user_id i business_unit_id, jer je naknadno dodavanje osi migracija nad živim retcima. Također smo prije svakog pushanja lokalno pokretali nexus-gates, budući da je to ista naredba koju pokreće cjevovod; pokretanje koje ništa nije pregledalo završava s izlaznim kodom 2 i to navodi. Poglavlje 2.19, Pravila koja nasljeđuje svako proširenje, navodi provjere.
Ogledni podaci za testiranje
Stranica Ogledni podaci za testiranje nudi tri vrste grana:
| Vrsta | Što sadrži | Tko odobrava |
|---|---|---|
| Sintetički | Podaci generirani iz brojeva i oblika koje Vi postavite; ništa ne dolazi iz stvarne jedinice | Nitko; ona je Vaša |
| Maskirana kopija | Kopija jedinice u kojoj su osobna, osjetljiva i poslovna polja zamijenjena | Vlasnik podataka (Priya Natarajan za Rotterdam) |
| Samo shema | Oblik spremišta, bez redaka | Nitko; za migracije |
Generirali smo prometan tjedan: otprilike 7 odstupanja na svakih 100 hladnjača, što odgovara prometnom kolovozu u Rotterdamu. Neobični slučajevi bili su važniji od količine. Zatražili smo gubitak napajanja tijekom iskrcaja, ostavljena otvorena vrata, prekid u podacima senzora i dva zahtjeva za jedno odstupanje. Stranica može predložiti neobične slučajeve na temelju uzroka odstupanja u modelu znanja, nikada iz stvarnih zapisa.
Svaki skup brojeva i oblika sprema se kao seed, primjerice cold-chain-busy-01, zajedno sa svojim otiskom. Isti seed daje iste podatke, pa svako testno pokretanje na svakoj grani vidi isti tjedan. Upravo je to naših 66 testova učinilo ponovljivima.
Grana prema zadanim postavkama traje 72 sata, a najviše 14 dana. Zatražio sam da našu prometnu granu zadržimo 30 dana tijekom dugog pregleda, a stranica je to odbila s BRANCH_LIFE_EXCEEDED. Rješenje je ono koje predlaže pločica: zadržite seed i iz njega izradite novu granu kada Vam zatreba. Maskirana kopija podliježe istim ograničenjima, a njezin zahtjev sadrži razlog i trajanje do najviše 14 dana.
Pregled leće iz perspektive osobe
Prije nego što je itko u Rotterdamu vidio Cold chain, pogledali smo ga onako kako bi ga oni vidjeli. Pregled leće kao osoba prikazuje paket točno onako kako ga vidi odabrana uloga, na podatkovnoj grani, unutar isprekidanog okvira pregleda.
Tri pravila čine preglede sigurnima za slobodnu upotrebu. Pregled koristi podatkovnu granu, nikada živu jedinicu. Vaša vlastita dopuštenja ne prenose se u njega, pa vidite ono što vidi uloga, a ne ono što možete vidjeti Vi. Pregled završava nakon 30 minuta. Usmjeravanje pregleda na živu jedinicu odbija se s CONNECTION_SCOPE_EXCEEDED; ako su Vam potrebni stvarni oblici, zatražite od vlasnika podataka maskiranu kopiju i pregledajte na njoj.
Upravo smo u pregledu otkrili stvarnu pogrešku. Grafikon temperature u prikazu za tehničare prikazivao je zadanu vrijednost, a izmjene zadane vrijednosti bile su namijenjene samo kontrolorima. Grafikon je bio u redu; gumb za izmjenu ispod njega nije. Verzija 0.3.2 sakrila je izmjene zadane vrijednosti od tehničara, a pogrešku smo pronašli upravo u pregledu.
Promjena modela znanja nakon isporuke
Do verzije 0.4.0 trebala nam je vrsta Inspection za inspekcije prije putovanja, a relacija „Excursion caused Claim” bolje je glasila kao „Excursion led to Claim”. Prijelaz modela s 1.3 na 1.4 promjena je modela znanja, a stranica Promjene modela znanja prikazuje njezine razlike, što bi zahvatila i u kojoj je fazi.
Promjena putuje kao zahtjev za promjenu grafa. Njezino probno pokretanje broji ono što bi zahvatilo na maskiranoj kopiji Rotterdama, u obliku brojeva: kod nas 1.284 preimenovane veze i ništa uklonjeno. Dvoje recenzenata je odobrava, a cjevovod je primjenjuje na staging, a zatim na pilot. Nitko ne piše u zajednički graf ručno; takav se pokušaj odbija i bilježi. Tri spremljena pitanja koristila su riječ „caused”, a promjena je za svako od njih sadržavala automatsko prepisivanje, koje je stranica navela. Filtri leća nisu se promijenili jer su obje leće i dalje samo sužavale prikaz.
Promicanje u produkciju
Svako izdanje kreće se jednim putem: razvojni prostor, staging, pilot jedinica, zatim sve jedinice. Svaki korak ima provjere i ništa ne preskače nijednu.
| Prema | Kontrolne točke |
|---|---|
| Staging | Svi testovi prolaze; provjere kvalitete; manifest nepromijenjen ili prihvaćeno proširenje; potpisana slika |
| Pilot (Rotterdam) | Probno pokretanje promjene modela na maskiranoj kopiji bez pogrešaka; provjera pravila o lećama i opsegu; dvoje recenzenata koji nisu autor, od kojih je jedan vlasnik podataka |
| Sve jedinice | 14 dana u pilotu; pogreške ispod 1 na 1.000, brojeno u pilotu; administrator svake jedinice odobrava za svoju jedinicu; dvoje recenzenata koji nisu autor |
Prečac sam pokušao jednom, u petak, za ispravak od jednog retka: promovirati 0.4.0-dev iz svojeg razvojnog prostora na sve jedinice. Odbijeno je s GATE_CANNOT_BE_SKIPPED i ništa nije promovirano. Pločica Vam savjetuje da umjesto toga promovirate na sljedeći korak, i to je jedini mogući odgovor.
Sam pregled izdanja, dokazi koje drugi recenzent čita i kanali koje jedinice biraju opisani su u poglavlju 2.28, Izdavanje Vašeg proširenja. Dvije činjenice iz njega pripadaju ovdje jer oblikuju način na koji planirate vertikalu. Autor se nikada ne računa kao recenzent, pa tim od dvije osobe treba treću osobu za svako izdanje. Svako okruženje čuva prethodnu verziju 30 dana, pa je vraćanje recenzirana promjena koju cjevovod izvodi za otprilike minutu.
Proširivanje postojećeg paketa
Ne počinje svaka vertikala od nule. Paket može naslijediti drugi paket i dodati samo ono što je drukčije. Paket Banking and payments, koji koristi Larchmont Bank, najjasniji je primjer u katalogu. Njegov manifest počinje ovako:
{
"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 imenuje paket na kojem se gradi. Banking and payments zadržava oblik paketa Insurance, njegove zajedničke klastere razgovora i osnovne pojmove te dodaje tri vlastite leće: Lending decisions, Card disputes i My account. Treći element svakog unosa u leksikonu je exact za pojam koji se mora prikazati onako kako je napisan, primjerice APR (godišnja kamatna stopa), umjesto da se preformulira.
Neke stvari ne možete postići nasljeđivanjem. Paket nikada ne mijenja ljusku, komponente ni pravila pisanja, pa paket-dijete ne može promijeniti stil konzole. Regulatorni režim koji treba više paketa jedna je zajednička leća, a ne kopija u svakom od njih: registar eksternaliziranih tehnologija služi i paketu Insurance i paketu Banking and payments. Ako Vašem paketu-djetetu treba leća koja već postoji kao zajednička leća, upotrijebite nju umjesto da izrađujete vlastitu.
Licenciranje prati nasljeđivanje. Paket se licencira povrh izdanja Enterprise i može zahtijevati dodatke, a licencni dokument sadrži te ovisnosti. Insurance zahtijeva Decision rooms i zapečaćene zapise, pa kupac koji licencira paket koji ga nasljeđuje također treba taj dodatak, a konzola odbija izdati licencu koja ga izostavlja. Zasloni paketa za telefon također zahtijevaju dodatak Mobile apps. Provjerite lanac zahtjeva prije nego što kupcu obećate datum.
Dodavanje leće u isporučeni paket
Najmanji posao na vertikali je nova leća na paketu koji niste napisali. Šest mjeseci nakon početka pilota, tim za pomorske odštetne zahtjeve tvrtke Larkfield želio je vlastitu leću unutar paketa Cold chain: odstupanja i zahtjevi, bez priključaka za napajanje i bez zadanih vrijednosti. Nismo dirali kod paketa. Leća je redak u registru leća organizacije, u vlasništvu paketa, pa smo je pokrenuli iz zlatnog puta za leće na stranici Započnite nešto novo i oblikovali je u alatu Lens builder s lećom Cold-chain controller kao osnovom. Vrijedi isto pravilo kao i prije: nova leća može sakriti ono što prikazuje njezina osnova, ali nikada ne može prikazati više. Definira se jednom za organizaciju i dodjeljuje platformskoj ulozi u svakoj jedinici. Dodjela se povlači, nikada ne briše, a ponovno davanje leće stvara novu dodjelu, pa ostaje čitljivo tko je koju leću imao i kada. Registar broji koliko je osoba svakog mjeseca imalo leću, nikada tko.
Stranica Leće i tko ih vidi prikazuje rezultat kao matricu leća prema jedinici i ulozi, s opcijama Dodaj, Promijeni i Povuci u svakoj ćeliji. Pregledajte novu leću kao osoba prije nego što je dodijelite, točno kao gore.
Koliko je to iskreno stajalo
Paket dira zapise kupca, pa platforma namjerno usporava neke stvari, a Vi biste ih trebali planirati od prvog dana.
- Maskirana kopija svaki put zahtijeva odobrenje vlasnika podataka. Naša je prvi put stigla tek nakon jednog dana jer je Priya najprije željela pročitati model znanja. Počnite sa sintetičkim podacima i zatražite na vrijeme.
- Autor ne može odobriti vlastito izdanje, a zahtjevi istječu nakon 3 dana. Ako su Vaši recenzenti zauzeti, Vaše izdanje čeka.
- Izdanje koje traži više od prethodnog, primjerice slanje pošte ili jednu vanjsku adresu, zadržava se dok dvoje recenzenata ne prihvati prošireni manifest. Poglavlje 2.28, Izdavanje Vašeg proširenja, prikazuje stranicu Manifest i dopuštenja koja Vas o tome obavještava prije nego što zatražite.
- Leća ne može prikazati ono što skriva njezina osnovna leća. Ako uloga doista treba više, to je razgovor s administratorom organizacije, a ne postavka.
Ništa od ovoga nije nam smetalo dvaput. Drugo izdanje paketa Cold chain trajalo je tjedan dana od prvog commita do pilota u Rotterdamu, a većinu tog vremena odnijelo je izvođenje 66 testova na tri grane i dvije osobe koje su čitale dokaze.




