バージョン 1.0.0-alpha.1最新
第 2.23 章
ドメインパック
ドメインパックの構成要素と pack.json の記述内容、レンズとレンズレジストリ、ナレッジモデル、コネクター、モバイルオーバーレイ、ユニットに対してパックのライセンスを付与して有効化する方法、および Adverant が提供する10個のパックについて説明します。
このページは英語の原文から AI によって翻訳されました。不明な点がある場合は、英語のページを正としてご参照ください。 このページを英語で読む

私がCorrán Orbitalで構築したパックは、地上局チームのみが使用していた2つのプラグインと12個のSkills Engineスキルから始まりました。ミッション運用部門から同じものを求められたとき、私には2つの選択肢がありました。すべてをコピーしてあらゆるものを二重に保守するか、1つのナレッジモデルと2つのレンズを備え、部門ごとに切り替えられるドメインパックにするかです。パックにするには1週間かかりました。明日同じ選択を迫られても同じ決断を下すでしょうし、次回は最初からパックとして作り始めるでしょう。
ドメインパックは、ある業界の仕事の進め方をNexusにもたらします。これには、その業界における対象物の種類とそのつながり方、そして各ロールに表示される内容が含まれます。また、人々が毎日使用するテンプレートやワークフロー、業界の規則が求める証跡、そして電波のない場所でもスマートフォンで動作する画面を備えています。シェルやそのコンポーネントを変更することは決してなく、記述ルールを変更することもありません。新しい業界はパックであり、アプリではありません。
パックの構成要素
内部的には、パックは4つの要素で構成されており、いずれもプラットフォーム内のパック固有のコードではありません。
- エンタイトルメントチェックにおける機能グループのバンドル。パックのコントロールは、一連の機能グループに属します。パックが追加するすべてのメニュー行とパネルタブは、Nexusの他の部分と同じメカニズムによって、利用権あり、ティーザー表示、または非表示のいずれかに決定されます。
- パックマニフェスト(
pack.json)。パックの画面クラスターとその用語、レンズ、およびスマートフォン画面を宣言します。 - 自身の付与を検証するクローズドモジュール。パックのコンパイル済みブレインなど、判断を行うサーバーコードは、内部にライセンス検証器を備えており、署名付きライセンスを自らチェックします。モジュールの外部からこれをオンにすることはできません。
- カタログエントリ。これにより、パックがもたらす機能と必要な要件とともに、ドメインパックページにパックが表示されます。
これらの上部に、ユーザーの目に触れる部分が配置されます。ナレッジモデルとレンズ、テンプレート、ワークフロー、Skills Engineスキル、すでにレコードを保持しているシステムへの読み取り専用コネクタ、各規則からそれに対応するレコードへの証跡マップ、およびモバイルオーバーレイです。
pack.json ファイル
以下は、Banking and paymentsパックのマニフェストを、1つのシートを持つ1つのレンズと2つの用語に絞り込んだものです。そのファイルIDはfintechであり、nameにはパックの作業名が保持されます。コンソールとカタログにはBanking and paymentsとして表示されます。
{
"id": "fintech",
"name": "Financial services",
"version": "0.1",
"inherits": "insurance",
"screenCount": 10,
"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": [
{ "id": "FL01-A01", "title": "Credit desk today", "who": "Omar Haddad, credit analyst", "doing": "Seeing which applications are waiting and which rule held each one" },
{ "id": "FL01-A04", "title": "Refer to credit committee", "who": "Omar Haddad, credit analyst", "doing": "Sending a loan above his mandate to two people who can decide it" }
]
}
],
"lexicon": {
"core": [],
"fin": [
["affordability", "whether someone can pay it back without hardship", ""],
["mandate", "the most one person may lend alone", ""]
]
},
"world": {
"tenants": [
{
"id": "larchmont",
"name": "Larchmont Bank",
"kind": "bank",
"market": "GB",
"locale": "en-GB",
"people": 212,
"plan": { "areas": ["H", "C", "E", "B", "X", "FL01", "FL02", "FL03"], "of": 12 },
"ai": { "onDevice": "allowed", "personalDataToCloudModels": "uk-only", "sealRequiresUno": true }
}
],
"seats": [
{
"id": "credit-analyst",
"person": "Omar Haddad",
"tenant": "larchmont",
"title": "Credit analyst",
"lens": "FL01",
"clusters": ["C", "E", "B", "X"],
"home": "FL01-A01",
"posture": "desk"
}
]
}
}上から順に各フィールドを説明します。
| フィールド | 記載内容 |
|---|---|
id |
パックのID(小文字) |
name |
その作業名 |
version |
パック自体のバージョン |
inherits |
このパックの基盤となるパック。Banking and paymentsは、会話や設定など、すべてのパックが使用する共有クラスターを保持するInsuranceから継承します。新しいパックは独自のレンズを追加し、共有クラスターは継承元のパックに任せます |
screenCount |
パックが定義する画面の数 |
clusters[] |
パックの画面グループ。それぞれが、id、kind、name、対象となるseats、そのpurpose、用語の取得元となるlexiconセット、そのmenuおよびscreensを持ち、それぞれにid、title、who、およびその人たちがdoing内容があります |
clusters[].kind |
すべてのレンズが到達できるクラスター(たとえば会話など)の場合はshared、1つのロール専用の画面の場合はlens。クラスターのscopeは、それがコア(core)に属するか、業界(domain)に属するかを示します |
lexicon |
名前付きセットにまとめられたパックの用語。各用語には新任者でも読める平易な解説があり、3番目のスロットは規制上の数値など、一言一句そのまま使用しなければならない用語のためのexactです |
world |
パックの画面やテストが使用する架空のテナントとシートのサンプル環境、およびそのデータブランチ |
world.tenants[].plan |
プランのareas:ofのうち、このテナントのプランが開くクラスターとレンズ |
world.tenants[].ai |
パックに対する組織のAI(人工知能)ポリシー:オンデバイスモデルが許可されているか(onDevice)、個人データをクラウドモデルに送信できる場所(uk-onlyやeu-onlyなどのpersonalDataToCloudModels)、およびレコードの封印にUNOディスパッチが必要か(sealRequiresUno) |
world.seats[] |
1人のユーザーのシート:そのユーザーのtitle、保持するlens、同様に到達できる共有のclusters、home画面、posture(desk、field、またはconsumer)、および完全なファイル内では行動の範囲となる制限であるauthority |
pack.jsonに含めることができる内容には2つのルールがあります。規制は単なる頭字語ではなく、解説付きの平易な言葉で記述されます。また、ファイル内のいかなるものもコードではありません。これはサーバーとアプリが解釈する可読な定義であるため、ルールやプロンプトを保持することはなく、コンパイル済みブレインを保持することも決してありません。
共有レンズ
いくつかの制度は複数の業界にまたがっています。外部委託テクノロジーの登録簿はInsuranceとBanking and paymentsの両方で役立ちます。インシデントクロック(インシデント発生後に規制当局が求める報告までのカウントダウン)は、Critical infrastructure and energyとGovernment and public sectorの両方で役立ちます。複数のパックが使用する制度は、共有レンズとして一度だけ記述されます。それを必要とする各パックがそれを組み込みます。規則が変更された場合、変更は1か所で済みます。
レンズは絞り込みのみを行う
レンズとは、パックまたはプラットフォーム内で1つのロールに表示される内容、つまりどのカードとフィールド、どのアクションを表示するかを定義するものです。レンズは常に、ベースレンズを絞り込む形で定義されます。ベースを持つレンズは、そのベースが表示しない種類の対象物を表示せず、ベースが開かない領域を開かず、同じ種類を表示と非表示の両方にすることはできません。権限は引き続きロールから付与されます。レンズが変更するのは表示内容であり、人が行える操作を決して変更するものではありません。
レンズを広げようとすると、応答はLENS_CANNOT_WIDEN(422)となり、何も保存されません。請求金額を表示しない運行管理者ベースの上に構築されたリーファー技術者レンズの場合、レンズビルダーには「Claim amount cannot be added to this lens(請求金額はこのレンズに追加できません)」と表示されます。解決策は別のベースレンズを使用することであり、それはベースの所有者に対する別のリクエストとなります。
このルールはルートだけでなく、データベース内にも保持されます。各組織のレンズは、プラグインレジストリのスキーマ内の4つのテーブルに格納されます。
| テーブル | 保持する内容 |
|---|---|
plugins.lenses |
1つの所有者、つまりパック(owner_kind pack)またはプラットフォーム(platform)の1つのレンズ:そのslugとname、base_lens_id、showsおよびhidesする種類、opensする領域、そのstatus(activeまたはwithdrawn)、およびそのversion |
plugins.lens_grants |
1つの事業部門内の1つのロール(owner、admin、member、viewer、developer、またはbilling_admin)に付与されたレンズ |
plugins.lens_changes |
レンズまたはその付与に対するすべての変更。誰がなぜ行ったかとともに、変更前と変更後の状態として保持されます。追記専用 |
plugins.lens_holder_months |
毎月、部門内でレンズを保持していた人数。誰であるかではなく、数値のみ |
トリガーは、そのベースよりも多くのものを表示するレンズを拒否し、またベースの上に構築されたレンズがベースよりも多くのものを表示することになるようなベースへの変更を拒否します。何も削除されません。レンズと付与は取り下げられ、レンズを再度付与すると新しい行になります。変更が書き換えられることは決してなく、過去の月の数値が変更されることもありません。すべての行は複合キーを介して自身の組織のレンズを参照するため、付与が組織をまたいで指し示すことはありません。
コンソールおよび独自のツールは、ユーザー自身のベアラートークンを使用して、/api/v1/lensesを介してレジストリに到達します。組織とユーザー、および部門シートは、検証済みのトークンのみから取得され、他のいかなるものからも取得されません。
| メソッドとパス | 行うこと |
|---|---|
GET / |
owner_kind、owner_id、およびstatusでフィルタリングされたレンズと、自身のシートにおけるそれらの付与 |
POST / |
レンズの追加:owner_kind、owner_id、slug、name、shows、およびオプションでdescription、base_lens_id、hides、opens、reason |
GET /owners/:kind/:id |
パックまたはプラットフォームのレンズと、それらのうちどれが各種類を表示するか |
GET /owners/:kind/:id/grants |
部門別のレンズ:各レンズが付与されたロールと、それが到達するユーザー |
GET /owners/:kind/:id/holders |
毎月レンズを保持しているユーザー(months、デフォルトは6) |
POST /owners/:kind/:id/holders/count |
今月の数値を記録 |
GET /owners/:kind/:id/changes |
所有者のレンズの変更履歴(limit、デフォルトは50) |
GET /:lensId |
1つのレンズとそのベース、それを絞り込むレンズ、およびその付与と変更 |
PATCH /:lensId |
レンズの変更:name、description、shows、hides、opens、reason |
POST /:lensId/withdraw |
レンズと、それに伴う付与の取り下げ。別の有効なレンズが絞り込んでいるレンズは、そのレンズが取り下げられるまで取り下げることはできません |
POST /:lensId/grants |
レンズの付与:business_unit_id、role、reason |
POST /:lensId/grants/:grantId/withdraw |
1つの付与の取り下げ |
:kindはpackまたはplatformです。すべての拒否には説明文と次のステップを伴うコードが含まれ、予期しない障害は応答内ではなくサービスログに原因を記録してUNHANDLED_ERRORを返します。
ナレッジモデル、コネクター、およびコンパイル済みブレイン
ナレッジモデルとは、パックが認識する対象物の種類とそれらのつながり方です。これはバージョン管理されており、通常、パックは継承元のパックのベースモデルの上に構築されます。たとえば、物流のベースモデル上のコールドチェーンパックは、5つの種類(リーファーユニットや本船寄港など)を追加し、ベース自体を変更することなくそのうちの2つをベースにリンクします。各プロパティは作成時に分類されるため、どのレンズやデータブランチが使用するよりも前に、個人フィールドと商用フィールドが判別されます。そのため、技術者向けのレンズは、商用に分類された請求金額を表示することができません。取り下げられたプロパティは、それを含んでいたバージョンに残り、後のバージョンでのみ除外されます。新しいバージョンをステージングすると、まずナレッジがコピーされ、一定期間は元のバージョンに戻す経路が開かれたままになります。
コネクタは、保険契約管理システム、請求システム、パートナーが送信するファイルのメールフォルダなど、すでにレコードを保持しているシステムからレコードを取り込みます。それぞれが読み取り専用であり、独自のスケジュールで実行され、テストボタンを備えています。レコードは取り込まれる際にパックの用語にマッピングされ、レンズが読み取るナレッジモデルに格納されます。アシスタントの回答はこれを引用します。Nexusからソースシステムに書き戻されることは一切ありません。
コンパイル済みブレインとは、たとえばInsuranceパックの引受査定ブレインや請求ブレインなど、パック内で判断を行う部分です。これらはコンパイルされライセンス付与されたモジュールとしてサーバーで実行され、それぞれが自らライセンスを検証し、スマートフォンやブラウザに配信されることは決してありません。
モバイルオーバーレイとオフラインフィールド
パックは同じマニフェスト内で、スマートフォン画面をモバイルオーバーレイとして宣言します。これには、どのカードとキャプチャステップがどのロールのスマートフォンに表示されるかが含まれます。その後、管理者は、キャプチャがオフラインで待機できる時間、各写真に撮影場所を含めるかどうか、承認にパスキーが必要かどうかなど、スマートフォン上のルールを組織ごとに設定します。設定作業はコンピュータ上で行われ、管理者はスマートフォンが送信する内容を名前と件数として確認し、写真やメモ自体を見ることは決してありません。
電波のない状態でスマートフォン画面が提供するすべてのフィールドは、3つのクラスのいずれかを宣言し、画面にはそのクラスが表示されます。
| クラス | 処理内容 | 例 |
|---|---|---|
| オフラインで作成 | スマートフォンに保存され、再接続時にマージされます | メモ、写真、計測値 |
| オフラインで提案 | オフィスが決定する提案として送信されます。サーバーはこれをマージせず、独自の権限チェックを通じて再実行します | 金額、所見、支払備金の変更、決定 |
| オフライン不可 | 現場では実行できません。ボタンとしてではなく、理由を添えた行として描画されます | 署名、封印、権限チェック、制裁リストとの照合 |
オーバーレイはルールもプロンプトも保持せず、ブレインも保持しません。これらは可読な画面定義であり、判断を行うすべてのものはサーバーにとどまります。パックのスマートフォン画面は、Nexusスマートフォンアプリの内部でのみ開き、かつ組織がパックとMobile appsアドオンの両方を保持している場合にのみ開きます。
エンタイトルメント:パックの保有者と実行場所
パックはライセンス付与されるものであり、設定によってオンにされることは決してありません。誰にパックを表示するかは、3つのレイヤーによって決定されます。
ライセンス。署名付きライセンス文書には、機能グループのgrantsおよびadd_onsと並んで、マトリックスIDのdomain_packsリスト(最大100個、空の場合もあり)が含まれます。Adverantのコンソールは、必要なアドオンなしにパックを発行することはありません。たとえば、Decision rooms and sealed recordsを必要とするパックは、それがないライセンスには発行できません。ライセンス内の機能グループは、インストール全体または指定された組織のいずれかに付与され、エンタイトルメントチェックは組織ごとに応答します。付与を削除すると、パックのすべてのレンズとスマートフォン画面はティーザー表示になり、レコードはそのまま保持されます。
エンタイトルメントチェック。各組織とプラン、各ロールと各ユーザーに対して、エンタイトルメントチェックは、パックが追加するコントロールが利用権ありか、ティーザー表示か、非表示か、またはコード付きで拒否されるかを決定します。これにより、メニュー行とパネルタブ、およびルートとディスパッチのチェックが制御されます。クローズドモジュールは、自身の付与に対する権限を保持し続けます。
部門とレンズ。パックを持つ組織内では、管理者がそれを実行する場所を決定します。部門に対するパックの有効化は段階的に行われ、部門全体に対して一度にオンにされることは決してありません。ライセンスチェック、パイロットグループ、設定プリセットを経て、管理者が選択した日に部門内の全員へと広げられます。何かが変更される前に、ページには誰が何を得るかがロール別に表示されます。その後、1つのマトリックス内で、ロールごとおよび部門ごとにレンズが付与されます。後になって部門のパックをオフにしても、人々が作成したすべてのレコードは保持されます。レンズとテンプレートは消えますが、他のものは何も変わりません。
10個のパック
Adverantは10個のドメインパックを提供しています。それぞれにEnterpriseベースライセンスが必要であり、いくつかにはアドオンが必要です。また、すべてのパックのスマートフォン画面にはMobile appsアドオンが必要です。
| パック | マトリックスID | 提供される機能 | 追加の要件 |
|---|---|---|---|
| 保険 | insurance |
引受査定、請求、再保険、Lloyd's、および委任権限などのための保険レンズ、不正および調査フロー、保険ストアフロントのジャーニーと設定、保険コンパイル済みブレイン | 決定ルームと封印された記録 |
| 銀行および決済 | financial-services |
外部委託テクノロジーの登録簿、テクノロジーインシデントのクロックと報告、重要プロバイダーの撤退計画、融資決定、カード紛争 | ベース以外の要件なし |
| 資本市場および資産運用 | capital-markets |
リサーチアナリスト、ポートフォリオマネージャー、サーベイランスとコンプライアンス、およびクライアントレポーティングのためのレンズ、トレーディングデスクでの通話録音、リリースまでウォールの背後に保持されるリサーチ、ウォールクロッシングログ、通話レビュー、およびリサーチリリースのためのテンプレート。スマートフォンでは朝のブリーフィングとリリース承認、およびサーベイランスアラートを受信しますが、注文は決して扱いません | 決定ルームと封印された記録 |
| 政府および公共部門 | government |
給付および受給資格の請求、都市計画申請、情報公開請求 | ベース以外の要件なし |
| ヘルスケア | healthcare-providers |
患者記録へのアクセスと共有、および情報公開請求。臨床意思決定支援は含まれません | ベース以外の要件なし |
| ライフサイエンス | life-sciences |
逸脱と是正措置、バッチ記録レビュー、バリデートされた変更管理 | ベース以外の要件なし |
| 重要インフラおよびエネルギー | energy-and-utilities |
インシデントクロックと報告、検査と欠陥、作業指示書 | ベース以外の要件なし |
| 防衛および安全保障 | defence-and-mission |
プラットフォームアラートと融合された現場報告、共有マーキング、デブリーフィング。そのスマートフォンビルドはデバイス管理を通じてのみインストールされます | プラットフォームアラート用のNexus Edge |
| 法務および専門サービス | legal |
フィーアーナー、ナレッジロイヤー、利益相反とリスク、および請求のためのレンズ、すべての新規案件における利益相反チェック、2名のパートナーによってのみ解除されるエシカルウォール、新規案件チェック、ウォールビルダー、およびウォールリマインダーのためのテンプレート。スマートフォンでは時間記録と承認付きの案件更新を行えますが、秘匿特権ファイルは決して扱いません | 決定ルームと封印された記録、およびMail |
| 物流および海事 | logistics-and-maritime |
運行管理者、通関士、キャリアマネージャー、および港湾検査官のためのレンズ、通関申告と保留、初回予約前の制裁チェック(すべての保留は人が解除)、港湾と船舶、キャリアと保留のナレッジモデル。スマートフォンではドローンの所見を伴うヤードとバースの検査、および税関保留を扱います | マップとGeoAI |
Harrow Port AuthorityはLogistics and maritimeパックを実行しており、独自のパックを構築しようとしているなら、まずこれを読むことをお勧めします。そのナレッジモデルは、上記のコールドチェーンの例が基盤としているベースだからです。
独自パックの構築
Enterpriseでは、開発者は「Start something new」のゴールデンパスから3つのステップでパックを開始します。「About it」では、パックの名前、部門、基盤とするパック、および証跡を示す必要がある規則を指定します。「Knowledge model」では、ベースモデルの上に新しい種類の対象物を追加します。「Review and create」では、計画を表示してそれに従います。これにより、パックが到達できる範囲を宣言するマニフェストとそのテストを備えたリポジトリがパックテンプレートから作成され、次に合成データブランチを備えた開発スペース、最後に自分だけが見ることができるドラフトカタログエントリが作成されます。最後のステップで「Create」を押すまでは何も作成されません。第2.24章「Building a custom vertical end to end」では、このパス全体を詳しく説明しています。
パックのコスト
パックは、所有するのに最もコストがかかる拡張機能です。そのナレッジモデルには人々が依存するバージョンがあるため、後悔するようなプロパティであっても、それを出荷したバージョンに残り続けます。そのレンズは要素を削ることしかできないため、より多くの表示を必要とするロールがあれば、ベースレンズについての話し合いが必要になります。その証跡マップは、誰かがそれに依拠する前に自社の法務顧問が確認しなければならない規則を指定します。そして、顧客は自身のライセンスを通じてのみそれを手に入れます。業界最高のパックを構築できたとしても、組織のライセンスにそれが含まれるまでは、たった1つの部門でさえそれをオンにすることはできません。その見返りとして、それを求める30番目の部門にかかるコストは、1回のスイッチ切り替えとパイロット運用だけで済みます。




