Logi sisseBroneerige tutvustus

Peatükk 2.24

Kohandatud vertikaali terviklik loomine

Külmaahela valdkonnapaketi praktiline ehitamine alates esimesest lähteülesandest kuni iga üksuse jaoks töötava väljalaskeni, koos teadmismudeli, vaadete, oskuse, täisteenuse pistikprogrammi ja näidisandmetega. Seejärel vaadatakse, kuidas laiendada juba olemasolevat paketti ja kuidas lisada vaade juba avaldatud paketile.

Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

19 minutit lugemist

Mina olen Mateo Ruiz, arendaja ettevõttes Corrán Orbital. Suurem osa minu nädalast kulub meie enda kasuliku koormuse tarkvarale, kuid see peatükk räägib tööst, mille tegime ühele kliendile. Larkfield & Vane kindlustab kaupa ning üha suurem osa sellest liigub külmutuskonteinerites. Kui külmkonteiner kaotab kai ääres kaldatoite, tõuseb temperatuur, kaup rikneb ja nädalaid hiljem järgneb kahjunõue. Larkfield soovis, et nende inimesed näeksid seda ahelat Nexuses ühe tervikuna, alates toitehäirest kuni kahjunõudeni, kusjuures iga roll näeb ainult oma osa. Sellest sai Cold chain pakett.

Järgnevalt kirjeldan ehitust selles järjekorras, nagu me selle tegime, koos kuvade, failide ja käskudega. Jätsin vead sisse, sest kaks keeldumist, millega kokku puutusime, õpetasid meile platvormi kohta rohkem kui sujuv tee. Viitematerjal asub sellele eelnevates peatükkides ning ma viitan neile, selle asemel et neid korrata. Kõige rohkem toetusin peatükile 2.18, Laiendusmudel, ja peatükile 2.23, Valdkonnapaketid, ning nende kõrval oli avatud peatükk 2.21, Plugin SDK, tarkvaraarenduskomplekti enda jaoks.

Vasakult paremale kulgev rada kaheksast kastist: „Lähteülesanne“, „Kuldne rada“, „Teadmusmudel“, „Läätsed“, „Oskus ja plugin“, „Näidisandmed ja eelvaade“, „Väljalaske ülevaatus“, „Edendamine“. Viimase kasti all näitab teine rida neljast väiksemast noolega ühendatud kastist edendamise samme: „Arendusruum“, „Staging“, „Pilootüksus (Rotterdam)“, „Kõik üksused“, iga noole juures tabaluku ikoon sildiga „värav“. Katkendjooneline nool otse „Arendusruumist“ „Kõik üksused“ kasti on läbi kriipsutatud ja sildiga GATE_CANNOT_BE_SKIPPED.
Cold chain paketi ehitus, lähteülesandest iga üksuseni.

Lähteülesanne ja kes mida teeb

Larkfield andis mulle projekti ajaks arendajakoha oma organisatsioonis. See on oluline, sest ühe kliendi privaatne pakett ehitatakse selle kliendi enda installatsioonis, selle arendusruumides ja andmeharudes ning selle inimeste kinnituste alusel. Paljudele klientidele mõeldud pakett ehitatakse teisiti, väljaandja klastris ainult näidisandmetega, ja seda juhtumit käsitleb peatükk 2.25, Ehitamine iga väljaande jaoks.

Lähteülesanne mahtus ühele lehele:

  • Külmkonteinerid kai ääres ja laevadel: nende toide, temperatuurikõrvalekalded ja neile järgnevad kahjunõuded.
  • Alguseks kaks rolli: külmkonteinerite tehnik kail ja külmaahela kontroller kontoris.
  • Pilootprojekt, mis käivitub esmalt Rotterdami üksuses ja liigub seejärel Felixstowe'i.
  • Tõendid kolme reeglistiku jaoks: kiiresti riknevate toiduainete ATP leping, ravimite ELi hea turustamistava ning toiduohutuse dokumendid HACCP (ohutegurite analüüs ja kriitilised kontrollpunktid) alusel. Haagi-Visby reeglite alusel esitatud kahjunõuded kasutavad samu kõrvalekallete kirjeid, seega märkisime need pilootprojekti järgseks ajaks üles.

Valdkonnapaketid on Enterprise'i võimekus. Larkfield kasutab Enterprise'i, seega oli valdkonnapaketi tee mulle avatud. Community väljaandes paketi kuldset teed üldse ei pakuta.

Alustamine kuldselt teekonnalt

Kõik algab lehelt Start something new. See pakub kuut kuldset teed: plugin, valdkonnapakett, lääts, platvorm, oskus ja töövoog. Igaüks neist loob versioonitud mallist repositooriumi, manifesti, mis deklareerib, mida asi vajab, testid, arendusruumi ja andmeharud. Samad teed töötavad konsoolis, käsureal ja teie IDE-s (integreeritud arenduskeskkond), kus Workbenchi tööriist nexus.create teeb sama töö plaaniga, mille te esmalt kinnitate.

Alusta midagi uut
Alusta midagi uut
Kuus kuldset teed, igaühe juures see, mida see loob, selle nexus create käsk ja selle fikseeritud mall. Pange tähele plaati lehe allosas: manifesti järgimine on kohustuslik, mitte soovituslik, ning väljalase, mis küsib rohkem, peetakse kinni, kuni kaks inimest on selle üle vaadanud.

Valisime sellelt lehelt valdkonnapaketi tee, andes paketile nimeks cold-chain ja selle esimesele üksusele Rotterdam. Tulemus nimetab fikseeritud malli domain-pack@1.6.0 ja loetleb, mida see lõi: repositooriumi, manifesti, mis deklareerib neli ulatust, kaks andmehoidlat ja mitte ühtegi väljuvat aadressi, 66 testi mallist, arendusruumi Rotterdamis, kolm sünteetilist andmeharu ning mustandkirje Larkfieldi enda kataloogis, mida nägin ainult mina. Malli versioon on fikseeritud ja selle hilisem uuendamine saabub üle vaadatud muudatusena nagu iga teine, nii et kellegi pakett ei muutu ainult seetõttu, et mall muutus. Kasutasin oma esimese paketi jaoks siiski konsooli viisardit, sest see näitab plaani enne, kui midagi luuakse.

1. samm: määratlege paketi eesmärk

Viisardil New domain pack on kolm sammu: ülevaade, teadmusmudel ning ülevaatus ja loomine. 1. samm küsib neid väheseid asju, mis kujundavad kõike sellele järgnevat.

Väli Mida me sisestasime Märkus
Nimi Cold chain Kasutatakse repositooriumi ja kataloogi jaoks
Milleks see on mõeldud Külmkonteinerid kai ääres ja laevadel: toide, temperatuurikõrvalekalded ja neile järgnevad kahjunõuded
Valdkond Logistika ja merendus Tugineb logistika ja meresõidu paketile
Omanik Selle looja Viisardis lukustatud
Üksused Rotterdam (piloot) Felixstowe pärast pilootprojekti
Mall domain-pack@1.6.0 Lukustatud; uuendused saabuvad üle vaadatud muudatustena
Kaardistatavad reeglid ATP leping, ELi hea turustamistava, toiduohutuse dokumendid Igast reeglist saab leht paketi tõendikaardil

Viimase rea pakkus välja dokis olev assistent, sealhulgas tähelepaneku, et kaubanõuded kasutavad samu kõrvalekallete kirjeid. Lehe allosas olev plaat ütleb, et midagi pole veel loodud. Repositoorium, arendusruum ja andmeharud luuakse alles siis, kui vajutate 3. sammul nuppu Create, pärast seda, kui olete plaani näinud. Saate mustandi salvestada ja hiljem tagasi tulla.

2. samm: teadmismudel

Teadmusmudel on nende asjade liikide kogum, mida pakett tunneb, ja see, kuidas need omavahel seotud on. Cold chain sai alguse logistika baasmudelist logistics-base 4.2, mis imporditi SDK-st ja andis meile viis baasliiki, millele tugineda (Vessel, Port, Container, Carrier ja Shipment). Baasliigid on viisardis kirjutuskaitstud. Kui mõnda neist on vaja muuta, muudetakse seda paketis, mis selle omanik on.

Lisasime viis omaenda liiki:

Liik Mis see on Omadused
Külmkonteiner Külmutusega konteiner 9
Laeva sadamakülastus Üks laev ühel kaikohal 6
Kõrvalekalle Temperatuur väljaspool oma piire 8
Toiteallikas Kalda- või laevatoite punkt 4
Sidumine Riknenud kauba eest nõutav raha 7
Uus valdkonnapakett: teadmusmudel
Uus domeenipakett: teadmusmudel
Teadmusgraaf viie baasliigi ja viie uuega. Vaadake paremal kõrvalekalde omadusi: iga omadus saab oma klassi loomise hetkel ning plaat ütleb, et nõudesummad on ärilised, mistõttu tehnikute läätsed ei saa neid näidata.

Iga omadus klassifitseeritakse selle loomisel. Kõrvalekalde väli „Teatanud“ on isikuandmed. „Ohus oleva kauba väärtus“ ning nõude summa ja lahendus on ärilised. Esimesel päeval tundus see paberimajandusena, kuid hiljem päästis see meid kaks korda, sest klassid määravad, mida lääts tohib näidata, mida maskeeritud koopia asendab ja mida logirida peidab.

Kaks meie seost ulatuvad baasmudelisse: külmkonteiner on ühendatud toiteallikaga ja nõue viitab saadetisele. Baasmudelit ennast ei muudeta. Tagasi võetud omadus jääb mudeli versiooni 1.0 ja kaob alles hilisemas versioonis, nii et miski, mis kehtis vanade kirjete kohta, ei muutu loetamatuks.

3. samm: ülevaatus ja loomine

3. samm on plaan. See loetleb, mis luuakse, ulatused, mida manifest deklareerib, andmeharud ja arendusruumi. Kinnitate plaani oma pääsuvõtmega ja plaan saab sõrmejälje. Seejärel järgib loomine täpselt seda plaani, üks samm korraga, ning võite igal sammul peatuda ja loodu alles jätta.

Cold chain paketi plaan deklareeris neli ulatust:

Ulatus Miks pakett seda vajab
Külmkonteinerite telemeetria lugemine Toite- ja temperatuurinäidud
Kõrvalekallete kirjutamine Registreerib kõrvalekalde, kui piirid ületatakse
Saadetiste lugemine Seob nõude selle saadetisega
Nõudemärkuste mustandid Ainult mustandid; saadab inimene

Selle andmehoidlad olid graaf ja kirjed. Sellel ei olnud väljuvaid aadresse ning sellel oli liivakasti profiil Standard. Arendusruum tuli 4 tuuma, 16 GiB mälu ja 50 GiB salvestusruumiga, võrguga, mis on suletud kõige jaoks peale manifestis deklareeritu, ainult allkirjastatud tõmmistega ning lõpetamisega pärast 7 jõudeoleku päeva. Lõpetamisel jääb selle definitsioon repositooriumi, nii et saate selle sealt uuesti luua.

Kolm andmeharu pärinesid sünteetiliste andmete generaatorist. Kliendiandmeid ei kopeeritud. Rotterdami maskeeritud koopia jaoks on vaja andmeomaniku nõusolekut, kelleks Larkfieldis on Priya Natarajan, ja seda tuleb küsida eraldi.

Paketi manifest

Repositooriumis on paketi manifest pack.json. See nimetab paketi, selle versiooni, paketi, millest see pärib (kui on), selle klastrid ja selle sõnad. Klaster on kas lääts, ehk see, mida üks roll paketi sees näeb, või ühine, mis toimib kõigis läätsedes. Siin on meie manifesti tuum:

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

Leksikon sisaldab paketi enda sõnu koos lihtsa selgitusega igaühe kohta, piisavalt lühikesena, et seda telefonist lugeda.

Lisaks pack.json-le deklareerib manifest ka seda, millele pakett ligi pääseb: selle ulatused, andmehoidlad, väljuvad aadressid ja liivakasti profiili. Nexus annab täpselt selle ja mitte midagi enamat. Iga tööriistakutset kontrollitakse deklareeritud ulatuste suhtes ning välisaadress on blokeeritud, kui seda pole loetletud. Deklaratsiooni ja muudatust võrreldes viimase väljalaskega saate lugeda paketi lehelt Manifest and permissions.

Läätsed: mida iga roll näeb

Lääts saab alati ainult kitsendada seda, mida selle baas näitab, ja see üks reegel kujundas meie lahendust rohkem kui ükski teine. Lääts näitab osa sellest, mida selle baaslääts näitab, ning õigused tulenevad endiselt rollidest: lääts määrab, mida roll paketis näeb, mitte seda, mida tal on lubatud teha.

Lääts Reefer technician kitsendab läätse Operations controller, baasläätse, mida Larkfield juba logistikatöös kasutab. Läätsede koostajas märgite need kaardid, väljad ja toimingud, mida lääts näitab. Elemendid, mida baas ei näita, on lukustatud.

Osa Reefer technician näitab Välja jäetud
Kaardid Külmkonteinerid kai ääres, avatud kõrvalekalded, toitepunktid, tänased laevakülastused Kõik, mis puudutab nõudeid
Väljad Toite olek, seadeväärtus, viimane näit, kõrgeim temperatuur Nõude summa (baasläätses puudub), isikuandmete väljad (vaikimisi välja lülitatud)
Toimingud Kõrvalekalde põhjuse registreerimine, toitekontrolli taotlemine Seadeväärtuse muutmine ja kõrvalekalde sulgemine (ainult kontrolleritele), nõudemärkuse mustandi koostamine
Vaateehitaja
Vaateehitaja
Läätse Reefer technician koostaja, kus märkimine toimub baasläätse suhtes. Vasakus alanurgas olev plaat on keeldumine, mille saate nõude summa märkimisel: baaslääts seda ei näita, seega ei saa ka see lääts.

Proovisin siiski lisada nõude summa tehniku läätsele, sest üks tehnik oli seda palunud. Koostaja keeldus koodiga LENS_CANNOT_WIDEN ega salvestanud midagi. Läätse sees pole sellest mööda pääsemiseks võimalust: edasi saab minna laiema baasiga läätse kaudu, mis on eraldi taotlus, mille üle otsustab organisatsiooni administraator. Jätsime selle välja.

Millegi peitmine läätses ei eemalda seda Nexusest. See tähendab, et see roll seda ei näe. Koostaja näitab, kui paljude inimesteni lääts pilootprojektis jõuab (meie puhul 29), ning peab logi iga lisamise, muutmise ja tagasivõtmise kohta. Lääts määratletakse organisatsiooni jaoks üks kord ja antakse platvormirollile üksuse kaupa, nii et sama läätse Reefer technician saab sel kuul anda Rotterdami tehnikutele ja järgmisel kuul Felixstowe'i omadele.

Oskus kahjunõuete märkmete koostamiseks

Kontrollerid soovisid esimest mustandit märkusest, mis saadetakse pärast kõrvalekallet kauba omanikule. See on keeletöö, seega töötab see mudelil, ja küsimus oli, kuhu see paigutada.

Nexuses on kahte liiki oskusi ja nende erinevus on siin oluline. Manifestioskus on tüübitud rida plugina failis skills[], mille saadab täitmisele platvorm. Skills Engine'i oskus on SKILL.md pakett organisatsiooni oskusteegis, mida agendid, AI (tehisintellekti) nupud, töövood ja arendustööriistad kõik käitavad ühtemoodi. Mõlemat käsitleb peatükk 2.20, Oskused.

Meie plugina usaldustase on community ning kogukonna plugin võib deklareerida ainult selliseid manifestioskusi, mis mudelini ei ulatu (host_callback ja plugin_queue). Kaks taset, mis ulatuvad AI Provider Routerini, tool_using ja llm_only, nõuavad usaldustaset core või verified. Seega sai nõudemärkuste mustandite koostamisest Skills Engine'i oskus ning marsruuter valib mudeli Larkfieldi enda kogumist:

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

Pakett asub repositooriumis kaustas skills/draft-claim-note/, mille nimi on sama mis oskusel. Valideerisime ja laadisime selle üles terminalist:

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

Sama sisu kaks korda üleslaadimine tagastab olemasoleva versiooni, mitte uue (CONTENT_HASH_ALREADY_PUBLISHED), seega on üleslaadimise kordamine ohutu. Enne versiooni väljaandmist käitab Skills Engine selle testjuhtumid, varjurežiimis proovikäituse varasemal tööl ning pimeülevaatuse teise ettevõtte mudeli poolt, koos iga käituse aja ja kuluga.

Täisteenuse pistikprogramm

Pakett vajas ka koodi, mis töötab pidevalt: lugejat külmkonteinerite telemeetriavoo jaoks ja kirjutajat, mis avab kõrvalekalde kirje, kui näit ületab oma piire. Selline kood kuulub täisteenusega pluginasse ning lõime selle karkassi SDK enda käsuga, mis kirjutab kogu viitepuu, asendades nime:

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 installitakse asukohast https://registry.adverant.ai/npm/, kasutades tõmbeluba, mis on teie Adverant'i konto lehel Pull tokens and install commands. Tehke commit failile package-lock.json, mille esimene installimine kirjutab; tõmmise ehitus käitab käsku npm ci ja keeldub ilma selleta.

Siin on see osa meie failist nexus.manifest.json, mis erineb mallist. See ei ole kogu fail: karkassi plokid description, author, license, runtime, backend ja frontend jäävad muutmata ning validaator lükkab täisteenuse manifesti ilma nendeta tagasi. Kolm architecture lauset on seadus, mida iga plugin kordab, ja validaator kontrollib nende sõnastust. UNO esimeses neist on töövoomootor:

{
  "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 on manifesti oskus tasemega host_callback: platvorm postitab sisendi meie enda teenusele (Service) meie nimeruumis ja mitte kunagi meie nimetatud hostile. Vastuvõtja marsruut on deklareeritud kui auth: internal ja kaitstud SDK funktsiooniga serviceMiddleware, mis on kaitse Expressi kuju ning lükkab tagasi kutsetõendi, mis on väljastatud mis tahes muule pluginale, organisatsioonile, oskusele või marsruudile. Selle classification on tenant, mis on kogukonna plugina ülempiir. Peatükk 2.27, Stsenaariumide loomine, käsitleb eraldi host_callback oskust.

Sellest etapist tasub üle võtta kaks harjumust. Igal tabelil on organization_id, owner_user_id ja business_unit_id alates esimesest migratsioonist, sest telje hilisem lisamine on migratsioon üle elavate ridade. Samuti käivitasime enne iga push'i kohapeal nexus-gates, kuna see on sama käsk, mida käivitab konveier; käivitus, mis midagi ei uurinud, lõpetab koodiga 2 ja ütleb seda. Peatükk 2.19, Reeglid, mille iga laiendus pärib, loetleb väravad.

Näidisandmed testimiseks

Leht Näidisandmed testimiseks pakub kolme liiki harusid:

Liik Mida see sisaldab Kes nõustub
Sünteetiline Teie määratud koguste ja kujude põhjal genereeritud andmed; midagi ei pärine päris üksusest Mitte keegi; see on teie oma
Maskeeritud koopia Üksuse koopia, milles isiku-, tundlikud ja ärilised väljad on asendatud Andmeomanik (Rotterdami puhul Priya Natarajan)
Ainult skeem Andmehoidlate kuju ilma ridadeta Mitte keegi; migratsioonide jaoks

Genereerisime töise nädala: umbes 7 kõrvalekallet iga 100 külmkonteineri kohta, mis vastab Rotterdami töisele augustile. Ebatavalised juhtumid olid olulisemad kui maht. Küsisime toitekatkestust tühjendamise ajal, lahti jäetud ust, anduri andmelünka ja kahte nõuet ühe kõrvalekalde kohta. Leht oskab soovitada ebatavalisi juhtumeid teadmusmudeli kõrvalekallete põhjuste põhjal, mitte kunagi päris kirjete põhjal.

Iga koguste ja kujude komplekt salvestatakse seemnena, näiteks cold-chain-busy-01, koos selle sõrmejäljega. Sama seeme annab samad andmed, nii et iga testikäivitus igas harus näeb sama nädalat. Just see muutis meie 66 testi korratavaks.

Haru elab vaikimisi 72 tundi ja kõige rohkem 14 päeva. Palusin pika ülevaatuse ajal hoida meie töist haru 30 päeva ja leht keeldus veaga BRANCH_LIFE_EXCEEDED. Lahendus on see, mida teateplaat soovitab: hoidke seemet alles ja looge sellest vajaduse korral uus haru. Maskeeritud koopia järgib samu piire ning selle taotlus sisaldab põhjendust ja kestust kuni 14 päeva.

Vaate eelvaade konkreetse isikuna

Enne kui keegi Rotterdamis Cold chaini nägi, vaatasime seda nii, nagu nemad seda näeksid. Läätse eelvaade isikuna kuvab paketi täpselt nii, nagu valitud roll seda näeb, andmeharul, katkendjoonelise eelvaateraami sees.

Läätse eelvaade isikuna
Vaate eelvaade konkreetse isikuna
Cold chain nii, nagu Rotterdami külmkonteinerite tehnik seda näeb, sünteetilisel harul. Pange tähele iga avatud kõrvalekalde juures nõuete veergu märkega „läätse poolt peidetud“ ning külgpaneeli, mis ütleb, mida see lääts peidab ja miks.

Kolm reeglit muudavad eelvaated vabalt kasutatavaks. Eelvaade kasutab andmeharu, mitte kunagi elavat üksust. Teie enda õigused sellesse ei leki, nii et näete seda, mida näeb roll, mitte seda, mida näete teie. Ja see lõpeb 30 minuti pärast. Eelvaate suunamine elavale üksusele lükatakse tagasi veaga CONNECTION_SCOPE_EXCEEDED; kui vajate päris kujusid, paluge andmeomanikult maskeeritud koopiat ja tehke eelvaade sellel.

Just eelvaates tabasime tegeliku vea. Tehniku vaate temperatuurigraafik näitas seadeväärtust ja seadeväärtuse muutmine pidi olema lubatud ainult kontrolleritele. Graafik oli korras, selle all olev muutmisnupp aga mitte. Versioon 0.3.2 peitis seadeväärtuse muutmise tehnikute eest ja eelvaade oli koht, kus selle leidsime.

Teadmismudeli muutmine pärast avaldamist

Versiooniks 0.4.0 vajasime eelreisi ülevaatuste jaoks tüüpi Inspection ning seos „Excursion caused Claim“ kõlas paremini kujul „Excursion led to Claim“. Mudeli viimine versioonilt 1.3 versioonile 1.4 on teadmusmudeli muudatus ja leht Teadmusmudeli muudatused näitab selle erinevusi, mida see mõjutaks ja kus see oma teel on.

Muudatus liigub graafi muudatustaotlusena. Selle proovikäivitus loendab Rotterdami maskeeritud koopial, mida see mõjutaks, arvudena: meie puhul 1,284 ümbernimetatud linki ja mitte midagi eemaldatud. Kaks ülevaatajat kiidavad selle heaks ning konveier rakendab selle esmalt staging-keskkonnale, seejärel pilootüksusele. Keegi ei kirjuta jagatud graafi käsitsi; katse lükatakse tagasi ja salvestatakse. Kolm salvestatud küsimust kasutasid sõna „caused“ ning muudatus sisaldas igaühe jaoks automaatset ümberkirjutust, mille leht loetles. Läätse filtrid ei muutunud, sest mõlemad läätsed ainult kitsendasid endiselt.

Tootmiskeskkonda viimine

Iga väljalase liigub mööda üht teed: arendusruum, staging, pilootüksus, seejärel kõik üksused. Igal sammul on väravad ja midagi ei jäeta vahele.

Kuhu Väravad
Staging Kõik testid läbivad; kvaliteedikontrollid; manifest muutmata või laiendus aktsepteeritud; allkirjastatud kujutis
Piloot (Rotterdam) Mudelimuudatuse proovikäivitus maskeeritud koopial ilma vigadeta; poliitikakontroll läätse- ja ulatusreeglitele; kaks ülevaatajat, kes ei ole autor, neist üks andmeomanik
Kõik üksused 14 päeva piloodis; vigu alla 1 1,000 kohta, loendatuna piloodis; iga üksuse administraator nõustub oma üksuse jaoks; kaks ülevaatajat, kes ei ole autor
Keskkonnad ja keskkondade vaheline edasiviimine
Keskkonnad ja edutamine
Cold chain 0.3.2 ootab pilootväravas oma teist ülevaatajat. Paremal olev teateplaat on keeldumine katse eest edendada otse arendusruumist kõikidele üksustele.

Proovisin otseteed ühe korra, reedel, üherealise paranduse jaoks: edendada 0.4.0-dev oma arendusruumist kõikidele üksustele. See lükati tagasi veaga GATE_CANNOT_BE_SKIPPED ja midagi ei edendatud. Teateplaat käsib selle asemel edendada järgmisele sammule ja see on ainus vastus, mis on olemas.

Väljalaske ülevaatust ennast, tõendeid, mida teine ülevaataja loeb, ja kanaleid, mille üksused valivad, käsitleb peatükk 2.28, Laienduse väljalaskmine. Kaks fakti sealt kuuluvad siia, sest need kujundavad seda, kuidas vertikaali planeerida. Autorit ei loeta kunagi ülevaatajaks, nii et kaheliikmeline meeskond vajab iga väljalaske jaoks kolmandat inimest. Samuti hoiab iga keskkond eelmist versiooni 30 päeva, nii et tagasipööramine on ülevaadatud muudatus, mille konveier teeb umbes minutiga.

Olemasoleva paketi laiendamine

Mitte iga vertikaal ei alga nullist. Pakett võib pärida teiselt paketilt ja lisada ainult selle, mis on erinev. Pakett Pangandus ja maksed, mida kasutab Larchmont Bank, on kataloogi selgeim näide. Selle manifest algab nii:

{
  "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 nimetab paketi, millele see tugineb. Pangandus ja maksed säilitab Kindlustuse paketi kuju, selle jagatud vestlusklastrid ja põhisõnad ning lisab kolm oma läätse: Laenuotsused, Kaardivaidlused ja Minu konto. Iga leksikonikirje kolmas element on exact termini jaoks, mida tuleb näidata kirjapandud kujul, näiteks APR (annual percentage rate), mitte ümber sõnastatult.

Mõnda asja ei saa pärimise teel teha. Pakett ei muuda kunagi kesta, komponente ega kirjutamisreegleid, nii et alampakett ei saa konsooli ümber kujundada. Režiim, mida vajavad mitu paketti, on üks jagatud lääts, mitte koopia igas paketis: allhankena ostetud tehnoloogia register teenindab nii Kindlustust kui ka Panganduse ja maksete paketti. Kui teie alampakett vajab läätse, mis on juba olemas jagatud läätsena, kasutage seda, selle asemel et oma joonistada.

Litsentsimine järgib pärimist. Pakett litsentsitakse Enterprise'i peale ja võib vajada lisamooduleid ning litsentsidokument sisaldab neid sõltuvusi. Kindlustus vajab otsustusruume ja pitseeritud kirjeid, nii et klient, kes litsentsib sellelt pärivat paketti, vajab samuti seda lisamoodulit ning konsool keeldub väljastamast litsentsi, millest see puudub. Paketi telefoniekraanid vajavad lisaks lisamoodulit Mobiilirakendused. Kontrollige nõuete ahelat enne, kui lubate kliendile kuupäeva.

Vaate lisamine avaldatud paketile

Väikseim vertikaalne töö on uus lääts paketile, mida te ise ei kirjutanud. Kuus kuud pärast piloodi algust soovis Larkfieldi merekahjunõuete meeskond Cold chaini sisse oma läätse: kõrvalekalded ja nõuded, ilma toitepunktide ja seadeväärtusteta. Me ei puudutanud paketi koodi. Lääts on rida organisatsiooni läätseregistris, mille omanik on pakett, nii et alustasime seda läätse kuldsest rajast lehel Alusta midagi uut ja kujundasime selle Läätsekoostajas, kasutades alusena Cold chaini kontrolleri läätse. Kehtib sama reegel nagu varem: uus lääts võib peita seda, mida selle alus näitab, kuid ei saa kunagi näidata rohkem. See määratletakse organisatsiooni jaoks üks kord ja antakse igas üksuses platvormirollile. Õigus võetakse tagasi, mitte ei kustutata, ning läätse uuesti andmine loob uue õiguse, nii et see, kellel milline lääts millal oli, jääb loetavaks. Register loendab, mitu inimest läätse igal kuul omas, mitte kunagi seda, kes.

Leht Läätsed ja kes neid näevad näitab tulemust maatriksina läätse kaupa üksuse ja rolli lõikes, iga lahtri juures toimingud Lisa, Muuda ja Võta tagasi. Tehke uuele läätsele eelvaade isikuna enne selle andmist, täpselt nagu eespool.

Mis see ausalt öeldes maksma läks

Pakett puudutab kliendi kirjeid, nii et platvorm muudab mõned asjad meelega aeglaseks ja nendega peaksite arvestama esimesest päevast alates.

  1. Maskeeritud koopia vajab iga kord andmeomaniku nõusolekut. Esimesel korral kulus meil selle saamiseks päev, sest Priya soovis kõigepealt teadmusmudelit lugeda. Alustage sünteetiliste andmetega ja küsige varakult.
  2. Autor ei saa oma väljalaset ise heaks kiita ja taotlused aeguvad 3 päeva pärast. Kui teie ülevaatajad on hõivatud, ootab teie väljalase.
  3. Väljalase, mis küsib rohkem kui eelmine, näiteks e-kirjade saatmist või ühte välist aadressi, peetakse kinni, kuni kaks ülevaatajat aktsepteerivad laiema manifesti. Peatükk 2.28, Laienduse väljalaskmine, näitab lehte Manifest ja õigused, mis annab teile sellest teada enne, kui küsite.
  4. Lääts ei saa näidata seda, mida selle alusläätse peidab. Kui roll tõesti vajab rohkem, on see vestlus organisatsiooni administraatoriga, mitte seadistus.

Ükski neist ei takistanud meid kaks korda. Cold chaini teine väljalase võttis esimesest commit'ist Rotterdami piloodini aega nädala, millest suurema osa moodustasid 66 testi käivitamine kolme haru vastu ja kaks inimest tõendeid lugemas.