バージョン 1.0.0-alpha.1最新
第 2.24 章
カスタムバーティカルのエンドツーエンド構築
コールドチェーン・ドメインパックの構築実例です。最初の要件定義からすべてのユニットで稼働するリリースまで、ナレッジモデル、レンズ、スキル、フルサービスプラグイン、サンプルデータを含めて解説します。さらに、既存パックの拡張方法や、出荷済みパックへのレンズ追加方法も説明します。
このページは英語の原文から AI によって翻訳されました。不明な点がある場合は、英語のページを正としてご参照ください。 このページを英語で読む

私はCorrán Orbitalの開発者、Mateo Ruizです。普段の業務の大半は自社のペイロード・ソフトウェアの開発に費やしていますが、この章では、ある顧客のために行ったプロジェクトについてお話しします。Larkfield & Vaneは貨物保険を扱っており、その貨物のうち冷蔵コンテナ(リーファーコンテナ)で輸送される割合が増えています。岸壁でリーファーコンテナの陸上電源が失われると、温度が上昇して貨物が損傷し、数週間後に保険金請求が発生します。Larkfieldは、電源障害から保険金請求に至るまでの一連の連鎖を、Nexus上で1つの流れとして把握し、各ロールがそれぞれの担当部分のみを参照できるようにしたいと考えていました。それがCold chainパックとなりました。
以下では、私たちが構築した順序に沿って、画面、ファイル、およびコマンドを交えて説明します。途中で遭遇した2つの拒否エラーは、順調に進んだ場合よりもプラットフォームについて多くのことを教えてくれたため、あえて失敗例も残しています。リファレンス資料は本章より前の章にありますので、繰り返すのではなく参照先を示すにとどめます。私が最も頼りにしたのは、第2.18章「拡張モデル」と第2.23章「ドメインパック」であり、ソフトウェア開発キット自体については第2.21章「Plugin SDK」を横に開いて参照しました。
要件定義と役割分担
Larkfieldはプロジェクトの期間中、自社の組織内に開発者シートを私に割り当ててくれました。これは重要な点です。なぜなら、1社向けのプライベートパックは、その顧客のインストール環境内の開発スペースおよびデータブランチ上で、顧客側の担当者の承認のもとで構築されるためです。複数の顧客を対象としたパックはこれとは異なり、サンプルデータのみを使用してパブリッシャークラスター上で構築されます。そのケースについては、第2.25章「エディション別の構築」で解説しています。
要件定義は1ページに収まるものでした。
- 岸壁および船上のリーファーコンテナ:その電源、温度逸脱、およびそれに伴う保険金請求。
- 開始時のロールは2つ:岸壁のリーファー技術者と、オフィスのコールドチェーン管理者。
- パイロット運用は最初にRotterdam拠点で実施し、その後Felixstoweへ展開する。
- 3つの規則セットに対する証跡:生鮮食品に関するATP協定、医薬品のEU適正流通基準(GDP)、およびHACCP(危害要因分析重要管理点)に基づく食品安全記録。ヘーグ・ヴィスビー・ルールに基づく保険金請求でも同じ温度逸脱記録を使用するため、これについてはパイロット後の課題として記録しました。
ドメインパックはEnterpriseエディションの機能です。LarkfieldはEnterpriseを実行しているため、ドメインパックのパスを利用できました。Communityエディションでは、パック用のゴールデンパスは一切提供されません。
ゴールデンパスから始める
すべては「Start something new(新規作成)」ページから始まります。ここには、プラグイン、ドメインパック、レンズ、プラットフォーム、スキル、ワークフローという6つのゴールデンパスが用意されています。それぞれのパスは、バージョン管理されたテンプレートからリポジトリ、必要なものを宣言するマニフェスト、テスト、開発スペース、およびデータブランチを作成します。これらのパスは、コンソール、コマンドライン、およびIDE(統合開発環境)のいずれでも同様に機能し、IDEではWorkbenchツールnexus.createが、事前に確認するプランに基づいて同じ処理を実行します。
nexus createコマンド、および固定されたテンプレートが示されています。下部のプレートに注目してください。マニフェストは推奨ではなく強制であり、より多くの権限を要求するリリースは2人のレビュアーが確認するまで保留されます。私たちはそのページからドメインパックのパスを選択し、パック名をcold-chain、最初の拠点をRotterdamと名付けました。結果画面には、固定されたテンプレートdomain-pack@1.6.0の名前と、作成されたものの一覧が表示されます。具体的には、リポジトリ、4つのスコープ・2つのストア・アウトバウンドアドレスなしを宣言するマニフェスト、テンプレートからの66個のテスト、Rotterdamの開発スペース、3つの合成データブランチ、およびLarkfield独自のカタログ内の私だけが見えるドラフトエントリです。テンプレートのバージョンは固定されており、後でアップグレードする場合は他の変更と同様にレビュー済みの変更として適用されるため、テンプレートが変更されたという理由で誰かのパックが勝手に書き換わることはありません。とにかく最初のパックだったので、何かを作成する前にプランを確認できるコンソールウィザードを使用しました。
ステップ 1:パックの目的を定義する
「New domain pack(新規ドメインパック)」ウィザードには、概要、ナレッジモデル、確認と作成の3つのステップがあります。ステップ1では、以降のすべてを形作るいくつかの項目を入力します。
| フィールド | 入力内容 | 注記 |
|---|---|---|
| 名前 | コールドチェーン | リポジトリおよびカタログで使用されます |
| 目的 | 岸壁および船上のリーファーコンテナ:電源、温度逸脱、およびそれに伴う保険金請求 | |
| 業界 | 物流および海事 | Logistics and maritimeパックを基盤として構築 |
| オーナー | 作成者 | ウィザードでロックされています |
| 拠点 | Rotterdam (パイロット) | パイロット後にFelixstowe |
| テンプレート | domain-pack@1.6.0 |
ロックされています。アップグレードはレビュー済みの変更として適用されます |
| マッピングする規則 | ATP協定、EU適正流通基準、食品安全記録 | 各規則はパックの証跡マップ内の1ページになります |
ドック内のアシスタントが最後の行を提案してくれました。これには、貨物保険の請求で同じ温度逸脱記録を再利用するという点も含まれていました。ページ下部のプレートには、まだ何も作成されていないことが示されています。リポジトリ、開発スペース、およびデータブランチは、ステップ3でプランを確認した後に「Create(作成)」を押した時点で初めて作成されます。ドラフトを保存して後で再開することも可能です。
ステップ 2:ナレッジモデル
ナレッジモデルとは、パックが認識する「対象の種類(Kind)」とそれらがどのように関連付けられるかのセットです。Cold chainは、SDKからインポートされたロジスティクスベースモデルlogistics-base 4.2から開始しました。これにより、基盤となる5つのベースKind(Vessel、Port、Container、Carrier、Shipment)が提供されました。ベースKindはウィザード内では読み取り専用です。変更が必要な場合は、それを所有するパック側で変更します。
私たちは独自に5つのKindを追加しました。
| 種類 | その内容 | プロパティ |
|---|---|---|
| リーファーユニット | 冷蔵コンテナ | 9 |
| 本船寄港 | 1つのバースにおける1隻の船舶の寄港 | 6 |
| 温度逸脱 | 制限範囲外の温度 | 8 |
| 電源供給 | 陸上または船上の給電ポイント | 4 |
| 要求(クレーム) | 損傷した貨物に対する請求金額 | 7 |
すべてのプロパティは作成時にクラス分けされます。Excursionの「Reported by(報告者)」は個人情報(personal)です。「Cargo value at risk(リスクにさらされている貨物価値)」や請求の金額および決済額は商用(commercial)です。初日は面倒な事務作業のように感じられましたが、後になって2度も助けられました。なぜなら、レンズが表示してよいもの、マスクされたコピーが置き換えるもの、そしてログ行が隠すものは、このクラスによって決定されるからです。
私たちが定義したリレーションのうち2つはベースモデルに到達します。つまり、Reefer unitはPower supplyに接続され、ClaimはShipmentを参照します。ベースモデル自体は変更されません。取り下げたプロパティはモデルのバージョン1.0に残り、後のバージョンで初めて削除されるため、古いレコードに関する事実が読み取れなくなることはありません。
ステップ 3:確認と作成
ステップ3はプランです。作成されるもの、マニフェストが宣言するスコープ、データブランチ、および開発スペースが一覧表示されます。パスキーでプランを承認すると、プランにフィンガープリントが付与されます。その後の作成処理はそのプランに厳密に従って1ステップずつ実行され、任意のステップで停止してそれまでに作成されたものを保持することができます。
Cold chainのプランでは4つのスコープが宣言されました。
| スコープ | パックがそれを必要とする理由 |
|---|---|
| リーファーのテレメトリの読み取り | 電源および温度の測定値 |
| 温度逸脱の書き込み | 制限値を超えた際に温度逸脱を記録する |
| 輸送情報の読み取り | 保険金請求を該当する輸送にリンクする |
| 請求通知のドラフト作成 | ドラフト作成のみ。送信は人が行う |
そのストアはグラフとレコードでした。アウトバウンドアドレスはなく、Standardサンドボックスプロファイルが適用されました。開発スペースには4コア、16 GiBのメモリ、50 GiBのストレージが割り当てられ、ネットワークはマニフェストで宣言されたものを除いて閉じられており、署名付きイメージのみが許可され、7日間アイドル状態が続くと終了する設定になっていました。開発スペースが終了しても、その定義はリポジトリに残るため、そこから再作成できます。
3つのデータブランチは合成ジェネレーターから作成されました。顧客データは一切コピーされていません。Rotterdamのマスクされたコピーを作成するにはデータ所有者の同意が必要であり、LarkfieldではPriya Natarajanがその任にあたっているため、これについては別途申請します。
パックマニフェスト
リポジトリにはパックのマニフェストpack.jsonが保持されます。ここには、パックの名前、バージョン、継承元のパック(存在する場合)、クラスター、および用語が記述されます。クラスターは、パック内で1つのロールに表示される「レンズ」であるか、すべてのレンズにわたって機能する「共有(shared)」のいずれかです。以下は私たちのマニフェストの核心部分です。
{
"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", ""]
]
}
}レキシコン(用語集)には、パック固有の用語とそれぞれの平易な解説が、スマートフォンの画面で読める程度の短さで保持されます。
pack.jsonと並んで、マニフェストはパックがアクセスできる対象(スコープ、ストア、アウトバウンドアドレス、サンドボックスプロファイル)も宣言します。Nexusは宣言されたものだけを正確に許可し、それ以上は一切許可しません。各ツール呼び出しは宣言されたスコープと照合され、外部アドレスはリストに記載されていない限りブロックされます。宣言の内容および前回リリースからの変更点は、パックの「Manifest and permissions(マニフェストと権限)」ページで確認できます。
レンズ:各ロールに表示される内容
レンズは、そのベースが表示する内容を「絞り込む」ことしかできません。このただ1つのルールが、他のどのルールよりも私たちの設計を大きく形作りました。レンズはベースレンズが表示する内容の一部を表示し、権限は依然としてロールから付与されます。つまり、レンズはパック内でロールに何が見えるかを決定するものであり、何が許可されるかを決定するものではありません。
Reefer technician(リーファー技術者)レンズは、Larkfieldがすでにロジスティクス業務で運用しているベースレンズであるOperations controller(運用管理者)を絞り込んだものです。Lens builder(レンズビルダー)で、レンズに表示するカード、フィールド、およびアクションにチェックを入れます。ベースが表示しない項目はロックされています。
| コンポーネント | Reefer technicianが表示するもの | 除外されたもの |
|---|---|---|
| カード | 岸壁のリーファーユニット、未解決の温度逸脱、給電ポイント、本日の船舶寄港 | 保険金請求に関するすべて |
| フィールド | 電源状態、設定温度、最終測定値、最高温度 | 請求金額(ベースレンズに存在しない)、個人情報フィールド(デフォルトでオフ) |
| アクション | 温度逸脱の原因を記録する、電源チェックを依頼する | 設定温度の変更および温度逸脱のクローズ(管理者のみ)、請求通知のドラフト作成 |
ある技術者から要望があったため、私はとにかく技術者レンズに請求金額を追加しようと試みました。しかし、ビルダーはLENS_CANNOT_WIDENを出して拒否し、何も保存しませんでした。レンズ内部での回避策はありません。実現するには、より広いベースを持つレンズを使用する必要があり、それは組織管理者が判断する別の申請となります。私たちはそれを除外したままにしました。
レンズで何かを非表示にしても、それがNexusから削除されるわけではありません。このロールからは見えないという意味です。ビルダーには、パイロット運用でこのレンズの対象となる人数(私たちのケースでは29人)が表示され、すべての追加、変更、および取り下げのログが記録されます。レンズは組織に対して1回定義され、拠点ごとにプラットフォームロールへ付与されます。そのため、同じReefer technicianレンズを今月はRotterdamの技術者に、来月はFelixstoweの技術者に付与することができます。
請求メモを作成するためのスキル
管理者たちは、温度逸脱の発生後に荷主へ送る通知の初稿(ドラフト)を求めていました。これは言語処理の作業であるためモデル上で実行されますが、問題はそれをどこに配置するかでした。
Nexusには2種類のスキルがあり、ここではその違いが重要になります。マニフェストスキルは、プラグインのskills[]内の型付けされた行であり、プラットフォームによってディスパッチされます。Skills Engineスキルは、組織のスキルライブラリ内のSKILL.mdパッケージであり、エージェント、AI(人工知能)ボタン、ワークフロー、および開発者ツールのすべてが同じ方法で実行します。第2.20章「スキル」でその両方について解説しています。
私たちのプラグインの信頼レベル(trust)はcommunityであり、コミュニティプラグインはモデルに到達しないマニフェストスキル(host_callbackおよびplugin_queue)のみを宣言できます。AI Provider Routerに到達する2つのティア(tool_usingおよびllm_only)には、信頼レベルcoreまたはverifiedが必要です。そのため、請求通知のドラフト作成はSkills Engineスキルとして実装し、ルーターがLarkfield独自のプールからモデルを選択するようにしました。
---
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.パッケージはリポジトリ内のskills/draft-claim-note/に配置され、フォルダー名はスキル名と同じにします。ターミナルから検証とアップロードを実行しました。
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同じ内容を2回アップロードすると、新しいバージョンではなく既存のバージョン(CONTENT_HASH_ALREADY_PUBLISHED)が返されるため、アップロードの再実行は安全です。バージョンが公開される前に、Skills Engineはテストケース、過去の作業データを用いたシャドウ環境でのドライラン、および他社製モデルによるブラインドレビューを実行し、各実行の時間とコストを記録します。
フルサービスプラグイン
パックには常時実行されるコードも必要でした。具体的には、リーファーのテレメトリフィードのリーダー(読み取り機能)と、測定値が制限値を超えた際に温度逸脱レコードをオープンするライター(書き込み機能)です。このようなコードはフルサービスプラグインに属するため、SDK独自のコマンドを使用してスキャフォールディング(雛形生成)を行いました。これにより、名前が置換された状態でリファレンスツリー全体が出力されます。
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アカウントの「Pull tokens and install commands」ページにあるプルトークンを使用して、https://registry.adverant.ai/npm/からインストールされます。最初のインストール時に出力されるpackage-lock.jsonをコミットしてください。イメージのビルドはnpm ciを実行するため、これがないと拒否されます。
以下は、私たちのnexus.manifest.jsonのうちテンプレートと異なる部分です。これはファイル全体ではありません。スキャフォールドのdescription、author、license、runtime、backend、およびfrontendの各ブロックはそのまま維持され、これらがないとバリデーターはフルサービスマニフェストを拒否します。3つのarchitectureの文はすべてのプラグインが再宣言する規則であり、バリデーターはその文言をチェックします。1つ目の文にあるUNOはワークフローエンジンです。
{
"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ティアを持つマニフェストスキルです。プラットフォームは、私たちが指定するホストに対してではなく、私たちの名前空間内の独自のServiceに対して入力をPOSTします。レシーバールートはauth: internalとして宣言され、ガードのExpress形式であるSDKのserviceMiddlewareによって保護されます。これは、他のプラグイン、組織、スキル、またはルート向けに発行された呼び出しトークンを拒否します。そのclassificationはtenantであり、これがコミュニティプラグインの上限です。第2.27章「構築シナリオ」では、単体でのhost_callbackスキルについて順を追って説明しています。
この段階における2つの習慣は真似する価値があります。1つ目は、後から軸を追加すると稼働中の行に対するマイグレーションが発生するため、最初のマイグレーションからすべてのテーブルにorganization_id、owner_user_id、およびbusiness_unit_idを持たせることです。2つ目は、プッシュする前には毎回ローカルでnexus-gatesを実行することです。これはパイプラインが実行するのと同じコマンドであり、何も検査しなかった実行は終了コード2で終了し、その旨を表示します。第2.19章「すべての拡張機能が継承するルール」にゲートの一覧があります。
テスト用のサンプルデータ
「Sample data for testing(テスト用サンプルデータ)」ページでは、3種類のブランチが提供されています。
| 種類 | 保持する内容 | 同意する人 |
|---|---|---|
| 合成(Synthetic) | 設定した件数と形状から生成されたデータ。実際の拠点からは何も取得されません | 不要(あなた自身のものです) |
| マスクされたコピー(Masked copy) | 個人情報、機密情報、および商用フィールドが置き換えられた拠点のコピー | データ所有者(Rotterdamの場合はPriya Natarajan) |
| スキーマのみ(Schema only) | 行を含まない、ストアの形状のみ | 不要(マイグレーション用) |
私たちは繁忙期の1週間分を生成しました。リーファー100台あたり約7件の温度逸脱が発生するペースで、これはRotterdamの忙しい8月の状況に相当します。データ量よりも特殊なケース(エッジケース)の方が重要でした。荷揚げ中の電源喪失、ドアの開けっ放し、センサーの欠測、および1件の温度逸脱に対する2件の保険金請求を条件として指定しました。このページでは、実際のレコードからではなく、ナレッジモデル内の温度逸脱の原因から特殊なケースを提案することができます。
件数と形状の各セットは、そのフィンガープリントとともにcold-chain-busy-01のようなシードとして保存されます。同じシードからは同じデータが生成されるため、どのブランチのどのテスト実行でも同じ1週間分のデータが参照されます。これにより、66個のテストに再現性を持たせることができました。
ブランチの存続期間はデフォルトで72時間、最長で14日間です。長期のレビュー中に繁忙期ブランチを30日間保持しようと申請したところ、ページはBRANCH_LIFE_EXCEEDEDを出して拒否しました。解決策はプレートが提案するとおり、シードを保持しておき、必要になった時点でそこから新しいブランチを作成することです。マスクされたコピーも同じ制限に従い、その申請には理由と最長14日間の期間を含める必要があります。
特定のユーザーとしてレンズをプレビューする
Rotterdamの誰かがCold chainを目にする前に、私たちは彼らの視点でそれを確認しました。「Preview a lens as a person(担当者としてレンズをプレビュー)」機能を使うと、データブランチ上で、点線のプレビューフレーム内に、選択したロールから見えるとおりにパックが正確に描画されます。
3つのルールにより、プレビューを自由かつ安全に使用できます。1つ目に、プレビューは本番拠点ではなくデータブランチを使用します。2つ目に、あなた自身の権限がプレビューに漏れることはないため、あなたが見えるものではなく、そのロールが見えるものだけが表示されます。そして3つ目に、プレビューは30分後に終了します。プレビューの対象として本番拠点を指定すると、CONNECTION_SCOPE_EXCEEDEDで拒否されます。実際のデータ形状が必要な場合は、データ所有者にマスクされたコピーを依頼し、その上でプレビューしてください。
このプレビューによって、私たちは実際のミスを発見することができました。技術者ビューの温度チャートに設定温度が表示されていたのですが、設定温度の編集は管理者のみに許可されるべきものでした。チャート自体は問題ありませんでしたが、その下にある編集ボタンが問題でした。バージョン0.3.2で技術者から設定温度の編集を非表示にしましたが、それに気づくきっかけとなったのがこのプレビューでした。
出荷後のナレッジモデルの変更
バージョン0.4.0までに、トリップ前検査用のInspection(検査)というKindが必要になり、また「Excursion caused Claim(温度逸脱が保険金請求を引き起こした)」というリレーションは「Excursion led to Claim(温度逸脱が保険金請求につながった)」とした方がより自然であることがわかりました。モデルを1.3から1.4へ移行することはナレッジモデルの変更にあたり、「Knowledge model changes(ナレッジモデルの変更)」ページにはその差分、影響を受ける対象、および現在の進行状況が表示されます。
この変更はグラフ変更リクエストとして処理されます。そのドライランでは、Rotterdamのマスクされたコピー上で影響を受ける対象が件数としてカウントされます。私たちのケースでは、1,284個のリンクが名前変更され、削除されるものはありませんでした。2人のレビュアーが承認すると、パイプラインがそれをステージング、続いてパイロットへと適用します。共有グラフに手動で書き込むことは誰にもできません。試みても拒否され、記録に残ります。保存された3つの質問(クエリ)で「caused」という単語が使用されていましたが、この変更にはそれらすべてに対する自動書き換えが含まれており、ページに一覧表示されました。両方のレンズは依然として絞り込みのみを行っていたため、レンズのフィルターは変更されませんでした。
本番環境への昇格
すべてのリリースは、開発スペース、ステージング、パイロット拠点、そして全拠点という1つのパスに沿って進みます。各ステップにはゲートがあり、どのステップもスキップすることはできません。
| 昇格先 | ゲート |
|---|---|
| ステージング | すべてのテストに合格。品質チェック。マニフェストが未変更であるか権限拡大が承認されていること。署名付きイメージ |
| パイロット (Rotterdam) | マスクされたコピー上でのモデル変更ドライランでエラーがないこと。レンズおよびスコープのルールに関するポリシーチェック。作成者ではない2人のレビュアー(うち1人はデータ所有者) |
| 全拠点 | パイロットでの14日間の運用。パイロットでカウントされたエラーが1,000件中1件未満であること。各拠点管理者が自身の拠点について同意していること。作成者ではない2人のレビュアー |
ある金曜日、1行だけの修正のために一度だけ近道をしようとしたことがあります。開発スペースから全拠点へ0.4.0-devを直接昇格させようとしたのです。しかし、GATE_CANNOT_BE_SKIPPEDで拒否され、何も昇格されませんでした。プレートには代わりに次のステップへ昇格させるよう表示されますが、それが唯一の答えです。
リリースレビュー自体、2人目のレビュアーが確認する証跡、および拠点が選択するチャネルについては、第2.28章「拡張機能のリリース」で解説しています。そのうちの2つの事実は、バーティカル(業種別ソリューション)の計画方法を左右するため、ここで触れておきます。1つ目は、作成者はレビュアーとしてカウントされないため、2人チームの場合は毎回のリリースに3人目の担当者が必要になるということです。2つ目は、各環境は直前のバージョンを30日間保持するため、ロールバックはパイプラインが約1分で実行するレビュー済みの変更として処理されるということです。
既存パックの拡張
すべてのバーティカルがゼロから始まるわけではありません。パックは別のパックを継承し、異なる部分だけを追加することができます。Larchmont Bankが運用しているBanking and payments(銀行および決済)パックは、カタログ内で最もわかりやすい例です。そのマニフェストは次のように始まります。
{
"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は基盤となるパックを指定します。Banking and paymentsは、Insurance(保険)パックの形状、共有の会話クラスター、およびコアとなる用語を維持しつつ、独自の3つのレンズ(Lending decisions、Card disputes、My account)を追加しています。各レキシコンエントリの3番目の要素であるexactは、APR(実質年率)のように言い換えるのではなく記述どおりに表示しなければならない用語に対して指定します。
継承によっては行えないこともあります。パックはシェル、コンポーネント、または記述ルールを決して変更しないため、子パックがコンソールのスタイルを変更することはできません。複数のパックが必要とする規制対応は、各パックにコピーするのではなく1つの共有レンズとして実装します。たとえば、外部委託テクノロジーの登録簿はInsuranceとBanking and paymentsの両方で利用されます。子パックで必要なレンズがすでに共有レンズとして存在する場合は、独自に作成するのではなくそれを使用してください。
ライセンス供与もこの継承に従います。パックはEnterpriseの上位でライセンス供与され、アドオンが必要になる場合があり、ライセンス文書にはそれらの依存関係が記載されます。InsuranceにはDecision roomsおよびsealed records(封印されたレコード)が必要であるため、それを継承するパックのライセンスを取得する顧客にはそのアドオンも必要となり、コンソールはそれを除外したライセンスの発行を拒否します。また、パックのスマートフォン画面にはMobile appsアドオンも必要です。顧客に日程を約束する前に、要件の連鎖を確認してください。
出荷済みパックへのレンズの追加
最小のバーティカル作業は、自分が書いていないパックに新しいレンズを追加することです。パイロット開始から6か月後、Larkfieldの海上クレームチームは、Cold chain内に独自のレンズ(逸脱とクレームのみを表示し、電源ポイントや設定ポイントは表示しないもの)を求めました。私たちはパックのコードには触れませんでした。レンズはパックが所有する組織のレンズレジストリ内の1行であるため、「Start something new」のレンズのゴールデンパスから開始し、Cold-chain controllerレンズをベースとしてLens builderで形作りました。以前と同じルールが適用されます。新しいレンズはベースが表示するものを非表示にすることはできますが、それ以上を表示することは決してできません。これは組織全体で一度定義され、各ユニットのプラットフォームロールに付与されます。付与は取り消されるだけで削除されることはなく、レンズを再度付与すると新しい付与が作成されるため、誰がいつどのレンズを保持していたかが常に読み取れる状態に保たれます。レジストリは毎月何人がレンズを保持していたかをカウントしますが、それが誰であるかは記録しません。
「Lenses and who sees them」ページには、結果がレンズとユニットおよびロールのマトリックスとして表示され、各セルには「Add」、「Change」、「Withdraw」があります。上記と全く同様に、新しいレンズを付与する前に個人としてプレビューしてください。
実際にかかったコスト
パックは顧客の記録に触れるため、プラットフォームは意図的にいくつかの処理を遅くしています。初日からこれらを考慮して計画を立てる必要があります。
- マスクされたコピーには、毎回データ所有者の同意が必要です。私たちが最初に行った際は、Priyaがまずナレッジモデルを読むことを望んだため、届くまでに1日かかりました。合成データから開始し、早めに依頼してください。
- 作成者は自身のリリースを承認することはできず、リクエストは3日後に失効します。レビュアーが多忙な場合、リリースは待機状態になります。
- メールの送信や1つの外部アドレスへの接続など、前回よりも多くの権限を要求するリリースは、2人のレビュアーがより広範なマニフェストを承認するまで保留されます。チャプター 2.28「Releasing your extension」では、申請前にこれを確認できる「Manifest and permissions」ページを紹介しています。
- レンズは、そのベースレンズが非表示にしているものを表示することはできません。ロールが本当にそれ以上の情報を必要とする場合、それは設定の問題ではなく、組織管理者との話し合いになります。
これらが2度私たちの妨げになることはありませんでした。Cold chainの2回目のリリースは、最初のコミットからRotterdamのパイロットまで1週間で完了し、その大部分は3つのブランチに対して実行された66個のテストと、2人の担当者によるエビデンスの読み込みに費やされました。




