Sínigh isteachCuir cruinniú eolais in áirithe

Caibidil 2.24

Earnáil shaincheaptha a thógáil ó thús deireadh

Tógáil oibrithe de phacáiste fearainn an tSlabhra Fhuair, ón gcéad choimirce go dtí eisiúint atá ag rith do gach aonad, lena shamhail eolais, lionsaí, scil, breiseán lánseirbhíse agus sonraí samplacha. Ansin conas pacáiste atá ann cheana a leathnú agus conas lionsa a chur le ceann atá seolta cheana.

d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

19 nóiméad le léamh

Is mise Mateo Ruiz, forbróir ag Corrán Orbital. Caithim formhór mo sheachtaine ar ár mbogearraí pálasta féin, ach baineann an chaibidil seo le jab a rinneamar do chustaiméir. Déanann Larkfield & Vane lasta a árachú, agus taistealaíonn sciar atá ag fás de i gcoimeádáin chuisnithe. Nuair a chailleann coimeádán cuisnithe cumhacht ón gcladach ag an gcé, ardaíonn an teocht, loiceann an lasta agus tagann éileamh roinnt seachtainí ina dhiaidh sin. Bhí Larkfield ag iarraidh go bhfeicfeadh a gcuid daoine an slabhra sin mar rud amháin in Nexus, ón lochtcumhachta go dtí an t-éileamh, agus gan ach a chuid féin le feiceáil ag gach ról. B'in mar a tháinig an pacáiste Cold chain ar an saol.

Is é atá anseo thíos an tógáil san ord inar rinneamar í, leis na scáileáin, na comhaid agus na horduithe. D'fhág mé na botúin isteach, mar gur mhúin dhá cheann de na diúltuithe a fuaireamar níos mó dúinn faoin ardán ná mar a mhúin an cosán réidh. Tá an t-ábhar tagartha sna caibidlí roimh an gceann seo, agus tagraím dóibh seachas iad a athrá. Na cinn ar bhain mé an leas is mó astu ná caibidil 2.18, An tsamhail síneadh, agus caibidil 2.23, Pacáistí fearainn, agus caibidil 2.21, An Plugin SDK, oscailte lena dtaobh don trealamh forbartha bogearraí féin.

Conair ó chlé go deas d'ocht mbosca: "Achoimre", "Conair órga", "Múnla eolais", "Lionsaí", "Scil agus breiseán", "Sonraí samplacha agus réamhamharc", "Athbhreithniú eisiúna", "Cur chun cinn". Faoin mbosca deireanach, taispeánann an dara sraith de cheithre bhosca níos lú ceangailte le saigheada céimeanna an chur chun cinn: "Spás forbartha", "Stáitse", "Aonad píolótach (Rotterdam)", "Gach aonad", le deilbhín glais ar gach saighead lipéadaithe "geata". Tá saighead bhriste ó "Spás forbartha" go díreach go "Gach aonad" trasnaithe amach agus lipéadaithe GATE_CANNOT_BE_SKIPPED.
Tógáil Cold chain, ón mionteagasc go dtí gach aonad.

An mionteagasc, agus cé a dhéanann cad

Thug Larkfield suíochán forbróra dom ina n-eagraíocht ar feadh fhad an tionscadail. Is tábhachtach é sin, mar tógtar pacáiste príobháideach do chustaiméir amháin taobh istigh de shuiteáil an chustaiméara sin, ar a spásanna forbartha agus a bhrainsí sonraí, faoi fhaomhadh a chuid daoine. Tógtar pacáiste atá ceaptha do go leor custaiméirí ar bhealach eile, ar bhraisle foilsitheora le sonraí samplacha amháin, agus clúdaíonn caibidil 2.25, Tógáil do gach eagrán, an cás sin.

Luigh an mionteagasc ar leathanach amháin:

  • Coimeádáin chuisnithe ag an gcé agus ar shoithí: a gcumhacht, a sáruithe teochta agus na héilimh a leanann iad.
  • Dhá ról le tosú: teicneoir coimeádán cuisnithe ar an gcé, agus rialaitheoir an tslabhra fhuair san oifig.
  • Píolóta a ritheann san aonad Rotterdam ar dtús agus a bhogann go Felixstowe ina dhiaidh sin.
  • Fianaise do thrí shraith rialacha: comhaontú ATP do bhia meathlaithe, dea-chleachtas dáileacháin an AE do chógais, agus taifid sábháilteachta bia faoi HACCP (anailís ghuaise agus pointí criticiúla rialaithe). Úsáideann éilimh faoi rialacha Hague-Visby na taifid sháraithe chéanna, mar sin thugamar faoi deara iad le haghaidh tar éis an phíolóta.

Is cumas Enterprise iad pacáistí fearainn. Ritheann Larkfield Enterprise, mar sin bhí cosán an phacáiste fearainn oscailte dom. Ar Community, ní thairgtear an cosán órga do phacáiste ar chor ar bith.

Tosaigh ón gcosán órga

Tosaíonn gach rud ar an leathanach Tosaigh rud éigin nua. Tairgeann sé sé chosán órga: breiseán, pacáiste fearainn, lionsa, ardán, scil agus sreabhadh oibre. Déanann gach ceann acu stór ó theimpléad leaganaithe, léiriú a fhógraíonn a bhfuil ag teastáil ón rud, tástálacha, spás forbartha agus brainsí sonraí. Oibríonn na cosáin chéanna sa chonsól, ar an líne ordaithe agus ó do IDE (timpeallacht forbartha comhtháite), áit a ndéanann uirlis Workbench nexus.create an jab céanna le plean a dheimhníonn tú ar dtús.

Tosaigh rud éigin nua
Tosaigh rud éigin nua
Na sé chosán órga, gach ceann lena ndéanann sé, a ordú nexus create agus a theimpléad greamaithe. Tabhair faoi deara an pláta ag an mbun: cuirtear an léiriú i bhfeidhm, ní comhairle amháin é, agus coinnítear siar eisiúint a iarrann níos mó go dtí go ndéanann beirt athbhreithniú air.

Ghlacamar cosán an phacáiste fearainn ón leathanach sin, agus thugamar cold-chain mar ainm ar an bpacáiste agus Rotterdam ar a chéad aonad. Ainmníonn an toradh an teimpléad greamaithe, domain-pack@1.6.0, agus liostaíonn sé a ndearna sé: an stór, léiriú a fhógraíonn ceithre raon, dhá stóras agus gan aon seoladh amach, 66 tástáil ón teimpléad, spás forbartha in Rotterdam, trí bhrainse sonraí sintéiseacha agus iontráil dréachta i gcatalóg Larkfield féin nach raibh le feiceáil ag aon duine ach mise. Tá leagan an teimpléid greamaithe, agus tagann uasghrádú air níos déanaí mar athrú athbhreithnithe cosúil le haon athrú eile, ionas nach mbogann pacáiste aon duine fúthu toisc gur bhog teimpléad. D'úsáid mé draoi an chonsóil dár gcéad phacáiste mar sin féin, mar taispeánann sé an plean sula ndéanann sé aon rud.

Céim 1: abair cad chuige an pacáiste

Tá trí chéim i ndraoi an Phacáiste fearainn nua: faoi, samhail eolais, agus athbhreithniú agus cruthú. Iarrann Céim 1 an beagán rudaí a mhúnlaíonn gach rud ina dhiaidh.

Réimse An méid a chuireamar isteach Nóta
Ainm Cold chain Úsáidtear don stór agus don chatalóg
Cad chuige é Coimeádáin chuisnithe ag an gcé agus ar shoithí: cumhacht, sáruithe teochta agus na héilimh a leanann iad
Tionscal Lóistíocht agus muirí Tógann ar an bpacáiste Lóistíocht agus muirí
Úinéir An duine a chruthaíonn é Glasáilte sa draoi
Aonaid Rotterdam (píolóta) Felixstowe tar éis an phíolóta
Teimpléad domain-pack@1.6.0 Glasáilte; tagann uasghráduithe mar athruithe athbhreithnithe
Rialacha a mhapálann sé Comhaontú ATP, dea-chleachtas dáileacháin an AE, taifid sábháilteachta bia Déantar leathanach i léarscáil fianaise an phacáiste de gach riail

Mhol an cúntóir sa duga an tsraith dheireanach, lena n-áirítear an pointe go n-athúsáideann éilimh lasta na taifid sháraithe chéanna. Deir pláta ag bun an leathanaigh nach bhfuil aon rud déanta fós. Ní dhéantar an stór, an spás forbartha ná na brainsí sonraí ach nuair a bhrúnn tú Cruthaigh ar chéim 3, tar éis duit an plean a fheiceáil. Is féidir leat dréacht a shábháil agus filleadh air.

Céim 2: an tsamhail eolais

Is í an tsamhail eolais an tacar cineálacha rudaí a bhfuil eolas ag an bpacáiste orthu agus an chaoi a nascann siad. Thosaigh Cold chain ó bhunsamhail na lóistíochta, logistics-base 4.2, a iompórtáladh ón SDK, a thug cúig bhunchineál dúinn le tógáil orthu (Vessel, Port, Container, Carrier agus Shipment). Is inléite amháin iad bunchineálacha sa draoi. Má tá ar cheann acu athrú, athraíonn sé sa phacáiste ar leis é.

Chuireamar cúig chineál dár gcuid féin leis:

Cineál Cad é féin Airíonna
Reefer unit Coimeádán cuisnithe 9
Vessel call Soitheach amháin ag caladh amháin 6
Excursion Teocht lasmuigh dá teorainneacha 8
Power supply Pointe cumhachta cladaigh nó loinge 4
Éiligh Airgead a iarrtar as lasta loite 7
Pacáiste fearainn nua: samhail eolais
Pacáiste fearainn nua: múnla eolais
An graf eolais le cúig bhunchineál agus cúig cinn nua. Féach ar airíonna Excursion ar dheis: iompraíonn gach airí a aicme de réir mar a dhéantar é, agus deir an pláta gur tráchtáil iad méideanna éilimh, mar sin ní féidir le lionsaí teicneoirí iad a thaispeáint.

Aicmítear gach airí de réir mar a dhéanann tú é. Is pearsanta é "Tuairiscithe ag" ar Excursion. Is tráchtáil iad "Luach lasta i mbaol" agus méid agus socrú éilimh. Bhraith sé seo cosúil le páipéarachas ar an gcéad lá agus shábháil sé sinn faoi dhó níos déanaí, mar is iad na haicmí a chinneann cad is féidir le lionsa a thaispeáint, cad a chuireann cóip cheilte in ionad agus cad a cheileann líne loga.

Sroicheann dhá cheann dár ngaolta isteach sa bhunsamhail: tá Reefer unit plugáilte isteach i Power supply, agus tagraíonn Claim do Shipment. Ní athraítear an bhunsamhail féin. Fanann airí a tharraingíonn tú siar i leagan 1.0 den tsamhail agus ní fhágann sé ach i leagan níos déanaí, ionas nach stopann aon rud a bhí fíor faoi sheantaifid de bheith inléite.

Céim 3: athbhreithnigh agus cruthaigh

Is é Céim 3 an plean. Liostaíonn sé a ndéanfar, na raonta a fhógróidh an léiriú, na brainsí sonraí agus an spás forbartha. Deimhníonn tú an plean le d'eochair phasfhocail, agus faigheann an plean méarlorg. Leanann an cruthú an plean sin go díreach ansin, céim ar chéim, agus is féidir leat stopadh ag aon chéim agus a bhfuil déanta a choinneáil.

D'fhógair an plean do Cold chain ceithre raon:

Raon An fáth a dteastaíonn sé ón bpacáiste
Teiliméadracht coimeádán cuisnithe a léamh Léamha cumhachta agus teochta
Sáruithe a scríobh Taifeadann sé sárú nuair a sháraítear teorainneacha
Lastais a léamh Nascann sé éileamh lena lastas
Nótaí éilimh a dhréachtú Dréachtaí amháin; seolann duine

Ba iad an graf agus taifid a stórais. Ní raibh aon seoltaí amach aige agus bhí an phróifíl bhosca gainimh Standard aige. Tháinig an spás forbartha le 4 chroí, 16 GiB cuimhne agus 50 GiB stórála, líonra dúnta ach amháin don mhéid a fhógraíonn an léiriú, íomhánna sínithe amháin, agus deireadh tar éis 7 lá díomhaoin. Nuair a thagann deireadh leis, fanann a shainmhíniú sa stór, mar sin déanann tú arís é as sin.

Tháinig na trí bhrainse sonraí ón ngineadóir sintéiseach. Níor cóipeáladh aon sonraí custaiméara. Teastaíonn comhaontú úinéir na sonraí le haghaidh cóip cheilte de Rotterdam, arb í Priya Natarajan é ag Larkfield, agus iarrann tú é sin ar leith.

Forógra an phacáiste

Coinníonn an stór léiriú an phacáiste, pack.json. Ainmníonn sé an pacáiste, a leagan, an pacáiste óna bhfaigheann sé oidhreacht (más ann dó), a bhraislí agus a fhocail. Is lionsa é braisle, is é sin a bhfeiceann ról amháin taobh istigh den phacáiste, nó is braisle chomhroinnte é, a ritheann trasna gach lionsa. Seo croí ár gceann féin:

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

Coinníonn an foclóir focail an phacáiste féin le gluais shimplí do gach ceann, gearr go leor le léamh ar fhón.

Taobh le pack.json fógraíonn an léiriú freisin a bhfuil cead ag an bpacáiste a shroichint: a raonta, a stórais, a sheoltaí amach agus a phróifíl bhosca gainimh. Deonaíonn Nexus é sin go díreach agus faic níos mó. Seiceáiltear gach glao uirlise in aghaidh na raonta fógartha, agus cuirtear bac ar sheoladh seachtrach mura bhfuil sé liostaithe. Is féidir leat an fógra, agus an t-athrú i gcomparáid leis an eisiúint dheireanach, a léamh ar leathanach Léiriú agus ceadanna an phacáiste.

Lionsaí: an méid a fheiceann gach ról

Ní féidir le lionsa riamh ach an méid a thaispeánann a bhonn a chúngú, agus mhúnlaigh an riail amháin sin níos mó dár ndearadh ná aon riail eile. Taispeánann lionsa cuid den mhéid a thaispeánann a bhunlionsa, agus is ó róil a thagann ceadanna fós: cinneann lionsa cad a fheiceann ról sa phacáiste, ní cad a bhfuil cead aige a dhéanamh.

Cúngaíonn an lionsa Reefer technician Operations controller, an bunlionsa a ritheann Larkfield cheana féin d'obair lóistíochta. Sa Tógálaí lionsaí cuireann tú tic leis na cártaí, na réimsí agus na gníomhartha a thaispeánann an lionsa. Tá míreanna nach dtaispeánann an bonn glasáilte.

Cuid Taispeánann Reefer technician Fágtha amach
Cártaí Coimeádáin chuisnithe ag an gcé, sáruithe oscailte, pointí cumhachta, cuairteanna soithí inniu Aon rud faoi éilimh
Réimsí Staid chumhachta, pointe socraithe, an léamh deireanach, an teocht is airde Méid an éilimh (níl sé sa bhunlionsa), réimsí pearsanta (múchta de réir réamhshocraithe)
Gníomhartha Cúis sháraithe a thaifeadadh, seiceáil chumhachta a iarraidh Pointe socraithe a athrú agus sárú a dhúnadh (rialaitheoirí amháin), nóta éilimh a dhréachtú
Tógálaí lionsaí
Tógálaí lionsaí
An Tógálaí lionsaí do Reefer technician, tic curtha in aghaidh a bhunlionsa. Is é an pláta ag bun ar chlé an diúltú a fhaigheann tú as tic a chur le méid an éilimh: ní thaispeánann an bunlionsa é, mar sin ní féidir leis an lionsa seo é a thaispeáint.

Rinne mé iarracht méid an éilimh a chur leis an lionsa teicneora mar sin féin, mar gur iarr teicneoir é. Dhiúltaigh an tógálaí le LENS_CANNOT_WIDEN agus níor shábháil sé faic. Níl aon bhealach timpeall air taobh istigh den lionsa: is é an bealach ar aghaidh lionsa ar bhonn níos leithne, iarratas difriúil a chinneann riarthóir na heagraíochta. D'fhágamar amach é.

Ní bhaineann folú ruda i lionsa é as Nexus. Ciallaíonn sé nach bhfeiceann an ról seo é. Taispeánann an tógálaí cé mhéad duine a shroichfidh lionsa sa phíolóta (29, inár gcás féin) agus coinníonn sé loga de gach Cur leis, Athrú agus Tarraingt siar. Sainmhínítear lionsa uair amháin don eagraíocht agus deonaítear é in aghaidh an aonaid do ról ardáin, ionas gur féidir an lionsa Reefer technician céanna a thabhairt do theicneoirí Rotterdam an mhí seo agus do theicneoirí Felixstowe an mhí seo chugainn.

Scil chun nótaí éilimh a dhréachtú

Theastaigh ó rialaitheoirí céad dréacht den nóta a théann chuig úinéir lasta tar éis sáraithe. Obair theanga é sin, mar sin ritheann sé ar shamhail, agus ba í an cheist cá háit lena chur.

Tá dhá chineál scile in Nexus, agus is tábhachtach an difríocht anseo. Is éard is scil léirithe ann ná ró clóscríofa i skills[] breiseáin, a sheolann an t-ardán. Is éard is scil Skills Engine ann ná pacáiste SKILL.md i leabharlann scileanna na heagraíochta, a ritheann gníomhairí, cnaipí AI (intleacht shaorga), sreafaí oibre agus uirlisí forbróra ar fad ar an mbealach céanna. Clúdaíonn Caibidil 2.20, Scileanna, an dá cheann.

Is é community iontaoibh ár mbreiseáin, agus ní féidir le breiseán pobail ach scileanna léirithe nach sroicheann samhail a fhógairt (host_callback agus plugin_queue). Teastaíonn iontaoibh core nó verified ón dá shraith a shroicheann an AI Provider Router, tool_using agus llm_only. Mar sin rinneadh scil Skills Engine de dhréachtú nótaí éilimh, agus roghnaíonn an ródaire an tsamhail ó chomhthiomsú Larkfield féin:

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

Tá an pacáiste i skills/draft-claim-note/ sa stór, agus ainm an fhillteáin cothrom le hainm na scile. Bhailíochtaíomar agus d'uaslódálamar é ón teirminéal:

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

Má uaslódáiltear an t-ábhar céanna faoi dhó, filltear an leagan atá ann cheana seachas leagan nua (CONTENT_HASH_ALREADY_PUBLISHED), mar sin is sábháilte an t-uaslódáil a rith arís. Sula n-eisítear leagan, ritheann an Skills Engine a chásanna tástála, triail i scáth ar obair a rinneadh roimhe, agus athbhreithniú dall ag samhail ó chomhlacht eile, le ham agus costas gach rite.

An breiseán lánseirbhíse

Bhí cód ag teastáil ón bpacáiste freisin a ritheann an t-am ar fad: léitheoir don fhotha teiliméadrachta coimeádán cuisnithe, agus scríbhneoir a osclaíonn taifead sáraithe nuair a sháraíonn léamh a theorainneacha. Is i mbreiseán lánseirbhíse a bhaineann cód mar sin, agus rinneamar scafall de le hordú an SDK féin, a scríobhann an crann tagartha iomlán agus an t-ainm curtha isteach:

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

Suiteáiltear an SDK ó https://registry.adverant.ai/npm/ leis an gcomhartha tarraingthe ón leathanach Comharthaí tarraingthe agus orduithe suiteála de do chuntas Adverant. Déan tiomantas den package-lock.json a scríobhann an chéad suiteáil; ritheann tógáil na híomhá npm ci agus diúltaíonn sí gan é.

Seo an chuid dár nexus.manifest.json a difríonn ón teimpléad. Ní hé an comhad iomlán é: fanann bloic description, author, license, runtime, backend agus frontend an scafaill mar atá siad, agus diúltaíonn an bailíochtóir do léiriú seirbhíse iomláine gan iad. Is iad na trí abairt architecture an dlí a athluann gach breiseán, agus seiceálann an bailíochtóir an fhoclaíocht. Is é UNO sa chéad cheann an t-inneall sreafa oibre:

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

Is scil léirithe é excursion_open leis an leibhéal host_callback: postálann an t-ardán an t-ionchur chuig ár Seirbhís féin, laistigh dár n-ainmspás, agus ní chuig óstríomhaire a ainmnímid choíche. Fógraítear an bealach glacadóra auth: internal agus cosnaítear é le serviceMiddleware an SDK, foirm Express an gharda, a dhiúltaíonn do chomhartha glao a eisíodh d'aon bhreiseán, eagraíocht, scil nó bealach eile. Is é tenant a classification, arb é an uasteorainn do bhreiseán pobail é. Siúlann Caibidil 2.27, Cásanna a thógáil, trí scil host_callback ina haonar.

Is fiú dhá nós ón gcéim seo a aithris. Iompraíonn gach tábla organization_id, owner_user_id agus business_unit_id ón gcéad imirce, mar is imirce thar shraitheanna beo é ais a chur leis níos déanaí. Agus rithamar nexus-gates go háitiúil roimh gach brú, ós é an t-ordú céanna é a ritheann an píblíne; scoireann rith nár scrúdaigh aon rud le 2 agus deir sé amhlaidh. Liostaíonn Caibidil 2.19, Na rialacha a fhaigheann gach síneadh le hoidhreacht, na geataí.

Sonraí samplacha le haghaidh tástála

Tairgeann an leathanach Sonraí samplacha le haghaidh tástála trí chineál brainse:

Cineál An méid atá ann Cé a aontaíonn
Sintéiseach Sonraí a ghintear ó chomhairimh agus ó chruthanna a shocraíonn sibh; ní thagann aon rud ó aonad fíor Duine ar bith; is libhse é
Cóip cheilte Cóip d'aonad ina bhfuil réimsí pearsanta, íogaire agus tráchtála curtha in ionad Úinéir na sonraí (Priya Natarajan do Rotterdam)
Scéimre amháin Cruth na stórais, gan aon sraitheanna Duine ar bith; le haghaidh imirceanna

Ghineamar seachtain ghnóthach: thart ar 7 seachrán i ngach 100 coimeádán cuisnithe, agus sin an chuma atá ar Lúnasa gnóthach in Rotterdam. Ba thábhachtaí na cásanna corra ná an toirt. D'iarramar cailleadh cumhachta le linn díluchtaithe, doras fágtha ar oscailt, bearna braiteora, agus dhá éileamh ar sheachrán amháin. Is féidir leis an leathanach cásanna corra a mholadh ó chúiseanna seachráin sa mhúnla eolais, ach ní ó thaifid fhíora choíche.

Sábháiltear gach tacar comhaireamh agus cruthanna mar shíol, mar shampla cold-chain-busy-01, lena mhéarlorg. Tugann an síol céanna na sonraí céanna, mar sin feiceann gach rith tástála ar gach brainse an tseachtain chéanna. Sin a d'fhág ár 66 tástáil in-athdhéanta.

Maireann brainse 72 uair de réir réamhshocraithe agus 14 lá ar a mhéad. D'iarr mé ár mbrainse gnóthach a choinneáil ar feadh 30 lá le linn athbhreithnithe fhada, agus dhiúltaigh an leathanach le BRANCH_LIFE_EXCEEDED. Is é an réiteach an ceann a mholann an pláta: coinnigh an síol, agus déan brainse úr uaidh nuair a bhíonn ceann ag teastáil uait. Leanann cóip cheilte na teorainneacha céanna, agus iompraíonn a hiarratas cúis agus fad suas le 14 lá.

Réamhamharc ar lionsa mar dhuine

Sula bhfaca aon duine in Rotterdam Cold chain, d'fhéachamar air mar a d'fhéachfaidís féin air. Rindreálann Réamhamharc ar lionsa mar dhuine an pacáiste díreach mar a fheiceann ról roghnaithe é, ar bhrainse sonraí, laistigh d'fhráma réamhamhairc briste.

Réamhamharc ar lionsa mar dhuine
Réamhamharc ar lionsa mar dhuine
Cold chain mar a fheiceann teicneoir coimeádán cuisnithe in Rotterdam é, ar bhrainse sintéiseach. Tabhair faoi deara an colún éilimh marcáilte "folaithe ag an lionsa" ar gach seachrán oscailte, agus an painéal taoibh a insíonn cad a fholaíonn an lionsa seo agus cén fáth.

Fágann trí riail go bhfuil réamhamhairc sábháilte le húsáid go saor. Úsáideann réamhamharc brainse sonraí, ní an t-aonad beo choíche. Ní sceitheann bhur gceadanna féin isteach ann, mar sin feiceann sibh an rud a fheiceann an ról agus ní an rud is féidir libhse a fheiceáil. Agus críochnaíonn sé tar éis 30 nóiméad. Diúltaítear le CONNECTION_SCOPE_EXCEEDED do réamhamharc a dhíriú ar aonad beo; má bhíonn cruthanna fíora ag teastáil uaibh, iarr cóip cheilte ar úinéir na sonraí agus déan réamhamharc air sin.

Sa réamhamharc a rugamar ar fhíorbhotún. Thaispeáin an chairt teochta ar radharc an teicneora an pointe socraithe, agus bhí eagarthóireacht pointe socraithe ceaptha do rialaitheoirí amháin. Bhí an chairt i gceart; ní raibh an cnaipe eagarthóireachta fúithi. D'fholaigh leagan 0.3.2 eagarthóireacht pointe socraithe ó theicneoirí, agus sa réamhamharc a d'aimsíomar é.

An tsamhail eolais a athrú tar éis í a sheoladh

Faoi leagan 0.4.0 bhí cineál Inspection ag teastáil uainn le haghaidh iniúchtaí réamhthurais, agus ba fhearr a léigh an gaol "Excursion led to Claim" ná "Excursion caused Claim". Is athrú ar an múnla eolais é an múnla a bhogadh ó 1.3 go 1.4, agus taispeánann an leathanach Athruithe ar an múnla eolais a dhifríocht, cad a bhainfeadh sé leis agus cá bhfuil sé ar a bhealach.

Taistealaíonn an t-athrú mar iarratas athraithe graif. Comhaireann a thriail thirim cad a bhainfeadh sé leis ar chóip cheilte Rotterdam, mar chomhairimh: dúinne, 1,284 nasc athainmnithe agus faic bainte. Faomhann beirt athbhreithneoirí é, agus cuireann an píblíne i bhfeidhm é ar stáitse, ansin ar an bpíolóta. Ní scríobhann aon duine chuig an ngraf comhroinnte de láimh; diúltaítear d'iarracht agus taifeadtar í. D'úsáid trí cheist shábháilte an focal "caused", agus d'iompair an t-athrú athscríobh uathoibríoch do gach ceann acu, a liostaigh an leathanach. Níor athraigh scagairí lionsa, mar níor rinne an dá lionsa ach cúngú i gcónaí.

Ardú go táirgeadh

Bogann gach eisiúint ar feadh conair amháin: spás forbartha, stáitse, aonad píolótach, ansin gach aonad. Tá geataí ag gach céim, agus ní scipeálann aon rud ceann acu.

Isteach i Geataí
Stáitse Pasálann gach tástáil; seiceálacha cáilíochta; léiriú gan athrú nó an leathnú glactha; íomhá shínithe
Píolóta (Rotterdam) Triail thirim ar athrú múnla ar an gcóip cheilte gan earráidí; seiceáil pholasaí ar rialacha lionsa agus raoin; beirt athbhreithneoirí nach é an t-údar iad, duine acu úinéir na sonraí
Gach aonad 14 lá sa phíolóta; earráidí faoi 1 in 1,000, comhairthe sa phíolóta; aontaíonn riarthóir gach aonaid dá aonad; beirt athbhreithneoirí nach é an t-údar iad
Timpeallachtaí agus ardú céime
Timpeallachtaí agus ardú céime
Cold chain 0.3.2 ag fanacht ag geata an phíolóta lena dara hathbhreithneoir. Is é an pláta ar dheis an diúltú as iarracht a chur chun cinn go díreach ó spás forbartha go gach aonad.

Thriail mé an aicearra uair amháin, ar an Aoine, le haghaidh deisiúchán aonlíne: 0.4.0-dev a chur chun cinn ó mo spás forbartha go gach aonad. Diúltaíodh dó le GATE_CANNOT_BE_SKIPPED, agus níor cuireadh aon rud chun cinn. Insíonn an pláta duit é a chur chun cinn go dtí an chéad chéim eile ina ionad, agus sin an t-aon fhreagra atá ann.

Tá an t-athbhreithniú eisiúna féin, an fhianaise a léann an dara hathbhreithneoir agus na cainéil a roghnaíonn aonaid, i gcaibidil 2.28, Bhur síneadh a eisiúint. Baineann dhá fhíric uaithi anseo, mar múnlaíonn siad an chaoi a bpleanálann sibh ingearach. Ní áirítear an t-údar choíche mar athbhreithneoir, mar sin teastaíonn tríú duine ó fhoireann beirte do gach eisiúint. Agus coinníonn gach timpeallacht an leagan roimhe ar feadh 30 lá, mar sin is athrú athbhreithnithe é dul siar a dhéanann an píblíne i dtimpeall nóiméid.

Pacáiste atá ann cheana a leathnú

Ní thosaíonn gach ingearach ó neamhní. Is féidir le pacáiste oidhreacht a fháil ó cheann eile agus gan ach an rud atá difriúil a chur leis. Is é an pacáiste Banking and payments, a ritheann Larchmont Bank, an sampla is soiléire sa chatalóg. Tosaíonn a léiriú mar seo:

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

Ainmníonn inherits an pacáiste a dtógann sé air. Coinníonn Banking and payments cruth an phacáiste Insurance, a bhraislí comhrá comhroinnte agus a bhunfhocail, agus cuireann sé trí lionsa dá chuid féin leis: Lending decisions, Card disputes agus My account. Is é an tríú heilimint de gach iontráil foclóra exact do théarma nach mór a thaispeáint mar atá sé scríofa, mar shampla APR (ráta céatadáin bliantúil), seachas é a athfhoclú.

Tá rudaí áirithe nach féidir libh a dhéanamh trí oidhreacht. Ní athraíonn pacáiste an bhlaosc, na comhpháirteanna ná na rialacha scríbhneoireachta choíche, mar sin ní féidir le pacáiste linbh stíl nua a chur ar an gconsól. Is lionsa comhroinnte amháin é córas a theastaíonn ó roinnt pacáistí seachas cóip i ngach ceann: freastalaíonn clár na teicneolaíochta seachfhoinsithe ar Insurance agus ar Banking and payments araon. Má theastaíonn lionsa ó bhur bpacáiste linbh atá ann cheana mar lionsa comhroinnte, úsáidigí é in ionad bhur gceann féin a tharraingt.

Leanann ceadúnú an oidhreacht. Ceadúnaítear pacáiste ar bharr Enterprise agus d'fhéadfadh breiseáin a bheith ag teastáil uaidh, agus iompraíonn an doiciméad ceadúnais na spleáchais sin. Teastaíonn Decision rooms agus taifid séalaithe ó Insurance, mar sin teastaíonn an breiseán sin freisin ó chustaiméir a cheadúnaíonn pacáiste a fhaigheann oidhreacht uaidh, agus diúltaíonn an consól ceadúnas a eisiúint a fhágann ar lár é. Teastaíonn an breiseán Mobile apps freisin ó scáileáin fóin pacáiste. Seiceáil slabhra na riachtanas sula ngeallann sibh dáta do chustaiméir.

Lionsa a chur le pacáiste atá seolta cheana

Is í an obair ingearach is lú lionsa nua ar phacáiste nár scríobh sibh. Sé mhí isteach sa phíolóta, theastaigh lionsa dá cuid féin ó fhoireann éileamh muirí Larkfield laistigh de Cold chain: seachráin agus éilimh, gan phointí cumhachta, gan phointí socraithe. Níor bhaineamar le cód an phacáiste. Is ró é lionsa i gclár lionsaí na heagraíochta, ar leis an bpacáiste é, mar sin thosaíomar é ón gconair órga lionsa ar Tosaigh rud éigin nua agus mhúnlaíomar é sa Tógálaí lionsaí i gcoinne an lionsa Cold-chain controller mar bhonn. Baineann an riail chéanna agus a bhain roimhe: is féidir leis an lionsa nua an rud a thaispeánann a bhonn a fholú agus ní féidir leis níos mó a thaispeáint choíche. Sainmhínítear é uair amháin don eagraíocht agus deonaítear é do ról ardáin i ngach aonad. Tarraingítear siar deonú, ní scriostar é choíche, agus déanann an lionsa a thabhairt arís deonú nua, ionas go bhfanann sé inléite cé a bhí ag cén lionsa agus cathain. Comhaireann an clár cé mhéad duine a bhí ag lionsa gach mí, ach ní cé hiad choíche.

Taispeánann an leathanach Lionsaí agus cé a fheiceann iad an toradh mar mhaitrís de lionsa de réir aonaid agus róil, le Cuir leis, Athraigh agus Tarraing siar ar gach cill. Déan réamhamharc ar an lionsa nua mar dhuine sula ndeonaíonn sibh é, díreach mar atá thuas.

Cad a chosain sé, go hionraic

Baineann pacáiste le taifid custaiméara, mar sin déanann an t-ardán rudaí áirithe mall d'aon ghnó, agus ba cheart daoibh pleanáil dóibh seo ón gcéad lá.

  1. Teastaíonn comhaontú úinéir na sonraí ó chóip cheilte gach uair. Thóg ár gceann lá le teacht an chéad uair, mar theastaigh ó Priya an múnla eolais a léamh ar dtús. Tosaigh le sonraí sintéiseacha agus iarr go luath.
  2. Ní féidir leis an údar a eisiúint féin a fhaomhadh, agus téann iarratais as feidhm tar éis 3 lá. Má bhíonn bhur n-athbhreithneoirí gnóthach, fanann bhur n-eisiúint.
  3. Coinnítear siar eisiúint a iarrann níos mó ná an ceann deireanach, mar shampla ríomhphost a sheoladh nó seoladh seachtrach amháin, go dtí go nglacann beirt athbhreithneoirí leis an léiriú níos leithne. Taispeánann Caibidil 2.28, Bhur síneadh a eisiúint, an leathanach Léiriú agus ceadanna a insíonn daoibh roimh ré.
  4. Ní féidir le lionsa an rud a fholaíonn a bhunlionsa a thaispeáint. Má theastaíonn níos mó go fírinneach ó ról, is comhrá le riarthóir na heagraíochta é sin, ní socrú.

Níor sheas aon cheann acu seo inár mbealach faoi dhó. Thóg an dara heisiúint de Cold chain seachtain ón gcéad tiomantas go píolóta Rotterdam, an chuid is mó di na 66 tástáil ag rith i gcoinne trí bhrainse agus beirt ag léamh na fianaise.