Različica 1.0.0-alpha.1najnovejša
Poglavje 2.24
Celovita izdelava prilagojene vertikale
Praktični prikaz izdelave domenskega paketa za hladno verigo (Cold chain), od prvega osnutka do izdaje, ki se izvaja za vsako enoto, vključno z njegovim modelom znanja, pogledi (lenses), veščino, celovitim vtičnikom in vzorčnimi podatki. Sledi prikaz, kako razširiti že obstoječi paket in kako dodati pogled paketu, ki je že bil izdan.
To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

Sem Mateo Ruiz, razvijalec v podjetju Corrán Orbital. Večino tedna porabim za našo lastno programsko opremo za tovor, toda to poglavje govori o delu, ki smo ga opravili za stranko. Larkfield & Vane zavaruje tovor, pri čemer vse večji delež tega tovora potuje v hlajenih zabojnikih. Ko hladilni zabojnik na pomolu izgubi kopensko napajanje, temperatura naraste, tovor se pokvari in čez nekaj tednov sledi odškodninski zahtevek. V podjetju Larkfield so želeli, da bi njihovi zaposleni to verigo v sistemu Nexus videli kot eno celoto, od izpada napajanja do odškodninskega zahtevka, pri čemer bi vsaka vloga videla le svoj del. Tako je nastal paket Cold chain.
V nadaljevanju je opisana izdelava v vrstnem redu, kot smo jo izvedli, skupaj z zasloni, datotekami in ukazi. Napake sem ohranil, saj sta nas dve zavrnitvi, na kateri smo naleteli, o platformi naučili več kot pa pot brez zapletov. Referenčno gradivo se nahaja v predhodnih poglavjih, zato se nanje le sklicujem, namesto da bi jih ponavljal. Najbolj sem se opiral na poglavje 2.18, Razširitveni model, in poglavje 2.23, Domenski paketi, medtem ko sem imel poglavje 2.21, Vtičniški SDK, odprto poleg njiju za sam komplet za razvoj programske opreme.
Projektna naloga in razdelitev vlog
Podjetje Larkfield mi je za čas trajanja projekta dodelilo razvijalsko mesto v svoji organizaciji. To je pomembno, saj se zasebni paket za eno stranko gradi znotraj namestitve te stranke, v njenih razvojnih prostorih in podatkovnih vejah ter pod odobritvami njenih ljudi. Paket, namenjen več strankam, se gradi drugače, na gruči izdajatelja in le z vzorčnimi podatki, kar obravnava poglavje 2.25, Izdelava za posamezno izdajo.
Projektna naloga je obsegala eno stran:
- Hladilni zabojniki na pomolu in na plovilih: njihovo napajanje, temperaturna odstopanja in odškodninski zahtevki, ki sledijo.
- Dve vlogi za začetek: tehnik za hladilne zabojnike na pomolu in nadzornik hladne verige v pisarni.
- Pilotni projekt, ki se najprej izvaja v enoti Rotterdam in se nato preseli v Felixstowe.
- Dokazila za tri sklope pravil: sporazum ATP za hitro pokvarljiva živila, dobre distribucijske prakse EU za zdravila in evidence o varnosti živil v skladu s sistemom HACCP (analiza tveganj in kritične nadzorne točke). Zahtevki po Haaško-Visbyjskih pravilih uporabljajo iste zapise o odstopanjih, zato smo si jih zabeležili za čas po pilotnem projektu.
Domenski paketi so zmogljivost izdaje Enterprise. Podjetje Larkfield uporablja izdajo Enterprise, zato mi je bila pot za domenski paket odprta. V izdaji Community zlata pot za paket sploh ni na voljo.
Začnite po zlati poti
Vse se začne na strani Začni nekaj novega. Ponuja šest zlatih poti: vtičnik, domenski paket, pogled, platforma, veščina in delovni tok. Vsaka ustvari repozitorij iz predloge z določeno različico, manifest, ki določa, kaj element potrebuje, teste, razvojni prostor in podatkovne veje. Iste poti delujejo v konzoli, v ukazni vrstici in v vašem IDE-ju (integriranem razvojnem okolju), kjer orodje Workbench nexus.create opravi enako delo z načrtom, ki ga najprej potrdite.
nexus create in pripeto predlogo. Bodite pozorni na obvestilo na dnu: manifest je uveljavljen, ne le priporočen, in izdaja, ki zahteva več, je zadržana, dokler je ne pregledata dve osebi.Na tej strani smo izbrali pot domenskega paketa, paket poimenovali cold-chain, njegovo prvo enoto pa Rotterdam. Rezultat navaja pripeto predlogo, domain-pack@1.6.0, in našteje, kaj je ustvarila: repozitorij, manifest s štirimi obsegi, dvema shrambo in brez izhodnih naslovov, 66 testov iz predloge, razvojni prostor v Rotterdamu, tri sintetične podatkovne veje in osnutek vnosa v lastnem katalogu podjetja Larkfield, ki sem ga lahko videl le jaz. Različica predloge je pripeta in njena kasnejša nadgradnja prispe kot pregledana sprememba, tako kot vsaka druga, zato se nobenemu uporabniku paket ne spremeni sam od sebe, ker bi se spremenila predloga. Za naš prvi paket sem kljub temu uporabil čarovnika v konzoli, ker prikaže načrt, preden karkoli ustvari.
1. korak: določite namen paketa
Čarovnik Nov domenski paket ima tri korake: o paketu, model znanja ter pregled in ustvarjanje. Korak 1 zahteva tistih nekaj podatkov, ki oblikujejo vse za tem.
| Polje | Kaj smo vnesli | Opomba |
|---|---|---|
| Ime | Hladna veriga | Uporablja se za repozitorij in katalog |
| Čemu je namenjen | Hladilni zabojniki na pomolu in na plovilih: napajanje, temperaturna odstopanja in odškodninski zahtevki, ki sledijo | |
| Panoga | Logistika in pomorstvo | Temelji na paketu Logistika in pomorstvo |
| Lastnik | Oseba, ki ga ustvarja | Zaklenjeno v čarovniku |
| Enote | Rotterdam (pilotni projekt) | Felixstowe po pilotnem projektu |
| Predloga | domain-pack@1.6.0 |
Zaklenjeno; nadgradnje prihajajo kot pregledane spremembe |
| Pravila, ki jih preslikava | Sporazum ATP, dobra distribucijska praksa EU, evidence o varnosti živil | Vsako pravilo postane stran na zemljevidu dokazil paketa |
Pomočnik v vrstici je predlagal zadnjo vrstico, vključno s poudarkom, da odškodninski zahtevki za tovor ponovno uporabijo iste zapise o odstopanjih. Obvestilo na dnu strani pravi, da ni še nič ustvarjeno. Repozitorij, razvojni prostor in podatkovne veje se ustvarijo šele, ko na koraku 3 pritisnete Ustvari, potem ko ste si ogledali načrt. Osnutek lahko shranite in se vrnete kasneje.
2. korak: model znanja
Model znanja je nabor vrst entitet, ki jih paket pozna, in načinov, kako se povezujejo. Paket Cold chain se je začel iz osnovnega logističnega modela, logistics-base 4.2, uvoženega iz SDK-ja, kar nam je dalo pet osnovnih vrst za nadgradnjo (Plovilo, Pristanišče, Zabojnik, Prevoznik in Pošiljka). Osnovne vrste so v čarovniku samo za branje. Če je treba katero spremeniti, se spremeni v paketu, ki si jo lasti.
Dodali smo pet lastnih vrst:
| Vrsta | Kaj to je | Lastnosti |
|---|---|---|
| Hladilna enota | Hlajeni zabojnik | 9 |
| Postanek plovila | Eno plovilo na enem privezu | 6 |
| Odstopanje | Temperatura zunaj svojih omejitev | 8 |
| Napajanje | Točka napajanja na kopnem ali ladji | 4 |
| Prevzem (Claim) | Denar, zahtevan za pokvarjen tovor | 7 |
Vsaka lastnost je razvrščena že med ustvarjanjem. »Poročal« pri vrsti Odstopanje je osebni podatek. »Ogrožena vrednost tovora« ter znesek in poravnava zahtevka so poslovni podatki. Prvi dan se je to zdelo kot odvečna birokracija, a nas je kasneje dvakrat rešilo, saj razredi določajo, kaj pogled sme prikazati, kaj prikrita kopija nadomesti in kaj vrstica dnevnika skrije.
Dve naši relaciji segata v osnovni model: Hladilna enota je priključena na Napajanje, Zahtevek pa se nanaša na Pošiljko. Sam osnovni model se ne spremeni. Lastnost, ki jo umaknete, ostane v različici 1.0 modela in se odstrani šele v kasnejši različici, tako da nič, kar je veljalo za stare zapise, ne postane neberljivo.
3. korak: pregled in ustvarjanje
Korak 3 je načrt. Navaja, kaj bo ustvarjeno, katere obsege bo določal manifest, podatkovne veje in razvojni prostor. Načrt potrdite s svojim potrdilnim ključem, nakar načrt dobi prstni odtis. Ustvarjanje nato natančno sledi temu načrtu, korak za korakom, pri čemer se lahko ustavite na katerem koli koraku in obdržite tisto, kar je bilo ustvarjeno.
Načrt za paket Cold chain je določal štiri obsege:
| Obseg | Zakaj ga paket potrebuje |
|---|---|
| Branje telemetrije hladilnih zabojnikov | Odčitki napajanja in temperature |
| Zapisovanje odstopanj | Zabeleži odstopanje, ko so meje presežene |
| Branje pošiljk | Poveže zahtevek z njegovo pošiljko |
| Priprava osnutkov obvestil o zahtevkih | Samo osnutki; pošlje jih oseba |
Njegovi shrambi sta bili graf in zapisi. Imel ni nobenih izhodnih naslovov in je uporabljal profil peskovnika Standard. Razvojni prostor je vključeval 4 jedra, 16 GiB pomnilnika in 50 GiB prostora za shranjevanje, zaprto omrežje z izjemo tistega, kar določa manifest, samo podpisane slike ter prekinitev po 7 dneh nedejavnosti. Ko se prekine, njegova definicija ostane v repozitoriju, tako da ga lahko od tam znova ustvarite.
Tri podatkovne veje so prišle iz sintetičnega generatorja. Nobeni podatki strank niso bili kopirani. Prikrita kopija Rotterdama potrebuje soglasje lastnika podatkov, kar je v podjetju Larkfield Priya Natarajan, za to pa zaprosite ločeno.
Manifest paketa
Repozitorij hrani manifest paketa, pack.json. Navaja ime paketa, njegovo različico, paket, iz katerega deduje (če obstaja), njegove sklope in njegovo besedišče. Sklop je bodisi pogled, kar pomeni tisto, kar posamezna vloga vidi znotraj paketa, bodisi deljen element, ki deluje prek vseh pogledov. Tukaj je jedro našega:
{
"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", ""]
]
}
}Besednjak hrani lastne besede paketa s preprosto razlago za vsako, dovolj kratko za branje na telefonu.
Poleg datoteke pack.json manifest določa tudi, do česa sme paket dostopati: njegove obsege, shrambe, izhodne naslove in profil peskovnika. Nexus odobri natanko to in nič več. Vsak klic orodja se preveri glede na določene obsege, zunanji naslov pa je blokiran, razen če je naveden na seznamu. Deklaracijo in spremembe v primerjavi z zadnjo izdajo si lahko preberete na strani Manifest in dovoljenja znotraj paketa.
Pogledi (lenses): kaj vidi posamezna vloga
Pogled lahko vedno le zoži tisto, kar prikazuje njegova osnova, in to edino pravilo je oblikovalo našo zasnovo bolj kot katero koli drugo. Pogled prikazuje del tistega, kar prikazuje njegov osnovni pogled, dovoljenja pa še vedno izhajajo iz vlog: pogled določa, kaj vloga vidi v paketu, ne pa tega, kaj sme početi.
Pogled Tehnik za hladilne zabojnike zoži pogled Nadzornik operacij, ki je osnovni pogled, ki ga podjetje Larkfield že uporablja za logistično delo. V Graditelju pogledov odkljukate kartice, polja in dejanja, ki jih pogled prikazuje. Elementi, ki jih osnova ne prikazuje, so zaklenjeni.
| Del | Tehnik za hladilne zabojnike prikazuje | Izpuščeno |
|---|---|---|
| Kartice | Hladilne enote na pomolu, odprta odstopanja, točke napajanja, postanki plovil danes | Karkoli v zvezi z zahtevki |
| Polja | Stanje napajanja, nastavljena vrednost, zadnji odčitek, najvišja temperatura | Znesek zahtevka (ni v osnovnem pogledu), osebna polja (privzeto izklopljena) |
| Dejanja | Beleženje vzroka odstopanja, zahteva za preverjanje napajanja | Spreminjanje nastavljene vrednosti in zapiranje odstopanja (samo nadzorniki), priprava osnutka obvestila o zahtevku |
Kljub temu sem poskusil dodati znesek zahtevka v pogled za tehnika, ker je nek tehnik zanj prosil. Graditelj je to zavrnil s kodo LENS_CANNOT_WIDEN in ni shranil ničesar. Znotraj pogleda ni obvoza: pot naprej je pogled na širši osnovi, kar je drugačna zahteva, o kateri odloča skrbnik organizacije. Zato smo to izpustili.
Skrivanje nečesa v pogledu tega ne odstrani iz sistema Nexus. Pomeni le, da ta vloga tega ne vidi. Graditelj prikazuje, koliko ljudi bo pogled dosegel v pilotnem projektu (29 v našem primeru), in vodi dnevnik vsakega Dodajanja, Spremembe in Umika. Pogled se določi enkrat za organizacijo in se dodeli vlogi platforme za posamezno enoto, tako da se isti pogled Tehnik za hladilne zabojnike lahko ta mesec dodeli tehnikom v Rotterdamu, naslednji mesec pa tistim v Felixstowu.
Veščina za pripravo osnutkov zapiskov o zahtevkih
Nadzorniki so želeli prvi osnutek obvestila, ki gre lastniku tovora po odstopanju. To je jezikovno delo, zato teče na modelu, vprašanje pa je bilo, kam ga umestiti.
V sistemu Nexus obstajata dve vrsti veščin in razlika je tukaj pomembna. Manifestna veščina je tipizirana vrstica v polju skills[] manifesta vtičnika, ki jo razpošilja platforma. Veščina pogona Skills Engine je paket SKILL.md v knjižnici veščin organizacije, ki ga agenti, gumbi za UI (umetno inteligenco), delovni tokovi in razvijalska orodja izvajajo na enak način. Poglavje 2.20, Veščine, obravnava oboje.
Stopnja zaupanja našega vtičnika je community, skupnostni vtičnik pa sme določati le manifestne veščine, ki ne segajo do modela (host_callback in plugin_queue). Dve ravni, ki segata do usmerjevalnika AI Provider Router, tool_using in llm_only, potrebujeta zaupanje core ali verified. Tako je priprava osnutkov obvestil o zahtevkih postala veščina pogona Skills Engine, usmerjevalnik pa izbere model iz lastnega nabora podjetja 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.Paket se nahaja v mapi skills/draft-claim-note/ v repozitoriju, pri čemer je ime mape enako imenu veščine. Preverili in naložili smo ga prek 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Če isto vsebino naložite dvakrat, sistem vrne obstoječo različico namesto nove (CONTENT_HASH_ALREADY_PUBLISHED), zato je ponovno nalaganje varno. Preden gre različica v uporabo, pogon Skills Engine zažene njene testne primere, poskusni zagon v senci na preteklem delu in slepi pregled z modelom drugega podjetja, skupaj s časom in stroški vsakega zagona.
Celoviti vtičnik
Paket je potreboval tudi kodo, ki teče ves čas: bralnik za vir telemetrije hladilnih zabojnikov in zapisovalnik, ki odpre zapis o odstopanju, ko odčitek preseže meje. Takšna koda sodi v polno storitveni vtičnik, ogrodje zanj pa smo ustvarili z lastnim ukazom SDK-ja, ki zapiše celotno referenčno drevo z zamenjanim imenom:
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 namesti iz naslova https://registry.adverant.ai/npm/ z žetonom za prenos (pull token) s strani Žetoni za prenos in ukazi za namestitev v vašem računu Adverant. Potrdite (commit) datoteko package-lock.json, ki jo zapiše prva namestitev; gradnja slike zažene npm ci in brez nje postopek zavrne.
Tukaj je del naše datoteke nexus.manifest.json, ki se razlikuje od predloge. To ni celotna datoteka: bloki ogrodja description, author, license, runtime, backend in frontend ostanejo takšni, kot so, validator pa zavrne manifest polne storitve brez njih. Trije stavki architecture so pravilo, ki ga ponovi vsak vtičnik, validator pa preveri ubeseditev. UNO v prvem stavku je pogon delovnega toka:
{
"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 manifestna veščina z ravnjo host_callback: platforma pošlje vhodne podatke naši lastni Storitvi, znotraj našega imenskega prostora, in nikoli gostitelju, ki bi ga imenovali mi. Sprejemna pot je določena kot auth: internal in varovana z elementom serviceMiddleware iz SDK-ja, ki je oblika varovala za Express in zavrne klicni žeton, izdan za kateri koli drug vtičnik, organizacijo, veščino ali pot. Njen classification je tenant, kar je zgornja meja za skupnostni vtičnik. Poglavje 2.27, Scenariji izdelave, samostojno predstavi veščino host_callback.
Dve navadi iz te faze sta vredni posnemanja. Vsaka tabela že od prve migracije nosi organization_id, owner_user_id in business_unit_id, saj je dodajanje osi kasneje migracija čez žive vrstice. Poleg tega smo pred vsakim potiskom (push) lokalno zagnali nexus-gates, saj je to isti ukaz, ki ga zažene cevovod; zagon, ki ni pregledal ničesar, se konča s kodo 2 in to tudi sporoči. Poglavje 2.19, Pravila, ki jih podeduje vsaka razširitev, navaja vse kontrolne točke.
Vzorčni podatki za testiranje
Stran Vzorčni podatki za testiranje ponuja tri vrste vej:
| Vrsta | Kaj vsebuje | Kdo odobri |
|---|---|---|
| Sintetična | Podatki, ustvarjeni iz številk in oblik, ki jih nastavite; nič ne izvira iz resnične enote | Nihče; je vaša |
| Prikrita kopija | Kopija enote z nadomeščenimi osebnimi, občutljivimi in poslovnimi polji | Lastnik podatkov (Priya Natarajan za Rotterdam) |
| Samo shema | Oblika shramb, brez vrstic | Nihče; za migracije |
Ustvarili smo živahen teden: približno 7 odstopanj na vsakih 100 hladilnih zabojnikov, kakršen je običajno živahen avgust v Rotterdamu. Nenavadni primeri so bili pomembnejši od količine. Zahtevali smo izgubo napajanja med razkladanjem, odprta vrata, vrzel v delovanju senzorja in dva zahtevka za eno odstopanje. Stran lahko predlaga nenavadne primere na podlagi vzrokov odstopanj v modelu znanja, nikoli pa iz resničnih zapisov.
Vsak nabor številk in oblik se shrani kot seme, na primer cold-chain-busy-01, s svojim prstnim odtisom. Isto seme da iste podatke, tako da vsak testni zagon na vsaki veji vidi isti teden. To je omogočilo ponovljivost naših 66 testov.
Veja privzeto živi 72 ur in največ 14 dni. Med dolgim pregledom sem želel našo obremenjeno vejo obdržati 30 dni, vendar je stran to zavrnila s kodo BRANCH_LIFE_EXCEEDED. Rešitev je tista, ki jo predlaga obvestilo: obdržite seme in iz njega ustvarite svežo vejo, ko jo potrebujete. Prikrita kopija sledi istim omejitvam, zahteva zanjo pa vključuje razlog in trajanje do 14 dni.
Predogled pogleda kot določena oseba
Preden je kdorkoli v Rotterdamu videl paket Cold chain, smo si ga ogledali tako, kot bi si ga oni. Predogled pogleda kot oseba izriše paket natanko tako, kot ga vidi izbrana vloga, na podatkovni veji, znotraj črtkanega okvira za predogled.
Tri pravila omogočajo varno in prosto uporabo predogledov. Predogled uporablja podatkovno vejo, nikoli žive enote. Vaša lastna dovoljenja ne pronicanjo vanj, zato vidite tisto, kar vidi vloga, in ne tistega, kar lahko vidite vi. Poleg tega se konča po 30 minutah. Usmerjanje predogleda na živo enoto se zavrne s kodo CONNECTION_SCOPE_EXCEEDED; če potrebujete resnične oblike podatkov, prosite lastnika podatkov za prikrito kopijo in predogled opravite na njej.
V predogledu smo ujeli resnično napako. Temperaturni grafikon v pogledu za tehnika je prikazoval nastavljeno vrednost, urejanje nastavljene vrednosti pa je bilo namenjeno le nadzornikom. Grafikon je bil v redu; gumb za urejanje pod njim pa ne. Različica 0.3.2 je urejanje nastavljene vrednosti skrila pred tehniki, odkrili pa smo to prav v predogledu.
Spreminjanje modela znanja po izdaji
Do različice 0.4.0 smo potrebovali vrsto Pregled za preglede pred potovanjem, relacija »Odstopanje je povzročilo Zahtevek« pa se je bolje brala kot »Odstopanje je privedlo do Zahtevka«. Premik modela z različice 1.3 na 1.4 je sprememba modela znanja, stran Spremembe modela znanja pa prikazuje njeno razliko (diff), česa bi se dotaknila in kje na svoji poti se nahaja.
Sprememba potuje kot zahteva za spremembo grafa. Njen poskusni zagon prešteje, česa bi se dotaknila na prikriti kopiji Rotterdama, v obliki številk: v našem primeru 1.284 preimenovanih povezav in nič odstranjenega. Odobrita jo dva pregledovalca, cevovod pa jo uveljavi v predprodukcijskem okolju in nato v pilotnem projektu. Nihče ne piše v deljeni graf ročno; poskus se zavrne in zabeleži. Tri shranjena vprašanja so uporabljala besedo »povzročilo«, sprememba pa je za vsako od njih vsebovala samodejni prepis, ki ga je stran navedla. Filtri pogledov se niso spremenili, saj sta oba pogleda še vedno le ožila prikaz.
Prenos v produkcijo
Vsaka izdaja se pomika po eni poti: razvojni prostor, predprodukcija, pilotna enota, nato vse enote. Vsak korak ima kontrolne točke in nobena se ne preskoči.
| V | Vrata |
|---|---|
| Predprodukcijo | Vsi testi uspešni; preverjanja kakovosti; manifest nespremenjen ali pa je razširitev sprejeta; podpisana slika |
| Pilotni projekt (Rotterdam) | Poskusni zagon spremembe modela na prikriti kopiji brez napak; preverjanje pravilnika glede pravil za poglede in obsege; dva pregledovalca, ki nista avtor, eden od njiju lastnik podatkov |
| Vse enote | 14 dni v pilotnem projektu; napake pod 1 na 1.000, štete v pilotnem projektu; skrbnik vsake enote se strinja za svojo enoto; dva pregledovalca, ki nista avtor |
Enkrat, v petek, sem poskusil ubrati bližnjico za popravek v eni vrstici: napredovanje različice 0.4.0-dev iz mojega razvojnega prostora v vse enote. Zavrnjeno je bilo s kodo GATE_CANNOT_BE_SKIPPED in nič ni napredovalo. Obvestilo vam naroči, da namesto tega napredujete na naslednji korak, in to je edini možni odgovor.
Sam pregled izdaje, dokazila, ki jih prebere drugi pregledovalec, in kanali, ki jih izberejo enote, so opisani v poglavju 2.28, Izdajanje vaše razširitve. Dve dejstvi iz tega poglavja sodita sem, saj oblikujeta način načrtovanja vertikale. Avtor nikoli ne šteje kot pregledovalec, zato dvočlanska ekipa za vsako izdajo potrebuje tretjo osebo. Poleg tega vsako okolje hrani prejšnjo različico 30 dni, tako da je povrnitev pregledana sprememba, ki jo cevovod opravi v približno eni minuti.
Razširitev že obstoječega paketa
Vsaka vertikala se ne začne iz nič. Paket lahko deduje iz drugega in doda le tisto, kar je drugačno. Paket Bančništvo in plačila, ki ga uporablja Larchmont Bank, je najjasnejši primer v katalogu. Njegov manifest se začne takole:
{
"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 katerem temelji. Paket Bančništvo in plačila ohranja obliko paketa Zavarovalništvo, njegove deljene pogovorne sklope in njegove osnovne besede ter dodaja tri lastne poglede: Odločitve o posojilih, Spori glede kartic in Moj račun. Tretji element vsakega vnosa v besednjaku je exact za izraz, ki mora biti prikazan tako, kot je zapisan, na primer APR (letna obrestna mera), namesto da bi bil preoblikovan.
Nekaterih stvari z dedovanjem ne morete narediti. Paket nikoli ne spremeni lupine, komponent ali pravil pisanja, zato podrejeni paket ne more preoblikovati sloga konzole. Režim, ki ga potrebuje več paketov, je en deljeni pogled, ne pa kopija v vsakem: register zunanjih izvajalcev tehnologije služi tako paketu Zavarovalništvo kot paketu Bančništvo in plačila. Če vaš podrejeni paket potrebuje pogled, ki že obstaja kot deljeni pogled, ga uporabite, namesto da bi risali svojega.
Licenciranje sledi dedovanju. Paket je licenciran na vrhu izdaje Enterprise in morda potrebuje dodatke, licenčni dokument pa nosi te odvisnosti. Paket Zavarovalništvo potrebuje Sobe za odločanje in zapečatene zapise, zato stranka, ki licencira paket, ki deduje iz njega, potrebuje tudi ta dodatek, konzola pa zavrne izdajo licence, ki bi ga izpustila. Zasloni paketa za telefone prav tako potrebujejo dodatek Mobilne aplikacije. Preverite verigo zahtev, preden stranki obljubite datum.
Dodajanje pogleda paketu, ki je že bil izdan
Najmanjše vertikalno delo je nov pogled za paket, ki ga niste napisali vi. Šest mesecev po začetku pilotnega projekta je ekipa za pomorske odškodninske zahtevke pri Larkfield želela lasten pogled znotraj paketa Hladna veriga: odstopanja in zahtevki, brez priključnih točk in brez nastavljenih vrednosti. Kode paketa se nismo dotaknili. Pogled je vrstica v registru pogledov organizacije, ki je v lasti paketa, zato smo ga ustvarili prek predpisane poti za poglede na strani Začni nekaj novega in ga oblikovali v Graditelju pogledov na osnovi pogleda nadzornika hladne verige. Velja isto pravilo kot prej: novi pogled lahko skrije tisto, kar prikazuje njegova osnova, in nikoli ne more prikazati več. Določen je enkrat za celotno organizacijo in dodeljen platformni vlogi v vsaki enoti. Dodelitev se prekliče in nikoli ne izbriše, ponovna dodelitev pogleda pa ustvari novo dodelitev, tako da je vedno razvidno, kdo je imel kateri pogled in kdaj. Register šteje, koliko oseb je imelo pogled vsak mesec, in nikoli, kdo so bile te osebe.
Stran Pogledi in kdo jih vidi prikazuje rezultat kot matriko pogledov po enotah in vlogah, z možnostmi Dodaj, Spremeni in Prekliči v vsaki celici. Preden novi pogled dodelite, si ga oglejte v predogledu kot določena oseba, natanko tako kot zgoraj.
Koliko je to dejansko stalo
Paket posega v zapise strank, zato platforma nekatere postopke namenoma upočasni, kar morate upoštevati pri načrtovanju že od prvega dne.
- Za maskirano kopijo je vsakič potrebno soglasje lastnika podatkov. Na našo smo prvič čakali en dan, ker je Priya želela najprej prebrati model znanja. Začnite s sintetičnimi podatki in zaprosite zgodaj.
- Avtor ne more odobriti lastne izdaje, zahteve pa zapadejo po 3 dneh. Če so vaši pregledovalci zasedeni, vaša izdaja čaka.
- Izdaja, ki zahteva več dovoljenj kot prejšnja, na primer pošiljanje pošte ali en zunanji naslov, je zadržana, dokler dva pregledovalca ne sprejmeta razširjenega manifesta. Poglavje 2.28, Izdaja vaše razširitve, prikazuje stran Manifest in dovoljenja, ki vas na to opozori, še preden oddate zahtevo.
- Pogled ne more prikazati tistega, kar njegov osnovni pogled skriva. Če vloga resnično potrebuje več, je to stvar pogovora s skrbnikom organizacije in ne nastavitev.
Nič od tega nas ni oviralo dvakrat. Druga izdaja paketa Hladna veriga je od prve potrditve sprememb do pilotnega projekta v Rotterdamu trajala en teden, pri čemer je večino časa vzelo izvajanje 66 testov na treh vejah in dve osebi, ki sta pregledovali dokaze.




