Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.24
Il-bini ta' settur vertikali apposta mill-bidu sal-aħħar
Eżempju maħdum tal-bini tal-pakkett tad-dominju tal-katina tal-kesħa (Cold chain), mill-ewwel deskrizzjoni sa verżjoni mħaddma għal kull unità, bil-mudell tal-għarfien tiegħu, il-lentijiet, ħila, plugin ta' servizz sħiħ u dejta ta' kampjun. Imbagħad kif testendi pakkett li diġà jeżisti u kif iżżid lenti ma' wieħed li diġà ġie rilaxxat.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

Jien Mateo Ruiz, żviluppatur f'Corrán Orbital. Il-biċċa l-kbira tal-ġimgħa tiegħi tmur fuq is-software tal-payload tagħna stess, iżda dan il-kapitlu huwa dwar xogħol li għamilna għal klijent. Larkfield & Vane jassiguraw il-merkanzija, u sehem dejjem akbar minnha jivvjaġġa f'kontejners refriġerati. Meta reefer jitlef l-elettriku mill-moll, it-temperatura togħla, il-merkanzija titħassar u ftit ġimgħat wara tasal talba għal kumpens. Larkfield riedu li n-nies tagħhom jaraw dik il-katina bħala ħaġa waħda f'Nexus, mill-ħsara fl-elettriku sat-talba, b'kull rwol jara biss il-parti tiegħu. Minn hemm twieled il-pakkett Cold chain.
Dak li ġej huwa l-bini fl-ordni li għamilnieh, bl-iskrins, il-fajls u l-kmandi. Ħallejt l-iżbalji ġewwa, għax tnejn mir-rifjuti li ltqajna magħhom għallmuna aktar dwar il-pjattaforma milli għallmitna t-triq bla xkiel. Il-materjal ta' referenza jinsab fil-kapitoli ta' qabel dan, u nirreferi għalihom minflok ma nirrepetihom. Dawk li l-aktar strejt fuqhom kienu il-kapitolu 2.18, Il-mudell tal-estensjonijiet, u il-kapitolu 2.23, Il-pakketti tad-dominju, b'il-kapitolu 2.21, Il-Plugin SDK, miftuħ maġenbhom għas-sett tal-għodod tal-iżvilupp tas-software innifsu.
Id-deskrizzjoni, u min jagħmel xiex
Larkfield tawni post ta' żviluppatur fl-organizzazzjoni tagħhom għat-tul tal-proġett. Dan huwa importanti, għax pakkett privat għal klijent wieħed jinbena ġewwa l-installazzjoni ta' dak il-klijent, fuq l-ispazji tal-iżvilupp u l-fergħat tad-data tiegħu, taħt l-approvazzjonijiet tan-nies tiegħu. Pakkett maħsub għal ħafna klijenti jinbena b'mod differenti, fuq cluster tal-pubblikatur b'data ta' kampjun biss, u il-kapitolu 2.25, Il-bini għal kull edizzjoni, ikopri dak il-każ.
Il-brief daħal f'paġna waħda:
- Kontejners reefer fuq il-moll u fuq il-bastimenti: l-elettriku tagħhom, id-devjazzjonijiet tat-temperatura tagħhom u t-talbiet għal kumpens li jsegwu.
- Żewġ rwoli biex nibdew: tekniku tar-reefers fuq il-moll, u kontrollur tal-katina tal-kesħa fl-uffiċċju.
- Proġett pilota li jibda fl-unità ta' Rotterdam u wara jgħaddi għal Felixstowe.
- Evidenza għal tliet settijiet ta' regoli: il-ftehim ATP għall-ikel li jitħassar, il-prattika tajba tad-distribuzzjoni tal-UE għall-mediċini, u r-rekords tas-sikurezza tal-ikel taħt l-HACCP (analiżi tal-perikli u punti kritiċi ta' kontroll). It-talbiet taħt ir-regoli Hague-Visby jużaw l-istess rekords tad-devjazzjonijiet, għalhekk innotajnihom għal wara l-pilota.
Il-pakketti tad-dominju huma kapaċità tal-Enterprise. Larkfield iħaddmu l-Enterprise, għalhekk it-triq tal-pakkett tad-dominju kienet miftuħa għalija. Fuq Community, it-triq standard għal pakkett ma tiġix offruta xejn.
Ibda mill-mogħdija ideali
Kollox jibda fuq il-paġna Ibda xi ħaġa ġdida. Hija toffri sitt toroq standard: plugin, pakkett tad-dominju, lens, pjattaforma, skill u workflow. Kull waħda toħloq repożitorju minn mudell b'verżjoni, manifest li jiddikjara x'jeħtieġ il-komponent, testijiet, spazju tal-iżvilupp u fergħat tad-data. L-istess toroq jaħdmu fil-console, fuq il-linja tal-kmand u mill-IDE tiegħek (ambjent integrat tal-iżvilupp), fejn l-għodda Workbench nexus.create tagħmel l-istess xogħol bi pjan li tikkonferma l-ewwel.
nexus create tagħha u l-mudell imwaħħal tagħha. Innota l-pjanċa f'qiegħ il-paġna: il-manifest huwa infurzat, mhux konsultattiv, u rilaxx li jitlob aktar jinżamm sakemm żewġ persuni jirrevedewh.Ħadna t-triq tal-pakkett tad-dominju minn dik il-paġna, u semmejna l-pakkett cold-chain u l-ewwel unità tiegħu Rotterdam. Ir-riżultat jsemmi l-mudell imwaħħal, domain-pack@1.6.0, u jelenka dak li ħoloq: ir-repożitorju, manifest li jiddikjara erba' ambiti, żewġ ħażniet u ebda indirizz 'il barra, 66 test mill-mudell, spazju tal-iżvilupp f'Rotterdam, tliet fergħat tad-data sintetiċi u entrata abbozz fil-katalgu ta' Larkfield stess li stajt narah jien biss. Il-verżjoni tal-mudell hija mwaħħla, u l-aġġornament tagħha aktar tard jasal bħala bidla riveduta bħal kull bidla oħra, għalhekk il-pakkett ta' ħadd ma jiċċaqlaq taħtu għax iċċaqlaq mudell. Xorta waħda użajt il-wizard tal-console għall-ewwel pakkett tagħna, għax juri l-pjan qabel ma joħloq xejn.
Pass 1: għid għalxiex inhu l-pakkett
Il-wizard Pakkett tad-dominju ġdid għandu tliet passi: dwaru, mudell tal-għarfien, u reviżjoni u ħolqien. Il-pass 1 jistaqsi l-ftit affarijiet li jsawru dak kollu li jiġi wara.
| Qasam | Dak li daħħalna | Nota |
|---|---|---|
| Isem | Cold chain | Jintuża għar-repożitorju u għall-katalgu |
| Għal xiex inhu | Kontejners reefer fuq il-moll u fuq il-bastimenti: elettriku, devjazzjonijiet tat-temperatura u t-talbiet għal kumpens li jsegwu | |
| Industrija | Loġistika u qasam marittimu | Jibni fuq il-pakkett Loġistika u marittimu |
| Sid | Il-persuna li toħolqu | Imsakkar fil-wizard |
| Unitajiet | Rotterdam (pilota) | Felixstowe wara l-pilota |
| Mudell | domain-pack@1.6.0 |
Imsakkar; l-aġġornamenti jaslu bħala bidliet riveduti |
| Regoli li jkopri | Ftehim ATP, prattika tajba tad-distribuzzjoni tal-UE, rekords tas-sikurezza tal-ikel | Kull regola ssir paġna fil-mappa tal-evidenza tal-pakkett |
L-assistent fil-pannell issuġġerixxa l-aħħar ringiela, inkluż il-punt li t-talbiet għall-merkanzija jerġgħu jużaw l-istess rekords tad-devjazzjonijiet. Pjanċa f'qiegħ il-paġna tgħid li għadu ma nħoloq xejn. Ir-repożitorju, l-ispazju tal-iżvilupp u l-fergħat tad-data jinħolqu biss meta tagħfas Oħloq fil-pass 3, wara li tkun rajt il-pjan. Tista' tissejvja abbozz u terġa' lura.
Pass 2: il-mudell tal-għarfien
Il-mudell tal-għarfien huwa s-sett ta' tipi ta' affarijiet li l-pakkett jaf bihom u kif jorbtu ma' xulxin. Cold chain beda mill-mudell bażi tal-loġistika, logistics-base 4.2, importat mill-SDK, li tana ħames tipi bażi biex nibnu fuqhom (Vessel, Port, Container, Carrier u Shipment). It-tipi bażi huma għall-qari biss fil-wizard. Jekk wieħed minnhom jeħtieġ jinbidel, jinbidel fil-pakkett li jippossjedih.
Żidna ħames tipi tagħna:
| Tip | X'inhu | Proprjetajiet |
|---|---|---|
| Unità reefer | Kontejner refriġerat | 9 |
| Żjara ta' bastiment | Bastiment wieħed f'irmiġġ wieħed | 6 |
| Devjazzjoni | Temperatura barra mil-limiti tagħha | 8 |
| Provvista tal-elettriku | Punt tal-elettriku mill-art jew mill-bastiment | 4 |
| Irreklama | Flus mitluba għal merkanzija li tħassret | 7 |
Kull proprjetà tiġi kklassifikata hekk kif toħloqha. "Irrappurtat minn" fuq Excursion hija personali. "Valur tal-merkanzija f'riskju" u l-ammont u s-saldu ta' talba huma kummerċjali. Dan deher bħala burokrazija fl-ewwel jum u salvana darbtejn aktar tard, għax il-klassijiet jiddeċiedu x'jista' juri lens, x'jissostitwixxi kopja mgħottija u x'jaħbi linja tal-log.
Tnejn mir-relazzjonijiet tagħna jilħqu l-mudell bażi: Unità reefer hija mqabbda ma' Provvista tal-elettriku, u Talba tirreferi għal Shipment. Il-mudell bażi nnifsu ma jinbidilx. Proprjetà li tirtira tibqa' fil-verżjoni 1.0 tal-mudell u titneħħa biss f'verżjoni aktar tard, għalhekk xejn minn dak li kien veru dwar rekords qodma ma jieqaf jinqara.
Pass 3: irrevedi u oħloq
Il-pass 3 huwa l-pjan. Jelenka dak li se jinħoloq, l-ambiti li se jiddikjara l-manifest, il-fergħat tad-data u l-ispazju tal-iżvilupp. Tikkonferma l-pjan bil-passkey tiegħek, u l-pjan jingħata marka distintiva. Il-ħolqien imbagħad isegwi dak il-pjan eżatt, pass pass, u tista' tieqaf fi kwalunkwe pass u żżomm dak li nħoloq.
Il-pjan għal Cold chain iddikjara erba' ambiti:
| Ambitu | Għaliex il-pakkett jeħtieġu |
|---|---|
| Aqra t-telemetrija tar-reefers | Qari tal-elettriku u tat-temperatura |
| Ikteb devjazzjonijiet | Jirreġistra devjazzjoni meta jinqabżu l-limiti |
| Aqra l-kunsinni | Jorbot talba mal-kunsinna tagħha |
| Abbozza noti tat-talbiet | Abbozzi biss; persuna tibgħat |
Il-ħażniet tiegħu kienu l-graff u r-rekords. Ma kellu ebda indirizz 'il barra u kellu l-profil Standard tas-sandbox. L-ispazju tal-iżvilupp ġie b'4 cores, 16 GiB ta' memorja u 50 GiB ta' ħażna, netwerk magħluq ħlief għal dak li jiddikjara l-manifest, immaġnijiet iffirmati biss, u tmiem wara 7 ijiem ta' inattività. Meta jintemm, id-definizzjoni tiegħu tibqa' fir-repożitorju, għalhekk terġa' toħolqu minn hemm.
It-tliet fergħat tad-data ġew mill-ġeneratur sintetiku. Ma ġiet ikkopjata ebda data tal-klijenti. Kopja mgħottija ta' Rotterdam teħtieġ il-qbil tas-sid tad-data, li f'Larkfield hija Priya Natarajan, u titolbu separatament.
Il-manifest tal-pakkett
Ir-repożitorju fih il-manifest tal-pakkett, pack.json. Isemmi l-pakkett, il-verżjoni tiegħu, il-pakkett li jiret minnu (jekk hemm), il-clusters u l-kliem tiegħu. Cluster huwa jew lens, li huwa dak li jara rwol wieħed ġewwa l-pakkett, jew kondiviż, li jaħdem fuq il-lenses kollha. Hawn il-qalba tal-manifest tagħna:
{
"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", ""]
]
}
}Il-lessiku fih il-kliem proprju tal-pakkett bi spjegazzjoni sempliċi għal kull wieħed, qasira biżżejjed biex tinqara fuq mowbajl.
Ħdejn pack.json il-manifest jiddikjara wkoll x'jista' jilħaq il-pakkett: l-ambiti, il-ħażniet, l-indirizzi 'l barra u l-profil tas-sandbox tiegħu. Nexus jagħti eżatt dak u xejn aktar. Kull sejħa ta' għodda tiġi ċċekkjata mal-ambiti ddikjarati, u indirizz estern jiġi mblukkat sakemm ma jkunx elenkat. Tista' taqra d-dikjarazzjoni, u l-bidla meta mqabbla mal-aħħar rilaxx, fil-paġna Manifest u permessi tal-pakkett.
Lentijiet: x'jara kull rwol
Lens jista' biss idejjaq dak li juri l-bażi tiegħu, u dik ir-regola waħda sawret aktar mid-disinn tagħna minn kwalunkwe regola oħra. Lens juri parti minn dak li juri l-lens bażi tiegħu, u l-permessi xorta jiġu mir-rwoli: lens jiddeċiedi x'jara rwol fil-pakkett, mhux x'inhu permess jagħmel.
Il-lens Reefer technician idejjaq lil Operations controller, il-lens bażi li Larkfield diġà jħaddmu għax-xogħol tal-loġistika. Fil-Lens builder timmarka l-kards, il-oqsma u l-azzjonijiet li juri l-lens. L-elementi li l-bażi ma jurix huma msakkra.
| Parti | Reefer technician juri | Imħolli barra |
|---|---|---|
| Kards | Unitajiet reefer fuq il-moll, devjazzjonijiet miftuħa, punti tal-elettriku, żjarat ta' bastimenti llum | Kull ħaġa dwar it-talbiet |
| Oqsma | Stat tal-elettriku, set point, l-aħħar qari, l-ogħla temperatura | Ammont tat-talba (mhux fil-lens bażi), oqsma personali (mitfija b'mod predefinit) |
| Azzjonijiet | Irreġistra l-kawża ta' devjazzjoni, itlob verifika tal-elettriku | Ibdel set point u agħlaq devjazzjoni (kontrolluri biss), abbozza nota ta' talba |
Xorta waħda ppruvajt inżid l-ammont tat-talba mal-lens tat-tekniku, għax tekniku kien talbu. Il-builder irrifjuta b'LENS_CANNOT_WIDEN u ma ssejvja xejn. M'hemm ebda soluzzjoni alternattiva ġewwa l-lens: it-triq 'il quddiem hija lens fuq bażi usa', talba differenti li jiddeċiediha l-amministratur tal-organizzazzjoni. Ħallejnieh barra.
Li taħbi xi ħaġa f'lens ma jneħħihiex minn Nexus. Ifisser li dan ir-rwol ma jarahiex. Il-builder juri lil kemm-il persuna se jilħaq lens fil-pilota (29, fil-każ tagħna) u jżomm log ta' kull Żieda, Bidla u Rtirar. Lens jiġi definit darba għall-organizzazzjoni u jingħata għal kull unità lil rwol tal-pjattaforma, għalhekk l-istess lens Reefer technician jista' jingħata lit-tekniċi ta' Rotterdam dan ix-xahar u lil dawk ta' Felixstowe x-xahar id-dieħel.
Ħila għall-abbozzar ta' noti ta' talba
Il-kontrolluri riedu l-ewwel abbozz tan-nota li tintbagħat lil sid il-merkanzija wara devjazzjoni. Dak huwa xogħol tal-lingwa, għalhekk jaħdem fuq mudell, u l-mistoqsija kienet fejn għandu jitqiegħed.
Hemm żewġ tipi ta' skill f'Nexus, u d-differenza hawn hija importanti. Manifest skill hija ringiela tipizzata fil-skills[] ta' plugin, mibgħuta mill-pjattaforma. Skill tal-Skills Engine hija pakkett SKILL.md fil-librerija tal-iskills tal-organizzazzjoni, li l-aġenti, il-buttuni tal-IA (intelliġenza artifiċjali), il-workflows u l-għodod tal-iżviluppaturi kollha jħaddmu bl-istess mod. Il-kapitolu 2.20, Skills, ikopri t-tnejn.
Il-livell ta' fiduċja tal-plugin tagħna huwa community, u plugin tal-komunità jista' jiddikjara biss manifest skills li ma jilħqux mudell (host_callback u plugin_queue). Iż-żewġ livelli li jilħqu l-AI Provider Router, tool_using u llm_only, jeħtieġu fiduċja core jew verified. Għalhekk l-abbozzar tan-noti tat-talbiet sar skill tal-Skills Engine, u r-router jagħżel il-mudell mill-ġabra proprja ta' 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.Il-pakkett jinsab f'skills/draft-claim-note/ fir-repożitorju, b'isem il-folder ugwali għall-isem tal-iskill. Ivvalidajnieh u tellajnieh mit-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-noteJekk ittella' l-istess kontenut darbtejn, tirċievi l-verżjoni eżistenti minflok waħda ġdida (CONTENT_HASH_ALREADY_PUBLISHED), għalhekk huwa sikur li terġa' tħaddem it-tlugħ. Qabel ma verżjoni toħroġ, l-Skills Engine iħaddem il-każijiet tat-test tagħha, prova fid-dell fuq xogħol li sar qabel, u reviżjoni għamja minn mudell ta' kumpanija oħra, bil-ħin u l-ispiża ta' kull tħaddim.
Il-plugin ta' servizz sħiħ
Il-pakkett kellu bżonn ukoll kodiċi li jaħdem il-ħin kollu: qarrej għall-fluss tat-telemetrija tar-reefers, u kittieb li jiftaħ rekord ta' devjazzjoni meta qari jaqbeż il-limiti tiegħu. Kodiċi bħal dan jagħmel parti minn plugin b'servizz sħiħ, u ħloqnielu l-iskeletru bil-kmand proprju tal-SDK, li jikteb is-siġra ta' referenza kollha bl-isem sostitwit:
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-testL-SDK jiġi installat minn https://registry.adverant.ai/npm/ bit-token tal-pull mill-paġna Pull tokens u kmandi tal-installazzjoni tal-kont Adverant tiegħek. Agħmel commit tal-package-lock.json li tikteb l-ewwel installazzjoni; il-bini tal-immaġni jħaddem npm ci u jirrifjuta mingħajru.
Hawn hija l-parti tal-nexus.manifest.json tagħna li tvarja mill-mudell. Mhijiex il-fajl kollu: il-blokki description, author, license, runtime, backend u frontend tal-iskeletru jibqgħu kif inhuma, u l-validatur jirrifjuta manifest ta' servizz sħiħ mingħajrhom. It-tliet sentenzi architecture huma l-liġi li kull plugin jerġa' jiddikjara, u l-validatur jiċċekkja l-kliem. UNO fl-ewwel waħda hija l-magna tal-flussi tax-xogħol:
{
"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 hija ħila tal-manifest bil-livell host_callback: il-pjattaforma tibgħat l-input lis-Service tagħna stess, ġewwa n-namespace tagħna, u qatt lil host li nsemmu aħna. Ir-rotta tar-riċevitur hija ddikjarata auth: internal u mħarsa bil-serviceMiddleware tal-SDK, il-forma Express tal-gwardja, li tirrifjuta token ta' sejħa maħruġ għal kwalunkwe plugin, organizzazzjoni, ħila jew rotta oħra. Il-classification tagħha hija tenant, li hija l-limitu massimu għal plugin tal-komunità. Il-Kapitolu 2.27, Xenarji tal-bini, jgħaddi minn ħila host_callback waħedha.
Żewġ drawwiet minn dan l-istadju jistħoqqilhom jiġu kkupjati. Kull tabella ġġorr organization_id, owner_user_id u business_unit_id mill-ewwel migrazzjoni, għax iż-żieda ta' assi aktar tard hija migrazzjoni fuq ringieli ħajjin. U ħaddimna nexus-gates lokalment qabel kull push, peress li huwa l-istess kmand li jħaddem il-pipeline; tħaddim li ma eżamina xejn joħroġ b'2 u jgħid hekk. Il-Kapitolu 2.19, Ir-regoli li kull estensjoni tirret, jelenka l-kontrolli.
Dejta ta' kampjun għall-ittestjar
Il-paġna Data kampjun għall-ittestjar toffri tliet tipi ta' fergħa:
| Tip | X'fih | Min jaqbel |
|---|---|---|
| Sintetika | Data ġġenerata minn għadd u forom li tistabbilixxu intom; xejn ma jiġi minn unità reali | Ħadd; hija tagħkom |
| Kopja mgħottija | Kopja ta' unità bl-oqsma personali, sensittivi u kummerċjali sostitwiti | Is-sid tad-data (Priya Natarajan għal Rotterdam) |
| Skema biss | Il-forma tal-imħażen, mingħajr ringieli | Ħadd; għall-migrazzjonijiet |
Iġġenerajna ġimgħa intensa: madwar 7 devjazzjonijiet f'kull 100 reefer, li hekk tidher Awwissu intensa f'Rotterdam. Il-każijiet strambi kienu aktar importanti mill-volum. Tlabna telf ta' enerġija waqt il-ħatt, bieba mħollija miftuħa, vojt fis-sensur, u żewġ talbiet għal devjazzjoni waħda. Il-paġna tista' tissuġġerixxi każijiet strambi mill-kawżi tad-devjazzjonijiet fil-mudell tal-għarfien, qatt minn rekords reali.
Kull sett ta' għadd u forom jiġi ssejvjat bħala seed, bħal cold-chain-busy-01, flimkien mal-marka tiegħu. L-istess seed jagħti l-istess data, għalhekk kull tħaddim ta' test fuq kull fergħa jara l-istess ġimgħa. Hekk saru ripetibbli s-66 test tagħna.
Fergħa tgħix 72 siegħa b'mod awtomatiku u 14-il jum l-aktar. Tlabt li nżommu l-fergħa intensa tagħna għal 30 jum waqt reviżjoni twila, u l-paġna rrifjutat b'BRANCH_LIFE_EXCEEDED. Is-soluzzjoni hija dik li tissuġġerixxi l-pjanċa: żommu s-seed, u agħmlu fergħa ġdida minnu meta jkollkom bżonnha. Kopja mgħottija ssegwi l-istess limiti, u t-talba tagħha ġġorr raġuni u tul sa 14-il jum.
Ara dehra minn qabel ta' lenti bħala persuna
Qabel ma ħadd f'Rotterdam ra Cold chain, ħarisna lejha kif kienu se jħarsu huma. Preview ta' lenti bħala persuna turi l-pakkett eżatt kif jarah rwol magħżul, fuq fergħa tad-data, ġewwa qafas ta' preview bil-linja mqattgħa.
Tliet regoli jagħmlu l-previews sikuri biex jintużaw liberament. Preview juża fergħa tad-data, qatt l-unità ħajja. Il-permessi tagħkom stess ma jinfiltrawx fih, għalhekk taraw dak li jara r-rwol u mhux dak li tistgħu taraw intom. U jintemm wara 30 minuta. Li tippuntaw preview lejn unità ħajja jiġi rrifjutat b'CONNECTION_SCOPE_EXCEEDED; jekk għandkom bżonn forom reali, itolbu lis-sid tad-data kopja mgħottija u agħmlu l-preview fuqha.
Il-preview huwa fejn qbadna żball reali. Il-grafika tat-temperatura fil-veduta tat-teknikus kienet turi s-set point, u l-bidliet fis-set point kienu maħsuba għall-kontrolluri biss. Il-grafika kienet tajba; il-buttuna tal-editjar taħtha ma kinitx. Il-verżjoni 0.3.2 ħbiet il-bidliet fis-set point mit-tekniċi, u l-preview huwa fejn sibnieha.
Il-bidla fil-mudell tal-għarfien wara li jiġi rilaxxat
Sal-verżjoni 0.4.0 kellna bżonn tip Inspection għall-ispezzjonijiet ta' qabel il-vjaġġ, u r-relazzjoni "Excursion caused Claim" kienet tinqara aħjar bħala "Excursion led to Claim". Iċ-ċaqliq tal-mudell minn 1.3 għal 1.4 huwa bidla fil-mudell tal-għarfien, u l-paġna Bidliet fil-mudell tal-għarfien turi d-differenzi tagħha, x'kienet se tolqot u fejn tinsab fit-triq tagħha.
Il-bidla tivvjaġġa bħala talba għal bidla fil-graff. Il-prova bla effett tagħha tgħodd x'kienet se tolqot fuq il-kopja mgħottija ta' Rotterdam, bħala għadd: għalina, 1,284 rabta msemmija mill-ġdid u xejn imneħħi. Żewġ reviżuri japprovawha, u l-pipeline tapplikaha għal staging, imbagħad għall-pilota. Ħadd ma jikteb fil-graff kondiviż bl-idejn; tentattiv jiġi rrifjutat u rreġistrat. Tliet mistoqsijiet issejvjati kienu jużaw il-kelma "caused", u l-bidla ġarret kitba mill-ġdid awtomatika għal kull waħda minnhom, li l-paġna elenkat. Il-filtri tal-lentijiet ma nbidlux, għax iż-żewġ lentijiet xorta kienu biss jiddejqu.
Ippromwovi għall-produzzjoni
Kull rilaxx jimxi fuq triq waħda: dev space, staging, unità pilota, imbagħad l-unitajiet kollha. Kull pass għandu kontrolli, u xejn ma jaqbeż wieħed.
| Lejn | Kontrolli |
|---|---|
| Staging | It-testijiet kollha jgħaddu; kontrolli tal-kwalità; manifest mhux mibdul jew it-twessigħ aċċettat; immaġni ffirmata |
| Pilota (Rotterdam) | Prova bla effett tal-bidla fil-mudell fuq il-kopja mgħottija mingħajr żbalji; kontroll tal-politika fuq ir-regoli tal-lentijiet u tal-ambitu; żewġ reviżuri li mhumiex l-awtur, wieħed minnhom is-sid tad-data |
| L-unitajiet kollha | 14-il jum fil-pilota; żbalji taħt 1 f'1,000, magħduda fil-pilota; kull amministratur ta' unità jaqbel għall-unità tiegħu; żewġ reviżuri li mhumiex l-awtur |
Ippruvajt ix-xorta qasira darba, nhar ta' Ġimgħa, għal soluzzjoni ta' linja waħda: nippromwovi 0.4.0-dev mid-dev space tiegħi għall-unitajiet kollha. Ġiet irrifjutata b'GATE_CANNOT_BE_SKIPPED, u xejn ma ġie promoss. Il-pjanċa tgħidilkom tippromwovu għall-pass li jmiss minflok, u dik hija l-unika tweġiba li hemm.
Ir-reviżjoni tar-rilaxx innifisha, l-evidenza li jaqra t-tieni reviżur u l-kanali li jagħżlu l-unitajiet, jinsabu fil-kapitolu 2.28, Ir-rilaxx tal-estensjoni tagħkom. Żewġ fatti minnu jagħmlu sens hawn, għax jiffurmaw kif tippjanaw vertikali. L-awtur qatt ma jgħodd bħala reviżur, għalhekk tim ta' żewġ persuni jeħtieġ tielet persuna għal kull rilaxx. U kull ambjent iżomm il-verżjoni ta' qabel għal 30 jum, għalhekk ir-rollback huwa bidla riveduta li l-pipeline tagħmel f'madwar minuta.
L-estensjoni ta' pakkett li diġà jeżisti
Mhux kull vertikali jibda minn xejn. Pakkett jista' jiret minn ieħor u jżid biss dak li hu differenti. Il-pakkett Banking and payments, li jħaddem Larchmont Bank, huwa l-eżempju l-aktar ċar fil-katalgu. Il-manifest tiegħu jibda hekk:
{
"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 isemmi l-pakkett li jibni fuqu. Banking and payments iżomm il-forma tal-pakkett Insurance, ir-raggruppamenti tal-konversazzjonijiet kondiviżi u l-kliem ewlieni tiegħu, u jżid tliet lentijiet tiegħu: Lending decisions, Card disputes u My account. It-tielet element ta' kull daħla tal-lessiku huwa exact għal terminu li għandu jintwera kif miktub, bħal APR (annual percentage rate), minflok ma jiġi rifformulat.
Xi affarijiet ma tistgħux tagħmluhom bil-wirt. Pakkett qatt ma jibdel il-qoxra, il-komponenti jew ir-regoli tal-kitba, għalhekk pakkett tifel ma jistax ibiddel l-istil tal-console. Reġim li għandhom bżonnu diversi pakketti huwa lenti kondiviża waħda minflok kopja f'kull wieħed: ir-reġistru tat-teknoloġija esternalizzata jservi kemm Insurance kif ukoll Banking and payments. Jekk il-pakkett tifel tagħkom għandu bżonn lenti li diġà teżisti bħala lenti kondiviża, użawha minflok ma tfasslu tagħkom.
Il-liċenzjar isegwi l-wirt. Pakkett jiġi liċenzjat fuq Enterprise u jista' jkollu bżonn add-ons, u d-dokument tal-liċenza jġorr dawk id-dipendenzi. Insurance teħtieġ Decision rooms u rekords issiġillati, għalhekk klijent li jilliċenzja pakkett li jirtha jeħtieġ ukoll dak l-add-on, u l-console tirrifjuta toħroġ liċenza li tħallih barra. L-iskrins tat-telefon ta' pakkett jeħtieġu wkoll l-add-on Mobile apps. Iċċekkjaw il-katina ta' rekwiżiti qabel ma twegħdu data lil klijent.
Iż-żieda ta' lenti ma' pakkett li diġà ġie rilaxxat
L-iżgħar xogħol vertikali huwa lenti ġdida fuq pakkett li ma ktibtuhx intom. Sitt xhur wara l-bidu tal-pilota, it-tim tat-talbiet marittimi ta' Larkfield ried lenti tiegħu ġewwa Cold chain: devjazzjonijiet u talbiet, l-ebda punt tal-enerġija, l-ebda set point. Ma messejniex il-kodiċi tal-pakkett. Lenti hija ringiela fir-reġistru tal-lentijiet tal-organizzazzjoni, proprjetà tal-pakkett, għalhekk bdejnieha mill-golden path tal-lentijiet f'Ibdew xi ħaġa ġdida u sawwarnieha fil-Lens builder bil-lenti Cold-chain controller bħala l-bażi tagħha. Tapplika l-istess regola bħal qabel: il-lenti l-ġdida tista' taħbi dak li turi l-bażi tagħha u qatt ma tista' turi aktar. Hija definita darba għall-organizzazzjoni u tingħata lil rwol tal-pjattaforma f'kull unità. Għotja tiġi rtirata, qatt imħassra, u l-għoti mill-ġdid tal-lenti joħloq għotja ġdida, għalhekk min kellu liema lenti u meta jibqa' jinqara. Ir-reġistru jgħodd kemm persuni kellhom lenti kull xahar, qatt min.
Il-paġna Lentijiet u min jarahom turi r-riżultat bħala matriċi ta' lenti skont l-unità u r-rwol, b'Add, Change u Withdraw fuq kull ċellula. Agħmlu preview tal-lenti l-ġdida bħala persuna qabel ma tagħtuha, eżatt kif deskritt hawn fuq.
Kemm swiet, onestament
Pakkett jolqot ir-rekords ta' klijent, għalhekk il-pjattaforma tagħmel xi affarijiet bil-mod apposta, u għandkom tippjanaw għalihom mill-ewwel jum.
- Kopja mgħottija teħtieġ il-qbil tas-sid tad-data kull darba. Tagħna damet jum biex waslet l-ewwel darba, għax Priya riedet taqra l-mudell tal-għarfien l-ewwel. Ibdew b'data sintetika u itolbu kmieni.
- L-awtur ma jistax japprova r-rilaxx tiegħu stess, u t-talbiet jiskadu wara 3 ijiem. Jekk ir-reviżuri tagħkom huma okkupati, ir-rilaxx tagħkom jistenna.
- Rilaxx li jitlob aktar mill-aħħar wieħed, bħal li jibgħat posta jew indirizz estern wieħed, jinżamm sakemm żewġ reviżuri jaċċettaw il-manifest imwessa'. Il-Kapitolu 2.28, Ir-rilaxx tal-estensjoni tagħkom, juri l-paġna Manifest u permessi li tgħidilkom qabel ma titolbu.
- Lenti ma tistax turi dak li taħbi l-lenti bażi tagħha. Jekk rwol verament jeħtieġ aktar, dik hija konversazzjoni mal-amministratur tal-organizzazzjoni, mhux issettjar.
L-ebda waħda minn dawn ma xekklitna darbtejn. It-tieni rilaxx ta' Cold chain ħa ġimgħa mill-ewwel commit sal-pilota ta' Rotterdam, il-biċċa l-kbira minnha s-66 test jaħdmu kontra tliet friegħi u żewġ persuni jaqraw l-evidenza.




