Versie 1.0.0-alpha.1nieuwste
Hoofdstuk 2.27
Bouwscenario's
Een kookboek met dertien builds, van een enkele vaardigheid tot een air-gapped levering. Elk recept geeft het doel, de bouwstenen, de stappen en opdrachten, de poort die bewijst dat het heeft gewerkt, en wat er verandert per editie en leveringsvorm.
Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

Dit zijn de recepten waar ik naar grijp wanneer iemand bij Corrán Orbital, of bij een klant, zegt: "wij willen dat Nexus X doet". Elk recept is bewust kort gehouden. De redenering achter de stappen staat in de voorgaande hoofdstukken: hoofdstuk 2.20, Skills, en hoofdstuk 2.21, De Plugin SDK, dat de software development kit behandelt, gevolgd door hoofdstuk 2.23, Domeinpakketten, en de drie daaropvolgende hoofdstukken over het bouwen. Hier vindt u het doel, welke bouwstenen u moet gebruiken, de stappen, de opdrachten, de poort die aangeeft dat het heeft gewerkt, en de opmerkingen over de editie en oplevering.
De poort is het belangrijkst. Een recept is klaar wanneer de poort op groen staat. Elke poort in dit hoofdstuk is iets dat u zelf kunt uitvoeren of dat het platform voor u uitvoert, en elke poort sluit af met een waarde ongelijk aan nul of weigert met een code wanneer er niet aan wordt voldaan.
| Scenario | Belangrijkste bouwsteen | De poort die het bewijst | Editie |
|---|---|---|---|
| Een nieuwe Skills Engine-skill | SKILL.md-pakket |
skill:validate met nul fouten |
Community en Enterprise |
Een manifest-skill met host_callback |
Plugin-manifest skills[] |
create-nexus-plugin validate en nexus-gates |
Community en Enterprise |
| Een bestaand pakket uitbreiden | pack.json met inherits |
Beleidscontrole van lenzen bij de pilotpoort | Enterprise en een pakketlicentie |
| Een nieuw pakket vanaf nul | Golden path voor domeinpakketten | Staging- en pilotpoorten | Enterprise |
| Een dataconnector | plugin_queue-skill |
validate, nexus-gates, weigering van uitgaand verkeer |
Community en Enterprise |
| Een MCP-tool (Model Context Protocol) | Manifest mcpTools[] |
validate (geen combinators op het hoogste niveau) |
Community en Enterprise |
| Een white-label storefront | Manifest domains en branding |
Openbare regel scope-adherence |
Enterprise en de Storefront-add-on |
| Een Edge-missiepakket | Missiepakket | Testcases aan boord, twee van de drie handtekeningen | Enterprise en de Nexus Edge-add-on |
| Een air-gapped oplevering | Verzegelde bundel | nexus-airgap verify |
Enterprise |
| Een module exclusief voor Enterprise | @adverant/nexus-spi |
Licentiegrens-poort, editie-builds | Enterprise |
| De open core forken of uitbreiden | De Community-broncode | Tests, lint en typecontrole | Community |
| Een cloud-app voor de Team-editie | Uitgeverscluster | Ondertekende release, beoordeling, toekenning door klant | Team |
| Een bestaande interne app inpakken | /plugin-create |
migrate, validate, nexus-gates |
Community en Enterprise |
1. Een nieuwe Skills Engine-vaardigheid
Het doel is een herbruikbare instructie die de assistent, agents, workflows en ontwikkelaarstools allemaal kunnen uitvoeren, zoals het controleren van een douaneaangifte aan de hand van de regels. Uw bouwstenen zijn een SKILL.md-pakket in een map die is vernoemd naar de skill, een optionele skill.yaml voor triggers en tags, en een optionele scripts/-map die ermee wordt gebundeld.
- Maak
skills/<slug>/en schrijfSKILL.mdmet frontmatter:name(kebab-case, gelijk aan de mapnaam),description(maximaal 500 tekens),allowed-tools, en optioneeltriggers,capabilitiesenversion. - Schrijf de hoofdtekst voor het model: wanneer de skill moet worden gebruikt, de stappen, voorbeelden en wat deze nooit mag doen.
- Voeg testcases toe. Neem er een op met een in de invoer verstopte instructie die de skill niet mag opvolgen.
- Valideer, bekijk het uploadplan en upload vervolgens.
- Publiceer. Een skill die een schrijftool toevoegt, wordt vastgehouden totdat twee aangewezen personen deze goedkeuren met passkeys, waarbij de indiener zijn eigen wijziging niet kan goedkeuren.
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing --dry-run
npm run skill:upload skills/check-a-customs-filingDe poort is skill:validate, die nul fouten moet rapporteren voordat er iets kan worden gepubliceerd. De blokkerende fouten zijn een ontbrekende naam of beschrijving en een dubbele slug of taaktype. Het uploaden van inhoud die al is gepubliceerd, retourneert de bestaande versie (CONTENT_HASH_ALREADY_PUBLISHED), zodat het veilig is om de upload te herhalen.
Community krijgt de volledige creator, de bibliotheek, versies, het terugschakelen, importeren en tests. Bij Enterprise doorloopt het publiceren ook shadow en canary: de goedgekeurde versie draait in shadow, vervolgens voor één eenheid achter benoemde poorten, daarna voor iedereen, en stopt automatisch als niet aan een poort wordt voldaan. Voor een air-gapped klant worden skills vooraf ondertekend meegeleverd in de verzegelde bundel (scenario 9).
2. Een manifestvaardigheid met host_callback
Het doel is deterministische rekenkracht in uw eigen plugin die het platform kan aansturen, zoals het openen van een afwijkingsrecord op basis van een meting. U gebruikt een rij in de skills[] van het manifest met de tier host_callback, en een /internal-route in uw backend die wordt beveiligd door de service guard van de SDK.
- Declareer de skill:
idin lower_snake,tier: "host_callback", eenclassificationop of onder het vertrouwensplafond van uw plugin,inputSchema,outputSchemaen eentimeoutMstussen 1 seconde en 6 uur. - Vul
hostCallbackin: uw eigen servicenaam, de bijbehorende poort, een relatief pad zoals/internal/skills/excursion_open, beide bytelimieten (maxRequestBytesenmaxResponseBytes) entenantHeader: "X-Organization-ID". - Declareer de route in
api.endpoints[]metauth: "service-key"ofauth: "internal", en beveilig deze metrequireServiceofserviceMiddleware, nooit met de user scope guard. - Valideer, voer de poorten uit en laat de onboarding de skills synchroniseren met het register via
compileRegistry. U schrijft nooit handmatig register-SQL.
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-testvalidate past de eigen regels van de registersynchronisatie toe voordat er iets wordt gesynchroniseerd, waarbij elke weigering de code van de ontvanger krijgt. Een pad met een schema, // of een backslash wordt geweigerd als cross-origin. Een ontbrekende bytelimiet is ENDPOINT_BYTE_CAP_REQUIRED, een veld uit een andere tier is FIELD_NOT_FOR_TIER, en een time-out buiten het bereik is TIMEOUT_OUT_OF_BOUNDS. Vervolgens controleert nexus-gates of de /internal-route de service guard draagt en is gedeclareerd als internal of service-key. Dat tweetal poorten vormt het bewijs.
Synchronisatie is declaratief. Post elke keer de volledige set skills, want een skill die u weglaat wordt uitgeschakeld, en laat uw deploy-stap mislukken bij elke andere status dan 200. Bij Enterprise wordt een pluginsynchronisatie in zijn geheel gecontroleerd: als één skill een regel overtreedt, wordt niets van die synchronisatie overgenomen (PLUGIN_SYNC_ALL_OR_NOTHING) en blijft de vorige versie draaien. Een plugin met community-vertrouwen kan de tiers die een model bereiken, tool_using en llm_only, niet gebruiken; daarvoor is vertrouwensniveau core of verified vereist.
3. Een bestaand pakket uitbreiden
Het doel is een nieuwe sector of subsector die het grootste deel van een bestaand pakket hergebruikt, zoals kredietverstrekking en kaartgeschillen bovenop de structuur van het verzekeringspakket. De bouwsteen is een pack.json die zijn bovenliggende pakket noemt in inherits en alleen zijn eigen lensclusters en woorden toevoegt.
- Start het pakket met het golden path voor domeinpakketten en stel vervolgens
inheritsin op de id van het bovenliggende pakket. - Voeg uw eigen
lens-clusters toe, elk met hun eigen seats, doel en lexiconverwijzing. - Voeg uw woorden toe aan het lexicon, elk met een duidelijke verklaring. Markeer een term als
exactwaar deze exact zoals geschreven moet worden getoond. - Hergebruik gedeelde lenzen in plaats van uw eigen lenzen te ontwerpen: een regime dat meerdere pakketten nodig hebben, zoals een register van uitbestede technologie, is één gedeelde lens.
- Controleer de licentieketen. Uw pakket erft de add-on-vereisten van het bovenliggende pakket.
- Bekijk een voorbeeld van elke lens als een persoon op een synthetische branch.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Het bewijs is de beleidscontrole van de pilotpoort, die bevestigt dat elke lens zijn basis alleen maar versmalt en persoonlijke velden standaard uitgeschakeld houdt. Een lens die probeert te tonen wat zijn basis verbergt, wordt geweigerd met LENS_CANNOT_WIDEN. Aan de licentiekant weigert de console een licentie voor uw pakket af te geven zonder de add-ons die het bovenliggende pakket nodig heeft; het verzekeringspakket vereist Decision rooms en verzegelde records.
Domeinpakketten zijn voor Enterprise en worden per pakket gelicentieerd. De telefoonschermen van een pakket hebben ook de add-on Mobile apps nodig. Een onderliggend pakket kan de shell, de componenten of de schrijfregels niet wijzigen.
4. Een nieuw pakket vanaf nul opbouwen
Het doel is de kijk van één specifieke sector op Nexus: het kennismodel, de lenzen voor elke rol, het bewijsmateriaal waar de regels om vragen, en de plugin die de gegevens actueel houdt. Hoofdstuk 2.24, Een aangepaste vertical van begin tot eind bouwen, doorloopt dit bouwproces volledig; hier volgt de korte versie.
- Voer het golden path voor domeinpakketten uit en beschrijf het pakket: het doel, de eenheden, het basismodel en de regels die het in kaart brengt.
- Bouw het kennismodel op een basismodel en classificeer elke eigenschap terwijl u deze toevoegt.
- Lees het plan, bevestig de vingerafdruk met uw passkey en maak het aan.
- Geef de lenzen vorm in de Lens builder, waarbij elke lens een basislens versmalt.
- Schrijf de plugin en eventuele Skills Engine-skills die het pakket nodig heeft.
- Genereer synthetische gegevens op basis van een seed met de uitzonderingsgevallen die voor u van belang zijn, en bekijk een voorbeeld van elke lens als een persoon.
- Promoveer vanuit de ontwikkelomgeving naar staging, naar een piloteenheid en vervolgens naar alle eenheden.
Het bewijs wordt geleverd door de promotiepoorten: alle tests moeten slagen op de synthetische branches naar staging, gevolgd door twee beoordelaars die niet de auteur zijn, en daarna 14 dagen in de pilot met minder dan 1 op de 1.000 fouten. Geen enkele stap kan worden overgeslagen (GATE_CANNOT_BE_SKIPPED). Pakketten zijn voor Enterprise. Bij Community wordt het golden path voor domeinpakketten niet aangeboden.
5. Een gegevensconnector
Het doel is dat gegevens uit een extern systeem volgens een schema naar de eigen tabellen van uw plugin stromen, zoals poortgebeurtenissen uit een terminalbesturingssysteem. De bouwstenen zijn een plugin_queue-skill, een worker die uw wachtrij uitleest, een migratie voor de doeltabel en een in het manifest gedeclareerd uitgaand adres.
- Declareer een
plugin_queue-skill waarbijqueueNamewordt gespeld als<plugin name>.<name>. Er is geen dubbele punt toegestaan en de naam moet in het manifest staan, omdat de orchestrator er rechtstreeks taken op plaatst. - Schrijf de worker die de wachtrij uitleest en het externe systeem aanroept.
- Declareer het adres van het externe systeem als een uitgaand adres. Alles wat niet in de lijst staat, wordt geblokkeerd.
- Sla wat binnenkomt op in uw eigen schema, met
organization_id,owner_user_idenbusiness_unit_idop elke rij. - Lees de inloggegevens van het externe systeem op naam uit de omgeving en vermeld de variabele in
scripts/ci/required-env. - Stuur de ophaalacties aan via UNO, de workflow-engine, en nooit met een timer die engines rechtstreeks aanroept.
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 --only no-credentials --only no-direct-compute --only migrations-are-scoped
node scripts/ci/required-envvalidate controleert de wachtrijnaam en de time-out aan de hand van de regels voor registersynchronisatie. De drie poorten bewijzen dat er geen model-inloggegevens zijn, geen directe rekenkracht en een correct afgebakende tabel. Voer de volledige nexus-gates uit voordat u pusht, aangezien --only de uitvoering beperkt en dat ook in de samenvatting vermeldt. Tijdens runtime wordt een aanroep naar een adres dat niet in het manifest is gedeclareerd, aan de rand gestopt met EGRESS_NOT_DECLARED.
De eigen connectoren van het platform voor schijven, wiki's, mailopslag en verouderde systemen, inclusief wijzigingsregistratie en herkomst (lineage), worden geleverd bij de add-on Data connectors. Een connector die u zelf bouwt, is een plugin en werkt op elke editie. Het toevoegen van een uitgaand adres in een latere release is een verruiming, die wordt vastgehouden totdat twee beoordelaars deze accepteren.
6. Een MCP-tool
Het doel is een tool die Claude Code, agents en andere MCP-clients (Model Context Protocol) kunnen aanroepen, zoals het opzoeken van de inspectiegeschiedenis van een vaartuig. De bouwsteen is een vermelding in de mcpTools[] van het manifest, met een name, een description en een inputSchema.
- Geef de tool een naam en beschrijf deze duidelijk. De beschrijving is wat een model leest om te beslissen of het de tool moet aanroepen.
- Schrijf de
inputSchemaals één objectschema. Plaats geenoneOf,allOfofanyOfop het hoogste niveau. - Houd de route die de tool bedient achter de scope guard, net als elke andere
/api-route, zodat de tenancy afkomstig is van het token van de aanroeper. - Valideer het manifest.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonHet bewijs is validate: een combinator op het hoogste niveau wordt tijdens het opstellen geweigerd, omdat deze er tijdens runtime voor zou zorgen dat de tool mislukt voor elke MCP-subagent die hem importeert, waardoor de tool zou bestaan zonder dat iemand hem kan aanroepen.
Bij Enterprise wordt elke tool die een IDE (integrated development environment) kan aanroepen, vermeld in de Workbench-toolcatalogus met de bijbehorende tier, of deze zaken wijzigt, een vastgepinde vingerafdruk en de rollen die hem mogen gebruiken. Als de beschrijving van uw tool in een nieuwe release verandert, houdt de catalogus de tool vast totdat een persoon de wijziging beoordeelt. Dat gebeurt bewust: een gewijzigde beschrijving is de manier waarop een tool een model kan gaan vragen om iets dat niet de bedoeling is. Een aanroep naar iets buiten de pas van de aanroeper wordt geweigerd met CONNECTION_SCOPE_EXCEEDED.
7. Een white-label-etalage
Het doel is een app die de eigen klanten van uw klant gebruiken, op het domein van de klant en in hun eigen huisstijl, zonder enig spoor van Adverant. De bouwstenen zijn de blokken domains en branding van het manifest, de aanmeldhelpers van de SDK en de Storefront / white-label add-on van de klant.
- Zet het domein van de klant in
domains[]alsprimary, met eventuelealiases. - Vul
brandingin:appName,tagline,primaryColor,accentColor, eenpasskeyRpIdgelijk aan het domein, enoauthClientRef. - Meld mensen aan via de aanmeldhelpers van de SDK en declareer hun twee openbare routes exact, met
auth: "public"enallowAnonymous: true. - Stuur elke frontend-aanroep via de allow-list-proxy van de backend for frontend. Zet nooit een serviceadres in de client.
- Laat betalingen over aan de beheerder van de klant, die gateways koppelt en de checkout in de eigen huisstijl instelt.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractHet bewijs is scope-adherence. Deze staat een onbeveiligde /api-route alleen toe wanneer het manifest die exacte methode en dat pad als openbaar declareert en het pad een van de aanmeldroutes is; elke andere openbare declaratie mislukt en noemt de twee toegestane paden. api-contract vergelijkt vervolgens in beide richtingen de gedeclareerde routes met de daadwerkelijke routes. definePlugin weigert ook een frontend.basePath die geen relatief same-origin pad is.
White-label is de Storefront / white-label add-on op Enterprise, die tevens de licentie voor betalingen omvat. Kaartgegevens komen nooit in aanraking met Nexus. De beheerder van de klant is eigenaar van het merk, en het platform haalt dit op uit de organisatie in plaats van uit uw code.
8. Een Edge-missiepakket
Het doel is een nieuwe of bijgewerkte missie voor een satelliet of drone waarop Nexus Edge draait, zoals het toevoegen van een scheepszoeker-adapter aan een maritieme wachtmissie. De bouwsteen is een missiepakket, gebouwd en ondertekend op de grond.
- Begin vanaf het huidige pakket op de pagina Een missiepakket bouwen, die de nieuwe versie opstelt op basis van de oude en elke wijziging markeert.
- Wijzig alleen wat de missie nodig heeft. Houd de grote onderdelen, het taalmodel en de ontologie, waar mogelijk stabiel.
- Controleer de plaatsingstabel bij elke gedegradeerde stap, zodat elke printplaat nog steeds past bij wat erop draait.
- Voer de testcases aan boord van het pakket uit op een testopstelling met dezelfde printplaten.
- Verstuur het ter ondertekening: twee van de drie handtekeningen zijn vereist.
- Geef het vrij naar één platform. Het komt in het inactieve slot terecht en wordt pas ingeschakeld nadat de testcases aan boord zijn geslaagd.
- Rol het na een foutloze week uit naar het volgende platform.
Er zijn geen opdrachten in dit recept; het wordt uitgevoerd op de Nexus Edge-pagina's van de console. Het bewijs wordt geleverd door de testcases aan boord, die allemaal moeten slagen voordat het pakket wordt ingeschakeld, en de twee handtekeningen. Als een test aan boord mislukt, blijft het platform op zijn vorige pakket en komt de fout bij de volgende passage naar beneden. Het installeren van een pakket op hardware waarvoor het niet is gecontroleerd, wordt geweigerd met PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge is een add-on, gelicentieerd per platform of per vloot. Pakketten blijven geldig terwijl een platform buiten bereik is. De uplink is smal, dus houd daar rekening mee bij het plannen van de bestandsgroottes: onze 1.5-release was 412 MB, tegenover 9.8 GB voor een pakket met een nieuw taalmodel.
9. Een air-gapped levering aan een klant
Het doel is dat uw plugin of pakket wordt geïnstalleerd op een klantlocatie zonder netwerk. De bouwstenen zijn een verzegelde bundel van @adverant/nexus-sovereign, uw ondertekeningssleutel voor releases en de eigen releasekanalen van de klant.
- Bouw de plugin en de bijbehorende images precies zoals voor een verbonden klant, met elke poort op groen.
- Maak een verzegelde bundel met het
airgap-profiel, met daarin de images, migraties, vooraf ondertekende skills en een SBOM (software bill of materials) met de licenties. - Onderteken deze met uw Ed25519-releasesleutel.
- Verifieer het zelf op een schone machine.
- Verstuur de bundel op een gegevensdrager, en verstuur uw openbare sleutel en de SHA-256 van de bundel via een aparte route.
- De operator van de klant verifieert de bundel met uw sleutel en haalt de release vervolgens binnen via hun eigen releasekanalen.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle bouwt de bundel op basis van uw bundelconfiguratie. Het bewijs is nexus-airgap verify aan de kant van de klant. Het berekent opnieuw de hash van elk bestand, wijst elk bestand af dat niet in het manifest staat, vereist een vertrouwde ondertekenaar en weigert een bundel waarvan de netwerk-allow-list niet leeg is. Een gewijzigd bestand mislukt met BUNDLE_INTEGRITY_VIOLATION. Niemand zou ooit de strikte controle mogen uitschakelen om dit te omzeilen.
Air-gapped installaties zijn voor Enterprise. Niets in de bundel mag tijdens de installatie iets ophalen, en een model dat de plugin nodig heeft, is afkomstig van de eigen modelserver van de klant via de AI (artificial intelligence) Provider Router.
10. Een module exclusief voor Enterprise
Het doel is een gesloten, gelicentieerde mogelijkheid die wordt gekoppeld aan de open core, zoals een audittrail met lange bewaartermijn die alleen aan Enterprise-klanten wordt verkocht. De bouwsteen is het interfacepakket @adverant/nexus-spi, en verder niets uit Community.
- Bewaar een op byte-niveau vastgepinde kopie van het gebouwde interfacepakket in uw repository als een lokaal
file:-pakket, met de bijbehorendeSHA256SUMS-pin. - Schrijf er een
RouteModule(of eenScreenModulevoor consoleschermen) tegen, met de functiegroep die deze bedient. - Laat elke route achter
ctx.requireScopedraaien en controleer de eigen toekenning van de module voordat u antwoordt. - Weiger met
LICENCE_LOCKEDwanneer de organisatie geen recht heeft op de functie, en toon de teaser van de functie, nooit de gegevens ervan. - Houd de repository aan de licentiegrens en bouw vervolgens de samengestelde boomstructuur van elke editie.
npm ci
npm test
npm run buildHet bewijs is de licentiegrens-regel: geen import vanuit een Community-scope behalve het interfacepakket, geen relatieve import buiten de repository, en geen file:-, link:- of workspace:-afhankelijkheid daarbuiten. Vervolgens moeten de drie bovenstaande opdrachten slagen in elke samengestelde editie-boomstructuur, niet alleen in uw werkboomstructuur. Hoofdstuk 2.25, Bouwen voor elke editie, bevat het moduleskelet.
Een module wordt bij het opstarten geladen in een Community-service, op installaties waarvan de licentie de bijbehorende functiegroep bevat. Zonder die toekenning weigert de module, zodat dezelfde build overal wordt uitgerold en niets doet waar er geen licentie voor is.
11. De open core afsplitsen (forken) of uitbreiden
Het doel is een wijziging aan Community zelf, die u in uw eigen fork bewaart of teruggeeft aan het project. De bouwsteen is de Community-broncode onder de Apache License, Version 2.0.
- Fork de repository en maak een branch vanaf
main. - Geef de voorkeur aan een plugin of een skill als wat u wilt daarmee kan worden gerealiseerd. Een wijziging aan de core moet u bij elke release zelf onderhouden.
- Breng de wijziging aan met tests die zonder deze wijziging mislukken.
- Voer de controles uit die het project uitvoert voordat u iets voorstelt.
- Behoud het NOTICE-bestand en gebruik de namen of handelsmerken van Adverant niet, behalve om aan te geven waar het werk vandaan komt.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckHet bewijs is dat die drie controles slagen, plus het bewijs dat elke nieuwe test vóór uw wijziging mislukte. Houd één eigenschap van de open core in stand in uw fork: Community voert een agent van begin tot eind uit op een lokaal model, zonder sleutel en zonder netwerk. Een wijziging die dat verbreekt, doet teniet wat Community op zichzelf bruikbaar maakt.
Dit is alleen voor Community. Alles wat gesloten moet blijven, hoort in plaats daarvan thuis in een Enterprise-module (scenario 10), zodat de licentiegrens een duidelijke plek blijft waar iedereen naar kan verwijzen.
12. Een cloud-app voor de Team-editie
Het doel is een app die Team-klanten kunnen installeren. Team draait alleen op de Adverant-cloud, dus de app bereikt hen uitsluitend via de catalogus. De bouwstenen zijn een plugin en een uitgeverscluster: uw eigen virtuele cluster op de Adverant-cloud met voorbeeldgegevens.
- Bouw en test op het uitgeverscluster, uitsluitend met voorbeeldgegevens.
- Declareer alles wat de app nodig heeft in het bijbehorende manifest, en niets meer.
- Geef de app ondertekend vrij voor beoordeling door Adverant en voor vermelding in de catalogus.
- Elke klant installeert de app en kent elke gedeclareerde scope eenheid voor eenheid toe.
Het bewijs bestaat uit twee delen. De ondertekende, beoordeelde release zorgt ervoor dat u in de catalogus wordt opgenomen. Vervolgens bepaalt de toekenning van de klant wat de app op hun locatie kan bereiken, en wordt elke aanroep die niet is gedeclareerd, geweigerd met CONNECTION_SCOPE_EXCEEDED. U kunt een ontbrekende scope alleen toevoegen in een nieuwe release die door de klant wordt beoordeeld.
Een uitgeverscluster heeft geen route naar welke klant dan ook, en het opvragen van klantgegevens aldaar wordt geweigerd met TENANT_BOUNDARY. Klanten kunnen testresultaten met u delen, maar nooit hun gegevens. Team bevat de mogelijkheid voor workflowbeheer, dus als uw app workflows meelevert, kunnen Team-klanten deze zelf tussen omgevingen promoveren.
13. Een bestaande interne app inpakken als een plug-in
Het doel is een app die uw bedrijf al gebruikt, ondergebracht in Nexus zodat deze aanmelding, isolatie en governance erft. De bouwstenen zijn de /plugin-create-skill voor de eerste opzet, en de manifesttools en poorten van de SDK om het af te ronden.
- Voer
/plugin-createuit met de repository. Het analyseert de code en kiest een inpakstrategie, en genereert vervolgens de backend, migraties, gebruikersinterface (UI), het manifest en de tests. - Til het manifest naar het v2-contract.
migratevoegt de drie wetmatige zinnen toe en verplaatstdomainnaardomains[], en weigert zelf een entrypoint te verzinnen. - Vervang elke tenantwaarde die de wrapper uit headers leest door de scope guard van de SDK.
- Voeg
organization_id,owner_user_idenbusiness_unit_idtoe aan elke tabel, met primaire sleutels die beginnen met de tenant. - Declareer elke route met het bijbehorende recht en installeer het weigeringsregister.
- Voer de poorten uit totdat ze op groen staan.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin migrate nexus.manifest.json --write
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-testHet bewijs is dat nexus-gates afsluit met 0, waarbij scope-adherence, one-fence, migrations-are-scoped, crud-adherence en api-contract allemaal slagen. Reken erop dat de eerste uitvoering op de meeste punten zal mislukken; de onze rapporteerde elke route als niet-afgebakend (unscoped), omdat de eerste opzet vertrouwde op headers die de browser zelf kon instellen. De poorten hebben bewust geen automatische hersteloptie.
Ingepakte apps werken op elke editie. Implementatie verloopt uitsluitend via de releasekanalen van de installatie, dus negeer eventuele implementatiebestanden die het concept heeft weggeschreven. Het isolatiewerk is waar de tijd in gaat zitten: reken voor een echte app op dagen, niet op uren.


