Logga inBoka en genomgång

Kapitel 2.24

Bygga en anpassad vertikal från grunden

Ett genomarbetat bygge av domänpaketet för kylkedja, från den första kravspecifikationen till en driftsatt utgåva för varje enhet, med dess kunskapsmodell, linser, en färdighet, ett komplett tjänsteinsticksprogram och exempeldata. Därefter hur man utökar ett befintligt paket och hur man lägger till en lins i ett paket som redan har levererats.

Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

19 minuters läsning

Jag heter Mateo Ruiz och är utvecklare på Corrán Orbital. Det mesta av min vecka går åt till vår egen nyttolastprogramvara, men det här kapitlet handlar om ett uppdrag vi utförde åt en kund. Larkfield & Vane försäkrar last, och en växande andel av den fraktas i kylcontainrar. När en kylcontainer tappar landström vid kajen stiger temperaturen, lasten förstörs och ett skadeärende följer veckor senare. Larkfield ville att deras medarbetare skulle se den kedjan som en helhet i Nexus, från strömavbrottet till skadeärendet, där varje roll bara ser sin del. Det blev paketet Cold chain.

Här följer bygget i den ordning vi genomförde det, med skärmarna, filerna och kommandona. Jag har behållit misstagen, eftersom två av de nekanden vi stötte på lärde oss mer om plattformen än vad den felfria vägen gjorde. Referensmaterialet finns i kapitlen före detta, och jag hänvisar till dem snarare än att upprepa dem. De jag lutade mig mest mot var kapitel 2.18, Utökningsmodellen, och kapitel 2.23, Domänpaket, med kapitel 2.21, Plugin SDK, öppet bredvid för själva programutvecklingspaketet.

Ett flöde från vänster till höger med åtta rutor: "Uppdragsbeskrivning", "Gyllene väg", "Kunskapsmodell", "Linser", "Färdighet och plugin", "Exempeldata och förhandsgranskning", "Lanseringsgranskning", "Befordran". Under den sista rutan visar en andra rad med fyra mindre rutor sammanbundna med pilar stegen för befordran: "Utvecklingsutrymme", "Staging", "Pilotenhet (Rotterdam)", "Alla enheter", med en hänglåssymbol på varje pil märkt "grind". En streckad pil från "Utvecklingsutrymme" rakt till "Alla enheter" är överkorsad och märkt GATE_CANNOT_BE_SKIPPED.
Cold chain-bygget, från kravspecifikationen till varje enhet.

Kravspecifikationen och vem som gör vad

Larkfield gav mig en utvecklarplats i sin organisation under projektets gång. Det spelar roll, eftersom ett privat paket för en enskild kund byggs inuti den kundens installation, på dess utvecklingsytor och datagrenar, med godkännanden från dess personal. Ett paket avsett för många kunder byggs på ett annat sätt, på ett utgivarkluster med enbart exempeldata, och kapitel 2.25, Bygga för respektive utgåva, täcker det fallet.

Kravspecifikationen rymdes på en sida:

  • Kylcontainrar vid kaj och på fartyg: deras strömförsörjning, deras temperaturavvikelser och de skadeärenden som följer.
  • Två roller till att börja med: en kylcontainertekniker på kajen och en kylkedjekontrollant på kontoret.
  • En pilot som körs i Rotterdam-enheten först och flyttas till Felixstowe därefter.
  • Underlag för tre regelverk: ATP-konventionen för lättfördärvliga livsmedel, EU:s goda distributionssed för läkemedel samt livsmedelssäkerhetsregister enligt HACCP (faroanalys och kritiska styrpunkter). Skadeärenden enligt Haag-Visby-reglerna använder samma avvikelseregister, så vi noterade dem för tiden efter piloten.

Domänpaket är en Enterprise-funktion. Larkfield kör Enterprise, så vägen för domänpaket var öppen för mig. I Community erbjuds inte den gyllene vägen för ett paket överhuvudtaget.

Utgå från standardvägen

Allt börjar på sidan Starta något nytt. Den erbjuder sex gyllene vägar: plugin, domänpaket, lins, plattform, färdighet och arbetsflöde. Var och en skapar ett kodförråd från en versionshanterad mall, ett manifest som deklarerar vad komponenten behöver, tester, en utvecklingsyta och datagrenar. Samma vägar fungerar i konsolen, på kommandoraden och från er IDE (integrerad utvecklingsmiljö), där Workbench-verktyget nexus.create gör samma jobb med en plan som ni bekräftar först.

Starta något nytt
Starta något nytt
De sex gyllene vägarna, var och en med vad den skapar, sitt nexus create-kommando och sin låsta mall. Lägg märke till skylten längst ned: manifestet är tvingande, inte rådgivande, och en utgåva som begär mer hålls kvar tills två personer har granskat den.

Vi valde vägen för domänpaket från den sidan, gav paketet namnet cold-chain och dess första enhet Rotterdam. Resultatet anger den låsta mallen, domain-pack@1.6.0, och listar vad den skapade: kodförrådet, ett manifest som deklarerar fyra behörighetsområden, två datalager och inga utgående adresser, 66 tester från mallen, en utvecklingsyta i Rotterdam, tre syntetiska datagrenar och en utkastpost i Larkfields egen katalog som bara jag kunde se. Mallversionen är låst, och en uppgradering av den senare kommer som en granskad ändring precis som alla andra, så att ingens paket ändras under fötterna på dem för att en mall har ändrats. Jag använde ändå konsolguiden för vårt första paket, eftersom den visar planen innan den skapar något.

Steg 1: ange vad paketet är till för

Guiden Nytt domänpaket har tre steg: om paketet, kunskapsmodell samt granska och skapa. Steg 1 frågar efter de få saker som formar allt som kommer därefter.

Fält Vad vi angav Obs
Namn Cold chain Används för kodförrådet och katalogen
Vad det är till för Kylcontainrar vid kaj och på fartyg: strömförsörjning, temperaturavvikelser och de skadeärenden som följer
Bransch Logistik och sjöfart Bygger på paketet Logistik och sjöfart
Ägare Personen som skapar det Låst i guiden
Enheter Rotterdam (pilot) Felixstowe efter piloten
Mall domain-pack@1.6.0 Låst; uppgraderingar kommer som granskade ändringar
Regler det kartlägger ATP-konventionen, EU:s goda distributionssed, livsmedelssäkerhetsregister Varje regel blir en sida i paketets beviskarta

Assistenten i dockan föreslog den sista raden, inklusive poängen att lastskadeärenden återanvänder samma avvikelseregister. En skylt längst ned på sidan anger att ingenting har skapats ännu. Kodförrådet, utvecklingsytan och datagrenarna skapas först när ni trycker på Skapa i steg 3, efter att ni har sett planen. Ni kan spara ett utkast och komma tillbaka.

Steg 2: kunskapsmodellen

Kunskapsmodellen är uppsättningen av typer av objekt som paketet känner till och hur de är länkade. Cold chain utgick från basmodellen för logistik, logistics-base 4.2, importerad från SDK:t, vilket gav oss fem bastyper att bygga vidare på (Vessel, Port, Container, Carrier och Shipment). Bastyper är skrivskyddade i guiden. Om en behöver ändras, ändras den i det paket som äger den.

Vi lade till fem egna typer:

Typ Vad det är Egenskaper
Reefer unit En kylcontainer 9
Vessel call Ett fartyg vid en kajplats 6
Excursion En temperatur utanför gränsvärdena 8
Power supply En strömpunkt på land eller ombord på fartyg 4
Gör anspråk Begärt belopp för förstörd last 7
Nytt domänpaket: kunskapsmodell
Nytt domänpaket: kunskapsmodell
Kunskapsgrafen med fem bastyper och fem nya. Titta på egenskaperna för Excursion till höger: varje egenskap bär sin klass när den skapas, och skylten anger att skadebelopp är kommersiella, så teknikerlinser kan inte visa dem.

Varje egenskap klassificeras när ni skapar den. "Rapporterad av" på en Excursion är personlig. "Lastvärde i farozonen" samt ett skadeärendes belopp och förlikning är kommersiella. Detta kändes som pappersarbete dag ett men räddade oss två gånger senare, eftersom klasserna avgör vad en lins får visa, vad en maskerad kopia ersätter och vad en loggrad döljer.

Två av våra relationer sträcker sig in i basmodellen: en Reefer unit är ansluten till en Power supply, och ett Claim hänvisar till en Shipment. Själva basmodellen ändras inte. En egenskap som ni drar tillbaka stannar kvar i version 1.0 av modellen och försvinner först i en senare version, så ingenting som gällde för gamla poster slutar vara läsbart.

Steg 3: granska och skapa

Steg 3 är planen. Den listar vad som kommer att skapas, de behörighetsområden som manifestet kommer att deklarera, datagrenarna och utvecklingsytan. Ni bekräftar planen med er passnyckel, och planen får ett fingeravtryck. Skapandet följer sedan den planen exakt, ett steg i taget, och ni kan stanna vid vilket steg som helst och behålla det som har skapats.

Planen för Cold chain deklarerade fyra behörighetsområden:

Behörighetsområde Varför paketet behöver det
Läsa kylcontainertelemetri Ström- och temperaturavläsningar
Skriva avvikelser Registrerar en avvikelse när gränsvärden överskrids
Läsa sändningar Länkar ett skadeärende till dess sändning
Skapa utkast till skadeanteckningar Endast utkast; en person skickar

Dess datalager var grafen och posterna. Det hade inga utgående adresser och sandlådeprofilen Standard. Utvecklingsytan levererades med 4 kärnor, 16 GiB minne och 50 GiB lagring, ett nätverk stängt för allt utom det som manifestet deklarerar, endast signerade avbildningar samt ett avslut efter 7 inaktiva dagar. När den avslutas ligger dess definition kvar i kodförrådet, så att ni kan skapa den igen därifrån.

De tre datagrenarna kom från den syntetiska generatorn. Ingen kunddata kopierades. En maskerad kopia av Rotterdam kräver dataägarens godkännande, vilket på Larkfield är Priya Natarajan, och ni ber om det separat.

Paketmanifestet

Kodförrådet innehåller paketets manifest, pack.json. Det anger paketets namn, dess version, det paket det ärver från (om något), dess kluster och dess ord. Ett kluster är antingen en lins, vilket är vad en roll ser inuti paketet, eller delat, vilket körs över varje lins. Här är kärnan i vårt:

{
  "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", ""]
    ]
  }
}

Lexikonet innehåller paketets egna ord med en enkel förklaring för vart och ett, kort nog att läsas på en telefon.

Utöver pack.json deklarerar manifestet också vad paketet får nå: dess behörighetsområden, datalager, utgående adresser och sandlådeprofil. Nexus beviljar exakt detta och ingenting mer. Varje verktygsanrop kontrolleras mot de deklarerade behörighetsområdena, och en extern adress blockeras om den inte är listad. Ni kan läsa deklarationen, och ändringen jämfört med den senaste utgåvan, på paketets sida Manifest och behörigheter.

Linser: vad varje roll ser

En lins kan bara någonsin begränsa vad dess bas visar, och den enskilda regeln formade mer av vår design än någon annan. En lins visar en del av vad dess baslins visar, och behörigheter kommer fortfarande från roller: en lins avgör vad en roll ser i paketet, inte vad den tillåts göra.

Linsen Kylcontainertekniker begränsar Driftkontrollant, den baslins som Larkfield redan kör för logistikarbete. I Linsbyggaren kryssar ni för de kort, fält och åtgärder som linsen visar. Objekt som basen inte visar är låsta.

Del Kylcontainertekniker visar Utelämnat
Kort Kylcontainrar vid kajen, öppna avvikelser, strömpunkter, fartygsanlöp idag Allt som rör skadeärenden
Fält Strömstatus, börvärde, senaste avläsning, högsta temperatur Skadebelopp (finns inte i baslinsen), personliga fält (avstängda som standard)
Åtgärder Registrera en avvikelseorsak, begära en strömkontroll Ändra ett börvärde och stänga en avvikelse (endast kontrollanter), skapa utkast till en skadeanteckning
Linsbyggare
Linsbyggare
Linsbyggaren för Kylcontainertekniker, förkryssad mot sin baslins. Skylten nere till vänster är det nekande ni får om ni kryssar för skadebelopp: baslinsen visar det inte, så den här linsen kan inte göra det.

Jag försökte ändå lägga till skadebelopp i teknikerlinsen, eftersom en tekniker hade bett om det. Byggaren nekade med LENS_CANNOT_WIDEN och sparade ingenting. Det finns ingen genväg inuti linsen: vägen framåt är en lins på en bredare bas, en annan begäran som organisationsadministratören fattar beslut om. Vi utelämnade det.

Att dölja något i en lins tar inte bort det från Nexus. Det betyder att den här rollen inte ser det. Byggaren visar hur många personer en lins kommer att nå i piloten (29 i vårt fall) och för logg över varje Tillägg, Ändring och Tillbakadragande. En lins definieras en gång för organisationen och beviljas per enhet till en plattformsroll, så samma lins för Kylcontainertekniker kan ges till Rotterdams tekniker den här månaden och Felixstowes nästa.

En färdighet för att utforma skadeanteckningar

Kontrollanterna ville ha ett första utkast till det meddelande som går till en lastägare efter en avvikelse. Det är ett språkarbete, så det körs på en modell, och frågan var var det skulle placeras.

Det finns två typer av färdigheter i Nexus, och skillnaden spelar roll här. En manifestfärdighet är en typad rad i en plugins skills[], som skickas iväg av plattformen. En Skills Engine-färdighet är ett SKILL.md-paket i organisationens färdighetsbibliotek, som agenter, AI-knappar (artificiell intelligens), arbetsflöden och utvecklarverktyg alla kör på samma sätt. Kapitel 2.20, Färdigheter, täcker båda.

Vår plugins tillitsnivå är community, och en community-plugin får endast deklarera manifestfärdigheter som inte når en modell (host_callback och plugin_queue). De två nivåer som når AI Provider Router, tool_using och llm_only, kräver tillitsnivå core eller verified. Så att skapa utkast till skadeanteckningar blev en Skills Engine-färdighet, och routern väljer modellen från Larkfields egen pool:

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

Paketet ligger i skills/draft-claim-note/ i kodförrådet, med mappnamnet lika med färdighetens namn. Vi validerade och laddade upp det från 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-note

Att ladda upp samma innehåll två gånger returnerar den befintliga versionen i stället för en ny (CONTENT_HASH_ALREADY_PUBLISHED), så att köra uppladdningen igen är säkert. Innan en version släpps kör Skills Engine sina testfall, en torrkörning i skuggläge på tidigare arbete samt en blind granskning av en modell från ett annat företag, med tid och kostnad för varje körning.

Det kompletta tjänsteinsticksprogrammet

Paketet behövde också kod som körs hela tiden: en läsare för telemetriflödet från kylcontainrarna, och en skrivare som öppnar en avvikelsepost när en avläsning överskrider sina gränsvärden. Sådan kod hör hemma i en fullservice-plugin, och vi skapade grundstrukturen för den med SDK:ts eget kommando, vilket skriver hela referensträdet med namnet utbytt:

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-test

SDK:t installeras från https://registry.adverant.ai/npm/ med den pull-token som finns på sidan Pull-tokens och installationskommandon på ert Adverant-konto. Checka in den package-lock.json som den första installationen skriver; avbildningsbygget kör npm ci och nekar utan en sådan.

Här är den del av vår nexus.manifest.json som skiljer sig från mallen. Det är inte hela filen: grundstrukturens block description, author, license, runtime, backend och frontend förblir som de är, och valideraren nekar ett fullservicemanifest utan dem. De tre architecture-meningarna är den lag som varje plugin upprepar, och valideraren kontrollerar ordalydelsen. UNO i den första är arbetsflödesmotorn:

{
  "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 är en manifestfärdighet med nivån host_callback: plattformen skickar indata till vår egen Service, inuti vår namnrymd, och aldrig till en värd som vi namnger. Mottagarrutten deklareras som auth: internal och skyddas med SDK:ts serviceMiddleware, Express-formen av skyddet, som nekar en anrops-token som utfärdats för någon annan plugin, organisation, färdighet eller rutt. Dess classification är tenant, vilket är taket för en community-plugin. Kapitel 2.27, Byggscenarier, går igenom en host_callback-färdighet på egen hand.

Två vanor från det här steget är värda att ta efter. Varje tabell bär organization_id, owner_user_id och business_unit_id från den första migreringen, eftersom att lägga till en axel senare innebär en migrering över aktiva rader. Och vi körde nexus-gates lokalt före varje push, eftersom det är samma kommando som pipelinen kör; en körning som inte undersökte någonting avslutas med kod 2 och anger detta. Kapitel 2.19, Reglerna som varje utökning ärver, listar kontrollgrindarna.

Exempeldata för testning

Sidan Exempeldata för testning erbjuder tre typer av grenar:

Typ Vad den innehåller Vem som godkänner
Syntetisk Data som genereras utifrån antal och former ni anger; ingenting kommer från en riktig enhet Ingen; den är er
Maskerad kopia En kopia av en enhet där personliga, känsliga och kommersiella fält har ersatts Dataägaren (Priya Natarajan för Rotterdam)
Endast schema Datalagrens struktur, utan några rader Ingen; för migreringar

Vi genererade en hektisk vecka: ungefär 7 avvikelser per 100 kylcontainrar, vilket är hur en hektisk augustimånad ser ut i Rotterdam. De udda fallen spelade större roll än volymen. Vi bad om strömbortfall under lossning, en dörr som lämnats öppen, ett sensorgap och två skadeärenden för en avvikelse. Sidan kan föreslå udda fall utifrån avvikelseorsakerna i kunskapsmodellen, aldrig från riktiga poster.

Varje uppsättning av antal och former sparas som ett frö, såsom cold-chain-busy-01, med sitt fingeravtryck. Samma frö ger samma data, så varje testkörning på varje gren ser samma vecka. Det var det som gjorde våra 66 tester repeterbara.

En gren lever i 72 timmar som standard och högst i 14 dagar. Jag bad om att få behålla vår hektiska gren i 30 dagar under en lång granskning, och sidan nekade med BRANCH_LIFE_EXCEEDED. Lösningen är den som skylten föreslår: behåll fröet och skapa en ny gren från det när ni behöver en. En maskerad kopia följer samma gränser, och en begäran om den innehåller en motivering och en varaktighet på upp till 14 dagar.

Förhandsgranska en lins som en viss person

Innan någon i Rotterdam såg Cold chain tittade vi på det så som de skulle göra. Förhandsgranska en lins som en person återger paketet exakt så som en vald roll ser det, på en datagren, inuti en streckad förhandsgranskningsram.

Förhandsgranska en lins som en person
Förhandsgranska en lins som en viss person
Cold chain som en kylcontainertekniker i Rotterdam ser det, på en syntetisk gren. Lägg märke till skadekolumnen markerad med "dold av lins" på varje öppen avvikelse, och sidopanelen som anger vad den här linsen döljer och varför.

Tre regler gör förhandsgranskningar säkra att använda fritt. En förhandsgranskning använder en datagren, aldrig den aktiva enheten. Era egna behörigheter läcker inte in i den, så ni ser vad rollen ser och inte vad ni själv kan se. Och den avslutas efter 30 minuter. Att peka en förhandsgranskning mot en aktiv enhet nekas med CONNECTION_SCOPE_EXCEEDED; om ni behöver riktiga former, be dataägaren om en maskerad kopia och förhandsgranska på den.

Det var i förhandsgranskningen vi fångade ett verkligt misstag. Temperaturdiagrammet i teknikervyn visade börvärdet, och redigeringar av börvärdet var endast avsedda för kontrollanter. Diagrammet var det inget fel på, men redigeringsknappen under det skulle inte vara där. Version 0.3.2 dolde redigering av börvärden för tekniker, och det var i förhandsgranskningen vi upptäckte det.

Ändra kunskapsmodellen efter leverans

Vid version 0.4.0 behövde vi en Inspection-typ för inspektioner före avfärd, och relationen "Excursion caused Claim" lät bättre som "Excursion led to Claim". Att flytta modellen från 1.3 till 1.4 är en ändring av kunskapsmodellen, och sidan Ändringar i kunskapsmodellen visar dess diff, vad den skulle beröra och var på vägen den befinner sig.

Ändringen färdas som en begäran om grafändring. Dess torrkörning räknar vad den skulle beröra på Rotterdams maskerade kopia, i antal: för oss, 1 284 omdöpta länkar och ingenting borttaget. Två granskare godkänner den, och pipelinen tillämpar den på staging och sedan i piloten. Ingen skriver till den delade grafen för hand; ett försök nekas och registreras. Tre sparade frågor använde ordet "caused", och ändringen innehöll en automatisk omskrivning för var och en av dem, vilka sidan listade. Linsfiltren ändrades inte, eftersom båda linserna fortfarande bara begränsade.

Befordra till produktion

Varje utgåva rör sig längs en och samma väg: utvecklingsyta, staging, en pilotenhet och sedan alla enheter. Varje steg har kontrollgrindar, och ingenting hoppar över någon.

Till Spärrar
Staging Alla tester godkända; kvalitetskontroller; manifestet oförändrat eller utvidgningen godkänd; signerad avbildning
Pilot (Rotterdam) Torrkörning av modelländring på den maskerade kopian utan fel; policykontroll av lins- och behörighetsområdesregler; två granskare som inte är författaren, varav en är dataägaren
Alla enheter 14 dagar i piloten; fel under 1 på 1 000, räknat i piloten; varje enhetsadministratör godkänner för sin enhet; två granskare som inte är författaren
Miljöer och uppflyttning
Miljöer och uppflyttning
Cold chain 0.3.2 väntar vid pilotgrinden på sin andra granskare. Skylten till höger är nekandet vid försök att befordra direkt från en utvecklingsyta till alla enheter.

Jag provade genvägen en gång, på en fredag, för en enradsfix: att befordra 0.4.0-dev från min utvecklingsyta till alla enheter. Det nekades med GATE_CANNOT_BE_SKIPPED, och ingenting befordrades. Skylten säger åt er att befordra till nästa steg i stället, och det är det enda svaret som finns.

Själva utgåvegranskningen, det underlag en andra granskare läser och de kanaler som enheterna väljer finns i kapitel 2.28, Släppa er utökning. Två fakta därifrån hör hemma här, eftersom de formar hur ni planerar en vertikal. Författaren räknas aldrig som granskare, så ett team på två personer behöver en tredje person för varje utgåva. Och varje miljö behåller den föregående versionen i 30 dagar, så att rulla tillbaka är en granskad ändring som pipelinen gör på ungefär en minut.

Utöka ett paket som redan finns

Inte varje vertikal börjar från noll. Ett paket kan ärva från ett annat och bara lägga till det som skiljer sig. Paketet Bank och betalningar, som Larchmont Bank kör, är det tydligaste exemplet i katalogen. Dess manifest börjar så här:

{
  "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 anger namnet på det paket det bygger på. Bank och betalningar behåller Försäkringspaketets struktur, dess delade konversationskluster och dess kärnord, och lägger till tre egna linser: Kreditbeslut, Kortreklamationer och Mitt konto. Det tredje elementet i varje lexikonpost är exact för en term som måste visas exakt som den är skriven, såsom APR (effektiv ränta), i stället för att omformuleras.

Vissa saker kan ni inte göra genom arv. Ett paket ändrar aldrig skalet, komponenterna eller skrivreglerna, så ett underordnat paket kan inte ändra utseendet på konsolen. Ett regelverk som flera paket behöver är en delad lins snarare än en kopia i varje: registret över utkontrakterad teknik betjänar både Försäkring och Bank och betalningar. Om ert underordnade paket behöver en lins som redan finns som en delad lins, använd den i stället för att rita en egen.

Licensieringen följer arvet. Ett paket licensieras ovanpå Enterprise och kan behöva tillägg, och licensdokumentet bär de beroendena. Försäkring behöver Beslutsrum och förseglade poster, så en kund som licensierar ett paket som ärver det behöver det tillägget också, och konsolen nekar att utfärda en licens som utelämnar det. Ett pakets telefonskärmar behöver även tillägget Mobilappar. Kontrollera kravkedjan innan ni lovar en kund ett datum.

Lägga till en lins i ett paket som har levererats

Det minsta vertikala arbetet är en ny lins för ett paket du inte har skrivit själv. Sex månader in i piloten ville Larkfields marinskadeavdelning ha en egen lins i Cold chain: avvikelser och skadeärenden, inga strömpunkter, inga börvärden. Vi rörde inte paketets kod. En lins är en rad i organisationens linsregister som ägs av paketet, så vi startade den från linsens gyllene väg under Starta något nytt och utformade den i Linsbyggaren med Cold-chain-kontrollantlinsen som bas. Samma regel gäller som tidigare: den nya linsen kan dölja vad dess bas visar men kan aldrig visa mer. Den definieras en gång för organisationen och tilldelas en plattformsroll i varje enhet. En tilldelning återkallas men raderas aldrig, och att ge ut linsen igen skapar en ny tilldelning, så att det förblir läsbart vem som hade vilken lins och när. Registret räknar hur många personer som hade en lins varje månad, aldrig vilka.

Sidan Linser och vem som ser dem visar resultatet som en matris med lins per enhet och roll, med Lägg till, Ändra och Återkalla i varje cell. Förhandsgranska den nya linsen som en person innan du tilldelar den, precis som ovan.

Vad det ärligt talat kostade

Ett paket berör en kunds register, så plattformen gör vissa saker långsamma med flit, och du bör planera för dessa från dag ett.

  1. En maskerad kopia kräver dataägarens godkännande varje gång. Vår tog en dag att få första gången, eftersom Priya ville läsa kunskapsmodellen först. Börja med syntetiska data och fråga i god tid.
  2. Författaren kan inte godkänna sin egen lansering, och förfrågningar förfaller efter 3 dagar. Om dina granskare är upptagna får din lansering vänta.
  3. En lansering som begär mer än den föregående, såsom att skicka e-post eller en extern adress, hålls kvar tills två granskare godkänner det utökade manifestet. Kapitel 2.28, Lansera ditt tillägg, visar sidan Manifest och behörigheter som informerar dig innan du frågar.
  4. En lins kan inte visa vad dess baslins döljer. Om en roll verkligen behöver mer är det en diskussion med organisationsadministratören, inte en inställning.

Inget av detta kom i vägen för oss två gånger. Den andra lanseringen av Cold chain tog en vecka från första commit till Rotterdam-piloten, varav merparten bestod av de 66 testerna som kördes mot tre grenar och två personer som läste underlaget.