IdħolIbbukkja laqgħa informattiva

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ż

19 minuti qari

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.

Triq mix-xellug għal-lemin ta' tmien kaxxi: "Brief", "Golden path", "Mudell tal-għarfien", "Lentijiet", "Ħila u plugin", "Data kampjun u preview", "Reviżjoni tar-rilaxx", "Promozzjoni". Taħt l-aħħar kaxxa, it-tieni ringiela ta' erba' kaxxi iżgħar magħquda bi vleġeġ turi l-passi tal-promozzjoni: "Dev space", "Staging", "Unità pilota (Rotterdam)", "L-unitajiet kollha", b'ikona ta' katnazz fuq kull vleġġa mmarkata "kontroll". Vleġġa bil-linja mqattgħa minn "Dev space" dritt għal "L-unitajiet kollha" hija maqtugħa b'salib u mmarkata GATE_CANNOT_BE_SKIPPED.
Il-bini ta' Cold chain, mill-brief sa kull unità.

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.

Ibda xi ħaġa ġdida
Ibda xi ħaġa ġdida
Is-sitt toroq standard, kull waħda b'dak li toħloq, il-kmand 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
Pakkett tad-dominju ġdid: mudell tal-għarfien
Pakkett ġdid ta' dominju: mudell tal-għarfien
Il-graff tal-għarfien b'ħames tipi bażi u ħamsa ġodda. Ħares lejn il-proprjetajiet ta' Excursion fuq il-lemin: kull proprjetà ġġorr il-klassi tagħha hekk kif tinħoloq, u l-pjanċa tgħid li l-ammonti tat-talbiet huma kummerċjali, għalhekk il-lenses tat-tekniċi ma jistgħux juruhom.

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
Benniena tal-lentijiet
Benniena tal-lentijiet
Il-Lens builder għal Reefer technician, immarkat mal-lens bażi tiegħu. Il-pjanċa fin-naħa t'isfel tax-xellug hija r-rifjut li tikseb jekk timmarka l-ammont tat-talba: il-lens bażi ma jurihx, għalhekk dan il-lens ma jistax.

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-note

Jekk 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-test

L-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.

Preview ta' lenti bħala persuna
 Ara dehra minn qabel ta' lenti bħala persuna
Cold chain kif jaraha tekniku tar-reefers f'Rotterdam, fuq fergħa sintetika. Innotaw il-kolonna tat-talba mmarkata "moħbija mil-lenti" fuq kull devjazzjoni miftuħa, u l-pannell tal-ġenb li jgħid x'taħbi din il-lenti u għaliex.

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
Ambjenti u promozzjoni
Ambjenti u promozzjoni
Cold chain 0.3.2 tistenna fil-kontroll tal-pilota għat-tieni reviżur tagħha. Il-pjanċa fuq il-lemin hija r-rifjut għat-tentattiv ta' promozzjoni dritt minn dev space għall-unitajiet kollha.

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.