PrijavaZakažite brifing

Poglavlje 2.24

Izgradnja prilagođene vertikale od početka do kraja

Razrađena izgradnja domenskog paketa Cold chain, od prvog zadatka do izdanja koje radi za svaku jedinicu, sa njegovim modelom znanja, prikazima, veštinom, plugin-om za kompletan servis i primerima podataka. Zatim kako da proširite paket koji već postoji i kako da dodate prikaz paketu koji je već isporučen.

Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

19 min čitanja

Ja sam Mateo Ruiz, programer u kompaniji Corrán Orbital. Veći deo nedelje posvećujem našem softveru za korisni teret, ali ovo poglavlje govori o poslu koji smo uradili za jednog klijenta. Larkfield & Vane osigurava teret, a sve veći deo tog tereta putuje u rashladnim kontejnerima. Kada rashladni kontejner na keju izgubi napajanje sa obale, temperatura raste, teret se kvari, a odštetni zahtev stiže nekoliko nedelja kasnije. Larkfield je želeo da njihovi ljudi vide taj lanac kao jednu celinu u sistemu Nexus, od kvara napajanja do odštetnog zahteva, pri čemu svaka uloga vidi samo svoj deo. Tako je nastao paket Cold chain.

U nastavku je izrada prikazana redosledom kojim smo je radili, sa ekranima, datotekama i komandama. Greške sam zadržao, jer su nas dva odbijanja na koja smo naišli naučila više o platformi nego put bez prepreka. Referentni materijal nalazi se u poglavljima pre ovog i na njih upućujem umesto da ih ponavljam. Najviše sam se oslanjao na poglavlje 2.18, Model proširenja, i poglavlje 2.23, Domenski paketi, uz poglavlje 2.21, Plugin SDK, otvoreno pored njih zbog samog kompleta za razvoj softvera.

Putanja sleva nadesno od osam polja: „Opis zadatka”, „Zlatna putanja”, „Model znanja”, „Sočiva”, „Skill i plugin”, „Uzorci podataka i pregled”, „Pregled izdanja”, „Unapređenje”. Ispod poslednjeg polja, drugi red od četiri manja polja povezana strelicama prikazuje korake unapređenja: „Razvojni prostor”, „Staging”, „Pilot jedinica (Rotterdam)”, „Sve jedinice”, sa ikonom katanca na svakoj strelici označenom sa „kontrolna tačka”. Isprekidana strelica od „Razvojni prostor” direktno do „Sve jedinice” je precrtana i označena sa GATE_CANNOT_BE_SKIPPED.
Izrada paketa Cold chain, od zadatka do svake jedinice.

Projektni zadatak i ko šta radi

Larkfield mi je dodelio programersko mesto u svojoj organizaciji za vreme trajanja projekta. To je važno, jer se privatni paket za jednog klijenta pravi unutar instalacije tog klijenta, na njegovim razvojnim prostorima i granama podataka, uz odobrenja njegovih ljudi. Paket namenjen većem broju klijenata pravi se drugačije, na klasteru izdavača isključivo sa uzorcima podataka, a taj slučaj obrađuje poglavlje 2.25, Izrada za svako izdanje.

Zadatak je stao na jednu stranu:

  • Rashladni kontejneri na keju i na brodovima: njihovo napajanje, njihova temperaturna odstupanja i odštetni zahtevi koji iz toga proizlaze.
  • Dve uloge za početak: tehničar za rashladne kontejnere na keju i kontrolor hladnog lanca u kancelariji.
  • Pilot projekat koji se najpre sprovodi u jedinici Rotterdam, a zatim prelazi u Felixstowe.
  • Dokazi za tri skupa pravila: ATP sporazum za kvarljivu hranu, EU dobru distributivnu praksu za lekove i evidenciju o bezbednosti hrane prema HACCP sistemu (analiza opasnosti i kritične kontrolne tačke). Odštetni zahtevi prema Hag-Visbijevim pravilima koriste iste evidencije o odstupanjima, pa smo ih zabeležili za period nakon pilota.

Domenski paketi su mogućnost izdanja Enterprise. Larkfield koristi Enterprise, pa mi je put domenskog paketa bio dostupan. U izdanju Community zlatni put za paket uopšte se ne nudi.

Počnite od preporučene putanje (golden path)

Sve počinje na stranici Pokrenite nešto novo. Ona nudi šest zlatnih puteva: plugin, domenski paket, lens, platforma, veština i radni tok. Svaki od njih pravi repozitorijum iz verzionisanog šablona, manifest koji deklariše šta je potrebno, testove, razvojni prostor i grane podataka. Isti putevi funkcionišu u konzoli, na komandnoj liniji i iz Vašeg IDE okruženja (integrisano razvojno okruženje), gde alat Workbench nexus.create obavlja isti posao uz plan koji prethodno potvrđujete.

Započnite nešto novo
Započnite nešto novo
Šest zlatnih puteva, svaki sa onim što pravi, svojom komandom nexus create i svojim fiksiranim šablonom. Obratite pažnju na oznaku u dnu: manifest se sprovodi, nije savetodavan, a izdanje koje traži više zadržava se dok ga dve osobe ne pregledaju.

Sa te stranice izabrali smo put domenskog paketa, nazvavši paket cold-chain, a njegovu prvu jedinicu Rotterdam. Rezultat navodi fiksirani šablon, domain-pack@1.6.0, i ono što je napravljeno: repozitorijum, manifest koji deklariše četiri opsega, dva skladišta i nijednu odlaznu adresu, 66 testova iz šablona, razvojni prostor u Rotterdam, tri grane sintetičkih podataka i nacrt unosa u Larkfieldov sopstveni katalog koji sam samo ja mogao da vidim. Verzija šablona je fiksirana, a njena kasnija nadogradnja stiže kao pregledana izmena kao i svaka druga, tako da se ničiji paket ne menja samo zato što se promenio šablon. Za naš prvi paket ipak sam koristio čarobnjak u konzoli, jer on prikazuje plan pre nego što bilo šta napravi.

Korak 1: navedite čemu paket služi

Čarobnjak Novi domenski paket ima tri koraka: o paketu, model znanja te pregled i kreiranje. Korak 1 postavlja nekoliko pitanja koja oblikuju sve što sledi.

Polje Šta smo uneli Napomena
Naziv Cold chain Koristi se za repozitorijum i katalog
Čemu služi Rashladni kontejneri na keju i na brodovima: napajanje, temperaturna odstupanja i odštetni zahtevi koji iz toga proizlaze
Delatnost Logistika i pomorstvo Nadograđuje paket Logistics and maritime
Vlasnik Osoba koja ga kreira Zaključano u čarobnjaku
Jedinice Rotterdam (pilot) Felixstowe nakon pilota
Šablon domain-pack@1.6.0 Zaključano; nadogradnje stižu kao pregledane izmene
Pravila koja mapira ATP sporazum, EU dobra distributivna praksa, evidencija o bezbednosti hrane Svako pravilo postaje stranica u mapi dokaza paketa

Asistent na bočnoj traci predložio je poslednji red, uključujući napomenu da odštetni zahtevi za teret ponovo koriste iste evidencije o odstupanjima. Oznaka u dnu stranice navodi da još ništa nije napravljeno. Repozitorijum, razvojni prostor i grane podataka prave se tek kada pritisnete Kreiraj u koraku 3, nakon što pregledate plan. Možete sačuvati nacrt i vratiti se kasnije.

Korak 2: model znanja

Model znanja je skup vrsta stvari koje paket poznaje 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 vrste su u čarobnjaku samo za čitanje. Ako neku treba promeniti, ona se menja u paketu koji je poseduje.

Dodali smo pet sopstvenih vrsta:

Vrsta Šta je to Svojstva
Rashladna jedinica Rashladni kontejner 9
Pristajanje broda Jedan brod na jednom vezu 6
Odstupanje Temperatura izvan dozvoljenih granica 8
Napajanje Priključak za napajanje sa obale ili broda 4
Povezivanje Novac koji se traži za pokvareni teret 7
Novi domenski paket: model znanja
Novi paket domena: model znanja
Graf znanja sa pet osnovnih i pet novih vrsta. Pogledajte svojstva vrste Odstupanje desno: svako svojstvo dobija klasu u trenutku kreiranja, a oznaka navodi da su iznosi odštetnih zahteva komercijalni podaci, pa ih lensovi za tehničare ne mogu prikazati.

Svako svojstvo dobija klasu u trenutku kada ga kreirate. „Prijavio“ kod Odstupanja je lični podatak. „Vrednost ugroženog tereta“ te iznos i poravnanje odštetnog zahteva su komercijalni podaci. Prvog dana ovo je delovalo kao administracija, a kasnije nas je dvaput spasilo, jer klase određuju šta lens sme da prikaže, šta maskirana kopija zamenjuje i šta stavka u logu skriva.

Dve naše relacije sežu u osnovni model: Rashladna jedinica je priključena na Napajanje, a Odštetni zahtev se odnosi na Shipment. Sam osnovni model se ne menja. Svojstvo koje povučete ostaje u verziji 1.0 modela i uklanja se tek u nekoj kasnijoj verziji, tako da ništa što je važilo za stare zapise ne prestaje da bude čitljivo.

Korak 3: pregledajte i kreirajte

Korak 3 je plan. U njemu je navedeno šta će biti napravljeno, opsezi koje će manifest deklarisati, grane podataka i razvojni prostor. Plan potvrđujete svojim pristupnim ključem (passkey), a plan dobija otisak. Kreiranje zatim tačno prati taj plan, korak po korak, a možete se zaustaviti na bilo kom koraku i zadržati ono što je napravljeno.

Plan za Cold chain deklarisao je četiri opsega:

Opseg Zašto je paketu potreban
Čitanje telemetrije rashladnih kontejnera Očitavanja napajanja i temperature
Upis odstupanja Beleži odstupanje kada se granice prekorače
Čitanje pošiljki Povezuje odštetni zahtev sa njegovom pošiljkom
Izrada nacrta napomena uz odštetne zahteve Samo nacrti; šalje ih osoba

Njegova skladišta bila su graf i evidencije. Nije imao odlaznih adresa i koristio je sandbox profil Standard. Razvojni prostor dobio je 4 jezgra, 16 GiB memorije i 50 GiB prostora za skladištenje, mrežu zatvorenu osim za ono što manifest deklariše, isključivo potpisane image-e i gašenje nakon 7 dana neaktivnosti. Kada se ugasi, njegova definicija ostaje u repozitorijumu, pa ga odatle ponovo pravite.

Tri grane podataka potekle su iz generatora sintetičkih podataka. Nijedan podatak klijenta nije kopiran. Za maskiranu kopiju jedinice Rotterdam potrebna je saglasnost vlasnika podataka, a to je u Larkfieldu Priya Natarajan, i za nju se traži posebno.

Manifest paketa

Repozitorijum sadrži manifest paketa, pack.json. On navodi naziv paketa, njegovu verziju, paket od kojeg nasleđuje (ako postoji), njegove klastere i njegove reči. Klaster je ili lens, odnosno ono što jedna uloga vidi unutar paketa, ili deljeni klaster, koji obuhvata sve lensove. Evo jezgra 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 sopstvene reči paketa uz jednostavno objašnjenje za svaku, dovoljno kratko da se pročita na telefonu.

Pored pack.json manifest deklariše i šta paket sme da dosegne: njegove opsege, skladišta, odlazne adrese i sandbox profil. Nexus odobrava tačno to i ništa više. Svaki poziv alata proverava se u odnosu na deklarisane opsege, a spoljna adresa je blokirana ako nije navedena. Deklaraciju, kao i izmenu u odnosu na poslednje izdanje, možete pročitati na stranici Manifest i dozvole paketa.

Lensovi: šta svaka uloga vidi

Lens može samo da suzi ono što prikazuje njegova osnova, i to jedno pravilo oblikovalo je naš dizajn više od bilo kog drugog. Lens prikazuje deo onoga što prikazuje njegov osnovni lens, a dozvole i dalje potiču od uloga: lens određuje šta uloga vidi u paketu, a ne šta joj je dozvoljeno da radi.

Lens Tehničar za rashladne kontejnere sužava lens Kontrolor operacija, osnovni lens koji Larkfield već koristi za logističke poslove. U Lens builder-u označavate kartice, polja i radnje koje lens prikazuje. Stavke koje osnova ne prikazuje su zaključane.

Deo Tehničar za rashladne kontejnere prikazuje Izostavljeno
Kartice Rashladne jedinice na keju, otvorena odstupanja, priključci za napajanje, današnja pristajanja brodova Bilo šta u vezi sa odštetnim zahtevima
Polja Stanje napajanja, zadata vrednost, poslednje očitavanje, najviša temperatura Iznos odštetnog zahteva (nije u osnovnom lensu), lična polja (podrazumevano isključena)
Radnje Evidentiranje uzroka odstupanja, zahtev za proveru napajanja Promena zadate vrednosti i zatvaranje odstupanja (samo kontrolori), izrada nacrta napomene uz odštetni zahtev
Alat za izradu prikaza
Alat za izradu prikaza
Lens builder za lens Tehničar za rashladne kontejnere, označen u odnosu na njegov osnovni lens. Oznaka dole levo je odbijanje koje dobijate kada označite iznos odštetnog zahteva: osnovni lens ga ne prikazuje, pa ni ovaj lens ne može.

Ipak sam pokušao da dodam iznos odštetnog zahteva u lens za tehničare, jer je to jedan tehničar zatražio. Builder je odbio uz LENS_CANNOT_WIDEN i ništa nije sačuvao. Unutar lensa ne postoji zaobilazno rešenje: jedini put napred je lens na široj osnovi, što je drugačiji zahtev o kojem odlučuje administrator organizacije. Izostavili smo ga.

Skrivanje nečega u lensu ne uklanja to iz sistema Nexus. To znači da ova uloga to ne vidi. Builder prikazuje koliko će ljudi lens obuhvatiti u pilotu (u našem slučaju 29) i vodi log svakog dodavanja, izmene i povlačenja. Lens se definiše jednom za organizaciju i dodeljuje po jedinici nekoj ulozi na platformi, tako da isti lens Tehničar za rashladne kontejnere može ovog meseca biti dodeljen tehničarima u Rotterdam, a sledećeg tehničarima u Felixstowe.

Veština za sastavljanje nacrta beležaka o odštetnom zahtevu

Kontrolori su želeli prvi nacrt napomene koja se nakon odstupanja šalje vlasniku tereta. To je jezički posao, pa se izvršava na modelu, a pitanje je bilo gde ga smestiti.

U sistemu Nexus postoje dve vrste veština i ta razlika je ovde bitna. Manifest veština je tipizovani red u nizu skills[] plugina, koji pokreće platforma. Skills Engine veština je paket SKILL.md u biblioteci veština organizacije, koji agenti, AI (veštačka inteligencija) dugmad, radni tokovi i razvojni alati pokreću na isti način. Poglavlje 2.20, Veštine, obrađuje obe vrste.

Nivo poverenja našeg plugina je community, a community plugin sme da deklariše samo manifest veštine koje ne pristupaju modelu (host_callback i plugin_queue). Za dva nivoa koja pristupaju komponenti AI Provider Router, tool_using i llm_only, potreban je nivo poverenja core ili verified. Zato je izrada nacrta napomena uz odštetne zahteve postala Skills Engine veština, a router bira model iz Larkfieldovog sopstvenog 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 repozitorijumu, pri čemu je naziv fascikle jednak nazivu veštine. Validirali smo ga i otpremili 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-note

Ponovno otpremanje istog sadržaja vraća postojeću verziju umesto nove (CONTENT_HASH_ALREADY_PUBLISHED), pa je ponovno pokretanje otpremanja bezbedno. Pre objavljivanja verzije, Skills Engine pokreće njene test slučajeve, probno izvršavanje u senci na ranijim poslovima i slepi pregled koji obavlja model druge kompanije, uz vreme i trošak svakog izvršavanja.

Dodatak punog servisa

Paketu je bio potreban i kod koji se izvršava sve vreme: čitač toka telemetrije rashladnih kontejnera i upisivač koji otvara zapis o odstupanju kada očitavanje prekorači granice. Takav kod pripada full-service pluginu, a njegovu osnovu smo napravili sopstvenom komandom SDK-a, koja ispisuje celo referentno stablo sa zamenjenim 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-test

SDK se instalira sa https://registry.adverant.ai/npm/ pomoću pull tokena sa stranice Pull tokeni i komande za instalaciju u Vašem Adverant nalogu. Komitujte package-lock.json koji zapisuje prva instalacija; izgradnja image-a pokreće npm ci i odbija da se izvrši bez njega.

Ovo je deo našeg nexus.manifest.json koji se razlikuje od šablona. To nije cela datoteka: blokovi description, author, license, runtime, backend i frontend iz osnovne strukture ostaju kakvi jesu, a validator odbija manifest punog servisa bez njih. Tri rečenice architecture predstavljaju pravilo koje svaki plugin ponavlja, a validator proverava njihov tekst. UNO u prvoj od njih je mehanizam za tokove 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 skill manifesta sa nivoom host_callback: platforma šalje ulazne podatke našem sopstvenom Service-u, unutar našeg namespace-a, i nikada hostu koji mi navedemo. Ruta prijemnika je deklarisana kao auth: internal i zaštićena SDK zaštitom serviceMiddleware, Express oblikom zaštite, koja odbija token poziva izdat za bilo koji drugi plugin, organizaciju, skill ili rutu. Njen classification je tenant, što je gornja granica za plugin zajednice. Poglavlje 2.27, Scenariji izgradnje, zasebno prikazuje skill tipa host_callback.

Dve navike iz ove faze vredi preuzeti. Svaka tabela sadrži organization_id, owner_user_id i business_unit_id od prve migracije, jer je naknadno dodavanje ose migracija nad aktivnim redovima. Takođe smo pokretali nexus-gates lokalno pre svakog push-a, budući da je to ista komanda koju pokreće pipeline; izvršavanje koje ništa nije proverilo završava se kodom 2 i to navodi. Poglavlje 2.19, Pravila koja nasleđuje svako proširenje, navodi kontrolne tačke.

Probni podaci za testiranje

Stranica Uzorci podataka za testiranje nudi tri vrste grana:

Vrsta Šta sadrži Ko odobrava
Sintetički podaci Podaci generisani na osnovu brojeva i oblika koje Vi zadate; ništa ne potiče iz stvarne jedinice Niko; grana je Vaša
Maskirana kopija Kopija jedinice u kojoj su lična, osetljiva i komercijalna polja zamenjena Vlasnik podataka (Priya Natarajan za Rotterdam)
Samo šema Struktura skladišta, bez redova Niko; za migracije

Generisali smo jednu prometnu nedelju: oko 7 temperaturnih odstupanja na svakih 100 rashladnih kontejnera, što odgovara prometnom avgustu u Rotterdamu. Neobični slučajevi bili su važniji od obima. Zatražili smo nestanak napajanja tokom istovara, ostavljena otvorena vrata, prekid u radu senzora i dva odštetna zahteva za jedno odstupanje. Stranica može da predloži neobične slučajeve na osnovu uzroka odstupanja iz modela znanja, a nikada na osnovu stvarnih zapisa.

Svaki skup brojeva i oblika čuva se kao seed, na primer cold-chain-busy-01, zajedno sa svojim otiskom. Isti seed daje iste podatke, tako da svako testiranje na svakoj grani vidi istu nedelju. Upravo je to učinilo naših 66 testova ponovljivim.

Grana podrazumevano traje 72 sata, a najduže 14 dana. Zatražio sam da našu prometnu granu zadržimo 30 dana tokom dugog pregleda, a stranica je to odbila uz BRANCH_LIFE_EXCEEDED. Rešenje je ono koje poruka predlaže: zadržite seed i napravite novu granu iz njega kada Vam bude potrebna. Maskirana kopija podleže istim ograničenjima, a njen zahtev sadrži razlog i trajanje od najviše 14 dana.

Pregled sočiva iz ugla određene osobe

Pre nego što je iko u Rotterdamu video Cold chain, pogledali smo ga onako kako bi ga oni videli. Funkcija Pregled sočiva iz ugla osobe prikazuje paket tačno onako kako ga vidi izabrana uloga, na grani podataka, unutar isprekidanog okvira za pregled.

Pregled sočiva iz ugla osobe
Pregled sočiva iz ugla određene osobe
Cold chain onako kako ga vidi tehničar za rashladne kontejnere u Rotterdamu, na sintetičkoj grani. Obratite pažnju na kolonu odštetnog zahteva označenu sa „sakriveno sočivom” kod svakog otvorenog odstupanja, kao i na bočni panel koji navodi šta ovo sočivo sakriva i zašto.

Tri pravila omogućavaju da se pregledi bezbedno slobodno koriste. Pregled koristi granu podataka, nikada aktivnu jedinicu. Vaše sopstvene dozvole ne prenose se na njega, tako da vidite ono što vidi uloga, a ne ono što Vi možete da vidite. I pregled se završava nakon 30 minuta. Usmeravanje pregleda na aktivnu jedinicu odbija se uz CONNECTION_SCOPE_EXCEEDED; ako su Vam potrebni stvarni oblici podataka, zatražite od vlasnika podataka maskiranu kopiju i pregledajte na njoj.

Upravo smo u pregledu otkrili stvarnu grešku. Grafikon temperature u prikazu za tehničare prikazivao je zadatu vrednost, a izmene zadate vrednosti bile su namenjene samo kontrolorima. Grafikon je bio u redu; dugme za izmenu ispod njega nije. Verzija 0.3.2 sakrila je izmene zadate vrednosti od tehničara, a to smo otkrili upravo u pregledu.

Izmena modela znanja nakon isporuke

Do verzije 0.4.0 bila nam je potrebna vrsta Inspekcija za inspekcije pre transporta, a relacija „Odstupanje je prouzrokovalo Odštetni zahtev” bolje je glasila kao „Odstupanje je dovelo do Odštetnog zahteva”. Prelazak modela sa 1.3 na 1.4 predstavlja promenu modela znanja, a stranica Promene modela znanja prikazuje njen diff, šta bi promena obuhvatila i u kojoj je fazi.

Promena se prenosi kao zahtev za promenu grafa. Njeno probno izvršavanje broji šta bi obuhvatila na maskiranoj kopiji Rotterdama, u vidu brojeva: u našem slučaju 1.284 preimenovane veze i ništa uklonjeno. Dva recenzenta je odobravaju, a pipeline je primenjuje na staging, zatim na pilot. Niko ne upisuje ručno u deljeni graf; svaki pokušaj se odbija i evidentira. Tri sačuvana upita koristila su reč „prouzrokovalo”, a promena je za svaki od njih sadržala automatsko preformulisanje, koje je stranica navela. Filteri sočiva nisu se promenili, jer su oba sočiva i dalje samo sužavala prikaz.

Prebacivanje u produkciju

Svako izdanje prolazi istim putem: razvojni prostor, staging, pilot jedinica, zatim sve jedinice. Svaki korak ima kontrolne tačke i nijedna se ne preskače.

Prelazak u Kontrole
Staging Svi testovi prolaze; provere kvaliteta; manifest nepromenjen ili prihvaćeno proširenje; potpisana slika
Pilot (Rotterdam) Probno izvršavanje promene modela na maskiranoj kopiji bez grešaka; provera politika za pravila sočiva i opsega; dva recenzenta koji nisu autori, od kojih je jedan vlasnik podataka
Sve jedinice 14 dana u pilotu; greške ispod 1 na 1.000, brojano u pilotu; svaki administrator jedinice odobrava za svoju jedinicu; dva recenzenta koji nisu autori
Okruženja i promocija
Okruženja i promocija
Cold chain 0.3.2 čeka na kontrolnoj tački pilota svog drugog recenzenta. Poruka desno je odbijanje pokušaja da se izdanje unapredi direktno iz razvojnog prostora na sve jedinice.

Jednom sam, u petak, pokušao prečicu zbog ispravke od jednog reda: da unapredim 0.4.0-dev iz svog razvojnog prostora na sve jedinice. Pokušaj je odbijen uz GATE_CANNOT_BE_SKIPPED i ništa nije unapređeno. Poruka Vam savetuje da umesto toga unapredite izdanje na sledeći korak, i to je jedini mogući odgovor.

Sam pregled izdanja, dokazi koje čita drugi recenzent i kanali koje jedinice biraju opisani su u poglavlju 2.28, Objavljivanje Vašeg proširenja. Dve činjenice odande pripadaju ovde, jer utiču na to kako planirate vertikalu. Autor se nikada ne računa kao recenzent, tako da je timu od dve osobe potrebna treća osoba za svako izdanje. Takođe, svako okruženje čuva prethodnu verziju 30 dana, tako da je vraćanje na nju recenzirana promena koju pipeline izvršava za otprilike minut.

Proširivanje paketa koji već postoji

Ne počinje svaka vertikala od nule. Paket može da nasledi drugi paket i doda samo ono što je drugačije. Paket Bankarstvo i plaćanja, koji koristi Larchmont Bank, najjasniji je primer 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 navodi paket na kojem se gradi. Bankarstvo i plaćanja zadržava strukturu paketa Osiguranje, njegove zajedničke klastere razgovora i osnovne pojmove, i dodaje tri sopstvena sočiva: Odluke o kreditima, Sporovi oko kartica i Moj račun. Treći element svake stavke leksikona je exact za pojam koji mora da se prikaže onako kako je napisan, na primer APR (godišnja kamatna stopa), umesto da se preformuliše.

Neke stvari se ne mogu postići nasleđivanjem. Paket nikada ne menja okvir, komponente ni pravila pisanja, tako da izvedeni paket ne može da promeni stil konzole. Regulatorni režim koji je potreban većem broju paketa predstavlja jedno zajedničko sočivo, a ne kopiju u svakom od njih: registar eksternalizovane tehnologije služi i paketu Osiguranje i paketu Bankarstvo i plaćanja. Ako je Vašem izvedenom paketu potrebno sočivo koje već postoji kao zajedničko, koristite njega umesto da izrađujete sopstveno.

Licenciranje prati nasleđivanje. Paket se licencira povrh izdanja Enterprise i može da zahteva dodatke, a dokument licence sadrži te zavisnosti. Paket Osiguranje zahteva Sobe za odlučivanje i zapečaćene zapise, tako da je kupcu koji licencira paket izveden iz njega takođe potreban taj dodatak, a konzola odbija da izda licencu koja ga izostavlja. Ekranima paketa za telefon potreban je i dodatak Mobilne aplikacije. Proverite lanac zahteva pre nego što kupcu obećate datum.

Dodavanje sočiva paketu koji je već isporučen

Najmanji obim rada na vertikali je novo sočivo na paketu koji niste Vi napisali. Šest meseci nakon početka pilota, tim kompanije Larkfield za pomorske odštetne zahteve poželeo je sopstveno sočivo unutar Cold chain-a: odstupanja i odštetni zahtevi, bez priključaka za napajanje i bez zadatih vrednosti. Nismo dirali kod paketa. Sočivo je red u registru sočiva organizacije, u vlasništvu paketa, pa smo ga započeli iz zlatne putanje za sočiva na stranici Započnite nešto novo i oblikovali ga u alatu Lens builder, sa sočivom kontrolora Cold-chain kao osnovom. Važi isto pravilo kao i ranije: novo sočivo može da sakrije ono što njegova osnova prikazuje, ali nikada ne može da prikaže više. Definiše se jednom za organizaciju i dodeljuje se ulozi platforme u svakoj jedinici. Dodela se povlači, nikada ne briše, a ponovno davanje sočiva stvara novu dodelu, tako da ostaje čitljivo ko je koje sočivo imao i kada. Registar broji koliko je osoba imalo sočivo svakog meseca, a nikada ko.

Stranica Sočiva i ko ih vidi prikazuje rezultat kao matricu sočiva po jedinici i ulozi, sa opcijama Dodaj, Izmeni i Povuci u svakoj ćeliji. Pregledajte novo sočivo iz ugla osobe pre nego što ga dodelite, tačno kao što je gore opisano.

Koliko je to koštalo, iskreno

Paket pristupa zapisima kupca, pa platforma namerno usporava neke stvari, i na njih treba da računate od prvog dana.

  1. Za maskiranu kopiju svaki put je potrebna saglasnost vlasnika podataka. Naša je prvi put stigla tek nakon jednog dana, jer je Priya želela prvo da pročita model znanja. Počnite sa sintetičkim podacima i zatražite saglasnost na vreme.
  2. Autor ne može da odobri sopstveno izdanje, a zahtevi ističu nakon 3 dana. Ako su Vaši recenzenti zauzeti, Vaše izdanje čeka.
  3. Izdanje koje traži više od prethodnog, na primer slanje pošte ili jednu spoljnu adresu, zadržava se dok dva recenzenta ne prihvate prošireni manifest. Poglavlje 2.28, Objavljivanje Vašeg proširenja, prikazuje stranicu Manifest i dozvole koja Vas o tome obaveštava pre nego što podnesete zahtev.
  4. Sočivo ne može da prikaže ono što njegovo osnovno sočivo sakriva. Ako je ulozi zaista potrebno više, o tome se razgovara sa administratorom organizacije; to nije podešavanje.

Nijedno od ovoga nas nije sputalo dvaput. Drugo izdanje Cold chain-a stiglo je od prvog commit-a do pilota u Rotterdamu za nedelju dana, a najveći deo tog vremena otišao je na izvršavanje 66 testova na tri grane i na dve osobe koje su čitale dokaze.