PieteiktiesPieteikt konsultāciju

2.24. nodaļa

Pielāgota nozares risinājuma pilna cikla izveide

Praktisks aukstuma ķēdes domēna pakotnes izstrādes piemērs no sākotnējā apraksta līdz laidienam, kas darbojas katrā struktūrvienībā, ietverot zināšanu modeli, skata lēcas, prasmi, pilna servisa spraudni un paraugdatus. Pēc tam — kā paplašināt jau esošu pakotni un kā pievienot skata lēcu jau izlaistai pakotnei.

Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

19 minūšu lasīšana

Esmu Mateo Ruiz, izstrādātājs uzņēmumā Corrán Orbital. Lielākā daļa manas nedēļas paiet pie mūsu pašu kravas programmatūras, taču šī nodaļa ir par darbu, ko veicām klienta uzdevumā. Larkfield & Vane apdrošina kravas, un arvien lielāka to daļa tiek pārvadāta refrižeratorkonteineros. Kad refrižeratorkonteiners piestātnē zaudē krasta elektroapgādi, temperatūra kāpj, krava sabojājas, un pēc vairākām nedēļām seko prasība. Larkfield vēlējās, lai viņu darbinieki šo ķēdi Nexus redzētu kā vienotu veselumu, no elektroapgādes bojājuma līdz prasībai, turklāt katra loma redzētu tikai savu daļu. Tā radās pakotne Cold chain.

Turpmāk aprakstīta izstrāde tādā secībā, kādā to veicām, ar ekrāniem, failiem un komandām. Kļūdas esmu atstājis, jo divi atteikumi, ar kuriem saskārāmies, mums iemācīja par platformu vairāk nekā veiksmīgais scenārijs. Atsauces materiāli atrodas iepriekšējās nodaļās, un es uz tiem norādu, nevis tos atkārtoju. Visvairāk balstījos uz 2.18. nodaļu “Paplašinājumu modelis” un 2.23. nodaļu “Nozaru pakotnes”, blakus turot atvērtu 2.21. nodaļu “Plugin SDK” par pašu programmatūras izstrādes rīkkopu.

Ceļš no kreisās uz labo pusi ar astoņiem lodziņiem: “Uzdevums”, “Zelta ceļš”, “Zināšanu modelis”, “Skati”, “Prasme un spraudnis”, “Paraugdati un priekšskatījums”, “Laidiena pārskatīšana”, “Paaugstināšana”. Zem pēdējā lodziņa otrā rindā ar bultām savienoti četri mazāki lodziņi parāda paaugstināšanas soļus: “Izstrādes vide”, “Testēšanas vide”, “Pilotvienība (Rotterdam)”, “Visas vienības”, un uz katras bultas ir piekaramās slēdzenes ikona ar uzrakstu “vārti”. Raustīta bulta no “Izstrādes vide” tieši uz “Visas vienības” ir pārsvītrota un apzīmēta ar GATE_CANNOT_BE_SKIPPED.
Cold chain izstrāde no darba uzdevuma līdz katrai vienībai.

Uzdevuma apraksts un pienākumu sadalījums

Uz projekta laiku Larkfield piešķīra man izstrādātāja vietu savā organizācijā. Tas ir svarīgi, jo privāta pakotne vienam klientam tiek veidota šī klienta instalācijā, tā izstrādes vidēs un datu zaros, ar tā darbinieku apstiprinājumiem. Pakotne, kas paredzēta daudziem klientiem, tiek veidota citādi, izdevēja klasterī tikai ar parauga datiem, un šo gadījumu aplūko 2.25. nodaļa “Izstrāde katram izdevumam”.

Darba uzdevums ietilpa vienā lappusē:

  • Refrižeratorkonteineri piestātnē un uz kuģiem: to elektroapgāde, temperatūras novirzes un prasības, kas tām seko.
  • Sākumā divas lomas: refrižeratoru tehniķis piestātnē un aukstuma ķēdes kontrolieris birojā.
  • Izmēģinājums, kas vispirms darbojas Roterdamas vienībā un pēc tam pāriet uz Felikstovu.
  • Pierādījumi trim noteikumu kopumiem: ATP nolīgumam par ātrbojīgiem pārtikas produktiem, ES labas izplatīšanas praksei zālēm un pārtikas nekaitīguma uzskaitei saskaņā ar HACCP (riska analīze un kritiskie kontroles punkti). Prasības saskaņā ar Hāgas–Visbija noteikumiem izmanto tos pašus noviržu ierakstus, tāpēc atzīmējām tās laikam pēc izmēģinājuma.

Nozaru pakotnes ir Enterprise iespēja. Larkfield izmanto Enterprise, tāpēc nozares pakotnes ceļš man bija pieejams. Community izdevumā pakotnes zelta ceļš netiek piedāvāts vispār.

Sāciet ar ieteicamo ceļu

Viss sākas lapā “Sākt kaut ko jaunu”. Tajā piedāvāti seši zelta ceļi: spraudnis, nozares pakotne, lēca, platforma, prasme un darbplūsma. Katrs no tiem izveido repozitoriju no versijota veidnes, manifestu, kas deklarē, kas šim veidojumam nepieciešams, testus, izstrādes vidi un datu zarus. Tie paši ceļi darbojas konsolē, komandrindā un jūsu IDE (integrētajā izstrādes vidē), kur Workbench rīks nexus.create veic to pašu darbu ar plānu, ko jūs vispirms apstiprināt.

Sākt ko jaunu
Sākt ko jaunu
Seši zelta ceļi, katram norādīts, ko tas izveido, tā nexus create komanda un tā piesaistītā veidne. Ievērojiet plāksni lejasdaļā: manifests tiek piemērots obligāti, nevis ieteikuma kārtā, un laidiens, kas pieprasa vairāk, tiek aizturēts, līdz to pārskata divi cilvēki.

No šīs lapas izvēlējāmies nozares pakotnes ceļu, nosaucot pakotni cold-chain un tās pirmo vienību Rotterdam. Rezultātā norādīta piesaistītā veidne domain-pack@1.6.0 un uzskaitīts, kas izveidots: repozitorijs, manifests, kas deklarē četrus tvērumus, divas krātuves un nevienu izejošo adresi, 66 testi no veidnes, izstrādes vide Roterdamā, trīs sintētisko datu zari un melnraksta ieraksts paša Larkfield katalogā, ko redzēju tikai es. Veidnes versija ir piesaistīta, un tās vēlākā jaunināšana tiek saņemta kā pārskatīta izmaiņa tāpat kā jebkura cita, tāpēc neviena pakotne nemainās tikai tāpēc, ka mainījusies veidne. Pirmajai pakotnei tomēr izmantoju konsoles vedni, jo tas parāda plānu, pirms kaut ko izveido.

1. darbība: norādiet, kam pakotne ir paredzēta

Vednim “Jauna nozares pakotne” ir trīs soļi: apraksts, zināšanu modelis un pārskatīšana un izveide. 1. solī tiek uzdoti tie daži jautājumi, kas nosaka visu turpmāko.

Lauks Ko ievadījām Piezīme
Nosaukums Cold chain Tiek izmantots repozitorijam un katalogam
Kam tā paredzēta Refrižeratorkonteineri piestātnē un uz kuģiem: elektroapgāde, temperatūras novirzes un prasības, kas tām seko
Nozare Loģistika un jūrniecība Balstās uz loģistikas un jūrniecības pakotni
Īpašnieks Persona, kas to izveido Vednī bloķēts
Vienības Rotterdam (izmēģinājums) Felixstowe pēc izmēģinājuma
Veidne domain-pack@1.6.0 Bloķēta; jauninājumi tiek saņemti kā pārskatītas izmaiņas
Noteikumi, kurus tā kartē ATP nolīgums, ES labas izplatīšanas prakse, pārtikas nekaitīguma uzskaite Katrs noteikums kļūst par lapu pakotnes pierādījumu kartē

Pēdējo rindu ieteica asistents dokā, tostarp norādi, ka kravas prasības atkārtoti izmanto tos pašus noviržu ierakstus. Plāksne lapas lejasdaļā norāda, ka vēl nekas nav izveidots. Repozitorijs, izstrādes vide un datu zari tiek izveidoti tikai tad, kad 3. solī nospiežat “Izveidot” pēc tam, kad esat redzējis plānu. Varat saglabāt melnrakstu un atgriezties vēlāk.

2. darbība: zināšanu modelis

Zināšanu modelis ir to lietu veidu kopums, par kurām pakotne zina, un to savstarpējās saites. Cold chain sākās no loģistikas bāzes modeļa logistics-base 4.2, kas importēts no SDK un deva mums piecus bāzes veidus, uz kuriem balstīties (Vessel, Port, Container, Carrier un Shipment). Vednī bāzes veidi ir tikai lasāmi. Ja kāds no tiem jāmaina, tas tiek mainīts pakotnē, kurai tas pieder.

Pievienojām piecus savus veidus:

Veids Kas tas ir Rekvizīti
Refrižeratora vienība Refrižeratorkonteiners 9
Kuģa ienākšana Viens kuģis pie vienas piestātnes 6
Novirze Temperatūra ārpus tās robežām 8
Elektroapgāde Krasta vai kuģa elektroapgādes punkts 4
Piesaistīt Par sabojātu kravu pieprasītā nauda 7
Jauna nozares pakotne: zināšanu modelis
Jauna domēna pakotne: zināšanu modelis
Zināšanu grafs ar pieciem bāzes veidiem un pieciem jauniem. Aplūkojiet Novirzes rekvizītus labajā pusē: katram rekvizītam klase tiek piešķirta tā izveides brīdī, un plāksne norāda, ka prasību summas ir komercinformācija, tāpēc tehniķu lēcas tās nevar rādīt.

Katram rekvizītam klase tiek piešķirta tā izveides brīdī. “Ziņotājs” Novirzei ir personisks. “Riskam pakļautās kravas vērtība” un prasības summa un noregulējums ir komercinformācija. Pirmajā dienā tas šķita kā formalitāte, bet vēlāk mūs izglāba divreiz, jo klases nosaka, ko lēca drīkst rādīt, ko maskēta kopija aizstāj un ko žurnāla rinda paslēpj.

Divas no mūsu relācijām sniedzas bāzes modelī: refrižeratora vienība ir pievienota elektroapgādei, un prasība attiecas uz sūtījumu. Pats bāzes modelis netiek mainīts. Atsaukts rekvizīts paliek modeļa versijā 1.0 un tiek izņemts tikai kādā vēlākā versijā, tāpēc nekas, kas bija patiess par veciem ierakstiem, nepārstāj būt lasāms.

3. darbība: pārskatīšana un izveide

3. solis ir plāns. Tajā uzskaitīts, kas tiks izveidots, tvērumi, ko manifests deklarēs, datu zari un izstrādes vide. Jūs apstiprināt plānu ar savu piekļuves atslēgu, un plāns saņem pirkstu nospiedumu. Izveide pēc tam precīzi seko šim plānam soli pa solim, un jūs varat apturēt jebkurā solī un paturēt izveidoto.

Cold chain plāns deklarēja četrus tvērumus:

Tvērums Kāpēc tas pakotnei nepieciešams
Lasīt refrižeratoru telemetriju Elektroapgādes un temperatūras rādījumi
Rakstīt novirzes Reģistrē novirzi, kad tiek pārkāptas robežas
Lasīt sūtījumus Sasaista prasību ar tās sūtījumu
Sagatavot prasību piezīmju melnrakstus Tikai melnraksti; nosūta cilvēks

Tās krātuves bija grafs un ieraksti. Tai nebija izejošo adrešu, un tai bija Standard smilškastes profils. Izstrādes videi bija 4 kodoli, 16 GiB atmiņas un 50 GiB krātuves, tīkls, kas slēgts visam, izņemot manifestā deklarēto, tikai parakstīti attēli un beigas pēc 7 neaktivitātes dienām. Kad tā beidzas, tās definīcija paliek repozitorijā, tāpēc jūs to izveidojat no jauna no turienes.

Trīs datu zari tika iegūti no sintētisko datu ģeneratora. Klientu dati netika kopēti. Roterdamas maskētai kopijai nepieciešama datu īpašnieka piekrišana, kas Larkfield gadījumā ir Priya Natarajan, un to jūs pieprasāt atsevišķi.

Pakotnes manifests

Repozitorijā glabājas pakotnes manifests pack.json. Tajā norādīts pakotnes nosaukums, tās versija, pakotne, no kuras tā manto (ja tāda ir), tās klasteri un tās vārdi. Klasteris ir vai nu lēca, kas ir tas, ko viena loma redz pakotnē, vai koplietots, kas darbojas visās lēcās. Lūk, mūsējā pamatdaļa:

{
  "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ā glabājas pakotnes pašas vārdi ar vienkāršu skaidrojumu katram, pietiekami īsu, lai to izlasītu tālrunī.

Līdzās pack.json manifests deklarē arī to, kam pakotne drīkst piekļūt: tās tvērumus, krātuves, izejošās adreses un smilškastes profilu. Nexus piešķir tieši to un neko vairāk. Katrs rīka izsaukums tiek pārbaudīts attiecībā pret deklarētajiem tvērumiem, un ārēja adrese tiek bloķēta, ja vien tā nav norādīta sarakstā. Deklarāciju un izmaiņas salīdzinājumā ar pēdējo laidienu varat apskatīt pakotnes lapā “Manifests un atļaujas”.

Skata lēcas: ko redz katra loma

Lēca var tikai sašaurināt to, ko rāda tās bāze, un šis viens noteikums noteica mūsu dizainu vairāk nekā jebkurš cits. Lēca rāda daļu no tā, ko rāda tās bāzes lēca, un atļaujas joprojām nāk no lomām: lēca nosaka, ko loma redz pakotnē, nevis to, ko tai atļauts darīt.

Lēca Reefer technician sašaurina Operations controller — bāzes lēcu, ko Larkfield jau izmanto loģistikas darbam. Lēcu veidotājā jūs atzīmējat kartītes, laukus un darbības, ko lēca rāda. Vienumi, ko bāze nerāda, ir bloķēti.

Komponents Reefer technician rāda Neiekļauts
Kartītes Refrižeratora vienības piestātnē, atvērtās novirzes, elektroapgādes punkti, šodienas kuģu ienākšanas Viss, kas attiecas uz prasībām
Lauki Elektroapgādes stāvoklis, iestatītā vērtība, pēdējais rādījums, augstākā temperatūra Prasības summa (nav bāzes lēcā), personiskie lauki (pēc noklusējuma izslēgti)
Darbības Reģistrēt novirzes cēloni, pieprasīt elektroapgādes pārbaudi Mainīt iestatīto vērtību un slēgt novirzi (tikai kontrolieriem), sagatavot prasības piezīmes melnrakstu
Skatījumu veidotājs
Skatījumu veidotājs
Lēcu veidotājs lēcai Reefer technician, atzīmēts attiecībā pret tās bāzes lēcu. Plāksne apakšējā kreisajā stūrī ir atteikums, ko saņemat, atzīmējot prasības summu: bāzes lēca to nerāda, tāpēc arī šī lēca to nevar.

Tomēr mēģināju pievienot prasības summu tehniķa lēcai, jo kāds tehniķis to bija lūdzis. Veidotājs atteica ar LENS_CANNOT_WIDEN un neko nesaglabāja. Lēcas ietvaros apiešanas ceļa nav: risinājums ir lēca uz plašākas bāzes, kas ir cits pieprasījums, par kuru lemj organizācijas administrators. Mēs to neiekļāvām.

Kaut kā paslēpšana lēcā to neizņem no Nexus. Tas nozīmē, ka šī loma to neredz. Veidotājs parāda, cik cilvēkus lēca sasniegs izmēģinājumā (mūsu gadījumā 29), un uztur žurnālu par katru pievienošanu, izmaiņu un atsaukšanu. Lēca tiek definēta vienreiz visai organizācijai un piešķirta katrā vienībā platformas lomai, tāpēc to pašu Reefer technician lēcu var šomēnes piešķirt Roterdamas tehniķiem, bet nākammēnes — Felikstovas tehniķiem.

Prasme prasību piezīmju sagatavošanai

Kontrolieri vēlējās pirmo melnrakstu piezīmei, kas pēc novirzes tiek nosūtīta kravas īpašniekam. Tas ir valodas darbs, tāpēc tas darbojas uz modeļa, un jautājums bija, kur to izvietot.

Nexus ir divu veidu prasmes, un šeit atšķirība ir būtiska. Manifesta prasme ir tipizēta rinda spraudņa skills[], ko izsauc platforma. Skills Engine prasme ir SKILL.md pakotne organizācijas prasmju bibliotēkā, ko aģenti, MI (mākslīgā intelekta) pogas, darbplūsmas un izstrādātāju rīki palaiž vienādi. 2.20. nodaļa “Prasmes” aplūko abas.

Mūsu spraudņa uzticamība ir community, un kopienas spraudnis drīkst deklarēt tikai tādas manifesta prasmes, kas nesasniedz modeli (host_callback un plugin_queue). Abiem līmeņiem, kas sasniedz AI Provider Router, tool_using un llm_only, nepieciešama uzticamība core vai verified. Tāpēc prasību piezīmju melnrakstu sagatavošana kļuva par Skills Engine prasmi, un maršrutētājs izvēlas modeli no paša Larkfield kopas:

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

Pakotne atrodas repozitorijā mapē skills/draft-claim-note/, kuras nosaukums sakrīt ar prasmes nosaukumu. Mēs to validējām un augšupielādējām no termināļa:

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

Atkārtoti augšupielādējot to pašu saturu, tiek atgriezta esošā versija, nevis jauna (CONTENT_HASH_ALREADY_PUBLISHED), tāpēc augšupielādes atkārtota palaišana ir droša. Pirms versija tiek izlaista, Skills Engine izpilda tās testa gadījumus, izmēģinājuma palaidi ēnas režīmā uz iepriekšējā darba un aklo pārskatīšanu, ko veic citas kompānijas modelis, norādot katras palaides laiku un izmaksas.

Pilna servisa spraudnis

Pakotnei bija nepieciešams arī kods, kas darbojas visu laiku: refrižeratoru telemetrijas plūsmas lasītājs un rakstītājs, kas atver novirzes ierakstu, kad rādījums pārkāpj savas robežas. Šāds kods pieder pilna servisa spraudnī, un mēs to izveidojām ar paša SDK komandu, kas uzraksta visu atsauces koku ar aizstātu nosaukumu:

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 tiek instalēts no https://registry.adverant.ai/npm/, izmantojot izvilkšanas marķieri no jūsu Adverant konta lapas “Izvilkšanas marķieri un instalēšanas komandas”. Iesniedziet (commit) package-lock.json, ko izveido pirmā instalēšana; attēla būvēšana izpilda npm ci un bez tā atsakās darboties.

Šeit ir tā mūsu nexus.manifest.json daļa, kas atšķiras no veidnes. Tas nav viss fails: sagataves bloki description, author, license, runtime, backend un frontend paliek nemainīti, un validators noraida pilna servisa manifestu bez tiem. Trīs architecture teikumi ir likums, ko atkārto katrs spraudnis, un validators pārbauda to formulējumu. UNO pirmajā no tiem ir darbplūsmu dzinējs:

{
  "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 ir manifesta prasme ar līmeni host_callback: platforma nosūta ievadi mūsu pašu Service, mūsu nosaukumvietā, un nekad uz resursdatoru, ko mēs norādām. Saņēmēja maršruts ir deklarēts kā auth: internal un aizsargāts ar SDK serviceMiddleware, kas ir aizsarga Express forma un noraida izsaukuma marķieri, kas izdots jebkuram citam spraudnim, organizācijai, prasmei vai maršrutam. Tā classification ir tenant, kas ir augšējā robeža kopienas spraudnim. 2.27. nodaļā “Scenāriju veidošana” atsevišķi aplūkota host_callback prasme.

Divus šī posma ieradumus ir vērts pārņemt. Katrā tabulā ir organization_id, owner_user_id un business_unit_id jau no pirmās migrācijas, jo ass pievienošana vēlāk ir migrācija pār dzīvām rindām. Un pirms katras nosūtīšanas mēs lokāli palaidām nexus-gates, jo tā ir tā pati komanda, ko palaiž konveijers; palaišana, kas neko nepārbaudīja, beidzas ar kodu 2 un to arī paziņo. 2.19. nodaļā “Noteikumi, ko manto katrs paplašinājums” uzskaitīti vārti.

Paraugdati testēšanai

Lapā “Paraugdati testēšanai” ir pieejami trīs zaru veidi:

Veids Ko tas satur Kas piekrīt
Sintētiski Dati, kas ģenerēti no jūsu iestatītajiem skaitiem un formām; nekas nenāk no reālas vienības Neviens; tas ir jūsu
Maskēta kopija Vienības kopija, kurā personiskie, sensitīvie un komerciālie lauki ir aizstāti Datu īpašnieks (Rotterdam gadījumā Priya Natarajan)
Tikai shēma Krātuvju forma bez rindām Neviens; migrācijām

Mēs ģenerējām noslogotu nedēļu: aptuveni 7 novirzes uz katriem 100 refrižeratorkonteineriem, kā izskatās noslogots augusts Rotterdam. Neparastie gadījumi bija svarīgāki par apjomu. Mēs pieprasījām strāvas zudumu izkraušanas laikā, atstātas atvērtas durvis, sensora datu pārtraukumu un divas pretenzijas par vienu novirzi. Lapa var ieteikt neparastus gadījumus, balstoties uz noviržu cēloņiem zināšanu modelī, nekad uz reāliem ierakstiem.

Katra skaitu un formu kopa tiek saglabāta kā sēkla, piemēram, cold-chain-busy-01, ar tās nospiedumu. Tā pati sēkla dod tos pašus datus, tāpēc katra testu palaišana katrā zarā redz to pašu nedēļu. Tieši tas padarīja mūsu 66 testus atkārtojamus.

Zars pēc noklusējuma pastāv 72 stundas un ne ilgāk kā 14 dienas. Ilgas pārskatīšanas laikā es lūdzu saglabāt mūsu noslogoto zaru 30 dienas, un lapa atteica ar BRANCH_LIFE_EXCEEDED. Risinājums ir tas, ko iesaka paziņojums: saglabājiet sēklu un, kad nepieciešams, izveidojiet no tās jaunu zaru. Uz maskētu kopiju attiecas tie paši ierobežojumi, un tās pieprasījumā norāda iemeslu un ilgumu līdz 14 dienām.

Skata lēcas priekšskatīšana konkrētas personas skatījumā

Pirms kāds Rotterdam ieraudzīja Cold chain, mēs to aplūkojām tā, kā to redzētu viņi. Funkcija “Priekšskatīt skatu kā persona” attēlo pakotni tieši tā, kā to redz izvēlēta loma, datu zarā, raustītā priekšskatījuma rāmī.

Priekšskatīt skatu kā persona
Skata lēcas priekšskatīšana konkrētas personas skatījumā
Cold chain, kā to sintētiskā zarā redz Rotterdam refrižeratorkonteineru tehniķis. Ievērojiet pretenziju kolonnu, kas katrā atvērtajā novirzē atzīmēta ar “paslēpts ar skatu”, un sānu paneli, kas norāda, ko šis skats slēpj un kāpēc.

Trīs noteikumi ļauj priekšskatījumus droši izmantot brīvi. Priekšskatījums izmanto datu zaru, nekad dzīvo vienību. Jūsu pašu atļaujas tajā nenoplūst, tāpēc jūs redzat to, ko redz loma, nevis to, ko varat redzēt jūs. Un tas beidzas pēc 30 minūtēm. Priekšskatījuma vēršana uz dzīvu vienību tiek noraidīta ar CONNECTION_SCOPE_EXCEEDED; ja jums nepieciešamas reālas formas, lūdziet datu īpašniekam maskētu kopiju un veiciet priekšskatījumu tajā.

Tieši priekšskatījumā mēs pamanījām reālu kļūdu. Temperatūras diagrammā tehniķa skatā bija redzama iestatītā vērtība, bet iestatītās vērtības labojumi bija paredzēti tikai kontrolieriem. Diagramma bija kārtībā; poga zem tās nebija. Versija 0.3.2 paslēpa iestatītās vērtības labojumus no tehniķiem, un kļūdu mēs atradām tieši priekšskatījumā.

Zināšanu modeļa maiņa pēc izlaišanas

Līdz versijai 0.4.0 mums bija nepieciešams veids Inspection pirmsreisa pārbaudēm, un relācija “Excursion caused Claim” labāk izklausījās kā “Excursion led to Claim”. Modeļa pārvietošana no 1.3 uz 1.4 ir zināšanu modeļa izmaiņa, un lapā “Zināšanu modeļa izmaiņas” redzama tās atšķirība, tas, ko tā skartu, un tas, kurā ceļa posmā tā atrodas.

Izmaiņa tiek nodota kā grafa izmaiņu pieprasījums. Tās izmēģinājuma palaišana Rotterdam maskētajā kopijā saskaita, ko tā skartu, kā skaitus: mūsu gadījumā 1 284 pārdēvētas saites un nekas nav noņemts. To apstiprina divi pārskatītāji, un konveijers to piemēro vispirms testēšanas videi, pēc tam pilotam. Neviens neraksta koplietojamajā grafā manuāli; mēģinājums tiek noraidīts un reģistrēts. Trīs saglabātos jautājumos tika lietots vārds “caused”, un izmaiņa ietvēra automātisku pārrakstīšanu katram no tiem, ko lapa uzskaitīja. Skatu filtri nemainījās, jo abi skati joprojām tikai sašaurināja.

Virzīšana uz produkcijas vidi

Katrs laidiens virzās pa vienu ceļu: izstrādes vide, testēšanas vide, pilotvienība, pēc tam visas vienības. Katrā solī ir vārti, un neviens tos neizlaiž.

Uz Kontrolpunkti
Testēšanas vide Visi testi izturēti; kvalitātes pārbaudes; manifests nemainīts vai paplašinājums pieņemts; parakstīts attēls
Pilots (Rotterdam) Modeļa izmaiņu izmēģinājuma palaišana maskētajā kopijā bez kļūdām; politikas pārbaude skatu un tvēruma noteikumiem; divi pārskatītāji, kas nav autors, viens no tiem ir datu īpašnieks
Visas vienības 14 dienas pilotā; kļūdas mazāk nekā 1 no 1000, skaitot pilotā; katras vienības administrators piekrīt savas vienības vārdā; divi pārskatītāji, kas nav autori
Vides un virzīšana
Vides un virzīšana
Cold chain 0.3.2 gaida pie pilota vārtiem savu otro pārskatītāju. Paziņojums labajā pusē ir atteikums mēģinājumam paaugstināt tieši no izstrādes vides uz visām vienībām.

Es vienreiz, piektdienā, izmēģināju īsceļu vienas rindas labojumam: paaugstināt 0.4.0-dev no savas izstrādes vides uz visām vienībām. Tas tika noraidīts ar GATE_CANNOT_BE_SKIPPED, un nekas netika paaugstināts. Paziņojums iesaka paaugstināt uz nākamo soli, un tā ir vienīgā iespējamā atbilde.

Pati laidiena pārskatīšana, pierādījumi, ko lasa otrais pārskatītājs, un kanāli, ko izvēlas vienības, aprakstīti 2.28. nodaļā “Jūsu paplašinājuma izlaišana”. Divi fakti no tās ir svarīgi šeit, jo tie nosaka, kā plānot vertikāli. Autors nekad netiek uzskatīts par pārskatītāju, tāpēc divu cilvēku komandai katram laidienam nepieciešams trešais cilvēks. Un katra vide 30 dienas glabā iepriekšējo versiju, tāpēc atgriešana ir pārskatīta izmaiņa, ko konveijers veic aptuveni minūtes laikā.

Jau esošas pakotnes paplašināšana

Ne katra vertikāle sākas no nulles. Pakotne var mantot no citas un pievienot tikai to, kas atšķiras. Pakotne Banking and payments, ko izmanto Larchmont Bank, ir skaidrākais piemērs katalogā. Tās manifests sākas šādi:

{
  "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 norāda pakotni, uz kuras tā balstās. Banking and payments saglabā pakotnes Insurance struktūru, tās koplietojamos sarunu klasterus un pamatterminus un pievieno trīs savus skatus: Lending decisions, Card disputes un My account. Katra leksikona ieraksta trešais elements ir exact terminam, kas jāparāda tieši tā, kā rakstīts, piemēram, APR (gada procentu likme), nevis jāpārformulē.

Dažas lietas nevar paveikt ar mantošanu. Pakotne nekad nemaina čaulu, komponentus vai rakstīšanas noteikumus, tāpēc pakārtota pakotne nevar mainīt konsoles stilu. Regulējums, kas nepieciešams vairākām pakotnēm, ir viens koplietojams skats, nevis kopija katrā no tām: ārpakalpojumā nodoto tehnoloģiju reģistrs kalpo gan Insurance, gan Banking and payments. Ja jūsu pakārtotajai pakotnei nepieciešams skats, kas jau pastāv kā koplietojams skats, izmantojiet to, nevis veidojiet savu.

Licencēšana seko mantošanai. Pakotne tiek licencēta papildus Enterprise, un tai var būt nepieciešami papildinājumi, un licences dokumentā ir norādītas šīs atkarības. Insurance nepieciešami Decision rooms un aizzīmogoti ieraksti, tāpēc klientam, kas licencē pakotni, kura to manto, arī ir nepieciešams šis papildinājums, un konsole atsakās izsniegt licenci, kurā tā nav. Pakotnes tālruņa ekrāniem nepieciešams arī papildinājums Mobile apps. Pārbaudiet prasību ķēdi, pirms apsolāt klientam datumu.

Skata lēcas pievienošana izlaistai pakotnei

Mazākais vertikāles darbs ir jauns skats pakotnē, ko neesat rakstījis jūs. Sešus mēnešus pēc pilota sākuma Larkfield jūras pretenziju komanda vēlējās savu skatu Cold chain ietvaros: novirzes un pretenzijas, bez strāvas pieslēgumiem, bez iestatītajām vērtībām. Mēs neaizskārām pakotnes kodu. Skats ir rinda organizācijas skatu reģistrā, kas pieder pakotnei, tāpēc mēs to sākām no skata zelta ceļa lapā “Sākt kaut ko jaunu” un veidojām Skatu veidotājā, par pamatu ņemot skatu Cold-chain controller. Spēkā ir tas pats noteikums kā iepriekš: jaunais skats var paslēpt to, ko rāda tā pamats, un nekad nevar parādīt vairāk. Tas tiek definēts vienreiz organizācijai un piešķirts platformas lomai katrā vienībā. Piešķīrums tiek atsaukts, nekad dzēsts, un skata atkārtota piešķiršana izveido jaunu piešķīrumu, tāpēc paliek salasāms, kam un kad bija kāds skats. Reģistrs uzskaita, cik cilvēkiem katru mēnesi bija skats, nekad – kam.

Lapā “Skati un kas tos redz” rezultāts redzams kā skatu matrica pēc vienības un lomas, katrā šūnā ar darbībām Pievienot, Mainīt un Atsaukt. Pirms piešķiršanas priekšskatiet jauno skatu kā persona, tieši kā aprakstīts iepriekš.

Cik tas patiesībā izmaksāja

Pakotne skar klienta ierakstus, tāpēc platforma dažas lietas apzināti padara lēnas, un jums tās jāplāno jau no pirmās dienas.

  1. Maskētai kopijai katru reizi nepieciešama datu īpašnieka piekrišana. Mūsējā pirmo reizi pienāca pēc dienas, jo Priya vispirms vēlējās izlasīt zināšanu modeli. Sāciet ar sintētiskiem datiem un lūdziet laikus.
  2. Autors nevar apstiprināt savu laidienu, un pieprasījumi zaudē spēku pēc 3 dienām. Ja jūsu pārskatītāji ir aizņemti, jūsu laidiens gaida.
  3. Laidiens, kas pieprasa vairāk nekā iepriekšējais, piemēram, pasta sūtīšanu vai vienu ārēju adresi, tiek aizturēts, līdz divi pārskatītāji pieņem paplašināto manifestu. 2.28. nodaļā “Jūsu paplašinājuma izlaišana” parādīta lapa “Manifests un atļaujas”, kas to pasaka, pirms jūs pieprasāt.
  4. Skats nevar parādīt to, ko slēpj tā pamata skats. Ja lomai patiešām nepieciešams vairāk, tā ir saruna ar organizācijas administratoru, nevis iestatījums.

Neviens no šiem ierobežojumiem mūs netraucēja divreiz. Otrais Cold chain laidiens no pirmās iesūtīšanas līdz Rotterdam pilotam aizņēma nedēļu, lielākoties 66 testus, kas darbojās pret trim zariem, un divus cilvēkus, kas lasīja pierādījumus.