Sürüm 1.0.0-alpha.1en son
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

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ı.
Ö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.
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 |
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 |
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-noteAynı 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-testSDK, 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.
Üç 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 |
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.
- 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.
- 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.
- 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.
- 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.




