Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.24
Ndërtimi i një vertikaleje të personalizuar nga fillimi në fund
Një ndërtim praktik i paketës së domenit të zinxhirit të ftohtë, nga përmbledhja e parë deri te një lëshim që ekzekutohet për çdo njësi, me modelin e vet të njohurive, lentet, një aftësi, një shtojcë me shërbim të plotë dhe të dhëna shembull. Më pas, si të zgjeroni një paketë që ekziston tashmë dhe si t'i shtoni një lente një pakete që është shpërndarë.
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Unë jam Mateo Ruiz, zhvillues në Corrán Orbital. Pjesën më të madhe të javës ia kushtoj softuerit tonë të ngarkesës, por ky kapitull ka të bëjë me një punë që bëmë për një klient. Larkfield & Vane siguron mallra, dhe një pjesë gjithnjë e më e madhe e tyre udhëton në kontejnerë frigoriferikë. Kur një kontejner frigoriferik humbet furnizimin me energji nga bregu në kalatë, temperatura rritet, malli prishet dhe disa javë më vonë pason një kërkesë për dëmshpërblim. Larkfield donte që njerëzit e tyre ta shihnin këtë zinxhir si një të tërë në Nexus, nga defekti i energjisë deri te kërkesa për dëmshpërblim, ku secili rol sheh vetëm pjesën e vet. Kështu lindi paketa Cold chain.
Në vijim përshkruhet ndërtimi sipas radhës që e bëmë, me ekranet, skedarët dhe komandat. I kam lënë edhe gabimet, sepse dy nga refuzimet që hasëm na mësuan më shumë për platformën sesa rruga pa probleme. Materiali referues ndodhet në kapitujt para këtij dhe unë ju drejtoj tek ata në vend që t'i përsëris. Ata mbi të cilët u mbështeta më shumë ishin kapitulli 2.18, Modeli i zgjerimeve, dhe kapitulli 2.23, Paketat e domenit, me kapitullin 2.21, Plugin SDK, të hapur pranë tyre për vetë paketën e zhvillimit të softuerit.
Përmbledhja dhe kush bën çfarë
Larkfield më dha një vend zhvilluesi në organizatën e tyre për gjatë gjithë kohëzgjatjes së projektit. Kjo ka rëndësi, sepse një paketë private për një klient ndërtohet brenda instalimit të atij klienti, në hapësirat e tij të zhvillimit dhe degët e të dhënave, me miratimet e njerëzve të tij. Një paketë e menduar për shumë klientë ndërtohet ndryshe, në një klaster botuesi vetëm me të dhëna shembull, dhe kapitulli 2.25, Ndërtimi për çdo edicion, e trajton atë rast.
Detyra fillestare zinte një faqe:
- Kontejnerët frigoriferikë në kala dhe në anije: energjia e tyre, devijimet e temperaturës dhe kërkesat për dëmshpërblim që pasojnë.
- Dy role për fillim: një teknik i kontejnerëve frigoriferikë në kala dhe një kontrollues i zinxhirit të ftohtë në zyrë.
- Një projekt pilot që zhvillohet fillimisht në njësinë Rotterdam dhe më pas kalon në Felixstowe.
- Dëshmi për tre grupe rregullash: marrëveshja ATP për ushqimet që prishen, praktika e mirë e shpërndarjes e BE-së për barnat dhe regjistrat e sigurisë ushqimore sipas HACCP (analiza e rreziqeve dhe pikat kritike të kontrollit). Kërkesat për dëmshpërblim sipas rregullave Hague-Visby përdorin të njëjtat regjistra devijimesh, ndaj i shënuam për pas projektit pilot.
Paketat e domenit janë një aftësi e Enterprise. Larkfield përdor Enterprise, ndaj rruga e paketës së domenit ishte e hapur për mua. Në Community, rruga e artë për një paketë nuk ofrohet fare.
Filloni nga rruga e artë
Gjithçka fillon në faqen Fillo diçka të re. Ajo ofron gjashtë rrugë të arta: plugin, paketë domeni, lente, platformë, aftësi dhe rrjedhë pune. Secila krijon një depo nga një shabllon me version, një manifest që deklaron çfarë i nevojitet, teste, një hapësirë zhvillimi dhe degë të dhënash. Të njëjtat rrugë funksionojnë në konsolë, në vijën e komandës dhe nga IDE-ja juaj (mjedisi i integruar i zhvillimit), ku mjeti Workbench nexus.create kryen të njëjtën punë me një plan që ju e konfirmoni më parë.
nexus create dhe shabllonin e saj të fiksuar. Vini re pllakën në fund: manifesti zbatohet detyrimisht, nuk është këshillues, dhe një publikim që kërkon më shumë mbahet pezull derisa ta shqyrtojnë dy persona.Nga ajo faqe zgjodhëm rrugën e paketës së domenit, duke e emërtuar paketën cold-chain dhe njësinë e saj të parë Rotterdam. Rezultati emërton shabllonin e fiksuar, domain-pack@1.6.0, dhe rendit çfarë krijoi: depon, një manifest që deklaron katër fusha veprimi, dy depozita dhe asnjë adresë dalëse, 66 teste nga shablloni, një hapësirë zhvillimi në Rotterdam, tre degë të dhënash sintetike dhe një hyrje draft në katalogun e vetë Larkfield që mund ta shihja vetëm unë. Versioni i shabllonit është i fiksuar dhe përditësimi i tij më vonë vjen si një ndryshim i shqyrtuar si çdo tjetër, kështu që paketa e askujt nuk ndryshon pa dijeninë e tij vetëm sepse ndryshoi një shabllon. Për paketën tonë të parë përdora gjithsesi magjistarin e konsolës, sepse ai e tregon planin përpara se të krijojë ndonjë gjë.
Hapi 1: tregoni për çfarë shërben paketa
Magjistari Paketë e re domeni ka tre hapa: rreth saj, modeli i njohurive, dhe shqyrtimi e krijimi. Hapi 1 pyet për ato pak gjëra që përcaktojnë gjithçka pas tij.
| Fusha | Çfarë futëm | Shënim |
|---|---|---|
| Emri | Cold chain | Përdoret për depon dhe katalogun |
| Për çfarë shërben | Kontejnerët frigoriferikë në kalata dhe në anije: energjia, devijimet e temperaturës dhe kërkesat për dëmshpërblim që pasojnë | |
| Industria | Logjistika dhe sektori detar | Ndërtohet mbi paketën Logjistikë dhe detare |
| Pronari | Personi që e krijon | I kyçur në magjistar |
| Njësitë | Rotterdam (pilot) | Felixstowe pas projektit pilot |
| Shablloni | domain-pack@1.6.0 |
I kyçur; përditësimet vijnë si ndryshime të shqyrtuara |
| Rregullat që harton | Marrëveshja ATP, praktika e mirë e shpërndarjes e BE-së, regjistrat e sigurisë ushqimore | Çdo rregull bëhet një faqe në hartën e dëshmive të paketës |
Asistenti në panelin anësor sugjeroi rreshtin e fundit, përfshirë faktin që kërkesat për dëmshpërblim të mallrave ripërdorin të njëjtat regjistra devijimesh. Një pllakë në fund të faqes thotë se ende nuk është krijuar asgjë. Depoja, hapësira e zhvillimit dhe degët e të dhënave krijohen vetëm kur shtypni Krijo në hapin 3, pasi të keni parë planin. Mund të ruani një draft dhe të ktheheni më vonë.
Hapi 2: modeli i njohurive
Modeli i njohurive është grupi i llojeve të gjërave që paketa njeh dhe mënyra si lidhen ato. Cold chain filloi nga modeli bazë i logjistikës, logistics-base 4.2, i importuar nga SDK, i cili na dha pesë lloje bazë mbi të cilat të ndërtonim (Vessel, Port, Container, Carrier dhe Shipment). Llojet bazë janë vetëm për lexim në magjistar. Nëse një prej tyre duhet ndryshuar, ai ndryshohet në paketën që e zotëron.
Shtuam pesë lloje tonat:
| Lloji | Çfarë është | Vetitë |
|---|---|---|
| Njësi frigoriferike | Një kontejner frigoriferik | 9 |
| Ndalesë anijeje | Një anije në një kalatë ankorimi | 6 |
| Devijim | Një temperaturë jashtë kufijve të saj | 8 |
| Furnizim me energji | Një pikë energjie nga bregu ose nga anija | 4 |
| Merr në pronësi | Para e kërkuar për mallin e prishur | 7 |
Çdo veti klasifikohet ndërsa e krijoni. "Raportuar nga" te një Devijim është personale. "Vlera e mallit në rrezik" dhe shuma e shlyerja e një kërkese për dëmshpërblim janë tregtare. Ditën e parë kjo dukej si burokraci, por na shpëtoi dy herë më vonë, sepse klasat përcaktojnë çfarë mund të shfaqë një lente, çfarë zëvendëson një kopje e maskuar dhe çfarë fsheh një rresht regjistri.
Dy nga marrëdhëniet tona shtrihen në modelin bazë: një Njësi frigoriferike është e lidhur me një Furnizim me energji, dhe një Kërkesë për dëmshpërblim i referohet një Shipment. Vetë modeli bazë nuk ndryshohet. Një veti që e tërhiqni mbetet në versionin 1.0 të modelit dhe largohet vetëm në një version të mëvonshëm, kështu që asgjë që ishte e vërtetë për regjistrat e vjetër nuk pushon së qeni e lexueshme.
Hapi 3: rishikoni dhe krijoni
Hapi 3 është plani. Ai rendit çfarë do të krijohet, fushat e veprimit që do të deklarojë manifesti, degët e të dhënave dhe hapësirën e zhvillimit. Ju e konfirmoni planin me passkey-n tuaj dhe plani merr një shenjë gishti. Më pas krijimi ndjek saktësisht atë plan, hap pas hapi, dhe mund të ndaleni në çdo hap e të mbani atë që është krijuar.
Plani për Cold chain deklaroi katër fusha veprimi:
| Fusha e veprimit | Pse i nevojitet paketës |
|---|---|
| Lexim i telemetrisë së kontejnerëve frigoriferikë | Leximet e energjisë dhe të temperaturës |
| Shkrim i devijimeve | Regjistron një devijim kur kalohen kufijtë |
| Lexim i dërgesave | Lidh një kërkesë për dëmshpërblim me dërgesën e saj |
| Hartim i shënimeve të kërkesave për dëmshpërblim | Vetëm drafte; dërgon një person |
Depozitat e saj ishin grafi dhe regjistrat. Nuk kishte adresa dalëse dhe kishte profilin Standard të sandbox-it. Hapësira e zhvillimit erdhi me 4 bërthama, 16 GiB memorie dhe 50 GiB hapësirë ruajtjeje, një rrjet të mbyllur përveç asaj që deklaron manifesti, vetëm imazhe të nënshkruara, dhe përfundim pas 7 ditësh pa aktivitet. Kur përfundon, përkufizimi i saj mbetet në depo, kështu që e krijoni sërish prej andej.
Tre degët e të dhënave erdhën nga gjeneratori sintetik. Nuk u kopjua asnjë e dhënë klienti. Një kopje e maskuar e Rotterdam kërkon pëlqimin e pronarit të të dhënave, që në Larkfield është Priya Natarajan, dhe ai kërkohet veçmas.
Manifesti i paketës
Depoja përmban manifestin e paketës, pack.json. Ai emërton paketën, versionin e saj, paketën nga e cila trashëgon (nëse ka), klasterët dhe fjalët e saj. Një klaster është ose një lente, që është ajo që sheh një rol brenda paketës, ose i përbashkët, që funksionon përgjatë të gjitha lenteve. Ja thelbi i tonit:
{
"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", ""]
]
}
}Leksiku përmban fjalët e vetë paketës me një shpjegim të thjeshtë për secilën, mjaft të shkurtër për t'u lexuar në telefon.
Krahas pack.json, manifesti deklaron edhe çfarë mund të arrijë paketa: fushat e veprimit, depozitat, adresat dalëse dhe profilin e sandbox-it. Nexus jep pikërisht këtë dhe asgjë më shumë. Çdo thirrje mjeti kontrollohet kundrejt fushave të deklaruara të veprimit, dhe një adresë e jashtme bllokohet nëse nuk është e listuar. Deklaratën, si dhe ndryshimin krahasuar me publikimin e fundit, mund t'i lexoni në faqen Manifesti dhe lejet e paketës.
Lentet: çfarë sheh secili rol
Një lente mund vetëm të ngushtojë atë që shfaq baza e saj, dhe ky rregull i vetëm e formësoi dizajnin tonë më shumë se çdo tjetër. Një lente shfaq një pjesë të asaj që shfaq lentja e saj bazë, dhe lejet vijnë ende nga rolet: një lente përcakton çfarë sheh një rol në paketë, jo çfarë i lejohet të bëjë.
Lentja Teknik i kontejnerëve frigoriferikë ngushton Kontrolluesin e operacioneve, lenten bazë që Larkfield përdor tashmë për punën logjistike. Në Ndërtuesin e lenteve ju shënoni kartat, fushat dhe veprimet që shfaq lentja. Elementet që baza nuk i shfaq janë të kyçura.
| Pjesa | Teknik i kontejnerëve frigoriferikë shfaq | Lënë jashtë |
|---|---|---|
| Kartat | Njësitë frigoriferike në kalata, devijimet e hapura, pikat e energjisë, ndalesat e anijeve sot | Çdo gjë që lidhet me kërkesat për dëmshpërblim |
| Fushat | Gjendja e energjisë, vlera e caktuar, leximi i fundit, temperatura më e lartë | Shuma e kërkesës për dëmshpërblim (jo në lenten bazë), fushat personale (joaktive si parazgjedhje) |
| Veprimet | Regjistrimi i shkakut të një devijimi, kërkimi i një kontrolli të energjisë | Ndryshimi i një vlere të caktuar dhe mbyllja e një devijimi (vetëm kontrolluesit), hartimi i një shënimi për kërkesë dëmshpërblimi |
Gjithsesi u përpoqa ta shtoja shumën e kërkesës për dëmshpërblim në lenten e teknikut, sepse një teknik e kishte kërkuar. Ndërtuesi refuzoi me LENS_CANNOT_WIDEN dhe nuk ruajti asgjë. Brenda lentes nuk ka rrugëdalje: rruga përpara është një lente mbi një bazë më të gjerë, një kërkesë tjetër për të cilën vendos administratori i organizatës. E lamë jashtë.
Fshehja e diçkaje në një lente nuk e heq atë nga Nexus. Do të thotë që ky rol nuk e sheh. Ndërtuesi tregon sa persona do të arrijë një lente në projektin pilot (29, në rastin tonë) dhe mban një regjistër të çdo Shtimi, Ndryshimi dhe Tërheqjeje. Një lente përkufizohet një herë për organizatën dhe u jepet sipas njësisë një roli të platformës, kështu që e njëjta lente Teknik i kontejnerëve frigoriferikë mund t'u jepet teknikëve të Rotterdam këtë muaj dhe atyre të Felixstowe muajin tjetër.
Një aftësi për hartimin e shënimeve të kërkesave të dëmshpërblimit
Kontrolluesit donin një draft të parë të shënimit që i dërgohet pronarit të mallit pas një devijimi. Kjo është punë gjuhësore, ndaj ekzekutohet mbi një model, dhe pyetja ishte ku ta vendosnim.
Në Nexus ka dy lloje aftësish dhe dallimi ka rëndësi këtu. Një aftësi manifesti është një rresht i tipizuar në skills[] të një plugin-i, i dërguar për ekzekutim nga platforma. Një aftësi e Skills Engine është një paketë SKILL.md në bibliotekën e aftësive të organizatës, të cilën agjentët, butonat AI (inteligjenca artificiale), rrjedhat e punës dhe mjetet e zhvilluesve e ekzekutojnë të gjithë në të njëjtën mënyrë. Kapitulli 2.20, Aftësitë, i trajton të dyja.
Niveli i besimit të plugin-it tonë është community, dhe një plugin komuniteti mund të deklarojë vetëm aftësi manifesti që nuk arrijnë një model (host_callback dhe plugin_queue). Dy nivelet që arrijnë AI Provider Router, tool_using dhe llm_only, kërkojnë besim core ose verified. Prandaj hartimi i shënimeve të kërkesave për dëmshpërblim u bë një aftësi e Skills Engine, dhe router-i zgjedh modelin nga grupi i vetë 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.Paketa ndodhet në skills/draft-claim-note/ në depo, me emrin e dosjes të njëjtë me emrin e aftësisë. E vlefshmëruam dhe e ngarkuam nga terminali:
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-noteNgarkimi i së njëjtës përmbajtje dy herë kthen versionin ekzistues në vend të një versioni të ri (CONTENT_HASH_ALREADY_PUBLISHED), kështu që përsëritja e ngarkimit është e sigurt. Përpara se një version të publikohet, Skills Engine ekzekuton rastet e tij të testimit, një ekzekutim provë në hije mbi punë të mëparshme dhe një shqyrtim të verbër nga një model i një kompanie tjetër, me kohën dhe koston e çdo ekzekutimi.
Shtojca me shërbim të plotë
Paketës i duhej gjithashtu kod që funksionon gjatë gjithë kohës: një lexues për rrjedhën e telemetrisë së kontejnerëve frigoriferikë dhe një shkrues që hap një regjistër devijimi kur një lexim kalon kufijtë e tij. Një kod i tillë i përket një plugin-i me shërbim të plotë, dhe e krijuam skeletin e tij me komandën e vetë SDK-së, e cila shkruan të gjithë pemën referuese me emrin të zëvendësuar:
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 instalohet nga https://registry.adverant.ai/npm/ me token-in e tërheqjes nga faqja Token-ët e tërheqjes dhe komandat e instalimit të llogarisë suaj Adverant. Bëni commit package-lock.json që shkruan instalimi i parë; ndërtimi i imazhit ekzekuton npm ci dhe refuzon pa të.
Ja pjesa e nexus.manifest.json tonë që ndryshon nga shablloni. Nuk është i gjithë skedari: blloqet description, author, license, runtime, backend dhe frontend të skeletit mbeten siç janë, dhe validuesi refuzon një manifest shërbimi të plotë pa to. Tre fjalitë architecture janë ligji që çdo plugin e riformulon, dhe validuesi kontrollon formulimin. UNO në fjalinë e parë është motori i rrjedhave të punës:
{
"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 është një aftësi manifesti me nivelin host_callback: platforma e dërgon hyrjen te Service ynë, brenda namespace-it tonë, dhe kurrë te një host që emërtojmë ne. Rruga marrëse deklarohet auth: internal dhe mbrohet me serviceMiddleware të SDK-së, formën Express të mbrojtjes, e cila refuzon një token thirrjeje të lëshuar për çdo plugin, organizatë, aftësi ose rrugë tjetër. classification e saj është tenant, që është kufiri i sipërm për një plugin të komunitetit. Kapitulli 2.27, Skenarë ndërtimi, shpjegon hap pas hapi një aftësi host_callback më vete.
Dy zakone nga kjo fazë ia vlen të kopjohen. Çdo tabelë mban organization_id, owner_user_id dhe business_unit_id që nga migrimi i parë, sepse shtimi i një boshti më vonë është një migrim mbi rreshta aktivë. Dhe ne ekzekutuam nexus-gates lokalisht para çdo push-i, pasi është e njëjta komandë që ekzekuton pipeline-i; një ekzekutim që nuk shqyrtoi asgjë del me kodin 2 dhe e thotë këtë. Kapitulli 2.19, Rregullat që trashëgon çdo zgjerim, rendit portat.
Të dhëna shembull për testim
Faqja Të dhëna shembull për testim ofron tre lloje degësh:
| Lloji | Çfarë mban | Kush jep pëlqimin |
|---|---|---|
| Sintetike | Të dhëna të gjeneruara nga numrat dhe format që caktoni ju; asgjë nuk vjen nga një njësi reale | Askush; është e juaja |
| Kopje e maskuar | Një kopje e një njësie me fushat personale, të ndjeshme dhe tregtare të zëvendësuara | Pronari i të dhënave (Priya Natarajan për Rotterdam) |
| Vetëm skema | Forma e depove, pa rreshta | Askush; për migrime |
Ne gjeneruam një javë të ngarkuar: rreth 7 devijime në çdo 100 kontejnerë frigoriferikë, që është pamja e një gushti të ngarkuar në Rotterdam. Rastet e veçanta kishin më shumë rëndësi se vëllimi. Kërkuam ndërprerje energjie gjatë shkarkimit, një derë të lënë hapur, një boshllëk sensori dhe dy pretendime për një devijim. Faqja mund të sugjerojë raste të veçanta nga shkaqet e devijimeve në modelin e njohurive, kurrë nga regjistrime reale.
Çdo grup numrash dhe formash ruhet si farë, si p.sh. cold-chain-busy-01, me shenjën e saj identifikuese. E njëjta farë jep të njëjtat të dhëna, kështu që çdo ekzekutim testi në çdo degë sheh të njëjtën javë. Kjo i bëri 66 testet tona të përsëritshme.
Një degë jeton 72 orë si parazgjedhje dhe 14 ditë më së shumti. Kërkova ta mbaja degën tonë të ngarkuar për 30 ditë gjatë një rishikimi të gjatë, dhe faqja refuzoi me BRANCH_LIFE_EXCEEDED. Zgjidhja është ajo që sugjeron pllaka: ruani farën dhe krijoni një degë të re prej saj kur ju duhet. Një kopje e maskuar ndjek të njëjtat kufij, dhe kërkesa e saj përmban një arsye dhe një kohëzgjatje deri në 14 ditë.
Shikoni paraprakisht një lente si një person
Para se dikush në Rotterdam të shihte Cold chain, ne e shikuam ashtu siç do ta shihnin ata. Paraqitja paraprake e një lenteje si një person e shfaq paketën saktësisht siç e sheh një rol i zgjedhur, në një degë të dhënash, brenda një kornize paraprake me vija të ndërprera.
Tre rregulla i bëjnë paraqitjet paraprake të sigurta për t'u përdorur lirshëm. Një paraqitje paraprake përdor një degë të dhënash, kurrë njësinë aktive. Lejet tuaja nuk depërtojnë në të, kështu që ju shihni atë që sheh roli dhe jo atë që mund të shihni ju. Dhe përfundon pas 30 minutash. Drejtimi i një paraqitjeje paraprake drejt një njësie aktive refuzohet me CONNECTION_SCOPE_EXCEEDED; nëse ju duhen forma reale, kërkojini pronarit të të dhënave një kopje të maskuar dhe bëni paraqitjen paraprake mbi të.
Paraqitja paraprake është vendi ku zbuluam një gabim real. Grafiku i temperaturës në pamjen e teknikut tregonte pikën e caktuar, dhe ndryshimet e pikës së caktuar ishin menduar vetëm për kontrollorët. Grafiku ishte në rregull; butoni i ndryshimit poshtë tij jo. Versioni 0.3.2 i fshehu ndryshimet e pikës së caktuar nga teknikët, dhe paraqitja paraprake është vendi ku e gjetëm.
Ndryshimi i modelit të njohurive pas shpërndarjes
Deri në versionin 0.4.0 na duhej një lloj Inspektim për inspektimet para udhëtimit, dhe relacioni "Devijimi shkaktoi Pretendimin" lexohej më mirë si "Devijimi çoi në Pretendim". Kalimi i modelit nga 1.3 në 1.4 është një ndryshim i modelit të njohurive, dhe faqja Ndryshimet e modelit të njohurive tregon diferencën e tij, çfarë do të prekte dhe ku ndodhet në rrugën e tij.
Ndryshimi udhëton si një kërkesë për ndryshim grafi. Ekzekutimi i tij provë numëron çfarë do të prekte në kopjen e maskuar të Rotterdam, si numra: për ne, 1,284 lidhje të riemërtuara dhe asgjë e hequr. Dy rishikues e miratojnë, dhe pipeline-i e zbaton në staging, pastaj në pilot. Askush nuk shkruan me dorë në grafin e përbashkët; një përpjekje refuzohet dhe regjistrohet. Tre pyetje të ruajtura përdornin fjalën "shkaktoi", dhe ndryshimi përmbante një rishkrim automatik për secilën prej tyre, të cilat faqja i renditi. Filtrat e lenteve nuk ndryshuan, sepse të dyja lentet vetëm ngushtonin ende.
Kalimi në prodhim
Çdo publikim lëviz përgjatë një rruge të vetme: hapësira e zhvillimit, staging, një njësi pilot, pastaj të gjitha njësitë. Çdo hap ka porta, dhe asgjë nuk anashkalon asnjë.
| Në | Portat e kontrollit |
|---|---|
| Staging | Të gjitha testet kalojnë; kontrollet e cilësisë; manifesti i pandryshuar ose zgjerimi i pranuar; imazh i nënshkruar |
| Pilot (Rotterdam) | Ekzekutim provë i ndryshimit të modelit në kopjen e maskuar pa gabime; kontroll politikash për rregullat e lenteve dhe të fushëveprimit; dy rishikues që nuk janë autori, njëri prej tyre pronari i të dhënave |
| Të gjitha njësitë | 14 ditë në pilot; gabime nën 1 në 1,000, të numëruara në pilot; çdo administrator njësie jep pëlqimin për njësinë e vet; dy rishikues që nuk janë autori |
E provova shkurtoren një herë, një të premte, për një rregullim njëreshtor: të promovoja 0.4.0-dev nga hapësira ime e zhvillimit te të gjitha njësitë. U refuzua me GATE_CANNOT_BE_SKIPPED, dhe asgjë nuk u promovua. Pllaka ju thotë që në vend të kësaj ta promovoni te hapi tjetër, dhe kjo është përgjigjja e vetme që ekziston.
Vetë rishikimi i publikimit, dëshmitë që lexon një rishikues i dytë dhe kanalet që zgjedhin njësitë, gjenden në kapitullin 2.28, Publikimi i zgjerimit tuaj. Dy fakte prej tij i përkasin këtu, sepse përcaktojnë si e planifikoni një vertikal. Autori nuk llogaritet kurrë si rishikues, kështu që një ekip dyshe ka nevojë për një person të tretë për çdo publikim. Dhe çdo mjedis e ruan versionin e mëparshëm për 30 ditë, kështu që kthimi mbrapa është një ndryshim i rishikuar që pipeline-i e kryen në rreth një minutë.
Zgjerimi i një pakete që ekziston tashmë
Jo çdo vertikal nis nga zero. Një paketë mund të trashëgojë nga një tjetër dhe të shtojë vetëm atë që është ndryshe. Paketa Bankat dhe pagesat, të cilën e përdor Larchmont Bank, është shembulli më i qartë në katalog. Manifesti i saj fillon kështu:
{
"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 emërton paketën mbi të cilën ndërtohet. Bankat dhe pagesat ruan formën e paketës Sigurime, grupimet e saj të përbashkëta të bisedave dhe fjalët e saj bazë, dhe shton tre lente të vetat: Vendimet për kreditë, Kontestimet e kartave dhe Llogaria ime. Elementi i tretë i çdo hyrjeje leksiku është exact për një term që duhet shfaqur siç është shkruar, si APR (normë vjetore e përqindjes), në vend që të riformulohet.
Disa gjëra nuk mund t'i bëni përmes trashëgimisë. Një paketë nuk e ndryshon kurrë guaskën, komponentët ose rregullat e shkrimit, kështu që një paketë fëmijë nuk mund ta ristilizojë konsolën. Një regjim që u nevojitet disa paketave është një lente e vetme e përbashkët dhe jo një kopje në secilën: regjistri i teknologjisë së kontraktuar jashtë u shërben si Sigurimeve ashtu edhe Bankave dhe pagesave. Nëse paketa juaj fëmijë ka nevojë për një lente që ekziston tashmë si lente e përbashkët, përdoreni atë në vend që të vizatoni tuajën.
Licencimi ndjek trashëgiminë. Një paketë licencohet mbi Enterprise dhe mund të ketë nevojë për shtesa, dhe dokumenti i licencës i mban këto varësi. Sigurimet kanë nevojë për Dhomat e vendimeve dhe regjistrimet e vulosura, kështu që një klient që licencon një paketë që e trashëgon atë ka nevojë edhe për atë shtesë, dhe konsola refuzon të lëshojë një licencë që e lë jashtë. Ekranet e telefonit të një pakete kanë nevojë gjithashtu për shtesën Aplikacionet mobile. Kontrolloni zinxhirin e kërkesave para se t'i premtoni një klienti një datë.
Shtimi i një lenteje në një paketë që është shpërndarë
Puna më e vogël vertikale është një lente e re mbi një paketë që nuk e keni shkruar ju. Gjashtë muaj pas fillimit të pilotit, ekipi i pretendimeve detare të Larkfield donte një lente të vetën brenda Cold chain: devijime dhe pretendime, pa pika energjie, pa pika të caktuara. Ne nuk e prekëm kodin e paketës. Një lente është një rresht në regjistrin e lenteve të organizatës, në pronësi të paketës, kështu që e nisëm nga rruga e artë e lenteve te Filloni diçka të re dhe i dhamë formë në Ndërtuesin e lenteve me lenten Kontrollori i Cold chain si bazë. Vlen i njëjti rregull si më parë: lentja e re mund të fshehë atë që tregon baza e saj dhe nuk mund të tregojë kurrë më shumë. Përcaktohet një herë për organizatën dhe i jepet një roli të platformës në çdo njësi. Një dhënie tërhiqet, nuk fshihet kurrë, dhe dhënia përsëri e lentes krijon një dhënie të re, kështu që kush mbante cilën lente dhe kur mbetet e lexueshme. Regjistri numëron sa njerëz mbanin një lente çdo muaj, kurrë se kush.
Faqja Lentet dhe kush i sheh tregon rezultatin si një matricë lentesh sipas njësisë dhe rolit, me Shto, Ndrysho dhe Tërhiq në çdo qelizë. Bëni paraqitjen paraprake të lentes së re si një person para se ta jepni, saktësisht si më sipër.
Sa kushtoi, sinqerisht
Një paketë prek regjistrimet e një klienti, kështu që platforma i bën qëllimisht disa gjëra të ngadalta, dhe ju duhet t'i planifikoni këto që nga dita e parë.
- Një kopje e maskuar kërkon pëlqimin e pronarit të të dhënave çdo herë. E jona mori një ditë për të mbërritur herën e parë, sepse Priya donte të lexonte fillimisht modelin e njohurive. Filloni me të dhëna sintetike dhe kërkoni herët.
- Autori nuk mund ta miratojë publikimin e vet, dhe kërkesat skadojnë pas 3 ditësh. Nëse rishikuesit tuaj janë të zënë, publikimi juaj pret.
- Një publikim që kërkon më shumë se i mëparshmi, si dërgimi i postës ose një adresë e jashtme, mbahet derisa dy rishikues të pranojnë manifestin më të gjerë. Kapitulli 2.28, Publikimi i zgjerimit tuaj, tregon faqen Manifesti dhe lejet, që jua tregon para se të kërkoni.
- Një lente nuk mund të tregojë atë që fsheh lentja e saj bazë. Nëse një roli i duhet vërtet më shumë, kjo është një bisedë me administratorin e organizatës, jo një cilësim.
Asnjë prej tyre nuk na pengoi dy herë. Publikimi i dytë i Cold chain mori një javë nga commit-i i parë deri te piloti i Rotterdam, kryesisht 66 testet që ekzekutoheshin kundrejt tre degëve dhe dy persona që lexonin dëshmitë.




