Versio 1.0.0-alpha.1uusin
Luku 2.24
Räätälöidyn toimialaratkaisun rakentaminen alusta loppuun
Kylmäketjun toimialapaketin käytännön toteutus ensimmäisestä toimeksiannosta aina jokaista yksikköä palvelevaan julkaisuun asti, sisältäen tietomallin, näkymät, taidon, täyden palvelun liitännäisen ja testiaineiston. Lisäksi käydään läpi, miten olemassa olevaa pakettia laajennetaan ja miten jo toimitettuun pakettiin lisätään näkymä.
Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

Olen Mateo Ruiz, kehittäjä Corrán Orbital -yrityksessä. Suurin osa viikostani kuluu omien hyötykuormaohjelmistojemme parissa, mutta tämä luku kertoo työstä, jonka teimme asiakkaalle. Larkfield & Vane vakuuttaa rahtia, ja kasvava osa siitä kulkee kylmäkonteissa. Kun kylmäkontti menettää maasähkön laiturilla, lämpötila nousee, lasti pilaantuu ja korvausvaatimus seuraa viikkoja myöhemmin. Larkfield halusi, että sen henkilöstö näkee tämän ketjun Nexuksessa yhtenä kokonaisuutena sähkövikasta korvausvaatimukseen asti, ja että kukin rooli näkee vain oman osuutensa. Siitä syntyi Cold chain -paketti.
Seuraavassa kuvataan rakennustyö siinä järjestyksessä kuin teimme sen, näkymineen, tiedostoineen ja komentoineen. Olen jättänyt virheet mukaan, koska kaksi kohtaamaamme hylkäystä opetti meille alustasta enemmän kuin ongelmaton kulku. Viitemateriaali on tätä edeltävissä luvuissa, ja viittaan niihin toistamisen sijaan. Eniten nojasin lukuihin 2.18, Laajennusmalli, ja 2.23, Toimialapaketit, sekä niiden rinnalla avoinna olleeseen lukuun 2.21, Plugin SDK, joka käsittelee itse ohjelmistokehityspakettia.
Toimeksianto ja työnjako
Larkfield antoi minulle kehittäjäpaikan organisaatiossaan projektin ajaksi. Sillä on merkitystä, koska yhden asiakkaan yksityinen paketti rakennetaan kyseisen asiakkaan omassa asennuksessa, sen kehitystiloissa ja datahaaroissa, sen henkilöstön hyväksyntöjen alaisena. Monille asiakkaille tarkoitettu paketti rakennetaan eri tavalla, julkaisijan klusterissa pelkällä esimerkkidatalla, ja tätä tapausta käsitellään luvussa 2.25, Rakentaminen kullekin versiolle.
Toimeksianto mahtui yhdelle sivulle:
- Kylmäkontit laiturilla ja aluksilla: niiden virransyöttö, lämpötilapoikkeamat ja niitä seuraavat korvausvaatimukset.
- Aluksi kaksi roolia: kylmäkonttiteknikko laiturilla ja kylmäketjun valvoja toimistossa.
- Pilotti, joka toteutetaan ensin Rotterdamin yksikössä ja siirretään sen jälkeen Felixstoween.
- Näyttöä kolmelle säännöstölle: ATP-sopimus pilaantuvista elintarvikkeista, EU:n hyvät jakelutavat lääkkeille sekä HACCP:n (vaarojen arviointi ja kriittiset hallintapisteet) mukaiset elintarviketurvallisuustiedot. Haag-Visbyn sääntöjen mukaiset korvausvaatimukset käyttävät samoja poikkeamatietoja, joten merkitsimme ne pilotin jälkeiseen vaiheeseen.
Toimialapaketit ovat Enterprise-ominaisuus. Larkfield käyttää Enterprise-versiota, joten toimialapaketin polku oli käytettävissäni. Community-versiossa paketin kultaista polkua ei tarjota lainkaan.
Aloittakaa suositellulta polulta
Kaikki alkaa Aloita jotain uutta -sivulta. Se tarjoaa kuusi kultaista polkua: plugin, toimialapaketti, linssi, alusta, taito ja työnkulku. Kukin niistä luo versioidusta mallipohjasta repositorion, manifestin, joka ilmoittaa, mitä kokonaisuus tarvitsee, testit, kehitystilan ja datahaarat. Samat polut toimivat konsolissa, komentorivillä ja kehitysympäristössänne (IDE, integrated development environment), jossa Workbench-työkalu nexus.create tekee saman työn suunnitelmalla, jonka vahvistatte ensin.
nexus create-komento ja sen kiinnitetty mallipohja. Huomatkaa alareunan ilmoitus: manifestia valvotaan pakottavasti, se ei ole pelkkä suositus, ja julkaisu, joka pyytää enemmän, pidätetään, kunnes kaksi henkilöä on tarkastanut sen.Valitsimme tältä sivulta toimialapaketin polun ja nimesimme paketin cold-chain ja sen ensimmäisen yksikön Rotterdamiksi. Tulos nimeää kiinnitetyn mallipohjan, domain-pack@1.6.0, ja luettelee, mitä se loi: repositorion, manifestin, joka ilmoittaa neljä käyttöoikeusaluetta, kaksi tietovarastoa eikä yhtään lähtevää osoitetta, 66 mallipohjan testiä, kehitystilan Rotterdamissa, kolme synteettistä datahaaraa sekä luonnosmerkinnän Larkfieldin omaan katalogiin, jonka vain minä näin. Mallipohjan versio on kiinnitetty, ja sen päivitys saapuu myöhemmin tarkastettuna muutoksena kuten mikä tahansa muu, joten kenenkään paketti ei muutu sen vuoksi, että mallipohja muuttui. Käytin ensimmäiseen pakettiimme silti konsolin ohjattua toimintoa, koska se näyttää suunnitelman ennen kuin se luo mitään.
Vaihe 1: määrittäkää paketin tarkoitus
Uusi toimialapaketti -ohjatussa toiminnossa on kolme vaihetta: perustiedot, tietomalli sekä tarkastus ja luonti. Vaihe 1 kysyy ne harvat asiat, jotka muokkaavat kaikkea sen jälkeen tulevaa.
| Kenttä | Mitä syötimme | Huomautus |
|---|---|---|
| Nimi | Cold chain | Käytetään repositoriossa ja katalogissa |
| Käyttötarkoitus | Kylmäkontit laiturilla ja aluksilla: virransyöttö, lämpötilapoikkeamat ja niitä seuraavat korvausvaatimukset | |
| Toimiala | Logistiikka ja merenkulku | Perustuu Logistiikka ja merenkulku -pakettiin |
| Omistaja | Luoja | Lukittu ohjatussa toiminnossa |
| Yksiköt | Rotterdam (pilotti) | Felixstowe pilotin jälkeen |
| Mallipohja | domain-pack@1.6.0 |
Lukittu; päivitykset tulevat tarkastettuina muutoksina |
| Kattamat säännöt | ATP-sopimus, EU:n hyvät jakelutavat, elintarviketurvallisuustiedot | Kustakin säännöstä tulee sivu paketin näyttökarttaan |
Telakan avustaja ehdotti viimeistä riviä, mukaan lukien huomion, että rahtikorvausvaatimukset käyttävät uudelleen samoja poikkeamatietoja. Sivun alareunan ilmoitus kertoo, ettei mitään ole vielä luotu. Repositorio, kehitystila ja datahaarat luodaan vasta, kun painatte Luo vaiheessa 3 nähtyänne suunnitelman. Voitte tallentaa luonnoksen ja palata myöhemmin.
Vaihe 2: tietomalli
Tietomalli on joukko niitä asiatyyppejä, joista paketti tietää, sekä niiden väliset yhteydet. Cold chain lähti liikkeelle logistiikan perusmallista, logistics-base 4.2, joka tuotiin SDK:sta ja antoi meille viisi perustyyppiä rakentamisen pohjaksi (Alus, Satama, Kontti, Kuljetusliike ja Lähetys). Perustyypit ovat ohjatussa toiminnossa vain luku -tilassa. Jos jotakin niistä on muutettava, muutos tehdään sen omistavassa paketissa.
Lisäsimme viisi omaa tyyppiä:
| Tyyppi | Mikä se on | Ominaisuudet |
|---|---|---|
| Kylmäkontti | Jäähdytetty kontti | 9 |
| Aluskäynti | Yksi alus yhdellä laituripaikalla | 6 |
| Poikkeama | Lämpötila rajojensa ulkopuolella | 8 |
| Virransyöttö | Maasähkö- tai aluksen sähköliitäntäpiste | 4 |
| Lunastaminen | Pilaantuneesta lastista vaadittu rahasumma | 7 |
Jokainen ominaisuus luokitellaan sitä luotaessa. Poikkeaman "Ilmoittaja" on henkilötieto. "Riskissä oleva lastin arvo" sekä korvausvaatimuksen summa ja sovinto ovat kaupallisia. Ensimmäisenä päivänä tämä tuntui paperityöltä, mutta myöhemmin se pelasti meidät kahdesti, koska luokat ratkaisevat, mitä linssi saa näyttää, mitä peitetty kopio korvaa ja mitä lokirivi piilottaa.
Kaksi suhteistamme ulottuu perusmalliin: kylmäkontti on kytketty virransyöttöön, ja korvausvaatimus viittaa lähetykseen. Itse perusmallia ei muuteta. Poistettu ominaisuus säilyy mallin versiossa 1.0 ja poistuu vasta myöhemmässä versiossa, joten mikään vanhoista tietueista paikkansapitänyt ei lakkaa olemasta luettavissa.
Vaihe 3: tarkistus ja luominen
Vaihe 3 on suunnitelma. Siinä luetellaan, mitä luodaan, manifestin ilmoittamat käyttöoikeusalueet, datahaarat ja kehitystila. Vahvistatte suunnitelman pääsyavaimellanne, ja suunnitelma saa sormenjäljen. Luonti noudattaa sen jälkeen suunnitelmaa täsmälleen, vaihe kerrallaan, ja voitte pysäyttää sen missä tahansa vaiheessa ja säilyttää siihen mennessä luodun.
Cold chain -paketin suunnitelma ilmoitti neljä käyttöoikeusaluetta:
| Käyttöoikeusalue | Miksi paketti tarvitsee sen |
|---|---|
| Kylmäkonttien telemetrian luku | Virta- ja lämpötilalukemat |
| Poikkeamien kirjoitus | Kirjaa poikkeaman, kun rajat ylittyvät |
| Lähetysten luku | Linkittää korvausvaatimuksen lähetykseensä |
| Korvausvaatimusilmoitusten luonnostelu | Vain luonnoksia; ihminen lähettää |
Sen tietovarastot olivat graafi ja tietueet. Sillä ei ollut lähteviä osoitteita, ja sen hiekkalaatikkoprofiili oli Standard. Kehitystilaan kuului 4 ydintä, 16 GiB muistia ja 50 GiB tallennustilaa, verkko, joka oli suljettu manifestissa ilmoitettua lukuun ottamatta, vain allekirjoitetut levykuvat sekä päättyminen 7 käyttämättömän päivän jälkeen. Kun se päättyy, sen määrittely säilyy repositoriossa, joten voitte luoda sen sieltä uudelleen.
Kolme datahaaraa tuotettiin synteettisellä generaattorilla. Asiakasdataa ei kopioitu. Rotterdamin peitetty kopio edellyttää datan omistajan suostumusta, joka Larkfieldissä on Priya Natarajan, ja sitä pyydetään erikseen.
Paketin manifesti
Repositoriossa on paketin manifesti, pack.json. Se nimeää paketin, sen version, paketin, josta se perii (jos sellainen on), sen klusterit ja sen sanaston. Klusteri on joko linssi, eli se, mitä yksi rooli näkee paketin sisällä, tai jaettu, joka toimii kaikkien linssien läpi. Tässä on omamme ydin:
{
"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", ""]
]
}
}Sanasto sisältää paketin omat sanat, ja kullekin on selkeä selite, joka on riittävän lyhyt luettavaksi puhelimella.
pack.json:n ohella manifesti ilmoittaa myös, mihin paketti saa ulottua: sen käyttöoikeusalueet, tietovarastot, lähtevät osoitteet ja hiekkalaatikkoprofiilin. Nexus myöntää täsmälleen sen eikä mitään enempää. Jokainen työkalukutsu tarkistetaan ilmoitettuja käyttöoikeusalueita vasten, ja ulkoinen osoite estetään, ellei sitä ole lueteltu. Voitte lukea ilmoituksen ja sen muutokset edelliseen julkaisuun nähden paketin Manifesti ja käyttöoikeudet -sivulla.
Linssit: mitä kukin rooli näkee
Linssi voi aina vain rajata sitä, mitä sen pohja näyttää, ja tämä yksi sääntö muokkasi suunnitteluamme enemmän kuin mikään muu. Linssi näyttää osan siitä, mitä sen pohjalinssi näyttää, ja käyttöoikeudet tulevat edelleen rooleista: linssi ratkaisee, mitä rooli näkee paketissa, ei sitä, mitä sillä on lupa tehdä.
Kylmäkonttiteknikko-linssi rajaa Operatiivinen valvoja -linssiä, joka on Larkfieldin logistiikkatyössä jo käyttämä pohjalinssi. Linssien rakennustyökalussa valitsette kortit, kentät ja toiminnot, jotka linssi näyttää. Kohteet, joita pohja ei näytä, ovat lukittuja.
| Osa | Kylmäkonttiteknikko näyttää | Jätetty pois |
|---|---|---|
| Kortit | Kylmäkontit laiturilla, avoimet poikkeamat, sähköliitäntäpisteet, tämän päivän aluskäynnit | Kaikki korvausvaatimuksiin liittyvä |
| Kentät | Virran tila, asetusarvo, viimeisin lukema, korkein lämpötila | Korvausvaatimuksen summa (ei pohjalinssissä), henkilötietokentät (oletuksena pois päältä) |
| Toiminnot | Poikkeaman syyn kirjaaminen, virtatarkistuksen pyytäminen | Asetusarvon muuttaminen ja poikkeaman sulkeminen (vain valvojat), korvausvaatimusilmoituksen luonnostelu |
Yritin silti lisätä korvausvaatimuksen summan teknikkolinssiin, koska eräs teknikko oli pyytänyt sitä. Rakennustyökalu hylkäsi sen virheellä LENS_CANNOT_WIDEN eikä tallentanut mitään. Linssin sisällä ei ole kiertotietä: eteenpäin pääsee vain laajemmalle pohjalle rakennetulla linssillä, joka on eri pyyntö ja jonka organisaation ylläpitäjä ratkaisee. Jätimme sen pois.
Kohteen piilottaminen linssissä ei poista sitä Nexuksesta. Se tarkoittaa, ettei tämä rooli näe sitä. Rakennustyökalu näyttää, kuinka moneen henkilöön linssi pilotissa ulottuu (meidän tapauksessamme 29), ja pitää lokia jokaisesta lisäyksestä, muutoksesta ja poistosta. Linssi määritellään kerran organisaatiolle ja myönnetään yksikkökohtaisesti alustan roolille, joten sama Kylmäkonttiteknikko-linssi voidaan antaa Rotterdamin teknikoille tässä kuussa ja Felixstowen teknikoille ensi kuussa.
Taito korvausvaatimusmuistiinpanojen luonnosteluun
Valvojat halusivat ensimmäisen luonnoksen ilmoituksesta, joka lähetetään lastin omistajalle poikkeaman jälkeen. Se on kielellistä työtä, joten se toimii mallin varassa, ja kysymys oli, mihin se sijoitetaan.
Nexuksessa on kahdenlaisia taitoja, ja ero on tässä merkityksellinen. Manifestitaito on tyypitetty rivi pluginin skills[]-taulukossa, ja alusta välittää sen suoritettavaksi. Skills Engine -taito on SKILL.md-paketti organisaation taitokirjastossa, ja agentit, tekoälypainikkeet, työnkulut ja kehitystyökalut suorittavat sen kaikki samalla tavalla. Luku 2.20, Taidot, käsittelee molempia.
Pluginimme luottamustaso on community, ja yhteisöplugin saa ilmoittaa vain manifestitaitoja, jotka eivät ulotu malliin (host_callback ja plugin_queue). Kaksi tasoa, jotka ulottuvat AI Provider Routeriin, tool_using ja llm_only, edellyttävät luottamustasoa core tai verified. Siksi korvausvaatimusilmoitusten luonnostelusta tuli Skills Engine -taito, ja reititin valitsee mallin Larkfieldin omasta joukosta:
---
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.Paketti sijaitsee repositoriossa hakemistossa skills/draft-claim-note/, ja kansion nimi on sama kuin taidon nimi. Validoimme ja latasimme sen päätteestä:
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-noteSaman sisällön lataaminen kahdesti palauttaa olemassa olevan version uuden sijaan (CONTENT_HASH_ALREADY_PUBLISHED), joten latauksen suorittaminen uudelleen on turvallista. Ennen version julkaisua Skills Engine suorittaa sen testitapaukset, kuivaharjoituksen varjotilassa aiemmalla työllä sekä toisen yrityksen mallin tekemän sokkoarvioinnin, ja kustakin ajosta näytetään aika ja kustannus.
Täyden palvelun liitännäinen
Paketti tarvitsi myös jatkuvasti käynnissä olevaa koodia: lukijan kylmäkonttien telemetriasyötteelle ja kirjoittajan, joka avaa poikkeamatietueen, kun lukema ylittää rajansa. Tällainen koodi kuuluu täyden palvelun pluginiin, ja loimme sen rungon SDK:n omalla komennolla, joka kirjoittaa koko viiterakenteen nimi korvattuna:
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 asennetaan osoitteesta https://registry.adverant.ai/npm/ käyttäen pull-tunnusta, jonka saatte Adverant-tilinne Pull-tunnukset ja asennuskomennot -sivulta. Tehkää commit ensimmäisen asennuksen kirjoittamasta package-lock.json-tiedostosta; levykuvan koonti suorittaa komennon npm ci ja kieltäytyy ilman sitä.
Tässä on se osa nexus.manifest.json-tiedostostamme, joka poikkeaa mallipohjasta. Se ei ole koko tiedosto: rungon description-, author-, license-, runtime-, backend- ja frontend-lohkot pysyvät ennallaan, ja validaattori hylkää täyden palvelun manifestin ilman niitä. Kolme architecture-lausetta ovat sääntö, jonka jokainen laajennus toistaa, ja validaattori tarkistaa sanamuodon. Ensimmäisessä niistä UNO on työnkulkumoottori:
{
"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 manifestitaito, jonka taso on host_callback: alusta lähettää syötteen omaan palveluumme omassa nimiavaruudessamme eikä koskaan nimeämäämme isäntään. Vastaanottajareitti on määritetty auth: internal-reitiksi, ja sitä suojaa SDK:n serviceMiddleware, suojauksen Express-muoto, joka hylkää kutsutunnuksen, joka on luotu mille tahansa muulle laajennukselle, organisaatiolle, taidolle tai reitille. Sen classification on tenant, joka on yhteisölaajennuksen yläraja. Luku 2.27, Rakennusskenaariot, käy läpi host_callback-taidon erikseen.
Tästä vaiheesta kannattaa omaksua kaksi tapaa. Jokaisessa taulussa on organization_id, owner_user_id ja business_unit_id ensimmäisestä migraatiosta alkaen, koska akselin lisääminen myöhemmin on migraatio aktiivisten rivien yli. Lisäksi ajoimme nexus-gates-komennon paikallisesti ennen jokaista pushia, koska se on sama komento, jonka putki ajaa; ajo, joka ei tutkinut mitään, päättyy koodiin 2 ja ilmoittaa siitä. Luku 2.19, Säännöt, jotka jokainen laajennus perii, luettelee portit.
Testiaineisto testausta varten
Testausdata-sivu tarjoaa kolmenlaisia haaroja:
| Tyyppi | Mitä se sisältää | Kuka hyväksyy |
|---|---|---|
| Synteettinen | Määrittämiesi määrien ja muotojen perusteella luotu data; mikään ei ole peräisin todellisesta yksiköstä | Ei kukaan; se on sinun |
| Maskattu kopio | Kopio yksiköstä, jossa henkilötiedot sekä arkaluonteiset ja kaupalliset kentät on korvattu | Datan omistaja (Rotterdamissa Priya Natarajan) |
| Vain skeema | Tietovarastojen rakenne ilman rivejä | Ei kukaan; migraatioita varten |
Loimme kiireisen viikon: noin 7 poikkeamaa 100:aa kylmäkonttia kohden, mikä vastaa kiireistä elokuuta Rotterdamissa. Poikkeustapaukset olivat määrää tärkeämpiä. Pyysimme virtakatkosta purun aikana, auki jätettyä ovea, anturikatkosta ja kahta korvausvaatimusta yhdestä poikkeamasta. Sivu voi ehdottaa poikkeustapauksia tietomallin poikkeamasyistä, ei koskaan todellisista tietueista.
Jokainen määrien ja muotojen yhdistelmä tallennetaan siemenenä, kuten cold-chain-busy-01, sormenjälkineen. Sama siemen tuottaa saman datan, joten jokainen testiajo jokaisessa haarassa näkee saman viikon. Juuri tämä teki 66 testistämme toistettavia.
Haara on oletusarvoisesti voimassa 72 tuntia ja enintään 14 päivää. Pyysin säilyttämään kiireisen haaramme 30 päivää pitkän katselmoinnin ajan, ja sivu hylkäsi pyynnön koodilla BRANCH_LIFE_EXCEEDED. Ratkaisu on se, jota ilmoitus ehdottaa: säilytä siemen ja luo siitä uusi haara tarvittaessa. Maskattua kopiota koskevat samat rajat, ja sen pyynnössä ilmoitetaan syy ja enintään 14 päivän kesto.
Esikatsele näkymää tiettynä henkilönä
Ennen kuin kukaan Rotterdamissa näki Cold chainin, tarkastelimme sitä heidän silmin. Linssin esikatselu henkilönä näyttää paketin täsmälleen niin kuin valittu rooli sen näkee, datahaarassa, katkoviivoitetun esikatselukehyksen sisällä.
Kolme sääntöä tekee esikatseluista turvallisia käyttää vapaasti. Esikatselu käyttää datahaaraa, ei koskaan aktiivista yksikköä. Omat käyttöoikeutesi eivät vuoda siihen, joten näet sen, minkä rooli näkee, etkä sitä, minkä sinä voit nähdä. Lisäksi se päättyy 30 minuutin kuluttua. Esikatselun kohdistaminen aktiiviseen yksikköön hylätään koodilla CONNECTION_SCOPE_EXCEEDED; jos tarvitset todellisia rakenteita, pyydä datan omistajalta maskattu kopio ja esikatsele sitä.
Esikatselussa havaitsimme todellisen virheen. Teknikkonäkymän lämpötilakaaviossa näkyi asetusarvo, ja asetusarvojen muokkausten oli tarkoitus olla vain valvojien käytettävissä. Kaavio oli kunnossa; sen alla oleva muokkauspainike ei ollut. Versio 0.3.2 piilotti asetusarvojen muokkaukset teknikoilta, ja virhe löytyi esikatselussa.
Tietomallin muuttaminen julkaisun jälkeen
Versioon 0.4.0 mennessä tarvitsimme Inspection-tyypin lähtöä edeltäviä tarkastuksia varten, ja relaatio "Excursion caused Claim" toimi paremmin muodossa "Excursion led to Claim". Mallin siirtäminen versiosta 1.3 versioon 1.4 on tietomallin muutos, ja Tietomallin muutokset -sivu näyttää sen erot, mihin se vaikuttaisi ja missä vaiheessa se on.
Muutos kulkee graafin muutospyyntönä. Sen kuivaharjoitus laskee Rotterdamin maskatusta kopiosta, mihin se vaikuttaisi, lukumäärinä: meillä 1 284 linkkiä nimettiin uudelleen eikä mitään poistettu. Kaksi katselmoijaa hyväksyy sen, ja putki soveltaa sen ensin staging-ympäristöön ja sitten pilottiin. Kukaan ei kirjoita jaettuun graafiin käsin; yritys hylätään ja kirjataan. Kolmessa tallennetussa kysymyksessä käytettiin sanaa "caused", ja muutos sisälsi kullekin automaattisen uudelleenkirjoituksen, jotka sivu luetteli. Linssisuodattimet eivät muuttuneet, koska molemmat linssit vain rajasivat edelleen.
Siirto tuotantoon
Jokainen julkaisu kulkee samaa polkua: kehitystila, staging, pilottiyksikkö ja lopuksi kaikki yksiköt. Jokaisessa vaiheessa on portit, eikä mitään ohiteta.
| Kohde | Portit |
|---|---|
| Staging | Kaikki testit läpäisty; laatutarkistukset; manifesti ennallaan tai laajennus hyväksytty; allekirjoitettu image |
| Pilotti (Rotterdam) | Mallimuutoksen kuivaharjoitus maskatulla kopiolla ilman virheitä; linssi- ja laajuussääntöjen käytäntötarkistus; kaksi katselmoijaa, jotka eivät ole tekijöitä, joista toinen on datan omistaja |
| Kaikki yksiköt | 14 päivää pilotissa; virheitä alle 1/1 000 pilotissa laskettuna; kunkin yksikön ylläpitäjä hyväksyy oman yksikkönsä osalta; kaksi katselmoijaa, jotka eivät ole tekijöitä |
Kokeilin oikotietä kerran, perjantaina, yhden rivin korjausta varten: ylentää 0.4.0-dev kehitystilastani kaikkiin yksiköihin. Se hylättiin koodilla GATE_CANNOT_BE_SKIPPED, eikä mitään ylennetty. Ilmoitus kehottaa ylentämään sen sijaan seuraavaan vaiheeseen, ja se on ainoa vaihtoehto.
Itse julkaisukatselmointi, toisen katselmoijan lukema näyttö ja yksiköiden valitsemat kanavat käsitellään luvussa 2.28, Laajennuksen julkaiseminen. Kaksi sen tosiasiaa kuuluu tähän, koska ne vaikuttavat vertikaalin suunnitteluun. Tekijää ei koskaan lasketa katselmoijaksi, joten kahden hengen tiimi tarvitsee kolmannen henkilön jokaiseen julkaisuun. Lisäksi jokainen ympäristö säilyttää edellisen version 30 päivää, joten palautus on katselmoitu muutos, jonka putki tekee noin minuutissa.
Olemassa olevan paketin laajentaminen
Kaikki vertikaalit eivät ala tyhjästä. Paketti voi periä toisesta paketista ja lisätä vain sen, mikä on erilaista. Banking and payments -paketti, jota Larchmont Bank käyttää, on luettelon selkein esimerkki. Sen manifesti alkaa näin:
{
"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 nimeää paketin, jonka päälle se rakentuu. Banking and payments säilyttää Insurance-paketin rakenteen, sen jaetut keskusteluklusterit ja ydinsanaston sekä lisää kolme omaa linssiä: Lending decisions, Card disputes ja My account. Kunkin sanastomerkinnän kolmas elementti on exact termille, joka on näytettävä kirjoitetussa muodossa, kuten APR (todellinen vuosikorko), eikä muotoiltava uudelleen.
Joitakin asioita ei voi tehdä perimällä. Paketti ei koskaan muuta kuorta, komponentteja tai kirjoitussääntöjä, joten alipaketti ei voi muuttaa konsolin tyyliä. Sääntely, jota useat paketit tarvitsevat, on yksi jaettu linssi eikä kopio jokaisessa: ulkoistetun teknologian rekisteri palvelee sekä Insurancea että Banking and paymentsia. Jos alipakettisi tarvitsee linssin, joka on jo olemassa jaettuna linssinä, käytä sitä oman piirtämisen sijaan.
Lisensointi seuraa perintää. Paketti lisensoidaan Enterprisen päälle ja voi edellyttää lisäosia, ja lisenssiasiakirja sisältää nämä riippuvuudet. Insurance edellyttää Decision rooms and sealed records -lisäosaa, joten asiakas, joka lisensoi siitä perivän paketin, tarvitsee myös sen, ja konsoli kieltäytyy myöntämästä lisenssiä, josta se puuttuu. Paketin puhelinnäkymät edellyttävät lisäksi Mobile apps -lisäosaa. Tarkista vaatimusketju ennen kuin lupaat asiakkaalle päivämäärän.
Näkymän lisääminen jo julkaistuun pakettiin
Pienin vertikaalityö on uusi linssi paketille, jota et ole itse kirjoittanut. Kuusi kuukautta pilotin alun jälkeen Larkfieldin merivakuutuskorvaustiimi halusi oman linssin Cold chainiin: poikkeamat ja korvausvaatimukset, ei virtapisteitä, ei asetusarvoja. Emme koskeneet paketin koodiin. Linssi on rivi organisaation linssirekisterissä, ja sen omistaa paketti, joten aloitimme sen linssin kultaisesta polusta Aloita jotain uutta -sivulla ja muotoilimme sen Linssien rakentajassa käyttäen pohjana Cold-chain controller -linssiä. Sama sääntö pätee kuin aiemmin: uusi linssi voi piilottaa sen, mitä pohja näyttää, mutta ei koskaan näyttää enempää. Se määritetään kerran organisaatiolle ja myönnetään alustan roolille kussakin yksikössä. Myöntö perutaan, ei koskaan poisteta, ja linssin antaminen uudelleen luo uuden myönnön, joten tieto siitä, kenellä oli mikäkin linssi milloinkin, säilyy luettavana. Rekisteri laskee, kuinka monella henkilöllä linssi oli kunakin kuukautena, ei koskaan sitä, keillä.
Linssit ja niiden näkijät -sivu näyttää tuloksen matriisina linssin, yksikön ja roolin mukaan, ja jokaisessa solussa on Lisää-, Muuta- ja Peru-toiminnot. Esikatsele uutta linssiä henkilönä ennen kuin myönnät sen, täsmälleen kuten edellä.
Todelliset kustannukset
Paketti käsittelee asiakkaan tietueita, joten alusta tekee joistakin asioista tarkoituksella hitaita, ja niihin kannattaa varautua ensimmäisestä päivästä lähtien.
- Maskattu kopio edellyttää joka kerta datan omistajan hyväksynnän. Meillä se kesti ensimmäisellä kerralla päivän, koska Priya halusi lukea tietomallin ensin. Aloita synteettisellä datalla ja pyydä ajoissa.
- Tekijä ei voi hyväksyä omaa julkaisuaan, ja pyynnöt raukeavat 3 päivän kuluttua. Jos katselmoijasi ovat kiireisiä, julkaisusi odottaa.
- Julkaisu, joka pyytää enemmän kuin edellinen, kuten sähköpostin lähettämistä tai yhtä ulkoista osoitetta, pidätetään, kunnes kaksi katselmoijaa hyväksyy laajemman manifestin. Luku 2.28, Laajennuksen julkaiseminen, esittelee Manifesti ja käyttöoikeudet -sivun, joka kertoo tästä ennen kuin pyydät.
- Linssi ei voi näyttää sitä, minkä sen pohjalinssi piilottaa. Jos rooli todella tarvitsee enemmän, asia on keskusteltava organisaation ylläpitäjän kanssa, eikä se ole asetus.
Mikään näistä ei ollut tiellämme kahdesti. Cold chainin toinen julkaisu vei viikon ensimmäisestä commitista Rotterdamin pilottiin, ja suurin osa ajasta kului 66 testin ajamiseen kolmea haaraa vasten ja kahden henkilön näytön lukemiseen.




