InnskráningBóka kynningu

Kafli 2.24

Að smíða sérsniðna faglausn frá upphafi til enda

Fullunnin smíði á Cold chain fagpakkanum, frá fyrstu forskrift til útgáfu sem keyrir fyrir hverja einingu, með þekkingarlíkani hans, sjónarhornum, færni, heildarþjónustuviðbót og sýnigögnum. Síðan hvernig á að útvíkka pakka sem þegar er til og hvernig á að bæta sjónarhorni við pakka sem hefur verið gefinn út.

Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

19 mínútna lestur

Ég heiti Mateo Ruiz og er forritari hjá Corrán Orbital. Mestur hluti vikunnar fer í okkar eigin hugbúnað fyrir farmhleðslur, en þessi kafli fjallar um verkefni sem við unnum fyrir viðskiptavin. Larkfield & Vane vátryggir farm og sífellt stærri hluti hans fer í kæligámum. Þegar kæligámur missir landrafmagn á hafnarbakkanum hækkar hitinn, farmurinn skemmist og krafa fylgir nokkrum vikum síðar. Larkfield vildi að starfsfólk sitt sæi þessa keðju sem eina heild í Nexus, frá rafmagnsbilun til kröfu, og að hvert hlutverk sæi aðeins sinn hluta. Úr því varð Cold chain-pakkinn.

Hér á eftir fer smíðin í þeirri röð sem við unnum hana, með skjámyndum, skrám og skipunum. Ég hef haldið mistökunum inni, því að tvær af þeim höfnunum sem við fengum kenndu okkur meira um kerfið en það sem gekk snurðulaust. Tilvísunarefnið er í köflunum á undan þessum og ég vísa í þá frekar en að endurtaka þá. Þeir sem ég studdist mest við voru kafli 2.18, Viðbótalíkanið, og kafli 2.23, Sviðspakkar, með kafla 2.21, Plugin SDK, opinn við hliðina fyrir hugbúnaðarþróunarsettið sjálft.

Leið frá vinstri til hægri með átta reitum: „Lýsing“, „Gullna leiðin“, „Þekkingarlíkan“, „Sýnir“, „Færni og viðbót“, „Sýnigögn og forskoðun“, „Útgáfuyfirferð“, „Færsla“. Undir síðasta reitnum sýnir önnur röð fjögurra minni reita, tengdra með örvum, skref færslunnar: „Þróunarrými“, „Prófunarumhverfi“, „Tilraunaeining (Rotterdam)“, „Allar einingar“, með hengilástákni á hverri ör merktri „hlið“. Strikuð ör frá „Þróunarrými“ beint til „Allar einingar“ er yfirstrikuð og merkt GATE_CANNOT_BE_SKIPPED.
Smíði Cold chain, frá verklýsingu til hverrar einingar.

Forskriftin og hver gerir hvað

Larkfield veitti mér forritarasæti í fyrirtæki sínu meðan verkefnið stóð yfir. Það skiptir máli, því að einkapakki fyrir einn viðskiptavin er smíðaður innan uppsetningar þess viðskiptavinar, í þróunarrýmum hans og gagnagreinum, með samþykki starfsfólks hans. Pakki sem ætlaður er mörgum viðskiptavinum er smíðaður á annan hátt, á útgefandaklasa með sýnigögnum eingöngu, og kafli 2.25, Smíðað fyrir hverja útgáfu, fjallar um það tilvik.

Verklýsingin rúmaðist á einni síðu:

  • Kæligámar á hafnarbakkanum og um borð í skipum: rafmagn þeirra, hitafrávik og þær kröfur sem fylgja.
  • Tvö hlutverk til að byrja með: kæligámatæknimaður á hafnarbakkanum og kælikeðjustjóri á skrifstofunni.
  • Tilraunaverkefni sem keyrir fyrst í Rotterdam-einingunni og færist síðan til Felixstowe.
  • Sönnunargögn fyrir þrenns konar reglur: ATP-samninginn um viðkvæm matvæli, góða dreifingarhætti ESB fyrir lyf og matvælaöryggisskrár samkvæmt HACCP (hættugreining og mikilvægir stýristaðir). Kröfur samkvæmt Hague-Visby-reglunum nota sömu frávikaskrár, svo við skráðum þær hjá okkur til síðari tíma, eftir tilraunaverkefnið.

Sviðspakkar eru Enterprise-eiginleiki. Larkfield keyrir Enterprise, svo leiðin fyrir sviðspakka stóð mér opin. Í Community er gullna leiðin fyrir pakka alls ekki í boði.

Byrjaðu á gullnu leiðinni

Allt hefst á síðunni Byrja á einhverju nýju. Hún býður sex gullnar leiðir: viðbót, sviðspakka, linsu, kerfi, færni og verkflæði. Hver þeirra býr til gagnageymslu út frá sniðmáti með útgáfunúmeri, skilgreiningarskrá sem tilgreinir hvað hluturinn þarf, prófanir, þróunarrými og gagnagreinar. Sömu leiðir virka í stjórnborðinu, á skipanalínunni og úr IDE-umhverfinu þínu (samþættu þróunarumhverfi), þar sem Workbench-tólið nexus.create vinnur sama verk með áætlun sem þú staðfestir fyrst.

Hefja eitthvað nýtt
Hefja eitthvað nýtt
Gullnu leiðirnar sex, hver með því sem hún býr til, nexus create-skipun sinni og festu sniðmáti sínu. Takið eftir skiltinu neðst: skilgreiningarskránni er framfylgt, hún er ekki ráðgefandi, og útgáfa sem biður um meira er stöðvuð þar til tveir aðilar hafa yfirfarið hana.

Við fórum leiðina fyrir sviðspakka á þeirri síðu, nefndum pakkann cold-chain og fyrstu eininguna Rotterdam. Niðurstaðan tilgreinir festa sniðmátið, domain-pack@1.6.0, og telur upp það sem var búið til: gagnageymsluna, skilgreiningarskrá sem tilgreinir fjögur heimildasvið, tvær geymslur og engin ytri vistföng, 66 prófanir úr sniðmátinu, þróunarrými í Rotterdam, þrjár tilbúnar gagnagreinar og drög að færslu í eigin vörulista Larkfield sem aðeins ég gat séð. Útgáfa sniðmátsins er fest og uppfærsla á því síðar berst sem yfirfarin breyting eins og hver önnur, svo enginn pakki breytist undir neinum vegna þess að sniðmát breyttist. Ég notaði samt leiðsagnarforrit stjórnborðsins fyrir fyrsta pakkann okkar, því að það sýnir áætlunina áður en það býr nokkuð til.

Skref 1: segðu til hvers pakkinn er

Leiðsagnarforritið Nýr sviðspakki hefur þrjú skref: um pakkann, þekkingarlíkan, og yfirferð og stofnun. Skref 1 spyr um þau fáu atriði sem móta allt sem á eftir kemur.

Reitur Það sem við slógum inn Athugið
Heiti Cold chain Notað fyrir gagnageymsluna og vörulistann
Til hvers hann er Kæligámar á hafnarbakkanum og um borð í skipum: rafmagn, hitafrávik og þær kröfur sem fylgja
Atvinnugrein Flutningar og siglingar Byggir á pakkanum Flutningar og siglingar
Eigandi (Owner) Sá sem stofnar hann Læst í leiðsagnarforritinu
Einingar Rotterdam (tilraunaverkefni) Felixstowe eftir tilraunaverkefnið
Sniðmát domain-pack@1.6.0 Læst; uppfærslur berast sem yfirfarnar breytingar
Reglur sem hann kortleggur ATP-samningurinn, góðir dreifingarhættir ESB, matvælaöryggisskrár Hver regla verður að síðu í sönnunargagnakorti pakkans

Aðstoðarmaðurinn í hliðarstikunni stakk upp á síðustu línunni, þar á meðal því að farmkröfur endurnýta sömu frávikaskrár. Skilti neðst á síðunni segir að ekkert hafi enn verið búið til. Gagnageymslan, þróunarrýmið og gagnagreinarnar eru aðeins búnar til þegar þú ýtir á Stofna í skrefi 3, eftir að þú hefur séð áætlunina. Þú getur vistað drög og komið aftur síðar.

Skref 2: þekkingarlíkanið

Þekkingarlíkanið er safn þeirra tegunda hluta sem pakkinn þekkir og hvernig þær tengjast. Cold chain byrjaði á grunnlíkani flutninga, logistics-base 4.2, sem flutt var inn úr SDK-settinu og gaf okkur fimm grunntegundir til að byggja á (Skip, Höfn, Gámur, Flytjandi og Sending). Grunntegundir eru skrifvarðar í leiðsagnarforritinu. Ef breyta þarf einhverri þeirra er henni breytt í pakkanum sem á hana.

Við bættum við fimm eigin tegundum:

Tegund Hvað það er Eiginleikar
Kælieining Kældur gámur 9
Skipskoma Eitt skip við eina legu 6
Frávik Hitastig utan marka sinna 8
Aflgjafi Rafmagnstengill í landi eða um borð 4
Tilkalla (Claim) Fé sem krafist er vegna skemmds farms 7
Nýr sviðspakki: þekkingarlíkan
Nýr sviðspakki: þekkingarlíkan
Þekkingargrafið með fimm grunntegundum og fimm nýjum. Lítið á eiginleika Fráviks til hægri: hver eiginleiki fær flokk sinn um leið og hann er búinn til, og skiltið segir að kröfufjárhæðir séu viðskiptalegar, svo linsur tæknimanna geta ekki sýnt þær.

Hver eiginleiki er flokkaður um leið og þú býrð hann til. „Tilkynnt af“ á Fráviki er persónuupplýsing. „Verðmæti farms í hættu“ og fjárhæð og uppgjör kröfu eru viðskiptaleg. Þetta virtist vera skriffinnska á fyrsta degi en bjargaði okkur tvisvar síðar, því að flokkarnir ráða því hvað linsa má sýna, hverju dulin afrit skipta út og hvað færsla í annál felur.

Tvö af venslum okkar ná inn í grunnlíkanið: Kælieining er tengd við Aflgjafa og Krafa vísar til Sendingar. Grunnlíkaninu sjálfu er ekki breytt. Eiginleiki sem þú dregur til baka helst í útgáfu 1.0 af líkaninu og hverfur aðeins í síðari útgáfu, svo ekkert sem átti við eldri færslur hættir að vera læsilegt.

Skref 3: yfirfara og búa til

Skref 3 er áætlunin. Hún telur upp það sem verður búið til, heimildasviðin sem skilgreiningarskráin mun tilgreina, gagnagreinarnar og þróunarrýmið. Þú staðfestir áætlunina með aðgangslyklinum þínum og áætlunin fær fingrafar. Stofnunin fylgir síðan þeirri áætlun nákvæmlega, einu skrefi í einu, og þú getur stöðvað við hvaða skref sem er og haldið því sem búið var til.

Áætlunin fyrir Cold chain tilgreindi fjögur heimildasvið:

Heimildasvið Hvers vegna pakkinn þarf það
Lesa fjarmælingar kæligáma Rafmagns- og hitamælingar
Skrifa frávik Skráir frávik þegar farið er út fyrir mörk
Lesa sendingar Tengir kröfu við sendingu hennar
Semja drög að kröfubréfum Aðeins drög; manneskja sendir

Geymslur hans voru grafið og færslur. Hann hafði engin ytri vistföng og Standard-sandkassasniðið. Þróunarrýminu fylgdu 4 kjarnar, 16 GiB af minni og 50 GiB af geymslurými, net sem er lokað nema fyrir það sem skilgreiningarskráin tilgreinir, eingöngu undirritaðar myndir og lokun eftir 7 óvirka daga. Þegar því lýkur helst skilgreining þess í gagnageymslunni, svo þú býrð það til aftur þaðan.

Gagnagreinarnar þrjár komu úr gervigagnaframleiðandanum. Engin gögn viðskiptavina voru afrituð. Dulið afrit af Rotterdam krefst samþykkis gagnaeiganda, sem hjá Larkfield er Priya Natarajan, og um það er beðið sérstaklega.

Pakkaskráin (manifest)

Gagnageymslan geymir skilgreiningarskrá pakkans, pack.json. Hún tilgreinir heiti pakkans, útgáfu hans, pakkann sem hann erfir frá (ef einhver er), klasa hans og orð hans. Klasi er annaðhvort linsa, sem er það sem eitt hlutverk sér innan pakkans, eða sameiginlegur, sem nær yfir allar linsur. Hér er kjarninn í okkar:

{
  "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", ""]
    ]
  }
}

Orðasafnið geymir eigin orð pakkans með einfaldri skýringu við hvert, nógu stuttri til að lesa í síma.

Auk pack.json tilgreinir skilgreiningarskráin einnig hvað pakkinn má ná til: heimildasvið hans, geymslur, ytri vistföng og sandkassasnið. Nexus veitir nákvæmlega það og ekkert umfram það. Hvert tólakall er borið saman við tilgreind heimildasvið og ytra vistfang er lokað nema það sé skráð. Þú getur lesið skilgreininguna, og breytinguna frá síðustu útgáfu, á síðu pakkans Skilgreiningarskrá og heimildir.

Sjónarhorn: hvað hvert hlutverk sér

Linsa getur aðeins þrengt það sem grunnur hennar sýnir, og sú eina regla mótaði hönnun okkar meira en nokkur önnur. Linsa sýnir hluta af því sem grunnlinsa hennar sýnir og heimildir koma áfram frá hlutverkum: linsa ræður því hvað hlutverk sér í pakkanum, ekki hvað það má gera.

Linsan Reefer technician þrengir Operations controller, grunnlinsuna sem Larkfield notar þegar fyrir flutningastarfsemi. Í linsusmiðnum hakar þú við þau spjöld, svið og aðgerðir sem linsan sýnir. Atriði sem grunnurinn sýnir ekki eru læst.

Hluti Reefer technician sýnir Sleppt
Spjöld Kæligámar á hafnarbakkanum, opin frávik, rafmagnstenglar, skipskomur dagsins Allt sem varðar kröfur
Svið Rafmagnsstaða, stillt gildi, síðasta mæling, hæsta hitastig Kröfufjárhæð (ekki í grunnlinsunni), persónusvið (sjálfgefið óvirk)
Aðgerðir Skrá orsök fráviks, biðja um rafmagnsathugun Breyta stilltu gildi og loka fráviki (aðeins stjórnendur), semja drög að kröfubréfi
Linsusmiður
Linsusmiður
Linsusmiðurinn fyrir Reefer technician, hakaður á móti grunnlinsu sinni. Skiltið neðst til vinstri er höfnunin sem þú færð fyrir að haka við kröfufjárhæð: grunnlinsan sýnir hana ekki, svo þessi linsa getur það ekki.

Ég reyndi samt að bæta kröfufjárhæð við tæknimannalinsuna, því að tæknimaður hafði beðið um hana. Smiðurinn hafnaði því með LENS_CANNOT_WIDEN og vistaði ekkert. Engin leið er fram hjá þessu innan linsunnar: leiðin áfram er linsa á víðari grunni, önnur beiðni sem stjórnandi fyrirtækisins tekur ákvörðun um. Við slepptum henni.

Að fela eitthvað í linsu fjarlægir það ekki úr Nexus. Það þýðir að þetta hlutverk sér það ekki. Smiðurinn sýnir hve mörgum linsa nær til í tilraunaverkefninu (29 í okkar tilviki) og heldur annál yfir hverja Viðbót, Breytingu og Afturköllun. Linsa er skilgreind einu sinni fyrir fyrirtækið og veitt kerfishlutverki fyrir hverja einingu, svo sömu Reefer technician-linsu er hægt að veita tæknimönnum í Rotterdam þennan mánuðinn og í Felixstowe þann næsta.

Færni til að semja drög að tjónaskýrslum

Stjórnendur vildu fyrstu drög að bréfinu sem fer til farmeiganda eftir frávik. Það er textavinna, svo hún keyrir á líkani, og spurningin var hvar ætti að koma henni fyrir.

Í Nexus eru tvær tegundir færni og munurinn skiptir máli hér. Skilgreiningarfærni er tögguð lína í skills[] viðbótar sem kerfið sendir áfram. Skills Engine-færni er SKILL.md-pakki í færnisafni fyrirtækisins, sem gervigreindarfulltrúar, gervigreindarhnappar, verkflæði og þróunartól keyra öll á sama hátt. Kafli 2.20, Færni, fjallar um hvort tveggja.

Traust viðbótar okkar er community og samfélagsviðbót má aðeins tilgreina skilgreiningarfærni sem nær ekki til líkans (host_callback og plugin_queue). Þrepin tvö sem ná til AI Provider Router, tool_using og llm_only, krefjast traustsins core eða verified. Því varð gerð kröfubréfsdraga að Skills Engine-færni og beinirinn velur líkanið úr eigin safni 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.

Pakkinn er í skills/draft-claim-note/ í gagnageymslunni, og heiti möppunnar er það sama og heiti færninnar. Við staðfestum hann og hlóðum honum upp úr skipanalínunni:

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

Ef sama efni er hlaðið upp tvisvar er núverandi útgáfu skilað frekar en nýrri (CONTENT_HASH_ALREADY_PUBLISHED), svo óhætt er að keyra upphleðsluna aftur. Áður en útgáfa fer út keyrir Skills Engine prófunartilvik sín, prufukeyrslu í skugga á eldri verkum og blinda yfirferð líkans frá öðru fyrirtæki, ásamt tíma og kostnaði hverrar keyrslu.

Heildarþjónustuviðbótin

Pakkinn þurfti einnig kóða sem keyrir stöðugt: lesara fyrir fjarmælingastraum kæligámanna og ritara sem opnar frávikafærslu þegar mæling fer út fyrir mörk sín. Slíkur kóði á heima í fullbúinni þjónustuviðbót og við settum hana upp með eigin skipun SDK-settsins, sem skrifar allt tilvísunartréð með heitinu sett inn:

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

SDK-settið er sett upp úr https://registry.adverant.ai/npm/ með niðurhalslyklinum af síðunni Niðurhalslyklar og uppsetningarskipanir á Adverant-reikningnum þínum. Gerið commit á package-lock.json sem fyrsta uppsetningin skrifar; myndsmíðin keyrir npm ci og neitar án hennar.

Hér er sá hluti nexus.manifest.json okkar sem er frábrugðinn sniðmátinu. Þetta er ekki öll skráin: blokkirnar description, author, license, runtime, backend og frontend úr grunninum haldast óbreyttar, og sannprófarinn hafnar lýsingarskrá fullrar þjónustu án þeirra. Setningarnar þrjár í architecture eru reglurnar sem hver viðbót endurtekur, og sannprófarinn athugar orðalagið. UNO í þeirri fyrstu er verkflæðisvélin:

{
  "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 er færni í lýsingarskrá með stiginu host_callback: kerfið sendir inntakið til okkar eigin Service, innan okkar nafnrýmis, og aldrei til hýsils sem við tilgreinum. Móttökuleiðin er skilgreind auth: internal og varin með serviceMiddleware úr SDK, Express-útgáfu varnarinnar, sem hafnar kallmiða sem gefinn er út fyrir aðra viðbót, fyrirtæki, færni eða leið. classification hennar er tenant, sem er hámarkið fyrir samfélagsviðbót. Kafli 2.27, Byggja sviðsmyndir, fer yfir host_callback-færni eina og sér.

Tvær venjur frá þessu stigi er vert að tileinka sér. Sérhver tafla hefur organization_id, owner_user_id og business_unit_id frá fyrsta flutningi, því að bæta við ás síðar er flutningur yfir lifandi raðir. Og við keyrðum nexus-gates staðbundið fyrir hverja sendingu, þar sem það er sama skipunin og ferlið keyrir; keyrsla sem skoðaði ekkert hættir með 2 og segir frá því. Kafli 2.19, Reglurnar sem allar viðbætur erfa, telur upp hliðin.

Sýnigögn fyrir prófanir

Síðan Sýnigögn til prófunar býður upp á þrjár gerðir af greinum:

Tegund Hvað það geymir Hver samþykkir
Tilbúin Gögn mynduð út frá fjölda og lögun sem þú stillir; ekkert kemur frá raunverulegri einingu Enginn; hún er þín
Dulið afrit Afrit af einingu þar sem persónuleg, viðkvæm og viðskiptaleg svið hafa verið skipt út Gagnaeigandinn (Priya Natarajan fyrir Rotterdam)
Aðeins skema Lögun gagnageymslnanna, án raða Enginn; fyrir flutninga

Við mynduðum annasama viku: um 7 frávik í hverjum 100 kæligámum, sem er það sem annasamur ágúst lítur út eins og í Rotterdam. Óvenjulegu tilvikin skiptu meira máli en magnið. Við báðum um rafmagnsleysi við losun, hurð sem var skilin eftir opin, gat í skynjaragögnum og tvær kröfur vegna eins fráviks. Síðan getur stungið upp á óvenjulegum tilvikum út frá orsökum frávika í þekkingarlíkaninu, aldrei út frá raunverulegum færslum.

Hvert sett af fjölda og lögun er vistað sem fræ, til dæmis cold-chain-busy-01, ásamt fingrafari sínu. Sama fræið gefur sömu gögnin, þannig að hver prófunarkeyrsla á hverri grein sér sömu vikuna. Það er það sem gerði 66 prófanir okkar endurtakanlegar.

Grein lifir sjálfgefið í 72 klukkustundir og í mesta lagi 14 daga. Ég bað um að halda annasömu greininni okkar í 30 daga meðan á langri yfirferð stóð, og síðan hafnaði því með BRANCH_LIFE_EXCEEDED. Lausnin er sú sem platan leggur til: haltu fræinu og búðu til nýja grein úr því þegar þú þarft. Dulið afrit fylgir sömu takmörkunum, og beiðni um það inniheldur ástæðu og lengd sem er að hámarki 14 dagar.

Forskoða sjónarhorn sem tiltekinn aðili

Áður en nokkur í Rotterdam sá Cold chain skoðuðum við það eins og þau myndu gera. Forskoða sýn sem einstaklingur birtir pakkann nákvæmlega eins og valið hlutverk sér hann, á gagnagrein, innan strikaðs forskoðunarramma.

Forskoða sýn sem einstaklingur
Forskoða sjónarhorn sem tiltekinn aðili
Cold chain eins og kæligámatæknir í Rotterdam sér það, á tilbúinni grein. Taktu eftir kröfudálkinum merktum „falið af sýn“ á hverju opnu fráviki, og hliðarspjaldinu sem segir hvað þessi sýn felur og hvers vegna.

Þrjár reglur gera forskoðanir öruggar til frjálsrar notkunar. Forskoðun notar gagnagrein, aldrei lifandi eininguna. Þínar eigin heimildir leka ekki inn í hana, þannig að þú sérð það sem hlutverkið sér en ekki það sem þú getur séð. Og henni lýkur eftir 30 mínútur. Ef forskoðun er beint að lifandi einingu er því hafnað með CONNECTION_SCOPE_EXCEEDED; ef þú þarft raunverulega lögun skaltu biðja gagnaeigandann um dulið afrit og forskoða á því.

Það var í forskoðuninni sem við fundum raunveruleg mistök. Hitastigsritið í sýn tæknimannsins sýndi stillipunktinn, og breytingar á stillipunkti áttu aðeins að vera fyrir stjórnendur. Ritið var í lagi; breytingahnappurinn undir því var það ekki. Útgáfa 0.3.2 faldi breytingar á stillipunkti fyrir tæknimönnum, og það var í forskoðuninni sem við fundum þetta.

Að breyta þekkingarlíkaninu eftir útgáfu

Í útgáfu 0.4.0 þurftum við tegundina Skoðun fyrir skoðanir fyrir ferð, og venslin „Frávik olli Kröfu“ hljómuðu betur sem „Frávik leiddi til Kröfu“. Að færa líkanið úr 1.3 í 1.4 er breyting á þekkingarlíkani, og síðan Breytingar á þekkingarlíkani sýnir mismuninn, hverju breytingin myndi snerta og hvar hún er stödd á leið sinni.

Breytingin fer sem beiðni um breytingu á grafi. Prufukeyrsla hennar telur hverju hún myndi snerta á duldu afriti Rotterdam, sem fjölda: hjá okkur 1,284 tengsl endurnefnd og engu eytt. Tveir yfirferðaraðilar samþykkja hana, og ferlið beitir henni á prófunarumhverfi, síðan á tilraunaeininguna. Enginn skrifar handvirkt í sameiginlega grafið; tilraun til þess er hafnað og skráð. Þrjár vistaðar spurningar notuðu orðið „olli“, og breytingin bar með sér sjálfvirka endurritun fyrir hverja þeirra, sem síðan taldi upp. Síur sýnanna breyttust ekki, því að báðar sýnirnar þrengdu enn aðeins.

Færa í raunrekstur

Sérhver útgáfa fer eftir einni leið: þróunarrými, prófunarumhverfi, tilraunaeining og síðan allar einingar. Hvert skref hefur hlið, og ekkert sleppir neinu þeirra.

Inn í Hlið
Prófunarumhverfi Allar prófanir standast; gæðaathuganir; lýsingarskrá óbreytt eða útvíkkunin samþykkt; undirrituð mynd
Tilraunaeining (Rotterdam) Prufukeyrsla líkanbreytingar á duldu afriti án villna; reglnaathugun á reglum sýna og umfangs; tveir yfirferðaraðilar sem eru ekki höfundurinn, annar þeirra gagnaeigandinn
Allar einingar 14 dagar í tilraunaeiningu; villur undir 1 af 1,000, taldar í tilraunaeiningunni; hver stjórnandi einingar samþykkir fyrir sína einingu; tveir yfirferðaraðilar sem eru ekki höfundurinn
Umhverfi og tilfærsla milli umhverfa
Umhverfi og flutningur útgáfa milli umhverfa
Cold chain 0.3.2 bíður við hlið tilraunaeiningar eftir öðrum yfirferðaraðila sínum. Platan til hægri er höfnunin fyrir að reyna að færa beint úr þróunarrými til allra eininga.

Ég reyndi flýtileiðina einu sinni, á föstudegi, fyrir einnar línu lagfæringu: að færa 0.4.0-dev úr þróunarrýminu mínu til allra eininga. Því var hafnað með GATE_CANNOT_BE_SKIPPED, og ekkert var fært. Platan segir þér að færa í næsta skref í staðinn, og það er eina svarið sem til er.

Útgáfuyfirferðin sjálf, gögnin sem annar yfirferðaraðili les og rásirnar sem einingar velja, eru í kafla 2.28, Útgáfa viðbótarinnar. Tvær staðreyndir þaðan eiga heima hér, því að þær móta hvernig þú skipuleggur lóðréttan pakka. Höfundurinn telst aldrei sem yfirferðaraðili, þannig að tveggja manna teymi þarf þriðja mann fyrir hverja útgáfu. Og hvert umhverfi geymir fyrri útgáfuna í 30 daga, þannig að afturköllun er yfirfarin breyting sem ferlið framkvæmir á um það bil mínútu.

Að útvíkka pakka sem þegar er til

Ekki hefst sérhver lóðréttur pakki frá grunni. Pakki getur erft frá öðrum og bætt aðeins við því sem er frábrugðið. Pakkinn Bankastarfsemi og greiðslur, sem Larchmont Bank keyrir, er skýrasta dæmið í vörulistanum. Lýsingarskrá hans byrjar svona:

{
  "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 tilgreinir pakkann sem hann byggir á. Bankastarfsemi og greiðslur heldur lögun Tryggingapakkans, sameiginlegum samtalsklösum hans og kjarnaorðum, og bætir við þremur eigin sýnum: Lánaákvarðanir, Kortaágreiningur og Minn reikningur. Þriðja stak hverrar færslu í orðasafninu er exact fyrir hugtak sem verður að birta eins og það er skrifað, til dæmis APR (árleg hlutfallstala kostnaðar), í stað þess að umorða það.

Sumt er ekki hægt að gera með erfðum. Pakki breytir aldrei skelinni, íhlutunum eða ritreglunum, þannig að afleiddur pakki getur ekki breytt útliti stjórnborðsins. Regluverk sem nokkrir pakkar þurfa er ein sameiginleg sýn frekar en afrit í hverjum þeirra: skrá yfir útvistaða tækni þjónar bæði Tryggingum og Bankastarfsemi og greiðslum. Ef afleiddi pakkinn þinn þarf sýn sem er þegar til sem sameiginleg sýn skaltu nota hana í stað þess að búa til þína eigin.

Leyfisveiting fylgir erfðunum. Pakki er leyfður ofan á Enterprise og getur þurft viðbætur, og leyfisskjalið ber þessi skilyrði. Tryggingar þurfa Ákvörðunarherbergi og innsiglaðar færslur, þannig að viðskiptavinur sem fær leyfi fyrir pakka sem erfir hann þarf einnig þá viðbót, og stjórnborðið neitar að gefa út leyfi sem sleppir henni. Símaskjáir pakka þurfa einnig viðbótina Farsímaforrit. Athugaðu keðju skilyrðanna áður en þú lofar viðskiptavini dagsetningu.

Að bæta sjónarhorni við pakka sem hefur verið gefinn út

Minnsta vinnan við lóðréttan pakka er ný sýn á pakka sem þú skrifaðir ekki. Sex mánuðum inn í tilraunina vildi sjótjónateymi Larkfield fá eigin sýn innan Cold chain: frávik og kröfur, engir rafmagnstenglar, engir stillipunktar. Við snertum ekki kóða pakkans. Sýn er röð í sýnaskrá fyrirtækisins, í eigu pakkans, þannig að við byrjuðum hana út frá gullnu leiðinni fyrir sýnir á Byrja eitthvað nýtt og mótuðum hana í Sýnasmiðnum með stjórnandasýn Cold chain sem grunn. Sama regla gildir og áður: nýja sýnin getur falið það sem grunnurinn sýnir og getur aldrei sýnt meira. Hún er skilgreind einu sinni fyrir fyrirtækið og veitt kerfishlutverki í hverri einingu. Veiting er afturkölluð, aldrei eytt, og ef sýnin er veitt aftur verður til ný veiting, þannig að hver hafði hvaða sýn og hvenær helst læsilegt. Skráin telur hve margir höfðu sýn í hverjum mánuði, aldrei hverjir.

Síðan Sýnir og hverjir sjá þær sýnir niðurstöðuna sem fylki sýna eftir einingu og hlutverki, með Bæta við, Breyta og Afturkalla í hverjum reit. Forskoðaðu nýju sýnina sem einstaklingur áður en þú veitir hana, nákvæmlega eins og að ofan.

Hvað það kostaði í raun og veru

Pakki snertir færslur viðskiptavinar, þannig að kerfið gerir sumt viljandi hægvirkt, og þú ættir að gera ráð fyrir því frá fyrsta degi.

  1. Dulið afrit krefst samþykkis gagnaeigandans í hvert sinn. Okkar tók dag að berast í fyrsta skiptið, því að Priya vildi lesa þekkingarlíkanið fyrst. Byrjaðu á tilbúnum gögnum og spurðu snemma.
  2. Höfundurinn getur ekki samþykkt eigin útgáfu, og beiðnir falla úr gildi eftir 3 daga. Ef yfirferðaraðilar þínir eru uppteknir bíður útgáfan þín.
  3. Útgáfa sem biður um meira en sú síðasta, til dæmis að senda póst eða eitt utanaðkomandi vistfang, er stöðvuð þar til tveir yfirferðaraðilar samþykkja víðari lýsingarskrána. Kafli 2.28, Útgáfa viðbótarinnar, sýnir síðuna Lýsingarskrá og heimildir sem segir þér frá því áður en þú spyrð.
  4. Sýn getur ekki sýnt það sem grunnsýn hennar felur. Ef hlutverk þarf raunverulega meira er það samtal við stjórnanda fyrirtækisins, ekki stilling.

Ekkert af þessu var okkur til trafala tvisvar. Önnur útgáfa Cold chain tók viku frá fyrstu framlagningu að tilraunaeiningunni í Rotterdam, mest af því 66 prófanir sem keyrðu á þremur greinum og tveir einstaklingar sem lásu gögnin.