Versiune 1.0.0-alpha.1cea mai recentă
Capitolul 2.24
Construirea unei verticale personalizate de la un capăt la altul
Un exemplu practic de construire a pachetului de domeniu Cold chain, de la primul rezumat până la o versiune lansată care rulează pentru fiecare unitate, cu modelul său de cunoștințe, lentile, o competență, un plugin cu servicii complete și date de test. Apoi, cum să extindeți un pachet care există deja și cum să adăugați o lentilă la unul care a fost deja livrat.
Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

Sunt Mateo Ruiz, dezvoltator la Corrán Orbital. Cea mai mare parte a săptămânii mi-o petrec cu propriul nostru software pentru sarcina utilă, dar acest capitol este despre o lucrare pe care am realizat-o pentru un client. Larkfield & Vane asigură mărfuri, iar o parte tot mai mare dintre acestea călătoresc în containere frigorifice. Când un container frigorific pierde alimentarea de la țărm pe cheu, temperatura crește, marfa se strică, iar câteva săptămâni mai târziu urmează o cerere de despăgubire. Larkfield dorea ca oamenii săi să vadă acest lanț ca pe un singur lucru în Nexus, de la defecțiunea de alimentare până la cererea de despăgubire, fiecare rol văzând doar partea sa. Așa a luat naștere pachetul Cold chain.
Ceea ce urmează este construcția în ordinea în care am realizat-o, cu ecranele, fișierele și comenzile. Am păstrat și greșelile, deoarece două dintre refuzurile întâlnite ne-au învățat mai multe despre platformă decât calea fără probleme. Materialul de referință se află în capitolele dinaintea acestuia, iar eu fac trimitere la ele în loc să le repet. Cele pe care m-am bazat cel mai mult au fost capitolul 2.18, Modelul de extensii, și capitolul 2.23, Pachete de domeniu, cu capitolul 2.21, Plugin SDK, deschis alături pentru kitul de dezvoltare software propriu-zis.
Rezumatul și cine ce face
Larkfield mi-a acordat un loc de dezvoltator în organizația sa pe durata proiectului. Acest lucru contează, deoarece un pachet privat pentru un singur client se construiește în instalarea acelui client, pe spațiile sale de dezvoltare și ramurile sale de date, cu aprobările oamenilor săi. Un pachet destinat mai multor clienți se construiește altfel, pe un cluster de publicare, numai cu date de exemplu, iar capitolul 2.25, Construirea pentru fiecare ediție, tratează acest caz.
Cerințele au încăput pe o singură pagină:
- Containere frigorifice pe cheu și pe nave: alimentarea lor, abaterile lor de temperatură și cererile de despăgubire care urmează.
- Două roluri pentru început: un tehnician de containere frigorifice pe cheu și un controlor al lanțului frigorific la birou.
- Un proiect pilot care rulează mai întâi în unitatea Rotterdam și se mută ulterior la Felixstowe.
- Dovezi pentru trei seturi de reguli: acordul ATP pentru alimentele perisabile, bunele practici de distribuție ale UE pentru medicamente și înregistrările privind siguranța alimentară conform HACCP (analiza riscurilor și punctele critice de control). Cererile de despăgubire conform regulilor Haga-Visby folosesc aceleași înregistrări ale abaterilor, așa că le-am notat pentru după proiectul pilot.
Pachetele de domeniu sunt o capabilitate Enterprise. Larkfield folosește Enterprise, așa că parcursul pentru pachete de domeniu îmi era disponibil. În Community, parcursul standard pentru un pachet nu este oferit deloc.
Începeți de la calea optimă
Totul începe pe pagina Începeți ceva nou. Aceasta oferă șase parcursuri standard: plugin, pachet de domeniu, lentilă, platformă, abilitate și flux de lucru. Fiecare creează un depozit dintr-un șablon versionat, un manifest care declară de ce are nevoie elementul respectiv, teste, un spațiu de dezvoltare și ramuri de date. Aceleași parcursuri funcționează în consolă, în linia de comandă și din IDE-ul dumneavoastră (mediul de dezvoltare integrat), unde instrumentul Workbench nexus.create face aceeași treabă pe baza unui plan pe care îl confirmați mai întâi.
nexus create și șablonul său fixat. Observați plăcuța din partea de jos: manifestul este impus, nu orientativ, iar o versiune care solicită mai mult este reținută până când două persoane o revizuiesc.Am ales parcursul pentru pachete de domeniu de pe acea pagină, denumind pachetul cold-chain și prima sa unitate Rotterdam. Rezultatul indică șablonul fixat, domain-pack@1.6.0, și enumeră ce a creat: depozitul, un manifest care declară patru domenii de acces, două depozite de date și nicio adresă externă, 66 de teste din șablon, un spațiu de dezvoltare în Rotterdam, trei ramuri de date sintetice și o intrare provizorie în catalogul propriu al Larkfield, vizibilă doar mie. Versiunea șablonului este fixată, iar actualizarea ulterioară a acestuia sosește ca o modificare revizuită, la fel ca oricare alta, astfel încât pachetul nimănui nu se schimbă pentru că s-a schimbat un șablon. Am folosit totuși asistentul din consolă pentru primul nostru pachet, deoarece acesta arată planul înainte de a crea ceva.
Pasul 1: precizați la ce folosește pachetul
Asistentul Pachet de domeniu nou are trei pași: despre pachet, modelul de cunoștințe și revizuire și creare. Pasul 1 solicită puținele informații care determină tot ce urmează.
| Câmp | Ce am introdus | Notă |
|---|---|---|
| Nume | Cold chain | Folosit pentru depozit și catalog |
| La ce servește | Containere frigorifice pe cheu și pe nave: alimentare, abateri de temperatură și cererile de despăgubire care urmează | |
| Industrie | Logistică și transport maritim | Se bazează pe pachetul Logistică și transport maritim |
| Proprietar (Owner) | Persoana care îl creează | Blocat în asistent |
| Unități | Rotterdam (pilot) | Felixstowe după proiectul pilot |
| Șablon | domain-pack@1.6.0 |
Blocat; actualizările sosesc ca modificări revizuite |
| Reguli pe care le mapează | Acordul ATP, bunele practici de distribuție ale UE, înregistrările privind siguranța alimentară | Fiecare regulă devine o pagină în harta de dovezi a pachetului |
Asistentul din panoul lateral a sugerat ultimul rând, inclusiv observația că cererile de despăgubire pentru mărfuri reutilizează aceleași înregistrări ale abaterilor. O plăcuță din partea de jos a paginii arată că încă nu s-a creat nimic. Depozitul, spațiul de dezvoltare și ramurile de date se creează doar când apăsați Creare la pasul 3, după ce ați văzut planul. Puteți salva o versiune provizorie și reveni ulterior.
Pasul 2: modelul de cunoștințe
Modelul de cunoștințe este setul de tipuri de elemente despre care pachetul are cunoștințe și modul în care acestea se leagă. Cold chain a pornit de la modelul de bază pentru logistică, logistics-base 4.2, importat din SDK, care ne-a oferit cinci tipuri de bază pe care să construim (Navă, Port, Container, Transportator și Expediere). Tipurile de bază sunt doar în citire în asistent. Dacă unul trebuie modificat, modificarea se face în pachetul care îl deține.
Am adăugat cinci tipuri proprii:
| Tip | Ce reprezintă | Proprietăți |
|---|---|---|
| Unitate frigorifică | Un container frigorific | 9 |
| Escală de navă | O navă la un dană | 6 |
| Abatere | O temperatură în afara limitelor sale | 8 |
| Sursă de alimentare | Un punct de alimentare de la țărm sau de pe navă | 4 |
| Revendicare | Bani solicitați pentru marfa stricată | 7 |
Fiecare proprietate este clasificată în momentul în care o creați. „Raportat de” la o Abatere este personal. „Valoarea mărfii expuse riscului”, precum și suma și decontarea unei cereri de despăgubire sunt comerciale. Acest lucru a părut birocrație în prima zi, dar ne-a salvat de două ori ulterior, deoarece clasele decid ce poate afișa o lentilă, ce înlocuiește o copie mascată și ce ascunde o linie de jurnal.
Două dintre relațiile noastre ajung în modelul de bază: o Unitate frigorifică este conectată la o Sursă de alimentare, iar o Cerere de despăgubire se referă la o Expediere. Modelul de bază în sine nu este modificat. O proprietate pe care o retrageți rămâne în versiunea 1.0 a modelului și dispare doar într-o versiune ulterioară, astfel încât nimic din ceea ce era valabil pentru înregistrările vechi nu devine imposibil de citit.
Pasul 3: revizuire și creare
Pasul 3 este planul. Acesta enumeră ce se va crea, domeniile de acces pe care le va declara manifestul, ramurile de date și spațiul de dezvoltare. Confirmați planul cu cheia de acces (passkey), iar planul primește o amprentă. Crearea urmează apoi exact acest plan, pas cu pas, iar dumneavoastră puteți opri la orice pas și păstra ceea ce s-a creat.
Planul pentru Cold chain a declarat patru domenii de acces:
| Domeniu de acces | De ce are nevoie pachetul de el |
|---|---|
| Citirea telemetriei containerelor frigorifice | Citiri de alimentare și temperatură |
| Scrierea abaterilor | Înregistrează o abatere când limitele sunt depășite |
| Citirea expedierilor | Leagă o cerere de despăgubire de expedierea sa |
| Redactarea notelor privind cererile de despăgubire | Doar versiuni provizorii; o persoană le trimite |
Depozitele sale de date au fost graful și înregistrările. Nu avea adrese externe și folosea profilul de izolare Standard. Spațiul de dezvoltare a venit cu 4 nuclee, 16 GiB de memorie și 50 GiB de stocare, o rețea închisă cu excepția a ceea ce declară manifestul, numai imagini semnate și o încheiere după 7 zile de inactivitate. Când se încheie, definiția sa rămâne în depozit, așa că îl puteți crea din nou de acolo.
Cele trei ramuri de date au provenit din generatorul sintetic. Nu au fost copiate date ale clienților. O copie mascată a Rotterdam necesită acordul proprietarului datelor, care la Larkfield este Priya Natarajan, iar acesta se solicită separat.
Manifestul pachetului
Depozitul conține manifestul pachetului, pack.json. Acesta numește pachetul, versiunea sa, pachetul de la care moștenește (dacă există), clusterele sale și termenii săi. Un cluster este fie o lentilă, adică ceea ce vede un rol în cadrul pachetului, fie partajat, adică rulează în toate lentilele. Iată nucleul manifestului nostru:
{
"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", ""]
]
}
}Lexiconul conține termenii proprii ai pachetului, fiecare cu o explicație simplă, suficient de scurtă pentru a fi citită pe telefon.
Pe lângă pack.json, manifestul declară și ce poate accesa pachetul: domeniile de acces, depozitele de date, adresele externe și profilul de izolare. Nexus acordă exact atât și nimic mai mult. Fiecare apel de instrument este verificat în raport cu domeniile de acces declarate, iar o adresă externă este blocată dacă nu este listată. Puteți citi declarația, precum și modificările față de ultima versiune, pe pagina Manifest și permisiuni a pachetului.
Lentile: ce vede fiecare rol
O lentilă poate doar să restrângă ceea ce afișează baza sa, iar această singură regulă ne-a modelat designul mai mult decât oricare alta. O lentilă afișează o parte din ceea ce afișează lentila sa de bază, iar permisiunile provin în continuare din roluri: o lentilă decide ce vede un rol în pachet, nu ce are voie să facă.
Lentila Tehnician containere frigorifice restrânge Controlor operațiuni, lentila de bază pe care Larkfield o folosește deja pentru activitățile de logistică. În Constructorul de lentile bifați cardurile, câmpurile și acțiunile pe care le afișează lentila. Elementele pe care baza nu le afișează sunt blocate.
| Componentă | Tehnician containere frigorifice afișează | Omise |
|---|---|---|
| Carduri | Unități frigorifice pe cheu, abateri deschise, puncte de alimentare, escale de nave astăzi | Orice privește cererile de despăgubire |
| Câmpuri | Starea alimentării, temperatura setată, ultima citire, temperatura maximă | Suma cererii de despăgubire (nu se află în lentila de bază), câmpuri personale (dezactivate implicit) |
| Acțiuni | Înregistrarea cauzei unei abateri, solicitarea unei verificări a alimentării | Modificarea temperaturii setate și închiderea unei abateri (doar controlorii), redactarea unei note privind cererea de despăgubire |
Am încercat totuși să adaug suma cererii de despăgubire în lentila pentru tehnicieni, deoarece un tehnician o solicitase. Constructorul a refuzat cu LENS_CANNOT_WIDEN și nu a salvat nimic. Nu există nicio soluție ocolitoare în cadrul lentilei: calea de urmat este o lentilă pe o bază mai largă, o solicitare diferită asupra căreia decide administratorul organizației. Am omis-o.
Ascunderea unui element într-o lentilă nu îl elimină din Nexus. Înseamnă doar că acest rol nu îl vede. Constructorul arată câte persoane va atinge o lentilă în proiectul pilot (29, în cazul nostru) și păstrează un jurnal al fiecărei operațiuni de Adăugare, Modificare și Retragere. O lentilă este definită o singură dată pentru organizație și acordată per unitate unui rol de platformă, astfel încât aceeași lentilă Tehnician containere frigorifice poate fi acordată tehnicienilor din Rotterdam luna aceasta și celor din Felixstowe luna viitoare.
O competență pentru redactarea notelor de daună
Controlorii doreau o primă versiune a notei care se trimite unui proprietar de marfă după o abatere. Aceasta este o activitate lingvistică, deci rulează pe un model, iar întrebarea era unde să o plasăm.
În Nexus există două tipuri de abilități, iar diferența contează aici. O abilitate de manifest este un rând tipizat în skills[] al unui plugin, distribuit de platformă. O abilitate Skills Engine este un pachet SKILL.md din biblioteca de abilități a organizației, pe care agenții, butoanele IA (inteligență artificială), fluxurile de lucru și instrumentele pentru dezvoltatori îl rulează toate în același mod. Capitolul 2.20, Abilități, le tratează pe amândouă.
Nivelul de încredere al pluginului nostru este community, iar un plugin comunitar poate declara doar abilități de manifest care nu accesează un model (host_callback și plugin_queue). Cele două niveluri care accesează AI Provider Router, tool_using și llm_only, necesită nivelul de încredere core sau verified. Prin urmare, redactarea notelor privind cererile de despăgubire a devenit o abilitate Skills Engine, iar router-ul alege modelul din propriul set al 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.Pachetul se află în skills/draft-claim-note/ în depozit, numele folderului fiind identic cu numele abilității. L-am validat și încărcat din terminal:
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Încărcarea de două ori a aceluiași conținut returnează versiunea existentă în loc de una nouă (CONTENT_HASH_ALREADY_PUBLISHED), așa că reluarea încărcării este sigură. Înainte ca o versiune să fie lansată, Skills Engine rulează cazurile sale de test, o rulare de probă în modul umbră pe activitatea anterioară și o revizuire oarbă efectuată de un model de la o altă companie, cu durata și costul fiecărei rulări.
Pluginul cu servicii complete
Pachetul avea nevoie și de cod care rulează permanent: un cititor pentru fluxul de telemetrie al containerelor frigorifice și un scriitor care deschide o înregistrare de abatere atunci când o citire își depășește limitele. Un astfel de cod își are locul într-un plugin cu servicii complete, iar noi l-am generat cu comanda proprie a SDK-ului, care scrie întregul arbore de referință cu numele substituit:
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-ul se instalează din https://registry.adverant.ai/npm/ cu tokenul de descărcare de pe pagina Tokenuri de descărcare și comenzi de instalare din contul dumneavoastră Adverant. Faceți commit pentru package-lock.json pe care îl scrie prima instalare; construirea imaginii rulează npm ci și refuză să continue fără acesta.
Iată partea din nexus.manifest.json care diferă de șablon. Nu este întregul fișier: blocurile description, author, license, runtime, backend și frontend din schelet rămân așa cum sunt, iar validatorul refuză un manifest de serviciu complet fără ele. Cele trei propoziții architecture sunt regula pe care fiecare plugin o reformulează, iar validatorul verifică formularea. UNO, în prima dintre ele, este motorul de fluxuri de lucru:
{
"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 este o abilitate de manifest cu nivelul host_callback: platforma trimite datele de intrare către propriul nostru Service, în interiorul namespace-ului nostru, și niciodată către o gazdă pe care o numim. Ruta receptorului este declarată auth: internal și protejată cu serviceMiddleware din SDK, forma Express a protecției, care refuză un token de apel emis pentru orice alt plugin, organizație, abilitate sau rută. Valoarea sa classification este tenant, care reprezintă plafonul pentru un plugin comunitar. Capitolul 2.27, Scenarii de construire, prezintă separat o abilitate host_callback.
Două obiceiuri din această etapă merită preluate. Fiecare tabel conține organization_id, owner_user_id și business_unit_id încă de la prima migrare, deoarece adăugarea ulterioară a unei axe înseamnă o migrare peste rânduri active. Și am rulat nexus-gates local înainte de fiecare push, deoarece este aceeași comandă pe care o rulează pipeline-ul; o rulare care nu a examinat nimic se încheie cu codul 2 și o spune explicit. Capitolul 2.19, Regulile pe care le moștenește fiecare extensie, enumeră porțile.
Date de eșantion pentru testare
Pagina Date de probă pentru testare oferă trei tipuri de ramuri:
| Tip | Ce conține | Cine aprobă |
|---|---|---|
| Sintetice | Date generate din numerele și formele pe care le stabiliți; nimic nu provine dintr-o unitate reală | Nimeni; este a dumneavoastră |
| Copie mascată | O copie a unei unități în care câmpurile personale, sensibile și comerciale sunt înlocuite | Proprietarul datelor (Priya Natarajan pentru Rotterdam) |
| Doar schema | Forma depozitelor de date, fără rânduri | Nimeni; pentru migrări |
Am generat o săptămână aglomerată: aproximativ 7 abateri la fiecare 100 de containere frigorifice, așa cum arată un august aglomerat la Rotterdam. Cazurile neobișnuite au contat mai mult decât volumul. Am cerut pierderea alimentării în timpul descărcării, o ușă lăsată deschisă, o întrerupere a senzorului și două daune pentru o singură abatere. Pagina poate sugera cazuri neobișnuite pe baza cauzelor abaterilor din modelul de cunoștințe, niciodată din înregistrări reale.
Fiecare set de numere și forme este salvat ca seed, de exemplu cold-chain-busy-01, împreună cu amprenta sa. Același seed produce aceleași date, astfel încât fiecare rulare de test pe fiecare ramură vede aceeași săptămână. Acesta este motivul pentru care cele 66 de teste ale noastre au fost repetabile.
O ramură există implicit 72 de ore și cel mult 14 zile. Am cerut să păstrăm ramura aglomerată timp de 30 de zile în timpul unei revizuiri lungi, iar pagina a refuzat cu BRANCH_LIFE_EXCEEDED. Soluția este cea sugerată de mesaj: păstrați seed-ul și creați o ramură nouă din el atunci când aveți nevoie. O copie mascată respectă aceleași limite, iar cererea pentru ea include un motiv și o durată de până la 14 zile.
Previzualizarea unei perspective așa cum o vede o persoană
Înainte ca cineva din Rotterdam să vadă Cold chain, l-am privit așa cum l-ar vedea ei. Previzualizarea unei perspective ca o anumită persoană afișează pachetul exact așa cum îl vede un rol ales, pe o ramură de date, într-un cadru de previzualizare punctat.
Trei reguli fac ca previzualizările să poată fi folosite liber, în siguranță. O previzualizare folosește o ramură de date, niciodată unitatea activă. Propriile dumneavoastră permisiuni nu se transferă în ea, astfel încât vedeți ce vede rolul, nu ce puteți vedea dumneavoastră. Și se încheie după 30 de minute. Îndreptarea unei previzualizări către o unitate activă este refuzată cu CONNECTION_SCOPE_EXCEEDED; dacă aveți nevoie de forme reale, cereți proprietarului datelor o copie mascată și faceți previzualizarea pe aceasta.
Previzualizarea este locul în care am descoperit o greșeală reală. Graficul de temperatură din vizualizarea tehnicianului afișa valoarea de referință, iar modificările valorii de referință erau destinate doar controlorilor. Graficul era în regulă; butonul de editare de sub el nu era. Versiunea 0.3.2 a ascuns modificările valorii de referință față de tehnicieni, iar previzualizarea este locul unde am descoperit problema.
Modificarea modelului de cunoștințe după livrare
Până la versiunea 0.4.0 aveam nevoie de un tip Inspection pentru inspecțiile dinaintea transportului, iar relația „Excursion caused Claim” suna mai bine ca „Excursion led to Claim”. Trecerea modelului de la 1.3 la 1.4 este o modificare a modelului de cunoștințe, iar pagina Modificări ale modelului de cunoștințe arată diferențele, ce ar afecta și în ce etapă se află.
Modificarea circulă sub forma unei cereri de modificare a grafului. Rularea sa de probă numără ce ar afecta în copia mascată a Rotterdam, sub formă de totaluri: în cazul nostru, 1.284 de legături redenumite și nimic eliminat. Doi recenzenți o aprobă, iar pipeline-ul o aplică în staging, apoi în pilot. Nimeni nu scrie manual în graful partajat; o încercare este refuzată și înregistrată. Trei întrebări salvate foloseau cuvântul „caused”, iar modificarea a inclus o rescriere automată pentru fiecare dintre ele, pe care pagina le-a enumerat. Filtrele perspectivelor nu s-au schimbat, deoarece ambele perspective doar restrângeau în continuare.
Promovarea în producție
Fiecare versiune parcurge un singur traseu: spațiul de dezvoltare, staging, o unitate pilot, apoi toate unitățile. Fiecare etapă are porți, iar niciuna nu poate fi sărită.
| Către | Porți de verificare |
|---|---|
| Staging | Toate testele trec; verificări de calitate; manifest neschimbat sau extinderea acceptată; imagine semnată |
| Pilot (Rotterdam) | Rulare de probă a modificării modelului pe copia mascată, fără erori; verificarea politicilor pentru regulile de perspectivă și de domeniu; doi recenzenți care nu sunt autorul, unul dintre ei fiind proprietarul datelor |
| Toate unitățile | 14 zile în pilot; erori sub 1 la 1.000, numărate în pilot; fiecare administrator de unitate își dă acordul pentru unitatea sa; doi recenzenți care nu sunt autorul |
Am încercat scurtătura o singură dată, într-o vineri, pentru o corecție de un rând: să promovez 0.4.0-dev din spațiul meu de dezvoltare către toate unitățile. A fost refuzată cu GATE_CANNOT_BE_SKIPPED și nu s-a promovat nimic. Mesajul vă indică să promovați în schimb către etapa următoare, iar acesta este singurul răspuns posibil.
Revizuirea versiunii în sine, dovezile pe care le citește un al doilea recenzent și canalele pe care le aleg unitățile se află în capitolul 2.28, Lansarea extensiei dumneavoastră. Două fapte de acolo își au locul aici, deoarece influențează modul în care planificați o verticală. Autorul nu este niciodată considerat recenzent, așa că o echipă de două persoane are nevoie de o a treia persoană pentru fiecare versiune. Și fiecare mediu păstrează versiunea anterioară timp de 30 de zile, astfel încât revenirea este o modificare revizuită pe care pipeline-ul o efectuează în aproximativ un minut.
Extinderea unui pachet care există deja
Nu orice verticală pornește de la zero. Un pachet poate moșteni de la altul și poate adăuga doar ce este diferit. Pachetul Banking and payments, utilizat de Larchmont Bank, este cel mai clar exemplu din catalog. Manifestul său începe astfel:
{
"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 numește pachetul pe care se bazează. Banking and payments păstrează structura pachetului Insurance, grupurile sale de conversații partajate și termenii de bază, și adaugă trei perspective proprii: Lending decisions, Card disputes și My account. Al treilea element al fiecărei intrări din lexicon este exact pentru un termen care trebuie afișat așa cum este scris, de exemplu APR (dobânda anuală efectivă), în loc să fie reformulat.
Unele lucruri nu se pot face prin moștenire. Un pachet nu modifică niciodată shell-ul, componentele sau regulile de redactare, așa că un pachet derivat nu poate schimba stilul consolei. Un regim de reglementare de care au nevoie mai multe pachete este o singură perspectivă partajată, nu o copie în fiecare: registrul tehnologiei externalizate servește atât Insurance, cât și Banking and payments. Dacă pachetul dumneavoastră derivat are nevoie de o perspectivă care există deja ca perspectivă partajată, folosiți-o în loc să o creați pe a dumneavoastră.
Licențierea urmează moștenirea. Un pachet este licențiat peste Enterprise și poate necesita suplimente, iar documentul de licență conține aceste dependențe. Insurance necesită Decision rooms și înregistrări sigilate, așa că un client care licențiază un pachet ce îl moștenește are nevoie și de acest supliment, iar consola refuză să emită o licență care îl omite. Ecranele pentru telefon ale unui pachet necesită, de asemenea, suplimentul Mobile apps. Verificați lanțul de cerințe înainte de a promite unui client o dată.
Adăugarea unei perspective la un pachet care a fost livrat
Cea mai mică lucrare verticală este o perspectivă nouă pe un pachet pe care nu l-ați scris dumneavoastră. La șase luni de la începutul pilotului, echipa de daune maritime a Larkfield a dorit o perspectivă proprie în Cold chain: abateri și daune, fără puncte de alimentare, fără valori de referință. Nu am atins codul pachetului. O perspectivă este un rând în registrul de perspective al organizației, deținut de pachet, așa că am pornit-o din traseul standard pentru perspective din Start something new și am modelat-o în Lens builder, având ca bază perspectiva Cold-chain controller. Se aplică aceeași regulă ca înainte: noua perspectivă poate ascunde ce arată baza sa, dar nu poate arăta niciodată mai mult. Este definită o singură dată pentru organizație și acordată unui rol de platformă în fiecare unitate. Un acord este retras, niciodată șters, iar acordarea din nou a perspectivei creează un acord nou, astfel încât rămâne lizibil cine a deținut ce perspectivă și când. Registrul numără câte persoane au deținut o perspectivă în fiecare lună, niciodată cine.
Pagina Perspective și cine le vede afișează rezultatul ca o matrice de perspective pe unități și roluri, cu Add, Change și Withdraw în fiecare celulă. Previzualizați noua perspectivă ca o anumită persoană înainte de a o acorda, exact ca mai sus.
Cât a costat, în mod realist
Un pachet atinge înregistrările unui client, așa că platforma face intenționat unele lucruri lente, iar dumneavoastră ar trebui să le planificați încă din prima zi.
- O copie mascată necesită de fiecare dată acordul proprietarului datelor. Prima dată, a noastră a sosit după o zi, deoarece Priya a dorit să citească mai întâi modelul de cunoștințe. Începeți cu date sintetice și cereți din timp.
- Autorul nu își poate aproba propria versiune, iar cererile expiră după 3 zile. Dacă recenzenții dumneavoastră sunt ocupați, versiunea dumneavoastră așteaptă.
- O versiune care solicită mai mult decât precedenta, de exemplu trimiterea de e-mailuri sau o adresă externă, este reținută până când doi recenzenți acceptă manifestul extins. Capitolul 2.28, Lansarea extensiei dumneavoastră, prezintă pagina Manifest și permisiuni, care vă informează înainte să solicitați.
- O perspectivă nu poate arăta ce ascunde perspectiva sa de bază. Dacă un rol chiar are nevoie de mai mult, aceasta este o discuție cu administratorul organizației, nu o setare.
Niciuna dintre acestea nu ne-a stat în cale de două ori. A doua versiune a Cold chain a durat o săptămână de la primul commit până la pilotul din Rotterdam, cea mai mare parte fiind rularea celor 66 de teste pe trei ramuri și citirea dovezilor de către două persoane.




