Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.19
Rregullat që trashëgon çdo zgjerim
Izolimi në tre boshte, llogaritja përmes UNO, AI (inteligjenca artificiale) përmes rrugëzuesit, çelësat në pronësi të organizatës dhe kontrollet e licencës. Çfarë do të thotë çdo rregull për kodin tuaj dhe cila portë e zbaton atë, dhe pse e trashëgoni në vend që ta shkruani.
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Refuzimi i parë që shtojca ime e rishikimit të anomalive dërgoi ndonjëherë ishte për mua. Kisha shkruar një klient testimi që postonte një rishikim të ri me id-në e organizatës në trupin e kërkesës, nga zakoni prej një platforme tjetër, dhe shtojca u përgjigj para se të ekzekutohej trajtuesi im:
{
"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."]
}Nuk e kisha shkruar unë atë kontroll. Ai erdhi me mbrojtësin e fushëveprimit që shablloni i SDK-së (kompleti i zhvillimit të softuerit) e lidh në çdo rrugë /api, dhe aktivizohet edhe kur id-ja në trupin e kërkesës është e vetë thirrësit. Ky është modeli për të gjithë këtë kapitull: një numër i vogël rregullash, secili i zbatuar nga një mekanizëm që ju e trashëgoni, secili me një portë kontrolli që e dështon ndërtimin tuaj nëse kodi juaj e anashkalon atë. Në Nexus, shtojca juaj e trashëgon izolimin e saj nga platforma dhe portat e kontrollit e auditojnë atë.
Ka pesë rregulla, dhe seksionet më poshtë i trajtojnë ato me radhë: izolimi në tre boshte; llogaritja që ekzekutohet vetëm përmes dërgimit UNO; AI (inteligjenca artificiale) që kalon vetëm përmes Ruterit të Ofruesve të AI; çelësat e modeleve që i përkasin organizatës; dhe veçoritë e licencuara të kontrolluara kundrejt licencës. Çdo manifest gjithashtu riformulon tre prej tyre në një bllok fjalish.
Rregulli 1: izolimi në tre boshte, nga kërkesa e autentifikuar
Çdo lexim dhe shkrim në një zgjerim kufizohet në fushëveprim në tre boshte, dhe po ashtu edhe çdo thirrje mjeti dhe dërgim aftësie.
| Boshti | Kolona | Përgjigjet | Sa i fortë është kufiri |
|---|---|---|---|
| Qiramarrësi (Tenant) | organization_id |
Cila organizatë | Një kufi i fortë, që kalohet vetëm përmes një autorizimi të regjistruar vetëm për lexim |
| Pronari | owner_user_id |
Cili person brenda organizatës | Private edhe brenda një organizate, për çdo gjë personale |
| Njësia | business_unit_id |
Cila pjesë e organizatës | Një gardh opsional brenda një qiramarrësi |
Boshti i pronarit është ai që fillestarët e ngatërrojnë. Një kuti postare është personale, dhe po ashtu është edhe një pamje e ruajtur ose një grafik i nxjerrë nga të dhënat e një personi. Dy anëtarë të së njëjtës organizatë, në të njëjtën njësi me të njëjtin rol, nuk i shohin rreshtat e njëri-tjetrit të kufizuar sipas pronarit. Në një artefakt organizate, si për shembull një miratim ose një regjistër rasti, pronari shërben si prejardhje: ai regjistron se kush veproi, dhe leximet kufizohen te qiramarrësi në mënyrë që gjurma e auditimit të mbetet e dukshme për njerëzit që kanë nevojë për të. Ju vendosni për çdo tabelë se cila lloj është, dhe shtresa e depove e kodon atë, kurrë si një rast të veçantë në një rrugë.
Boshtet vijnë nga kërkesa e autentifikuar dhe nga asnjë vend tjetër. Një variabël mjedisi nuk mund t'i furnizojë ato, dhe as një parametër pyetësori, një segment shtegu, një kokë klienti apo një konstante ndërtimi. SDK-ja e bën të vështirë shkrimin e gjësë së gabuar: resolveScope(identity, options) nuk ka fare parametër organizate. Organizata është brenda identity, dhe vetëm një token i verifikuar prodhon një të tillë. Nuk ka asgjë përmes së cilës të kalohet një id.
Kjo është arsyeja pse një trup kërkese që emërton qiramarrësin refuzohet në vend që të injorohet. Mbrojtësi refuzon cilindo nga pesë emrat e fushave: orgId, organizationId, organization_id, tenant dhe tenantId. Një fushë e injoruar në heshtje i mëson thirrësit se fusha funksionon. Thirrësi i parë e teston atë dhe sheh të dhënat e veta; i dyti dërgon id-në e një organizate tjetër. Refuzimi që në kërkesën e parë e përcakton kontratën përpara se dikush të ndërtojë mbi atë të gabuarën. I njëjti rregull vlen edhe për inputParams e një dërgimi: një hyrje e një aftësie që mbart një id organizate refuzohet në momentin e dërgimit.
Boshti i njësisë ose deklarohet dhe zbatohet, ose nuk përdoret. Një rrugë që deklaron needsUnit: true refuzon kur kredenciali nuk zgjidh një njësi, me unit të emërtuar në missing[]. Mos sintetizoni një njësi nga një nëndomen ose një kokë, dhe mos caktoni një si parazgjedhje. Një njësi e sajuar krijon kufij ndryshe nga njësitë reale të organizatës dhe bashkon rreshta që nuk duhet t'i bashkojë.
Një sipërfaqe që nuk mund të shprehë kallëzuesin refuzon
Nëse një rrugë nuk mund të thotë se cilit qiramarrës dhe pronar i përket një rresht, dhe cilës njësi kur i nevojitet një e tillë, ajo refuzon. Nuk ka lexim në shkallë organizate si zgjidhje rezervë dhe as vlerë mbajtëse vendi. Një mbajtës vendi është opsioni më i keq, sepse një mbajtës vendi është një vlerë dhe vlerat përputhen me rreshtat: një ruter mjetesh që caktonte si parazgjedhje si qiramarrësin ashtu edhe përdoruesin me vargun 'unknown' i shërbeu të dhëna në shkallë organizate kujtdo që e thirri atë. Në një kufi qiramarrësi, ?? 'unknown' është një defekt.
Refuzimi ka një formë të vetme kudo në platformë, dhe mbart mjaftueshëm informacion që një klient të shfaqë rregullimin:
{
"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."
]
}error është gjithmonë true. code vjen nga katalogu i kodeve të platformës. resolved[] emërton boshtet që u nxorën dhe missing[] ato që rrugës i nevojiteshin dhe nuk mundi t'i merrte. troubleshooting[] thotë se çfarë do ta rregullonte në të vërtetë. Një "forbidden" e thjeshtë nuk i mëson askujt asgjë.
Mbajini 401 dhe 403 të ndara, sepse klientët veprojnë ndryshe ndaj tyre.
| Statusi | Kuptimi | Çfarë bën klienti |
|---|---|---|
| 401 | I paautentifikuar | Identifikohet përsëri |
| 403 | I autentifikuar, por kërkesa nuk mund të kufizohet në fushëveprim, ose thirrësit i mungon e drejta | Ndalon riprovimin dhe ndryshon kërkesën |
Një refuzim fushëveprimi i përgjigjur si 401 e fut klientin në një cikël identifikimi që asnjë identifikim nuk mund ta përfundojë: ai e hedh poshtë sesionin dhe identifikohet përsëri, riprovon dhe merr përsëri 401, ndërsa personi sheh një rrotullues ngarkimi përgjithmonë.
Dy mekanizma të tjerë e bëjnë refuzimin të plotë. Brenda një trajtuesi, scopeOf(req) është e vetmja mënyrë për të lexuar fushëveprimin, dhe ai gjeneron një përjashtim nëse mbrojtësi nuk u ekzekutua. Dhe mbrojtësi ekzekutohet pas analizimit të trupit të kërkesës dhe përpara çdo trajtuesi; një trajtues që bëhet i arritshëm pa predikatin përgjigjet me 500 me MIDDLEWARE_ORDERING_ERROR, qëllimisht, në mënyrë që të bjerë në buxhetin tuaj të gabimeve në vend të një raporti incidenti.
Baza e të dhënave mban të njëjtën vijë më vete
Gardhi i kodit dhe gardhi i bazës së të dhënave janë dy mekanizma për një ligj të vetëm, dhe ju i merrni të dy.
Çdo deklaratë kundrejt një tabele me fushëveprim të kufizuar kompozon tenantFence(scope) nga SDK-ja; ju kurrë nuk e shkruani predikatin me dorë. Çdo deklaratë gjithashtu ekzekutohet brenda withScopedTx, e cila lidh të tre boshtet për atë transaksion të vetëm përmes një funksioni të vetëm të bazës së të dhënave dhe refuzon një lidhje të dytë (SCOPE_ALREADY_BOUND). Nën të, çdo tabelë në skemën tuaj ka sigurinë në nivel rreshti të detyruar, dhe roli me të cilin lidhet shtegu i kërkesës suaj nuk mund ta ndryshojë vetë qiramarrësin e lidhur. Një proces që lidhet si një rol i aftë për të anashkaluar sigurinë në nivel rreshti refuzon të niset me DB_ROLE_BYPASSES_ISOLATION. Kapitulli 2.22, Mjedisi i ekzekutimit të shtojcave, tregon kodin; kapitulli 2.21, SDK-ja e Shtojcave, tregon se si gjenerohen rolet për ju.
Kalimi i vetëm: një leje e regjistruar
Ka saktësisht një mënyrë për të kaluar kufirin e qiramarrësit. Organizata që mban rreshtat regjistron një autorizim duke emërtuar se cila organizatë mund të lexojë cilat tabela, nën cilën marrëveshje dhe për sa kohë. Baza e të dhënave e bën leximin vetëm për lexim, dhe çdo shikim shkruhet përpara leximit, në të dyja organizatat, vetëm me id. Shkrimet nuk e kalojnë kurrë kufirin; puna që i dorëzohet një firme tjetër udhëton si mesazh. Rolet e pronarit dhe administratorit nuk lexojnë kurrë përtej kufirit, dhe manifesti refuzohet nëse e drejta që lejon një lexim ndër-organizativ nuk i ndalon ato. Një shtojcë që dëshiron një mënyrë tjetër kalimi nuk e merr atë.
Rregulli 2: e gjithë llogaritja ekzekutohet përmes dërgimit UNO
UNO, motori i rrjedhës së punës, është i vetmi shteg llogaritjeje. Kodi juaj nuk thërret kurrë drejtpërdrejt një ofrues modeli apo një motor, dhe as një radhë apo një strehues të rrjedhës së punës. Ju dërgoni një zarf të vetëm në pikën fundore të dërgimit dhe merrni mbrapsht 202 me identifikues; rezultati mbërrin me pyetje periodike (polling) ose me thirrje kthimi (callback).
Prej këtej rrjedhin tre zakone, dhe shablloni i ka tashmë të treja.
- Një skedar i vetëm zotëron URL-në e dërgimit.
UNO_DISPATCH_URLlexohet një herë në ngarkuesin e konfigurimit dhe duhet të jetë një adresë brenda klasterit. Një adresë publike refuzohet në nisje, sepse asgjë nuk del jashtë instalimit. - Një listë e mbyllur lejimesh për atë që kjo sipërfaqe mund të dërgojë. Një prapavijë që dërgon çdo id aftësie që i jep një shfletues është një ndërmjetës (proxy) me qëllim të përgjithshëm për çdo aftësi në regjistër, përfshirë aftësitë e shtojcave të tjera dhe aftësitë që shpenzojnë buxhetin e modelit të dikujt tjetër. Lista është një konstante në nivel moduli e llojeve të punëve me hapësirë emrash, kurrë një variabël mjedisi. Një id që nuk është në të refuzohet me
SKILL_NOT_ALLOWED. - Rikontrolloni atë që kthehet. Kur lexoni mbrapsht një punë, klienti i SDK-së krahason
organization_ide rreshtit të kthyer me qiramarrësin e thirrësit në anën tuaj të thirrjes së rrjetit. Një gardh që ekziston vetëm në anën tjetër të një thirrjeje është thjesht një konventë.
Rregulli 3: e gjithë AI kalon përmes rrugëzuesit të ofruesve të AI
Një shtojcë nuk bën asnjë thirrje drejt një modeli, askund. Nuk ka SDK ofruesi në package.json, asnjë çelës modeli në mjedis dhe asnjë rele. Vetëm ruteri mban kredencialin e ofruesit të organizatës dhe merr vendimin përfundimtar për ofruesin dhe modelin.
Ajo që një shtojcë mund të bëjë është të shprehë dëshira, në kohën e regjistrimit, në rreshtin e regjistrit të aftësisë së manifestit:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"preferredModel": "gemini-3.5-flash",
"capabilityProfile": { "needsToolUse": true, "minContextWindow": 200000 }
}
}Ruteri e respekton një dëshirë vetëm kur organizata e ka atë ofrues të aktivizuar dhe të pajisur me kredenciale. Përndryshe, ai bën zëvendësim nga grupi i vetë organizatës. capabilityProfile nuk përzgjedh kurrë; ai filtron, dhe fusha e tij dataResidency është një kufizim i fortë juridiksional që ruteri ose e plotëson ose e refuzon. Lënia jashtë e të gjitha këtyre është parazgjedhja e duhur për shumicën e aftësive: caktimet e roleve të vetë organizatës vendosin më pas, dhe organizata është ajo që paguan.
Kthehen dy lloje refuzimesh, dhe ato kanë kuptime shumë të ndryshme.
| Kodi | Statusi | Çfarë do të thotë |
|---|---|---|
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER |
403 | Kodi juaj u përpoq të thërriste vetë ruterin. Ndaloni: kjo është pika e bashkimit që refuzon sipas dizajnit, dhe nuk mund të riprovohet |
MODEL_CAPABILITY_UNAVAILABLE |
422 | Asnjë ofrues i aktivizuar nuk ka një model që plotëson profilin. Zbuteni profilin, ose organizata aktivizon një ofrues të aftë |
NO_PROVIDER_FOR_ROLE |
422 | Organizata nuk ka konfiguruar rrugëzimin për këtë rol. Shfaqini personit tekstin e korrigjimit të ruterit |
Çifti i dytë i përket ekranit, jo një regjistri (log). Nuk ka model të parazgjedhur dhe as ofrues rezervë: një rol që organizata nuk e ka konfiguruar dështon hapur, me një fjali që thotë se çfarë duhet konfiguruar.
I vetmi lexim që një shtojcë mund t'i bëjë ruterit është effectiveRoute() nga runtime/ai-route. Ai përgjigjet se cilin ofrues dhe model do të zgjidhte ruteri për organizatën e identifikuar pa dërguar një kërkesë AI, dhe kthen refuzimin e ruterit me fjalë kur nuk ka model. Kapitulli 2.22, Mjedisi i ekzekutimit të shtojcave, e tregon atë.
Shkalla e besimit shton edhe një rresht tjetër. Vetëm shtojcat core dhe verified mund të deklarojnë dy nivelet e aftësive të manifestit që arrijnë ruterin, tool_using dhe llm_only. Të gjithë të tjerët ndërmjetësojnë punë deterministe dhe ia lënë platformës pjesën që arrin modelin.
Rregulli 4: çelësat i përkasin organizatës
Çdo organizatë sjell llogarinë dhe çelësin e vet të ofruesit, dhe paguan faturën e vet. Çelësi qëndron në grupin e ofruesve të AI të organizatës, i menaxhuar nga administratorët e saj nga konsola, dhe ruteri e zgjidh atë në kohën e thirrjes. Nuk ka çelës të përbashkët platforme pas një qiramarrësi, kështu që asnjë organizatë nuk shpenzon buxhetin e një tjetre.
Për një zgjerim kjo do të thotë tre gjëra.
- Ju kurrë nuk mbani një çelës modeli, qoftë në kod, në konfigurim apo në një depo sekretesh. Porta e kontrollit
no-credentialse dështon ndërtimin nëse një i tillë është i lexueshëm, dhe ngarkuesi i konfigurimit refuzon të niset nëse një i tillë është i pranishëm. - Ju kurrë nuk i listoni çelësat e një organizate. Nëse shtojca juaj mendon se ka nevojë ta bëjë këtë, kërkesa është në vendin e gabuar.
- Një organizatë pa çelës nuk merr përgjigje nga AI. Kjo është një gjendje e pritshme me një ekran real. Emërtoni rolin që mungon dhe citoni korrigjimin, pastaj drejtojeni personin te cilësimet e ofruesit të tij. Mos e shfaqni atë si një rezultat bosh.
Rregulli 5: veçoritë e licencuara kontrollohen kundrejt licencës
Ajo që një instalim mund të përdorë përtej nivelit bazë Community vjen nga një vend i vetëm: dokumenti i licencës që nënshkruan Adverant, i verifikuar në instalim vetëm me çelësa publikë. Zgjerimi juaj nuk vendos kurrë nga diçka më e dobët, siç është emri i një plani në një token ose një flamur në konfigurim.
Në një shtojcë, mënyra më e thjeshtë për të lidhur një veçori me licencën është te e drejta që e mbron atë. Një e drejtë në regjistrin rights të manifestit mund të emërtojë një veçori licence:
"rights": {
"evidence.export": {
"summary": "Export the evidence pack for an inspection.",
"roles": ["owner", "admin", "member"],
"licence": "compliance-packs"
}
}Kushdo që thërret një rrugë të mbrojtur nga ajo e drejtë refuzohet me LICENCE_LOCKED (403), pavarësisht roleve dhe vendeve që mban, kur licenca e organizatës nuk e përmban compliance-packs. Refuzimi emërton veçorinë dhe çfarë e përmban atë, dhe thotë se kush mund ta aktivizojë.
Gjendja e licencës ka gjithashtu rëndësi. Ndërsa një licencë është e vlefshme ose në dritaren e saj të paralajmërimit, veçoritë e licencuara funksionojnë, dhe ato vazhdojnë të funksionojnë në periudhën e mirëkuptimit (grace period), dhe kjo periudhë shfaq njoftimin LICENCE_IN_GRACE. Pasi një licencë e ka kaluar periudhën e mirëkuptimit, ajo kufizohet: puna në ekzekutim dhe leximet vazhdojnë, dhe po ashtu edhe eksportet dhe përditësimet e sigurisë, por krijimi i diçkaje të re nën një veçori të licencuar refuzohet me LICENCE_LOCKED. Ndërtoni shtigjet tuaja të krijimit duke pritur atë përgjigje.
Kur shtojca juaj pyet kontrollin e të drejtave të përfitimit nëse një organizatë zotëron një veçori, ajo merr një verdikt, kurrë një vlerë të thjeshtë booleane. "E paarritshme" dhe "e arritshme dhe jo" janë fakte të ndryshme me kode të ndryshme: ENTITLEMENT_UNREACHABLE (502) dhe ENTITLEMENT_DENIED (403). Një ndërprerje e përkohshme e arritshmërisë nuk duhet kurrë të zbresë në heshtje çdo klient në nivelin bazë falas.
MANIFEST_SCOPE_WIDENED derisa dy rishikues dhe zyrtari i përputhshmërisë të bien dakord.Manifesti ripohon ligjin
Çdo manifest v2 mbart një bllok architecture me tre fjali të detyrueshme, dhe validuesi fikson formulimin e tyre. Në një shtojcë që ndërtoni për instalimin tuaj, ato lexojnë:
"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."
}Ato fjali kontrollohen. Një shtojcë, manifesti i së cilës binte dakord me ligjet ndërsa kodi i saj thërriste një ofrues modeli, do të gënjente në kontratën e vet, dhe portat e kontrollit ekzistojnë për ta bërë gënjeshtrën të zbulueshme.
Portat që zbatojnë çdo rregull
SDK-ja ofron njëzet e dy porta kontrolli të përputhshmërisë si një komandë e vetme, nexus-gates. Kapitulli 2.21, SDK-ja e Shtojcave, përshkruan secilën prej tyre. Këtu ato janë grupuar sipas rregullit që mbrojnë.
| Rregulli | Portat e kontrollit | Çfarë e dështon ndërtimin |
|---|---|---|
| Izolimi në shtresën e rrugëve | scope-adherence, one-fence, rights-register, crud-adherence |
Një rrugë /api pa mbrojtësin e fushëveprimit, një predikat i dytë qiramarrësi i shkruar me dorë, një rrugë fushëveprimi pa të drejtë, një rrugë modifikuese e drejta e së cilës nuk emërton asgjë |
| Izolimi në SQL | sql-fence, no-set-config |
Një deklaratë në një tabelë me fushëveprim të kufizuar pa gardhin; kodi i shtojcës që lidh vetë cilësimin e qiramarrësit |
| Izolimi në bazën e të dhënave | migrations-are-scoped, rls-present, db-role-honest |
Një tabelë së cilës i mungon një bosht ose një çelës që fillon me qiramarrësin, një tabelë pa siguri të detyruar në nivel rreshti, një shteg kërkese që lidhet si pronar ose superpërdorues |
| I vetmi kalim | grants-declared |
Një tabelë e autorizuar në migrime që manifesti nuk e deklaron, ose një vend leximi të cilit i janë dhënë privilegje me dorë |
| Llogaritja përmes UNO | no-direct-compute |
Një thirrje e drejtpërdrejtë drejt një ofruesi modeli ose motori, ose drejt një radhe apo strehuesi të rrjedhës së punës; një lexues i dytë i URL-së së dërgimit |
| AI dhe çelësat | no-credentials |
Një kredencial i ofruesit të modelit i lexueshëm në depo ose në mjedis |
| Kontrata e deklaruar | api-contract, platform-clients, declared-input |
Një rrugë e regjistruar por e padeklaruar, ose e deklaruar por e paregjistruar; një klient platforme i importuar por i paemërtuar |
Çdo portë kontrolli ka një vetë-testim që vërteton se ajo dështon në një skenar testimi (fixture) të ndërtuar për ta aktivizuar atë. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test i ekzekuton të gjitha, dhe një portë kontrolli që ka reshtur së dështuari në skenarin e vet të testimit ka reshtur së funksionuari.
Përpara se të kërkoni një rishikim
Kjo është lista që unë ndjek përpara se t'i kërkoj një kolegu të rishikojë një shtojcë. Çdo rresht është diçka që një rishikues në Corrán Orbital ma ka kthyer mbrapsht të paktën një herë.
- Çdo rrugë
/apiregjistron mbrojtësin e fushëveprimit, dhe të vetmet rrugë anonime janë shtigjet e sakta të deklaruaraauth: publicmeallowAnonymous: true. - Çdo rrugë të cilës i shërben mbrojtësi i fushëveprimit emërton një
rightnga regjistri i manifestit, dhe asnjë trajtues nuk mbart një kontroll të drejtash të vetin. - Asnjë trajtues nuk lexon një organizatë, një person ose një njësi nga trupi i kërkesës, pyetësori ose një kokë.
- Çdo deklaratë në një tabelë me fushëveprim të kufizuar kalon përmes
tenantFencebrendawithScopedTx, dhe asgjë në depo nuk thërretset_config. - Çdo tabelë ka tre kolonat e boshteve, një çelës primar që fillon me
organization_id, dhe çelësa të huaj të përbërë që mbartin qiramarrësin. - URL-ja e dërgimit lexohet në një skedar të vetëm, dhe lista e lejimeve të dërgimit është një konstante e llojeve të punëve me hapësirë emrash.
- Asgjë në
package.jsonnuk komunikon me një ofrues modeli, dhe asnjë çelës nuk ndodhet në mjedis. - Çdo veçori që vetëm disa licenca e mbartin emërton
licencee saj te e drejta që e mbron atë. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testështë jeshile, dhe po ashtu është edhenpx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json.
Nëse të nënta qëndrojnë, rishikimi ka të bëjë me produktin tuaj, që është vendi ku duhet të shkojë koha e një rishikuesi.
Pse platforma i zbaton këto rregulla
Çdo rregull më sipër ka qenë dikur një konventë diku, dhe çdo konventë dështoi në të njëjtën mënyrë: rrugët që e mbanin mend ishin në rregull dhe ajo që e harroi ishte incidenti. Një gardh njësie biznesi i aplikuar si ndërmjetës (middleware) opsional u anashkalua në gjashtë mënyra të pavarura, secila prej tyre një rrugë që nuk u përfshi kurrë. Një variabël mjedisi që rishkruante identitetin e qiramarrësit i shërbeu një organizate 1,406 kontaktet e një tjetre, dhe dukej e saktë në rishikim sepse ishte e saktë për pod-in për të cilin ishte shkruar.
Kështu që platforma e vendos predikatin aty ku çdo sipërfaqe tashmë kalon përmes tij: në mbrojtësin e fushëveprimit dhe funksionin e gardhit, në mbështjellësin e transaksionit dhe sigurinë e detyruar në nivel rreshti, dhe në klientin e dërgimit. Një portë kontrolli më pas liston çdo rrugë, çdo deklaratë dhe çdo import, dhe e dështon ndërtimin kur njëra prej tyre arrin një tabelë me fushëveprim të kufizuar, një model ose një motor llogaritjeje pa kaluar përmes atyre mekanizmave. Kostoja e atij dizajni është se shtojca juaj e parë ndihet e kufizuar. Përfitimi është se shtojca e njëmijtë është e izoluar pa e ditur autori i saj që veçoria ekziston, sepse nuk ka asnjë shteg tjetër drejt të dhënave që ajo mund të ndjekë.
Ka një kufi të ndershëm për gjithë këtë. Portat e kontrollit vërtetojnë se kodi juaj kalon përmes mekanizmave; ato nuk mund të vërtetojnë se logjika e produktit tuaj është e drejtë. Një rrugë që kufizon saktë në fushëveprim një pyetësor te rreshtat e pronarit mund t'i shfaqë përsëri rreshtat e gabuar pronarit të duhur. Kompleti i testimit të izolimit në kapitullin 2.22, Mjedisi i ekzekutimit të shtojcave, sulmon çdo rrugë si një organizatë tjetër dhe si një koleg, me çdo gardh të hequr me radhë, dhe ky është testi që do të ekzekutoja përpara se t'i besoja leximit tim për cilëndo nga këto.

