Versija 1.0.0-alpha.1naujausia
2.19 skyrius
Taisyklės, kurias paveldi kiekvienas plėtinys
Izoliacija trijose ašyse, skaičiavimai per UNO, DI (dirbtinis intelektas) per maršrutizatorių, organizacijai priklausantys raktai ir licencijų patikrinimai. Ką kiekviena taisyklė reiškia jūsų kodui, kuris barjeras užtikrina jos vykdymą ir kodėl jūs ją paveldite, o ne rašote patys.
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

Pirmasis atsisakymas, kurį mano anomalijų peržiūros papildinys kada nors išsiuntė, buvo skirtas man. Iš įpročio, įgyto kitoje platformoje, buvau parašęs bandomąjį klientą, kuris paskelbdavo naują peržiūrą su organizacijos id užklausos turinyje, ir papildinys atsakė dar prieš paleidžiant mano apdorojimo funkciją:
{
"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."]
}Šios patikros aš nebuvau parašęs. Ją pateikė apimties sargas, kurį SDK (programinės įrangos kūrimo rinkinio) šablonas prijungia prie kiekvieno /api maršruto, ir ji suveikia net tada, kai id užklausos turinyje yra paties kvietėjo. Toks yra viso šio skyriaus modelis: nedidelis taisyklių skaičius, kurių kiekvieną užtikrina paveldimas mechanizmas ir kurių kiekviena turi patikros vartus, sustabdančius jūsų kompiliavimą, jei jūsų kodas ją apeina. Nexus platformoje jūsų papildinys izoliaciją paveldi iš platformos, o patikros vartai ją audituoja.
Taisyklės yra penkios, ir toliau pateikiami skyriai jas aptaria paeiliui: izoliacija trimis ašimis; skaičiavimai, vykdomi tik per UNO paskirstymą; DI (dirbtinis intelektas), naudojamas tik per AI Provider Router; modelių raktai, priklausantys organizacijai; ir licencijuojamos funkcijos, tikrinamos pagal licenciją. Kiekvienas manifestas taip pat pakartoja tris iš jų viename sakinių bloke.
1 taisyklė: izoliacija trijose ašyse nuo pat autentifikuotos užklausos
Kiekvienas skaitymas ir rašymas plėtinyje yra apribotas trimis ašimis, kaip ir kiekvienas įrankio iškvietimas bei įgūdžio paskirstymas.
| Ašis | Stulpelis | Atsako į klausimą | Kiek griežta riba |
|---|---|---|---|
| Nuomininkas (Tenant) | organization_id |
Kuri organizacija | Griežta riba, peržengiama tik per užregistruotą tik skaitymo leidimą |
| Savininkas (Owner) | owner_user_id |
Kuris asmuo organizacijoje | Privatu net ir vienos organizacijos viduje, kai tai asmeniniai duomenys |
| Padalinys (Unit) | business_unit_id |
Kuri organizacijos dalis | Pasirenkama užtvara nuomininko viduje |
Būtent savininko ašį naujokai supranta klaidingai. Pašto dėžutė yra asmeninė, kaip ir išsaugotas rodinys ar grafas, sudarytas iš vieno asmens duomenų. Du tos pačios organizacijos nariai, esantys tame pačiame padalinyje ir turintys tą pačią rolę, nemato vienas kito savininku apribotų eilučių. Organizacijos artefakte, pavyzdžiui, patvirtinime ar bylos įraše, savininkas reiškia kilmę: jis fiksuoja, kas atliko veiksmą, o skaitymas apribojamas nuomininku, kad audito seka liktų matoma tiems, kuriems jos reikia. Kokios rūšies yra kiekviena lentelė, sprendžiate jūs, ir tai užkoduoja saugyklos sluoksnis, o ne specialus atvejis maršrute.
Ašys gaunamos iš autentifikuotos užklausos ir iš niekur kitur. Jų negali pateikti aplinkos kintamasis, užklausos parametras, kelio segmentas, kliento antraštė ar kompiliavimo konstanta. SDK apsunkina neteisingo kodo rašymą: resolveScope(identity, options) apskritai neturi organizacijos parametro. Organizacija yra identity viduje, o jį sukuria tik patikrintas prieigos raktas. Nėra kur perduoti id.
Todėl užklausos turinys, nurodantis nuomininką, yra atmetamas, o ne ignoruojamas. Sargas atmeta bet kurį iš penkių laukų pavadinimų: orgId, organizationId, organization_id, tenant ir tenantId. Tyliai ignoruojamas laukas išmoko kvietėją, kad laukas veikia. Pirmasis kvietėjas jį išbando ir mato savo duomenis; antrasis siunčia kitos organizacijos id. Atmetimas jau per pirmąją užklausą įvardija sutartį, kol niekas dar nepradėjo remtis klaidinga. Ta pati taisyklė galioja ir paskirstymo inputParams: įgūdžio įvestis, kurioje yra organizacijos id, atmetama paskirstymo metu.
Padalinio ašis yra arba deklaruojama ir užtikrinama, arba nenaudojama. Maršrutas, deklaruojantis needsUnit: true, atmeta užklausą, kai kredencialas nenustato padalinio, ir missing[] nurodo unit. Nesukurkite padalinio iš subdomeno ar antraštės ir nenustatykite jo pagal numatytuosius nustatymus. Sugalvotas padalinys atitveria kitaip nei tikrieji organizacijos padaliniai ir sujungia eilutes, kurių neturėtų.
Paviršius, negalintis išreikšti predikato, atmeta užklausą
Jei maršrutas negali nurodyti, kuriam nuomininkui ir savininkui priklauso eilutė, o prireikus – ir kuriam padaliniui, jis atmeta užklausą. Nėra jokio atsarginio visos organizacijos skaitymo ir jokios vietos rezervavimo reikšmės. Vietos rezervavimo reikšmė yra blogiausias pasirinkimas, nes tai yra reikšmė, o reikšmės atitinka eilutes: įrankių maršrutizatorius, kuris nuomininkui ir naudotojui pagal numatytuosius nustatymus priskirdavo eilutę 'unknown', pateikdavo visos organizacijos duomenis bet kam, kas jį iškviesdavo. Nuomininko ribose ?? 'unknown' yra defektas.
Atmetimas visoje platformoje turi vieną formą, ir jame pateikiama pakankamai informacijos, kad klientas galėtų parodyti sprendimą:
{
"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 visada yra true. code imamas iš platformos kodų katalogo. resolved[] nurodo išvestas ašis, o missing[] – tas, kurių maršrutui reikėjo, bet kurių nepavyko gauti. troubleshooting[] nurodo, kas iš tikrųjų išspręstų problemą. Vien „draudžiama“ nieko nieko neišmoko.
Atskirkite 401 ir 403, nes klientai į juos reaguoja skirtingai.
| Būsena | Reikšmė | Ką daro klientas |
|---|---|---|
| 401 | Neautentifikuota | Prisijungia iš naujo |
| 403 | Autentifikuota, tačiau užklausos negalima apriboti arba kvietėjas neturi teisės | Nustoja kartoti ir pakeičia užklausą |
Apimties atmetimas, pateiktas kaip 401, įsuka klientą į prisijungimo ciklą, kurio joks prisijungimas negali užbaigti: jis išmeta sesiją ir prisijungia iš naujo, kartoja užklausą ir vėl gauna 401, o asmuo be galo žiūri į sukamą indikatorių.
Dar du mechanizmai padaro atmetimą visišką. Apdorojimo funkcijos viduje scopeOf(req) yra vienintelis būdas nuskaityti apimtį, ir jis išmeta išimtį, jei sargas nebuvo paleistas. Be to, sargas paleidžiamas po užklausos turinio analizės ir prieš bet kurią apdorojimo funkciją; apdorojimo funkcija, tapusi pasiekiama be predikato, sąmoningai atsako 500 su MIDDLEWARE_ORDERING_ERROR, kad tai patektų į jūsų klaidų biudžetą, o ne į incidento ataskaitą.
Duomenų bazė savarankiškai išlaiko tą pačią ribą
Kodo užtvara ir duomenų bazės užtvara yra du vieno dėsnio mechanizmai, ir jūs gaunate abu.
Kiekvienas sakinys, skirtas apribotai lentelei, sudaro tenantFence(scope) iš SDK; predikato niekada nerašote ranka. Kiekvienas sakinys taip pat vykdomas withScopedTx viduje, kuris per vieną duomenų bazės funkciją susieja tris ašis tai vienai transakcijai ir atmeta antrą susiejimą (SCOPE_ALREADY_BOUND). Žemesniu lygmeniu kiekvienai jūsų schemos lentelei priverstinai įjungta eilučių lygio sauga, o rolė, kuria jungiasi jūsų užklausų kelias, negali pati pakeisti susieto nuomininko. Procesas, kuris jungiasi role, galinčia apeiti eilučių lygio saugą, atsisako pasileisti su DB_ROLE_BYPASSES_ISOLATION. 2.22 skyriuje „Papildinių vykdymo aplinka“ pateikiamas kodas; 2.21 skyriuje „Plugin SDK“ parodoma, kaip rolės sugeneruojamos už jus.
Vienintelis kirtimas: užregistruotas leidimas
Per nuomininko ribą yra tik vienas kelias. Organizacija, kuriai priklauso eilutės, užregistruoja leidimą, nurodantį, kuri organizacija kurias lenteles gali skaityti, pagal kokį susitarimą ir kiek laiko. Duomenų bazė padaro skaitymą tik skaitymo, o kiekviena peržiūra įrašoma prieš skaitymą abiejose organizacijose, tik pagal id. Rašymas niekada nekerta ribos; kitai įmonei perduotas darbas keliauja kaip pranešimas. Savininko ir administratoriaus rolės niekada neskaito per ribą, o manifestas atmetamas, jei teisė, leidžianti skaityti tarp organizacijų, jų neužblokuoja. Papildinys, norintis kito kelio per ribą, jo negauna.
2 taisyklė: visi skaičiavimai vykdomi per UNO dispečerį
UNO, darbo eigų variklis, yra vienintelis skaičiavimo kelias. Jūsų kodas niekada tiesiogiai nesikreipia į modelių teikėją ar variklį, taip pat nei į eilę, nei į darbo eigų pagrindinį kompiuterį. Paskirstymo galiniam taškui siunčiate vieną voką ir atgal gaunate 202 su identifikatoriais; rezultatas gaunamas apklausiant arba per atgalinį iškvietimą.
Iš to išplaukia trys įpročiai, ir šablone jau yra visi trys.
- Paskirstymo URL priklauso vienam failui.
UNO_DISPATCH_URLvieną kartą nuskaitomas konfigūracijos įkėlėjoje ir turi būti klasterio vidinis adresas. Viešas adresas atmetamas paleidimo metu, nes niekas nepalieka diegimo. - Vienas uždaras leidžiamųjų sąrašas, ką šis paviršius gali paskirstyti. Serverio dalis, kuri paskirstys bet kurį naršyklės pateiktą įgūdžio id, yra bendrosios paskirties tarpinis serveris kiekvienam registro įgūdžiui, įskaitant kitų papildinių įgūdžius ir įgūdžius, kurie naudoja kažkieno kito modelių biudžetą. Sąrašas yra modulio lygmens konstanta su vardų sritimis pažymėtais užduočių tipais, o ne aplinkos kintamasis. Į jį neįtrauktas id atmetamas su
SKILL_NOT_ALLOWED. - Patikrinkite, kas grįžta. Kai nuskaitote užduotį atgal, SDK klientas jūsų tinklo iškvietimo pusėje palygina grąžintos eilutės
organization_idsu kvietėjo nuomininku. Užtvara, kuri egzistuoja tik kitoje iškvietimo pusėje, yra tik susitarimas.
3 taisyklė: visas DI veikia per „AI Provider Router“
Papildinys niekur nekviečia modelio. package.json nėra teikėjo SDK, aplinkoje nėra modelio rakto ir nėra jokio tarpininko. Tik maršrutizatorius turi organizacijos teikėjo kredencialą ir priima galutinį teikėjo bei modelio sprendimą.
Papildinys gali tik išreikšti pageidavimus registracijos metu, manifesto įgūdžio registro eilutėje:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"preferredModel": "gemini-3.5-flash",
"capabilityProfile": { "needsToolUse": true, "minContextWindow": 200000 }
}
}Maršrutizatorius atsižvelgia į pageidavimą tik tada, kai organizacija turi tą teikėją įjungtą ir su kredencialais. Priešingu atveju jis pakeičia jį kitu iš pačios organizacijos telkinio. capabilityProfile niekada nepasirenka; jis filtruoja, o jo laukas dataResidency yra griežtas jurisdikcinis apribojimas, kurį maršrutizatorius įvykdo arba atmeta. Daugumai įgūdžių tinkamiausia numatytoji parinktis yra visų jų nenurodyti: tuomet sprendžia pačios organizacijos rolių priskyrimai, o moka organizacija.
Grąžinami dviejų rūšių atmetimai, ir jie reiškia labai skirtingus dalykus.
| Kodas | Būsena | Ką tai reiškia |
|---|---|---|
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER |
403 | Jūsų kodas bandė pats kviesti maršrutizatorių. Sustokite: tai sąmoningai atmetanti sąsaja, ir kartoti nėra prasmės |
MODEL_CAPABILITY_UNAVAILABLE |
422 | Nė vienas įjungtas teikėjas neturi modelio, atitinkančio profilį. Sušvelninkite profilį arba organizacija turi įjungti tinkamą teikėją |
NO_PROVIDER_FOR_ROLE |
422 | Organizacija nesukonfigūravo šios rolės maršrutizavimo. Parodykite asmeniui maršrutizatoriaus taisymo nurodymus |
Antroji pora turi būti rodoma ekrane, o ne žurnale. Nėra numatytojo modelio ir nėra atsarginio teikėjo: organizacijos nesukonfigūruota rolė aiškiai nesuveikia, pateikdama sakinį, nurodantį, ką sukonfigūruoti.
Vienintelis maršrutizatoriaus skaitymas, kurį papildinys gali atlikti, yra effectiveRoute() iš runtime/ai-route. Jis atsako, kurį teikėją ir modelį maršrutizatorius pasirinktų prisijungusiai organizacijai, nesiųsdamas DI užklausos, o kai modelio nėra, žodžiais grąžina maršrutizatoriaus atmetimą. Tai parodyta 2.22 skyriuje „Papildinių vykdymo aplinka“.
Pasitikėjimo kopėčios prideda dar vieną eilutę. Tik core ir verified papildiniai gali deklaruoti du manifesto įgūdžių lygius, pasiekiančius maršrutizatorių – tool_using ir llm_only. Visi kiti tarpininkauja deterministiniam darbui ir leidžia platformai atlikti modelį pasiekiančią dalį.
4 taisyklė: raktai priklauso organizacijai
Kiekviena organizacija naudoja savo teikėjo paskyrą ir raktą bei pati apmoka savo sąskaitą. Raktas saugomas organizacijos DI teikėjų telkinyje, kurį iš konsolės valdo jos pačios administratoriai, o maršrutizatorius jį nustato iškvietimo metu. Už nuomininko nėra jokio bendro platformos rakto, todėl nė viena organizacija nenaudoja kitos biudžeto.
Plėtiniui tai reiškia tris dalykus.
- Jūs niekada nelaikote modelio rakto – nei kode, nei konfigūracijoje, nei slaptųjų duomenų saugykloje. Patikros vartai
no-credentialssustabdo kompiliavimą, jei raktą galima perskaityti, o konfigūracijos įkėlėja atsisako pasileisti, jei raktas yra. - Jūs niekada neišvardijate organizacijos raktų. Jei jūsų papildiniui atrodo, kad to reikia, reikalavimas yra ne vietoje.
- Organizacija be rakto negauna DI atsakymų. Tai numatyta būsena su tikru ekranu. Įvardykite trūkstamą rolę ir pacituokite taisymo nurodymus, tada nukreipkite asmenį į jo teikėjo nustatymus. Nerodykite to kaip tuščio rezultato.
5 taisyklė: licencijuotos funkcijos tikrinamos pagal licenciją
Ką diegimas gali naudoti virš Community lygio, nustatoma vienoje vietoje: Adverant pasirašytame licencijos dokumente, kuris diegime tikrinamas tik viešaisiais raktais. Jūsų plėtinys niekada nesprendžia pagal ką nors silpnesnio, pavyzdžiui, plano pavadinimą prieigos rakte ar vėliavėlę konfigūracijoje.
Papildinyje paprasčiausias būdas susieti funkciją su licencija yra per teisę, kuri ją saugo. Teisė manifesto rights registre gali nurodyti licence funkciją:
"rights": {
"evidence.export": {
"summary": "Export the evidence pack for an inspection.",
"roles": ["owner", "admin", "member"],
"licence": "compliance-packs"
}
}Kiekvienas, kas kviečia ta teise saugomą maršrutą, atmetamas su LICENCE_LOCKED (403), nepaisant turimų rolių ir vietų, kai organizacijos licencija neapima compliance-packs. Atmetime nurodoma funkcija ir tai, kas ją apima, bei kas gali ją įjungti.
Svarbi ir licencijos būsena. Kol licencija galioja arba yra įspėjimo laikotarpyje, licencijuojamos funkcijos veikia, jos toliau veikia ir lengvatiniu laikotarpiu, o lengvatinis laikotarpis rodo pranešimą LICENCE_IN_GRACE. Kai licencija pasibaigia ir praeina lengvatinis laikotarpis, ji apriboja: vykdomas darbas ir skaitymas tęsiasi, kaip ir eksportas bei saugos naujiniai, tačiau naujo objekto kūrimas pagal licencijuojamą funkciją atmetamas su LICENCE_LOCKED. Kurkite savo kūrimo kelius tikėdamiesi tokio atsakymo.
Kai jūsų papildinys teiraujasi teisių patikros, ar organizacija turi funkciją, jis gauna verdiktą, o ne vien loginę reikšmę. „Nepasiekiama“ ir „pasiekiama, bet ne“ yra skirtingi faktai su skirtingais kodais: ENTITLEMENT_UNREACHABLE (502) ir ENTITLEMENT_DENIED (403). Trumpas pasiekiamumo sutrikimas niekada neturi tyliai nuleisti visų klientų iki nemokamo lygio.
MANIFEST_SCOPE_WIDENED, kol du peržiūrėtojai ir atitikties pareigūnas sutiks.Manifestas pakartoja įstatymą
Kiekviename v2 manifeste yra architecture blokas su trimis privalomais sakiniais, o tikrintuvas griežtai nustato jų formuluotę. Įskiepyje, kurį kuriate savo diegimui, jie skamba taip:
"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."
}Šie sakiniai tikrinami. Įskiepis, kurio manifestas sutiko su taisyklėmis, o kodas kreipėsi į modelių teikėją, meluotų savo paties sutartyje, o patikros egzistuoja tam, kad toks melas būtų aptinkamas.
Barjerai, užtikrinantys kiekvienos taisyklės vykdymą
SDK pateikia dvidešimt dvi atitikties patikras kaip vieną komandą, nexus-gates. 2.21 skyriuje „Įskiepių SDK“ aprašyta kiekviena iš jų. Čia jos sugrupuotos pagal taisyklę, kurią užtikrina.
| Taisyklė | Patikros | Kas sustabdo kompiliavimą |
|---|---|---|
| Izoliacija maršrutų sluoksnyje | scope-adherence, one-fence, rights-register, crud-adherence |
/api maršrutas be aprėpties sargo, antras rankomis parašytas nuomininko predikatas, aprėpties maršrutas be teisės, keičiantis maršrutas, kurio teisė nieko neįvardija |
| Izoliacija SQL | sql-fence, no-set-config |
Sakinys aprėpties lentelei be užtvaros; įskiepio kodas, pats susiejantis nuomininko nustatymą |
| Izoliacija duomenų bazėje | migrations-are-scoped, rls-present, db-role-honest |
Lentelė, kuriai trūksta ašies arba nuomininku prasidedančio rakto, lentelė be priverstinės eilučių lygio saugos, užklausos kelias, jungiantis kaip savininkas arba supernaudotojas |
| Vienintelis perėjimas | grants-declared |
Migracijose suteikta lentelė, kurios manifestas nedeklaruoja, arba skaitymo vieta, kuriai privilegijos suteiktos rankomis |
| Skaičiavimai per UNO | no-direct-compute |
Tiesioginis kreipimasis į modelių teikėją ar variklį arba į eilės ar darbo eigos serverį; antras dispečerizavimo URL skaitytojas |
| DI ir raktai | no-credentials |
Modelių teikėjo prisijungimo duomenys, kuriuos galima perskaityti saugykloje arba aplinkoje |
| Deklaruota sutartis | api-contract, platform-clients, declared-input |
Užregistruotas, bet nedeklaruotas maršrutas arba deklaruotas, bet neužregistruotas; importuotas, bet neįvardytas platformos klientas |
Kiekviena patikra turi savitikrą, įrodančią, kad ji nepraeina su specialiai jai suklaidinti sukurtu testiniu rinkiniu. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test paleidžia jas visas, o patikra, kuri nustojo nepraeiti su savo testiniu rinkiniu, nustojo veikti.
Prieš prašydami peržiūros
Tai sąrašas, kurį peržiūriu prieš paprašydamas kolegos įvertinti įskiepį. Kiekvieną eilutę recenzentas iš Corrán Orbital man yra grąžinęs bent kartą.
- Kiekvienas
/apimaršrutas registruoja aprėpties sargą, o vieninteliai anoniminiai maršrutai yra tikslūs keliai, deklaruotiauth: publicsuallowAnonymous: true. - Kiekvienas aprėpties sargo aptarnaujamas maršrutas įvardija
rightiš manifesto registro, ir jokia doroklė neatlieka savo teisių patikros. - Jokia doroklė neskaito organizacijos, asmens ar padalinio iš užklausos turinio, užklausos parametrų ar antraštės.
- Kiekvienas sakinys aprėpties lentelei eina per
tenantFencevidujewithScopedTx, ir niekas saugykloje nekviečiaset_config. - Kiekviena lentelė turi tris ašies stulpelius, pirminį raktą, prasidedantį
organization_id, ir sudėtinius išorinius raktus, apimančius nuomininką. - Dispečerizavimo URL skaitomas viename faile, o dispečerizavimo leidžiamųjų sąrašas yra vardų erdvėmis pažymėtų užduočių tipų konstanta.
- Niekas
package.jsonnesikreipia į modelių teikėją, ir aplinkoje nėra jokio rakto. - Kiekviena funkcija, kurią turi tik kai kurios licencijos, įvardija savo
licenceją saugančioje teisėje. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testyra žalias, kaip irnpx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json.
Jei visi devyni punktai tenkinami, peržiūra yra apie jūsų produktą, ir būtent tam turėtų būti skiriamas recenzento laikas.
Kodėl platforma reikalauja laikytis šių taisyklių
Kiekviena aukščiau pateikta taisyklė kažkada kažkur buvo susitarimas, ir kiekvienas susitarimas žlugo taip pat: maršrutai, kurie jį prisiminė, veikė gerai, o tas, kuris pamiršo, tapo incidentu. Verslo padalinio užtvara, taikyta kaip pasirenkama tarpinė programinė įranga, buvo apeita šešiais nepriklausomais būdais, kiekvienas jų – maršrutas, kuris niekada jos neįsijungė. Aplinkos kintamasis, perrašęs nuomininko tapatybę, vienai organizacijai pateikė kitos 1406 kontaktus, ir peržiūroje tai atrodė teisinga, nes buvo teisinga tam pod, kuriam buvo parašyta.
Todėl platforma predikatą įdeda ten, pro kur jau eina kiekvienas paviršius: į aprėpties sargą ir užtvaros funkciją, į transakcijos apvalkalą ir priverstinę eilučių lygio saugą bei į dispečerizavimo klientą. Tada patikra išvardija kiekvieną maršrutą, sakinį ir kiekvieną importą ir sustabdo kompiliavimą, kai kuris nors iš jų pasiekia aprėpties lentelę, modelį ar skaičiavimo variklį neperėjęs per šiuos mechanizmus. Tokio dizaino kaina – jūsų pirmasis įskiepis atrodo suvaržytas. Nauda – tūkstantasis įskiepis yra izoliuotas, nors jo autorius net nežino, kad tokia funkcija egzistuoja, nes nėra jokio kito kelio į duomenis.
Visa tai turi sąžiningą ribą. Patikros įrodo, kad jūsų kodas eina per mechanizmus; jos negali įrodyti, kad jūsų produkto logika teisinga. Maršrutas, teisingai apribojantis užklausą savininko eilutėmis, vis tiek gali parodyti netinkamas eilutes tinkamam savininkui. Izoliacijos testų rinkinys, aprašytas 2.22 skyriuje „Įskiepių vykdymo aplinka“, atakuoja kiekvieną maršrutą kaip kita organizacija ir kaip kolega, paeiliui pašalindamas kiekvieną užtvarą, ir būtent šį testą paleisčiau prieš pasitikėdamas savo paties šių dalykų supratimu.

