Version 1.0.0-alpha.1seneste
Kapitel 2.24
Byg en skræddersyet vertikal løsning fra start til slut
En gennemarbejdet opbygning af domænepakken til kølekæden (Cold chain), fra det første oplæg til en udgivelse, der kører for hver enhed, med dens vidensmodel, linser, en færdighed, et full-service-plugin og eksempeldata. Derefter gennemgås det, hvordan man udvider en pakke, der allerede findes, og hvordan man tilføjer en linse til en pakke, der er udgivet.
Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

Jeg hedder Mateo Ruiz og er udvikler hos Corrán Orbital. Det meste af min uge går med vores egen nyttelastsoftware, men dette kapitel handler om en opgave, vi udførte for en kunde. Larkfield & Vane forsikrer gods, og en voksende andel af det transporteres i kølecontainere. Når en reefer mister landstrøm ved kajen, stiger temperaturen, godset fordærves, og et erstatningskrav følger uger senere. Larkfield ønskede, at deres medarbejdere kunne se den kæde som én sammenhæng i Nexus, fra strømfejlen til erstatningskravet, hvor hver rolle kun ser sin del. Det blev til Cold chain-pakken.
Det følgende er opbygningen i den rækkefølge, vi udførte den, med skærmbillederne, filerne og kommandoerne. Jeg har bevaret fejlene, fordi to af de afvisninger, vi mødte, lærte os mere om platformen end den problemfri vej. Referencematerialet findes i kapitlerne før dette, og jeg henviser til dem i stedet for at gentage dem. Dem, jeg støttede mig mest til, var kapitel 2.18, Udvidelsesmodellen, og kapitel 2.23, Domænepakker, med kapitel 2.21, Plugin SDK, åbent ved siden af for selve softwareudviklingssættet.
Oplægget, og hvem der gør hvad
Larkfield gav mig en udviklerplads i deres organisation i projektets varighed. Det har betydning, fordi en privat pakke til én kunde bygges inde i den kundes installation, på dennes dev spaces og databranches og under godkendelse fra dennes medarbejdere. En pakke beregnet til mange kunder bygges anderledes, på en publisher-klynge med udelukkende eksempeldata, og kapitel 2.25, Byg til hver udgave, dækker det tilfælde.
Opgavebeskrivelsen kunne være på én side:
- Kølecontainere ved kajen og på skibe: deres strøm, deres temperaturafvigelser og de erstatningskrav, der følger.
- To roller til at begynde med: en reefer-tekniker på kajen og en kølekædecontroller på kontoret.
- Et pilotprojekt, der først kører i enheden Rotterdam og derefter flyttes til Felixstowe.
- Dokumentation for tre regelsæt: ATP-aftalen for letfordærvelige fødevarer, EU's god distributionspraksis for lægemidler og fødevaresikkerhedsregistreringer under HACCP (risikoanalyse og kritiske kontrolpunkter). Erstatningskrav under Haag-Visby-reglerne bruger de samme afvigelsesregistreringer, så vi noterede dem til efter pilotprojektet.
Domænepakker er en Enterprise-funktion. Larkfield kører Enterprise, så vejen til domænepakker var åben for mig. På Community tilbydes den gyldne vej til en pakke slet ikke.
Start fra standardvejen
Alt begynder på siden Start noget nyt. Den tilbyder seks gyldne veje: plugin, domænepakke, lens, platform, skill og workflow. Hver af dem opretter et repository ud fra en versioneret skabelon, et manifest, der erklærer, hvad tingen har brug for, tests, en dev space og databranches. De samme veje fungerer i konsollen, på kommandolinjen og fra Deres IDE (integreret udviklingsmiljø), hvor Workbench-værktøjet nexus.create udfører samme opgave med en plan, De først bekræfter.
nexus create-kommando og dens fastlåste skabelon. Bemærk pladen nederst: manifestet håndhæves og er ikke vejledende, og en udgivelse, der beder om mere, tilbageholdes, indtil to personer har gennemgået den.Vi valgte vejen til domænepakker fra den side og navngav pakken cold-chain og dens første enhed Rotterdam. Resultatet angiver den fastlåste skabelon, domain-pack@1.6.0, og viser, hvad der blev oprettet: repositoryet, et manifest, der erklærer fire scopes, to lagre og ingen udgående adresser, 66 tests fra skabelonen, en dev space i Rotterdam, tre syntetiske databranches og en kladdepost i Larkfields eget katalog, som kun jeg kunne se. Skabelonversionen er fastlåst, og en senere opgradering ankommer som en gennemgået ændring som enhver anden, så ingens pakke flytter sig under dem, fordi en skabelon flyttede sig. Jeg brugte alligevel konsolguiden til vores første pakke, fordi den viser planen, før den opretter noget.
Trin 1: beskriv, hvad pakken skal bruges til
Guiden Ny domænepakke har tre trin: om pakken, vidensmodel samt gennemse og opret. Trin 1 spørger om de få ting, der former alt det efterfølgende.
| Felt | Hvad vi indtastede | Bemærk |
|---|---|---|
| Navn | Cold chain | Bruges til repositoryet og kataloget |
| Hvad den er til | Kølecontainere ved kajen og på skibe: strøm, temperaturafvigelser og de erstatningskrav, der følger | |
| Branche | Logistik og søfart | Bygger på pakken Logistik og søfart |
| Ejer (Owner) | Den person, der opretter den | Låst i guiden |
| Enheder | Rotterdam (pilot) | Felixstowe efter pilotprojektet |
| Skabelon | domain-pack@1.6.0 |
Låst; opgraderinger kommer som gennemgåede ændringer |
| Regler, den kortlægger | ATP-aftalen, EU's god distributionspraksis, fødevaresikkerhedsregistreringer | Hver regel bliver en side i pakkens dokumentationskort |
Assistenten i docken foreslog den sidste række, herunder pointen om, at godserstatningskrav genbruger de samme afvigelsesregistreringer. En plade nederst på siden angiver, at intet er oprettet endnu. Repositoryet, dev space og databranches oprettes først, når De trykker på Opret på trin 3, efter at De har set planen. De kan gemme en kladde og vende tilbage.
Trin 2: vidensmodellen
Vidensmodellen er det sæt af typer af ting, pakken kender til, og hvordan de hænger sammen. Cold chain tog udgangspunkt i logistikkens basismodel, logistics-base 4.2, importeret fra SDK'et, som gav os fem basistyper at bygge på (Vessel, Port, Container, Carrier og Shipment). Basistyper er skrivebeskyttede i guiden. Hvis en af dem skal ændres, ændres den i den pakke, der ejer den.
Vi tilføjede fem af vores egne typer:
| Type | Hvad det er | Egenskaber |
|---|---|---|
| Reefer-enhed | En kølecontainer | 9 |
| Skibsanløb | Ét skib ved én kajplads | 6 |
| Afvigelse | En temperatur uden for dens grænser | 8 |
| Strømforsyning | Et land- eller skibsstrømudtag | 4 |
| Tilknyt | Penge krævet for fordærvet gods | 7 |
Hver egenskab klassificeres, når De opretter den. "Rapporteret af" på en Afvigelse er personlig. "Godsværdi i risiko" samt et erstatningskravs beløb og afregning er kommercielle. Det føltes som papirarbejde på dag ét og reddede os to gange senere, fordi klasserne afgør, hvad en lens må vise, hvad en maskeret kopi erstatter, og hvad en loglinje skjuler.
To af vores relationer rækker ind i basismodellen: en Reefer-enhed er tilsluttet en Strømforsyning, og et Erstatningskrav henviser til en Shipment. Selve basismodellen ændres ikke. En egenskab, De trækker tilbage, forbliver i version 1.0 af modellen og forsvinder først i en senere version, så intet, der var sandt om gamle registreringer, holder op med at være læsbart.
Trin 3: gennemgå og opret
Trin 3 er planen. Den viser, hvad der vil blive oprettet, de scopes, manifestet vil erklære, databranches og dev space. De bekræfter planen med Deres passkey, og planen får et fingeraftryk. Oprettelsen følger derefter planen nøjagtigt, ét trin ad gangen, og De kan stoppe ved ethvert trin og beholde det, der er oprettet.
Planen for Cold chain erklærede fire scopes:
| Scope | Hvorfor pakken har brug for det |
|---|---|
| Læs reefer-telemetri | Strøm- og temperaturmålinger |
| Skriv afvigelser | Registrerer en afvigelse, når grænser overskrides |
| Læs forsendelser | Knytter et erstatningskrav til dets forsendelse |
| Udkast til erstatningsnotater | Kun udkast; en person sender |
Dens lagre var grafen og registreringer. Den havde ingen udgående adresser og sandkasseprofilen Standard. Dev space fulgte med 4 kerner, 16 GiB hukommelse og 50 GiB lagerplads, et netværk lukket bortset fra det, manifestet erklærer, kun signerede images og afslutning efter 7 inaktive dage. Når den afsluttes, forbliver dens definition i repositoryet, så De opretter den igen derfra.
De tre databranches kom fra den syntetiske generator. Ingen kundedata blev kopieret. En maskeret kopi af Rotterdam kræver dataejerens samtykke, hvilket hos Larkfield er Priya Natarajan, og De anmoder om det separat.
Pakkemanifestet
Repositoryet indeholder pakkens manifest, pack.json. Det angiver pakkens navn, dens version, den pakke, den arver fra (hvis nogen), dens klynger og dens ord. En klynge er enten en lens, som er det, én rolle ser inde i pakken, eller delt, som går på tværs af alle lenses. Her er kernen i vores:
{
"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", ""]
]
}
}Leksikonet indeholder pakkens egne ord med en enkel forklaring til hvert, kort nok til at læse på en telefon.
Ud over pack.json erklærer manifestet også, hvad pakken må tilgå: dens scopes, lagre, udgående adresser og sandkasseprofil. Nexus tildeler præcis dette og intet mere. Hvert værktøjskald kontrolleres mod de erklærede scopes, og en ekstern adresse blokeres, medmindre den er angivet. De kan læse erklæringen og ændringen i forhold til seneste udgivelse på pakkens side Manifest og tilladelser.
Linser: hvad hver rolle ser
En lens kan altid kun indsnævre, hvad dens base viser, og den ene regel formede mere af vores design end nogen anden. En lens viser en del af det, dens baselens viser, og tilladelser kommer stadig fra roller: en lens afgør, hvad en rolle ser i pakken, ikke hvad den har lov til at gøre.
Lensen Reefer-tekniker indsnævrer Driftscontroller, den baselens, Larkfield allerede bruger til logistikarbejde. I Lens builder markerer De de kort, felter og handlinger, lensen viser. Elementer, som basen ikke viser, er låst.
| Del | Reefer-tekniker viser | Udeladt |
|---|---|---|
| Kort | Reefer-enheder ved kajen, åbne afvigelser, strømudtag, dagens skibsanløb | Alt om erstatningskrav |
| Felter | Strømtilstand, setpunkt, seneste måling, højeste temperatur | Erstatningsbeløb (ikke i baselensen), personlige felter (slået fra som standard) |
| Handlinger | Registrer en afvigelsesårsag, anmod om en strømkontrol | Ændre et setpunkt og lukke en afvigelse (kun controllere), udarbejde et udkast til erstatningsnotat |
Jeg forsøgte alligevel at tilføje erstatningsbeløb til teknikerlensen, fordi en tekniker havde bedt om det. Builderen afviste med LENS_CANNOT_WIDEN og gemte intet. Der findes ingen omvej inde i lensen: vejen frem er en lens på en bredere base, en anden anmodning, som organisationsadministratoren afgør. Vi udelod det.
At skjule noget i en lens fjerner det ikke fra Nexus. Det betyder, at denne rolle ikke ser det. Builderen viser, hvor mange personer en lens vil nå i pilotprojektet (29 i vores tilfælde), og fører en log over hver Tilføj, Ændr og Træk tilbage. En lens defineres én gang for organisationen og tildeles pr. enhed til en platformrolle, så den samme Reefer-tekniker-lens kan gives til Rotterdams teknikere denne måned og Felixstowes den næste.
En færdighed til at udarbejde skadesnotater
Controllerne ønskede et første udkast til det notat, der sendes til en godsejer efter en afvigelse. Det er sprogarbejde, så det kører på en model, og spørgsmålet var, hvor det skulle placeres.
Der findes to slags skills i Nexus, og forskellen har betydning her. En manifest-skill er en typet række i et plugins skills[], som platformen afvikler. En Skills Engine-skill er en SKILL.md-pakke i organisationens skill-bibliotek, som agenter, AI-knapper (kunstig intelligens), workflows og udviklerværktøjer alle kører på samme måde. Kapitel 2.20, Skills, dækker begge.
Vores plugins tillidsniveau er community, og et community-plugin må kun erklære manifest-skills, der ikke når en model (host_callback og plugin_queue). De to niveauer, der når AI Provider Router, tool_using og llm_only, kræver tillidsniveau core eller verified. Derfor blev udarbejdelse af erstatningsnotater en Skills Engine-skill, og routeren vælger modellen fra Larkfields egen pulje:
---
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 repositoryet med et mappenavn, der er lig med skillens navn. Vi validerede og uploadede den 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-noteUpload af det samme indhold to gange returnerer den eksisterende version i stedet for en ny (CONTENT_HASH_ALREADY_PUBLISHED), så det er sikkert at køre uploaden igen. Før en version udrulles, kører Skills Engine dens testcases, en prøvekørsel i skyggetilstand på tidligere arbejde og en blind gennemgang foretaget af en model fra en anden virksomhed, med tid og omkostning for hver kørsel.
Full-service-pluginnet
Pakken havde også brug for kode, der kører hele tiden: en læser til reefer-telemetrifeedet og en skriver, der opretter en afvigelsesregistrering, når en måling overskrider sine grænser. Den slags kode hører hjemme i et fuldservice-plugin, og vi opbyggede det med SDK'ets egen kommando, som skriver hele referencetræet med navnet indsat:
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 pull-tokenet fra siden Pull-tokens og installationskommandoer i Deres Adverant-konto. Commit den package-lock.json, som den første installation skriver; image-buildet kører npm ci og afviser uden en.
Her er den del af vores nexus.manifest.json, der afviger fra skabelonen. Det er ikke hele filen: skabelonens description-, author-, license-, runtime-, backend- og frontend-blokke forbliver, som de er, og validatoren afviser et manifest for en fuld tjeneste uden dem. De tre architecture-sætninger er den lov, som hvert plugin gentager, og validatoren kontrollerer ordlyden. UNO i den første er workflow-motoren:
{
"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 manifest-færdighed med niveauet host_callback: platformen sender inputtet til vores egen Service i vores namespace og aldrig til en vært, vi angiver. Modtagerruten er erklæret auth: internal og beskyttet med SDK'ets serviceMiddleware, Express-formen af beskyttelsen, som afviser et kaldetoken udstedt til ethvert andet plugin, organisation, færdighed eller rute. Dens classification er tenant, hvilket er loftet for et community-plugin. Kapitel 2.27, Byg scenarier, gennemgår en host_callback-færdighed for sig.
To vaner fra denne fase er værd at efterligne. Hver tabel har organization_id, owner_user_id og business_unit_id fra den første migrering, fordi det at tilføje en akse senere er en migrering over levende rækker. Og vi kørte nexus-gates lokalt før hvert push, da det er den samme kommando, som pipelinen kører; en kørsel, der ikke undersøgte noget, afslutter med 2 og siger det. Kapitel 2.19, De regler, som enhver udvidelse arver, oplister portene.
Eksempeldata til test
Siden Eksempeldata til test tilbyder tre slags grene:
| Type | Hvad den indeholder | Hvem godkender |
|---|---|---|
| Syntetisk | Data genereret ud fra antal og former, som De angiver; intet kommer fra en rigtig enhed | Ingen; den er Deres |
| Maskeret kopi | En kopi af en enhed, hvor personlige, følsomme og kommercielle felter er erstattet | Dataejeren (Priya Natarajan for Rotterdam) |
| Kun skema | Lagrenes form uden rækker | Ingen; til migreringer |
Vi genererede en travl uge: omkring 7 afvigelser pr. 100 kølecontainere, hvilket er sådan en travl august ser ud i Rotterdam. De usædvanlige tilfælde betød mere end mængden. Vi bad om strømsvigt under losning, en dør, der stod åben, et hul i sensordata og to krav for én afvigelse. Siden kan foreslå usædvanlige tilfælde ud fra afvigelsesårsagerne i vidensmodellen, aldrig ud fra rigtige poster.
Hvert sæt af antal og former gemmes som et seed, f.eks. cold-chain-busy-01, med sit fingeraftryk. Det samme seed giver de samme data, så hver testkørsel på hver gren ser den samme uge. Det var det, der gjorde vores 66 test gentagelige.
En gren lever som standard i 72 timer og højst 14 dage. Jeg bad om at beholde vores travle gren i 30 dage under en lang gennemgang, og siden afviste med BRANCH_LIFE_EXCEEDED. Løsningen er den, som pladen foreslår: behold seedet, og lav en ny gren ud fra det, når De har brug for en. En maskeret kopi følger de samme grænser, og anmodningen om den indeholder en begrundelse og en varighed på op til 14 dage.
Forhåndsvis en linse som en person
Før nogen i Rotterdam så Cold chain, så vi på den, som de ville. Forhåndsvis en linse som en person gengiver pakken præcis, som en valgt rolle ser den, på en datagren inden for en stiplet forhåndsvisningsramme.
Tre regler gør forhåndsvisninger sikre at bruge frit. En forhåndsvisning bruger en datagren, aldrig den levende enhed. Deres egne tilladelser smitter ikke af på den, så De ser det, rollen ser, og ikke det, De selv kan se. Og den ophører efter 30 minutter. At rette en forhåndsvisning mod en levende enhed afvises med CONNECTION_SCOPE_EXCEEDED; hvis De har brug for rigtige former, så bed dataejeren om en maskeret kopi, og forhåndsvis på den.
Det var i forhåndsvisningen, vi fangede en reel fejl. Temperaturdiagrammet i teknikervisningen viste sætpunktet, og ændringer af sætpunktet var kun tiltænkt controllere. Diagrammet var i orden; redigeringsknappen under det var ikke. Version 0.3.2 skjulte ændringer af sætpunkt for teknikere, og det var i forhåndsvisningen, vi fandt det.
Ændring af vidensmodellen efter udgivelse
Ved version 0.4.0 havde vi brug for en Inspection-type til inspektioner før tur, og relationen "Excursion caused Claim" lød bedre som "Excursion led to Claim". At flytte modellen fra 1.3 til 1.4 er en ændring af vidensmodellen, og siden Ændringer af vidensmodellen viser dens diff, hvad den ville berøre, og hvor langt den er på sin vej.
Ændringen bevæger sig som en anmodning om grafændring. Dens tørkørsel tæller, hvad den ville berøre i Rotterdams maskerede kopi, som antal: for os 1.284 links omdøbt og intet fjernet. To bedømmere godkender den, og pipelinen anvender den på staging og derefter på piloten. Ingen skriver manuelt til den delte graf; et forsøg afvises og registreres. Tre gemte spørgsmål brugte ordet "caused", og ændringen medbragte en automatisk omskrivning for hvert af dem, som siden oplistede. Linsefiltrene ændrede sig ikke, fordi begge linser stadig kun indsnævrede.
Promover til produktion
Hver release bevæger sig ad én vej: dev space, staging, en pilotenhed og derefter alle enheder. Hvert trin har porte, og intet springer en over.
| Til | Porte |
|---|---|
| Staging | Alle test består; kvalitetskontroller; manifest uændret eller udvidelsen accepteret; signeret image |
| Pilot (Rotterdam) | Tørkørsel af modelændring på den maskerede kopi uden fejl; politikkontrol af linse- og omfangsregler; to bedømmere, som ikke er forfatteren, hvoraf den ene er dataejeren |
| Alle enheder | 14 dage i piloten; fejl under 1 ud af 1.000, talt i piloten; hver enhedsadministrator godkender for sin enhed; to bedømmere, som ikke er forfatteren |
Jeg prøvede genvejen én gang, en fredag, for en rettelse på én linje: forfrem 0.4.0-dev fra mit dev space til alle enheder. Det blev afvist med GATE_CANNOT_BE_SKIPPED, og intet blev forfremmet. Pladen beder Dem i stedet forfremme til næste trin, og det er det eneste svar, der findes.
Selve releasegennemgangen, den dokumentation, en anden bedømmer læser, og de kanaler, enhederne vælger, findes i kapitel 2.28, Udgivelse af Deres udvidelse. To fakta derfra hører hjemme her, fordi de former, hvordan De planlægger en vertikal. Forfatteren tæller aldrig som bedømmer, så et team på to personer har brug for en tredje person til hver release. Og hvert miljø beholder den forrige version i 30 dage, så en tilbagerulning er en gennemgået ændring, som pipelinen udfører på omkring et minut.
Udvidelse af en pakke, der allerede findes
Ikke alle vertikaler starter fra bunden. En pakke kan arve fra en anden og kun tilføje det, der er anderledes. Pakken Bank og betalinger, som Larchmont Bank kører, er det tydeligste eksempel i kataloget. Dens manifest starter sådan:
{
"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 angiver den pakke, den bygger på. Bank og betalinger bevarer Forsikringspakkens form, dens delte samtaleklynger og dens kerneord og tilføjer tre egne linser: Lånebeslutninger, Kortindsigelser og Min konto. Det tredje element i hver leksikonpost er exact for et begreb, der skal vises som skrevet, f.eks. APR (årlig omkostning i procent), i stedet for at blive omformuleret.
Nogle ting kan De ikke gøre ved at arve. En pakke ændrer aldrig skallen, komponenterne eller skrivereglerne, så en underpakke kan ikke ændre konsollens stil. En ordning, som flere pakker har brug for, er én delt linse frem for en kopi i hver: registret over outsourcet teknologi betjener både Forsikring og Bank og betalinger. Hvis Deres underpakke har brug for en linse, der allerede findes som delt linse, så brug den i stedet for at tegne Deres egen.
Licensering følger arven. En pakke licenseres oven på Enterprise og kan kræve tilføjelser, og licensdokumentet indeholder disse afhængigheder. Forsikring kræver Beslutningsrum og forseglede poster, så en kunde, der licenserer en pakke, som arver den, har også brug for den tilføjelse, og konsollen afviser at udstede en licens, der udelader den. En pakkes telefonskærme kræver desuden tilføjelsen Mobilapps. Kontrollér kæden af krav, før De lover en kunde en dato.
Tilføjelse af en linse til en pakke, der er udgivet
Det mindste vertikale arbejde er en ny linse på en pakke, De ikke selv har skrevet. Seks måneder inde i piloten ønskede Larkfields team for marineskader en egen linse i Cold chain: afvigelser og krav, ingen strømudtag, ingen sætpunkter. Vi rørte ikke pakkens kode. En linse er en række i organisationens linseregister, ejet af pakken, så vi startede den fra den gyldne sti for linser under Start noget nyt og formede den i Linsebyggeren med Cold-chain-controllerlinsen som grundlag. Den samme regel gælder som før: den nye linse kan skjule det, dens grundlag viser, og kan aldrig vise mere. Den defineres én gang for organisationen og tildeles en platformsrolle i hver enhed. En tildeling trækkes tilbage, slettes aldrig, og at give linsen igen skaber en ny tildeling, så det forbliver læsbart, hvem der havde hvilken linse hvornår. Registret tæller, hvor mange personer der havde en linse hver måned, aldrig hvem.
Siden Linser og hvem der ser dem viser resultatet som en matrix af linse efter enhed og rolle med Tilføj, Ændr og Træk tilbage i hver celle. Forhåndsvis den nye linse som en person, før De tildeler den, præcis som ovenfor.
Hvad det reelt kostede
En pakke berører en kundes poster, så platformen gør bevidst nogle ting langsomme, og De bør planlægge for dem fra første dag.
- En maskeret kopi kræver dataejerens godkendelse hver gang. Vores tog en dag om at komme første gang, fordi Priya ville læse vidensmodellen først. Start med syntetiske data, og spørg tidligt.
- Forfatteren kan ikke godkende sin egen release, og anmodninger bortfalder efter 3 dage. Hvis Deres bedømmere har travlt, venter Deres release.
- En release, der beder om mere end den forrige, f.eks. at sende mail eller én ekstern adresse, holdes tilbage, indtil to bedømmere accepterer det bredere manifest. Kapitel 2.28, Udgivelse af Deres udvidelse, viser siden Manifest og tilladelser, som fortæller Dem det, før De spørger.
- En linse kan ikke vise det, dens grundlinse skjuler. Hvis en rolle virkelig har brug for mere, er det en samtale med organisationsadministratoren, ikke en indstilling.
Ingen af disse stod i vejen for os to gange. Den anden release af Cold chain tog en uge fra første commit til Rotterdam-piloten, det meste af den brugt på, at de 66 test kørte mod tre grene, og at to personer læste dokumentationen.




