Sínigh isteachCuir cruinniú eolais in áirithe

Caibidil 2.19

Na rialacha a fhaigheann gach síneadh le hoidhreacht

Leithlisiú ar thrí ais, ríomhaireacht trí UNO, AI (intleacht shaorga) tríd an ródaire, eochracha faoi úinéireacht na heagraíochta agus seiceálacha ceadúnais. Cad a chiallaíonn gach riail do do chód agus cén geata a fhorfheidhmíonn í, agus cén fáth a bhfaigheann tú le hoidhreacht í in ionad í a scríobh.

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

15 nóiméad le léamh

Ba chugamsa a seoladh an chéad diúltú a sheol mo bhreiseán athbhreithnithe aimhrialtachtaí riamh. Bhí cliant tástála scríofa agam a chuir athbhreithniú nua isteach le hid na heagraíochta sa chorp, de bharr nós ó ardán eile, agus d'fhreagair an breiseán sular rith mo láimhseálaí:

{
  "error": true,
  "code": "TENANT_NOT_A_PARAMETER",
  "message": "The request body names the organisation. Tenancy comes from the token.",
  "resolved": ["tenant", "owner"],
  "missing": [],
  "troubleshooting": ["Remove organizationId from the body. The organisation is read from your sign-in."]
}

Ní mise a scríobh an seiceáil sin. Tháinig sé leis an ngarda scóipe a nascann teimpléad an SDK (tacar forbartha bogearraí) le gach bealach /api, agus scaoileann sé fiú nuair is le glaoiteoir é féin an id sa chorp. Sin é an patrún don chaibidil seo ar fad: líon beag rialacha, gach ceann acu curtha i bhfeidhm ag meicníocht a fhaigheann tú le hoidhreacht, agus geata ag gach ceann acu a chuireann teip ar do thógáil má théann do chód timpeall air. Ar Nexus faigheann do bhreiseán a leithlisiú le hoidhreacht ón ardán, agus déanann na geataí iniúchadh air.

Tá cúig riail ann, agus pléann na hailt thíos iad ceann ar cheann: leithlisiú ar thrí ais; ríomhaireacht nach ritheann ach trí sheoladh UNO; AI (intleacht shaorga) nach dtéann ach tríd an AI Provider Router; eochracha samhla a bhaineann leis an eagraíocht; agus gnéithe ceadúnaithe a sheiceáiltear i gcoinne an cheadúnais. Athluaitear trí cinn acu freisin i ngach forógra in aon bhloc amháin abairtí.

Riail 1: leithlisiú ar thrí ais, ón iarratas fíordheimhnithe

Tá gach léamh agus scríobh i síneadh scóipeáilte ar thrí ais, agus tá gach glao uirlise agus seoladh scile mar an gcéanna.

Ais Colún Freagraíonn Cé chomh daingean is atá an líne
Tionónta organization_id Cén eagraíocht Teorainn dhaingean, nach dtrasnaítear ach trí dheontas inléite amháin atá taifeadta
Úinéir owner_user_id Cén duine laistigh den eagraíocht Príobháideach fiú laistigh d'aon eagraíocht amháin, le haghaidh aon rud pearsanta
Aonad business_unit_id Cén chuid den eagraíocht Claí roghnach laistigh de thionónta

Is í ais an úinéara an ceann a mbíonn dul amú ar dhaoine nua faoi. Is rud pearsanta é bosca poist, agus is amhlaidh atá amharc sábháilte nó graf a dhíorthaítear ó shonraí duine amháin. Ní fheiceann beirt bhall den eagraíocht chéanna, san aonad céanna leis an ról céanna, sraitheanna a chéile atá scóipeáilte don úinéir. Ar dhéantán eagraíochta, ceadú nó taifead cáis mar shampla, is bunús é an t-úinéir ina ionad sin: taifeadann sé cé a ghníomhaigh, agus scóipeáiltear léamha don tionónta ionas go bhfanann an rian iniúchta infheicthe ag na daoine a bhfuil sé de dhíth orthu. Socraíonn tú in aghaidh an tábla cén cineál atá ann, agus ionchódaíonn sraith an stóir é, gan cás speisialta a dhéanamh de i mbealach riamh.

Tagann na haiseanna ón iarratas fíordheimhnithe agus ó áit ar bith eile. Ní féidir le hathróg thimpeallachta iad a sholáthar, ná ní féidir le paraiméadar fiosrúcháin, deighleog conaire, ceanntásc cliaint ná tairiseach tógála é sin a dhéanamh ach oiread. Déanann an SDK deacair an rud mícheart a scríobh: níl paraiméadar eagraíochta ar bith ag resolveScope(identity, options). Tá an eagraíocht taobh istigh de identity, agus ní tháirgeann ach comhartha fíoraithe ceann. Níl aon rud ann chun id a chur tríd.

Sin an fáth a ndiúltaítear do chorp a ainmníonn an tionónta seachas neamhaird a dhéanamh de. Diúltaíonn an garda d'aon cheann de chúig ainm réimse: orgId, organizationId, organization_id, tenant agus tenantId. Múineann réimse a ndéantar neamhaird de go ciúin don ghlaoiteoir go n-oibríonn an réimse. Déanann an chéad ghlaoiteoir tástáil air agus feiceann sé a chuid sonraí féin; seolann an dara ceann id eagraíochta eile. Ainmníonn diúltú ar an gcéad iarratas an conradh sula dtógann aon duine ar an gceann mícheart. Baineann an riail chéanna le inputParams seolta: diúltaítear d'ionchur scile a iompraíonn id eagraíochta ag an seoladh.

Dearbhaítear agus forfheidhmítear ais an aonaid nó ní úsáidtear í. Diúltaíonn bealach a dhearbhaíonn needsUnit: true nuair nach réitíonn an dintiúr aonad, le unit ainmnithe in missing[]. Ná sintéisigh aonad ó fho-fhearann nó ó cheanntásc, agus ná socraigh ceann mar réamhshocrú. Cuireann aonad cumtha claí ar bhealach difriúil ó fhíor-aonaid na heagraíochta, agus nascann sé sraitheanna nár cheart dó.

Diúltaíonn dromchla nach féidir leis an bpreidicáid a chur in iúl

Mura féidir le bealach a rá cén tionónta agus cén t-úinéir lena mbaineann sraith, agus cén t-aonad nuair a bhíonn ceann ag teastáil uaidh, diúltaíonn sé. Níl aon léamh ar fud na heagraíochta mar chúltaca ná aon luach ionadchoinneálaí ann. Is é ionadchoinneálaí an rogha is measa, toisc gur luach é ionadchoinneálaí agus go bhfreagraíonn luachanna do shraitheanna: rinne ródaire uirlisí a shocraigh an tionónta agus an t-úsáideoir araon mar réamhshocrú don teaghrán 'unknown' sonraí ar fud na heagraíochta a riar ar cibé duine a ghlaoigh air. Ar theorainn tionónta, is locht é ?? 'unknown'.

Tá cruth amháin ar an diúltú i ngach áit ar an ardán, agus iompraíonn sé go leor chun go bhféadfaidh cliant an ceartúchán a rindreáil:

{
  "error": true,
  "code": "SCOPE_PREDICATE_MISSING",
  "message": "Request cannot be scoped to a tenant from the presented credential.",
  "resolved": ["tenant", "owner"],
  "missing": ["unit"],
  "troubleshooting": [
    "The credential resolved tenant+owner; this route additionally requires a business unit.",
    "Select a business unit in the client and retry — re-authentication will not change this outcome."
  ]
}

Is é true i gcónaí error. Tagann code ó chatalóg cód an ardáin. Ainmníonn resolved[] na haiseanna a díorthaíodh agus missing[] na cinn a bhí ag teastáil ón mbealach agus nach bhféadfadh sé a fháil. Deir troubleshooting[] cad a cheartódh é i ndáiríre. Ní mhúineann "forbidden" lom aon rud d'aon duine.

Coinnigh 401 agus 403 scartha óna chéile, mar gníomhaíonn cliaint ar bhealach difriúil orthu.

Stádas Brí Cad a dhéanann an cliant
401 Gan fíordheimhniú Sínigh isteach arís
403 Fíordheimhnithe, ach ní féidir an t-iarratas a scóipeáil, nó níl an ceart ag an nglaoiteoir Stopann sé ag ath-iarracht agus athraíonn sé an t-iarratas

Cuireann diúltú scóipe a fhreagraítear mar 401 cliant isteach i lúb sínithe isteach nach féidir le haon síniú isteach críoch a chur léi: caitheann sé an seisiún uaidh agus síníonn sé isteach arís, déanann sé ath-iarracht agus faigheann sé 401 arís, fad is a bhíonn an duine ag breathnú ar rothlóir go deo.

Déanann dhá mheicníocht eile an diúltú iomlán. Taobh istigh de láimhseálaí, is é scopeOf(req) an t-aon bhealach chun an scóip a léamh, agus caitheann sé earráid mura rith an garda. Agus ritheann an garda tar éis parsáil an choirp agus roimh aon láimhseálaí; freagraíonn láimhseálaí a éiríonn insroichte gan an phreideacáid le 500 le MIDDLEWARE_ORDERING_ERROR, d'aon ghnó, ionas go dtuirlingíonn sé i do bhuiséad earráide in ionad i dtuarascáil teagmhais.

Coinníonn an bunachar sonraí an líne chéanna leis féin

Is dhá mheicníocht d'aon dlí amháin iad an claí cóid agus an claí bunachair sonraí, agus faigheann tú an dá cheann.

Cumann gach ráiteas i gcoinne tábla scóipeáilte tenantFence(scope) ón SDK; ní scríobhann tú an phreideacáid de láimh riamh. Ritheann gach ráiteas taobh istigh de withScopedTx freisin, a cheanglaíonn na trí ais don aon idirbheart amháin sin trí fheidhm bhunachair sonraí shingil agus a dhiúltaíonn d'athcheangal (SCOPE_ALREADY_BOUND). Faoi bhun sin, tá slándáil ag leibhéal na sraithe curtha i bhfeidhm ar gach tábla i do scéimre, agus ní féidir leis an ról a nascann do chonair iarratais mar é an tionónta ceangailte a athrú é féin. Diúltaíonn próiseas a nascann mar ról atá in ann slándáil ag leibhéal na sraithe a sheachaint tosú le DB_ROLE_BYPASSES_ISOLATION. Taispeánann Caibidil 2.22, Am rite an bhreiseáin, an cód; taispeánann caibidil 2.21, SDK an Bhreiseáin, conas a rindreáiltear na róil duit.

An t-aon trasnú amháin: deontas taifeadta

Tá bealach amháin díreach trasna na teorann tionónta. Taifeadann an eagraíocht a bhfuil na sraitheanna aici deontas a ainmníonn cén eagraíocht a fhéadfaidh cé na táblaí a léamh, faoi cén comhaontú agus cá fhad. Déanann an bunachar sonraí an léamh inléite amháin, agus scríobhtar gach amharc roimh an léamh, sa dá eagraíocht, de réir id amháin. Ní thrasnaíonn scríobhanna riamh; taistealaíonn obair a thugtar do ghnólacht eile mar theachtaireacht. Ní léann róil an úinéara agus an riarthóra trasna na teorann ar chor ar bith, agus diúltaítear don fhorógra mura gcuireann an ceart a cheadaíonn léamh tras-eagraíochta cosc orthu. Ní fhaigheann breiseán a bhfuil bealach eile trasna uaidh ceann ar bith.

Riail 2: ritheann an ríomhaireacht go léir trí sheoladh UNO

Is é UNO, an t-inneall sreafa oibre, an t-aon chonair ríomhaireachta. Ní fhaigheann do chód soláthraí samhla ná inneall go díreach riamh, ná scuaine ná óstach sreafa oibre ach oiread. Seolann tú clúdach amháin chuig an gcríochphointe seolta agus faigheann tú 202 le haitheantóirí ar ais; tagann an toradh trí vótaíocht nó trí aisghlao.

Leanann trí nós as sin, agus tá na trí cinn acu sa teimpléad cheana féin.

  • Is le comhad amháin an URL seolta. Léitear UNO_DISPATCH_URL uair amháin sa lódálaí cumraíochta agus ní mór dó a bheith ina sheoladh laistigh den bhraisle. Diúltaítear do cheann poiblí ag am tosaithe, toisc nach bhfágann aon rud an tsuiteáil.
  • Liosta ceadaithe dúnta amháin de na rudaí a fhéadfaidh an dromchla seo a sheoladh. Is seachfhreastalaí ilchuspóireach do gach scil sa chlárlann é cúlra a sheolfaidh aon id scile a thugann brabhsálaí dó, lena n-áirítear scileanna breiseán eile agus scileanna a chaitheann buiséad samhla duine eile. Is tairiseach ar leibhéal an mhódúil de chineálacha poist le spás ainmneacha é an liosta, ní athróg thimpeallachta riamh. Diúltaítear d'id nach bhfuil air le SKILL_NOT_ALLOWED.
  • Athsheiceáil cad a thagann ar ais. Nuair a léann tú post ar ais, déanann cliant an SDK comparáid idir organization_id na sraithe a tugadh ar ais agus tionónta an ghlaoiteora ar do thaobh féin den ghlao líonra. Is gnás é claí nach bhfuil ann ach ar an taobh eile de ghlao.

Riail 3: téann gach AI tríd an Ródaire Soláthraí AI

Ní dhéanann breiseán glao ar bith ar shamhail, in aon áit. Níl aon SDK soláthraí in package.json, níl aon eochair shamhla sa timpeallacht agus níl aon athsheachadán ann. Is é an ródaire amháin a choinníonn dintiúr soláthraí na heagraíochta agus a dhéanann an cinneadh deiridh maidir le soláthraí agus samhail.

Is é an rud is féidir le breiseán a dhéanamh ná mianta a chur in iúl, ag am clárúcháin, ar shraith chlárlainne scil an fhorógra:

{
  "execution_config_skill": {
    "preferredProvider": "gemini",
    "preferredModel": "gemini-3.5-flash",
    "capabilityProfile": { "needsToolUse": true, "minContextWindow": 200000 }
  }
}

Ní chomhlíonann an ródaire mian ach amháin nuair a bhíonn an soláthraí sin cumasaithe agus dintiúraithe ag an eagraíocht. Seachas sin cuireann sé ceann eile ina ionad, ó linn na heagraíochta féin. Ní roghnaíonn capabilityProfile riamh; scagann sé, agus is srian dlínse daingean é a réimse dataResidency a shásaíonn nó a dhiúltaíonn an ródaire. Is é na nithe seo go léir a fhágáil ar lár an réamhshocrú ceart don chuid is mó de na scileanna: is iad sannacháin róil na heagraíochta féin a chinneann ansin, agus is í an eagraíocht atá ag íoc.

Tagann dhá chineál diúltaithe ar ais, agus ciallaíonn siad rudaí an-difriúla.

Cód Stádas Cad is brí leis
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER 403 Rinne do chód iarracht glaoch ar an ródaire é féin. Stop: is é seo an t-alt ag diúltú d'aon ghnó, agus ní féidir ath-iarracht a dhéanamh air
MODEL_CAPABILITY_UNAVAILABLE 422 Níl samhail ag aon soláthraí cumasaithe a shásaíonn an phróifíl. Maolaigh an phróifíl, nó cumasaíonn an eagraíocht soláthraí cumasach
NO_PROVIDER_FOR_ROLE 422 Níl ródú cumraithe ag an eagraíocht don ról seo. Taispeáin téacs leighis an ródaire don duine

Is ar an scáileán is ceart don dara péire a bheith, ní i loga. Níl aon samhail réamhshocraithe ná aon soláthraí cúltaca ann: teipeann go glórach ar ról nach bhfuil socraithe ag an eagraíocht, le habairt a deir cad ba cheart a chumrú.

Is é an t-aon léamh amháin is féidir le breiseán a dhéanamh ar an ródaire ná effectiveRoute() ó runtime/ai-route. Freagraíonn sé cén soláthraí agus cén tsamhail a roghnódh an ródaire don eagraíocht atá sínithe isteach gan iarratas AI a sheoladh, agus tugann sé diúltú an ródaire ar ais i bhfocail nuair nach bhfuil aon samhail ann. Taispeánann Caibidil 2.22, Am rite an bhreiseáin, é.

Cuireann an dréimire iontaoibhe líne amháin eile leis. Ní fhéadfaidh ach breiseáin core agus verified an dá shraith scile forógra a shroicheann an ródaire, tool_using agus llm_only, a dhearbhú. Déanann gach duine eile bróicéireacht ar obair chinnteach agus ligeann siad don ardán an chuid a shroicheann an tsamhail a dhéanamh.

Riail 4: is leis an eagraíocht na heochracha

Tugann gach eagraíocht a cuntas agus a heochair sholáthraí féin léi, agus íocann sí a bille féin. Maireann an eochair i linn soláthraithe AI na heagraíochta, á bainistiú ag a riarthóirí féin ón gconsól, agus réitíonn an ródaire í ag am an ghlao. Níl aon eochair ardáin chomhroinnte taobh thiar de thionónta, mar sin ní chaitheann aon eagraíocht buiséad ceann eile.

I gcás síneadh ciallaíonn sé sin trí rud.

  • Ní choinníonn tú eochair shamhla riamh, bíodh sé i gcód nó i gcumraíocht nó i stór rúnda. Cuireann an geata no-credentials teip ar an tógáil má tá ceann inléite, agus diúltaíonn an lódálaí cumraíochta tosú má tá ceann i láthair.
  • Ní dhéanann tú eochracha eagraíochta a áireamh riamh. Má cheapann do bhreiseán go gcaithfidh sé é sin a dhéanamh, tá an riachtanas san áit mhícheart.
  • Ní fhaigheann eagraíocht gan eochair aon fhreagraí AI. Is staid í sin a bhfuiltear ag súil léi agus scáileán ceart aici. Ainmnigh an ról atá ar iarraidh agus luaigh an leigheas, ansin dírigh an duine chuig a socruithe soláthraí. Ná rindreáil mar thoradh folamh é.

Riail 5: seiceáiltear gnéithe ceadúnaithe i gcoinne an cheadúnais

Tagann an méid a fhéadfaidh suiteáil a úsáid thar urlár an Phobail ó áit amháin: an doiciméad ceadúnais a shíníonn Adverant, arna fhíorú ar an tsuiteáil le heochracha poiblí amháin. Ní chinneann do shíneadh riamh ó aon rud níos laige, amhail ainm plean i gcomhartha nó bratach i gcumraíocht.

I mbreiseán, is é an bealach is simplí chun gné a cheangal leis an gceadúnas ná ar an gceart a chosnaíonn í. Is féidir le ceart i gclár rights an fhorógra gné licence a ainmniú:

"rights": {
  "evidence.export": {
    "summary": "Export the evidence pack for an inspection.",
    "roles": ["owner", "admin", "member"],
    "licence": "compliance-packs"
  }
}

Diúltaítear le LICENCE_LOCKED (403) do cibé duine a ghlaonn ar bhealach atá cosanta ag an gceart sin, is cuma cé na róil agus na suíocháin atá acu, nuair nach n-iompraíonn ceadúnas na heagraíochta compliance-packs. Ainmníonn an diúltú an ghné agus cad a iompraíonn í, agus deir sé cé is féidir í a chasadh air.

Tá staid an cheadúnais tábhachtach freisin. Fad is atá ceadúnas bailí nó ina fhuinneog rabhaidh, oibríonn gnéithe ceadúnaithe, agus leanann siad orthu ag obair sa tréimhse chairde, agus taispeánann an tréimhse chairde an fógra LICENCE_IN_GRACE. Nuair a bhíonn ceadúnas imithe thar an tréimhse chairde cuireann sé srian i bhfeidhm: leanann obair reatha agus léamha ar aghaidh, agus leanann easpórtálacha agus nuashonruithe slándála ar aghaidh freisin, ach diúltaítear le LICENCE_LOCKED do rud éigin nua a chruthú faoi ghné cheadúnaithe. Tóg do chonairí cruthaithe ag súil leis an bhfreagra sin.

Nuair a fhiafraíonn do bhreiseán den tseiceáil teidil an bhfuil gné ag eagraíocht, faigheann sé fíorasc, ní luach Boole lom riamh. Is fíricí difriúla le cóid dhifriúla iad "Not reachable" agus "reachable and no": ENTITLEMENT_UNREACHABLE (502) agus ENTITLEMENT_DENIED (403). Ní mór do bhlip insroichteachta gan gach custaiméir a íosghrádú go ciúin chuig an urlár saor in aisce riamh.

Forógra agus ceadanna
Forógra agus ceadanna
Déanann Forógra agus ceadanna comparáid idir an méid a dhearbhaíonn eisiúint agus an ceann deireanach. Anseo cuireann leagan 0.4.0 seoladh ríomhphoist agus seoladh amháin lasmuigh leis, mar sin coinnítear an eisiúint siar le MANIFEST_SCOPE_WIDENED go dtí go n-aontaíonn beirt athbhreithneoirí agus an t-oifigeach comhlíontachta.

Athráiteann an follas an dlí

Iompraíonn gach forógra v2 bloc architecture le trí abairt riachtanacha, agus socraíonn an bailíochtóir a bhfriotal. I mbreiseán a thógann tú do do shuiteáil féin léitear iad mar seo:

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

Seiceáiltear na habairtí sin. Bheadh breiseán ar aontaigh a fhorógra leis na dlíthe fad is a ghlaoigh a chód ar sholáthraí samhla ag insint bréige ina chonradh féin, agus tá na geataí ann chun an bhréag a dhéanamh inbhraite.

Na geataí a fhorfheidhmíonn gach riail

Seolann an SDK dhá gheata cloí is fiche mar aon ordú amháin, nexus-gates. Déanann Caibidil 2.21, SDK an Bhreiseáin, cur síos ar gach ceann acu. Anseo tá siad grúpáilte de réir na rialach a choinníonn siad.

Riail Geataí Cad a chuireann teip ar an tógáil
Leithlisiú i sraith na mbealaí scope-adherence, one-fence, rights-register, crud-adherence Bealach /api gan an garda scóipe, dara preideacáid tionónta lámhscríofa, bealach scóipe gan aon cheart, bealach athraitheach nach n-ainmníonn a cheart aon rud
Leithlisiú in SQL sql-fence, no-set-config Ráiteas ar thábla scóipeáilte gan an claí; cód breiseáin ag ceangal socrú an tionónta é féin
Leithlisiú sa bhunachar sonraí migrations-are-scoped, rls-present, db-role-honest Tábla a bhfuil ais nó eochair le tionónta ar tosach in easnamh air, tábla gan slándáil éigeantach ag leibhéal na sraithe, conair iarratais ag nascadh mar an t-úinéir nó mar fhor-úsáideoir
An t-aon trasnú amháin grants-declared Tábla a deonaíodh in imirce nach ndearbhaíonn an forógra, nó suíochán léite ar tugadh pribhléidí dó de láimh
Ríomhaireacht trí UNO no-direct-compute Gabháil dhíreach chuig soláthraí samhla nó inneall, nó chuig scuaine nó óstach sreafa oibre; dara léitheoir ar an URL seolta
AI agus eochracha no-credentials Dintiúr soláthraí samhla inléite sa stór nó sa timpeallacht
An conradh dearbhaithe api-contract, platform-clients, declared-input Bealach cláraithe ach gan a bheith dearbhaithe, nó dearbhaithe ach gan a bheith cláraithe; cliant ardáin iompórtáilte ach gan a bheith ainmnithe

Tá féin-thástáil ag gach geata a chruthaíonn go dteipeann air ar fheistiú a tógadh chun é a thuisligh. Ritheann npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test iad go léir, agus tá geata atá stoptha de bheith ag teip ar a fheistiú féin stoptha de bheith ag obair.

Cad is féidir le feidhmchlár a shroicheadh
Cad is féidir le feidhmchlár a shroicheadh
Liostaíonn Cad is féidir le feidhmchlár a shroicheadh gach seoladh lasmuigh atá dearbhaithe ag feidhmchlár agus ar cheadaigh an t-oifigeach comhlíontachta é. Stoptar glao chuig seoladh nár dhearbhaigh aon duine agus comhairtear é sula bhfágann aon rud.

Sula n-iarrann tú athbhreithniú

Seo é an liosta a shiúlaim sula n-iarraim ar chomhghleacaí athbhreithniú a dhéanamh ar bhreiseán. Is rud é gach líne ar sheol athbhreithneoir ag Corrán Orbital ar ais chugam uair amháin ar a laghad.

  1. Cláraíonn gach bealach /api an garda scóipe, agus is iad na bealaí gan ainm amháin ná conairí beachta a dearbhaíodh auth: public le allowAnonymous: true.
  2. Ainmníonn gach bealach ar a bhfreastalaíonn an garda scóipe right ó chlár an fhorógra, agus ní iompraíonn aon láimhseálaí seiceáil chearta dá chuid féin.
  3. Ní léann aon láimhseálaí eagraíocht, duine ná aonad ón gcorp, ón bhfiosrúchán ná ó cheanntásc HTTP.
  4. Téann gach ráiteas ar thábla scóipeáilte trí tenantFence taobh istigh de withScopedTx, agus ní ghlaonn aon rud sa stór ar set_config.
  5. Tá na trí cholún aise ag gach tábla, eochair phríomhúil a thosaíonn le organization_id, agus eochracha coigríche ilchodacha a iompraíonn an tionónta.
  6. Léitear an URL seolta i gcomhad amháin, agus is tairiseach de chineálacha poist le spás ainmneacha é an liosta ceadaithe seolta.
  7. Ní labhraíonn aon rud in package.json le soláthraí samhla, agus ní luíonn aon eochair sa timpeallacht.
  8. Ainmníonn gach gné nach n-iompraíonn ach roinnt ceadúnas a licence ar an gceart a chosnaíonn í.
  9. Tá npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test glas, agus tá npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json mar an gcéanna.

Má sheasann na naoi gcinn go léir, baineann an t-athbhreithniú le do tháirge, arb é an áit ar cheart d'am athbhreithneora dul.

Cén fáth a bhforfheidhmíonn an t-ardán na rialacha seo

Ba ghnás in áit éigin tráth gach riail thuas, agus theip ar gach gnás ar an mbealach céanna: bhí na bealaí a chuimhnigh air go breá agus ba é an ceann a rinne dearmad air an teagmhas. Seachnaíodh claí aonaid ghnó a cuireadh i bhfeidhm mar bhogearraí idirmheánacha roghnacha ar shé bhealach neamhspleácha, gach ceann acu ina bhealach nár roghnaigh isteach riamh. Rinne athróg thimpeallachta a d'athscríobh céannacht tionónta 1,406 teagmhálaí de chuid eagraíochta eile a riar ar eagraíocht amháin, agus bhí cuma cheart air san athbhreithniú toisc go raibh sé ceart don phod ar scríobhadh dó é.

Mar sin cuireann an t-ardán an phreideacáid san áit a dtéann gach dromchla tríthi cheana féin: sa gharda scóipe agus san fheidhm chlaí, i bhfillteán an idirbhirt agus sa tslándáil éigeantach ag leibhéal na sraithe, agus sa chliant seolta. Déanann geata gach bealach agus ráiteas agus gach iompórtáil a áireamh ansin, agus cuireann sé teip ar an tógáil nuair a shroicheann ceann acu tábla scóipeáilte nó samhail nó inneall ríomhaireachta gan dul trí na meicníochtaí sin. Is é costas an deartha sin ná go mothaíonn do chéad bhreiseán srianta. Is é an brabús ná go bhfuil an míliú breiseán leithlisithe gan a fhios ag a údar go bhfuil an ghné ann, toisc nach bhfuil aon chonair eile chuig na sonraí ar féidir leis a ghlacadh.

Tá teorainn mhacánta leis seo go léir. Cruthaíonn na geataí go dtéann do chód trí na meicníochtaí; ní féidir leo a chruthú go bhfuil loighic do tháirge ceart. Is féidir le bealach a scóipeálann fiosrúchán go ceart chuig sraitheanna an úinéara na sraitheanna míchearta a thaispeáint don úinéir ceart fós. Ionsaíonn an tacar tástála leithlisithe i gcaibidil 2.22, Am rite an bhreiseáin, gach bealach mar eagraíocht eile agus mar chomhghleacaí, agus gach claí bainte de réir a chéile, agus sin í an tástáil a rithfinn sula mbeadh muinín agam as mo léamh féin ar aon chuid de seo.