Versjon 1.0.0-alpha.1nyeste
Kapittel 2.24
Bygge en tilpasset vertikal fra start til slutt
En gjennomarbeidet bygging av domenepakken Cold chain, fra den første spesifikasjonen til en utgivelse som kjører for hver enhet, med dens kunnskapsmodell, linser, en ferdighet, en fullservice-plugin og eksempeldata. Deretter hvordan du utvider en pakke som allerede finnes, og hvordan du legger til en linse i en som allerede er levert.
Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

Jeg er Mateo Ruiz, en utvikler hos Corrán Orbital. Det meste av uken min går med til vår egen nyttelastprogramvare, men dette kapittelet handler om et oppdrag vi gjorde for en kunde. Larkfield & Vane forsikrer last, og en økende andel av den fraktes i kjølecontainere. Når en kjølecontainer mister landstrøm på kaien, stiger temperaturen, lasten blir ødelagt, og et erstatningskrav følger uker senere. Larkfield ønsket at folkene deres skulle se denne kjeden som én helhet i Nexus, fra strømfeilen til erstatningskravet, der hver rolle bare ser sin del. Det ble til pakken Cold chain.
Det som følger, er byggeprosessen i den rekkefølgen vi utførte den, med skjermbildene, filene og kommandoene. Jeg har beholdt feilene, fordi to av avvisningene vi støtet på, lærte oss mer om plattformen enn den problemfrie ruten gjorde. Referansematerialet finnes i kapitlene før dette, og jeg viser til dem i stedet for å gjenta dem. De jeg støttet meg mest på, var kapittel 2.18, Utvidelsesmodellen, og kapittel 2.23, Domenepakker, med kapittel 2.21, Plugin SDK-et, åpent ved siden av for selve programvareutviklingssettet.
Spesifikasjonen, og hvem som gjør hva
Larkfield ga meg en utviklerplass i organisasjonen sin for hele prosjektperioden. Det har betydning, fordi en privat pakke for én kunde bygges inne i den kundens installasjon, på dens utviklingsområder og datagrener, under godkjenning av kundens egne folk. En pakke ment for mange kunder bygges annerledes, på en utgiverklynge med kun eksempeldata, og kapittel 2.25, Bygging for hver utgave, dekker det tilfellet.
Oppdragsbeskrivelsen fikk plass på én side:
- Kjølecontainere på kaien og på fartøy: strømforsyningen deres, temperaturavvikene deres og erstatningskravene som følger.
- To roller til å begynne med: en kjøletekniker på kaien og en kjølekjedekontrollør på kontoret.
- En pilot som kjører i Rotterdam-enheten først og flyttes til Felixstowe etterpå.
- Dokumentasjon for tre regelverk: ATP-avtalen for lett bedervelige næringsmidler, EUs gode distribusjonspraksis for legemidler, og mattrygghetsregistreringer under HACCP (fareanalyse og kritiske styringspunkter). Erstatningskrav under Haag-Visby-reglene bruker de samme avviksregistreringene, så vi noterte dem til etter piloten.
Domenepakker er en Enterprise-funksjonalitet. Larkfield kjører Enterprise, så ruten for domenepakker var åpen for meg. På Community tilbys ikke standardruten for en pakke i det hele tatt.
Start fra hovedsporet
Alt starter på siden Start noe nytt. Den tilbyr seks standardruter: plugin, domenepakke, linse, plattform, ferdighet og arbeidsflyt. Hver av dem oppretter et kodelager fra en versjonsstyrt mal, et manifest som deklarerer hva komponenten trenger, tester, et utviklingsområde og datagrener. De samme rutene fungerer i konsollen, på kommandolinjen og fra ditt IDE (integrert utviklingsmiljø), der Workbench-verktøyet nexus.create gjør den samme jobben med en plan du bekrefter først.
nexus create-kommando og dens låste mal. Legg merke til skiltet nederst: manifestet håndheves og er ikke kun veiledende, og en utgivelse som ber om mer, holdes tilbake til to personer har gjennomgått den.Vi valgte domenepakkeruten fra den siden, ga pakken navnet cold-chain og dens første enhet Rotterdam. Resultatet oppgir den låste malen, domain-pack@1.6.0, og lister opp hva den opprettet: kodelageret, et manifest som deklarerer fire virkeområder, to lagre og ingen utgående adresser, 66 tester fra malen, et utviklingsområde i Rotterdam, tre syntetiske datagrener og en utkastoppføring i Larkfields egen katalog som bare jeg kunne se. Malversjonen er låst, og en senere oppgradering kommer som en gjennomgått endring lik alle andre, slik at ingens pakke endrer seg under dem fordi en mal ble endret. Jeg brukte uansett konsollveiviseren for den første pakken vår, fordi den viser planen før den oppretter noe.
Trinn 1: si hva pakken er til for
Veiviseren Ny domenepakke har tre trinn: om pakken, kunnskapsmodell samt gjennomgå og opprett. Trinn 1 spør om de få tingene som former alt som kommer etterpå.
| Felt | Hva vi la inn | Merk |
|---|---|---|
| Navn | Kjølekjede | Brukes til kodelageret og katalogen |
| Hva den er til for | Kjølecontainere på kaien og på fartøy: strøm, temperaturavvik og erstatningskravene som følger | |
| Bransje | Logistikk og maritim sektor | Bygger på pakken Logistikk og maritim virksomhet |
| Eier | Personen som oppretter den | Låst i veiviseren |
| Enheter | Rotterdam (pilot) | Felixstowe etter piloten |
| Mal | domain-pack@1.6.0 |
Låst; oppgraderinger kommer som gjennomgåtte endringer |
| Regler den kartlegger | ATP-avtalen, EUs gode distribusjonspraksis, mattrygghetsregistreringer | Hver regel blir en side i pakkens dokumentasjonskart |
Assistenten i dokken foreslo den siste raden, inkludert poenget om at erstatningskrav for last gjenbruker de samme avviksregistreringene. Et skilt nederst på siden sier at ingenting er opprettet ennå. Kodelageret, utviklingsområdet og datagrenene opprettes først når du trykker på Opprett på trinn 3, etter at du har sett planen. Du kan lagre et utkast og komme tilbake.
Trinn 2: kunnskapsmodellen
Kunnskapsmodellen er settet av typer ting pakken kjenner til, og hvordan de henger sammen. Cold chain startet fra grunnmodellen for logistikk, logistics-base 4.2, importert fra SDK-et, noe som ga oss fem grunntyper å bygge på (Vessel, Port, Container, Carrier og Shipment). Grunntyper er skrivebeskyttet i veiviseren. Hvis en må endres, endres den i pakken som eier den.
Vi la til fem egne typer:
| Type | Hva det er | Egenskaper |
|---|---|---|
| Kjøleenhet | En kjølecontainer | 9 |
| Fartøysanløp | Ett fartøy ved én kaiplass | 6 |
| Avvik | En temperatur utenfor grenseverdiene | 8 |
| Strømforsyning | Et strømpunkt på land eller skip | 4 |
| Gjør krav på | Krevd beløp for ødelagt last | 7 |
Hver egenskap klassifiseres når du oppretter den. «Rapportert av» på en Excursion er personlig. «Lasteverdi i fare» samt et kravs beløp og oppgjør er kommersielle. Dette føltes som papirarbeid første dagen og reddet oss to ganger senere, fordi klassene avgjør hva en linse kan vise, hva en maskert kopi erstatter, og hva en logglinje skjuler.
To av relasjonene våre strekker seg inn i grunnmodellen: en Reefer unit er koblet til en Power supply, og et Claim viser til en Shipment. Selve grunnmodellen endres ikke. En egenskap du trekker tilbake, blir værende i versjon 1.0 av modellen og fjernes først i en senere versjon, slik at ingenting som gjaldt for gamle oppføringer, slutter å være lesbart.
Trinn 3: gå gjennom og opprett
Trinn 3 er planen. Den lister opp hva som vil bli opprettet, virkeområdene manifestet vil deklarere, datagrenene og utviklingsområdet. Du bekrefter planen med passnøkkelen din, og planen får et fingeravtrykk. Opprettelsen følger deretter den planen nøyaktig, ett trinn om gangen, og du kan stoppe ved ethvert trinn og beholde det som ble opprettet.
Planen for Cold chain deklarerte fire virkeområder:
| Virkeområde | Hvorfor pakken trenger det |
|---|---|
| Lese kjøletelemetri | Strøm- og temperaturmålinger |
| Skrive avvik | Registrerer et avvik når grenseverdier brytes |
| Lese forsendelser | Knytter et erstatningskrav til tilhørende forsendelse |
| Lage utkast til kravnotater | Kun utkast; en person sender |
Lagrene dens var grafen og oppføringene. Den hadde ingen utgående adresser og sandkasseprofilen Standard. Utviklingsområdet kom med 4 kjerner, 16 GiB minne og 50 GiB lagring, et nettverk som er lukket bortsett fra det manifestet deklarerer, kun signerte avbildninger, og avslutning etter 7 inaktive dager. Når det avsluttes, blir definisjonen liggende i kodelageret, slik at du kan opprette det på nytt derfra.
De tre datagrenene kom fra den syntetiske generatoren. Ingen kundedata ble kopiert. En maskert kopi av Rotterdam krever samtykke fra dataeieren, som hos Larkfield er Priya Natarajan, og du ber om det separat.
Pakkemanifestet
Kodelageret inneholder pakkens manifest, pack.json. Det oppgir pakkens navn, versjonen, pakken den arver fra (hvis noen), klyngene og ordene dens. En klynge er enten en linse, som er det én rolle ser inne i pakken, eller delt, som går på tvers av alle linser. Her er kjernen i vår:
{
"id": "cold-chain",
"name": "Cold chain",
"version": "0.4.0",
"clusters": [
{
"id": "CC01",
"kind": "lens",
"name": "Reefer technician",
"seats": "Technicians on the quay",
"purpose": "Which reefers have lost power or warmed up, and what to do next.",
"lexicon": ["cold"],
"menu": [],
"screens": []
},
{
"id": "CC02",
"kind": "lens",
"name": "Cold-chain controller",
"seats": "Controllers in the operations office",
"purpose": "Every excursion from first reading to closed claim, with its evidence.",
"lexicon": ["cold"],
"menu": [],
"screens": []
}
],
"lexicon": {
"core": [],
"cold": [
["excursion", "a time when the temperature left its limits", ""],
["set point", "the temperature a reefer is told to hold", ""],
["shore power", "electricity from the quay rather than the ship", ""]
]
}
}Ordlisten inneholder pakkens egne ord med en enkel forklaring for hvert av dem, kort nok til å leses på en telefon.
Ved siden av pack.json deklarerer manifestet også hva pakken kan nå: dens virkeområder, lagre, utgående adresser og sandkasseprofil. Nexus innvilger nøyaktig dette og ingenting mer. Hvert verktøykall sjekkes mot de deklarerte virkeområdene, og en ekstern adresse blokkeres med mindre den står på listen. Du kan lese deklarasjonen, og endringen sammenlignet med forrige utgivelse, på pakkens side Manifest og tillatelser.
Linser: hva hver rolle ser
En linse kan bare snevre inn det grunnlinse viser, og den ene regelen formet mer av designet vårt enn noen annen. En linse viser en del av det grunnlinse viser, og tillatelser kommer fortsatt fra roller: en linse avgjør hva en rolle ser i pakken, ikke hva den har lov til å gjøre.
Linsen Reefer technician snevrer inn Operations controller, grunnlinsen Larkfield allerede bruker for logistikkarbeid. I Linsebyggeren krysser du av for kortene, feltene og handlingene linsen skal vise. Elementer som grunnlinsen ikke viser, er låst.
| Del | Reefer technician viser | Utelatt |
|---|---|---|
| Kort | Kjøleenheter på kaien, åpne avvik, strømpunkter, fartøysanløp i dag | Alt som gjelder erstatningskrav |
| Felter | Strømstatus, settpunkt, siste måling, høyeste temperatur | Kravbeløp (ikke i grunnlinsen), personlige felter (av som standard) |
| Handlinger | Registrere en avviksårsak, be om en strømsjekk | Endre et settpunkt og lukke et avvik (kun kontrollører), lage utkast til kravnotat |
Jeg prøvde likevel å legge til kravbeløp i teknikerlinsen, fordi en tekniker hadde bedt om det. Byggeren avviste det med LENS_CANNOT_WIDEN og lagret ingenting. Det finnes ingen omvei inne i linsen: veien videre er en linse på en bredere grunnlinse, en annen forespørsel som organisasjonsadministratoren avgjør. Vi utelot det.
Å skjule noe i en linse fjerner det ikke fra Nexus. Det betyr at denne rollen ikke ser det. Byggeren viser hvor mange personer en linse vil nå i piloten (29 i vårt tilfelle) og fører en logg over hver Legg til, Endre og Trekk tilbake. En linse defineres én gang for organisasjonen og tildeles per enhet til en plattformrolle, slik at den samme Reefer technician-linsen kan gis til teknikerne i Rotterdam denne måneden og i Felixstowe neste måned.
En ferdighet for å utarbeide kravnotater
Kontrollørene ønsket et førsteutkast til notatet som sendes til en lasteeier etter et avvik. Det er språkarbeid, så det kjører på en modell, og spørsmålet var hvor vi skulle plassere det.
Det finnes to typer ferdigheter i Nexus, og forskjellen har betydning her. En manifestferdighet er en typet rad i en plugins skills[], som sendes ut av plattformen. En Skills Engine-ferdighet er en SKILL.md-pakke i organisasjonens ferdighetsbibliotek, som agenter, KI-knapper (kunstig intelligens), arbeidsflyter og utviklerverktøy alle kjører på samme måte. Kapittel 2.20, Ferdigheter, dekker begge.
Tillitsnivået for pluginen vår er community, og en fellesskapsplugin kan bare deklarere manifestferdigheter som ikke når en modell (host_callback og plugin_queue). De to nivåene som når AI Provider Router, tool_using og llm_only, krever tillitsnivå core eller verified. Dermed ble utarbeidelse av kravnotater en Skills Engine-ferdighet, og ruteren velger modellen fra Larkfields egen ressursgruppe:
---
name: draft-claim-note
description: Draft a note to a cargo owner about one reefer excursion, from the excursion record and its readings. Drafts only; a person reviews and sends.
allowed-tools: Read, Grep
triggers:
- /draft-claim-note
capabilities:
- name: draft_note
description: Write a first draft for one excursion
version: 1.0.0
---
# Draft a claim note
Use this when a controller asks for a note about one excursion.
## Steps
1. Read the excursion: unit, start, length, highest temperature and cause.
2. Read the shipment it belongs to, for the cargo owner's name.
3. Write four short paragraphs: what happened, when, what the readings show, what happens next.
4. Never state a claim amount. Never send anything.Pakken ligger i skills/draft-claim-note/ i kodelageret, der mappenavnet er lik ferdighetens navn. Vi validerte og lastet den opp fra terminalen:
npm run skill:validate skills/draft-claim-note
npm run skill:upload skills/draft-claim-note --dry-run
npm run skill:upload skills/draft-claim-noteOpplasting av samme innhold to ganger returnerer den eksisterende versjonen i stedet for en ny (CONTENT_HASH_ALREADY_PUBLISHED), så det er trygt å kjøre opplastingen på nytt. Før en versjon tas i bruk, kjører Skills Engine testtilfellene sine, en prøvekjøring i skyggemodus på tidligere arbeid, og en blind gjennomgang utført av en modell fra et annet selskap, med tid og kostnad for hver kjøring.
Fullservice-pluginen
Pakken trengte også kode som kjører hele tiden: en leser for strømmen av kjøletelemetri, og en skriver som åpner en avviksoppføring når en måling bryter grenseverdiene. Slik kode hører hjemme i en fulltjeneste-plugin, og vi genererte rammeverket med SDK-ets egen kommando, som skriver hele referansetreet med navnet satt inn:
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin scaffold cold-chain --tier full-service
cd cold-chain
npm install
npm ci
npm run typecheck && npm test && npm run build
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testSDK-et installeres fra https://registry.adverant.ai/npm/ med hentetokenet fra siden Hentetokener og installeringskommandoer på Adverant-kontoen din. Sjekk inn package-lock.json-filen som den første installasjonen skriver; avbildningsbygget kjører npm ci og avviser bygget uten en slik fil.
Her er den delen av vår nexus.manifest.json som skiller seg fra malen. Det er ikke hele filen: rammeverkets blokker description, author, license, runtime, backend og frontend forblir som de er, og validatoren avviser et fulltjenestemanifest uten dem. De tre architecture-setningene er regelen enhver plugin gjentar, og validatoren sjekker ordlyden. UNO i den første er arbeidsflytmotoren:
{
"manifestVersion": "2",
"name": "cold-chain",
"displayName": "Cold chain",
"version": "0.4.0",
"tier": "full-service",
"trust": "community",
"architecture": {
"compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
"ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
"deploy": "Deploy is through the installation's release channels only."
},
"api": {
"version": "1",
"basePath": "/",
"endpoints": [
{ "method": "GET", "path": "/health", "summary": "Liveness", "auth": "public", "allowAnonymous": true },
{ "method": "GET", "path": "/api/excursions", "summary": "List the unit's excursions", "auth": "scope", "right": "excursion.read", "needsUnit": true },
{ "method": "POST", "path": "/api/excursions", "summary": "Record an excursion", "auth": "scope", "right": "excursion.create", "needsUnit": true },
{ "method": "POST", "path": "/internal/skills/excursion_open", "summary": "host_callback receiver the platform POSTs to", "auth": "internal" }
]
},
"rights": {
"excursion.read": { "summary": "Read the unit's excursions.", "roles": ["owner", "admin", "member", "viewer"] },
"excursion.create": { "summary": "Record an excursion.", "roles": ["owner", "admin", "member"] }
},
"skills": [
{
"id": "excursion_open",
"displayName": "Open an excursion",
"description": "Open an excursion record when a reading breaks its set point limits. No model; runs in the plugin's own backend.",
"tier": "host_callback",
"classification": "tenant",
"dataResidency": "eu",
"inputSchema": { "type": "object", "properties": { "readingId": { "type": "string" } }, "required": ["readingId"] },
"outputSchema": { "type": "object", "properties": { "opened": { "type": "boolean" } }, "required": ["opened"] },
"hostCallback": {
"service": "cold-chain",
"port": 8080,
"path": "/internal/skills/excursion_open",
"maxRequestBytes": 65536,
"maxResponseBytes": 16384,
"tenantHeader": "X-Organization-ID"
},
"timeoutMs": 10000
}
],
"changePolicy": {
"enabled": true,
"classes": ["website", "bff", "migration"],
"approvals": { "website": 1, "bff": 1, "migration": 2 }
}
}excursion_open er en manifestferdighet på nivået host_callback: plattformen sender inndataene til vår egen Service, inne i navnerommet vårt, og aldri til en vert vi oppgir. Mottakerruten er deklarert som auth: internal og beskyttet med SDK-ets serviceMiddleware, Express-formen av vakten, som avviser et kalltoken utstedt for enhver annen plugin, organisasjon, ferdighet eller rute. Dens classification er tenant, som er taket for en fellesskapsplugin. Kapittel 2.27, Byggescenarier, gjennomgår en host_callback-ferdighet på egen hånd.
To vaner fra dette stadiet er verdt å kopiere. Hver tabell har med organization_id, owner_user_id og business_unit_id fra den første migreringen, fordi det å legge til en akse senere krever en migrering over aktive rader. Og vi kjørte nexus-gates lokalt før hver innsending, siden det er den samme kommandoen som leveransekjeden kjører; en kjøring som ikke undersøkte noe, avslutter med kode 2 og sier fra om det. Kapittel 2.19, Reglene enhver utvidelse arver, lister opp kontrollportene.
Eksempeldata for testing
Siden Eksempeldata for testing tilbyr tre typer grener:
| Type | Hva den inneholder | Hvem som godkjenner |
|---|---|---|
| Syntetisk | Data generert fra antall og former du angir; ingenting kommer fra en reell enhet | Ingen; den er din |
| Maskert kopi | En kopi av en enhet der personlige, sensitive og kommersielle felter er erstattet | Dataeieren (Priya Natarajan for Rotterdam) |
| Kun skjema | Formen på lagrene, uten rader | Ingen; for migreringer |
Vi genererte en travel uke: omtrent 7 avvik per 100 kjølecontainere, som er slik en travel august ser ut i Rotterdam. Særtilfellene var viktigere enn volumet. Vi ba om strømbrudd under lossing, en dør som ble stående åpen, et sensoravbrudd og to erstatningskrav for ett avvik. Siden kan foreslå særtilfeller ut fra avviksårsakene i kunnskapsmodellen, aldri fra reelle oppføringer.
Hvert sett med antall og former lagres som en startverdi, slik som cold-chain-busy-01, med tilhørende fingeravtrykk. Den samme startverdien gir de samme dataene, slik at hver testkjøring på hver gren ser den samme uken. Det var dette som gjorde de 66 testene våre repeterbare.
En gren lever i 72 timer som standard og høyst i 14 dager. Jeg ba om å beholde den travle grenen vår i 30 dager under en lang gjennomgang, og siden avviste det med BRANCH_LIFE_EXCEEDED. Løsningen er den som skiltet foreslår: behold startverdien, og opprett en ny gren fra den når du trenger en. En maskert kopi følger de samme grensene, og forespørselen om den inneholder en begrunnelse og en varighet på opptil 14 dager.
Forhåndsvis en linse som en person
Før noen i Rotterdam så Cold chain, så vi på den slik de ville se den. Forhåndsvis en linse som en person gjengir pakken nøyaktig slik en valgt rolle ser den, på en datagren, inne i en stiplet forhåndsvisningsramme.
Tre regler gjør det trygt å bruke forhåndsvisninger fritt. En forhåndsvisning bruker en datagren, aldri den aktive enheten. Dine egne tillatelser lekker ikke inn i den, så du ser det rollen ser, og ikke det du selv kan se. Og den avsluttes etter 30 minutter. Å peke en forhåndsvisning mot en aktiv enhet avvises med CONNECTION_SCOPE_EXCEEDED; hvis du trenger reelle former, ber du dataeieren om en maskert kopi og forhåndsviser på den.
Det var i forhåndsvisningen vi oppdaget en reell feil. Temperaturdiagrammet i teknikervisningen viste settpunktet, og redigering av settpunkt var kun ment for kontrollører. Diagrammet var greit; redigeringsknappen under det var det ikke. Versjon 0.3.2 skjulte redigering av settpunkt for teknikere, og det var i forhåndsvisningen vi fant feilen.
Endre kunnskapsmodellen etter at den er levert
Innen versjon 0.4.0 trengte vi en Inspection-type for inspeksjoner før avgang, og relasjonen «Excursion caused Claim» fungerte bedre som «Excursion led to Claim». Å flytte modellen fra 1.3 til 1.4 er en kunnskapsmodellendring, og siden Endringer i kunnskapsmodell viser forskjellen, hva den vil berøre, og hvor langt den har kommet.
Endringen sendes som en endringsforespørsel for grafen. Prøvekjøringen teller hva den ville berørt på Rotterdams maskerte kopi, oppgitt i antall: for oss ble 1 284 koblinger omdøpt og ingenting fjernet. To kontrollører godkjenner den, og leveransekjeden legger den inn i testmiljøet, deretter i piloten. Ingen skriver til den delte grafen for hånd; et forsøk blir avvist og loggført. Tre lagrede spørsmål brukte ordet «caused», og endringen inneholdt en automatisk omskriving for hvert av dem, som siden listet opp. Linsefiltrene ble ikke endret, fordi begge linsene fortsatt bare snevret inn.
Forfrem til produksjon
Hver utgivelse følger én rute: utviklingsområde, testmiljø, en pilotenhet, deretter alle enheter. Hvert trinn har kontrollporter, og ingenting hopper over en port.
| Inn i | Portvakter |
|---|---|
| Testmiljø | Alle tester bestått; kvalitetskontroller; manifest uendret eller utvidelsen godkjent; signert avbildning |
| Pilot (Rotterdam) | Prøvekjøring av modellendring på den maskerte kopien uten feil; policykontroll av linse- og virkeområderegler; to kontrollører som ikke er forfatteren, hvorav den ene er dataeieren |
| Alle enheter | 14 dager i piloten; feil under 1 av 1 000, telt i piloten; hver enhetsadministrator godkjenner for sin enhet; to kontrollører som ikke er forfatteren |
Jeg prøvde snarveien én gang, på en fredag, for en fiks på én linje: å forfremme 0.4.0-dev fra utviklingsområdet mitt til alle enheter. Det ble avvist med GATE_CANNOT_BE_SKIPPED, og ingenting ble forfremmet. Skiltet ber deg om å forfremme til neste trinn i stedet, og det er det eneste svaret som finnes.
Selve utgivelsesgjennomgangen, dokumentasjonen en andre kontrollør leser, og kanalene enhetene velger, finnes i kapittel 2.28, Utgivelse av utvidelsen din. To fakta derfra hører hjemme her, fordi de former hvordan du planlegger en bransjeløsning. Forfatteren teller aldri som kontrollør, så et team på to personer trenger en tredje person for hver utgivelse. Og hvert miljø beholder den forrige versjonen i 30 dager, slik at tilbakerulling er en gjennomgått endring som leveransekjeden utfører på omtrent et minutt.
Utvide en pakke som allerede finnes
Ikke alle bransjeløsninger starter fra bunnen av. En pakke kan arve fra en annen og bare legge til det som er forskjellig. Pakken Banking and payments, som Larchmont Bank bruker, er det tydeligste eksempelet i katalogen. Manifestet dens starter slik:
{
"id": "fintech",
"name": "Banking and payments",
"version": "0.1",
"inherits": "insurance",
"clusters": [
{
"id": "FL01",
"kind": "lens",
"name": "Lending decisions",
"seats": "Credit analysts, underwriters of loans, credit committee",
"purpose": "Whether to lend, how much, at what price, and writing down why.",
"lexicon": ["fin"],
"menu": [],
"screens": []
}
],
"lexicon": {
"core": [],
"fin": [
["APR", "the yearly cost of borrowing, fees included", "exact"],
["mandate", "the most one person may lend alone", ""]
]
}
}inherits oppgir pakken den bygger på. Banking and payments beholder Insurance-pakkens form, dens delte samtaleklynger og kjerneordene dens, og legger til tre egne linser: Lending decisions, Card disputes og My account. Det tredje elementet i hver ordlisteoppføring er exact for et begrep som må vises slik det er skrevet, som APR (annual percentage rate), i stedet for å bli omformulert.
Noen ting kan du ikke gjøre ved å arve. En pakke endrer aldri skallet, komponentene eller skrivereglene, så en underpakke kan ikke endre utseendet på konsollen. Et regelverk som flere pakker trenger, utgjør én delt linse i stedet for en kopi i hver: registeret over utkontraktert teknologi betjener både Insurance og Banking and payments. Hvis underpakken din trenger en linse som allerede finnes som en delt linse, bruker du den i stedet for å lage din egen.
Lisensiering følger arven. En pakke lisensieres på toppen av Enterprise og kan kreve tilleggsmoduler, og lisensdokumentet inneholder disse avhengighetene. Insurance krever Decision rooms and sealed records, så en kunde som lisensierer en pakke som arver fra den, trenger også den tilleggsmodulen, og konsollen nekter å utstede en lisens som utelater den. En pakkes telefonskjermer krever også tilleggsmodulen Mobile apps. Sjekk kravkjeden før du lover en kunde en dato.
Legge til en linse i en pakke som er levert
Det minste vertikale arbeidet er en ny linse på en pakke du ikke har skrevet selv. Seks måneder ut i piloten ønsket Larkfields team for sjøforsikringskrav sin egen linse i Cold chain: avvik og krav, ingen strømpunkter, ingen settpunkter. Vi rørte ikke pakkens kode. En linse er en rad i organisasjonens linseregister som eies av pakken, så vi startet den fra standardforløpet for linser på Start noe nytt, og utformet den i Linsebyggeren med linsen Cold-chain controller som grunnlag. Den samme regelen gjelder som før: den nye linsen kan skjule det grunnlaget viser, men kan aldri vise mer. Den defineres én gang for organisasjonen og tildeles en plattformrolle i hver enhet. En tildeling trekkes tilbake og slettes aldri, og det å gi linsen på nytt oppretter en ny tildeling, slik at det forblir lesbart hvem som hadde hvilken linse når. Registeret teller hvor mange personer som hadde en linse hver måned, aldri hvem.
Siden Linser og hvem som ser dem viser resultatet som en matrise med linser etter enhet og rolle, med Legg til, Endre og Trekk tilbake i hver celle. Forhåndsvis den nye linsen som en person før du tildeler den, nøyaktig som ovenfor.
Hva det kostet, helt ærlig
En pakke berører kundens oppføringer, så plattformen gjør enkelte ting trege med hensikt, og du bør planlegge for dette fra dag én.
- En maskert kopi krever dataeierens samtykke hver gang. Vår tok en dag å få på plass første gang, fordi Priya ville lese kunnskapsmodellen først. Start med syntetiske data og spør tidlig.
- Forfatteren kan ikke godkjenne sin egen utgivelse, og forespørsler utløper etter 3 dager. Hvis kontrollørene dine er opptatt, må utgivelsen vente.
- En utgivelse som ber om mer enn den forrige, for eksempel å sende e-post eller bruke én ekstern adresse, holdes tilbake til to kontrollører godtar det utvidede manifestet. Kapittel 2.28, Utgivelse av utvidelsen din, viser siden Manifest og tillatelser, som gir deg beskjed før du spør.
- En linse kan ikke vise det grunnlinjen skjuler. Hvis en rolle virkelig trenger mer, er det en samtale med organisasjonsadministratoren, ikke en innstilling.
Ingen av disse tingene kom i veien for oss to ganger. Den andre utgivelsen av Kjølekjede tok en uke fra første innsending til Rotterdam-piloten, der mesteparten av tiden gikk med til de 66 testene som kjørte mot tre grener, og to personer som leste gjennom dokumentasjonen.




