Versija 1.0.0-alpha.1naujausia
2.24 skyrius
Pasirinktinio šakinio sprendimo kūrimas nuo pradžios iki pabaigos
Praktinis „Cold chain“ srities paketo sukūrimas – nuo pirminės užduoties iki kiekvienam padaliniui veikiančios laidos, įskaitant žinių modelį, perspektyvas, įgūdį, pilno funkcionalumo įskiepį ir pavyzdinius duomenis. Taip pat aprašoma, kaip išplėsti jau esamą paketą ir kaip pridėti perspektyvą prie jau išleisto paketo.
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

Esu Mateo Ruiz, Corrán Orbital kūrėjas. Didžiąją savaitės dalį dirbu su mūsų pačių naudingosios apkrovos programine įranga, tačiau šis skyrius apie darbą, kurį atlikome klientui. Larkfield & Vane draudžia krovinius, ir vis didesnė jų dalis keliauja refrižeratoriniuose konteineriuose. Kai refrižeratorinis konteineris krantinėje netenka kranto elektros maitinimo, temperatūra kyla, krovinys sugenda, o po kelių savaičių pateikiama pretenzija. Larkfield norėjo, kad jų darbuotojai Nexus matytų šią grandinę kaip vieną visumą, nuo maitinimo gedimo iki pretenzijos, o kiekvienas vaidmuo matytų tik savo dalį. Taip atsirado Cold chain paketas.
Toliau aprašomas kūrimas ta tvarka, kuria jį atlikome, su ekranais, failais ir komandomis. Klaidas palikau, nes du gauti atsisakymai mus apie platformą išmokė daugiau nei sklandus kelias. Informacinė medžiaga pateikta ankstesniuose skyriuose, ir aš į juos nurodau, o ne kartoju. Labiausiai rėmiausi 2.18 skyriumi „Plėtinių modelis“ ir 2.23 skyriumi „Domenų paketai“, o šalia laikiau atvertą 2.21 skyrių „Plugin SDK“, skirtą pačiam programinės įrangos kūrimo rinkiniui.
Užduotis ir kas ką daro
Projekto laikotarpiu Larkfield suteikė man kūrėjo vietą savo organizacijoje. Tai svarbu, nes privatus paketas vienam klientui kuriamas to kliento įdiegtyje, jo kūrimo erdvėse ir duomenų šakose, jo darbuotojams tvirtinant. Paketas, skirtas daugeliui klientų, kuriamas kitaip – leidėjo klasteryje, naudojant tik pavyzdinius duomenis; šį atvejį aprašo 2.25 skyrius „Kūrimas kiekvienam leidimui“.
Užduotis tilpo viename puslapyje:
- Refrižeratoriniai konteineriai krantinėje ir laivuose: jų maitinimas, temperatūros nuokrypiai ir po jų sekančios pretenzijos.
- Pradžiai du vaidmenys: refrižeratorių technikas krantinėje ir šaltosios grandinės kontrolierius biure.
- Bandomasis projektas, pirmiausia vykdomas Rotterdam padalinyje, o vėliau perkeliamas į Felixstowe.
- Įrodymai trims taisyklių rinkiniams: ATP susitarimui dėl greitai gendančių maisto produktų, ES geros platinimo praktikos reikalavimams vaistams ir maisto saugos įrašams pagal HACCP (rizikos veiksnių analizė ir svarbiausieji valdymo taškai). Pretenzijoms pagal Hagos–Visbio taisykles naudojami tie patys nuokrypių įrašai, todėl jas pasižymėjome laikotarpiui po bandomojo projekto.
Domenų paketai yra Enterprise galimybė. Larkfield naudoja Enterprise, todėl domeno paketo kelias man buvo atviras. Community leidime auksinis kelias paketui apskritai nesiūlomas.
Pradėkite nuo rekomenduojamo kelio
Viskas prasideda puslapyje Start something new. Jame siūlomi šeši auksiniai keliai: papildinys, domeno paketas, rodinys, platforma, įgūdis ir darbo eiga. Kiekvienas iš versijuoto šablono sukuria saugyklą, manifestą, deklaruojantį, ko reikia, testus, kūrimo erdvę ir duomenų šakas. Tie patys keliai veikia konsolėje, komandinėje eilutėje ir jūsų IDE (integruotoje kūrimo aplinkoje), kur Workbench įrankis nexus.create atlieka tą patį darbą pagal planą, kurį pirmiausia patvirtinate.
nexus create komanda ir užfiksuotas šablonas. Atkreipkite dėmesį į pastabą apačioje: manifestas yra privalomas, o ne rekomendacinis, ir leidimas, prašantis daugiau, sulaikomas, kol jį peržiūri du žmonės.Tame puslapyje pasirinkome domeno paketo kelią, paketą pavadinome cold-chain, o pirmąjį jo padalinį – Rotterdam. Rezultate nurodomas užfiksuotas šablonas domain-pack@1.6.0 ir išvardijama, kas sukurta: saugykla, manifestas, deklaruojantis keturias aprėptis, dvi saugyklas ir jokių išorinių adresų, 66 testai iš šablono, kūrimo erdvė Rotterdam, trys sintetinių duomenų šakos ir juodraštinis įrašas paties Larkfield kataloge, kurį galėjau matyti tik aš. Šablono versija užfiksuota, o jos atnaujinimas vėliau pateikiamas kaip peržiūrimas pakeitimas, kaip ir bet kuris kitas, todėl niekieno paketas nepasikeičia tik todėl, kad pasikeitė šablonas. Vis dėlto pirmajam paketui naudojau konsolės vedlį, nes jis parodo planą prieš ką nors sukurdamas.
1 žingsnis: nurodykite, kam skirtas paketas
New domain pack vedlį sudaro trys žingsniai: apie paketą, žinių modelis bei peržiūra ir sukūrimas. 1 žingsnyje klausiama keleto dalykų, kurie lemia viską, kas seka.
| Laukas | Ką įvedėme | Pastaba |
|---|---|---|
| Pavadinimas | Cold chain | Naudojamas saugyklai ir katalogui |
| Kam jis skirtas | Refrižeratoriniai konteineriai krantinėje ir laivuose: maitinimas, temperatūros nuokrypiai ir po jų sekančios pretenzijos | |
| Pramonės šaka | Logistika ir jūrų laivyba | Grindžiamas Logistics and maritime paketu |
| Savininkas (Owner) | Kūrėjas | Vedlyje užfiksuota |
| Padaliniai | Rotterdam (bandomasis) | Felixstowe po bandomojo projekto |
| Šablonas | domain-pack@1.6.0 |
Užfiksuotas; atnaujinimai pateikiami kaip peržiūrimi pakeitimai |
| Susietos taisyklės | ATP susitarimas, ES geros platinimo praktika, maisto saugos įrašai | Kiekviena taisyklė tampa puslapiu paketo įrodymų žemėlapyje |
Paskutinę eilutę, įskaitant pastabą, kad krovinių pretenzijose pakartotinai naudojami tie patys nuokrypių įrašai, pasiūlė asistentas šoniniame skydelyje. Pastaba puslapio apačioje nurodo, kad dar niekas nesukurta. Saugykla, kūrimo erdvė ir duomenų šakos sukuriamos tik tada, kai 3 žingsnyje paspaudžiate Create, peržiūrėję planą. Galite išsaugoti juodraštį ir grįžti vėliau.
2 žingsnis: žinių modelis
Žinių modelis – tai objektų rūšių, apie kurias paketas žino, rinkinys ir tai, kaip jos susijusios. Cold chain pradėjo nuo bazinio logistikos modelio logistics-base 4.2, importuoto iš SDK, kuris suteikė penkias bazines rūšis, ant kurių galėjome statyti (Vessel, Port, Container, Carrier ir Shipment). Vedlyje bazinės rūšys yra tik skaitomos. Jei kurią nors reikia pakeisti, ji keičiama ją valdančiame pakete.
Pridėjome penkias savas rūšis:
| Rūšis | Kas tai yra | Savybės |
|---|---|---|
| Reefer unit | Refrižeratorinis konteineris | 9 |
| Vessel call | Vienas laivas prie vienos prieplaukos | 6 |
| Excursion | Temperatūra, išeinanti už nustatytų ribų | 8 |
| Power supply | Kranto arba laivo maitinimo taškas | 4 |
| Priskirti | Pinigai, prašomi už sugadintą krovinį | 7 |
Kiekvienai savybei klasė priskiriama ją kuriant. „Reported by“ Excursion rūšyje yra asmeninė. „Cargo value at risk“ bei pretenzijos suma ir atsiskaitymas yra komercinės. Pirmą dieną tai atrodė kaip popierizmas, tačiau vėliau mus išgelbėjo du kartus, nes klasės lemia, ką rodinys gali rodyti, ką pakeičia užmaskuota kopija ir ką paslepia žurnalo eilutė.
Du mūsų ryšiai siekia bazinį modelį: Reefer unit prijungtas prie Power supply, o Claim nurodo Shipment. Pats bazinis modelis nekeičiamas. Atšaukta savybė lieka modelio 1.0 versijoje ir pašalinama tik vėlesnėje versijoje, todėl niekas, kas buvo teisinga seniems įrašams, nenustoja būti skaitoma.
3 žingsnis: peržiūrėkite ir sukurkite
3 žingsnis – tai planas. Jame išvardijama, kas bus sukurta, kokias aprėptis deklaruos manifestas, duomenų šakos ir kūrimo erdvė. Planą patvirtinate savo prieigos raktu, ir planui suteikiamas kontrolinis kodas. Tuomet kūrimas tiksliai vykdo tą planą, žingsnis po žingsnio, ir galite sustoti bet kuriame žingsnyje bei išsaugoti tai, kas sukurta.
Cold chain plane buvo deklaruotos keturios aprėptys:
| Aprėptis | Kodėl jos reikia paketui |
|---|---|
| Skaityti refrižeratorių telemetriją | Maitinimo ir temperatūros rodmenys |
| Rašyti nuokrypius | Užregistruoja nuokrypį, kai viršijamos ribos |
| Skaityti siuntas | Susieja pretenziją su jos siunta |
| Rengti pretenzijų pastabų juodraščius | Tik juodraščiai; siunčia žmogus |
Jo saugyklos buvo grafas ir įrašai. Jis neturėjo išorinių adresų ir naudojo Standard smėlio dėžės profilį. Kūrimo erdvė buvo su 4 branduoliais, 16 GiB atminties ir 50 GiB saugyklos, tinklu, uždarytu viskam, išskyrus tai, ką deklaruoja manifestas, tik pasirašytais atvaizdais ir baigiama po 7 neveiklumo dienų. Jai pasibaigus, jos apibrėžtis lieka saugykloje, todėl ją vėl sukuriate iš ten.
Trys duomenų šakos buvo sukurtos sintetinių duomenų generatoriumi. Jokie klientų duomenys nebuvo nukopijuoti. Užmaskuotai Rotterdam kopijai reikia duomenų savininko sutikimo, kuris Larkfield yra Priya Natarajan, ir jo prašoma atskirai.
Paketo manifestas
Saugykloje yra paketo manifestas pack.json. Jame nurodomas paketo pavadinimas, versija, paketas, iš kurio jis paveldi (jei toks yra), jo klasteriai ir žodžiai. Klasteris yra arba rodinys, t. y. tai, ką vienas vaidmuo mato pakete, arba bendrasis, veikiantis visuose rodiniuose. Štai mūsų manifesto pagrindas:
{
"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", ""]
]
}
}Leksikone saugomi paties paketo žodžiai su paprastu kiekvieno paaiškinimu, pakankamai trumpu, kad būtų galima perskaityti telefone.
Be pack.json, manifeste taip pat deklaruojama, ką paketas gali pasiekti: jo aprėptys, saugyklos, išoriniai adresai ir smėlio dėžės profilis. Nexus suteikia būtent tai ir nieko daugiau. Kiekvienas įrankio iškvietimas tikrinamas pagal deklaruotas aprėptis, o išorinis adresas blokuojamas, nebent jis įtrauktas į sąrašą. Deklaraciją ir pakeitimus, palyginti su paskutiniu leidimu, galite peržiūrėti paketo puslapyje Manifest and permissions.
Perspektyvos: ką mato kiekvienas vaidmuo
Rodinys gali tik susiaurinti tai, ką rodo jo bazė, ir ši viena taisyklė lėmė daugiau mūsų projekto sprendimų nei bet kuri kita. Rodinys rodo dalį to, ką rodo jo bazinis rodinys, o teisės vis tiek kyla iš vaidmenų: rodinys lemia, ką vaidmuo mato pakete, o ne tai, ką jam leidžiama daryti.
Reefer technician rodinys siaurina Operations controller – bazinį rodinį, kurį Larkfield jau naudoja logistikos darbams. Lens builder pažymite korteles, laukus ir veiksmus, kuriuos rodinys rodo. Elementai, kurių bazė nerodo, yra užrakinti.
| Dalis | Reefer technician rodo | Neįtraukta |
|---|---|---|
| Kortelės | Refrižeratoriniai konteineriai krantinėje, atviri nuokrypiai, maitinimo taškai, šiandienos laivų užsukimai | Viskas, kas susiję su pretenzijomis |
| Laukai | Maitinimo būsena, nustatytoji vertė, paskutinis rodmuo, aukščiausia temperatūra | Pretenzijos suma (nėra baziniame rodinyje), asmeniniai laukai (pagal numatytuosius nustatymus išjungti) |
| Veiksmai | Užregistruoti nuokrypio priežastį, paprašyti patikrinti maitinimą | Pakeisti nustatytąją vertę ir uždaryti nuokrypį (tik kontrolieriams), parengti pretenzijos pastabos juodraštį |
Vis tiek bandžiau pridėti pretenzijos sumą prie techniko rodinio, nes jos paprašė technikas. Kūrimo įrankis atsisakė su LENS_CANNOT_WIDEN ir nieko neišsaugojo. Rodinyje nėra apėjimo būdo: išeitis – rodinys platesniu pagrindu, o tai yra kitas prašymas, dėl kurio sprendžia organizacijos administratorius. Šio lauko neįtraukėme.
Paslėpus kažką rodinyje, tai nepašalinama iš Nexus. Tai reiškia, kad šis vaidmuo to nemato. Kūrimo įrankis rodo, kiek žmonių rodinys pasieks bandomajame projekte (mūsų atveju 29), ir registruoja kiekvieną Add, Change ir Withdraw veiksmą. Rodinys apibrėžiamas vieną kartą visai organizacijai ir kiekvienam padaliniui suteikiamas platformos vaidmeniui, todėl tą patį Reefer technician rodinį šį mėnesį galima suteikti Rotterdam technikams, o kitą – Felixstowe.
Įgūdis pretenzijų pastabų juodraščiams rengti
Kontrolieriai norėjo pirmojo pastabos, kuri po nuokrypio siunčiama krovinio savininkui, juodraščio. Tai kalbinis darbas, todėl jis vykdomas modeliu, ir klausimas buvo, kur jį patalpinti.
Nexus yra dviejų rūšių įgūdžiai, ir skirtumas čia svarbus. Manifesto įgūdis yra tipizuota eilutė papildinio skills[], kurią vykdo platforma. Skills Engine įgūdis yra SKILL.md paketas organizacijos įgūdžių bibliotekoje, kurį agentai, DI mygtukai, darbo eigos ir kūrėjų įrankiai vykdo vienodai. 2.20 skyrius „Įgūdžiai“ aprašo abu.
Mūsų papildinio patikimumo lygis yra community, o bendruomenės papildinys gali deklaruoti tik tuos manifesto įgūdžius, kurie nesiekia modelio (host_callback ir plugin_queue). Du lygiams, kurie pasiekia AI Provider Router, tool_using ir llm_only, reikia patikimumo lygio core arba verified. Todėl pretenzijų pastabų rengimas tapo Skills Engine įgūdžiu, o maršrutizatorius parenka modelį iš paties Larkfield telkinio:
---
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.Paketas saugykloje laikomas skills/draft-claim-note/, o aplanko pavadinimas sutampa su įgūdžio pavadinimu. Jį patvirtinome ir įkėlėme iš terminalo:
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Įkėlus tą patį turinį du kartus, grąžinama esama versija, o ne nauja (CONTENT_HASH_ALREADY_PUBLISHED), todėl pakartotinai įkelti yra saugu. Prieš išleidžiant versiją, Skills Engine vykdo jos testinius atvejus, bandomąjį vykdymą šešėliniu režimu su ankstesniais darbais ir aklą kitos bendrovės modelio peržiūrą, nurodydamas kiekvieno vykdymo laiką ir kainą.
Pilno funkcionalumo įskiepis
Paketui taip pat reikėjo nuolat veikiančio kodo: refrižeratorių telemetrijos srauto skaitytuvo ir rašytuvo, kuris atveria nuokrypio įrašą, kai rodmuo viršija ribas. Toks kodas priklauso pilnos paslaugos papildiniui, ir jo karkasą sukūrėme paties SDK komanda, kuri įrašo visą pavyzdinį medį su pakeistu pavadinimu:
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 įdiegiamas iš https://registry.adverant.ai/npm/ naudojant traukimo prieigos raktą iš jūsų Adverant paskyros puslapio Pull tokens and install commands. Įrašykite į saugyklą (commit) package-lock.json, kurį sukuria pirmasis įdiegimas; atvaizdo kūrimas vykdo npm ci ir be jo atsisako veikti.
Štai mūsų nexus.manifest.json dalis, kuri skiriasi nuo šablono. Tai ne visas failas: karkaso description, author, license, runtime, backend ir frontend blokai lieka nepakeisti, o tikrintuvas atmeta pilnos paslaugos manifestą be jų. Trys architecture sakiniai yra taisyklė, kurią pakartoja kiekvienas įskiepis, o tikrintuvas tikrina jų formuluotę. UNO pirmajame iš jų yra darbo eigų variklis:
{
"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 yra manifesto įgūdis su host_callback lygiu: platforma siunčia įvestį į mūsų pačių Service, mūsų vardų srityje, ir niekada į mūsų nurodytą pagrindinį kompiuterį. Gavėjo maršrutas deklaruojamas auth: internal ir saugomas SDK serviceMiddleware – Express formos apsauga, kuri atmeta iškvietimo žetoną, išduotą bet kuriam kitam įskiepiui, organizacijai, įgūdžiui ar maršrutui. Jo classification yra tenant, o tai yra viršutinė riba bendruomenės įskiepiui. 2.27 skyriuje „Kūrimo scenarijai“ atskirai aptariamas host_callback įgūdis.
Verta perimti du šio etapo įpročius. Kiekviena lentelė nuo pirmosios migracijos turi organization_id, owner_user_id ir business_unit_id, nes vėliau pridėta ašis reiškia migraciją per gyvas eilutes. Be to, prieš kiekvieną išsiuntimą (push) vietoje paleisdavome nexus-gates, nes tai ta pati komanda, kurią vykdo konvejeris; vykdymas, kuris nieko neišnagrinėjo, baigiasi kodu 2 ir tai praneša. 2.19 skyriuje „Taisyklės, kurias paveldi kiekvienas plėtinys“ išvardyti vartai.
Pavyzdiniai duomenys testavimui
Puslapyje „Pavyzdiniai duomenys testavimui“ siūlomos trijų rūšių šakos:
| Rūšis | Kas jame saugoma | Kas sutinka |
|---|---|---|
| Sintetiniai | Duomenys, sugeneruoti pagal jūsų nustatytus kiekius ir formas; niekas nepaimta iš realaus padalinio | Niekas; jie jūsų |
| Užmaskuota kopija | Padalinio kopija, kurioje asmeniniai, jautrūs ir komerciniai laukai pakeisti | Duomenų savininkas (Rotterdam – Priya Natarajan) |
| Tik schema | Saugyklų struktūra be eilučių | Niekas; skirta migracijoms |
Sugeneravome įtemptą savaitę: maždaug 7 nukrypimai kiekvienam 100 šaldytuvinių konteinerių – taip atrodo įtemptas rugpjūtis Rotterdam. Neįprasti atvejai buvo svarbesni už apimtį. Paprašėme maitinimo praradimo iškrovimo metu, paliktų atvirų durų, jutiklio duomenų spragos ir dviejų pretenzijų dėl vieno nukrypimo. Puslapis gali pasiūlyti neįprastų atvejų pagal žinių modelyje esančias nukrypimų priežastis, bet niekada ne pagal realius įrašus.
Kiekvienas kiekių ir formų rinkinys išsaugomas kaip sėkla, pvz., cold-chain-busy-01, su savo kontroliniu atspaudu. Ta pati sėkla duoda tuos pačius duomenis, todėl kiekvienas testų paleidimas kiekvienoje šakoje mato tą pačią savaitę. Būtent tai padarė mūsų 66 testus pakartojamus.
Pagal numatytuosius nustatymus šaka gyvuoja 72 valandas, daugiausia – 14 dienų. Ilgos peržiūros metu paprašiau išlaikyti mūsų įtemptos savaitės šaką 30 dienų, ir puslapis atsisakė su BRANCH_LIFE_EXCEEDED. Sprendimas yra tas, kurį siūlo plokštelė: išsaugokite sėklą ir, kai prireiks, sukurkite iš jos naują šaką. Užmaskuotai kopijai taikomos tos pačios ribos, o jos užklausoje nurodoma priežastis ir trukmė iki 14 dienų.
Perspektyvos peržiūra konkretaus asmens vardu
Prieš tai, kai kas nors Rotterdam pamatė Cold chain, pažiūrėjome į jį taip, kaip žiūrėtų jie. Funkcija „Peržiūrėti lęšį kaip asmeniui“ atvaizduoja paketą tiksliai taip, kaip jį mato pasirinktas vaidmuo, duomenų šakoje, punktyriniame peržiūros rėmelyje.
Trys taisyklės leidžia peržiūras naudoti laisvai ir saugiai. Peržiūra naudoja duomenų šaką, niekada ne gyvą padalinį. Jūsų pačių leidimai į ją nepatenka, todėl matote tai, ką mato vaidmuo, o ne tai, ką galite matyti jūs. Be to, ji baigiasi po 30 minučių. Bandymas nukreipti peržiūrą į gyvą padalinį atmetamas su CONNECTION_SCOPE_EXCEEDED; jei jums reikia realių formų, paprašykite duomenų savininko užmaskuotos kopijos ir peržiūrėkite ją.
Būtent peržiūroje aptikome tikrą klaidą. Techniko vaizde temperatūros diagrama rodė nustatytąją vertę, o nustatytosios vertės keitimai turėjo būti prieinami tik valdytojams. Diagrama buvo tinkama; netinkamas buvo po ja esantis redagavimo mygtukas. Versijoje 0.3.2 nustatytosios vertės keitimai buvo paslėpti nuo technikų, o klaidą aptikome būtent peržiūroje.
Žinių modelio keitimas po išleidimo
Iki versijos 0.4.0 mums prireikė Inspection rūšies patikroms prieš kelionę, o ryšys „Excursion caused Claim“ geriau skambėjo kaip „Excursion led to Claim“. Modelio perkėlimas iš 1.3 į 1.4 yra žinių modelio pakeitimas, o puslapyje „Žinių modelio pakeitimai“ rodomas jo skirtumas, ką jis paveiktų ir kokiame etape jis yra.
Pakeitimas keliauja kaip grafo pakeitimo užklausa. Jos bandomasis vykdymas suskaičiuoja, ką ji paveiktų Rotterdam užmaskuotoje kopijoje, kiekiais: mūsų atveju 1 284 pervadintos sąsajos ir nieko nepašalinta. Ją patvirtina du peržiūrėtojai, o konvejeris pritaiko ją parengiamajai aplinkai, tada pilotiniam padaliniui. Niekas nerašo į bendrą grafą rankomis; toks bandymas atmetamas ir užregistruojamas. Trys išsaugoti klausimai naudojo žodį „caused“, o pakeitime kiekvienam iš jų buvo numatytas automatinis perrašymas, kurį puslapis išvardijo. Lęšių filtrai nepasikeitė, nes abu lęšiai vis tiek tik siaurino.
Perkėlimas į gamybinę aplinką
Kiekvienas leidimas juda vienu keliu: kūrimo erdvė, parengiamoji aplinka, pilotinis padalinys, tada visi padaliniai. Kiekvienas žingsnis turi vartus, ir nė vienas jų nepraleidžiamas.
| Į | Patikros |
|---|---|
| Parengiamoji aplinka | Visi testai išlaikyti; kokybės patikros; manifestas nepakitęs arba išplėtimas priimtas; pasirašytas atvaizdas |
| Pilotinis (Rotterdam) | Modelio pakeitimo bandomasis vykdymas užmaskuotoje kopijoje be klaidų; lęšių ir apimties taisyklių politikos patikra; du peržiūrėtojai, kurie nėra autoriai, vienas iš jų – duomenų savininkas |
| Visi padaliniai | 14 dienų pilotiniame padalinyje; klaidų mažiau nei 1 iš 1 000, skaičiuojant pilotiniame padalinyje; kiekvieno padalinio administratorius sutinka dėl savo padalinio; du peržiūrėtojai, kurie nėra autoriai |
Kartą, penktadienį, dėl vienos eilutės pataisymo išbandžiau trumpąjį kelią: perkelti 0.4.0-dev iš savo kūrimo erdvės į visus padalinius. Tai buvo atmesta su GATE_CANNOT_BE_SKIPPED, ir niekas nebuvo perkelta. Plokštelė nurodo vietoj to perkelti į kitą žingsnį, ir tai vienintelis galimas atsakymas.
Pati leidimo peržiūra, įrodymai, kuriuos skaito antrasis peržiūrėtojas, ir kanalai, kuriuos pasirenka padaliniai, aprašyti 2.28 skyriuje „Plėtinio išleidimas“. Du faktai iš jo priklauso čia, nes jie lemia, kaip planuojate vertikalę. Autorius niekada nelaikomas peržiūrėtoju, todėl dviejų žmonių komandai kiekvienam leidimui reikia trečio asmens. Be to, kiekviena aplinka 30 dienų saugo ankstesnę versiją, todėl atšaukimas yra peržiūrėtas pakeitimas, kurį konvejeris atlieka maždaug per minutę.
Jau esamo paketo išplėtimas
Ne kiekviena vertikalė pradedama nuo nulio. Paketas gali paveldėti iš kito ir pridėti tik tai, kas skiriasi. Banking and payments paketas, kurį naudoja Larchmont Bank, yra aiškiausias pavyzdys kataloge. Jo manifestas prasideda taip:
{
"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 nurodo paketą, kuriuo jis grindžiamas. Banking and payments išlaiko Insurance paketo struktūrą, bendrus pokalbių klasterius ir pagrindinius žodžius, ir prideda tris savo lęšius: Lending decisions, Card disputes ir My account. Trečiasis kiekvieno žodyno įrašo elementas yra exact terminui, kuris turi būti rodomas taip, kaip parašytas, pvz., APR (metinė palūkanų norma), o ne perfrazuojamas.
Kai kurių dalykų paveldėjimu padaryti neįmanoma. Paketas niekada nekeičia apvalkalo, komponentų ar rašymo taisyklių, todėl vaikinis paketas negali pakeisti konsolės stiliaus. Režimas, kurio reikia keliems paketams, yra vienas bendras lęšis, o ne kopija kiekviename: užsakomųjų technologijų registras tarnauja ir Insurance, ir Banking and payments. Jei jūsų vaikiniam paketui reikia lęšio, kuris jau egzistuoja kaip bendras lęšis, naudokite jį, užuot kūrę savo.
Licencijavimas seka paveldėjimą. Paketas licencijuojamas papildomai prie Enterprise ir gali reikalauti priedų, o licencijos dokumente nurodytos šios priklausomybės. Insurance reikia Decision rooms ir užantspauduotų įrašų, todėl klientui, licencijuojančiam jį paveldintį paketą, taip pat reikia šio priedo, o konsolė atsisako išduoti licenciją, kurioje jo nėra. Paketo telefono ekranams taip pat reikia Mobile apps priedo. Patikrinkite reikalavimų grandinę prieš pažadėdami klientui datą.
Perspektyvos pridėjimas prie išleisto paketo
Mažiausias vertikalės darbas – naujas lęšis pakete, kurio nerašėte jūs. Praėjus šešiems piloto mėnesiams, Larkfield jūrinių pretenzijų komanda panoro savo lęšio Cold chain viduje: nukrypimai ir pretenzijos, be maitinimo taškų, be nustatytųjų verčių. Paketo kodo nelietėme. Lęšis yra eilutė organizacijos lęšių registre, priklausanti paketui, todėl jį pradėjome nuo lęšio auksinio kelio puslapyje „Pradėti ką nors naujo“ ir suformavome Lens builder, kaip pagrindą naudodami Cold-chain controller lęšį. Galioja ta pati taisyklė kaip anksčiau: naujas lęšis gali paslėpti tai, ką rodo jo pagrindas, ir niekada negali rodyti daugiau. Jis apibrėžiamas vieną kartą organizacijai ir suteikiamas platformos vaidmeniui kiekviename padalinyje. Suteikimas atšaukiamas, bet niekada neištrinamas, o pakartotinai suteikus lęšį sukuriamas naujas suteikimas, todėl išlieka matoma, kas ir kada turėjo kurį lęšį. Registras skaičiuoja, kiek žmonių kiekvieną mėnesį turėjo lęšį, bet niekada – kas.
Puslapyje „Lęšiai ir kas juos mato“ rezultatas rodomas kaip lęšių pagal padalinius ir vaidmenis matrica su veiksmais Add, Change ir Withdraw kiekviename langelyje. Prieš suteikdami naują lęšį, peržiūrėkite jį kaip asmeniui, lygiai taip, kaip aprašyta aukščiau.
Kiek tai iš tikrųjų kainavo
Paketas paliečia kliento įrašus, todėl platforma kai kuriuos dalykus sąmoningai daro lėtus, ir į juos turėtumėte atsižvelgti nuo pirmos dienos.
- Užmaskuotai kopijai kiekvieną kartą reikia duomenų savininko sutikimo. Mūsiškis pirmą kartą užtruko dieną, nes Priya pirmiausia norėjo perskaityti žinių modelį. Pradėkite nuo sintetinių duomenų ir prašykite anksti.
- Autorius negali patvirtinti savo paties leidimo, o užklausos nustoja galioti po 3 dienų. Jei jūsų peržiūrėtojai užsiėmę, jūsų leidimas laukia.
- Leidimas, kuris prašo daugiau nei ankstesnis, pvz., siųsti laiškus ar vieno išorinio adreso, sulaikomas, kol du peržiūrėtojai priima platesnį manifestą. 2.28 skyriuje „Plėtinio išleidimas“ parodytas puslapis „Manifestas ir leidimai“, kuris tai praneša dar prieš jums prašant.
- Lęšis negali rodyti to, ką slepia jo pagrindinis lęšis. Jei vaidmeniui tikrai reikia daugiau, tai pokalbis su organizacijos administratoriumi, o ne nustatymas.
Nė vienas iš jų nesutrukdė mums du kartus. Antrasis Cold chain leidimas nuo pirmojo įsipareigojimo (commit) iki Rotterdam piloto užtruko savaitę, didžiąją jos dalį – 66 testų vykdymas trijose šakose ir du žmonės, skaitantys įrodymus.




