Oturum açınToplantı planlayın

Bölüm 2.24

Uçtan uca özel bir dikey çözüm oluşturma

Bilgi modeli, lensleri, bir becerisi, tam hizmet eklentisi ve örnek verileriyle birlikte, ilk özetten her birimde çalışan bir sürüme kadar Soğuk zincir alan paketinin uygulamalı bir derlemesi. Ardından halihazırda mevcut olan bir paketin nasıl genişletileceği ve kullanıma sunulmuş bir pakete nasıl lens ekleneceği.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

19 dakikalık okuma

Ben Mateo Ruiz, Corrán Orbital'da bir geliştiriciyim. Haftamın çoğu kendi faydalı yük yazılımımızla geçiyor, ancak bu bölüm bir müşterimiz için yaptığımız bir işle ilgili. Larkfield & Vane yük sigortası yapıyor ve bu yüklerin giderek artan bir payı soğutmalı konteynerlerde taşınıyor. Bir reefer rıhtımda kıyı elektriğini kaybettiğinde, sıcaklık yükselir, yük bozulur ve haftalar sonra bir hasar talebi gelir. Larkfield, çalışanlarının bu zinciri güç arızasından hasar talebine kadar Nexus içinde tek bir şey olarak görmesini ve her rolün yalnızca kendi kısmını görmesini istedi. Bu, Cold chain paketi oldu.

Aşağıda, ekranlar, dosyalar ve komutlarla birlikte bu yapıyı gerçekleştirdiğimiz sırayla bulacaksınız. Hataları da içeride bıraktım, çünkü karşılaştığımız reddedilmelerden ikisi bize platform hakkında sorunsuz ilerleyen süreçten daha fazlasını öğretti. Referans materyaller bundan önceki bölümlerde yer alıyor ve onları tekrarlamak yerine onlara işaret ediyorum. En çok yararlandıklarım bölüm 2.18, Uzantı modeli ve bölüm 2.23, Alan paketleri oldu; yazılım geliştirme kitinin kendisi için bölüm 2.21, Eklenti SDK'sı da yanlarında açıktı.

Soldan sağa sekiz kutudan oluşan bir yol: "Özet", "Altın yol", "Bilgi modeli", "Mercekler", "Beceri ve eklenti", "Örnek veriler ve önizleme", "Sürüm incelemesi", "Yükseltme". Son kutunun altında, oklarla birbirine bağlanan dört küçük kutudan oluşan ikinci bir satır yükseltme adımlarını gösterir: "Geliştirme alanı", "Hazırlık", "Pilot birim (Rotterdam)", "Tüm birimler"; her okun üzerinde "geçit" etiketli bir asma kilit simgesi bulunur. "Geliştirme alanı"ndan doğrudan "Tüm birimler"e giden kesikli bir ok üstü çizilmiştir ve GATE_CANNOT_BE_SKIPPED olarak etiketlenmiştir.
Özetten her birime kadar Cold chain yapısı.

Özet ve kimin ne yaptığı

Larkfield proje süresince bana kendi organizasyonlarında bir geliştirici koltuğu verdi. Bu önemlidir, çünkü tek bir müşteriye yönelik özel bir paket, o müşterinin kurulumunun içinde, kendi geliştirme alanlarında ve veri dallarında, kendi çalışanlarının onayları altında oluşturulur. Birçok müşteriye yönelik bir paket ise farklı şekilde, yalnızca örnek veriler içeren bir yayıncı kümesinde oluşturulur ve bölüm 2.25, Her sürüm için geliştirme, bu durumu ele alır.

Özet tek bir sayfaya sığdı:

  • Rıhtımda ve gemilerde bulunan reefer konteynerleri: güç durumları, sıcaklık sapmaları ve ardından gelen hasar talepleri.
  • Başlangıç için iki rol: rıhtımda bir reefer teknisyeni ve ofiste bir soğuk zincir kontrolörü.
  • Önce Rotterdam biriminde çalışan ve ardından Felixstowe'a geçen bir pilot uygulama.
  • Üç kural seti için kanıt: bozulabilir gıdalar için ATP anlaşması, ilaçlar için AB iyi dağıtım uygulamaları ve HACCP (tehlike analizi ve kritik kontrol noktaları) kapsamındaki gıda güvenliği kayıtları. Lahey-Visby kuralları kapsamındaki hasar talepleri aynı sapma kayıtlarını kullanır, bu nedenle bunları pilot uygulama sonrası için not ettik.

Alan paketleri bir Enterprise yeteneğidir. Larkfield, Enterprise çalıştırdığı için alan paketi yolu bana açıktı. Community sürümünde bir paket için altın yol hiç sunulmaz.

Altın yoldan başlayın

Her şey Yeni bir şeye başla sayfasında başlar. Altı altın yol sunar: eklenti, alan paketi, mercek, platform, beceri ve iş akışı. Her biri sürümlenmiş bir şablondan bir depo, öğenin neye ihtiyaç duyduğunu bildiren bir manifesto, testler, bir geliştirme alanı ve veri dalları oluşturur. Aynı yollar konsolda, komut satırında ve Workbench aracının nexus.create önce onayladığınız bir planla aynı işi yaptığı IDE'nizden (tümleşik geliştirme ortamı) çalışır.

Yeni bir şey başlatın
Yeni bir şey başlatın
Altı altın yol; her biri ne oluşturduğu, nexus create komutu ve sabitlenmiş şablonu ile birlikte. Alt kısımdaki levhaya dikkat edin: manifesto tavsiye niteliğinde değil, zorunludur ve daha fazlasını isteyen bir sürüm, iki kişi inceleyene kadar bekletilir.

O sayfadan alan paketi yolunu seçtik, pakete cold-chain ve ilk birimine Rotterdam adını verdik. Sonuç, sabitlenmiş şablon olan domain-pack@1.6.0 öğesini adlandırır ve oluşturduklarını listeler: depo, dört kapsam, iki veri deposu ve sıfır giden adres bildiren bir manifesto, şablondan 66 test, Rotterdam'da bir geliştirme alanı, üç sentetik veri dalı ve Larkfield'ın kendi kataloğunda yalnızca benim görebildiğim bir taslak girdi. Şablon sürümü sabitlenmiştir ve daha sonra yükseltilmesi diğerleri gibi incelenen bir değişiklik olarak gelir, böylece bir şablon değişti diye kimsenin paketi kendi kontrolü dışında değişmez. Yine de ilk paketimiz için konsol sihirbazını kullandım, çünkü herhangi bir şey oluşturmadan önce planı gösteriyor.

Adım 1: paketin ne için olduğunu belirtin

Yeni alan paketi sihirbazının üç adımı vardır: hakkında, bilgi modeli ve incele ve oluştur. 1. Adım, kendisinden sonraki her şeyi şekillendiren birkaç şeyi sorar.

Alan Girdiklerimiz Not
Ad Soğuk zincir Depo ve katalog için kullanılır
Ne için olduğu Rıhtımda ve gemilerde bulunan reefer konteynerleri: güç, sıcaklık sapmaları ve ardından gelen hasar talepleri
Sektör Lojistik ve denizcilik Lojistik ve denizcilik paketi üzerine inşa edilir
Sahip (Owner) Oluşturan kişi Sihirbazda kilitlidir
Birimler Rotterdam (pilot) Pilot uygulamadan sonra Felixstowe
Şablon domain-pack@1.6.0 Kilitli; yükseltmeler incelenen değişiklikler olarak gelir
Eşlediği kurallar ATP anlaşması, AB iyi dağıtım uygulamaları, gıda güvenliği kayıtları Her kural paketin kanıt haritasında bir sayfa haline gelir

Kenar çubuğundaki asistan, yük hasar taleplerinin aynı sapma kayıtlarını yeniden kullandığı noktası da dahil olmak üzere son satırı önerdi. Sayfanın altındaki bir levha henüz hiçbir şeyin oluşturulmadığını söyler. Depo, geliştirme alanı ve veri dalları yalnızca planı gördükten sonra 3. adımda Oluştur'a bastığınızda oluşturulur. Bir taslak kaydedip geri dönebilirsiniz.

Adım 2: bilgi modeli

Bilgi modeli, paketin bildiği öğe türlerinin ve bunların nasıl bağlantı kurduğunun kümesidir. Cold chain, SDK'dan içe aktarılan ve bize üzerine inşa edeceğimiz beş temel tür (Vessel, Port, Container, Carrier ve Shipment) veren lojistik temel modeli logistics-base 4.2 ile başladı. Temel türler sihirbazda salt okunurdur. Birinin değişmesi gerekirse, sahibi olan pakette değişir.

Kendi beş türümüzü ekledik:

Tür Tanımı Özellikler
Reefer ünitesi Soğutmalı bir konteyner 9
Gemi uğrağı Bir rıhtımdaki bir gemi 6
Sapma Sınırlarının dışında bir sıcaklık 8
Güç kaynağı Bir kıyı veya gemi güç noktası 4
Sahiplenme Bozulan yük için istenen para 7
Yeni alan paketi: bilgi modeli
Yeni alan paketi: bilgi modeli
Beş temel tür ve beş yeni tür içeren bilgi grafiği. Sağdaki Excursion özelliklerine bakın: her özellik oluşturulurken sınıfını taşır ve levha, hasar talebi tutarlarının ticari olduğunu, bu nedenle teknisyen merceklerinin bunları gösteremeyeceğini söyler.

Her özellik siz onu oluştururken sınıflandırılır. Bir Excursion üzerindeki "Reported by" kişiseldir. "Cargo value at risk" ile bir hasar talebinin tutarı ve ödemesi ticaridir. Bu, ilk gün kırtasiye işi gibi geldi ama daha sonra bizi iki kez kurtardı; çünkü bir merceğin neyi gösterebileceğine, maskelenmiş bir kopyanın neyi değiştireceğine ve bir günlük satırının neyi gizleyeceğine sınıflar karar verir.

İlişkilerimizden ikisi temel modele uzanır: bir Reefer unit bir Power supply'a takılıdır ve bir Claim bir Shipment'a atıfta bulunur. Temel modelin kendisi değiştirilmez. Geri çektiğiniz bir özellik modelin 1.0 sürümünde kalır ve yalnızca daha sonraki bir sürümde ayrılır, böylece eski kayıtlar için geçerli olan hiçbir şey okunamaz hale gelmez.

Adım 3: inceleyin ve oluşturun

3. Adım plandır. Nelerin oluşturulacağını, manifestonun bildireceği kapsamları, veri dallarını ve geliştirme alanını listeler. Planı geçiş anahtarınızla onaylarsınız ve plan bir parmak izi alır. Ardından oluşturma işlemi bu planı her seferinde bir adım olmak üzere tam olarak takip eder ve herhangi bir adımda durup oluşturulmuş olanı tutabilirsiniz.

Cold chain planı dört kapsam bildirdi:

Kapsam Paketin buna neden ihtiyacı var
Reefer telemetrisini oku Güç ve sıcaklık okumaları
Sapmaları yaz Sınırlar aşıldığında bir sapma kaydeder
Sevkiyatları oku Bir hasar talebini sevkiyatına bağlar
Hasar talebi notu taslağı oluştur Yalnızca taslak oluşturur; bir kişi gönderir

Veri depoları grafik ve kayıtlardı. Giden adresi yoktu ve Standart korumalı alan profiline sahipti. Geliştirme alanı 4 çekirdek, 16 GiB bellek ve 50 GiB depolama alanı, manifestonun bildirdikleri dışında kapalı bir ağ, yalnızca imzalı imajlar ve 7 boşta geçen günün ardından sona erme özelliğiyle geldi. Sona erdiğinde, tanımı depoda kalır, böylece oradan tekrar oluşturabilirsiniz.

Üç veri dalı sentetik oluşturucudan geldi. Hiçbir müşteri verisi kopyalanmadı. Rotterdam'ın maskelenmiş bir kopyası veri sahibinin onayını gerektirir ki bu kişi Larkfield'da Priya Natarajan'dır ve bunu ayrıca istersiniz.

Paket bildirimi (manifest)

Depo, paketin manifestosu olan pack.json dosyasını tutar. Paketi, sürümünü, miras aldığı paketi (varsa), kümelerini ve kelimelerini adlandırır. Bir küme ya bir rolün paket içinde gördüğü şey olan bir mercektir ya da her mercekte çalışan paylaşılan bir kümedir. İşte bizimkinin özü:

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

Sözlük, paketin kendi kelimelerini, her biri için bir telefonda okunacak kadar kısa ve sade bir açıklamayla tutar.

pack.json yanında manifesto, paketin nelere ulaşabileceğini de bildirir: kapsamları, veri depoları, giden adresleri ve korumalı alan profili. Nexus tam olarak bunu verir, fazlasını değil. Her araç çağrısı bildirilen kapsamlara göre kontrol edilir ve listelenmediği sürece bir dış adres engellenir. Bildirimi ve son sürüme göre yapılan değişikliği paketin Manifesto ve izinler sayfasında okuyabilirsiniz.

Lensler: her rolün gördükleri

Bir mercek, temelinin gösterdiği şeyi her zaman yalnızca daraltabilir ve bu tek kural, tasarımımızı diğer tüm kurallardan daha fazla şekillendirdi. Bir mercek, temel merceğinin gösterdiği şeyin bir kısmını gösterir ve izinler yine rollerden gelir: bir mercek, bir rolün neler yapmasına izin verildiğine değil, pakette ne gördüğüne karar verir.

Reefer technician merceği, Larkfield'ın lojistik işleri için halihazırda çalıştırdığı temel mercek olan Operations controller'ı daraltır. Mercek oluşturucuda merceğin göstereceği kartları, alanları ve eylemleri işaretlersiniz. Temelin göstermediği öğeler kilitlidir.

Bileşen Reefer technician gösterir Dışarıda bırakılanlar
Kartlar Rıhtımdaki reefer birimleri, açık sapmalar, güç noktaları, bugünkü gemi uğrakları Hasar talepleriyle ilgili her şey
Alanlar Güç durumu, ayar noktası, son okuma, en yüksek sıcaklık Hasar talebi tutarı (temel mercekte yok), kişisel alanlar (varsayılan olarak kapalı)
Eylemler Bir sapma nedeni kaydet, güç kontrolü iste Bir ayar noktasını değiştir ve bir sapmayı kapat (yalnızca kontrolörler), bir hasar talebi notu taslağı oluştur
Mercek oluşturucu
Mercek oluşturucu
Temel merceğine göre işaretlenmiş Reefer technician için Mercek oluşturucu. Sol alttaki levha, hasar talebi tutarını işaretlediğinizde aldığınız reddedilmedir: temel mercek bunu göstermez, dolayısıyla bu mercek de gösteremez.

Bir teknisyen istediği için yine de teknisyen merceğine hasar talebi tutarını eklemeye çalıştım. Oluşturucu LENS_CANNOT_WIDEN ile reddetti ve hiçbir şey kaydetmedi. Merceğin içinde geçici bir çözüm yoktur: ilerlemenin yolu, daha geniş bir temel üzerinde bir mercek, yani organizasyon yöneticisinin karar verdiği farklı bir istektir. Biz onu dışarıda bıraktık.

Bir mercekte bir şeyi gizlemek onu Nexus'tan kaldırmaz. Bu rolün onu görmediği anlamına gelir. Oluşturucu, bir merceğin pilot uygulamada kaç kişiye ulaşacağını (bizim durumumuzda 29) gösterir ve her Ekleme, Değiştirme ve Geri Çekme işleminin günlüğünü tutar. Bir mercek organizasyon için bir kez tanımlanır ve bir platform rolüne birim başına verilir; böylece aynı Reefer technician merceği bu ay Rotterdam'ın teknisyenlerine ve gelecek ay Felixstowe'unkilere verilebilir.

Talep notları taslağı hazırlamak için bir beceri

Kontrolörler bir sapmadan sonra yük sahibine giden notun ilk taslağını istediler. Bu bir dil işidir, dolayısıyla bir model üzerinde çalışır ve soru bunu nereye koyacağımızdı.

Nexus'ta iki tür beceri vardır ve aradaki fark burada önemlidir. Bir manifesto becerisi, bir eklentinin skills[] dosyasında bulunan ve platform tarafından gönderilen tipli bir satırdır. Bir Skills Engine becerisi ise organizasyonun beceri kitaplığında bulunan ve aracıların, YZ (yapay zeka) düğmelerinin, iş akışlarının ve geliştirici araçlarının hepsinin aynı şekilde çalıştırdığı bir SKILL.md paketidir. Bölüm 2.20, Beceriler, her ikisini de kapsar.

Eklentimizin güven düzeyi community olarak ayarlanmıştır ve bir topluluk eklentisi yalnızca bir modele ulaşmayan manifesto becerilerini (host_callback ve plugin_queue) bildirebilir. AI Provider Router'a ulaşan iki katman olan tool_using ve llm_only, core veya verified güven düzeyine ihtiyaç duyar. Böylece hasar talebi notu taslağı oluşturma bir Skills Engine becerisi haline geldi ve yönlendirici, modeli Larkfield'ın kendi havuzundan seçer:

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

Paket, depodaki skills/draft-claim-note/ içinde yaşar ve klasör adı becerinin adına eşittir. Terminalden doğruladık ve yükledik:

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

Aynı içeriği iki kez yüklemek yeni bir sürüm yerine mevcut sürümü döndürür (CONTENT_HASH_ALREADY_PUBLISHED), bu nedenle yüklemeyi yeniden çalıştırmak güvenlidir. Bir sürüm yayınlanmadan önce Skills Engine, test senaryolarını, geçmiş çalışmalar üzerinde gölgede bir deneme çalışmasını ve başka bir şirketin modeli tarafından yapılan kör bir incelemeyi, her çalışmanın süresi ve maliyetiyle birlikte çalıştırır.

Tam hizmet eklentisi

Paketin ayrıca sürekli çalışan bir koda ihtiyacı vardı: reefer telemetri akışı için bir okuyucu ve bir okuma sınırlarını aştığında bir sapma kaydı açan bir yazıcı. Bunun gibi kodlar tam hizmetli bir eklentiye aittir ve bunu, adı değiştirilmiş olarak tüm referans ağacını yazan SDK'nın kendi komutuyla iskelet haline getirdik:

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, Adverant hesabınızın Çekme belirteçleri ve kurulum komutları sayfasındaki çekme belirteci ile https://registry.adverant.ai/npm/ üzerinden kurulur. İlk kurulumun yazdığı package-lock.json dosyasını işleyin (commit); imaj yapısı npm ci çalıştırır ve bu dosya olmadan işlemi reddeder.

İşte nexus.manifest.json dosyamızın şablondan farklı olan kısmı. Dosyanın tamamı değildir: iskeletin description, author, license, runtime, backend ve frontend blokları olduğu gibi kalır ve doğrulayıcı bunlar olmadan tam hizmetli bir manifestoyu reddeder. Üç architecture cümlesi, her eklentinin yeniden ifade ettiği yasadır ve doğrulayıcı ifadeleri kontrol eder. İlk cümledeki UNO, iş akışı motorudur:

{
  "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, host_callback katmanına sahip bir manifesto becerisidir: platform, girdiyi adlandırdığımız bir ana bilgisayara asla değil, kendi ad alanımız içindeki kendi Hizmetimize gönderir. Alıcı rotası auth: internal olarak bildirilir ve korumanın Express biçimi olan SDK'nın serviceMiddleware öğesi ile korunur; bu koruma başka herhangi bir eklenti, organizasyon, beceri veya rota için basılmış bir çağrı belirtecini reddeder. classification değeri tenant olup, bu bir topluluk eklentisi için tavandır. Bölüm 2.27, Yapı senaryoları, bir host_callback becerisini tek başına adım adım inceler.

Bu aşamadaki iki alışkanlık kopyalanmaya değerdir. Her tablo ilk taşıma işleminden (migration) itibaren organization_id, owner_user_id ve business_unit_id taşır, çünkü daha sonra bir eksen eklemek canlı satırlar üzerinde bir taşıma işlemidir. Ve her gönderimden (push) önce yerel olarak nexus-gates çalıştırdık, çünkü bu, hattın (pipeline) çalıştırdığı komutun aynısıdır; hiçbir şeyi incelemeyen bir çalışma 2 koduyla çıkar ve bunu belirtir. Bölüm 2.19, Her uzantının miras aldığı kurallar, geçitleri listeler.

Test için örnek veriler

Test için örnek veri sayfası üç tür dal sunar:

Tür Ne barındırır Kim onaylar
Sentetik Ayarladığınız sayılardan ve şekillerden oluşturulan veriler; gerçek bir birimden hiçbir şey gelmez Hiç kimse; sizindir
Maskelenmiş kopya Bir birimin kişisel, hassas ve ticari alanları değiştirilmiş bir kopyası Veri sahibi (Rotterdam için Priya Natarajan)
Yalnızca şema Satır içermeyen, veri depolarının şekli Hiç kimse; taşıma işlemleri için

Yoğun bir hafta oluşturduk: her 100 reefer'da yaklaşık 7 sapma, ki Rotterdam'da yoğun bir Ağustos ayı böyle görünür. Sıra dışı durumlar hacimden daha önemliydi. Boşaltma sırasında güç kaybı, açık bırakılmış bir kapı, bir sensör boşluğu ve bir sapma için iki hasar talebi istedik. Sayfa, asla gerçek kayıtlardan değil, bilgi modelindeki sapma nedenlerinden sıra dışı durumlar önerebilir.

Her sayı ve şekil kümesi, parmak iziyle birlikte cold-chain-busy-01 gibi bir tohum (seed) olarak kaydedilir. Aynı tohum aynı verileri verir, böylece her daldaki her test çalışması aynı haftayı görür. 66 testimizi tekrarlanabilir kılan şey buydu.

Bir dal varsayılan olarak 72 saat ve en fazla 14 gün yaşar. Uzun bir inceleme sırasında yoğun dalımızı 30 gün tutmayı istedim ve sayfa BRANCH_LIFE_EXCEEDED ile reddetti. Çözüm, levhanın önerdiği çözümdür: tohumu tutun ve ihtiyacınız olduğunda ondan yeni bir dal oluşturun. Maskelenmiş bir kopya da aynı sınırları izler ve isteği bir neden ve 14 güne kadar bir süre taşır.

Bir lensi bir kişi olarak önizleyin

Rotterdam'daki herhangi biri Cold chain'i görmeden önce, biz ona onların bakacağı gibi baktık. Bir merceği bir kişi olarak önizle, paketi tam olarak seçilen bir rolün gördüğü gibi, bir veri dalı üzerinde, kesikli bir önizleme çerçevesi içinde oluşturur.

Bir merceği bir kişi olarak önizle
Bir lensi bir kişi olarak önizleyin
Sentetik bir dal üzerinde, bir Rotterdam reefer teknisyeninin gördüğü şekliyle Cold chain. Her açık sapmada "mercek tarafından gizlendi" olarak işaretlenmiş hasar talebi sütununa ve bu merceğin neyi ve neden gizlediğini söyleyen yan panele dikkat edin.

Üç kural, önizlemelerin serbestçe kullanılmasını güvenli kılar. Bir önizleme, asla canlı birimi değil, bir veri dalını kullanır. Kendi izinleriniz içine sızmaz, böylece sizin görebildiğinizi değil, rolün gördüğünü görürsünüz. Ve 30 dakika sonra sona erer. Bir önizlemeyi canlı bir birime yönlendirmek CONNECTION_SCOPE_EXCEEDED ile reddedilir; gerçek şekillere ihtiyacınız varsa, veri sahibinden maskelenmiş bir kopya isteyin ve önizlemeyi onun üzerinde yapın.

Gerçek bir hatayı yakaladığımız yer önizleme oldu. Teknisyen görünümündeki sıcaklık grafiği ayar noktasını gösteriyordu ve ayar noktası düzenlemeleri yalnızca kontrolörler içindi. Grafik iyiydi; altındaki düzenleme düğmesi değildi. Sürüm 0.3.2, ayar noktası düzenlemelerini teknisyenlerden gizledi ve bunu bulduğumuz yer önizleme oldu.

Kullanıma sunulduktan sonra bilgi modelini değiştirme

Sürüm 0.4.0 itibarıyla sefer öncesi denetimler için bir Inspection türüne ihtiyacımız vardı ve "Excursion caused Claim" ilişkisi "Excursion led to Claim" olarak daha iyi okunuyordu. Modeli 1.3'ten 1.4'e taşımak bir bilgi modeli değişikliğidir ve Bilgi modeli değişiklikleri sayfası bunun farkını (diff), neye dokunacağını ve yolun neresinde olduğunu gösterir.

Değişiklik bir grafik değişiklik isteği olarak ilerler. Deneme çalışması, Rotterdam'ın maskelenmiş kopyasında neye dokunacağını sayı olarak hesaplar: bizim için 1.284 bağlantı yeniden adlandırıldı ve hiçbir şey kaldırılmadı. İki incelemeci onaylar ve hat bunu önce hazırlık (staging) ortamına, ardından pilot uygulamaya uygular. Hiç kimse paylaşılan grafiğe elle yazmaz; bir girişim reddedilir ve kaydedilir. Kaydedilmiş üç soru "caused" kelimesini kullanıyordu ve değişiklik bunların her biri için sayfanın listelediği otomatik bir yeniden yazma taşıyordu. Mercek filtreleri değişmedi, çünkü her iki mercek de hala yalnızca daraltma yapıyordu.

Canlı ortama taşıyın

Her sürüm tek bir yol boyunca ilerler: geliştirme alanı, hazırlık ortamı, bir pilot birim, ardından tüm birimler. Her adımın geçitleri vardır ve hiçbir şey bir adımı atlamaz.

Hedef Kapılar
Hazırlık (Staging) Tüm testler geçer; kalite kontrolleri; manifesto değişmemiş veya genişletme kabul edilmiş; imzalı imaj
Pilot (Rotterdam) Maskelenmiş kopya üzerinde hatasız model değişikliği deneme çalışması; mercek ve kapsam kuralları üzerinde politika kontrolü; yazar olmayan iki incelemeci, bunlardan biri veri sahibi
Tüm birimler Pilot uygulamada 14 gün; pilot uygulamada sayılan, 1.000'de 1'in altında hata; her birim yöneticisi kendi birimi için onay verir; yazar olmayan iki incelemeci
Ortamlar ve yükseltme
Ortamlar ve yükseltme
Pilot geçidinde ikinci incelemecisini bekleyen Cold chain 0.3.2. Sağdaki levha, doğrudan bir geliştirme alanından tüm birimlere yükseltmeye çalışmanın reddedilmesidir.

Bir Cuma günü, tek satırlık bir düzeltme için kısayolu bir kez denedim: 0.4.0-dev sürümünü geliştirme alanımdan tüm birimlere yükseltmek. GATE_CANNOT_BE_SKIPPED ile reddedildi ve hiçbir şey yükseltilmedi. Levha bunun yerine bir sonraki adıma yükseltmenizi söyler ve var olan tek yanıt budur.

Sürüm incelemesinin kendisi, ikinci bir incelemecinin okuduğu kanıtlar ve birimlerin seçtiği kanallar bölüm 2.28, Uzantınızı yayınlama içindedir. Oradaki iki gerçek buraya aittir, çünkü dikey bir çözümü nasıl planladığınızı şekillendirirler. Yazar asla bir incelemeci olarak sayılmaz, bu nedenle iki kişilik bir ekibin her sürüm için üçüncü bir kişiye ihtiyacı vardır. Ve her ortam bir önceki sürümü 30 gün boyunca tutar, böylece geri alma işlemi, hattın yaklaşık bir dakika içinde yaptığı incelenen bir değişikliktir.

Halihazırda mevcut olan bir paketi genişletme

Her dikey çözüm sıfırdan başlamaz. Bir paket başka bir paketten miras alabilir ve yalnızca farklı olanı ekleyebilir. Larchmont Bank'ın çalıştırdığı Banking and payments paketi, katalogdaki en net örnektir. Manifestosu şöyle başlar:

{
  "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, üzerine inşa edildiği paketi adlandırır. Banking and payments, Insurance paketinin şeklini, paylaşılan konuşma kümelerini ve temel kelimelerini korur ve kendine ait üç mercek ekler: Lending decisions, Card disputes ve My account. Her sözlük girdisinin üçüncü öğesi, yeniden ifade edilmek yerine APR (yıllık yüzde oranı) gibi yazıldığı şekliyle gösterilmesi gereken bir terim için exact değeridir.

Miras alarak yapamayacağınız bazı şeyler vardır. Bir paket kabuğu, bileşenleri veya yazım kurallarını asla değiştirmez, bu nedenle bir alt paket konsolu yeniden şekillendiremez. Birkaç paketin ihtiyaç duyduğu bir düzen, her birinde bir kopya olmak yerine paylaşılan tek bir mercektir: dış kaynaklı teknoloji kaydı hem Insurance hem de Banking and payments paketlerine hizmet eder. Alt paketinizin halihazırda paylaşılan bir mercek olarak var olan bir merceğe ihtiyacı varsa, kendinizinkini çizmek yerine onu kullanın.

Lisanslama mirası takip eder. Bir paket Enterprise üzerine lisanslanır ve eklentilere (add-on) ihtiyaç duyabilir ve lisans belgesi bu bağımlılıkları taşır. Insurance paketi, Decision rooms and sealed records eklentisine ihtiyaç duyar; bu nedenle onu miras alan bir paketi lisanslayan bir müşterinin de bu eklentiye ihtiyacı vardır ve konsol bunu dışarıda bırakan bir lisansı vermeyi reddeder. Bir paketin telefon ekranları Mobile apps eklentisine de ihtiyaç duyar. Bir müşteriye tarih sözü vermeden önce gereksinimler zincirini kontrol edin.

Kullanıma sunulmuş bir pakete lens ekleme

En küçük dikey çalışma, sizin yazmadığınız bir paket üzerinde yeni bir mercektir. Pilotun altıncı ayında Larkfield'ın deniz hasar talepleri ekibi, Cold chain içinde kendine ait bir mercek istedi: sapmalar ve hasar talepleri, güç noktaları yok, ayar noktaları yok. Paketin koduna dokunmadık. Mercek, kuruluşun mercek kayıt defterinde pakete ait bir satırdır; bu nedenle onu Yeni bir şey başlatın sayfasındaki mercek altın yolundan başlattık ve Mercek oluşturucuda, temel olarak Cold-chain controller merceğini alarak şekillendirdik. Daha önceki kural aynen geçerlidir: yeni mercek, temelinin gösterdiğini gizleyebilir ancak hiçbir zaman daha fazlasını gösteremez. Kuruluş için bir kez tanımlanır ve her birimde bir platform rolüne verilir. Bir yetki geri çekilir, asla silinmez ve merceğin yeniden verilmesi yeni bir yetki oluşturur; böylece hangi merceğin ne zaman kimde olduğu okunabilir kalır. Kayıt defteri, her ay bir merceğe kaç kişinin sahip olduğunu sayar, asla kimin sahip olduğunu değil.

Mercekler ve onları kimin gördüğü sayfası, sonucu mercek ile birim ve rolden oluşan bir matris olarak gösterir; her hücrede Ekle, Değiştir ve Geri çek seçenekleri bulunur. Yeni merceği vermeden önce, tam olarak yukarıda olduğu gibi, bir kişi olarak önizleyin.

Gerçek maliyeti ne oldu

Bir paket bir müşterinin kayıtlarına dokunur; bu nedenle platform bazı işlemleri bilerek yavaşlatır ve bunları ilk günden itibaren planlamanız gerekir.

  1. Maskelenmiş bir kopya her seferinde veri sahibinin onayını gerektirir. Bizimki ilk seferde bir günde geldi, çünkü Priya önce bilgi modelini okumak istedi. Sentetik verilerle başlayın ve erkenden talep edin.
  2. Yazar kendi sürümünü onaylayamaz ve talepler 3 gün sonra geçersiz olur. İnceleyicileriniz meşgulse sürümünüz bekler.
  3. Bir öncekinden daha fazlasını isteyen bir sürüm, örneğin e-posta gönderme veya tek bir dış adres, iki inceleyici genişletilmiş manifesti kabul edene kadar bekletilir. Bölüm 2.28, Uzantınızı yayımlama, bunu siz talep etmeden önce size bildiren Manifest ve izinler sayfasını gösterir.
  4. Bir mercek, temel merceğinin gizlediğini gösteremez. Bir rolün gerçekten daha fazlasına ihtiyacı varsa, bu bir ayar değil, kuruluş yöneticisiyle yapılacak bir görüşmedir.

Bunların hiçbiri yolumuza iki kez çıkmadı. Cold chain'in ikinci sürümü, ilk commit'ten Rotterdam pilotuna kadar bir hafta sürdü; bunun büyük kısmı üç dala karşı çalışan 66 test ve kanıtları okuyan iki kişiydi.