https://rindrics.com/ Rindrics Mumbles Hugo -- gohugo.io en Fri, 04 Sep 2026 00:00:00 +0900 https://rindrics.com/books/domain-model-made-functional/introducing-ddd/ Wed, 13 Nov 2024 00:00:00 +0900 https://rindrics.com/books/domain-model-made-functional/introducing-ddd/ <p>&ldquo;1. Introducing Domain-Driven Design&rdquo; from &ldquo;<a href="https://rindrics.com/books/domain-model-made-functional/">Domain Modeling Made Functional: Tackle Software Complexity with Domain-Driven Design and F#</a>&rdquo; &#x1f4da;</p> <p>ソフトウェア開発者の仕事とは:</p> <ul> <li>not only コードを書くこと</li> <li>but also <strong>ソフトウェアを通して問題を解決すること</strong></li> </ul> <p>要件が不明瞭だったり、設計が悪ければコーディングをどれだけ頑張ろうとよい価値は得られない</p> <ul> <li>つまり garbage in, garbage out <ul> <li>&#x1f4dd; この表現はソフトウェア自体への入力と出力に対して使われることが多いが、ここでは input が「要件」、output を「得られる価値」というかなり高レイヤな意味で使われている</li> </ul> </li> </ul> <p>&ldquo;garbage in&rdquo; を減らすのに必要なもの:</p> <ul> <li>明解なコミュニケーション</li> <li>共有ドメイン知識に基づく設計アプローチ</li> </ul> <p>ドメイン駆動設計（DDD）をによってこれらを実現できる。</p> <h1 id="共有モデルの重要性">共有モデルの重要性</h1> <p>まず開発者が問題を正しく理解することが重要</p> <p>とりうるアプローチを 3 つ紹介:</p> <ol> <li>仕様書・要件定義書を整備する &#x1f4a3;</li> <li>ドメインエキスパートを開発プロセスに入れる &#x26a0;&#xfe0f;</li> <li>ドメイン駆動設計 &#x2705;</li> </ol> <h2 id="1-仕様書要件定義書を整備する-bomb">1. 仕様書・要件定義書を整備する &#x1f4a3;</h2> <p>これはだめなやり方。</p> <p>理由:</p> <ul> <li>ドメインエキスパートと開発チームの距離が遠くなってしまう &#x274c;</li> <li>&ldquo;伝言ゲーム&rdquo; のようなことが実際に起こり、これはプロジェクトにおいては致命的 &#x274c;</li> </ul> <h2 id="2-ドメインエキスパートを開発プロセスに組み込む-warning">2. ドメインエキスパートを開発プロセスに組み込む &#x26a0;&#xfe0f;</h2> <p>いわゆるアジャイルなやり方。一見良さそうに思えるがベストではない。</p> <p>誤りをすぐに修正できるようにするために、ドメインエキスパートを開発プロセスのフィードバックループに組み入れる。</p> <p>デメリット:</p> <ul> <li>開発者の働きがドメインエキスパートのメンタルモデルの単なる翻訳者でしかなくなってしまう &#x274c;</li> <li>必ず抜け落ちてしまう情報がある &#x274c;</li> <li>将来、ドメインエキスパートからの入力なしにコードをメンテする開発者は容易に方針を誤ってしまう &#x274c;</li> </ul> <h2 id="3-ドメイン駆動設計-white_check_mark">3. ドメイン駆動設計 &#x2705;</h2> <p>プロジェクトに関わる人々（下記）が<strong>共通のメンタルモデル</strong>を共有した状態で開発を進める:</p> <ul> <li>ドメインエキスパート</li> <li>開発者</li> <li>ステークホルダー</li> </ul> <p>ソフトウェアのコードはメンタルモデルを直接反映したものになるので、DDD では &ldquo;翻訳&rdquo; という作業は存在し得ない。</p> <p>メリット:</p> <ul> <li>市場投入スピード &#x2705;</li> <li>得られるビジネス価値の大きさ &#x2705;</li> <li>無駄の排除 &#x2705;</li> <li>スムーズなメンテナンス &#x2705;</li> </ul> <p>（コラムでは、開発者自身がドメインエキスパートになる重要性が示されている）</p> <p>共有メンタルモデルを作るためのガイドライン:</p> <ul> <li>データ構造ではなく、ビジネスイベントとワークフローに着目せよ</li> <li>ドメインを小さいサブドメインに分割せよ</li> <li>それぞれのサブドメインについてモデルを作れ</li> <li>会話やコードで使われる共通言語を作れ</li> </ul> <h1 id="ビジネスイベントからドメインを理解する">ビジネスイベントからドメインを理解する</h1> <p>共有メンタルモデルの構築はどこから始めたらいい？ → イベントから始めよ &#x2705;データ構造から始めるな &#x274c;</p> <p>理由:</p> <ul> <li>ビジネスがデータを<strong>ただ持っているだけ</strong>で終わることは有り得ないため</li> <li>ビジネスは何らかの方法でデータを<strong>変換</strong>するため</li> </ul> <p>ビジネスプロセスとは、データやドキュメントの変換処理の集まり → これらの変換がどう行われ、どう関連しているかを理解することが重要</p> <p>使われずにただ置かれているだけのデータは何の価値も生まない。 これらのデータから価値を引き出すためのプロセスはどうやって始まるか？ → <strong>ドメインイベント</strong>によって始まる</p> <p>ドメインイベントの例:</p> <ul> <li>外部トリガー</li> <li>スケジュールに基づいたトリガー</li> <li>観測に基づくトリガー</li> </ul> <p>ドメインイベントは事実である変化しないため必ず過去形で表現される。</p> <hr> <p>（中略）</p> <p>下記の 2 節で、イベントストーミングの説明と実例が書いてある:</p> <ul> <li>Using Event Storming to Discover the Domain</li> <li>Discovering the Domain: An Order-Taking System</li> </ul> <p>イベントストーミング自体を理解するには<a href="https://leanpub.com/introducing_eventstorming">提唱者の解説</a>を読むほうがいい。</p> <p>イベントストーミングで重要な点:</p> <ul> <li>「&ldquo;我々&rdquo; vs &ldquo;彼ら&rdquo; 思考」から脱却できること</li> <li>意見が合わなかったら、それは問題ではなくチャンス</li> </ul> <hr> <h2 id="イベントを境界にまで拡張する">イベントを境界にまで拡張する</h2> <p>要件の取りこぼしを防ぐために下記に注意を払う:</p> <ul> <li>最初のイベントと思っていたイベントをトリガーする他のイベントがないか</li> <li>最後のイベントと思っていたイベントにトリガーされる後続のイベントはないか</li> </ul> <p>全てを一気に変える必要はない。最も価値を生む一部分から取りかかれ。</p> <h2 id="コマンドを記述する">コマンドを記述する</h2> <p>イベントストーミングによってイベントが見えるようになった。 それらのイベントはどのように発生するのか？ → そのイベントが起こることを誰かが要求したから</p> <ul> <li>全てのイベントがコマンドに紐付いている必要はない。スケジュールによるトリガーや監視に基づくトリガーなどがあるため。</li> </ul> <p>DDD ではこれらの要求を「コマンド」という。 コマンドは常に命令形で表現される。 紛らわしいが、<a href="https://ja.wikipedia.org/wiki/Command_%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3">OO のコマンドパターン</a>とは違う。</p> <p>コマンドが成功するとワークフローがトリガーされ、ドメインイベントが作られる。</p> <p>例:</p> <ul> <li>「X を起こせ」というコマンドによってワークフローが X を起こし、「X が起こった」というドメインイベントが発行される</li> <li>「注文書を会社 A に送れ」というコマンドによってワークフローが注文書を送ると、「注文書が送信された」というドメインインベントが発行される</li> <li>コマンド「注文を確定せよ」 → ドメインイベント「注文が確定された」</li> <li>コマンド「配送を顧客 B に送れ」 → 「配送が送られた」</li> </ul> <p>&#x1f4dd; 「配送が送られた」は日本語としておかしいが、DDD ではモデルを記述する用語（ユビキタス言語）が重要なのでこのままにしておく。原著が英語なので限界がある。自然な日本語にしようとして「配送」の代わりに「商品」とするのは絶対に NG。いずれにせよ、ドメインエキスパートが使う言葉に合わせることが重要。</p> <p>これから、コマンド、ワークフロー、イベントの組み合わせでビジネスプロセスを記述していく。 これはまさに関数プログラミングの動きと同じ。</p> <h1 id="ドメインをサブドメインに分ける">ドメインをサブドメインに分ける</h1> <p>イベントストーミングによってイベントとコマンドを洗い出したことで、多数のビジネスプロセスの中身を理解できた状態になった。 しかし全体像がまだ整理されていない。 コードを書き始める<strong>前に</strong>整理する必要がある。</p> <p>本文中では、受注プロセスを例として分割の様子が示されている。</p> <p>受注プロセスとは:</p> <ul> <li>受注</li> <li>配送</li> <li>請求</li> <li>その他</li> </ul> <p>部署が既に分かれていれば、サブドメイン分割の強力な手がかりとなる。</p> <p>ドメインとは？ → DDD において、一貫した知識領域のこと。 &hellip;わかりにくい。 言い換えると、ドメインエキスパートが専門性を持っている領域。 この理解はかなり実用的。なぜなら辞書で「請求」を調べて頭を悩ませるのではなく、シンプルに「請求部門のドメインエキスパートがやっていること」と表現できるようになるため。</p> <p>ドメインは重複しうるため、分割する際には注意が必要。 はっきり分けたくなるが、現実世界はそれほど単純ではない。</p> <p>ドメインは少し重複しているので、例えば受注部門の担当者は請求部門や配送部門の業務を少しだけ知っている必要がある。</p> <h1 id="境界づけられたコンテキストを使って解決策を作る">境界づけられたコンテキストを使って解決策を作る</h1> <p>ドメインの情報全てを反映する必要はない。 得られた情報の中から、解こうとしている問題に関するもののみを抽出する。ほとんどは無関係なはず</p> <p>なので「問題領域」と「解決領域」を分け、両者を別物として扱う必要がある:</p> <ul> <li>問題領域は現実世界</li> <li>解決領域はドメインモデル</li> </ul> <p>問題領域は設計プロセスを経て解決領域になる</p> <p>なぜ「サブシステム」でなく「境界づけられたコンテキスト」という表現なのか？</p> <ul> <li>理由: 解決策を考える際に、本当に重要なものに集中できるようになるため</li> </ul> <p>コンテキストと境界を常に意識せよ。</p> <ul> <li> <p>コンテキストが重要な理由: それぞれのコンテキストは解決策に独自の知識を反映するから コンテキスト内では言語は共通し、デザインも一貫しているが、これらはコンテキストの外では使えなくなる</p> </li> <li> <p>境界が重要な理由: 現実世界では境界はぼやけているが、ソフトウェアの場合にはそれぞれを独立して開発できるようにするために分割したい。ソフトウェアでは API を使うなどして達成できるが、裏を返せばそのように作ったドメインモデルは現実世界に比べて情報量が減るということ。しかしこれは複雑さを減らし、メンテナンス性を手に入れるためのトレードオフ</p> </li> </ul> <p>問題領域のドメインは必ずしも解決領域のコンテキストと一対一対応しない:</p> <ul> <li>あるドメインが複数の境界づけられたコンテキストに分割されることもある</li> <li>複数のドメインが一つの境界づけられたコンテキストになるケースもある（レガシーソフトウェア） <ul> <li>例: ある企業が「受注」と「請求」をひとまとめに扱うシステムを既にインストールしていた場合、このレガシーシステムと連携するにはそれを一つの境界づけられたコンテキストとして扱う必要がある</li> </ul> </li> </ul> <p>ドメインを分けるなら、それぞれの境界づけられたコンテキストが明確な責務を持つ必要がある</p> <ul> <li>理由: モデルを実装するとき、境界づけられたコンテキストはそのままソフトウェアコンポーネント（DLL、サービス、名前空間など）になるため</li> </ul> <h2 id="コンテキストを正しくする">コンテキストを正しくする</h2> <p>聞くは易し、実行するは難し。 というか DDD で1番難しいのがこの境界を正しく定めることで、これは科学ではなく一種の芸術といえる。</p> <p>ガイドライン:</p> <ul> <li>【ドメインエキスパートの声を聞け】彼らが共通言語を話し、同じ問題に注目しているならばおそらく同じサブドメインにいる。それが境界づけられたコンテキストになる</li> <li>【既存チームや部署の境界に着目せよ】ビジネスが何をドメイン・サブドメインと認識しているかの強力な手がかり。必ずしも一致はしない（部署内で違うことしてたり、他部署とコラボしたり）</li> <li>【境界づけられたコンテキストの「境界」に着目せよ】スコープクリープに気をつけろ。要求が変化する複雑なプロジェクトでは、無慈悲なまでに境界を守る必要がある。大きすぎる境界は何もないのと同じ。よいフェンスはよい隣人を作る</li> <li>【自律可能性が生まれるように設計せよ】足を結ばれた 2 人のランナーは独立した 2 人のランナーよりも速くなることはない。それぞれの境界づけられたコンテキストを独立して開発できるようにしろ</li> <li>【ビジネスフローの摩擦の摩擦を最小化するように設計せよ】複数の境界づけられたコンテキストと関わるビジネスワークフローがそれらによって遅くなっているなら、デザインを損ねてでもワークフローをスムーズにしろ。純粋なデザインよりもビジネスと顧客が重要</li> </ul> <p>変わらない設計などない。いかなるモデルも、ビジネス要件が変わるたびに進化する必要がある。これは受注システムに要件を追加する例として 13 章で話す。</p> <h2 id="コンテキストマップをつくる">コンテキストマップをつくる</h2> <p><strong>コンテキストマップ</strong>とは:</p> <ul> <li>境界づけられたコンテキスト間の関係を示した全体像。これによって、コンテキスト同士の関係性について技術的詳細に囚われずにコミュニケーションできるようになる</li> <li>コンテキストマップは高次に保つ。複雑なシステムにおいては、それぞれのコンテキストの詳細にフォーカスした個別のマップが必要になる</li> </ul> <p>&#x1f4dd; 境界づけられたコンテキスト同士が連携するならば、当然それらのコンテキストは、交換可能な共有メッセージのフォーマットについて合意している必要がある。</p> <ul> <li>フォーマットの決定については主に上流側のコンテキストが主導権を持つ <ul> <li>例外: 【レガシーシステムが下流側にある場合など】上流側のコンテキストが、下流側のコンテキストが要求するフォーマットに合わせないといけない。その場合には翻訳コンポーネントが必要</li> </ul> </li> </ul> <h2 id="最も重要な境界づけられたコンテキストに着目せよ">最も重要な境界づけられたコンテキストに着目せよ</h2> <p>ここまでで、いくつか境界づけられたコンテキストを見つけた。 ドメインでの作業をすすめる過程でも、追加で見つかるだろう。 それらは等しく重要だろうか？</p> <p>どこから着手すべきだろう？ → <strong>需要なところから</strong></p> <ul> <li>全ての境界づけられたコンテキストを同時に実装したりするのは NG &#x274c;</li> <li>優先順位を付ける必要がある。何が重要かについて、コンセンサスがないこともあるが（各部署は自分こそが最重要だと思っている）</li> </ul> <p>重要とは: <strong>ビジネス優位性</strong>を生むドメインや<strong>売上げ</strong>を生むドメイン</p> <p>ドメインの大分類:</p> <ul> <li>コアドメイン: ビジネスの根幹となるもの</li> <li>補助ドメイン: 業務に必要であるもののビジネスの核ではないもの</li> <li>汎用ドメイン: 他のビジネスでも見られるもの（認証や配送など）。これは安全にアウトソースできる</li> </ul> <p>&#x1f4dd; 補助ドメインに見えるものがコアドメインになりうる例: 物販ビジネスにおいて、どの商品も常に出荷可能な状態が保たれていることが顧客満足に決定的に重要な場合、在庫管理ドメインはコアドメインになりうる。</p> <h1 id="ユビキタス言語をつくる">ユビキタス言語をつくる</h1> <p>コードとドメインエキスパートは同じモデルを共有しなければならない</p> <ul> <li>ドメインエキスパートが「注文」と言ったならば、コードでもそれに対応し、同じように振る舞う「注文」というものを定義する &#x2705;</li> <li>逆に、ドメインエキスパートのメンタルモデルにないもの（注文ファクトリ、注文マネージャ、注文ヘルパーなど）は設計に含めてはならない &#x274c; <ul> <li>ドメインエキスパートはそれらの意味を理解できないので害にしかならない。もちろんそれらの技術的概念はコードベースの方には出てくるだろうが、それらを<strong>設計</strong>に入れてはいけない</li> </ul> </li> </ul> <p><strong>ユビキタス言語</strong>で設計せよ</p> <p>ユビキタス言語とは: プロジェクトの関係者全員に共有される概念や用語のまとまり。これがビジネスドメインの共通メンタルモデルを定義する。プロジェクトのあらゆる場所で一貫して使われるべき。あらゆる場所とは、コードも含む。</p> <p>（確か、ドメインモデルを正確に反映するためにコード中のユビキタス言語も日本語で書いている日本のチームの事例があった。言語は Ruby だったと思う）</p> <p>ユビキタス言語の構築プロセス: 常に WIP。設計とともに進化する</p> <ul> <li>not ドメインエキスパート起点の一方通行 &#x274c;</li> <li>but プロジェクトみんなによるコラボレーション &#x2705;</li> </ul> <p>&#x26a0;&#xfe0f; ドメインの「方言」に注意</p> <ul> <li>ある用語が意味する概念が、ドメインによって微妙に異なる場合がある。イベントストーミング時には特にこれに気をつける必要がある <ul> <li>例: 配送部門が言う「注文」は請求部門が言うそれとは微妙に違う。配送部門の関心は在庫つまり数にあるが、請求部門の関心は価格と支払いにある。もし「注文」をコンテキストの明示なしにさまざまな場所で使ってしまうと誤解が生じてしまう</li> </ul> </li> </ul> <p>→ 全てのドメインとコンテキストをカバーするユビキタス言語を作るのは無理</p> <h1 id="ドメイン駆動設計の概念をまとめる">ドメイン駆動設計の概念をまとめる</h1> <ul> <li>【ドメイン】 解こうとする問題に関係する知識領域。ドメインエキスパートが専門とする</li> <li>【ドメインモデル】 特定の問題に関わるドメインの側面を単純化したものの集合。ドメインモデルは解決領域の一部で、ドメインは問題領域。</li> <li>【ユビキタス言語】 ドメインと関連し、チームメンバーとソースコードに共有される概念や語彙の集合</li> <li>【境界づけられたコンテキスト】 明解な境界によって他と区別される、解決領域の子要素。</li> <li>【コンテキストマップ】 境界づけられたコンテキスト間の関係を示した高次の概念図</li> <li>【ドメインイベント】 システム内で起こった事実の記録。必ず過去形で記述され、何らかのコマンド（原文では &ldquo;activity&rdquo; と書いてある）をトリガーすることが多い</li> <li>【コマンド】 何らかのプロセスへの開始要求。人やイベントによってトリガーされる。プロセスが成功するとシステムが変化し、一つ以上のドメインイベントとが記録される</li> </ul> <h1 id="まとめ">まとめ</h1> <h2 id="イベントとプロセス">イベントとプロセス</h2> <p>イベントストーミングによって、ドメイン内の全ての主要なドメインイベントが見えるようになった。 受注プロセスは注文書を郵便で受け取るところから始まり、見積書の作成、新規顧客の登録などのワークフローがあることもわかった。</p> <p>受注チームが注文を処理し終わると、そのイベントが配送部門の配送プロセスをスタートさせ、請求部門の請求プロセスをスタートさせることも学んだ</p> <p>他にもプロセスはたくさんあるが、本書では一つに着目する。</p> <h2 id="サブドメインと境界づけられたコンテキスト">サブドメインと境界づけられたコンテキスト</h2> <p>ここまでで、3 つのサブドメインが見つかった（受注、配送、請求）。 これらに対応する 3 つの境界づけられたコンテキストを作り、それぞれの関係を示したコンテキストマップをつくった。</p> <p>どれが注目すべきコアドメインだろう？ <strong>どこを自動化すると価値が最大化されるか</strong>？ → 現時点では受注ドメインからとりかかることにしておく</p> <p>必要ならば、受注ドメインの仕事を紙に出力することで、他のチームが今まで通りの方法で仕事を続けることもできる。</p> <h2 id="ユビキタス言語">ユビキタス言語</h2> <p>ここまでで、「注文フォーム」「見積もり」「注文」という言葉を見つけた。 設計を深める過程でもっと見つかるだろう。 ユビキタス言語は、wiki などのライブなドキュメント（印刷した書類は固定化されてしまうが、wiki は更新が前提）でメンテナンスするといい。 チームメンバーの足並みが揃うし、新しいメンバーもキャッチアップしやすい。</p> <h2 id="次にやることは">次にやることは？</h2> <p>本章によって</p> <ul> <li>問題の全体像と、解決策の概略が見えた &#x1f4a1;</li> <li>しかし詳細設計やコーディングを始めるにはまだ多くの疑問がある &#x1f4ad; <ul> <li>&#x2753; 注文処理ワークフローでは何が行われているのだろう？</li> <li>&#x2753; 入出力はどんな感じ？</li> <li>&#x2753; このワークフローが連携する他のコンテキストはある？</li> <li>&#x2753; 配送チームの「注文」と請求チームのそれはどう違う？</li> <li>などなど</li> </ul> </li> </ul> <p>次の章では注文確定ワークフローに着目して、これらの問いに答えていく</p> https://rindrics.com/books/domain-model-made-functional/understanding-the-domain/ Sun, 17 Nov 2024 00:00:00 +0900 https://rindrics.com/books/domain-model-made-functional/understanding-the-domain/ <p>&ldquo;2. Understanding the Domain&rdquo; from &ldquo;<a href="https://rindrics.com/books/domain-model-made-functional/">Domain Modeling Made Functional: Tackle Software Complexity with Domain-Driven Design and F#</a>&rdquo; &#x1f4da;</p> <p>一つのワークフローに着目して掘り下げていく</p> <ul> <li>何がそれをトリガーするのか？</li> <li>どんなデータが必要？</li> <li>どんな境界づけられたコンテキストと協働する必要がある？</li> </ul> <p>ここでは注意深く耳を傾ける能力が重要。 自分のメンタルモデルをドメインに押し付けないようにしたい。</p> <h1 id="ドメインエキスパートへの聞き取り">ドメインエキスパートへの聞き取り</h1> <p>ドメインエキスパート（文中では受注部門のメンバー）に聞き取り調査をしていく。</p> <p>ポイント:</p> <ul> <li>イベントストーミングで洗い出したコマンド・イベントを手がかりに、聞き取り調査をいくつかの小さい単位に分ける &#x2705; <ul> <li>忙しいドメインエキスパートに時間をとってもらいやすい</li> </ul> </li> <li>インタビューの初期は高次の視点を維持し、ワークフローの入出力だけに着目する &#x2705; <ul> <li>詳細に囚われすぎずに済む</li> </ul> </li> <li>顧客がシステムをどう使うかの結論を急がず、人類学者のようにとにかく耳を傾ける &#x2705; <ul> <li>文中では「顧客が注文フォームをオンラインで入力してくれたらいいのに」というドメインエキスパートの言葉に対して、開発者は一般的なカート &amp; チェックアウトパターンのシステムを想像しかけた <ul> <li>しかしドメインエキスパートが求めるのはそのパターンではなかった &#x1f4a3;</li> </ul> </li> </ul> </li> <li>理想的には、設計の前にドメインエキスパートが働く様子を観察したりするとよい &#x2705;</li> </ul> <h2 id="非機能要件を理解する">非機能要件を理解する</h2> <p>一歩下がって、ワークフローのスケールとコンテキストについて議論する。</p> <p>文中では、後のアーキテクチャ決定に関わる下記の要件についてドメインエキスパートに尋ねている:</p> <ul> <li>1 日あたりのリクエスト数</li> <li>リクエスト数の年間変動</li> <li>ユーザーの属性（ビギナー or プロフェッショナル）</li> <li>サービスに期待されているレスポンス</li> </ul> <h2 id="ワークフローの残りを理解する">ワークフローの残りを理解する</h2> <p>ドメインエキスパートへの聞き取りによってドメインの知識を獲得していく。</p> <p>文中では「受け取ったそれぞれの注文フォームで何をするのか？」という質問から始めて、下記のドメイン知識を発見した:</p> <ul> <li>検証作業</li> <li>協調すべき境界づけられたコンテキスト</li> <li>集計作業</li> <li>注文確認の返信作業</li> <li>同じ入力を利用する別のワークフロー（見積もり作業）</li> </ul> <h2 id="入出力について考える">入出力について考える</h2> <p>ワークフローの入出力について、聞き取りから学んだことを書き留める</p> <ul> <li>入力: 明らかに注文フォーム &#x2705;</li> <li>出力: <ul> <li>「処理済みの注文」という概念があることはわかった。しかしそれ自体は特に出力として使い道がない &#x274c;</li> <li>注文確認はどうか？これは注文確定ワークフローの副作用であり、出力ではない &#x274c;</li> <li>出力は常に生成イベントであるべき &#x2705; <ul> <li>他の境界づけられたコンテキストのアクションをトリガーするもの</li> <li>ここでは<code>注文が確定された</code>イベント</li> </ul> </li> </ul> </li> </ul> <h1 id="データベース駆動設計したくなる衝動と戦う-warning">データベース駆動設計したくなる衝動と戦う &#x26a0;&#xfe0f;</h1> <p>&#x1f4dd; この節は目からウロコだった・・・！ この節を読むべきなのは初学者よりむしろ、ビジネス要件から DB スキーマを設計することに慣れている人だと思う。</p> <p>ある程度経験を積んだプログラマなら、もう詳細設計して実装に入りたくなるだろう。 テーブル間の関連について、下記のように設計を始めるかもしれない:</p> <pre class="mermaid">erDiagram Customers ||--o{ Orders : places Customers { string name string custNumber string sector } Orders ||--|{ OrderLines : contains Orders { string customerId string shippnigAddressId string billingAddressId bool isQuote } OrderLines { string orderId string productId float quantity } Addresses ||--|{ Orders : referred </pre> <p>・・・しかしこれをやってしまったらオシマイ &#x1f4a3;（マジか）</p> <p>DDD ではドメインを正確にモデリングすることに集中するために「永続性の無視」というアプローチで設計する:</p> <ul> <li>ドメインに設計を駆動させる &#x2705;</li> <li>DB スキーマではない &#x274c; <ul> <li>実際、現実の紙ベースのシステムではデータベースなど存在しない</li> <li><code>データベース</code>はユビキタス言語には入らない <ul> <li>ユーザーはデータがどう永続化されているかには興味がない</li> </ul> </li> </ul> </li> </ul> <p>なぜこれが重要？ → データベースの視点からデザインすると、<strong>データベースモデルに合うようにデータを歪めないといけなくなる</strong>から</p> <p>例:</p> <ul> <li>既に先ほどの ER 図では<code>注文</code>と<code>見積り</code>の違いを無視してしまっている &#x1f4a3; <ul> <li>同じ外部キー（<code>orderId</code> は <code>quoteId</code> としても使われる）が二つのリレーションで責務を持つ状況は、データベースの機能ではサポートできない &#x1f4a3;（なるほど・・・！！）</li> </ul> </li> </ul> <p>とにかく、技術的な先入観なしにドメインエキスパートの言葉に耳を傾けることに集中するのが重要。 ドメイン駆動で設計したモデルを関係データベースに永続化する方法は第 12 章で見ていく。</p> <h1 id="クラス駆動デザインへの衝動と戦う-warning">クラス駆動デザインへの衝動と戦う &#x26a0;&#xfe0f;</h1> <p>&#x1f4dd; 本節のおかげで、私は<a href="https://github.com/Rindrics/success-notification-aggregator/blob/08c3a71da7cf27b0126798617cc285c1d7214b54/README.md#architecture-overview">個人開発でこの過ちを犯していた</a>ことを自覚した</p> <p>オブジェクト指向の経験があるなら、特定の DB 実装に縛られないことの重要性は理解していることだろう。 しかし、ドメインではなくオブジェクトの観点で考えることによって、モデルに偏見を持ち込んでしまう（マジか）。</p> <p>クラス駆動デザインも、要求をちゃんと聞いていないという点でデータベース駆動デザインと同じくらい危険 &#x1f4a3;</p> <p>こんなふうに設計するかもしれないが</p> <pre class="mermaid">classDiagram OrderBase <|-- Order OrderBase <|-- Quote OrderBase "n" -- "1" Customer Order "n" -- "1" Address : shipping address Order "n" -- "1" Address : billing address OrderBase "1" *-- "n" OrderLine OrderLine "1" -- "n" Product </pre> <p><code>注文</code>と<code>見積り</code>の違いは表現できているできているものの、<strong>現実世界に存在しない<code>OrderBase</code>という人工的なクラスを持ち込み、ドメインを歪めてしまった</strong> &#x1f4a3; （まぁ「ドメインモデルと詳細設計は区別しましょう」で片付く話ではあるか）</p> <p>心をオープンに保て。 技術的な思考をドメインに持ち込むな。</p> <h1 id="ドメインを文書化する">ドメインを文書化する</h1> <p>技術的な実装による偏見に陥らず、要求をどのように記述すべきだろう？ UML のような可視化ダイアグラムを使うこともできるが、労力がかかる割にドメインの機微をとらえられるほどの表現力がない。</p> <p>正確なドメインモデルをコードで表現する方法は後ほど学ぶとして、今は、ドメインモデルを捉えられる簡単なテキストベース言語を使う:</p> <ul> <li>ワークフローの表現法: 入出力を記述し、ビジネスロジックを記述するシンプルな疑似コードを使う</li> <li>データ構造の表現法 <ul> <li>二つの部分が共に必要なときには <code>かつ</code>を使う</li> <li>どちらかだけでいい時には<code>または</code>を使う</li> </ul> </li> </ul> <p>このミニ言語を使って、注文確定ワークフローを記述すると下記のようになる:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>境界づけられたコンテキスト: 受注 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>ワークフロー: 注文確定 </span></span><span style="display:flex;"><span> トリガー: &#34;注文フォームを受け取った&#34; イベント（&#34;見積もり&#34; にチェックが入っていたとき） </span></span><span style="display:flex;"><span>初期入力: </span></span><span style="display:flex;"><span> 注文フォーム </span></span><span style="display:flex;"><span>その他の入力: </span></span><span style="display:flex;"><span> 商品カタログ </span></span><span style="display:flex;"><span>出力イベント: </span></span><span style="display:flex;"><span> &#34;注文が確定した&#34; イベント </span></span><span style="display:flex;"><span>副作用: </span></span><span style="display:flex;"><span> 注文確定に伴って注文確認が顧客に送信された </span></span></code></pre></div><p>データ構造は下記のように表現される:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>境界づけられたコンテキスト: 受注 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>注文 データ = </span></span><span style="display:flex;"><span> 顧客情報 </span></span><span style="display:flex;"><span> かつ 配送先住所 </span></span><span style="display:flex;"><span> かつ 請求先住所 </span></span><span style="display:flex;"><span> かつ 注文明細 のリスト </span></span><span style="display:flex;"><span> かつ 請求金額 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>注文明細 データ = </span></span><span style="display:flex;"><span> 商品 </span></span><span style="display:flex;"><span> かつ 数量 </span></span><span style="display:flex;"><span> かつ 価格 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>顧客情報 データ = ??? // まだ不明 </span></span><span style="display:flex;"><span>請求先住所 データ = ??? // まだ不明 </span></span></code></pre></div><p>これはドメインを少し構造化された方法で捉えただけで、クラス構造もデータベーステーブルもない:</p> <ul> <li>ノンプログラマにとってもこわくない &#x2705; <ul> <li><strong>ドメインエキスパートにも見てもらい、一緒に取り組んでもらえる</strong></li> </ul> </li> <li>&#x2753; コードもこれくらいシンプルにできるのか？ <ul> <li>→ 第 5 章で学ぶ</li> </ul> </li> </ul> <h1 id="受注ワークフローを掘り下げる">受注ワークフローを掘り下げる</h1> <p>入出力を記述できたので、聞き取り調査を再開してワークフローを掘り下げていく。</p> <p>下記のドメイン知識が明らかになった:</p> <ul> <li><code>注文</code>か<code>見積り依頼</code>かを判別 <ul> <li><code>見積り依頼</code>はあとで処理する <ul> <li>売上げを生む<code>注文</code>のほうが重要だから</li> </ul> </li> </ul> </li> <li>検証作業におけるサードパーティサービスの利用</li> <li>用途の異なる書類の山 <ul> <li>実装ではキューになるだろうが、聞き取り調査では技術的詳細からは距離を保っておく</li> </ul> </li> <li><code>商品コード</code> のチェック <ul> <li>技術的に言うとシンタックスチェック</li> </ul> </li> <li><code>商品コード</code> の照合 <ul> <li>技術的に言うとデータベースルックアップ</li> </ul> </li> <li>依存管理 <ul> <li>「もし、商品部門のだれかがあなたの問い合わせに即座に答えられるとしても、商品カタログをやはり手元に持っておきたい？」「もちろん。電話が使えなかったり、彼らが忙しかったりしても、私の仕事が止まらずに済むから。」</li> </ul> </li> <li>数量単位の仕様</li> </ul> <h1 id="複雑さをドメインモデルに反映させる">複雑さをドメインモデルに反映させる</h1> <p>ワークフローを掘り下げたことによって、ドメインモデルがかなり複雑になった</p> <ul> <li>これは良いこと &#x2705; <ul> <li>実装する段になって複雑性が判明するのは大きな時間の無駄になる</li> <li>初期段階で、ドメインの理解に時間をかけるべき <ul> <li>「数週間のコーディングによって設計にかかる時間を数時間節約できる」という皮肉がある</li> </ul> </li> </ul> </li> </ul> <h2 id="制約を表現する">制約を表現する</h2> <p>聞き取り調査の結果、商品コードと数量が単なる文字列あるいは整数でないことがわかった。 これをドキュメントに反映する。</p> <p><code>ウィジェットコード</code>、<code>ギズモコード</code>、<code>商品コード</code>の制約は下記のように表現される:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>コンテキスト: 受注 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>ウィジェットコード データ = &#34;W&#34; から始まり 4 つの数字からなる文字列 </span></span><span style="display:flex;"><span>ギズモコード データ = &#34;G&#34; から始まり 3 つの数字からなる文字列 </span></span><span style="display:flex;"><span>商品コード データ = ウィジェットコード または ギズモコード </span></span></code></pre></div><ul> <li>&#x2753; この制約は厳しすぎるだろうか？ <ul> <li>&#x2753; 新しい商品コードを追加したくなったらどうする？ <ul> <li>正しい答えはコンテキストによるが、設計をドメインエキスパートの視点からすることが重要</li> </ul> </li> </ul> </li> </ul> <p>ここでは、この制約はドメインの設計に反映させるべきだろう。 なぜなら、商品コードのチェックは注文確認プロセスの重要な工程であることを学んだので、最終的には何らかの方法でドキュメント化が必要。 <strong>別のドキュメントに分散するより設計として書いた方が良い</strong>。</p> <p>ちなみに、設計が厳しいからといって必ずしも実装まで厳しくする必要はない。 不正な入力があったときの実装例:</p> <ul> <li>注文全体を即座に拒否（これは厳しすぎるだろう）</li> <li>ユーザーに「要確認」の通知を出す（よい落とし所かもしれない）</li> </ul> <p>数量に関する制約もドキュメントにしておく:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>単位数量 データ = 1 から 1000 までの整数 </span></span><span style="display:flex;"><span>キログラム数量 データ = 0.05 から 100.00 までの小数 </span></span></code></pre></div><h2 id="注文のライフサイクルを表現する">注文のライフサイクルを表現する</h2> <p><code>注文</code>（型）に着目し、学んだことを記述する。</p> <p>初期のバージョンでは下記のように表現したが、これはドメインを表現し切れていないことがわかった。</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>境界づけられたコンテキスト: 受注 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>注文 データ = </span></span><span style="display:flex;"><span> 顧客情報 </span></span><span style="display:flex;"><span> かつ 配送先住所 </span></span><span style="display:flex;"><span> かつ 請求先住所 </span></span><span style="display:flex;"><span> かつ 注文明細 のリスト </span></span><span style="display:flex;"><span> かつ 請求金額 </span></span></code></pre></div><p>聞き取り調査の結果、下記を学んだ:</p> <ul> <li><code>注文</code>にはライフサイクルがある <ul> <li><code>注文</code>は初めは<code>請求金額</code>を持たないが最後には必ず持つようになる</li> </ul> </li> <li>未検証の注文や未集計の注文は他と区別できる <ul> <li>紙ベースの現在の業務では進捗をフォームに記録しているため</li> </ul> </li> </ul> <p>これらをモデルにも反映する必要がある。</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>未検証の注文 データ = </span></span><span style="display:flex;"><span> 未検証の顧客情報 </span></span><span style="display:flex;"><span> かつ 未検証の配送先住所 </span></span><span style="display:flex;"><span> かつ 未検証の請求先住所 </span></span><span style="display:flex;"><span> かつ 未検証の注文明細 のリスト </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>未検証の注文明細 データ = </span></span><span style="display:flex;"><span> 未検証の商品コード </span></span><span style="display:flex;"><span> かつ 未検証の注文数量 </span></span></code></pre></div><p>各情報のステータスがわかるようになった（<strong>DB のフラグで済ませない！！！！</strong>）。</p> <p>注文が確認されると下記のようになる:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>検証済の注文 データ = </span></span><span style="display:flex;"><span> 検証済の顧客情報 </span></span><span style="display:flex;"><span> かつ 検証済の配送先住所 </span></span><span style="display:flex;"><span> かつ 検証済の請求先住所 </span></span><span style="display:flex;"><span> かつ 検証済の注文明細 のリスト </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>検証済の注文明細 データ = </span></span><span style="display:flex;"><span> 検証済の商品コード </span></span><span style="display:flex;"><span> かつ 検証済の注文数量 </span></span></code></pre></div><p>次は注文に金額を入力する:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>集計済の注文 データ = </span></span><span style="display:flex;"><span> 検証済の顧客情報 </span></span><span style="display:flex;"><span> かつ 検証済の配送先住所 </span></span><span style="display:flex;"><span> かつ 検証済の請求先住所 </span></span><span style="display:flex;"><span> かつ 集計済の注文明細 のリスト // 知識が反映されている </span></span><span style="display:flex;"><span> かつ 請求金額 // 知識が反映されている </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>集計済の注文明細 データ = </span></span><span style="display:flex;"><span> 検証済の商品コード </span></span><span style="display:flex;"><span> かつ 明細料金 // 知識が反映されている </span></span></code></pre></div><p>ドメインモデルがビジネスロジックを反映するようになった &#x1f389; 初めに考えていたよりも複雑になったが、逆に言えばもしモデルがこのように複雑でなかったとしたら、それは要件を正しく捉えられていなかったということ。</p> <h2 id="ワークフロー中のステップを肉付けする">ワークフロー中のステップを肉付けする</h2> <p>ワークフローが小さいステップに分割されることがわかった:</p> <ul> <li>確認作業</li> <li>集計作業</li> <li>などなど</li> </ul> <p>これらのステップにも入力出力アプローチを適用しよう</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>ワークフロー: 注文確定 </span></span><span style="display:flex;"><span> 入力: 注文フォーム </span></span><span style="display:flex;"><span> 出力: </span></span><span style="display:flex;"><span> &#34;注文が確定した&#34; イベント（他のチームに送るための山に置く） </span></span><span style="display:flex;"><span> または &#34;不正な注文&#34; （それ用の山に置く） </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> // ステップ 1 </span></span><span style="display:flex;"><span> do 注文を検証 </span></span><span style="display:flex;"><span> if 注文 が 不正 then: </span></span><span style="display:flex;"><span> add 不正な注文 to 山 </span></span><span style="display:flex;"><span> stop </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> // ステップ 2 </span></span><span style="display:flex;"><span> do 注文集計 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> // ステップ 3 </span></span><span style="display:flex;"><span> do 顧客に確認を送る </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> // ステップ 4 </span></span><span style="display:flex;"><span> return 注文が確定された イベント（if エラーがないならば） </span></span></code></pre></div><p>それぞれのサブステップもドキュメント化する</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>ワークフロー: 注文を検証 </span></span><span style="display:flex;"><span> 入力: 未検証の注文 </span></span><span style="display:flex;"><span> 出力: 検証済の注文 また 検証エラー </span></span><span style="display:flex;"><span> 依存: 商品コードの存在チェック, 住所の存在チェック </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> 顧客の名前を検証する </span></span><span style="display:flex;"><span> 配送先住所と請求先住所が存在することを確認する </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> for each 注文明細: </span></span><span style="display:flex;"><span> 商品コードをチェック </span></span><span style="display:flex;"><span> 商品コードが商品カタログに存在することをチェック </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> if 全て OK ならば, then: </span></span><span style="display:flex;"><span> return 検証済の注文 </span></span><span style="display:flex;"><span> else: </span></span><span style="display:flex;"><span> return 検証エラー </span></span></code></pre></div><p>ほぼ丸写しになってしまうのであとのステップは割愛。</p> <h1 id="まとめ">まとめ</h1> <p>次のモデリングフェーズでたくさんやることがあるので、要件の収集はここまで。</p> <p>ここで学んだことをまとめる:</p> <ul> <li>設計時には実装の詳細に立ち入らないことが重要</li> <li>代わりに、先入観やコーディング手法にとらわれずにドメインを捉えることに集中しよう</li> </ul> <p>本文中で例として使われている受注システムのようなはかなり単純化されているが、それでもドメインエキスパートの言葉に耳を傾けると、多くの複雑性が明らかになることがわかる。 例えば一口に注文といっても、ライフサイクルを通して、データや振る舞いの異なるのバリエーションがあった。</p> <h2 id="次にやることは">次にやることは？</h2> <p>受注ワークフローを F# の型システムを使ってどのようにモデリングするかをみていきたい。 次章ではその前に、一歩下がって全体像を見て、システム全体をどうソフトウェアアーキテクチャに翻訳するかを議論する。</p> https://rindrics.com/books/domain-model-made-functional/functional-architecture/ Thu, 21 Nov 2024 00:00:00 +0900 https://rindrics.com/books/domain-model-made-functional/functional-architecture/ <p>&ldquo;3. A Functional Architecture&rdquo; from &ldquo;<a href="https://rindrics.com/books/domain-model-made-functional/">Domain Modeling Made Functional: Tackle Software Complexity with Domain-Driven Design and F#</a>&rdquo; &#x1f4da;</p> <p><strong>次の課題</strong>: これまで得てきたドメインに対する理解を、どのように関数型プログラミングに基づいたソフトウェアアーキテクチャに翻訳するか</p> <ul> <li>&#x26a0;&#xfe0f; 注意点: 現時点ではまだ具体的なアーキテクチャについて考えすぎないようにすること</li> <li>時間を使うならば: 引き続きイベントストーミングや聞き取り調査などによってドメインと要件をより深く理解する</li> </ul> <p>本章で学ぶ内容:</p> <ul> <li>関数指向ドメインモデルのための典型的なソフトウェアアーキテクチャ</li> <li>DDD の概念（境界づけられたコンテキスト、ドメインイベントなど）がどのようにソフトウェアに翻訳されるのか</li> <li>ラフな実装方針</li> </ul> <p>本書が使うアーキテクチャ概念:</p> <ul> <li><strong>システムンテキスト</strong>: 業務システム全体 <ul> <li><strong>コンテナ</strong><sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup>: システムコンテキストを構成するデプロイ可能単位 <ul> <li><strong>コンポーネント</strong>: 各コンテナを構成するコードの大きい構成単位 <ul> <li><strong>クラス</strong>（あるいは<strong>モジュール</strong>）: コンポーネントの構成要素</li> </ul> </li> </ul> </li> </ul> </li> </ul> <h1 id="自律的なソフトウェアコンポーネントとしての境界づけられたコンテキスト">自律的なソフトウェアコンポーネントとしての境界づけられたコンテキスト</h1> <p>DDD の概念である &ldquo;境界づけられたコンテキスト&rdquo; とソフトウェアアーキテクチャとの関連を示す。</p> <p>コンテキストとは: うまく定義された境界に基づく自律的なサブシステム</p> <ul> <li>このように定義を定めたとしても、アーキテクチャとしての構成方法はいくつものパターンをとりうる <ul> <li>コンテナとドメインのマッピング例: <ul> <li><strong>コンテナ = 業務</strong>: システム=コンテナでもある。このとき、境界づけられたコンテキストはインターフェイスによって定義された個別のモジュール（.NET でいう &ldquo;アセンブリ&rdquo;）</li> <li><strong>コンテナ = 境界づけられたコンテキスト</strong>: 伝統的なサービス指向アーキテクチャ</li> <li><strong>コンテナ = ワークフロー</strong>: こうなるとマイクロサービスアーキテクチャ</li> </ul> </li> </ul> </li> </ul> <p>ただし、ドメインについて理解しきれていないフェーズでは、まだ特定のアーキテクチャパターンを選ぶ必要はない。 最重要なのは<strong>境界づけられたコンテキストを疎結合に設計し、自律可能に保つこと</strong>。</p> <p>境界を正しく定めることの重要性は述べたが、実際にはプロジェクト初期から正しく定めるのは難しい</p> <ul> <li>理由: 知識を得るにつれて境界は変わりうるから</li> <li>よって、開発初期にはまずはモノリスパターンで始めることをおすすめする <ul> <li>マイクロサービスパターンを使う明確なメリットが見えているならばこの限りではない</li> <li>本当に疎結合なマイクロサービスアーキテクチャを実現するのは難しいからでもある <ul> <li>あるマイクロサービスを止めたときに別の場所が壊れるならば、それはただの &ldquo;分散モノリス&rdquo;</li> </ul> </li> </ul> </li> </ul> <h1 id="境界づけられたコンテキスト間におけるコミュニケーション">境界づけられたコンテキスト間におけるコミュニケーション</h1> <p>どうコミュニケーションする？→ ドメインイベントを通じて</p> <ul> <li>注文処理を終えた受注部門が配送部門に対して配送を依頼する場合の例: <ul> <li>受注コンテキストは<code>注文が確定された</code>イベントを発行する</li> <li><code>注文が確定された</code>イベントはキューに入るか、直接発行される</li> <li>配送コンテキストは<code>注文が確定された</code>イベントをリッスンする</li> <li>配送コンテキストがイベントを受け取ると<code>注文を配送せよ</code>コマンドが作られる</li> <li><code>注文を配送せよ</code>コマンドは注文配送ワークフローをトリガーする</li> <li>注文配送ワークフローが完了すると<code>注文が配送された</code>イベントが発行される</li> </ul> </li> </ul> <p>このように設計すれば、受注・配送の両コンテキストは<strong>互いについて知る必要なく</strong>、イベントを通じてコミュニケーション可能。</p> <ul> <li>イベントを実際に発行する方法 <ul> <li>選定したアーキテクチャによる <ul> <li>キューや関数呼び出しなどが考えうるが、今はまだ決めなくていい</li> </ul> </li> <li>各コンテキストが自律できるよう、設計を疎結合に保つことが重要</li> </ul> </li> <li>イベントをコマンドに変換するハンドラ <ul> <li>これも複数の実装パターンが考えうる <ul> <li>下流コンテキストの一部としたり、独立したルータやプロセスマネージャにしてもいい</li> <li>選定するアーキテクチャや、イベントとコマンドの対応づけをどこでしたいかによって決めればいい</li> </ul> </li> </ul> </li> </ul> <p>&#x1f4dd; イベントを利用したコミュニケーションの特徴は<strong>互いを意識せずに済む</strong>ところ。 確かにイベント経由通信を使わなくとも、ある程度の疎結合性は「インターフェイス契約+非同期コミュニケーション」で獲得できる。 それでもやはり、通信時には相手にデータを投げるなり、相手のメソッドを呼び出すなり、コード中に必ず「相手」が出てきてしまう。</p> <h2 id="境界づけられたコンテキスト間におけるデータのやりとり">境界づけられたコンテキスト間におけるデータのやりとり</h2> <p>コミュニケーションに使われるイベントは、下流コンテキストが処理に必要としている全てのデータを含む。</p> <ul> <li>例: <ul> <li><code>注文が確定された</code>イベントは注文データ全体を含む <ul> <li><code>注文を配送せよ</code>コマンドを作るのに必要な情報全てを配送コンテキストに渡すため</li> </ul> </li> </ul> </li> </ul> <p>データがイベントに含めるのには大きすぎるなら、共有データストレージを利用してもよい。</p> <p>このデータオブジェクト──Data Transfer Objects（DTO）と呼ぶ──は、境界づけられたコンテキスト内で定義されたオブジェクトと同じに見えるが、厳密には違う。</p> <ul> <li>シリアライズしてコンテキスト間で共有できるよう設計されている <ul> <li>上流コンテキストの境界付近でドメインオブジェクトは DTO に変換される <ul> <li>JSON や XML などにシリアライズされる</li> </ul> </li> </ul> </li> <li>下流コンテキストでは、このプロセスが逆方向に実行されてドメインオブジェクトが作られる</li> </ul> <p>（例） <code>注文が確定された</code>イベントの DTO の構造:</p> <ul> <li>イベント DTO <ul> <li>注文 DTO <ul> <li>注文明細 DTO のリスト</li> </ul> </li> </ul> </li> </ul> <h2 id="信頼性境界と検証">信頼性境界と検証</h2> <p>境界づけられたコンテキストの輪郭は信頼性境界としてはたらく</p> <ul> <li>境界の内側: 全て信頼可能で、有効であるとみなされる</li> <li>境界の外側: いかなるものも未検証で、不正になり得る</li> </ul> <p>このような境界が機能するように、ワークフローの入口と出口にゲートを設置する必要がある。</p> <h3 id="入力ゲート">入力ゲート</h3> <p>渡された DTO がドメインの制約（例: ある属性が 非null かつ 50 文字以内であること）を満たしていることを保証するために、入力を必ず検証する。 検証失敗時には、残りのワークフローはスキップされて例外が送出される。</p> <h3 id="出力ゲート">出力ゲート</h3> <p>非公開情報が境界の外に出ないようにする役割を担う。</p> <p>目的:</p> <ul> <li>コンテキスト間の意図しないカップリング（なるほど！）</li> <li>セキュリティ向上</li> </ul> <p>これらの目的を果たすため、出力ゲートはドメインオブジェクトを DTO に変換する際に、情報を意図的に捨てる。</p> <h1 id="境界づけられたコンテキスト間の契約">境界づけられたコンテキスト間の契約</h1> <p>境界づけられたコンテキスト間のカップリングをできるだけ減らしたい</p> <ul> <li>しかし共有コミュニケーションは常に何らかの結合をもたらす <ul> <li>イベントと、関連する DTO は境界づけられたコンテキスト間に一種の契約をもたらす</li> <li>コミュニケーションを可能にするにはコミュニケーションに使う共通形式について両コンテキストが同意している必要がある</li> </ul> </li> </ul> <p>誰が契約の締結を決定する？→コンテキスト間の関係性による</p> <p>関係性の例:</p> <ul> <li>共有カーネル: 二つのコンテキストが共通のドメイン設計をいくつかもつ <ul> <li>よって関係するチームは協働する必要がある <ul> <li>例: 受注コンテキストは配送先住所を受け取り、検証する。配送コンテキストは配送にその住所を使う</li> </ul> </li> <li>イベントや DTO の定義を変えるときには関係者のレビューが必要</li> </ul> </li> <li>顧客/供給者（または顧客駆動契約）: 下流のコンテキストが上流コンテキストに供給してほしいものを定義する <ul> <li>上流が契約を守っている限り、両ドメインは独立に進化できる <ul> <li>例: 請求コンテキストが契約を定義し、受注コンテキストがそれを供給する</li> </ul> </li> </ul> </li> <li>順応者: 顧客駆動とは逆に、上流の定義を下流が受け入れ、自らのドメインモデルをそれに合うように適応させる <ul> <li>例: 受注コンテキストは製品カタログが決めた契約に従っている</li> </ul> </li> </ul> <h2 id="腐敗防止層">腐敗防止層</h2> <p>外部システムと通信したいとき、利用可能なインターフェイスが自コンテキストのドメインモデルと全く合わないことがある</p> <ul> <li>腐敗防止層（入力ゲートがこの役割を果たすことが多い）を使って、やりとりやデータをコンテキストに合うものに変換する必要がある <ul> <li>理由: ドメインモデルが外部のシステムに合わせようとして「壊れて」しまうのを防ぐため</li> </ul> </li> </ul> <h2 id="コンテキストマップと関係性">コンテキストマップと関係性</h2> <p>設計が進み、コンテキスト間の関係が決まったとする:</p> <ul> <li>受注・配送コンテキスト間: 共有カーネル <ul> <li>なのでコミュニケーション契約を一緒に決める</li> </ul> </li> <li>受注・請求コンテキスト間: 顧客駆動契約 <ul> <li>請求コンテキストが契約を決め、受注コンテキストがそれを提供する</li> </ul> </li> <li>受注・製品カタログ間: 適合者パターン <ul> <li>受注コンテキストは製品カタログが定めたモデルを使う</li> </ul> </li> <li>外部の住所確認サービス: 本システムのドメインモデルと全然合わない <ul> <li>腐敗防止層を介して利用する</li> </ul> </li> </ul> <p>コンテキストマップ<strong>コンテキストをもつチームがどのように連携すべきか</strong>も示す</p> <ul> <li>技術的な課題であると同時に組織的な課題でもある</li> </ul> <h1 id="境界づけられたコンテキスト内におけるワークフロー">境界づけられたコンテキスト内におけるワークフロー</h1> <p>ビジネスワークフローの表現:</p> <ul> <li>DDD の概念に基づく表現: コマンドにより起動され、いくつかのドメインイベントを発するミニプロセス</li> <li>関数型アーキテクチャにおける表現: コマンドオブジェクトを入力とし、イベントオブジェクトのリストを出力とする一つの関数</li> </ul> <p>本文中の模式図を使った説明:</p> <ul> <li>ワークフローは常にただ一つの境界づけられたコンテキストに含まれる</li> <li>公開ワークフロー（コンテキスト外からトリガーされる）は境界の外側に少しはみ出している</li> </ul> <h2 id="ワークフローの入力と出力">ワークフローの入力と出力</h2> <ul> <li>入力: 常にコマンドとひもづくデータ</li> <li>出力: 他のコンテキストと通信するためのイベントのリスト</li> </ul> <p>受注ワークフローにおける例:</p> <ul> <li>入力: <ul> <li><code>注文を確定せよ</code>コマンド</li> <li>紐づくデータ</li> </ul> </li> <li>出力: <code>注文が確定された</code>イベントなどのイベントのリスト</li> </ul> <p>請求コンテキストにおける例: （顧客/供給者パターンであることに注意）</p> <ul> <li>ただの<code>注文が確定された</code>イベントを出すだけでなく、イベントに含めるデータはは<strong>請求に必要なデータのみ</strong>に限る必要がある <ul> <li>例: 請求先住所と合計金額だけ。配送先住所と商品リストは入れない</li> </ul> </li> </ul> <p>つまり、我々は新しいイベント（言うなれば<code>請求可能な注文が確定した</code>イベント）を発行する必要があることを意味する。</p> <p>また注文確認が送信されたイベントも送りたい なので前に作ったダイアグラムはもう古いので新しくしたい</p> <p>ワークフローの模式図の中で重要なのは、関数はイベントを<strong>発行して</strong>はおらず、単に返しているだけであるところ</p> <ul> <li>理由: どのように発行するかは別の関心事なため</li> </ul> <h2 id="境界づけられたコンテキスト内のドメインイベントを避ける">境界づけられたコンテキスト内のドメインイベントを避ける</h2> <p>オブジェクト指向設計でよく見られるパターン: 境界づけられたコンテキスト内で、ドメインイベントを受けたリスナーが別のドメインイベントを発行 &#x26a0;&#xfe0f;</p> <p>関数型アプローチではやらない</p> <ul> <li>理由: 隠れた依存を生み出してしまうから <ul> <li>リスナーが必要な場合にはワークフローの終端に置く <ul> <li>効果: <ul> <li>ミュータブルなグローバルイベントマネージャがいないことが明示される &#x2705;</li> <li>理解・メンテナンスしやすい &#x2705;</li> </ul> </li> </ul> </li> </ul> </li> </ul> <h1 id="境界づけられたコンテキスト内のコード構造">境界づけられたコンテキスト内のコード構造</h1> <p>伝統的な「レイヤーアプローチ」では、コードは下記のような層に分けられる:</p> <ul> <li>コアドメインまたはビジネスロジック</li> <li>データベース</li> <li>サービス</li> <li>API またはユーザーインターフェイス</li> </ul> <p>ワークフローは表面のインターフェイスから始まって最深部のデータベースに到達し、また表面に戻る</p> <p>この手法の問題点 &#x26a0;&#xfe0f;:</p> <ul> <li>「同時に変更されるコードは同じ場所に属するべき」という設計原則を破っている</li> <li>層が「水平に」組み合わさっているので、ワークフローの動きを変えようとする場合には全ての層を変更する必要がある</li> </ul> <p>よりよい方法 &#x2705;: 「垂直な」構成に移行</p> <ul> <li>それぞれのワークフローは各自の仕事を終えるために必要なコードを全て含む</li> <li>ワークフローに対する要求が変わったら特定の垂直スライスだけを変えればいい</li> </ul> <p>これは理想論ではなく実際に可能</p> <h2 id="オニオンアーキテクチャ">オニオンアーキテクチャ</h2> <p>オニオンアーキテクチャ:</p> <ul> <li>ドメインを真ん中に置く</li> <li>その周りにその他の側面を配置する <ul> <li>配置ルール: それぞれの層は外側にでなく、内側にだけ依存する</li> </ul> </li> </ul> <p>この構造に対して関数型の依存注入を使う方法は第 9 章で述べる</p> <h2 id="io-を外側に保つ">I/O を外側に保つ</h2> <p>関数型プログラミングの主な狙い: 予測可能で、内部を見ることなく簡単に説明できる関数を使って仕事をすること</p> <ul> <li>そのために、関数を下記のように設計する: <ul> <li>可能な限りイミュータブルなデータを使うことで依存を明示する</li> <li>ランダム性・関数外の変数の更新などの副作用や、いかなる I/O も持たないようにする</li> </ul> </li> </ul> <p>DB やファイルシステムを使って読み書きするシステムは「不純」とみなされる → そのような関数はコアドメインから取り除く</p> <p>&#x2753; データの読み書きはどうやったらいい？ → I/O をオニオンアーキテクチャの最外殻に保つ</p> <ul> <li>データベースにアクセスするのは、ワークフローの内部ではなく最初と最後のみ <ul> <li>ドメインモデルに DB が登場しないのなら、ワークフローでも内部から DB にアクセスできてはいけない</li> </ul> </li> <li>利点: <ul> <li>関心が異なるもの同士を分離できる <ul> <li>コアドメインはビジネスロジックのみに集中</li> <li>永続化や他の I/O はインフラが管理する</li> </ul> </li> </ul> </li> </ul> <h1 id="まとめ">まとめ</h1> <p>DDD に関する概念と定義をいくつか紹介した</p> <ul> <li>ドメインオブジェクト: BC 内側でのみ使われるオブジェクト</li> <li>DTO: シリアライズされて bc 間で共有されるためのオブジェクト</li> <li>共有カーネル、顧客/サプライヤ、適合者: 境界づけられたコンテキスト間の関係パターン</li> <li>腐敗防止層: あるドメインの概念を他のドメインのものに翻訳するコンポーネント。カップリングを減らし、各ドメインが独自に進化できるようにする</li> <li>永続化の無視: ドメインモデルはドメイン自体の概念のみ基づくべきであり、永続化メカニズムへの意識は含むべきでない</li> </ul> <h1 id="次に学ぶこと">次に学ぶこと</h1> <p>ドメインを理解し、解決策を設計するアプローチを理解したことで、それぞれのワークフローの設計と実装に取り組めるようになった。</p> <p>続く数章でやること:</p> <ul> <li>F# の型システムを使ってワークフローとデータを定義する</li> <li>実際にコンパイル可能ながら、ドメインエキスパートや非開発者にも理解可能なコードを書く</li> </ul> <p>そのために次の章で学ぶこと:</p> <ul> <li>関数プログラマにとって型とは何を意味するのか</li> <li>クラスとどう違うのか</li> </ul> <div class="footnotes" role="doc-endnotes"> <hr> <ol> <li id="fn:1"> <p>Docker などの仮想環境技術の文脈における &ldquo;コンテナ&rdquo; ではないので注意&#160;<a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> </ol> </div> https://rindrics.com/posts/supplement-platform-engineering-approach/ Fri, 04 Sep 2026 00:00:00 +0900 https://rindrics.com/posts/supplement-platform-engineering-approach/ <h2 id="これはなに">これはなに</h2> <p>下記の口頭発表に対する補足記事である。</p> <ul> <li>演題: &ldquo;PfEingのアプローチで働こう&rdquo;</li> <li>イベント名: 【3-shake × enechain】SRE Tech Talk #15</li> <li>日時: 2026年9月4日</li> <li>場所: 株式会社スリーシェイク（東京, 銀座）</li> </ul> <p>この記事では、時間の制約から口頭発表には含められなかった情報を補足として紹介する。</p> <p>発表資料はこちら:</p> <div class="speakerdeck-embed"> <iframe class="speakerdeck-iframe" src="https://speakerdeck.com/player/1e9dfa1f9fb84c049ff2d52837afd1be" title="PfEingのアプローチで働こう" allowfullscreen allow="web-share" loading="lazy" style="border: 0; background: rgba(0, 0, 0, 0.1); margin: 0; padding: 0; border-radius: 6px; box-shadow: rgba(0, 0, 0, 0.2) 0 5px 40px; width: 100%; height: auto; aspect-ratio: 16 / 9;" ></iframe> </div> <h2 id="スライド各ページの補足">スライド各ページの補足</h2> <h3 id="タイトル">（タイトル）</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/1.webp" width="70%"> </figure> <p>本発表で話したのは「PfEingアプローチ」 ではない。 これでは、私が新しい用語を考え出したことになってしまう。</p> <p>あくまでも「PfEing<strong>の</strong>アプローチ」だ。</p> <p>「プラットフォームエンジニアリング」はスライド上では幅を取りすぎるので &ldquo;PfEing&rdquo; で統一した。 視覚上は短くなったが、読みは同じなので噛みそうなのは変わらない。</p> <h3 id="自己紹介">（自己紹介）</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/2.webp" width="70%"> </figure> <p>サイボウズが提供しているキントーン（kintone, Kintone）というサービスは、単一（というと語弊があるが）のアプリケーションソースコードを<a href="https://blog.cybozu.io/entry/2025/04/11/112000">国内向け（cybozu.com）</a>・<a href="https://blog.cybozu.io/entry/2019/04/24/080000">国外向け（kintone.com）</a>二つの基盤で動かすことでエンドユーザーに提供されている。</p> <p>ちなみに、キントーンのアルファベット表記は、国内向けでは小文字始まりの<strong>k</strong>intoneなのに対し、海外向けでは<strong>K</strong>intone。</p> <p>私のチームはkintone.comのプラットフォームを開発・運用しているプラットフォームチームで、社内では通称Yakumoチームと呼ばれている。</p> <p>10年近い歴史を持つチームなので、記事の中には古くなっているものもあるが、サイボウズのテックブログを &ldquo;Yakumo&rdquo; カテゴリで検索すると<a href="https://blog.cybozu.io/archive/category/Yakumo">技術記事がヒット</a>する。</p> <p>名前の由来をふくむ、Yakumoチーム自体については下の記事にまとまっている。</p> <div class="card"> <a href="https://blog.cybozu.io/entry/2026/07/23/100000" target="_blank" rel="noopener noreferrer" class="card-link"> <div class="card-content"> <h4 class="card-title">kintone.com プラットフォームを提供 ~ われら Yakumo にござる | blog.cybozu.io</h4> <span class="card-url">https://blog.cybozu.io/entry/2026/07/23/100000</span> </div> </a> </div> <h3 id="やっていること">「やっていること」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/3.webp" width="70%"> </figure> <p>本発表はプラットフォームエンジニアリング的な働き方について述べたものだが、別のアプローチの働き方をした経験があるので前職の例と対比した。</p> <p>DevOpsをチーム名に冠すること自体についてはここには書ききれないので、別の機会に書こうと思う。</p> <h3 id="pfeingチームの働き方">「PfEingチームの働き方」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/4.webp" width="70%"> </figure> <p>発表には含められなかったが、最近はプラットフォームエンジニアリングに関して、下記のテーマについて考えている:</p> <ul> <li>PfEingというアプローチそれ自体</li> <li>プラットフォームの &ldquo;<a href="https://tag-app-delivery.cncf.io/whitepapers/platforms/#attributes-of-platforms:~:text=the%20database%20server.-,Optional,-and%20composable.%20Platforms">optional</a>&rdquo; という特性と、それが満たされないときに起こること</li> <li>一応の運用が効果計測を目的とした計装と社内の信頼残高との関係</li> <li>責務境界のあるべき姿とストリームアラインドチームの負担増</li> </ul> <p>上記のうち、「PfEingというアプローチ」に関して、LTサイズに切り出せるメッセージが見つかったので本発表を作った。</p> <p>本スライドに示したのは、本発表が特に影響を受けた下記の記事・書籍である:</p> <ul> <li>&ldquo;<a href="https://martinfowler.com/articles/talk-about-platforms.html">What I Talk About When I Talk About Platforms</a>&rdquo; Bottcher (2018)</li> <li>&ldquo;<a href="https://cloudnativeplatforms.com/whitepapers/platforms/">CNCF Platforms White Paper</a>&rdquo;</li> <li>&ldquo;<a href="https://chadxz.dev/platform/">How Platform Engineering Works</a>&rdquo; McElligott (2023)</li> <li>『<a href="https://www.oreilly.co.jp/books/9784814401413/">プラットフォームエンジニアリング</a>』Fournier &amp; Nowland (2025) オライリー・ジャパン</li> <li>『<a href="https://book.mynavi.jp/ec/products/detail/id=151794">実践 プラットフォームエンジニアリング</a>』Chankramath et al. (2026) マイナビブックス</li> </ul> <h3 id="損益分岐点がある">「損益分岐点がある」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/5.webp" width="70%"> </figure> <p>こんにち（2026年）では、「プラットフォームエンジニアリング」という言葉が定着しつつあるため、このデシジョンツリーを使うなどして「プラットフォームエンジニアリングをするかどうか」というメタ認知を持ってプラットフォームチームを立ち上げられる。 プラットフォームチームにとって（もちろん組織全体にとって）、これは本当に大きい利点だ。</p> <p>この言葉がなかった頃から、形を変えながら続いてきたプラットフォームチームでは、プラットフォームとして必ずしも適切とはいえない責務を抱えていることがあると思う。</p> <h3 id="常に必要な自問">「常に必要な自問」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/6.webp" width="70%"> </figure> <blockquote> <p>「自分たちはPfEing<strong>できているか</strong>？」</p> </blockquote> <p>現実世界でちゃんとPfEingするのは本当に難しいので「できているか」を強調してある。</p> <p>プラットフォームエンジニアは、自分達の働き方について、本当に自覚的になる必要がある。 プラットフォームエンジニアの場合、他チーム<sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup>から見て「いい仕事」をしているように見えても、プラットフォームエンジニアリング的に誤ったアプローチで働いてしまうというケースは、いくらでも生じうる。 顧客の満足が必ずしも</p> <blockquote> <p>宿命的にROIが重要</p> </blockquote> <p>これには引用があるわけではなく、発表において言葉の簡潔さとパワーを得るためにこのフレーズを使った。</p> <p>といっても、プラットフォームエンジニアリングについて色々な情報を読んでいれば意味するところは理解いただけるのではないかと思う。</p> <p>関連する記述を具体的に揚げるとすれば、『プラットフォームエンジニアリング』では、プラットフォームチームは、より大きいものを管理するために自チームのサイズを大きくすることに慎重になる必要があることを指摘している（13.3「成長をコントロールすることによる複雑性の管理」）。 これは単純にROIの分母が大きくなってしまうだけではなく、働き方の質を変えるための吟味の機会を失うことも意味するからだ。</p> <h3 id="pfeingのアプローチ">「PfEingのアプローチ」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/7.webp" width="70%"> </figure> <p>どこから取ろうがエッセンスは変わらないが、ここでは代表としてCNCFのPlatforms White Paperからの引用を示した。 このドキュメントは短いが、読むたびに新しいテーマについて考えるきっかけが得られるので、私は定期的に読むようにしている。</p> <p>ちなみに現時点のPlatforms White Paperは、雑にキーワード検索すると<a href="https://tag-app-delivery.cncf.io/whitepapers/platforms/">App Delivery TAG版の古いドキュメント</a>がヒットしがち。 現行のドキュメントは<a href="https://cloudnativeplatforms.com/whitepapers/platforms/">cloudnativeplatforms.comのこちら</a>。</p> <h3 id="気を抜くとかんたんに外れうる">「気を抜くとかんたんに外れうる」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/8.webp" width="70%"> </figure> <p>プラットフォームエンジニアリングチームが<strong>どう</strong>働くべきチームなのかを、組織の中で最もよく理解しているのはプラットフォームチーム自身だ。 そもそも「依頼」という言葉自体、危険な香りがする。 プラットフォームチームとしては、TicketOps的な慣習をアンラーニングし、顧客チームとの関わり方自体も組織として成熟させていく必要がある。 『チームトポロジー』の用語で言うならば、ここで言っているのは「顧客チームとの &ldquo;コラボレーションモード&rdquo; を &ldquo;X-as-a-Service&rdquo; に変えていけ」という話<strong>ではない</strong>。 新しいケイパビリティの探索フェーズでは、コラボレーションモードが必要になる。 ここでは「依頼を受けて作る」という働き方を、雑に「コラボレーションモード」と呼んだりはするな、という意味で言っている。</p> <p>余談だが、参考リンク先の「Terraformスタータキット」のアンチパターンの例<sup id="fnref:2"><a href="#fn:2" class="footnote-ref" role="doc-noteref">2</a></sup>については、もしスタータキットの<strong>モジュール配布だけ</strong>をやっていた場合には少しマシになる<sup id="fnref:3"><a href="#fn:3" class="footnote-ref" role="doc-noteref">3</a></sup>という理解。</p> <h3 id="どうしても断れない依頼">「どうしても断れない依頼」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/9.webp" width="70%"> </figure> <p>このケースは、最初からプラットフォームチームとして設計されて立ち上がった、新しいプラットフォームチームでは起こりにくいのかもしれない。</p> <p>一方で、形を変えながら続いてきたプラットフォームチームには、このパターンはよく発生するのではないだろうか。</p> <h3 id="現実世界はいろいろあるけど">「&hellip;現実世界はいろいろあるけど」</h3> <figure><img src="https://rindrics.com/images/2026-09-02-pfeing/10.webp" width="70%"> </figure> <p>プラットフォームエンジニアリングは全体最適を追求する働き方だ。 全体最適は組織にとって善きものだが、それを推進する取組みもまた善きものと見られるかどうかは、他のタスクとの比重に因っている。 他チームに預けた信頼残高も関わってくる。</p> <h2 id="謝辞">謝辞</h2> <p>発表の機会を提供してくださったスリーシェイクさん、enechainさん、ありがとうございました。</p> <div class="footnotes" role="doc-endnotes"> <hr> <ol> <li id="fn:1"> <p>「他チーム」とはもちろん、プラットフォームエンジニアリングについての解像度が低いチームのことだ。当然、他のプラットフォームチームの目はごまかせない&#160;<a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> <li id="fn:2"> <p>ここでいうアンチパターンとは「プラットフォームチームとしての」アンチパターンのこと。状況に応じた方法を選ぶことが重要&#160;<a href="#fnref:2" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> <li id="fn:3"> <p>マシになるとは、プラットフォームエンジニアリング的な働き方にやや近づく、と言う意味&#160;<a href="#fnref:3" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> </ol> </div> https://rindrics.com/posts/book-review-effective-platform-engineering/ Sat, 29 Aug 2026 00:00:00 +0900 https://rindrics.com/posts/book-review-effective-platform-engineering/ <p><a href="https://effectiveplatformengineering.com/">Effective Platform Engineering</a>の邦訳版が出たので読んでみた。</p> <figure><img src="https://rindrics.com/images/2026-08-25-pfe/cover.webp"> </figure> <p>実践 プラットフォームエンジニアリング─開発者体験を加速するセルフサービス基盤の設計と構築</p> <ul> <li>執筆: Ajay Chankramath, Nic Cheneweth, Bryan Oliver, Sean Alvarez</li> <li>翻訳: 株式会社スリーシェイク（元内柊也、小池玲斗、木曽和則、下村俊貴）</li> <li>マイナビブックス、2026年</li> </ul> <p>私が読んだのは<a href="https://book.mynavi.jp/ec/products/detail/id=151794">PDF板</a>。 なお本書は会社の<a href="https://cybozu.backstage.cybozu.co.jp/n/ncabe948d639c">SLP（Self Learning Program）</a>という仕組みを利用して購入した。</p> <h2 id="どんな本か">どんな本か</h2> <p>こんにち、プラットフォームエンジニアリングのマインドセットは言語化され、例えば &ldquo;<a href="https://cloudnativeplatforms.com/whitepapers/platforms/">CNCF Platforms White Paper</a>&rdquo; などで参照可能になっている 一方で、それらを具体的にどのように実現するかについては、まだまだ情報は充分とはいえない。 本書は、コンサルタントとしてエンジニアリングプラットフォームの実装に関わり、多くの場数を踏んだ著者らによるものなのでこの &ldquo;how&rdquo; の部分が手厚く解説されている。 ちなみに著者陣のキャリアは、4人全員がThoughtworksあるいはBrillioにあり、これはつまりプラットフォームエンジニアリングにとって重要な要素であるスケール性を扱った経験が豊富ということを意味する。 また、特定のプラットフォームプロダクトのベンダー企業<strong>ではない</strong>というところも、実践形式の書籍として良い点といえる。</p> <p>本書の他に、プラットフォームエンジニアリングに関して体系的に読める別の書籍としてはオライリージャパンの『プラットフォームエンジニアリング』<sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup>もあるが、本書のほうが後発なだけあって現時点におけるプラットフォームエンジニアリングの業界の標準が反映されている。 2026年時点において、プラットフォームエンジニアリングについて知りたい人がまず読むならば、あちらの本よりも本書を先に読むと良さそう。 本書で「どんな世界観をどう実装するか」を理解したあと、「それを社内（政治的制約がある環境）でどう推進するか」について『プラットフォームエンジニアリング』を読みながら考えてみるとよい。</p> <p>また本書はプラットフォームエンジニアリングの定義に成功指標の計測も含めており、オブザーバービリティを第一級市民として扱っているところも特徴といえる。</p> <h2 id="個人的に目に止まったところ">個人的に目に止まったところ</h2> <h3 id="第1章-プラットフォームエンジニアリングとは何か">第1章 プラットフォームエンジニアリングとは何か</h3> <h4 id="プラットフォームはdevopsにとどまらないp4">プラットフォームはDevOpsにとどまらない（p.4）</h4> <p>本節で書かれている &ldquo;DevOps&rdquo; の認識に同意しかねる部分がある。 コメントの分量が膨らんでしまいそうなので、別の記事で書くことにする。</p> <h3 id="第2章-ソフトウェアデファインドのプロダクトとアーキテクチャ">第2章 ソフトウェア・デファインドのプロダクトとアーキテクチャ</h3> <h4 id="1年後にプラットフォームがどう使われるかを予測するのは不可能p44">1年後にプラットフォームがどう使われるかを予測するのは不可能（p.44）</h4> <p>この解釈は難しいところだと思う。 本書は技術選定時にはなるべく少ない機能のものを選ぶことを推奨しているが、だからといってここの記述は「今だけを見て意思決定しろ」という意味ではないはず。 チームとして戦略的視点に基づいた動きをしていることは恐らく前提（&hellip;そうだよな？）。 要はよくよく気をつけろというメッセージと理解した。</p> <p>それにしても「不可欠だと思われていたケイパビリティが実は不要だった」は肝に命じておきたい。 YAGNIとは昔から言われるが、ここで述べられているのは「あったら良いと思ったが不要だった」ではなく、「<strong>不可欠</strong>だと思ったが不要だった」だから恐ろしい。 要件を考える段になってYAGNIを唱えるのではなく、戦略レベルから注意を払わないとだめということ（難しい）。</p> <h4 id="ドメイン駆動プラットフォーム設計p54">ドメイン駆動プラットフォーム設計（p.54）</h4> <p>プラットフォームエンジニアリングの文脈でDDDを強調しているのは本書の一つの特徴。 個人的には、ソフトウェア開発ど真ん中のキャリアではないながらも、DDDについては本業とは別に継続的に自己投資してきたので、これまで学んできたことが本書を読んで数年（5年くらい？）のタイムラグを経てつながった感じがある。</p> <h4 id="スムーズな開発者体験を実現するインフラコスト配賦p59">スムーズな開発者体験を実現するインフラコスト配賦（p.59）</h4> <p>ここで書かれているスムーズな開発者体験は、顧客チームにインフラのコスト配賦をできている前提。 バックオフィスとも連携がとれた組織のレベルが高い話だ。</p> <h4 id="手動プロセスによる機会損失p60">手動プロセスによる機会損失（p.60）</h4> <p>手動プロセスが機会損失につながることは誰でも知っているが、コストや効果の計測を第一級市民として扱う本書では、機会損失は言葉だけでなく実際に算出する値としての意味を持っている。 こういった広い意味でのオブザーバービリティは、短期的な顧客価値につながりづらいので推進が難しいが、裏を返せばオブザーバービリティ確保の先延ばしは、チームが「このプロダクトは（たぶん）顧客の生産性を高めた（んだと思う&hellip;）」という状態で働き続けることを意味する。</p> <h4 id="組織固有のケイパビリティをk8sのapi拡張でオーケストレーションするp62">組織固有のケイパビリティをk8sのAPI拡張でオーケストレーションする（p.62）</h4> <p>自動化はソフトウェアエンジニアリング文化の空気みたいなものだが、オーケストレーション──確実に動き続ける──まで保証できるのはプラットフォームエンジニアリングならではのアプローチだと思う。</p> <h3 id="第3章-計測で導くプラットフォームエンジニアリングの成功">第3章 計測で導くプラットフォームエンジニアリングの成功</h3> <h4 id="エンジニアリングプラットフォーム構築のデシジョンツリーp70">エンジニアリングプラットフォーム構築のデシジョンツリー（p.70）</h4> <p>図3.2のデシジョンツリーは、プラットフォーム構築がプラスになるかどうかの境界フェーズにある組織にとってはなかなか役立ちそう。</p> <h4 id="プラットフォーム価値モデリングp77">プラットフォーム価値モデリング（p.77）</h4> <p>プラットフォームチームの取組みが組織のバリューストリームから遠ざかることについて、これまでにもアンチパターンとして認識されてきた（<a href="https://cloudnativeplatforms.com/whitepapers/platforms/#:~:text=teams%2E-,Many,frustration%2E">例</a>）。 本書が「プラットフォーム価値モデリング」としてモデル化したことで、世のプラットフォームチームは「アンチパターンに陥らないようにする」という具体性を欠いた否定形ではなく「プラットフォーム価値モデリングする」と能動態で考えられるようになった。 これは一種のケイパビリティだと思う。</p> <h4 id="パフォーマンスメトリクス--オンボーディング時間p86">パフォーマンスメトリクス | オンボーディング時間（p.86）</h4> <p>社内プラットフォームだからといって認証をおろそかにすると、こういったオブザーバービリティ面でツケが回ってくる。</p> <h4 id="エンジニアリングプラットフォームのプロダクトドメインp91">エンジニアリングプラットフォームのプロダクトドメイン（p.91）</h4> <p>図3.8は抽象的だが、ここで表されているものは、AWS上にEKSで環境を構築しているチームならば普通に使っているリソースを、本書の基準で分類したもの。 この8つの分類は初見時にはあまりしっくりこないかもしれないが、&ldquo;6.4 クラウド管理ID&rdquo;（p.193）以降で登場するそれぞれの分類の解説を読めば、その合理性がだんだんわかってくる。</p> <h3 id="第4章-ガバナンスコンプライアンス信頼">第4章 ガバナンス・コンプライアンス・信頼</h3> <h4 id="idプロバイダーソリューションp117">IDプロバイダーソリューション（p.117）</h4> <p>チームの境界で見られがちな「依頼」という協働パターンを撲滅するヒントがある。</p> <h3 id="第5章-進化するオブザーバービリティ">第5章 進化するオブザーバービリティ</h3> <h4 id="オブザーバービリティの8つのレンズp131">オブザーバービリティの8つのレンズ（p.131）</h4> <p>2026年現在、「オブザーバービリティ」といえば一般にはアプリケーションのオブザーバービリティを指すと思うが、本書ではそれをエンドユーザー（社内の開発者ユーザーのこと）体験を制限するアンチパターンと言い切っている。 本書はオブザーバービリティを「エンジニアリング」カテゴリと「ビジネス」カテゴリそれぞれ4つづつの主要8軸に分類し、組織のすみずみまで可観測性がある世界観を提示している。 当然「データ分析基盤」と呼ばれるものまで含むので、恐らくすべてプラットフォームチームが担当するわけではないだろう。 もしくは、いま「データエンジニアリングチーム」と呼ばれるものもプラットフォーム組織配下のチームとして考えているのかもしれない。</p> <h3 id="第6章-ソフトウェアデファインドなエンジニアリングプラットフォームの構築">第6章 ソフトウェア・デファインドなエンジニアリングプラットフォームの構築</h3> <h4 id="名前空間レベルのパイプラインp170">名前空間レベルのパイプライン（p.170）</h4> <p>ここで解説されているpreviewクラスタはおもしろい。 社内顧客を抱えるチームとして、インフラのメンテを安心して当てるのに合理的な構成となっている。</p> <h3 id="第7章-プラットフォームコントロールプレーンの基礎">第7章 プラットフォームコントロールプレーンの基礎</h3> <h4 id="クラウドアカウントのベースラインp214">クラウドアカウントのベースライン（p.214）</h4> <p>ここに差し掛かると、本書がこの「クラウドアカウントベースライン」を、前章で解説された「クラウド管理ID」とは異なるレイヤーのリソースとして認識していることを理解できる。 本来、AWSのリソースモデルの構造としては「アカウント」の下に「IAMロール」があるわけだが、本書の認知モデルではまず「クラウド管理ID（IAMロールが含まれる）」があり、その上に「クラウドアカウントベースライン（AWSアカウントを指す）」が載っている。 もちろん、AWSのリソースモデルとは異なるこの認知モデルが常に最高なわけはないが、複数アカウントの運用そのものが業務ドメインの中心にあるプラットフォームエンジニアリングの文脈では、なるほどこの整理は合理的だ。</p> <p>ただ環境を動かすだけなら誰にでもできる。 きれいに運用するのが難しい。 こうやって見せてもらえれば腹落ちするのだが、この整理は自分では思いつけそうにない。 ここはなかなか勉強になった。</p> <h3 id="第8章-コントロールプレーンのサービスとエクステンション">第8章 コントロールプレーンのサービスとエクステンション</h3> <h4 id="プラットフォームエンジニアリングとdevopsのアプローチの違いp317">プラットフォームエンジニアリングとDevOpsのアプローチの違い（p.317）</h4> <p>「スターターキット」のプラクティスを例に、DevOpsとプラットフォームエンジニアリングの違いが解説されている。 この解像度での解説は本書ならではで、両者は全く違うことがわかる。 特にプラットフォームエンジニアリングをする立場にあるならば、きちんと理解しておく必要がある。</p> <h3 id="第9章-スケールを支えるアーキテクチャの変更">第9章 スケールを支えるアーキテクチャの変更</h3> <h4 id="アジャイルプラクティスの導入p358">アジャイルプラクティスの導入（p.358）</h4> <p>『プラットフォームエンジニアリング』はプラットフォームチームがアジャイルな進め方をすることにかなり注意深い態度だったが、本書はけっこうアジャイル派な印象。</p> <h3 id="第10章-プラットフォームプロダクトの進化">第10章 プラットフォームプロダクトの進化</h3> <h4 id="内部開発者プラットフォームidpと開発者ポータルの比較p378">内部開発者プラットフォーム（IDP）と開発者ポータルの比較（p.378）</h4> <p>名前からしてそもそも紛らわしいので、ここは多くの読者が注意深く読みそう。 解説されてみれば、両者は確かに全く異なるし、はっきり使い分ける必要がある。</p> <h2 id="理解しにくかった箇所の個人的メモ">理解しにくかった箇所の個人的メモ</h2> <h3 id="p10">p.10</h3> <blockquote> <p>3つの概念は互いに依存し合っています</p> </blockquote> <p>&ldquo;<strong>4</strong>つの概念&rdquo; だろうか。</p> <p>余談だが、図1.3のような循環を表す模式図は、矢印を曲線にするだけで飛躍的に理解しやすくなる。</p> <h3 id="p20">p.20</h3> <p>ハンドオフ: 仕事の受け渡しのこと</p> <h3 id="p21">p.21</h3> <h4 id="図18">図1.8</h4> <ul> <li>SAST: static application security testing</li> <li>DAST: dynamic application security testing</li> </ul> <h3 id="p29">p.29</h3> <blockquote> <p>セキュリティステークホルダーが企業認証基準を、(1) 内部認証の単一の信頼できるソースを要求し、(2) 内部実装をOAuth 2.0 フレームワークに基づくものと定義する場合です</p> </blockquote> <p>これは恐らく下記の意味だと思う。</p> <p>セキュリティステークホルダーが企業認証基準を下記のように定義する場合です。</p> <ul> <li>(1) 内部認証の単一の信頼できるソースを要求するもの</li> <li>(2) 内部実装をOAuth 2.0 フレームワークに基づくもの</li> </ul> <h3 id="p33">p.33</h3> <blockquote> <p>成功は、独立してドメインに専念する開発チームから生まれます。各チームは自分たちのドメインに固有のアイデアを試行します。計測可能な体験と価値を生み出すためにソフトウェアを構築してテストします。そして、ソフトウェアを顧客にリリースし、質の高いユーザー体験を確保しながら結果を注視して管理します</p> </blockquote> <p>これは恐らく下記の意味だと思う。</p> <p>成功は、独立してドメインに専念する<strong>アプリケーション</strong>開発チームから生まれます。各チームは自分たちのドメインに固有のアイデアを試行します。計測可能な体験と価値を生み出すためにソフトウェアを構築してテストします。そして、ソフトウェアを<strong>社外</strong>顧客にリリースし、質の高いユーザー体験を確保しながら結果を注視して管理します</p> <h3 id="p80">p.80</h3> <p>「認知負荷の増加は10%以内」はどう計測するんだろう。 p.82には「認知負荷の影響を評価する体系的な手法が存在します」とだけ書いてある。 認知心理学の分野では確立されていたりするんだろうか。</p> <p>ちなみに、複数のプラットフォームプロダクトが時間差でリリースされた場合、認知負荷の変化がどのプロダクトによるものなのかわからなくなりそう。 成功指標の計測を徹底している組織では、同じ認知コンテキストに影響する変更が一つづつになるよう、リリース管理するんだろうか？</p> <h3 id="p89-表31-32">p.89 表3.1, 3.2</h3> <p>これらの情報は表で表してはいけない（同じ行間を比較したくなる）。 実査には下記のように、単なるリストで表示するのが正しい。</p> <p>表3.1</p> <ul> <li>計画 <ul> <li>開発者の関与</li> <li>顧客フィードバックループ</li> <li>&hellip;</li> </ul> </li> <li>設計</li> <li>コード</li> <li>ビルド</li> </ul> <p>表3.2</p> <ul> <li>テスト <ul> <li>テストの種類</li> <li>テスト自動化</li> <li>&hellip;</li> </ul> </li> <li>リリース</li> <li>監視</li> <li>運用</li> </ul> <h3 id="p138">p.138</h3> <blockquote> <p>5.2.1 エンドユーザーのアクセス体験</p> </blockquote> <p>エンドユーザーとは、プラットフォームサービスとしてのオブザーバービリティ機能を利用する社内開発者ユーザーのこと。 個人的には「エンド」と付くと本当の末端（会社が提供しているプロダクトのユーザー）をイメージしてしまうので紛らわしく感じる。</p> <h3 id="p139">p.139</h3> <blockquote> <p>5.2.2 顧客データの自動収集</p> </blockquote> <p>ここの「顧客」とは社内開発者ユーザーのことだと思う。 判断根拠は、p.140に「アプリケーションチームは、自分たちのデータがどのように収集され保存されるかという内部の仕組みを気にせず済みます」とあること。 よって「<strong>自分たちの</strong>データ」とは「自分たちが<strong>所有する</strong>データ」の意味であって、「自分たちが<strong>生成した</strong>データ」ではないはず。 従って、実際にはデータの中身は会社が提供しているサービスのユーザーのアクセスデータなどが含まれているはず。</p> <h3 id="p186-図614">p.186 図6.14</h3> <ul> <li>誤: my-orb/name of job-in-orb</li> <li>正: my-orb/name-of-command-in-orb</li> </ul> <h3 id="p193-図616">p.193 図6.16</h3> <p>「エンジニアリングプラットフォームドメイン」が指しているのはたぶん「EPステートアカウント」配下なんだろう。 「EPステートアカウント」は「Engineering Platformステートアカウント」と思われる。 「EP非本番アカウント」と「EP本番アカウント」はプラットフォームの社内顧客が使うんだと思う。 「domain-nameアカウント」はどこかのチームが何かの用途に使っているアカウントとの関係を示しているだけで、これらの解説は恐らく本書には出て来ていない。</p> <h3 id="p214">p.214</h3> <blockquote> <p>このドメインは、同じくクラウドアカウントレベルの設定を扱う点で前のドメインと似ている</p> </blockquote> <p>これは下記の意味:</p> <p>「この概念は、同じくクラウドアカウントレベルの設定を扱う点で、前章（6.4）で説明したクラウド管理IDと似ている」</p> <h3 id="p275">p.275</h3> <blockquote> <p>エンジニアリングプラットフォームプロダクトのリーダー層に直接属さないチームも含めて作業を分担せざるを得ない圧力もかかる</p> </blockquote> <p>これは恐らく下記の意味:</p> <p>「直接属さないチームも含めて作業を分担せざるを得ない圧力が、エンジニアリングプラットフォームプロダクトチームのリーダー層にかかる」</p> <blockquote> <p>両者の違いをもう一度見てみましょう</p> </blockquote> <p>「もう一度」とあるが初出と思われる。</p> <h3 id="p276">p.276</h3> <blockquote> <p>エクステンション</p> </blockquote> <p>私は「サービス」「エクステンション」という分類にあまり馴染みがなかったが、本書が示す分類基準でいえば、例えばCrossplaneは恐らく「エクステンション」に分類されるのだろう。</p> <h3 id="p340-図911">p.340 図9.11</h3> <p>図中に見慣れない黒い点があるが&hellip;ストリームイベントを示している？</p> <h3 id="p344-図915">p.344 図9.15</h3> <p>2本の垂直線の太さが同じだが、恐らく左はy軸、右はリリースイベントがあったx軸上の位置を示すものと思われる。</p> <h2 id="所感">所感</h2> <p>本書を読むと、自チームでも適用 or 参考にしたくなるものが何かしら見つかるのではないかと思う。</p> <div class="footnotes" role="doc-endnotes"> <hr> <ol> <li id="fn:1"> <p><a href="https://www.oreilly.co.jp/books/9784814401413/">Camille Fournier, Ian Nowland (2025) &ldquo;プラットフォームエンジニアリング―成功するプラットフォームとチームを作るガイドライン&rdquo;　オライリー・ジャパン</a>&#160;<a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> </ol> </div> https://rindrics.com/posts/platform-engineering-conferences/ Sat, 22 Aug 2026 00:00:00 +0900 https://rindrics.com/posts/platform-engineering-conferences/ <p>今後開催されるプラットフォームエンジニアリング関連カンファレンスのスケジュールと過去実績の統計。</p> <p>内側が国内、外側が国外で開催されるカンファレンス。</p> <ul> <li>密度曲線: 開催日およびCfPの過去実績（前後7日の移動平均）</li> <li>点: 今後の開催日およびCfP締切。黄枠の青点はCfP未クローズの開催日</li> </ul> <div class="conferences-seasonal" id="conferences-seasonal-0" data-chart-data="conferences-seasonal-0-data"> <div class="conferences-seasonal__chart" role="group" aria-label="カンファレンス開催日と CFP 受付期間の年間密度"></div> <div class="conferences-seasonal__tooltip" hidden></div> <div class="conferences-seasonal__legend" aria-hidden="true"> <span><i class="conferences-seasonal__swatch conferences-seasonal__swatch--conference"></i>開催日</span> <span><i class="conferences-seasonal__swatch conferences-seasonal__swatch--cfp"></i>CFP締切</span> </div> </div> <script type="application/json" id="conferences-seasonal-0-data">[{"cfp":null,"conference":{"from":"2024-03-02","to":"2024-03-02"},"country":"JP","id":"jaws-days-2024","name":"JAWS DAYS 2024","region":"domestic","tags":["AWS","Cloud","Infrastructure"],"url":"https://jawsdays2024.jaws-ug.jp/"},{"cfp":{"to":"2023-10-31"},"conference":{"from":"2024-03-18","to":"2024-03-20"},"country":"US","id":"srecon-americas-2024","name":"SREcon Americas 2024","region":"international","tags":["SRE","Reliability","Observability"],"url":"https://www.usenix.org/conference/srecon24americas"},{"cfp":null,"conference":{"from":"2024-03-19","to":"2024-03-22"},"country":"FR","id":"kubecon-europe-2024","name":"KubeCon + CloudNativeCon Europe Paris 2024","region":"international","tags":["Kubernetes","Cloud Native","Platform Engineering","Observability"],"url":"https://events.linuxfoundation.org/archive/2024/kubecon-cloudnativecon-europe/"},{"cfp":{"to":"2024-02-20"},"conference":{"from":"2024-04-09","to":"2024-04-10"},"country":"NL","id":"grafanacon-2024-amsterdam","name":"GrafanaCON Amsterdam 2024","region":"international","tags":["Grafana","Observability","Prometheus"],"url":"https://grafana.com/events/grafanacon/2024/"},{"cfp":{"to":"2024-03-01"},"conference":{"from":"2024-04-16","to":"2024-04-17"},"country":"JP","id":"devopsdays-tokyo-2024","name":"DevOpsDays Tokyo 2024","region":"domestic","tags":["DevOps","Platform Engineering"],"url":"https://www.devopsdaystokyo.org/2024"},{"cfp":null,"conference":{"from":"2024-06-08","to":"2024-06-08"},"country":"JP","id":"go-conference-japan-2024","name":"Go Conference 2024","region":"domestic","tags":["Go","Developer Experience"],"url":"https://gocon.jp/2024/"},{"cfp":{"to":"2024-02-26"},"conference":{"from":"2024-06-10","to":"2024-06-14"},"country":null,"id":"platformcon-2024","name":"PlatformCon 2024","region":"international","tags":["Platform Engineering","Developer Experience"],"url":"https://2024.platformcon.com/"},{"cfp":null,"conference":{"from":"2024-06-15","to":"2024-06-15"},"country":"JP","id":"cloudnative-days-2024-summer","name":"CloudNative Days Summer 2024","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://cloudnativedays.jp/cnds2024"},{"cfp":null,"conference":{"from":"2024-06-16","to":"2024-06-16"},"country":"JP","id":"jjug-ccc-2024-spring","name":"JJUG CCC 2024 Spring","region":"domestic","tags":["Java","JVM","Spring","Developer Experience"],"url":"https://ccc2024spring.java-users.jp/"},{"cfp":null,"conference":{"from":"2024-06-20","to":"2024-06-21"},"country":"JP","id":"aws-summit-japan-2024","name":"AWS Summit Japan 2024","region":"domestic","tags":["AWS","Cloud","Infrastructure"],"url":"https://aws.amazon.com/jp/blogs/news/aws-jam-report-aws-summit-japan-2024/"},{"cfp":null,"conference":{"from":"2024-06-22","to":"2024-06-22"},"country":"JP","id":"kotlin-fest-2024","name":"Kotlin Fest 2024","region":"domestic","tags":["Kotlin","JVM","Developer Experience"],"url":"https://2024.kotlinfest.dev/"},{"cfp":null,"conference":{"from":"2024-06-25","to":"2024-06-26"},"country":"US","id":"datadog-dash-2024-new-york","name":"DASH New York 2024","region":"international","tags":["Datadog","Observability"],"url":"https://dash.datadoghq.com/2024/"},{"cfp":null,"conference":{"from":"2024-06-25","to":"2024-06-25"},"country":"US","id":"opentelemetry-community-day-2024-seattle","name":"OpenTelemetry Community Day Seattle 2024","region":"international","tags":["OpenTelemetry","Observability"],"url":"https://events.linuxfoundation.org/archive/2024/open-telemetry-community-day/"},{"cfp":{"from":"2024-03-22","to":"2024-04-26"},"conference":{"from":"2024-07-09","to":"2024-07-09"},"country":"JP","id":"platform-engineering-kaigi-2024","name":"Platform Engineering Kaigi 2024","region":"domestic","tags":["Platform Engineering","Developer Experience"],"url":"https://www.cnia.io/pek2024"},{"cfp":null,"conference":{"from":"2024-07-11","to":"2024-07-12"},"country":"JP","id":"db-tech-showcase-2024-tokyo","name":"db tech showcase 東京 2024","region":"domestic","tags":["Database","Data"],"url":"https://www.db-tech-showcase.com/2024/"},{"cfp":null,"conference":{"from":"2024-08-03","to":"2024-08-04"},"country":"JP","id":"sre-next-2024","name":"SRE NEXT 2024","region":"domestic","tags":["SRE","Observability"],"url":"https://sre-next.dev/2024/"},{"cfp":null,"conference":{"from":"2024-10-27","to":"2024-10-27"},"country":"JP","id":"jjug-ccc-2024-fall","name":"JJUG CCC 2024 Fall","region":"domestic","tags":["Java","JVM","Spring","Developer Experience"],"url":"https://ccc2024fall.java-users.jp/"},{"cfp":{"to":"2024-06-13"},"conference":{"from":"2024-10-29","to":"2024-10-31"},"country":"IE","id":"srecon-emea-2024","name":"SREcon EMEA 2024","region":"international","tags":["SRE","Reliability","Observability"],"url":"https://www.usenix.org/conference/srecon24emea"},{"cfp":{"to":"2024-06-09"},"conference":{"from":"2024-11-12","to":"2024-11-15"},"country":"US","id":"kubecon-north-america-2024","name":"KubeCon + CloudNativeCon North America 2024","region":"international","tags":["Kubernetes","Cloud Native","Platform Engineering","Observability"],"url":"https://events.linuxfoundation.org/archive/2024/kubecon-cloudnativecon-north-america/"},{"cfp":null,"conference":{"from":"2024-11-28","to":"2024-11-29"},"country":"JP","id":"cloudnative-days-2024-winter","name":"CloudNative Days Winter 2024","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://cloudnativedays.jp/cndw2024"},{"cfp":{"from":"2024-09-04","to":"2024-09-30"},"conference":{"from":"2025-01-26","to":"2025-01-26"},"country":"JP","id":"sre-kaigi-2025","name":"SRE Kaigi 2025","region":"domestic","tags":["SRE"],"url":"https://2025.srekaigi.net/"},{"cfp":{"from":"2024-12-16","to":"2025-01-09"},"conference":{"from":"2025-03-01","to":"2025-03-01"},"country":"JP","id":"jaws-days-2025","name":"JAWS DAYS 2025","region":"domestic","tags":["AWS","Cloud","Infrastructure"],"url":"https://jawsdays2025.jaws-ug.jp/"},{"cfp":null,"conference":{"from":"2025-03-18","to":"2025-03-20"},"country":"US","id":"javaone-2025","name":"JavaOne 2025","region":"international","tags":["Java","JVM","Developer Experience"],"url":"https://www.oracle.com/javaone/"},{"cfp":{"to":"2024-11-04"},"conference":{"from":"2025-03-25","to":"2025-03-27"},"country":"US","id":"srecon-americas-2025","name":"SREcon Americas 2025","region":"international","tags":["SRE","Reliability","Observability"],"url":"https://www.usenix.org/conference/srecon25americas"},{"cfp":{"to":"2024-11-24"},"conference":{"from":"2025-04-01","to":"2025-04-04"},"country":"GB","id":"kubecon-europe-2025","name":"KubeCon + CloudNativeCon Europe London 2025","region":"international","tags":["Kubernetes","Cloud Native","Platform Engineering","Observability"],"url":"https://events.linuxfoundation.org/archive/2025/kubecon-cloudnativecon-europe/"},{"cfp":{"to":"2025-03-01"},"conference":{"from":"2025-04-15","to":"2025-04-17"},"country":"JP","id":"devopsdays-tokyo-2025","name":"DevOpsDays Tokyo 2025","region":"domestic","tags":["DevOps","Platform Engineering"],"url":"https://www.devopsdaystokyo.org/2025"},{"cfp":{"to":"2025-01-30"},"conference":{"from":"2025-05-06","to":"2025-05-08"},"country":"US","id":"grafanacon-2025-seattle","name":"GrafanaCON Seattle 2025","region":"international","tags":["Grafana","Observability","Prometheus"],"url":"https://grafana.com/blog/save-the-date-grafanacon-2025-is-coming-to-seattle-in-may/"},{"cfp":null,"conference":{"from":"2025-05-23","to":"2025-05-23"},"country":"JP","id":"cloudnative-days-2025-summer","name":"CloudNative Days Summer 2025","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://cloudnativedays.jp/cnds2025"},{"cfp":null,"conference":{"from":"2025-06-07","to":"2025-06-07"},"country":"JP","id":"jjug-ccc-2025-spring","name":"JJUG CCC 2025 Spring","region":"domestic","tags":["Java","JVM","Spring","Developer Experience"],"url":"https://ccc2025spring.java-users.jp/"},{"cfp":null,"conference":{"from":"2025-06-10","to":"2025-06-11"},"country":"US","id":"datadog-dash-2025-new-york","name":"DASH New York 2025","region":"international","tags":["Datadog","Observability"],"url":"https://dash.datadoghq.com/2025/"},{"cfp":{"to":"2025-02-02"},"conference":{"from":"2025-06-16","to":"2025-06-17"},"country":"JP","id":"kubecon-japan-2025","name":"KubeCon + CloudNativeCon Japan 2025","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://events.linuxfoundation.org/archive/2025/kubecon-cloudnativecon-japan/"},{"cfp":{"to":"2025-02-23"},"conference":{"from":"2025-06-23","to":"2025-06-27"},"country":null,"id":"platformcon-2025","name":"PlatformCon 2025","region":"international","tags":["Platform Engineering","Developer Experience"],"url":"https://2025.platformcon.com/"},{"cfp":null,"conference":{"from":"2025-06-25","to":"2025-06-26"},"country":"JP","id":"aws-summit-japan-2025","name":"AWS Summit Japan 2025","region":"domestic","tags":["AWS","Cloud","Infrastructure"],"url":"https://aws.amazon.com/jp/blogs/news/aws-summit-japan-2025-resilience/"},{"cfp":{"to":"2025-03-28"},"conference":{"from":"2025-06-26","to":"2025-06-26"},"country":"US","id":"opentelemetry-community-day-2025-denver","name":"OpenTelemetry Community Day Denver 2025","region":"international","tags":["OpenTelemetry","Observability"],"url":"https://events.linuxfoundation.org/open-observability-summit-otel-community-day/"},{"cfp":null,"conference":{"from":"2025-07-10","to":"2025-07-11"},"country":"JP","id":"db-tech-showcase-2025-tokyo","name":"db tech showcase 東京 2025","region":"domestic","tags":["Database","Data"],"url":"https://db-tech-showcase.com/"},{"cfp":null,"conference":{"from":"2025-07-11","to":"2025-07-12"},"country":"JP","id":"sre-next-2025","name":"SRE NEXT 2025","region":"domestic","tags":["SRE","Observability"],"url":"https://sre-next.dev/2025/"},{"cfp":{"from":"2025-01-20","to":"2025-03-03"},"conference":{"from":"2025-08-25","to":"2025-08-28"},"country":"US","id":"gophercon-2025","name":"GopherCon 2025","region":"international","tags":["Go","Developer Experience"],"url":"https://vendelux.com/app/event/gophercon-2025/03a33004-1b60-44d5-8092-1617faa3f9dd"},{"cfp":{"from":"2025-06-04","to":"2025-07-02"},"conference":{"from":"2025-09-18","to":"2025-09-18"},"country":"JP","id":"platform-engineering-kaigi-2025","name":"Platform Engineering Kaigi 2025","region":"domestic","tags":["Platform Engineering","Developer Experience"],"url":"https://www.cnia.io/pek2025"},{"cfp":null,"conference":{"from":"2025-09-27","to":"2025-09-28"},"country":"JP","id":"go-conference-japan-2025","name":"Go Conference 2025","region":"domestic","tags":["Go","Developer Experience"],"url":"https://gocon.jp/2025/"},{"cfp":{"to":"2025-05-21"},"conference":{"from":"2025-10-07","to":"2025-10-09"},"country":"IE","id":"srecon-emea-2025","name":"SREcon EMEA 2025","region":"international","tags":["SRE","Reliability","Observability"],"url":"https://www.usenix.org/conference/srecon25emea"},{"cfp":{"from":"2025-05-29","to":"2025-07-07"},"conference":{"from":"2025-11-01","to":"2025-11-01"},"country":"JP","id":"kotlin-fest-2025","name":"Kotlin Fest 2025","region":"domestic","tags":["Kotlin","JVM","Developer Experience"],"url":"https://2025.kotlinfest.dev/"},{"cfp":{"to":"2025-05-27"},"conference":{"from":"2025-11-10","to":"2025-11-13"},"country":"US","id":"kubecon-north-america-2025","name":"KubeCon + CloudNativeCon North America 2025","region":"international","tags":["Kubernetes","Cloud Native","Platform Engineering","Observability"],"url":"https://events.linuxfoundation.org/archive/2025/kubecon-cloudnativecon-north-america/"},{"cfp":null,"conference":{"from":"2025-11-15","to":"2025-11-15"},"country":"JP","id":"jjug-ccc-2025-fall","name":"JJUG CCC 2025 Fall","region":"domestic","tags":["Java","JVM","Spring","Developer Experience"],"url":"https://ccc2025fall.java-users.jp/"},{"cfp":null,"conference":{"from":"2025-11-18","to":"2025-11-19"},"country":"JP","id":"cloudnative-days-2025-winter","name":"CloudNative Days Winter 2025","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://cloudnativedays.jp/cndw2025"},{"cfp":{"from":"2025-09-04"},"conference":{"from":"2026-01-31","to":"2026-01-31"},"country":"JP","id":"sre-kaigi-2026","name":"SRE Kaigi 2026","region":"domestic","tags":["SRE"],"url":"https://2026.srekaigi.net/"},{"cfp":{"from":"2025-11-20","to":"2025-12-18"},"conference":{"from":"2026-03-07","to":"2026-03-07"},"country":"JP","id":"jaws-days-2026","name":"JAWS DAYS 2026","region":"domestic","tags":["AWS","Cloud","Infrastructure"],"url":"https://jawsdays2026.jaws-ug.jp/"},{"cfp":null,"conference":{"from":"2026-03-17","to":"2026-03-19"},"country":"US","id":"javaone-2026","name":"JavaOne 2026","region":"international","tags":["Java","JVM","Developer Experience"],"url":"https://www.oracle.com/javaone/"},{"cfp":{"to":"2025-10-12"},"conference":{"from":"2026-03-23","to":"2026-03-26"},"country":"NL","id":"kubecon-europe-2026","name":"KubeCon + CloudNativeCon Europe Amsterdam 2026","region":"international","tags":["Kubernetes","Cloud Native","Platform Engineering","Observability"],"url":"https://events.linuxfoundation.org/archive/2026/kubecon-cloudnativecon-europe/"},{"cfp":{"to":"2025-11-04"},"conference":{"from":"2026-03-24","to":"2026-03-26"},"country":"US","id":"srecon-americas-2026","name":"SREcon Americas 2026","region":"international","tags":["SRE","Reliability","Observability"],"url":"https://www.usenix.org/conference/srecon26americas"},{"cfp":{"from":"2025-11-01","to":"2026-03-01"},"conference":{"from":"2026-04-14","to":"2026-04-16"},"country":"JP","id":"devopsdays-tokyo-2026","name":"DevOpsDays Tokyo 2026","region":"domestic","tags":["DevOps","Platform Engineering"],"url":"https://devopsdays.org/events/2026-tokyo/welcome/"},{"cfp":{"to":"2026-01-19"},"conference":{"from":"2026-04-20","to":"2026-04-22"},"country":"ES","id":"grafanacon-2026-barcelona","name":"GrafanaCON Barcelona 2026","region":"international","tags":["Grafana","Observability","Prometheus"],"url":"https://grafana.com/events/grafanacon/"},{"cfp":null,"conference":{"from":"2026-05-14","to":"2026-05-15"},"country":"JP","id":"cloudnative-days-2026-nagoya","name":"クラウドネイティブ会議 2026 名古屋","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://kaigi.cloudnativedays.jp/"},{"cfp":null,"conference":{"from":"2026-05-30","to":"2026-05-30"},"country":"JP","id":"jjug-ccc-2026-spring","name":"JJUG CCC 2026 Spring","region":"domestic","tags":["Java","JVM","Spring","Developer Experience"],"url":"https://ccc2026spring.java-users.jp/"},{"cfp":null,"conference":{"from":"2026-06-09","to":"2026-06-10"},"country":"US","id":"datadog-dash-2026-new-york","name":"DASH New York 2026","region":"international","tags":["Datadog","Observability"],"url":"https://dash.datadoghq.com/"},{"cfp":{"to":"2026-02-22"},"conference":{"from":"2026-06-22","to":"2026-06-26"},"country":null,"id":"platformcon-2026","name":"PlatformCon 2026","region":"international","tags":["Platform Engineering","Developer Experience"],"url":"https://2026.platformcon.com/"},{"cfp":null,"conference":{"from":"2026-06-25","to":"2026-06-26"},"country":"JP","id":"aws-summit-japan-2026","name":"AWS Summit Japan 2026","region":"domestic","tags":["AWS","Cloud","Infrastructure"],"url":"https://aws.amazon.com/jp/events/summits/japan/"},{"cfp":null,"conference":{"from":"2026-07-10","to":"2026-07-11"},"country":"JP","id":"sre-next-2026","name":"SRE NEXT 2026","region":"domestic","tags":["SRE","Observability"],"url":"https://sre-next.dev/2026/"},{"cfp":{"to":"2026-03-29"},"conference":{"from":"2026-07-28","to":"2026-07-30"},"country":"JP","id":"kubecon-japan-2026","name":"KubeCon + CloudNativeCon Japan 2026","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://events.linuxfoundation.org/kubecon-cloudnativecon-japan/"},{"cfp":{"from":"2026-01-19","to":"2026-03-04"},"conference":{"from":"2026-08-03","to":"2026-08-06"},"country":"US","id":"gophercon-2026","name":"GopherCon 2026","region":"international","tags":["Go","Developer Experience"],"url":"https://www.gophercon.com/"},{"cfp":{"from":"2026-05-15","to":"2026-06-15"},"conference":{"from":"2026-09-11","to":"2026-09-11"},"country":"JP","id":"go-conference-japan-2026","name":"Go Conference 2026","region":"domestic","tags":["Go","Developer Experience"],"url":"https://gocon.jp/"},{"cfp":{"from":"2026-06-23","to":"2026-07-20"},"conference":{"from":"2026-09-26","to":"2026-09-26"},"country":"JP","id":"platform-engineering-kaigi-2026","name":"Platform Engineering Kaigi 2026","region":"domestic","tags":["Platform Engineering","Developer Experience"],"url":"https://www.cnia.io/pek2026/"},{"cfp":{"to":"2026-05-27"},"conference":{"from":"2026-10-13","to":"2026-10-15"},"country":"IE","id":"srecon-emea-2026","name":"SREcon EMEA 2026","region":"international","tags":["SRE","Reliability","Observability"],"url":"https://www.usenix.org/conference/srecon26emea"},{"cfp":{"to":"2026-05-31"},"conference":{"from":"2026-11-09","to":"2026-11-12"},"country":"US","id":"kubecon-north-america-2026","name":"KubeCon + CloudNativeCon North America 2026","region":"international","tags":["Kubernetes","Cloud Native","Platform Engineering","Observability"],"url":"https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/"},{"cfp":{"from":"2026-06-08","to":"2026-07-12"},"conference":{"from":"2026-11-14","to":"2026-11-14"},"country":"JP","id":"kotlin-fest-2026","name":"Kotlin Fest 2026","region":"domestic","tags":["Kotlin","JVM","Developer Experience"],"url":"https://2026.kotlinfest.dev/"},{"cfp":{"from":"2026-08-31","to":"2026-09-20"},"conference":{"from":"2026-11-19","to":"2026-11-20"},"country":"JP","id":"cloudnative-days-2026-winter","name":"CloudNative Days Winter 2026","region":"domestic","tags":["Cloud Native","Platform Engineering"],"url":"https://event.cloudnativedays.jp/cndw2026"},{"cfp":null,"conference":{"from":"2027-02-20","to":"2027-02-20"},"country":"JP","id":"sre-kaigi-2027","name":"SRE Kaigi 2027","region":"domestic","tags":["SRE"],"url":"https://blog.srekaigi.net/entry/2026/07/22/114937"},{"cfp":null,"conference":{"from":"2027-07-09","to":"2027-07-10"},"country":"JP","id":"sre-next-2027","name":"SRE NEXT 2027","region":"domestic","tags":["SRE","Observability"],"url":"https://sre-next.dev/2027/"}]</script> <style> .slider-switch { position: relative; width: 60px; height: 28px; background-color: #ddd; border-radius: 28px; cursor: pointer; transition: background-color 0.3s; display: inline-block; } .slider-switch.international { background-color: #0066cc; } .slider-switch::after { content: ''; position: absolute; height: 24px; width: 24px; left: 2px; top: 2px; background-color: white; border-radius: 50%; transition: transform 0.3s; } .slider-switch.international::after { transform: translateX(32px); } .region-label { font-size: 0.9rem; font-weight: 500; min-width: 40px; text-align: center; } .region-label.active { color: #0066cc; font-weight: bold; } </style> <div id="conferences-filter-container" style="margin-bottom: 2rem;"> <div style="display: flex; align-items: center; gap: 0.5rem; margin-bottom: 0.75rem;"> <span class="region-label active" id="region-label-domestic">国内</span> <div class="slider-switch" id="region-slider-display"></div> <span class="region-label" id="region-label-international">海外</span> </div> <div style="display: flex; gap: 1.25rem; flex-wrap: wrap; align-items: center; margin-bottom: 1rem;"> <div style="display: flex; align-items: center; gap: 0.5rem;"> <select id="tag-filter" style="padding: 0.5rem; border: 1px solid #ccc; border-radius: 4px;"> <option value="">すべてのタグ</option> </select> </div> <div style="display: flex; align-items: center; gap: 0.5rem;"> <label for="cfp-month-filter" style="font-size: 0.9rem; white-space: nowrap;">CfP 締切</label> <select id="cfp-month-filter" style="padding: 0.5rem; border: 1px solid #ccc; border-radius: 4px;"> <option value="">すべての月</option> </select> </div> <div style="display: flex; align-items: center; gap: 0.5rem;"> <label for="conference-month-filter" style="font-size: 0.9rem; white-space: nowrap;">開催日</label> <select id="conference-month-filter" style="padding: 0.5rem; border: 1px solid #ccc; border-radius: 4px;"> <option value="">すべての月</option> </select> </div> </div> <div style="margin-bottom: 1rem; font-size: 0.9rem; color: #666;"> 該当: <span id="result-count">0</span> 件 </div> </div> <div style="max-height: 500px; overflow-y: auto; border: 1px solid #ddd; border-radius: 4px;"> <table style="width: 100%; border-collapse: collapse; margin: 0;"> <thead> <tr style="background: #f5f5f5; border-bottom: 2px solid #ddd; position: sticky; top: 0;"> <th style="padding: 0.25rem; text-align: center; border: 1px solid #ddd;">イベント</th> <th style="padding: 0.25rem; text-align: center; border: 1px solid #ddd;">CfP締切</th> <th style="padding: 0.25rem; text-align: center; border: 1px solid #ddd;">開催時期</th> </tr> </thead> <tbody id="conferences-tbody"> <tr class="conf-row" data-region="international" data-tags="Go,Developer Experience" data-conf-from="2026-08-03" data-conf-to="2026-08-06" data-cfp-from="2026-01-19" data-cfp-to="2026-03-04" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://www.gophercon.com/" target="_blank">GopherCon 2026</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">Go</span><span class="tag-label" style="white-space: nowrap;">Developer Experience</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> <span class="cfp-date-display" data-date="2026-03-04"></span> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="domestic" data-tags="Go,Developer Experience" data-conf-from="2026-09-11" data-conf-to="2026-09-11" data-cfp-from="2026-05-15" data-cfp-to="2026-06-15" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://gocon.jp/" target="_blank">Go Conference 2026</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">Go</span><span class="tag-label" style="white-space: nowrap;">Developer Experience</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> <span class="cfp-date-display" data-date="2026-06-15"></span> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="domestic" data-tags="Platform Engineering,Developer Experience" data-conf-from="2026-09-26" data-conf-to="2026-09-26" data-cfp-from="2026-06-23" data-cfp-to="2026-07-20" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://www.cnia.io/pek2026/" target="_blank">Platform Engineering Kaigi 2026</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">Platform Engineering</span><span class="tag-label" style="white-space: nowrap;">Developer Experience</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> <span class="cfp-date-display" data-date="2026-07-20"></span> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="international" data-tags="SRE,Reliability,Observability" data-conf-from="2026-10-13" data-conf-to="2026-10-15" data-cfp-from="" data-cfp-to="2026-05-27" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://www.usenix.org/conference/srecon26emea" target="_blank">SREcon EMEA 2026</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">SRE</span><span class="tag-label" style="white-space: nowrap;">Reliability</span><span class="tag-label" style="white-space: nowrap;">Observability</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> <span class="cfp-date-display" data-date="2026-05-27"></span> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="international" data-tags="Kubernetes,Cloud Native,Platform Engineering,Observability" data-conf-from="2026-11-09" data-conf-to="2026-11-12" data-cfp-from="" data-cfp-to="2026-05-31" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/" target="_blank">KubeCon &#43; CloudNativeCon North America 2026</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">Kubernetes</span><span class="tag-label" style="white-space: nowrap;">Cloud Native</span><span class="tag-label" style="white-space: nowrap;">Platform Engineering</span><span class="tag-label" style="white-space: nowrap;">Observability</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> <span class="cfp-date-display" data-date="2026-05-31"></span> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="domestic" data-tags="Kotlin,JVM,Developer Experience" data-conf-from="2026-11-14" data-conf-to="2026-11-14" data-cfp-from="2026-06-08" data-cfp-to="2026-07-12" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://2026.kotlinfest.dev/" target="_blank">Kotlin Fest 2026</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">Kotlin</span><span class="tag-label" style="white-space: nowrap;">JVM</span><span class="tag-label" style="white-space: nowrap;">Developer Experience</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> <span class="cfp-date-display" data-date="2026-07-12"></span> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="domestic" data-tags="Cloud Native,Platform Engineering" data-conf-from="2026-11-19" data-conf-to="2026-11-20" data-cfp-from="2026-08-31" data-cfp-to="2026-09-20" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://event.cloudnativedays.jp/cndw2026" target="_blank">CloudNative Days Winter 2026</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">Cloud Native</span><span class="tag-label" style="white-space: nowrap;">Platform Engineering</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> <span class="cfp-date-display" data-date="2026-09-20"></span> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="domestic" data-tags="SRE" data-conf-from="2027-02-20" data-conf-to="2027-02-20" data-cfp-from="" data-cfp-to="" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://blog.srekaigi.net/entry/2026/07/22/114937" target="_blank">SRE Kaigi 2027</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">SRE</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> 未定 </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr class="conf-row" data-region="domestic" data-tags="SRE,Observability" data-conf-from="2027-07-09" data-conf-to="2027-07-10" data-cfp-from="" data-cfp-to="" style="border-bottom: 1px solid #ddd;"> <td style="padding: 0.35rem; border: 1px solid #ddd;"> <a href="https://sre-next.dev/2027/" target="_blank">SRE NEXT 2027</a> <div style="display: flex; flex-wrap: wrap; gap: 0.25rem; margin-top: 0.25rem; font-size: 0.65rem;"><span class="tag-label" style="white-space: nowrap;">SRE</span><span class="tag-label" style="white-space: nowrap;">Observability</span></div> </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;"> 未定 </td> <td style="padding: 0.35rem; border: 1px solid #ddd; font-size: 0.9rem; text-align: center;" class="conf-date-cell"> <span class="conf-date-display"></span> </td> </tr> <tr id="conferences-empty-row" style="display: none;"> <td colspan="3" style="padding: 1rem; border: 1px solid #ddd; text-align: center; color: #666;">表示するデータがありません</td> </tr> </tbody> </table> </div> <script> (function() { let currentFilters = { region: 'domestic', tag: '', cfpMonth: '', conferenceMonth: '' }; function monthsCovered(fromStr, toStr) { const months = new Set(); if (!fromStr) { return months; } const start = new Date(`${fromStr}T00:00:00Z`); const end = new Date(`${toStr || fromStr}T00:00:00Z`); const cursor = new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), 1)); while (cursor <= end) { months.add(String(cursor.getUTCMonth() + 1)); cursor.setUTCMonth(cursor.getUTCMonth() + 1); } return months; } const allTags = new Set(); document.querySelectorAll('.conf-row').forEach(row => { const tags = row.dataset.tags.split(',').filter(t => t); tags.forEach(tag => allTags.add(tag)); }); const tagSelect = document.getElementById('tag-filter'); Array.from(allTags).sort().forEach(tag => { const option = document.createElement('option'); option.value = tag; option.textContent = tag; tagSelect.appendChild(option); }); const monthSelects = [ document.getElementById('cfp-month-filter'), document.getElementById('conference-month-filter') ]; monthSelects.forEach((select) => { for (let month = 1; month <= 12; month += 1) { const option = document.createElement('option'); option.value = String(month); option.textContent = `${month}月`; select.appendChild(option); } }); function updateDisplay() { const rows = document.querySelectorAll('.conf-row'); let visibleCount = 0; rows.forEach(row => { const region = row.dataset.region; const tags = row.dataset.tags.split(',').filter(t => t); const cfpFrom = row.dataset.cfpFrom; const cfpTo = row.dataset.cfpTo; const conferenceMatch = !currentFilters.conferenceMonth || monthsCovered(row.dataset.confFrom, row.dataset.confTo).has(currentFilters.conferenceMonth); const cfpMatch = !currentFilters.cfpMonth || ( Boolean(cfpFrom || cfpTo) && monthsCovered(cfpFrom || cfpTo, cfpTo || cfpFrom).has(currentFilters.cfpMonth) ); let regionMatch = region === currentFilters.region; let tagMatch = !currentFilters.tag || tags.includes(currentFilters.tag); if (regionMatch && tagMatch && conferenceMatch && cfpMatch) { row.style.display = ''; visibleCount++; } else { row.style.display = 'none'; } }); document.getElementById('result-count').textContent = visibleCount; document.getElementById('conferences-empty-row').style.display = visibleCount === 0 ? '' : 'none'; } const regionSlider = document.getElementById('region-slider-display'); regionSlider.addEventListener('click', function() { if (currentFilters.region === 'domestic') { currentFilters.region = 'international'; document.getElementById('region-label-domestic').classList.remove('active'); document.getElementById('region-label-international').classList.add('active'); } else { currentFilters.region = 'domestic'; document.getElementById('region-label-domestic').classList.add('active'); document.getElementById('region-label-international').classList.remove('active'); } regionSlider.classList.toggle('international'); updateDisplay(); }); document.getElementById('tag-filter').addEventListener('change', function() { currentFilters.tag = this.value; updateDisplay(); }); document.getElementById('cfp-month-filter').addEventListener('change', function() { currentFilters.cfpMonth = this.value; updateDisplay(); }); document.getElementById('conference-month-filter').addEventListener('change', function() { currentFilters.conferenceMonth = this.value; updateDisplay(); }); const weekdays = ['日', '月', '火', '水', '木', '金', '土']; document.querySelectorAll('.cfp-date-display').forEach(span => { span.textContent = span.dataset.date.replaceAll("-", "/"); }); document.querySelectorAll('.conf-date-cell').forEach(cell => { const row = cell.closest('.conf-row'); const fromStr = row.dataset.confFrom; const toStr = row.dataset.confTo; if (fromStr) { const from = new Date(fromStr + 'T00:00:00Z'); const to = new Date(toStr + 'T00:00:00Z'); const fromWeekday = weekdays[from.getUTCDay()]; const toWeekday = weekdays[to.getUTCDay()]; let displayText; if (fromStr === toStr) { displayText = `${fromStr} (${fromWeekday})`; } else { displayText = `${fromStr} (${fromWeekday}) – ${toStr} (${toWeekday})`; } const span = cell.querySelector('.conf-date-display'); if (span) { span.textContent = displayText; } } }); updateDisplay(); })(); </script> https://rindrics.com/posts/organizational-efficiency-product-delivery/ Wed, 12 Aug 2026 00:00:00 +0900 https://rindrics.com/posts/organizational-efficiency-product-delivery/ <p>&ldquo;<a href="https://cloudnativeplatforms.com/whitepapers/platforms/">CNCF Platforms White Paper</a>&rdquo; に紛らわしい箇所があったが、自分なりに理解できた気がするので、思考の整理を兼ねて言語化しておく。</p> <p>扱うテーマは &ldquo;How to measure the success of platforms&rdquo;: プラットフォームの成功を客観的・定量的に計測するためのガイドラインの部分<sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup>。</p> <p>ここで推奨されている計測対象は、下記の3カテゴリに分かれている。</p> <table> <thead> <tr> <th>カテゴリ</th> <th>指標</th> </tr> </thead> <tbody> <tr> <td>User satisfaction and productivity</td> <td>アクティブユーザーと定着率、NPS、<a href="https://queue.acm.org/detail.cfm?id=3454124">SPACE</a></td> </tr> <tr> <td>Organizational efficiency</td> <td>各種のレイテンシ（後述）</td> </tr> <tr> <td>Product and feature delivery</td> <td>DORA の（旧）4指標<sup id="fnref:2"><a href="#fn:2" class="footnote-ref" role="doc-noteref">2</a></sup></td> </tr> </tbody> </table> <p>当初、第二カテゴリと第三カテゴリの違いがいまいち腑に落ちなかった。 &ldquo;Organizational efficiency&rdquo; も &ldquo;Product and feature delivery&rdquo; も、要は効率に関する計測として一括りにできるようにも思えてしまい、別カテゴリとされる理由がわからなかった。</p> <p>それぞれについて少し注意深く読んでみると、両者の違いは、「計測しているイベントの性質」および「誰が誰を待たせているか」にあるような気がする。</p> <p>&ldquo;Product and feature delivery&rdquo; で計測するDORAの4指標はいずれも、反復的なデリバリー性能を示すものだ:</p> <ul> <li>Deployment Frequency</li> <li>Lead Time for Changes</li> <li>Change Failure Rate</li> <li>Time to Restore Service</li> </ul> <p>一方で、&ldquo;Organizational efficiency&rdquo; とされる下記の3指標は、いずれも何かが初めて実現されるまでの時間に関するメトリクスであることがわかる:</p> <table> <thead> <tr> <th>指標</th> <th>観点</th> <th>支配的な要因</th> </tr> </thead> <tbody> <tr> <td>Latency from request to fulfillment of a service or capability, such as a database or test environment</td> <td><strong>開発リソース</strong></td> <td>セルフサービス化の度合い</td> </tr> <tr> <td>Latency to build and deploy a brand new service into production</td> <td><strong>サービス</strong></td> <td>ゴールデンパスとテンプレートの整備度</td> </tr> <tr> <td>Time for a new user to submit their first code changes to their product</td> <td><strong>ヒト</strong></td> <td>ドキュメント・権限・開発環境の整備度</td> </tr> </tbody> </table> <p>これらの理解をふまえると、両カテゴリは概ね下記のように表現しても良いと思う:</p> <ul> <li>Organizational efficiency: プラットフォームが顧客である開発者を待たせている時間<sup id="fnref:3"><a href="#fn:3" class="footnote-ref" role="doc-noteref">3</a></sup></li> <li>Product and feature delivery: 組織がエンドユーザーを待たせている時間</li> </ul> <p>それぞれを計測した場合の効果については、たぶん下記のような整理になるのではと思う:</p> <ul> <li>程度の差ではあるが、プラットフォームチームの取組みの効果を純粋に見たいのであれば、実装やレビューの所要時間の影響を受ける &ldquo;Product and feature delivery&rdquo; に比べて、&ldquo;Organizational efficiency&rdquo; のほうが適しているだろう</li> <li>ただし、プラットフォームチームの取組みは組織としてのバリューストリームに関わるものになっていないとまずい。原文にもあるように &ldquo;Product and feature delivery&rdquo; のほうが &ldquo;true measure of the success of a platform&rdquo; だ。ここを外してしまうと、プラットフォームが &ldquo;an expense quite disconnected from their primary value streams&rdquo; と見なされがちになる<sup id="fnref:4"><a href="#fn:4" class="footnote-ref" role="doc-noteref">4</a></sup></li> </ul> <p>本記事を書きながら、2年ほど前に組織メトリクスに関する一過性ブーム的な盛り上がりがあったことを思い出していた。 最近は落ち着いてきた（飽きる企業が出てきた？）ように思うが、当時は組織メトリクスに対して、計測するだけで何かが起こるかのような、過度の期待があったのではないかと想像する。 組織メトリクスは、それぞれのカテゴリが何を映しているのかを踏まえた上で、必要な情報を得るための普通の手段として運用したらいい。</p> <div class="footnotes" role="doc-endnotes"> <hr> <ol> <li id="fn:1"> <p>執筆時点では &ldquo;platform engineering white paper&rdquo; で検索すると、<a href="https://tag-app-delivery.cncf.io/whitepapers/platforms/">旧サイトのドキュメント</a>（<a href="https://cloudnativeplatforms.com/whitepapers/platforms/v1/">新サイトのv1</a>相当）がトップに出てきてしまう。本記事の大半はこのあたりの事情を知らずに旧サイトのv1を読んで書いたのだが、執筆時点の最新版である<a href="https://github.com/Cloud-Native-Platform-Engineering/cnpe-community/blob/9db35ef39ff8a22ad20e97007105d87f79bc68cb/platforms-whitepaper/latest/index.md">v1.1</a>においても &ldquo;How to measure the success of platforms&rdquo; の内容は同一だった&#160;<a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> <li id="fn:2"> <p>原文が参照しているDORAの指標は2019年ごろのものなので（原文で参照されているのは<a href="https://cloud.google.com/blog/products/devops-sre/the-2019-accelerate-state-of-devops-elite-performance-productivity-and-scaling">こちら</a>だが、内容的には<a href="https://cloud.google.com/blog/products/devops-sre/using-the-four-keys-to-measure-your-devops-performance">こちら</a>のほうが適当に思える）、&ldquo;time to restore service&rdquo; の改称や第5メトリクスの追加・分類軸の変更（<a href="https://dora.dev/insights/dora-metrics-history">ref</a>）は反映されていない。 これらは次の版で取り込まれるのかもしれない&#160;<a href="#fnref:2" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> <li id="fn:3"> <p>もっとも、二つ目の &ldquo;Latency to build and deploy a brand new service into production&rdquo; と三つ目の &ldquo;Time for a new user to submit their first code changes to their product&quot;については、実装やコードレビューの所要時間も含まれうる&#160;<a href="#fnref:3" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> <li id="fn:4"> <p>ちなみに、プラットフォームの利用は個人・チーム・組織の性能を向上させる一方で、&ldquo;throughput&rdquo; と &ldquo;stability&rdquo; の各指標を低下させることが報告されている（<a href="https://dora.dev/research/2024/dora-report/2024-dora-accelerate-state-of-devops-report.pdf">ref</a>）&#160;<a href="#fnref:4" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> </ol> </div> https://rindrics.com/posts/model-the-data-not-the-interface/ Sat, 08 Aug 2026 00:00:00 +0900 https://rindrics.com/posts/model-the-data-not-the-interface/ <figure><img src="https://rindrics.com/images/2026-08-08-cms/shared-file.webp"> </figure> <p>How a simple YAML data model let me add a client-facing CMS without touching the existing implementation.</p> <h2 id="the-story">The Story</h2> <p>A client asked for a profile page featuring his career timeline. Straightforward request. I built it, deployed it, and moved on.</p> <p>Months later, he came back with a new request: he wanted to update the timeline himself—to add new positions and modify past entries.</p> <p>Until then, I had been making those changes for him. Giving him direct access to the data wasn&rsquo;t an option either: he was a non-technical user, and GitHub access was deliberately off the table.</p> <p>At first glance, adding a content management interface sounded like a change that might ripple through the existing implementation.</p> <p>It didn&rsquo;t.</p> <p>The reason went back to a small design decision I had made months earlier, before a CMS was even a consideration.</p> <h2 id="the-initial-design-choice-yaml-over-markdown">The Initial Design Choice: YAML Over Markdown</h2> <p>When I first built the profile page, I didn&rsquo;t hard-code the timeline into HTML, but I didn&rsquo;t put it in Markdown either. I started by asking what kind of content a career timeline actually is.</p> <p>A career history isn&rsquo;t really a document. It&rsquo;s structured data: a collection of dates, each associated with one or more events. So I represented it that way:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#586e75"># data/timeline.yml</span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">entries</span>: </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">date</span>: <span style="color:#2aa198">2020</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">events</span>: </span></span><span style="display:flex;"><span> - Joined the neighborhood cat council </span></span><span style="display:flex;"><span> - Took responsibility for afternoon naps </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">date</span>: <span style="color:#2aa198">2021</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">events</span>: </span></span><span style="display:flex;"><span> - Became a boss cat </span></span><span style="display:flex;"><span> - Led a team of 5 cats </span></span></code></pre></div><p>I then rendered the data with Hugo:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-html" data-lang="html"><span style="display:flex;"><span><span style="color:#586e75">&lt;!-- layouts/shortcodes/timeline.html --&gt;</span> </span></span><span style="display:flex;"><span>&lt;<span style="color:#268bd2">dl</span> class<span style="color:#719e07">=</span><span style="color:#2aa198">&#34;timeline&#34;</span>&gt; </span></span><span style="display:flex;"><span>{{ range .Site.Data.timeline.entries }} </span></span><span style="display:flex;"><span> &lt;<span style="color:#268bd2">div</span> class<span style="color:#719e07">=</span><span style="color:#2aa198">&#34;timeline-entry&#34;</span>&gt; </span></span><span style="display:flex;"><span> &lt;<span style="color:#268bd2">dt</span> class<span style="color:#719e07">=</span><span style="color:#2aa198">&#34;timeline-date&#34;</span>&gt;{{ .date }}&lt;/<span style="color:#268bd2">dt</span>&gt; </span></span><span style="display:flex;"><span> &lt;<span style="color:#268bd2">div</span> class<span style="color:#719e07">=</span><span style="color:#2aa198">&#34;timeline-events&#34;</span>&gt; </span></span><span style="display:flex;"><span> {{ range .events }} </span></span><span style="display:flex;"><span> &lt;<span style="color:#268bd2">dd</span> class<span style="color:#719e07">=</span><span style="color:#2aa198">&#34;timeline-event&#34;</span>&gt;{{ . }}&lt;/<span style="color:#268bd2">dd</span>&gt; </span></span><span style="display:flex;"><span> {{ end }} </span></span><span style="display:flex;"><span> &lt;/<span style="color:#268bd2">div</span>&gt; </span></span><span style="display:flex;"><span> &lt;/<span style="color:#268bd2">div</span>&gt; </span></span><span style="display:flex;"><span>{{ end }} </span></span><span style="display:flex;"><span>&lt;/<span style="color:#268bd2">dl</span>&gt; </span></span></code></pre></div><p>This kept both the data structure and the implementation simple.</p> <figure><img src="https://rindrics.com/images/2026-08-08-cms/rendered.webp" alt="The career timeline rendered from the YAML data"><figcaption> <p>The career timeline rendered from the YAML data</p> </figcaption> </figure> <h3 id="why-yaml-instead-of-markdown">Why YAML Instead of Markdown?</h3> <p>Many static-site workflows are Markdown-first, and for good reason. Markdown is excellent for prose: articles, documentation, and other document-shaped content. But not all content is document-shaped.</p> <p>A career timeline is fundamentally a collection of structured records: dates with associated events. The same is often true of navigation menus, pricing tables, office locations, product specifications, and similar content.</p> <p>Representing those structures as Markdown would mean making the data fit the document format rather than choosing a format that fits the data. For the timeline, YAML was the more natural representation.</p> <p>I wasn&rsquo;t thinking about CMS support at this point, nor was I trying to make the architecture extensible. I was simply representing the content in the form that best matched its nature.</p> <p>That distinction became useful later.</p> <h2 id="the-requirement-change">The Requirement Change</h2> <p>Months later, the client wanted to manage his own career history. The new editing workflow had a few constraints:</p> <ul> <li>It had to work for a non-technical user.</li> <li>GitHub access was off the table.</li> <li>Inputs needed validation: a year should be a number, and an entry should contain at least one event.</li> <li>Changes had to be committed and deployed automatically.</li> </ul> <p>The existing YAML files were already a perfectly good representation of the content. The problem wasn&rsquo;t the data model; the problem was that the only interface for changing it was a text editor and Git.</p> <p>So instead of replacing the existing content model, I added another interface to it.</p> <h2 id="the-solution-add-an-interface-not-a-new-data-model">The Solution: Add an Interface, Not a New Data Model</h2> <p>I used Decap CMS, a Git-based CMS that can map an editing UI onto files stored in a repository.</p> <p>The configuration for the timeline looked roughly like this:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#586e75"># static/admin/config.yml</span> </span></span><span style="display:flex;"><span>- <span style="color:#268bd2">label</span>: <span style="color:#2aa198">&#34;Profile&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: <span style="color:#2aa198">&#34;profile&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">files</span>: </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">label</span>: <span style="color:#2aa198">&#34;Career History&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: <span style="color:#2aa198">&#34;timeline_data&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">file</span>: <span style="color:#2aa198">&#34;data/timeline.yml&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">fields</span>: </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">label</span>: <span style="color:#2aa198">&#34;Career entries&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: <span style="color:#2aa198">&#34;entries&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">widget</span>: <span style="color:#2aa198">&#34;list&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">fields</span>: </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">label</span>: <span style="color:#2aa198">&#34;Year&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: <span style="color:#2aa198">&#34;date&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">widget</span>: <span style="color:#2aa198">&#34;number&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">value_type</span>: <span style="color:#2aa198">&#34;int&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">min</span>: <span style="color:#2aa198">1980</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">max</span>: <span style="color:#2aa198">2050</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">label</span>: <span style="color:#2aa198">&#34;Events&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: <span style="color:#2aa198">&#34;events&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">widget</span>: <span style="color:#2aa198">&#34;list&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">field</span>: </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: <span style="color:#2aa198">&#34;event&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">widget</span>: <span style="color:#2aa198">&#34;string&#34;</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">min</span>: <span style="color:#2aa198">1</span> </span></span></code></pre></div><p>Decap CMS could now present the existing data as a form suitable for the client.</p> <div class="info"><strong>Resources</strong> <p>A minimal working example is available on GitHub, with a live demo deployed on Netlify.</p> <ul> <li>Live demo: <a href="https://rindrics-model-data-not-interface.netlify.app/">https://rindrics-model-data-not-interface.netlify.app/</a></li> <li>Source: <a href="https://github.com/rindrics/examples/tree/main/model-the-data-not-the-interface">https://github.com/rindrics/examples/tree/main/model-the-data-not-the-interface</a></li> </ul></div> <p>The important part was what I didn&rsquo;t change.</p> <p>The YAML structure? ──Unchanged; The Hugo templates? ──Untouched; The site still rendered exactly the same way.</p> <p>I had simply added a new way to edit the existing data.</p> <figure><img src="https://rindrics.com/images/2026-08-08-cms/before-after.webp" alt="Before (top) and after (bottom) adding a CMS: the existing data flow remains unchanged."><figcaption> <p>Before (top) and after (bottom) adding a CMS: the existing data flow remains unchanged.</p> </figcaption> </figure> <p>No refactor, no breaking changes.</p> <h2 id="why-so-little-had-to-change">Why So Little Had to Change</h2> <p>What made this work was surprisingly simple: the editing side and the rendering side could depend on the same file-based data model.</p> <figure><img src="https://rindrics.com/images/2026-08-08-cms/shared-file.webp" alt="File-based integration via a shared data contract"><figcaption> <p>File-based integration via a shared data contract</p> </figcaption> </figure> <p>The Hugo templates depend on the structure of the YAML to render the timeline, while the Decap CMS configuration depends on the same structure to provide an editing interface. But the two sides don&rsquo;t need to know about each other: Decap CMS doesn&rsquo;t know how Hugo renders the timeline, and Hugo doesn&rsquo;t know that Decap CMS exists.</p> <p>They only agree on the shape of the data.</p> <p>The YAML structure acts as a shared data contract between authoring and publishing. Adding another way to display the same data means writing another consumer of the model; adding another way to edit it means adding another authoring interface. Neither necessarily requires changing the underlying content model.</p> <p>Of course, if the content itself changes—if a career entry suddenly needs locations, employers, categories, or relationships—the data model should change too. The point isn&rsquo;t that the model never changes; it&rsquo;s that adding an interface doesn&rsquo;t inherently require it to change.</p> <h2 id="model-the-content-for-what-it-is">Model the Content for What It Is</h2> <p>What&rsquo;s interesting to me is that none of this was planned. When I chose YAML, I wasn&rsquo;t anticipating a CMS. There was no abstraction layer waiting for future requirements, no repository interface, and no elaborate content architecture.</p> <p>I simply looked at the content and asked:</p> <p><strong>What is this thing?</strong></p> <p>The answer was structured data, so I represented it as structured data. That gave the later CMS integration a clean boundary almost for free.</p> <p>This is different from trying to future-proof a system through speculative abstraction. I didn&rsquo;t predict the future requirement; I represented the requirement I already had accurately enough that the future requirement fit naturally around it.</p> <p>This applies beyond career timelines. A blog post or an article is usually document-shaped, making Markdown a natural fit. But a timeline is a collection of records, a navigation menu is a tree, and a pricing table is a collection of products, attributes, and prices. Different kinds of content have different natural structures.</p> <p>So rather than starting with the tool—</p> <blockquote> <p>How should I write this in Markdown?</p> </blockquote> <p>—I find it more useful to start with the content:</p> <blockquote> <p>What is this content, really?</p> </blockquote> <p>The representation follows from there. Markdown is often ideal for document-shaped content. YAML, JSON, or another structured store may better represent structured content. Relational or highly dynamic data may belong in a database.</p> <p>The specific format is secondary. What matters is whether the model reflects the structure of the thing being represented.</p> <h2 id="takeaway">Takeaway</h2> <p>Adding CMS support to this site turned out to be surprisingly small—not because I had designed the system for a CMS or anticipated the requirement, and not because I had introduced abstractions to protect against future changes. I had simply modeled a career timeline as what it was: structured data.</p> <p>When the client later needed an editing interface, Decap CMS could depend on that same model while Hugo continued rendering it exactly as before. The CMS became another interface to the data, rather than a replacement for the architecture.</p> <p>That experience left me with a simple design heuristic:</p> <p><strong>Don&rsquo;t model content around the tool that happens to consume it today. Model it around what the content actually is.</strong></p> <p>In this case, the flexibility followed naturally.</p> https://rindrics.com/posts/immutable-data-registry-alloy-design/ Fri, 07 Aug 2026 00:00:00 +0900 https://rindrics.com/posts/immutable-data-registry-alloy-design/ <p><a href="../stock-assess-data-registry-1/">前回</a>に引き続き、data-registryサービスを実装していく。 今回はdatasetVersionの生成ロジック周りを設計する。</p> <h2 id="はじめに">はじめに</h2> <p><a href="https://rindrics.com/posts/stock-assess-api-contract-postmortem/#:~:text=data%20service%E3%81%AE%E3%82%88%E3%81%86%E3%81%AA%E7%8B%AC%E7%AB%8B%E3%81%97%E3%81%9F%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%81%8C%E5%BF%85%E8%A6%81%E3%81%AB%E6%80%9D%E3%82%8F%E3%82%8C%E3%82%8B">データを登録するためのサービスが必要</a>ということがわかったので、下の記事で、データ登録サービス: data-registryの構築に必要なセットアップを終え、ハンドラの実装まで完了した。 <div class="card"> <a href="https://rindrics.com/posts/stock-assess-data-registry-1/" target="_blank" rel="noopener noreferrer" class="card-link"> <div class="card-content"> <h4 class="card-title">データ登録サービスの構築 その1 | rindrics.com</h4> <span class="card-url">https://rindrics.com/posts/stock-assess-data-registry-1/</span> </div> </a> </div> </p> <p>作業の進捗は下記の通り:</p> <ul> <li><input checked="" disabled="" type="checkbox"> API契約を書く</li> <li><input checked="" disabled="" type="checkbox"> ルーティングの動作確認</li> <li><input checked="" disabled="" type="checkbox"> db セットアップ</li> <li><input checked="" disabled="" type="checkbox"> リポジトリ・ハンドラの実装</li> <li><input disabled="" type="checkbox"> datasetVersion生成ロジックの設計</li> <li><input disabled="" type="checkbox"> リファクタリング</li> <li><input disabled="" type="checkbox"> エラーハンドリングの追加</li> </ul> <p>データセットの生成ロジックは、Alloyでモデル検証しつつ設計する。</p> <h2 id="要求と要件の整理">要求と要件の整理</h2> <p>正常ケースのレスポンスとして、まずUUID形式の<code>version</code>を返してほしい旨については<a href="https://gist.github.com/rindrics/8504980873e631a7f692543090995e8e#file-gistfile1-txt-L100-L111">OpenAPI</a>に既に書いた。</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{ </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&#34;version&#34;</span>: <span style="color:#2aa198">&#34;019f8bff-a5b8-7014-bfc8-41561eaac24c&#34;</span> </span></span><span style="display:flex;"><span>} </span></span></code></pre></div><p>将来的にはもっと有用なレスポンスを返したほうがよさそうだが、ひとまずの仕様としてシンプルなこの動作について、ロジックを設計したい。</p> <p>ここで設計するのは、この文字列を何のアルゴリズムで得るかという話ではなく、この値がレスポンスとして返るまでにどんな事項を考慮しないといけないかという話。 コンシューマのユースケース支援の観点と、バックエンドサービスとしての堅牢性や処理速度をバランスさせながら考えていく。</p> <h3 id="要求requirements">要求（Requirements）</h3> <p>仕様を検討するにあたり、data-registryのコンシューマのユースケースを想定し、要求を洗い出したい。 <a href="../stock-assess-data-registry-ubiquitous-language">こちらの記事</a>で定義したユビキタス言語を使い、要求を次のように整理する:</p> <table> <thead> <tr> <th>ID</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>R001</td> <td>同一の登録要求に対して、常に同じ応答を返すこと</td> </tr> <tr> <td>R002</td> <td>同一の版に対する取得要求には、常に同じ内容を返すこと</td> </tr> <tr> <td>R003</td> <td>評価データまたはパラメータセットの登録成功後、その版を取得できること</td> </tr> <tr> <td>R004</td> <td>評価データまたはパラメータセットの登録に失敗した場合、コンシューマが失敗を検知できること</td> </tr> <tr> <td>R005</td> <td>登録要求に対して有限時間内に応答すること</td> </tr> <tr> <td>R006</td> <td>評価データ、パラメータセットまたはシナリオを、通常の利用対象から外せること</td> </tr> <tr> <td>R007</td> <td>評価データまたはパラメータセットを修正した場合でも、修正前の版を取得できること</td> </tr> <tr> <td>R008</td> <td>任意の版を指定して取得できること</td> </tr> <tr> <td>R009</td> <td>外部公開済みの版を訂正した場合でも、訂正前の版を追跡できること</td> </tr> <tr> <td>R010</td> <td>アーカイブと、機密情報などを除去するための物理削除を区別できること</td> </tr> <tr> <td>R011</td> <td>評価データおよびパラメータセットの版の履歴を追跡できること</td> </tr> </tbody> </table> <p>immutableなサービスにしようと意気込んでいたので<code>R010</code>は当初入れてなかったが、リソースのリビジョン機能をサポートするAPIでは物理削除が必須という記述を読んだので追加した<sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup>。</p> <h3 id="システム要件system-requirements">システム要件（System Requirements）</h3> <p>上で整理した要求から、下記のシステム要件が導かれた:</p> <table> <thead> <tr> <th>ID</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>SR001</td> <td>各評価データおよびパラメータセットは、版を用いて管理されなければならない</td> </tr> <tr> <td>SR002</td> <td>登録後の版の内容を変更してはならない</td> </tr> <tr> <td>SR003</td> <td>評価データまたはパラメータセットを修正するときは、既存の版を更新せず、新しい版を作成しなければならない</td> </tr> <tr> <td>SR004</td> <td>新しい版は、修正元となった版を0個または1個参照しなければならない</td> </tr> <tr> <td>SR005</td> <td>同一の登録要求識別子を持つ登録要求に対しては同一の結果を返し、新たな版を重複して作成してはならない</td> </tr> <tr> <td>SR006</td> <td>登録処理が成功した場合、取得APIから登録された版の内容を取得できなければならない</td> </tr> <tr> <td>SR007</td> <td>版を指定した取得要求には、その版に記録された内容を返さなければならない</td> </tr> <tr> <td>SR008</td> <td>評価データおよびパラメータセットは、それぞれ高々1つの最新版を持たなければならない</td> </tr> <tr> <td>SR009</td> <td>新しい版の登録成功後、最新版は新しい版を指さなければならない</td> </tr> <tr> <td>SR010</td> <td>新しい版が登録されても、過去の版を変更または削除してはならない</td> </tr> </tbody> </table> <p>これらの要件を出発点とし、データ登録機能を提供するバックエンドサービスとしてあるべき姿に照らして、追加で必要な要件をモデル検証であぶり出していく。</p> <p>モデル検証には<a href="https://alloytools.org/alloy6.html">Alloy 6</a>を利用する。 動作環境は下記の通り:</p> <ul> <li>macOS 15.6.1（Apple M1 Max）</li> <li>Alloy Analyzer 6.1.0.20211119T054551</li> </ul> <h2 id="要件を満たすモデルの探索">要件を満たすモデルの探索</h2> <h3 id="システム基本構造の定義">システム基本構造の定義</h3> <p>data-registryサービスのドメイン構造として、下記を表現することにした:</p> <table> <thead> <tr> <th>#</th> <th>Alloy signature</th> <th>意味</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>Resource</td> <td>ユビキタス言語より</td> </tr> <tr> <td>2</td> <td>AnnualAssessment</td> <td>ユビキタス言語より</td> </tr> <tr> <td>3</td> <td>AssessmentTarget</td> <td>ユビキタス言語より</td> </tr> <tr> <td>4</td> <td>AssessmentDataRevision</td> <td>評価データの版</td> </tr> <tr> <td>5</td> <td>ParameterSetRevision</td> <td>パラメータセットの版</td> </tr> <tr> <td>6</td> <td>Registry</td> <td>data-registryサービス</td> </tr> </tbody> </table> <p>その他、Alloyによるシミュレーションを動かすために必要なstutterなどを足して、下記のコードから始めることにする:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-alloy:model.als" data-lang="alloy:model.als"><span style="display:flex;"><span>commit <span style="color:#2aa198">46</span>d22f240c3b20868818dcbf6d5b09dba5d161d7 </span></span><span style="display:flex;"><span>Author: Akira Hayashi <span style="color:#719e07">&lt;</span>rindrics@gmail<span style="color:#719e07">.</span>com<span style="color:#719e07">&gt;</span> </span></span><span style="display:flex;"><span>Date: Thu Jul <span style="color:#2aa198">30</span> <span style="color:#2aa198">06</span>:<span style="color:#2aa198">04</span>:<span style="color:#2aa198">25</span> <span style="color:#2aa198">2026</span> <span style="color:#719e07">+</span><span style="color:#2aa198">0900</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> feat: define fundamental model structure </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>diff <span style="color:#586e75">--git a/services/data-registry/docs/model.als b/services/data-registry/docs/model.als</span> </span></span><span style="display:flex;"><span>new file mode <span style="color:#2aa198">100644</span> </span></span><span style="display:flex;"><span>index <span style="color:#2aa198">0000000</span><span style="color:#719e07">..</span><span style="color:#2aa198">36</span>a45f9 </span></span><span style="display:flex;"><span><span style="color:#586e75">--- /dev/null</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+++</span> b<span style="color:#719e07">/</span>services<span style="color:#719e07">/</span>data<span style="color:#719e07">-</span>registry<span style="color:#719e07">/</span>docs<span style="color:#719e07">/</span>model<span style="color:#719e07">.</span>als </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">0</span>,<span style="color:#2aa198">0</span> <span style="color:#719e07">+</span><span style="color:#2aa198">1</span>,<span style="color:#2aa198">84</span> @@ </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">module</span> DataRegistry </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ 1. System Requirements </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ============================================================ */</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR001: AssessmentData and ParameterSet, along with their respective versions, must be managed separately.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR002: Each version must be assigned a unique identifier, and the contents must not be modified after registration.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR003: When modifying AssessmentData or ParameterSet, a new version must be created instead of updating the existing version.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR004: A new version must reference exactly zero or one previous version as its source.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR005: For registration requests with identical IdempotencyKey, the same result must be returned without creating duplicate versions.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR006: After successful registration, the registered version must be retrievable via the retrieval API.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR007: Retrieval requests specifying a version must return the contents recorded in that version.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR008: AssessmentData and ParameterSet must each have at most one current version.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR009: After successful registration of a new version, the current version must point to the new version.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR010: Past versions must not be modified or deleted even after a new version is registered.</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ 2. Domain </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ============================================================ */</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> Resource <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> AnnualAssessment <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> AssessmentTarget <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> resource: <span style="color:#719e07">one</span> Resource, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> year: <span style="color:#719e07">one</span> AnnualAssessment </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> AssessmentDataRevision <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> ParameterSetRevision <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ 3. State </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ============================================================ */</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> assessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> parameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ 4. Operations </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ============================================================ */</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> init <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> registerAssessmentData<span style="color:#719e07">[</span>at: AssessmentTarget, adr: AssessmentDataRevision<span style="color:#719e07">]</span> <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> registerParameterSet<span style="color:#719e07">[</span>at: AssessmentTarget, psr: ParameterSetRevision<span style="color:#719e07">]</span> <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> psr </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> stutter <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> step <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> stutter </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision <span style="color:#719e07">|</span> registerAssessmentData<span style="color:#719e07">[</span>at, adr<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision <span style="color:#719e07">|</span> registerParameterSet<span style="color:#719e07">[</span>at, psr<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">fact</span> traces <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> init </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">always</span> step </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ 5. Properties </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ============================================================ */</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ============================================================ */</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> <span style="color:#719e07">{}</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span></code></pre></div><p><code>run</code>を実行してみると、下図のような関係が表示された:</p> <figure><img src="https://rindrics.com/images/2026-07-29-data/init.webp" alt="システムの初期状態"><figcaption> <p>システムの初期状態</p> </figcaption> </figure> <p>（Alloyのおさらい）この図が意味していることは下記だ:</p> <ul> <li><code>AssessmentTarger0</code> は <code>AnnualAssessment</code> と <code>Resource1</code> からなる評価対象である</li> <li><code>AssessmentTarger1</code> も同じ年の評価だが、対象資源は <code>Resource0</code> である</li> <li><code>Registry</code> にはまだなにも登録されていない（= エッジが一本もない）</li> <li><code>AssessmentDataRevision</code> という概念がモデリングされているが使われていない（= データが登録されていない）</li> </ul> <p><code>registerParameterSet</code> predicateをstepに含めているにも関わらずデータが登録されていないことになっている理由は下記だ:</p> <ul> <li>a. step内で<code>registerParameterSet</code>の遷移が<code>or</code>の一つの選択肢として定義されているだけであり、その遷移が少なくとも一度選択されることは保証されていないため <ul> <li>stutterが常に選択可能なら、すべてのステップで<code>stutter</code>だけが選択され、登録が一度も起きないトレースも許される</li> </ul> </li> <li>b. Alloyによるケース探索ではインスタンスから生成されがちだから<sup id="fnref:2"><a href="#fn:2" class="footnote-ref" role="doc-noteref">2</a></sup></li> </ul> <p>逆に、データが登録された状況を見てみたければ下記のようにすれば良い:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:model.als" data-lang="diff:model.als"><span style="display:flex;"><span> <span style="color:#719e07">pred</span> step <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> stutter </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision <span style="color:#719e07">|</span> registerAssessmentData<span style="color:#719e07">[</span>at, adr<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision <span style="color:#719e07">|</span> registerParameterSet<span style="color:#719e07">[</span>at, psr<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision <span style="color:#719e07">|</span> registerAssessmentData<span style="color:#719e07">[</span>at, adr<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span></code></pre></div><p>↑力技でやるならこう。</p> <p>こちらのほうがスマートか↓</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:model.als" data-lang="diff:model.als"><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">run</span> <span style="color:#719e07">{}</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">run</span> <span style="color:#719e07">{</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">)</span> <span style="color:#719e07">}</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span></code></pre></div><p>実行すると、下図のようにデータが登録された状態を一応見ることができる: <figure><img src="https://rindrics.com/images/2026-07-29-data/init-registered.webp" alt="データが登録されたケースの一例"><figcaption> <p>データが登録されたケースの一例</p> </figcaption> </figure> </p> <p>図示のためのこの変更は不要だったので元に戻しておく。</p> <p>ここから、各要件をAlloyで形式化し、全ての要件が常に満たされるシステム仕様となっているかを検証していく。 「すべての要件が常に」と強めに書いたのは、各要件は私が定義した: つまり調整余地があるもなので、要件全体として整合するようにしたいからだ<sup id="fnref:3"><a href="#fn:3" class="footnote-ref" role="doc-noteref">3</a></sup>。</p> <h3 id="sr001-版による管理">SR001: 版による管理</h3> <blockquote> <p>SR001: 各評価データおよびパラメータセットは、版を用いて管理されなければならない</p> </blockquote> <p>この要件は下記のように表現できる。</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:model.als" data-lang="diff:model.als"><span style="display:flex;"><span> <span style="color:#2aa198">5</span><span style="color:#719e07">.</span> Properties </span></span><span style="display:flex;"><span> <span style="color:#719e07">============================================================</span> <span style="color:#719e07">*/</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">assert</span> SR001_revision_belongs_to_at_most_one_target <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> adr: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">lone</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">.</span>adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> psr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">lone</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">.</span>psr </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">check</span> SR001_revision_belongs_to_at_most_one_target <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR001_revisions_can_be_registered <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> psr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR001_revisions_can_be_registered <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p>Execute Allしてみる:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-gdscript3" data-lang="gdscript3"><span style="display:flex;"><span>Executing <span style="color:#2aa198">&#34;Check SR001_revision_belongs_to_at_most_one_target for 2 but 1..3 steps&#34;</span> </span></span><span style="display:flex;"><span> Actual scopes: <span style="color:#2aa198">2</span> <span style="color:#cb4b16">Resource</span>, <span style="color:#2aa198">2</span> AnnualAssessment, <span style="color:#2aa198">2</span> AssessmentTarget, <span style="color:#2aa198">2</span> AssessmentDataRevision, <span style="color:#2aa198">2</span> ParameterSetRevision, exactly <span style="color:#2aa198">1</span> Registry </span></span><span style="display:flex;"><span> Solver<span style="color:#719e07">=</span>sat4j Steps<span style="color:#719e07">=</span><span style="color:#2aa198">1.</span><span style="color:#719e07">.</span><span style="color:#2aa198">3</span> Bitwidth<span style="color:#719e07">=</span><span style="color:#2aa198">4</span> MaxSeq<span style="color:#719e07">=</span><span style="color:#2aa198">2</span> SkolemDepth<span style="color:#719e07">=</span><span style="color:#2aa198">1</span> Symmetry<span style="color:#719e07">=</span><span style="color:#2aa198">20</span> Mode<span style="color:#719e07">=</span>batch </span></span><span style="display:flex;"><span> <span style="color:#2aa198">1.</span><span style="color:#719e07">.</span><span style="color:#2aa198">3</span> steps<span style="color:#719e07">.</span> <span style="color:#2aa198">1553</span> vars<span style="color:#719e07">.</span> <span style="color:#2aa198">108</span> primary vars<span style="color:#719e07">.</span> <span style="color:#2aa198">2564</span> clauses<span style="color:#719e07">.</span> <span style="color:#2aa198">10</span>ms<span style="color:#719e07">.</span> </span></span><span style="display:flex;"><span> No counterexample found<span style="color:#719e07">.</span> Assertion may be valid<span style="color:#719e07">.</span> <span style="color:#2aa198">0</span>ms<span style="color:#719e07">.</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>Executing <span style="color:#2aa198">&#34;Run SR001_revisions_can_be_registered for 2 but 1..3 steps, 1 AssessmentTarget&#34;</span> </span></span><span style="display:flex;"><span> Actual scopes: <span style="color:#2aa198">2</span> <span style="color:#cb4b16">Resource</span>, <span style="color:#2aa198">2</span> AnnualAssessment, <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">2</span> AssessmentDataRevision, <span style="color:#2aa198">2</span> ParameterSetRevision, exactly <span style="color:#2aa198">1</span> Registry </span></span><span style="display:flex;"><span> Solver<span style="color:#719e07">=</span>sat4j Steps<span style="color:#719e07">=</span><span style="color:#2aa198">1.</span><span style="color:#719e07">.</span><span style="color:#2aa198">3</span> Bitwidth<span style="color:#719e07">=</span><span style="color:#2aa198">4</span> MaxSeq<span style="color:#719e07">=</span><span style="color:#2aa198">2</span> SkolemDepth<span style="color:#719e07">=</span><span style="color:#2aa198">1</span> Symmetry<span style="color:#719e07">=</span><span style="color:#2aa198">20</span> Mode<span style="color:#719e07">=</span>batch </span></span><span style="display:flex;"><span> <span style="color:#2aa198">1.</span><span style="color:#719e07">.</span><span style="color:#2aa198">3</span> steps<span style="color:#719e07">.</span> <span style="color:#2aa198">2479</span> vars<span style="color:#719e07">.</span> <span style="color:#2aa198">198</span> primary vars<span style="color:#719e07">.</span> <span style="color:#2aa198">3967</span> clauses<span style="color:#719e07">.</span> <span style="color:#2aa198">8</span>ms<span style="color:#719e07">.</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">.</span> found<span style="color:#719e07">.</span> Predicate is consistent<span style="color:#719e07">.</span> <span style="color:#2aa198">3</span>ms<span style="color:#719e07">.</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>Executing <span style="color:#2aa198">&#34;Run run$3 for 2 but 1..3 steps&#34;</span> </span></span><span style="display:flex;"><span> Actual scopes: <span style="color:#2aa198">2</span> <span style="color:#cb4b16">Resource</span>, <span style="color:#2aa198">2</span> AnnualAssessment, <span style="color:#2aa198">2</span> AssessmentTarget, <span style="color:#2aa198">2</span> AssessmentDataRevision, <span style="color:#2aa198">2</span> ParameterSetRevision, exactly <span style="color:#2aa198">1</span> Registry </span></span><span style="display:flex;"><span> Solver<span style="color:#719e07">=</span>sat4j Steps<span style="color:#719e07">=</span><span style="color:#2aa198">1.</span><span style="color:#719e07">.</span><span style="color:#2aa198">3</span> Bitwidth<span style="color:#719e07">=</span><span style="color:#2aa198">4</span> MaxSeq<span style="color:#719e07">=</span><span style="color:#2aa198">2</span> SkolemDepth<span style="color:#719e07">=</span><span style="color:#2aa198">1</span> Symmetry<span style="color:#719e07">=</span><span style="color:#2aa198">20</span> Mode<span style="color:#719e07">=</span>batch </span></span><span style="display:flex;"><span> <span style="color:#2aa198">1.</span><span style="color:#719e07">.</span><span style="color:#2aa198">1</span> steps<span style="color:#719e07">.</span> <span style="color:#2aa198">2769</span> vars<span style="color:#719e07">.</span> <span style="color:#2aa198">225</span> primary vars<span style="color:#719e07">.</span> <span style="color:#2aa198">4415</span> clauses<span style="color:#719e07">.</span> <span style="color:#2aa198">1</span>ms<span style="color:#719e07">.</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">.</span> found<span style="color:#719e07">.</span> Predicate is consistent<span style="color:#719e07">.</span> <span style="color:#2aa198">2</span>ms<span style="color:#719e07">.</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#2aa198">3</span> commands were executed<span style="color:#719e07">.</span> The results are: </span></span><span style="display:flex;"><span> <span style="color:#586e75">#1: No counterexample found. SR001_revision_belongs_to_at_most_one_target may be valid.</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">#2: Instance found. SR001_revisions_can_be_registered is consistent.</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">#3: Instance found. run$3 is consistent.</span> </span></span></code></pre></div><p>↑反例なし、全要件を満たすインスタンスあり（以下 OK &#x2705; と表現）。</p> <h3 id="sr002-不変性">SR002: 不変性</h3> <blockquote> <p>SR002: 登録後の版の内容を変更してはならない</p> </blockquote> <p>これは下のように表現する:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:model.als" data-lang="diff:model.als"><span style="display:flex;"><span> year: <span style="color:#719e07">one</span> AnnualAssessment </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span><span style="color:#268bd2">sig</span> AssessmentDataRevision <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span><span style="color:#268bd2">sig</span> ParameterSetRevision <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> AssessmentData <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> ParameterSet <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> AssessmentDataRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> id: <span style="color:#719e07">one</span> RevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> assessmentData: <span style="color:#719e07">one</span> AssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> ParameterSetRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> id: <span style="color:#719e07">one</span> RevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> parameterSet: <span style="color:#719e07">one</span> ParameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">fact</span> revisionIdUnique <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> r1, r2: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> r1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> r2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> r1 <span style="color:#719e07">=</span> r2 </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> r1, r2: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> r1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> r2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> r1 <span style="color:#719e07">=</span> r2 </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 3. State </span></span></span><span style="display:flex;"><span><span style="color:#586e75">@@ -96,6 +115,28 @@ pred SR001_revisions_can_be_registered { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> run SR001_revisions_can_be_registered for 2 but 1 AssessmentTarget, 1..3 steps </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+// SR002: The contents of a revision should not be modified after registration. </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+// (Automatically satisfied by definition) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+pred SR002_registered_revision_contents_remain_available { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ eventually (some at: AssessmentTarget, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ adr: AssessmentDataRevision, psr: ParameterSetRevision, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ data: AssessmentData, params: ParameterSet | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ Registry.assessmentData[at] = adr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and adr.assessmentData = data </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.parameterSet[at] = psr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and psr.parameterSet = params </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and after ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ Registry.assessmentData[at] = adr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and adr.assessmentData = data </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.parameterSet[at] = psr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and psr.parameterSet = params </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ )) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+} </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+run SR002_registered_revision_contents_remain_available </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ for 2 but 1 AssessmentTarget, 1..4 steps </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> /* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p>↑各Revisionに、非<code>var</code>のフィールドとして <code>one AssessmentData</code> と <code>one ParameterSet</code> を定義することによって保証する（保証といっても実装時の契約ではあるが）。</p> <p>assertは追加していないが、この変更によって不整合が出ていないかをExecute Allで確認する:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>4 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: No counterexample found. SR001_revision_belongs_to_at_most_one_target may be valid. </span></span><span style="display:flex;"><span> #2: Instance found. SR001_revisions_can_be_registered is consistent. </span></span><span style="display:flex;"><span> #3: Instance found. SR002_registered_revision_contents_remain_available is consistent. </span></span><span style="display:flex;"><span> #4: Instance found. run$4 is consistent. </span></span></code></pre></div><p>OK &#x2705;</p> <p>こちらは全体のsanity check: <figure><img src="https://rindrics.com/images/2026-07-29-data/sr002.webp" alt="現時点のsanity checkを持たすモデル"><figcaption> <p>現時点のsanity checkを持たすモデル</p> </figcaption> </figure> ↑<code>AssessmentDataRevision</code> と <code>ParameterSetRevision</code> が導入されたことで、モデルの構造が変わったのがわかる（スペース的に辛いのでノード数を減らしている）。</p> <p>また、SR002の正常ケースの例をひとつ見てみたいので、明示的に<code>egistered_revision_contents_remain_available</code>という<code>run</code>も追加した: <figure><img src="https://rindrics.com/images/2026-07-29-data/sr002-run.webp" alt="SR002を満たすケースの一例"><figcaption> <p>SR002を満たすケースの一例</p> </figcaption> </figure> &hellip;いや待て。 あるAssessmentDataRevisonと、あるParameterSetRevisionが同じRevisionIdを持ちうることになっているのか？ それは意図と違う。</p> <p>確かにちゃんとモデリングできていなかった:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:model.als" data-lang="diff:model.als"><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> AssessmentData <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> ParameterSet <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span><span style="color:#268bd2">sig</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">abstract</span> <span style="color:#268bd2">sig</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> AssessmentDataRevisionId, ParameterSetRevisionId <span style="color:#719e07">extends</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> AssessmentDataRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> id: <span style="color:#719e07">one</span> RevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> id: <span style="color:#719e07">one</span> AssessmentDataRevisionId, </span></span><span style="display:flex;"><span> assessmentData: <span style="color:#719e07">one</span> AssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> ParameterSetRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> id: <span style="color:#719e07">one</span> RevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> id: <span style="color:#719e07">one</span> ParameterSetRevisionId, </span></span><span style="display:flex;"><span> parameterSet: <span style="color:#719e07">one</span> ParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span></code></pre></div><p>もう一度状態を見てみる:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>4 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: No counterexample found. SR001_revision_belongs_to_at_most_one_target may be valid. </span></span><span style="display:flex;"><span> #2: Instance found. SR001_revisions_can_be_registered is consistent. </span></span><span style="display:flex;"><span> #3: Instance found. SR002_registered_cont_available is consistent. </span></span><span style="display:flex;"><span> #4: Instance found. run$4 is consistent. </span></span></code></pre></div><p>OK &#x2705;</p> <p>これで、AssessmentDataRevisonとParameterSetRevisionはそれぞれのRevisionIdを持つようになった。 <figure><img src="https://rindrics.com/images/2026-07-29-data/sr002-fixed.webp" alt="SR002を満たすケースの一例（修正版）"><figcaption> <p>SR002を満たすケースの一例（修正版）</p> </figcaption> </figure> </p> <p>Alloyの可視化機能に助けられた。</p> <h3 id="sr003-不変性その2">SR003: 不変性その2</h3> <blockquote> <p>SR003 : 評価データまたはパラメータセットを修正するときは、既存の版を更新せず、新しい版を作成しなければならない</p> </blockquote> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:model.als" data-lang="diff:model.als"><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> AssessmentDataRevisionId, ParameterSetRevisionId <span style="color:#719e07">extends</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR002: Each revision has unique identifier</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> AssessmentDataRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> id: <span style="color:#719e07">one</span> AssessmentDataRevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> assessmentData: <span style="color:#719e07">one</span> AssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> assessmentData: <span style="color:#719e07">one</span> AssessmentData, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> previousSource: <span style="color:#719e07">lone</span> AssessmentDataRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> ParameterSetRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> id: <span style="color:#719e07">one</span> ParameterSetRevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> parameterSet: <span style="color:#719e07">one</span> ParameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> parameterSet: <span style="color:#719e07">one</span> ParameterSet, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> previousSource: <span style="color:#719e07">lone</span> ParameterSetRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span><span style="color:#719e07">fact</span> revisionIdUnique <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">all</span> r1, r2: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> r1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> r2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> r1 <span style="color:#719e07">=</span> r2 </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">all</span> r1, r2: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> r1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> r2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> r1 <span style="color:#719e07">=</span> r2 </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR002: Unique identifier enforcement</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">fact</span> revisionIdUniqueAssessmentData <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> adr1, adr2: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> adr1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> adr2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> adr1 <span style="color:#719e07">=</span> adr2 </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">fact</span> revisionIdUniqueParameterSet <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> psr1, psr2: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> psr1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> psr2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> psr1 <span style="color:#719e07">=</span> psr2 </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">fact</span> noCyclicSource <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> adr: AssessmentDataRevision <span style="color:#719e07">|</span> adr not <span style="color:#719e07">in</span> adr<span style="color:#719e07">.^</span>previousSource </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> psr: ParameterSetRevision <span style="color:#719e07">|</span> psr not <span style="color:#719e07">in</span> psr<span style="color:#719e07">.^</span>previousSource </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">@@ -54,8 +66,8 @@ fact revisionIdUnique { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">var</span> assessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">var</span> parameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> currentAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> currentParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">@@ -63,23 +75,33 @@ one sig Registry { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> init <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> registerAssessmentData<span style="color:#719e07">[</span>at: AssessmentTarget, adr: AssessmentDataRevision<span style="color:#719e07">]</span> <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> adr<span style="color:#719e07">.</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> adr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData <span style="color:#719e07">++</span> at <span style="color:#719e07">-&gt;</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> registerParameterSet<span style="color:#719e07">[</span>at: AssessmentTarget, psr: ParameterSetRevision<span style="color:#719e07">]</span> <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> psr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> psr<span style="color:#719e07">.</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> psr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet <span style="color:#719e07">++</span> at <span style="color:#719e07">-&gt;</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> stutter <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> step <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">97</span>,<span style="color:#2aa198">40</span> <span style="color:#719e07">+</span><span style="color:#2aa198">119</span>,<span style="color:#2aa198">32</span> @@ <span style="color:#719e07">fact</span> traces <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#2aa198">5</span><span style="color:#719e07">.</span> Properties </span></span><span style="display:flex;"><span> <span style="color:#719e07">============================================================</span> <span style="color:#719e07">*/</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span><span style="color:#719e07">assert</span> SR001_revision_belongs_to_at_most_one_target <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">all</span> adr: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">lone</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">.</span>adr </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">all</span> psr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">lone</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">.</span>psr </span></span><span style="display:flex;"><span><span style="color:#719e07">-}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span><span style="color:#719e07">check</span> SR001_revision_belongs_to_at_most_one_target <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR001: At most one current version per AssessmentTarget</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// (Automatically satisfied by Registry definition: lone AssessmentDataRevision)</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> SR001_revisions_can_be_registered <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span> psr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">run</span> SR001_revisions_can_be_registered <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">// SR002: The contents of a revision should not be modified after registration.</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">// (Automatically satisfied by definition)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> SR002_registered_cont_available <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> adr: AssessmentDataRevision, psr: ParameterSetRevision, </span></span><span style="display:flex;"><span> data: AssessmentData, params: ParameterSet <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> adr<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">=</span> data </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> psr<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">=</span> params </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">after</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> Registry<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> adr<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">=</span> data </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> psr<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">=</span> params </span></span><span style="display:flex;"><span> <span style="color:#719e07">))</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">138</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">152</span>,<span style="color:#2aa198">46</span> @@ <span style="color:#719e07">pred</span> SR002_registered_cont_available <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">run</span> SR002_registered_cont_available </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">4</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR003: When modifying, a new version must be created instead of updating the existing version</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">assert</span> SR003_new_version_on_change <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">always</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">all</span> at: AssessmentTarget <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">implies</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">or</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">in</span> <span style="color:#719e07">(</span>Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]).~</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">all</span> at: AssessmentTarget <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">implies</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">or</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">in</span> <span style="color:#719e07">(</span>Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]).~</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">check</span> SR003_new_version_on_change <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR003_assessment_data_can_be_changed_with_new_revision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> source, newRevision: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> source<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">!=</span> newRevision<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> registerAssessmentData<span style="color:#719e07">[</span>at, newRevision<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR003_parameter_set_can_be_changed_with_new_revision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> source, newRevision: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> source<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">!=</span> newRevision<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> registerParameterSet<span style="color:#719e07">[</span>at, newRevision<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR003_assessment_data_can_be_changed_with_new_revision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR003_parameter_set_can_be_changed_with_new_revision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p><code>assert SR003_new_version_on_change</code> の下記の部分は「current revisionが同じまま（変わらない）、または next revisionが current revision から派生している」を意味している:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-alloy" data-lang="alloy"><span style="display:flex;"><span><span style="color:#719e07">implies</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">in</span> <span style="color:#719e07">(</span>Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]).~</span>previousSource<span style="color:#719e07">)</span> </span></span></code></pre></div><p>Execute All:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>6 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: Instance found. SR001_revisions_can_be_registered is consistent. </span></span><span style="display:flex;"><span> #2: Instance found. SR002_registered_cont_available is consistent. </span></span><span style="display:flex;"><span> #3: No counterexample found. SR003_new_version_on_change may be valid. </span></span><span style="display:flex;"><span> #4: Instance found. SR003_assessment_data_can_be_changed_with_new_revision is consistent. </span></span><span style="display:flex;"><span> #5: Instance found. SR003_parameter_set_can_be_changed_with_new_revision is consistent. </span></span><span style="display:flex;"><span> #6: Instance found. run$6 is consistent. </span></span></code></pre></div><p>OK &#x2705;</p> <p>AssessmentDataが変わった際には、別のRevisionとなるようになっている: <figure><img src="https://rindrics.com/images/2026-07-29-data/sr003.webp" alt="SR003を満たすケースの一例"><figcaption> <p>SR003を満たすケースの一例</p> </figcaption> </figure> （末尾の数字が交差しているが、これは自動付与されたものなので気にしなくて良いはず。）</p> <h3 id="sr004-版の参照規則">SR004: 版の参照規則</h3> <blockquote> <p>SR004: 新しい版は、修正元となった版を0個または1個参照しなければならない</p> </blockquote> <p>これは、<code>previousSource: lone AssessmentDataRevision</code> の <code>lone</code> によって、既に定義レベルで保証されている。 一応、状態を見てみたいので<code>run</code>を追加した:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:moodel.als" data-lang="diff:moodel.als"><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR004: Each revision can reference exactly zero or one previous version</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// (Enforced by previousSource: lone field definition - no explicit assertion needed)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR004_root_and_derived_revisions_can_exist <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">some</span> rootAdr, derivedAdr: AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> rootPsr, derivedPsr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> rootAdr <span style="color:#719e07">!=</span> derivedAdr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> rootAdr<span style="color:#719e07">.</span>previousSource </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> derivedAdr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> rootAdr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> rootPsr <span style="color:#719e07">!=</span> derivedPsr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> rootPsr<span style="color:#719e07">.</span>previousSource </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> derivedPsr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> rootPsr </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR004_root_and_derived_revisions_can_exist </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">4</span> <span style="color:#719e07">but</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> ParameterSetRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> AssessmentDataRevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> ParameterSetRevisionId, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">2</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p>一例を見てみる: <figure><img src="https://rindrics.com/images/2026-07-29-data/sr004.webp" alt="SR004を満たすケースの一例"><figcaption> <p>SR004を満たすケースの一例</p> </figcaption> </figure> なるほど、データの内容が同じでも親が違う状況が示されていて、この場合には違う版として扱われるらしい。 少し意図と違うが、これについては次の<code>SR005</code>で考える。</p> <h3 id="sr005-冪等性">SR005: 冪等性</h3> <blockquote> <p>SR005: 同一の登録要求識別子を持つ登録要求に対しては同一の結果を返し、新たな版を重複して作成してはならない</p> </blockquote> <p>先ほど述べた問題にも関係する冪等性。 下記のようにモデリングしてみる:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:moodel.als" data-lang="diff:moodel.als"><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> AssessmentDataRevisionId, ParameterSetRevisionId <span style="color:#719e07">extends</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> HashKey <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">abstract</span> <span style="color:#268bd2">sig</span> Status <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Success, Failure <span style="color:#719e07">extends</span> Status <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#268bd2">sig</span> Response <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> revision: <span style="color:#719e07">lone</span> <span style="color:#719e07">(</span>AssessmentDataRevision <span style="color:#719e07">+</span> ParameterSetRevision<span style="color:#719e07">)</span>, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> status: <span style="color:#719e07">one</span> Status </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">// SR002: Each revision has unique identifier</span> </span></span><span style="display:flex;"><span> <span style="color:#268bd2">sig</span> AssessmentDataRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> id: <span style="color:#719e07">one</span> AssessmentDataRevisionId, </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">67</span>,<span style="color:#2aa198">7</span> <span style="color:#719e07">+</span><span style="color:#2aa198">77</span>,<span style="color:#2aa198">9</span> @@ <span style="color:#719e07">fact</span> noCyclicSource <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> currentAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">-</span> <span style="color:#719e07">var</span> currentParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> currentParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#586e75">// SR005: Track responses by HashKey (idempotency key) for idempotency verification</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> responseLog: HashKey <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> Response </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">@@ -77,37 +89,80 @@ one sig Registry { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> pred init { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> no Registry.currentAssessmentData </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> no Registry.currentParameterSet </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ no Registry.responseLog </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> } </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75">-pred registerAssessmentData[at: AssessmentTarget, adr: AssessmentDataRevision] { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- (no Registry.currentAssessmentData[at] and no adr.previousSource) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+// SR005: Log response by idempotency key </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+pred registerAssessmentData[ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ at: AssessmentTarget, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ adr: AssessmentDataRevision, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ data: AssessmentData, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ idempotencyKey: HashKey </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+] { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ adr.assessmentData = data </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ no Registry.responseLog[idempotencyKey] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ (no Registry.currentAssessmentData[at] and no adr.previousSource) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ or ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ some Registry.currentAssessmentData[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and adr.previousSource = Registry.currentAssessmentData[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentAssessmentData&#39; = Registry.currentAssessmentData ++ at -&gt; adr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentParameterSet&#39; = Registry.currentParameterSet </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and some r: Response | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ r.revision = adr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and r.status = Success </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39; = Registry.responseLog + idempotencyKey -&gt; r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> or ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- some Registry.currentAssessmentData[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- and adr.previousSource = Registry.currentAssessmentData[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ some Registry.responseLog[idempotencyKey] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentAssessmentData&#39; = Registry.currentAssessmentData </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentParameterSet&#39; = Registry.currentParameterSet </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39; = Registry.responseLog </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- Registry.currentAssessmentData&#39; = Registry.currentAssessmentData ++ at -&gt; adr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- Registry.currentParameterSet&#39; = Registry.currentParameterSet </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> } </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75">-pred registerParameterSet[at: AssessmentTarget, psr: ParameterSetRevision] { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- (no Registry.currentParameterSet[at] and no psr.previousSource) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+pred registerParameterSet[ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ at: AssessmentTarget, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ psr: ParameterSetRevision, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ params: ParameterSet, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ idempotencyKey: HashKey </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+] { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ psr.parameterSet = params </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ no Registry.responseLog[idempotencyKey] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ (no Registry.currentParameterSet[at] and no psr.previousSource) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ or ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ some Registry.currentParameterSet[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and psr.previousSource = Registry.currentParameterSet[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentAssessmentData&#39; = Registry.currentAssessmentData </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentParameterSet&#39; = Registry.currentParameterSet ++ at -&gt; psr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and some r: Response | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ r.revision = psr </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and r.status = Success </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39; = Registry.responseLog + idempotencyKey -&gt; r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> or ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- some Registry.currentParameterSet[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- and psr.previousSource = Registry.currentParameterSet[at] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ some Registry.responseLog[idempotencyKey] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentAssessmentData&#39; = Registry.currentAssessmentData </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.currentParameterSet&#39; = Registry.currentParameterSet </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39; = Registry.responseLog </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- Registry.currentAssessmentData&#39; = Registry.currentAssessmentData </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- Registry.currentParameterSet&#39; = Registry.currentParameterSet ++ at -&gt; psr </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> } </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> pred stutter { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Registry.currentAssessmentData&#39; = Registry.currentAssessmentData </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Registry.currentParameterSet&#39; = Registry.currentParameterSet </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ Registry.responseLog&#39; = Registry.responseLog </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> } </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> pred step { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> stutter </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- or (some at: AssessmentTarget, adr: AssessmentDataRevision | registerAssessmentData[at, adr]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- or (some at: AssessmentTarget, psr: ParameterSetRevision | registerParameterSet[at, psr]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ or (some at: AssessmentTarget, adr: AssessmentDataRevision, data: AssessmentData, hk: HashKey | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ registerAssessmentData[at, adr, data, hk]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ or (some at: AssessmentTarget, psr: ParameterSetRevision, params: ParameterSet, hk: HashKey | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ registerParameterSet[at, psr, params, hk]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> } </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> fact traces { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">@@ -171,20 +226,22 @@ check SR003_new_version_on_change for 2 but 1..3 steps </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> pred SR003_assessment_update { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> eventually (some at: AssessmentTarget, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- source, newRevision: AssessmentDataRevision | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ source, newRevision: AssessmentDataRevision, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ data: AssessmentData, hk: HashKey | </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Registry.currentAssessmentData[at] = source </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- and source.assessmentData != newRevision.assessmentData </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and source.assessmentData != data </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> and newRevision.previousSource = source </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- and registerAssessmentData[at, newRevision]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and registerAssessmentData[at, newRevision, data, hk]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> } </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> pred SR003_parameter_update { </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> eventually (some at: AssessmentTarget, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- source, newRevision: ParameterSetRevision | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ source, newRevision: ParameterSetRevision, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ params: ParameterSet, hk: HashKey | </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Registry.currentParameterSet[at] = source </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- and source.parameterSet != newRevision.parameterSet </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and source.parameterSet != params </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> and newRevision.previousSource = source </span></span></span><span style="display:flex;"><span><span style="color:#586e75">- and registerParameterSet[at, newRevision]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and registerParameterSet[at, newRevision, params, hk]) </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> } </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> run SR003_assessment_update </span></span></span><span style="display:flex;"><span><span style="color:#586e75">@@ -214,6 +271,51 @@ run SR004_revision_chain </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> exactly 2 ParameterSetRevisionId, </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 1..2 steps </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+// SR005: Idempotency - same HashKey (idempotency key) returns same response </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+assert SR005_idempotency { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ always ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ all hk: HashKey | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ (some Registry.responseLog[hk]) implies always Registry.responseLog[hk] = Registry.responseLog&#39;[hk] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+} </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+check SR005_idempotency for 2 but 1..3 steps </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+pred SR005_assessment_data_retry_returns_same_response { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ some at: AssessmentTarget, adr: AssessmentDataRevision, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ data: AssessmentData, hk: HashKey, r: Response | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ eventually ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ no Registry.responseLog[hk] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and registerAssessmentData[at, adr, data, hk] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39;[hk] = r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and after ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ Registry.responseLog[hk] = r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and registerAssessmentData[at, adr, data, hk] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39;[hk] = r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+} </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+pred SR005_parameter_set_retry_returns_same_response { </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ some at: AssessmentTarget, psr: ParameterSetRevision, </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ params: ParameterSet, hk: HashKey, r: Response | </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ eventually ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ no Registry.responseLog[hk] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and registerParameterSet[at, psr, params, hk] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39;[hk] = r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and after ( </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ Registry.responseLog[hk] = r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and registerParameterSet[at, psr, params, hk] </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ and Registry.responseLog&#39;[hk] = r </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ ) </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+} </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+run SR005_assessment_data_retry_returns_same_response </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ for 2 but 1 AssessmentTarget, 1..3 steps </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+run SR005_parameter_set_retry_returns_same_response </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ for 2 but 1 AssessmentTarget, 1..3 steps </span></span></span><span style="display:flex;"><span><span style="color:#586e75">+ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> /* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p><code>var responseLog: HashKey -&gt; lone Response</code> の右辺が<code>one</code>ではなく<code>lone</code>なのは、データが未登録の状況を表現するため。 実装時における冪等性保証を助けるために、リクエストには<a href="https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/07/">idempotency key</a>を使う想定。 このkeyの計算には、親とする版のIDも含める必要がある。 始めはAssessmentDataなどの<strong>内容の</strong>みからkeyを生成して、同一の内容の登録リクエストは拒否してしまおうと考えていたが、そうすると履歴の復元: 内容が同じデータの再登録の時に不都合が出そう。</p> <p>ともあれ、同一性の定義については詳細設計に回すとして、ひとまず次に進む。</p> <p>Execute All:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>10 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: Instance found. SR001_registration is consistent. </span></span><span style="display:flex;"><span> #2: Instance found. SR002_content_stability is consistent. </span></span><span style="display:flex;"><span> #3: No counterexample found. SR003_new_version_on_change may be valid. </span></span><span style="display:flex;"><span> #4: Instance found. SR003_assessment_update is consistent. </span></span><span style="display:flex;"><span> #5: Instance found. SR003_parameter_update is consistent. </span></span><span style="display:flex;"><span> #6: Instance found. SR004_revision_chain is consistent. </span></span><span style="display:flex;"><span> #7: No counterexample found. SR005_idempotency may be valid. </span></span><span style="display:flex;"><span> #8: Instance found. SR005_assessment_retry is consistent. </span></span><span style="display:flex;"><span> #9: Instance found. SR005_parameter_retry is consistent. </span></span><span style="display:flex;"><span> #10: Instance found. run$10 is consistent. </span></span></code></pre></div><p>↑OK :white_check_mark</p> <figure><img src="https://rindrics.com/images/2026-07-29-data/sr005.webp" alt="SR005を満たすケースの一例"><figcaption> <p>SR005を満たすケースの一例</p> </figcaption> </figure> <p>↑同一のHashKeyとともに何度リクエストしても、Revisionは変化しない様子が示されている。</p> <h3 id="sr006-取得可能性">SR006: 取得可能性</h3> <blockquote> <p>SR006: 登録処理が成功した場合、取得APIから登録された版の内容を取得できなければならない</p> </blockquote> <p>この要件は「成功レスポンスがあるならRevisionが存在する」として表現する:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:moodel.als" data-lang="diff:moodel.als"><span style="display:flex;"><span> <span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> currentAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> currentParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> registeredAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">set</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">var</span> registeredParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">set</span> ParameterSetRevision, </span></span><span style="display:flex;"><span> <span style="color:#586e75">// SR005: Track responses by HashKey (idempotency key) for idempotency verification</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> responseLog: HashKey <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> Response </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">89</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">91</span>,<span style="color:#2aa198">8</span> @@ <span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> init <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">109</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">113</span>,<span style="color:#2aa198">8</span> @@ <span style="color:#719e07">pred</span> registerAssessmentData<span style="color:#719e07">[</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData <span style="color:#719e07">++</span> at <span style="color:#719e07">-&gt;</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">118</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">124</span>,<span style="color:#2aa198">8</span> @@ <span style="color:#719e07">pred</span> registerAssessmentData<span style="color:#719e07">[</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>idempotencyKey<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">138</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">146</span>,<span style="color:#2aa198">8</span> @@ <span style="color:#719e07">pred</span> registerParameterSet<span style="color:#719e07">[</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet <span style="color:#719e07">++</span> at <span style="color:#719e07">-&gt;</span> psr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">147</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">157</span>,<span style="color:#2aa198">8</span> @@ <span style="color:#719e07">pred</span> registerParameterSet<span style="color:#719e07">[</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>idempotencyKey<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">154</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">166</span>,<span style="color:#2aa198">8</span> @@ <span style="color:#719e07">pred</span> registerParameterSet<span style="color:#719e07">[</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">pred</span> stutter <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>@@ <span style="color:#719e07">-</span><span style="color:#2aa198">316</span>,<span style="color:#2aa198">6</span> <span style="color:#719e07">+</span><span style="color:#2aa198">330</span>,<span style="color:#2aa198">47</span> @@ <span style="color:#719e07">run</span> SR005_assessment_retry </span></span><span style="display:flex;"><span> <span style="color:#719e07">run</span> SR005_parameter_retry </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR006: After successful registration, the registered version must be retrievable</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// If response is logged as successful, the revision must remain registered</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">assert</span> SR006_retrievability <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">always</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">all</span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">implies</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> adr <span style="color:#719e07">and</span> adr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">or</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> psr <span style="color:#719e07">and</span> psr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">check</span> SR006_retrievability <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR006_registered_assessment_data_can_be_retrieved <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> adr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR006_registered_parameter_set_can_be_retrieved <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> psr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR006_registered_assessment_data_can_be_retrieved </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR006_registered_parameter_set_can_be_retrieved </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p>Execute All:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>13 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: Instance found. SR001_registration is consistent. </span></span><span style="display:flex;"><span> #2: Instance found. SR002_content_stability is consistent. </span></span><span style="display:flex;"><span> #3: No counterexample found. SR003_new_version_on_change may be valid. </span></span><span style="display:flex;"><span> #4: Instance found. SR003_assessment_update is consistent. </span></span><span style="display:flex;"><span> #5: Instance found. SR003_parameter_update is consistent. </span></span><span style="display:flex;"><span> #6: Instance found. SR004_revision_chain is consistent. </span></span><span style="display:flex;"><span> #7: No counterexample found. SR005_idempotency may be valid. </span></span><span style="display:flex;"><span> #8: Instance found. SR005_assessment_retry is consistent. </span></span><span style="display:flex;"><span> #9: Instance found. SR005_parameter_retry is consistent. </span></span><span style="display:flex;"><span> #10: No counterexample found. SR006_retrievability may be valid. </span></span><span style="display:flex;"><span> #11: Instance found. SR006_assessment_retrieval is consistent. </span></span><span style="display:flex;"><span> #12: Instance found. SR006_parameter_retrieval is consistent. </span></span><span style="display:flex;"><span> #13: Instance found. run$13 is consistent. </span></span></code></pre></div><p>↑OK &#x2705;</p> <p><code>SR006</code>の例示結果は<code>SR005</code>と変わらなかった。</p> <h3 id="sr007-取得可能性その2">SR007: 取得可能性その2</h3> <blockquote> <p>R007: 版を指定した取得要求には、その版に記録された内容を返さなければならない</p> </blockquote> <p>これは原理的には<code>SR001</code>と<code>SR002</code>で既に満たされている:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:moodel.als" data-lang="diff:moodel.als"><span style="display:flex;"><span> <span style="color:#719e07">run</span> SR006_parameter_retrieval </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR007: Retrieval requests return the contents recorded in that version</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// (Automatically satisfied because revision content is immutable)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR007_assessment_data_can_be_retrieved_by_revision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> data: AssessmentData <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> adr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> data <span style="color:#719e07">=</span> adr<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR007_parameter_set_can_be_retrieved_by_revision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> params: ParameterSet <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> psr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> params <span style="color:#719e07">=</span> psr<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR007_assessment_data_can_be_retrieved_by_revision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR007_parameter_set_can_be_retrieved_by_revision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p>実際の挙動がこれを満たすようにするのは実装時の責任。</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>15 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: Instance found. SR001_registration is consistent. </span></span><span style="display:flex;"><span> #2: Instance found. SR002_content_stability is consistent. </span></span><span style="display:flex;"><span> #3: No counterexample found. SR003_new_version_on_change may be valid. </span></span><span style="display:flex;"><span> #4: Instance found. SR003_assessment_update is consistent. </span></span><span style="display:flex;"><span> #5: Instance found. SR003_parameter_update is consistent. </span></span><span style="display:flex;"><span> #6: Instance found. SR004_revision_chain is consistent. </span></span><span style="display:flex;"><span> #7: No counterexample found. SR005_idempotency may be valid. </span></span><span style="display:flex;"><span> #8: Instance found. SR005_assessment_retry is consistent. </span></span><span style="display:flex;"><span> #9: Instance found. SR005_parameter_retry is consistent. </span></span><span style="display:flex;"><span> #10: No counterexample found. SR006_retrievability may be valid. </span></span><span style="display:flex;"><span> #11: Instance found. SR006_assessment_retrieval is consistent. </span></span><span style="display:flex;"><span> #12: Instance found. SR006_parameter_retrieval is consistent. </span></span><span style="display:flex;"><span> #13: Instance found. SR007_assessment_by_revision is consistent. </span></span><span style="display:flex;"><span> #14: Instance found. SR007_parameter_by_revision is consistent. </span></span><span style="display:flex;"><span> #15: Instance found. run$15 is consistent. </span></span></code></pre></div><p>↑OK &#x2705;</p> <p>今回の変更も、モデルに構造的な変化はなかった。</p> <h3 id="sr008-最新版の参照">SR008: 最新版の参照</h3> <blockquote> <p>SR008 評価データおよびパラメータセットは、それぞれ高々1つの最新版を持たなければならない</p> </blockquote> <p>この要件は、既に<code>Registry</code>の設計レベルで保証されている。 保証しているのは、下記<code>current-</code>の<code>lone</code>参照だ:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-alloy" data-lang="alloy"><span style="display:flex;"><span><span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> currentAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> currentParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> registeredAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">set</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> registeredParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">set</span> ParameterSetRevision, </span></span><span style="display:flex;"><span> <span style="color:#586e75">// SR005: Track responses by HashKey (idempotency key) for idempotency verification</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> responseLog: HashKey <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> Response </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span></code></pre></div><p>一応、ここでも正常ケースを例示しておく:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:moodel.als" data-lang="diff:moodel.als"><span style="display:flex;"><span> <span style="color:#719e07">run</span> SR007_parameter_by_revision </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR008: AssessmentData and ParameterSet each have at most one current revision</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// (Enforced by the lone multiplicity of the current revision fields)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR008_assessment_data_has_one_current_among_registered_revisions <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">disj</span> previousRevision, currentRevision: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> previousRevision <span style="color:#719e07">+</span> currentRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> currentRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR008_parameter_set_has_one_current_among_registered_revisions <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">disj</span> previousRevision, currentRevision: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> previousRevision <span style="color:#719e07">+</span> currentRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> currentRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR008_assessment_data_has_one_current_among_registered_revisions </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR008_parameter_set_has_one_current_among_registered_revisions </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p>Execute All:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>17 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: Instance found. SR001_registration is consistent. </span></span><span style="display:flex;"><span> #2: Instance found. SR002_content_stability is consistent. </span></span><span style="display:flex;"><span> #3: No counterexample found. SR003_new_version_on_change may be valid. </span></span><span style="display:flex;"><span> #4: Instance found. SR003_assessment_update is consistent. </span></span><span style="display:flex;"><span> #5: Instance found. SR003_parameter_update is consistent. </span></span><span style="display:flex;"><span> #6: Instance found. SR004_revision_chain is consistent. </span></span><span style="display:flex;"><span> #7: No counterexample found. SR005_idempotency may be valid. </span></span><span style="display:flex;"><span> #8: Instance found. SR005_assessment_retry is consistent. </span></span><span style="display:flex;"><span> #9: Instance found. SR005_parameter_retry is consistent. </span></span><span style="display:flex;"><span> #10: No counterexample found. SR006_retrievability may be valid. </span></span><span style="display:flex;"><span> #11: Instance found. SR006_assessment_retrieval is consistent. </span></span><span style="display:flex;"><span> #12: Instance found. SR006_parameter_retrieval is consistent. </span></span><span style="display:flex;"><span> #13: Instance found. SR007_assessment_by_revision is consistent. </span></span><span style="display:flex;"><span> #14: Instance found. SR007_parameter_by_revision is consistent. </span></span><span style="display:flex;"><span> #15: Instance found. SR008_assessment_current is consistent. </span></span><span style="display:flex;"><span> #16: Instance found. SR008_parameter_current is consistent. </span></span><span style="display:flex;"><span> #17: Instance found. run$17 is consistent. </span></span></code></pre></div><p>↑ OK &#x2705;</p> <p>正常系を図示する: <figure><img src="https://rindrics.com/images/2026-07-29-data/sr008.webp" alt="SR008を満たすケースの一例"><figcaption> <p>SR008を満たすケースの一例</p> </figcaption> </figure> ↑この例では、RegistryはAssessmentDataRevision0を最新版として参照している。</p> <h3 id="sr009-登録成功後の最新版の参照">SR009: 登録成功後の最新版の参照</h3> <blockquote> <p>SR009: 新しい版の登録成功後、最新版は新しい版を指さなければならない</p> </blockquote> <p>この要件は、<code>registerAssessmentData</code> などのpredの定義で保証済み。 具体的には下記の部分だ:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-alloy" data-lang="alloy"><span style="display:flex;"><span><span style="color:#719e07">pred</span> registerAssessmentData<span style="color:#719e07">[</span>at: AssessmentTarget, assessmentData: AssessmentData, idempotencyKey: HashKey<span style="color:#719e07">]</span> <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> adr: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> idempotencyKey <span style="color:#719e07">=</span> adr<span style="color:#719e07">.</span>id <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span> adr<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">=</span> assessmentData <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> adr <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> adr <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog <span style="color:#719e07">+</span> idempotencyKey <span style="color:#719e07">-&gt;</span> r </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span></code></pre></div><p>この定義は、例えば下記のような状況を表現している:</p> <ol> <li><code>AssessmentTarget</code>が<code>2026年度カタクチ太平洋</code>、<code>currentAssessmentData</code>が<code>someRevisionHash</code>に紐づくデータである状態</li> <li>新しい登録リクエストが届く: 「<code>2026年度カタクチ太平洋</code>、<code>新しいassessmentData</code>、<code>新しいidempotency key</code>」</li> <li><code>newRevisionHash</code>と紐づいた<code>currentAssessmentData</code>が<code>2026年度のカタクチ太平洋</code>の最新版として保持される</li> </ol> <p>ここでも正常系を明示的に例示してみる:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-diff:model.als" data-lang="diff:model.als"><span style="display:flex;"><span> <span style="color:#719e07">run</span> SR008_parameter_current </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#586e75">// SR009: Successful registration makes the new revision current</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR009_assessment_advance <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">disj</span> previousRevision, newRevision: AssessmentDataRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> data: AssessmentData, hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> registerAssessmentData<span style="color:#719e07">[</span>at, newRevision, data, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> newRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">pred</span> SR009_parameter_advance <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">disj</span> previousRevision, newRevision: ParameterSetRevision, </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> params: ParameterSet, hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> registerParameterSet<span style="color:#719e07">[</span>at, newRevision, params, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> newRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR009_assessment_advance </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span><span style="color:#719e07">run</span> SR009_parameter_advance </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">+</span> </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span></code></pre></div><p>Execute Allはall green &#x2705;</p> <p><figure><img src="https://rindrics.com/images/2026-07-29-data/sr009.webp" alt="SR009を満たすケースの一例"><figcaption> <p>SR009を満たすケースの一例</p> </figcaption> </figure> こちらも、モデルに構造的な変化は見られないように思う。</p> <h3 id="sr010-不変性その3">SR010: 不変性その3</h3> <blockquote> <p>SR010: 新しい版が登録されても、過去の版を変更または削除してはならない</p> </blockquote> <p>こちらは実装の責任なのでモデル検証はスキップ。</p> <h3 id="モデル全体">モデル全体</h3> <p>ここまでの検証で、Alloyのコード全体は最終的に下記のようになった:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-alloy:model.als" data-lang="alloy:model.als"><span style="display:flex;"><span><span style="color:#719e07">module</span> DataRegistry </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 1. System Requirements </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR001: Each AssessmentData and ParameterSet should be managed through revisions.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR002: The contents of a revision should not be modified after registration.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR003: When modifying AssessmentData or ParameterSet, a new version must be created instead of updating the existing version.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR004: A new version must reference exactly zero or one previous version as its source.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR005: For registration requests with identical IdempotencyKey, the same result must be returned without creating duplicate versions.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR006: After successful registration, the registered version must be retrievable via the retrieval API.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR007: Retrieval requests specifying a version must return the contents recorded in that version.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR008: AssessmentData and ParameterSet must each have at most one current version.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR009: After successful registration of a new version, the current version must point to the new version.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR010: Past versions must not be modified or deleted even after a new version is registered.</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 2. Domain </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> Resource <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> AnnualAssessment <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> AssessmentTarget <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> resource: <span style="color:#719e07">one</span> Resource, </span></span><span style="display:flex;"><span> year: <span style="color:#719e07">one</span> AnnualAssessment </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> AssessmentData <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> ParameterSet <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">abstract</span> <span style="color:#268bd2">sig</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> AssessmentDataRevisionId, ParameterSetRevisionId <span style="color:#719e07">extends</span> RevisionId <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> HashKey <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">abstract</span> <span style="color:#268bd2">sig</span> Status <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Success, Failure <span style="color:#719e07">extends</span> Status <span style="color:#719e07">{}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> Response <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> revision: <span style="color:#719e07">lone</span> <span style="color:#719e07">(</span>AssessmentDataRevision <span style="color:#719e07">+</span> ParameterSetRevision<span style="color:#719e07">)</span>, </span></span><span style="display:flex;"><span> status: <span style="color:#719e07">one</span> Status </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR002: Each revision has unique identifier</span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> AssessmentDataRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> id: <span style="color:#719e07">one</span> AssessmentDataRevisionId, </span></span><span style="display:flex;"><span> assessmentData: <span style="color:#719e07">one</span> AssessmentData, </span></span><span style="display:flex;"><span> previousSource: <span style="color:#719e07">lone</span> AssessmentDataRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#268bd2">sig</span> ParameterSetRevision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> id: <span style="color:#719e07">one</span> ParameterSetRevisionId, </span></span><span style="display:flex;"><span> parameterSet: <span style="color:#719e07">one</span> ParameterSet, </span></span><span style="display:flex;"><span> previousSource: <span style="color:#719e07">lone</span> ParameterSetRevision </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR002: Unique identifier enforcement</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">fact</span> revisionIdUniqueAssessmentData <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">all</span> adr1, adr2: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> adr1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> adr2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> adr1 <span style="color:#719e07">=</span> adr2 </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">fact</span> revisionIdUniqueParameterSet <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">all</span> psr1, psr2: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> psr1<span style="color:#719e07">.</span>id <span style="color:#719e07">=</span> psr2<span style="color:#719e07">.</span>id <span style="color:#719e07">implies</span> psr1 <span style="color:#719e07">=</span> psr2 </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">fact</span> noCyclicSource <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">all</span> adr: AssessmentDataRevision <span style="color:#719e07">|</span> adr not <span style="color:#719e07">in</span> adr<span style="color:#719e07">.^</span>previousSource </span></span><span style="display:flex;"><span> <span style="color:#719e07">all</span> psr: ParameterSetRevision <span style="color:#719e07">|</span> psr not <span style="color:#719e07">in</span> psr<span style="color:#719e07">.^</span>previousSource </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 3. State </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">one</span> <span style="color:#268bd2">sig</span> Registry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> currentAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> currentParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> ParameterSetRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> registeredAssessmentData: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">set</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> registeredParameterSet: AssessmentTarget <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">set</span> ParameterSetRevision, </span></span><span style="display:flex;"><span> <span style="color:#586e75">// SR005: Track responses by HashKey (idempotency key) for idempotency verification</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">var</span> responseLog: HashKey <span style="color:#719e07">-&gt;</span> <span style="color:#719e07">lone</span> Response </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 4. Operations </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> init <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR005: Log response by idempotency key</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> registerAssessmentData<span style="color:#719e07">[</span> </span></span><span style="display:flex;"><span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span> idempotencyKey: HashKey </span></span><span style="display:flex;"><span><span style="color:#719e07">]</span> <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>idempotencyKey<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> adr<span style="color:#719e07">.</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> adr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData <span style="color:#719e07">++</span> at <span style="color:#719e07">-&gt;</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog <span style="color:#719e07">+</span> idempotencyKey <span style="color:#719e07">-&gt;</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>idempotencyKey<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> registerParameterSet<span style="color:#719e07">[</span> </span></span><span style="display:flex;"><span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> psr: ParameterSetRevision, </span></span><span style="display:flex;"><span> idempotencyKey: HashKey </span></span><span style="display:flex;"><span><span style="color:#719e07">]</span> <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>idempotencyKey<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> psr<span style="color:#719e07">.</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> psr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet <span style="color:#719e07">++</span> at <span style="color:#719e07">-&gt;</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet <span style="color:#719e07">+</span> at <span style="color:#719e07">-&gt;</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog <span style="color:#719e07">+</span> idempotencyKey <span style="color:#719e07">-&gt;</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>idempotencyKey<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> stutter <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>registeredParameterSet </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> step <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> stutter </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> registerAssessmentData<span style="color:#719e07">[</span>at, adr, hk<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision, hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> registerParameterSet<span style="color:#719e07">[</span>at, psr, hk<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">fact</span> traces <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> init </span></span><span style="display:flex;"><span> <span style="color:#719e07">always</span> step </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 5. Properties </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR001: At most one current version per AssessmentTarget</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// (Automatically satisfied by Registry definition: lone AssessmentDataRevision)</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR001_registration <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span> psr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR001_registration <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR002: The contents of a revision should not be modified after registration.</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// (Automatically satisfied by definition)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR002_content_stability <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> adr: AssessmentDataRevision, psr: ParameterSetRevision, </span></span><span style="display:flex;"><span> data: AssessmentData, params: ParameterSet <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> adr<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">=</span> data </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> psr<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">=</span> params </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">after</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> adr<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">=</span> data </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> psr<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">=</span> params </span></span><span style="display:flex;"><span> <span style="color:#719e07">))</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR002_content_stability </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">4</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR003: When modifying, a new version must be created instead of updating the existing version</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">assert</span> SR003_new_version_on_change <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">always</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">all</span> at: AssessmentTarget <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">implies</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">in</span> <span style="color:#719e07">(</span>Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]).~</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">all</span> at: AssessmentTarget <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> <span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">implies</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">in</span> <span style="color:#719e07">(</span>Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]).~</span>previousSource<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">check</span> SR003_new_version_on_change <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR003_assessment_update <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> source, newRevision: AssessmentDataRevision, </span></span><span style="display:flex;"><span> hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> source<span style="color:#719e07">.</span>assessmentData <span style="color:#719e07">!=</span> newRevision<span style="color:#719e07">.</span>assessmentData </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerAssessmentData<span style="color:#719e07">[</span>at, newRevision, hk<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR003_parameter_update <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> source, newRevision: ParameterSetRevision, </span></span><span style="display:flex;"><span> hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> source<span style="color:#719e07">.</span>parameterSet <span style="color:#719e07">!=</span> newRevision<span style="color:#719e07">.</span>parameterSet </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> source </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerParameterSet<span style="color:#719e07">[</span>at, newRevision, hk<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR003_assessment_update </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR003_parameter_update </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR004: Each revision can reference exactly zero or one previous version</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// (Enforced by previousSource: lone field definition - no explicit assertion needed)</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR004_revision_chain <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> rootAdr, derivedAdr: AssessmentDataRevision, </span></span><span style="display:flex;"><span> rootPsr, derivedPsr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> rootAdr <span style="color:#719e07">!=</span> derivedAdr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> rootAdr<span style="color:#719e07">.</span>previousSource </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> derivedAdr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> rootAdr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> rootPsr <span style="color:#719e07">!=</span> derivedPsr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> rootPsr<span style="color:#719e07">.</span>previousSource </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> derivedPsr<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> rootPsr </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR004_revision_chain </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">4</span> <span style="color:#719e07">but</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> AssessmentDataRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> ParameterSetRevision, </span></span><span style="display:flex;"><span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> AssessmentDataRevisionId, </span></span><span style="display:flex;"><span> <span style="color:#719e07">exactly</span> <span style="color:#2aa198">2</span> ParameterSetRevisionId, </span></span><span style="display:flex;"><span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">2</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR005: Idempotency - same HashKey (idempotency key) returns same response</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">assert</span> SR005_idempotency <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">always</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">all</span> hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">])</span> <span style="color:#719e07">implies</span> <span style="color:#719e07">always</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">check</span> SR005_idempotency <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR005_assessment_retry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerAssessmentData<span style="color:#719e07">[</span>at, adr, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">after</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerAssessmentData<span style="color:#719e07">[</span>at, adr, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR005_parameter_retry <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision, </span></span><span style="display:flex;"><span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerParameterSet<span style="color:#719e07">[</span>at, psr, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">after</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerParameterSet<span style="color:#719e07">[</span>at, psr, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">&#39;[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR005_assessment_retry </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR005_parameter_retry </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR006: After successful registration, the registered version must be retrievable</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// If response is logged as successful, the revision must remain registered</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">assert</span> SR006_retrievability <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">always</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">all</span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">implies</span> <span style="color:#719e07">(</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> adr <span style="color:#719e07">and</span> adr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">or</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> psr <span style="color:#719e07">and</span> psr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">check</span> SR006_retrievability <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR006_assessment_retrieval <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> adr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> adr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR006_parameter_retrieval <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision, </span></span><span style="display:flex;"><span> hk: HashKey, r: Response <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> r </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>status <span style="color:#719e07">=</span> Success </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> r<span style="color:#719e07">.</span>revision <span style="color:#719e07">=</span> psr </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> psr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">])</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR006_assessment_retrieval </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR006_parameter_retrieval </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR007: Retrieval requests return the contents recorded in that version</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// (Automatically satisfied because revision content is immutable)</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR007_assessment_by_revision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, adr: AssessmentDataRevision, </span></span><span style="display:flex;"><span> data: AssessmentData <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> adr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> data <span style="color:#719e07">=</span> adr<span style="color:#719e07">.</span>assessmentData<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR007_parameter_by_revision <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, psr: ParameterSetRevision, </span></span><span style="display:flex;"><span> params: ParameterSet <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> psr <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> params <span style="color:#719e07">=</span> psr<span style="color:#719e07">.</span>parameterSet<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR007_assessment_by_revision </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR007_parameter_by_revision </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR008: AssessmentData and ParameterSet each have at most one current revision</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// (Enforced by the lone multiplicity of the current revision fields)</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR008_assessment_current <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> <span style="color:#719e07">disj</span> previousRevision, currentRevision: AssessmentDataRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> previousRevision <span style="color:#719e07">+</span> currentRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> currentRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR008_parameter_current <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> <span style="color:#719e07">disj</span> previousRevision, currentRevision: ParameterSetRevision <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> previousRevision <span style="color:#719e07">+</span> currentRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> currentRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR008_assessment_current </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR008_parameter_current </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR009: Successful registration makes the new revision current</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR009_assessment_advance <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> <span style="color:#719e07">disj</span> previousRevision, newRevision: AssessmentDataRevision, </span></span><span style="display:flex;"><span> hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerAssessmentData<span style="color:#719e07">[</span>at, newRevision, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> newRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR009_parameter_advance <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> <span style="color:#719e07">disj</span> previousRevision, newRevision: ParameterSetRevision, </span></span><span style="display:flex;"><span> hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerParameterSet<span style="color:#719e07">[</span>at, newRevision, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> newRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR009_assessment_advance </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR009_parameter_advance </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// SR010: Past versions must not be modified or deleted even after a new version is registered</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// (Automatically satisfied by operation design: registerAssessmentData/registerParameterSet only extend</span> </span></span><span style="display:flex;"><span><span style="color:#586e75">// the mapping with new versions; they never modify or remove existing entries)</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR010_assessment_history <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> <span style="color:#719e07">disj</span> previousRevision, newRevision: AssessmentDataRevision, </span></span><span style="display:flex;"><span> hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> previousRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerAssessmentData<span style="color:#719e07">[</span>at, newRevision, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> previousRevision <span style="color:#719e07">+</span> newRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentAssessmentData<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> newRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">pred</span> SR010_parameter_history <span style="color:#719e07">{</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">eventually</span> <span style="color:#719e07">(</span><span style="color:#719e07">some</span> at: AssessmentTarget, </span></span><span style="display:flex;"><span> <span style="color:#719e07">disj</span> previousRevision, newRevision: ParameterSetRevision, </span></span><span style="display:flex;"><span> hk: HashKey <span style="color:#719e07">|</span> </span></span><span style="display:flex;"><span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> previousRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> newRevision<span style="color:#719e07">.</span>previousSource <span style="color:#719e07">=</span> previousRevision </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> <span style="color:#719e07">no</span> Registry<span style="color:#719e07">.</span>responseLog<span style="color:#719e07">[</span>hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> registerParameterSet<span style="color:#719e07">[</span>at, newRevision, hk<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> previousRevision <span style="color:#719e07">+</span> newRevision <span style="color:#719e07">in</span> Registry<span style="color:#719e07">.</span>registeredParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> </span></span><span style="display:flex;"><span> <span style="color:#719e07">and</span> Registry<span style="color:#719e07">.</span>currentParameterSet<span style="color:#719e07">&#39;[</span>at<span style="color:#719e07">]</span> <span style="color:#719e07">=</span> newRevision<span style="color:#719e07">)</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR010_assessment_history </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> SR010_parameter_history </span></span><span style="display:flex;"><span> <span style="color:#719e07">for</span> <span style="color:#2aa198">3</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span> AssessmentTarget, <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#586e75">/* ============================================================ </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> 6. Sanity </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> ============================================================ */</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#719e07">run</span> <span style="color:#719e07">{}</span> <span style="color:#719e07">for</span> <span style="color:#2aa198">2</span> <span style="color:#719e07">but</span> <span style="color:#2aa198">1</span><span style="color:#719e07">..</span><span style="color:#2aa198">3</span> <span style="color:#719e07">steps</span> </span></span></code></pre></div><p>Execute Allの結果:</p> <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>21 commands were executed. The results are: </span></span><span style="display:flex;"><span> #1: Instance found. SR001_registration is consistent. </span></span><span style="display:flex;"><span> #2: Instance found. SR002_content_stability is consistent. </span></span><span style="display:flex;"><span> #3: No counterexample found. SR003_new_version_on_change may be valid. </span></span><span style="display:flex;"><span> #4: Instance found. SR003_assessment_update is consistent. </span></span><span style="display:flex;"><span> #5: Instance found. SR003_parameter_update is consistent. </span></span><span style="display:flex;"><span> #6: Instance found. SR004_revision_chain is consistent. </span></span><span style="display:flex;"><span> #7: No counterexample found. SR005_idempotency may be valid. </span></span><span style="display:flex;"><span> #8: Instance found. SR005_assessment_retry is consistent. </span></span><span style="display:flex;"><span> #9: Instance found. SR005_parameter_retry is consistent. </span></span><span style="display:flex;"><span> #10: No counterexample found. SR006_retrievability may be valid. </span></span><span style="display:flex;"><span> #11: Instance found. SR006_assessment_retrieval is consistent. </span></span><span style="display:flex;"><span> #12: Instance found. SR006_parameter_retrieval is consistent. </span></span><span style="display:flex;"><span> #13: Instance found. SR007_assessment_by_revision is consistent. </span></span><span style="display:flex;"><span> #14: Instance found. SR007_parameter_by_revision is consistent. </span></span><span style="display:flex;"><span> #15: Instance found. SR008_assessment_current is consistent. </span></span><span style="display:flex;"><span> #16: Instance found. SR008_parameter_current is consistent. </span></span><span style="display:flex;"><span> #17: Instance found. SR009_assessment_advance is consistent. </span></span><span style="display:flex;"><span> #18: Instance found. SR009_parameter_advance is consistent. </span></span><span style="display:flex;"><span> #19: Instance found. SR010_assessment_history is consistent. </span></span><span style="display:flex;"><span> #20: Instance found. SR010_parameter_history is consistent. </span></span><span style="display:flex;"><span> #21: Instance found. run$21 is consistent. </span></span></code></pre></div><p>↑ OK &#x2705;</p> <h2 id="学んだこと">学んだこと</h2> <p>今回は反省点が多い。 途中から雲行きの怪しさを感じていた。 まとめると下記だ:</p> <ul> <li>要件定義が雑すぎた</li> <li>スコープを決めていなかった</li> <li>進め方の戦略がなかった</li> </ul> <h3 id="要件定義が雑すぎた">要件定義が雑すぎた</h3> <p>一つ一つの要件の検証にかなり時間をかけているわけだが、そもそもそれぞれの要件自体の吟味が足りていないかった。要件をかっちり決める手法として、昔（確か2022年くらい）<a href="https://www.shoeisha.co.jp/book/detail/9784798146522">この本</a>を読んだことでICONIXを知ったのだが、当時は重厚すぎるような印象を持っていた。</p> <p>今回設計しているdata-registryは、<a href="https://rindrics.com/posts/stock-assess-api-contract-postmortem/#:~:text=data%20service%E3%81%AE%E3%82%88%E3%81%86%E3%81%AA%E7%8B%AC%E7%AB%8B%E3%81%97%E3%81%9F%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%81%8C%E5%BF%85%E8%A6%81%E3%81%AB%E6%80%9D%E3%82%8F%E3%82%8C%E3%82%8B">構想当時</a>にはとてもシンプルなものという見立てだったが、少し設計してみると考えるべきことがどんどん出てくる（なお今、この設計でも観点が全然足りていないだろう）。</p> <h3 id="スコープを決めていなかった">スコープを決めていなかった</h3> <p>今回は合計で10要件を検証したように書いているが、実は途中でどんどん要件が増えてしまい、最終的に20を超えてしまっていた。 収集がつかなくなりそうだったので、記事としてはいったん10の要件で一区切りとすることにした。 ちなみに区切りとするために捨てた機能は「アーカイブ」「物理削除」「外部公開」の三つ。 非機能要件としては並行性への対処を無視している。 時間の関係から、そもそも「機能」「スコープ」について言及していない内容になってしまったが、このやり方は是非真似しないでほしい（？）。</p> <h3 id="進め方の戦略がなかった">進め方の戦略がなかった</h3> <p>これは上記二つの反省点と同列ではなく、より上位の観点にある。 Alloyで検証することが決まっているような形で走り始めてしまったため、Alloyでの検証に向かないような要件が出てきたときに管理できなくなった。 今後の管理を考えると、サービスごとにユースケース・要求・要件にIDをふってドキュメント化しておくといいかもしれない。 そろそろカンバンを作るか。</p> <p>・・・</p> <p>反省点は多いし、設計にまだ穴もあるだろうが、そろそろ動くものを作りたい。 いや、その前に冪等性の定義とDB設計があるか。</p> <p>作業の進捗としてはこんな感じだろうか:</p> <ul> <li><input checked="" disabled="" type="checkbox"> API契約を書く</li> <li><input checked="" disabled="" type="checkbox"> ルーティングの動作確認</li> <li><input checked="" disabled="" type="checkbox"> db セットアップ</li> <li><input checked="" disabled="" type="checkbox"> リポジトリ・ハンドラの実装</li> <li><input disabled="" type="checkbox"> <del>datasetVersion生成ロジックの設計</del></li> <li><input checked="" disabled="" type="checkbox"> API基本設計</li> <li><input disabled="" type="checkbox"> Revision生成ロジックの設計</li> <li><input disabled="" type="checkbox"> データベース設計</li> <li><input disabled="" type="checkbox"> リファクタリング</li> <li><input disabled="" type="checkbox"> エラーハンドリングの追加</li> </ul> <p>つづく</p> <h2 id="参考情報">参考情報</h2> <ul> <li>Geewax (2022)『APIデザインパターン』マイナビ出版</li> </ul> <div class="footnotes" role="doc-endnotes"> <hr> <ol> <li id="fn:1"> <p>たまたま『<a href="https://book.mynavi.jp/ec/products/detail/id=131252">APIデザインパターン</a>』を読んでいたのだった。第28章「リソースリビジョン」がドンピシャの内容だった&#160;<a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> <li id="fn:2"> <p>『抽象によるソフトウェア設計』でも解説されており、特異な例を見つけるのに有用とされている。それはたしかにそうかも。ちなみに、このAlloyの挙動を決めているのは解析エンジンの挙動。私の環境ではSAT4Jソルバーだったので、SAT4Jのコードを見てみたところ、<a href="https://gitlab.ow2.org/sat4j/sat4j/-/commit/b0f351ab54a30fa9cb787e2a197954a700da5872?file_path=org.sat4j.core%2Fsrc%2Fmain%2Fjava%2Forg%2Fsat4j%2Fminisat%2Forders%2FSolutionPhaseSelectionStrategy.java#line_0f73d4584_A60">この部分</a>によって、解決フェーズでまず<code>false</code>が試されそうだった&#160;<a href="#fnref:2" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> <li id="fn:3"> <p>Alloyによる探索が有限スコープなのは実用観点で脇に置いておく&#160;<a href="#fnref:3" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> </ol> </div> https://rindrics.com/posts/stock-assess-data-registry-ubiquitous-language/ Sat, 01 Aug 2026 00:00:00 +0900 https://rindrics.com/posts/stock-assess-data-registry-ubiquitous-language/ <p>アプリケーションの設計を実際の資源評価事業のメンタルモデルが反映されたものにするために、資源評価事業で使うユビキタス言語を整理した。</p> <h2 id="はじめに">はじめに</h2> <p>ユビキタス言語がないと、アプリケーションの仕様をちゃんとモデリングできない。 例えばこの記事を書いた時点では<a href="../stock-assess-data-registry-1/">データ登録サービス</a>を作っていて、設計中に「データ」や「データセット」などの表現が混在してしまっていた。 設計を整理する中で「メタデータ」なる表現も出てきたが、資源評価担当者だった当時を振り返っても、こんな表現を使ったことは一度もなかったように思う。</p> <p>データ登録サービスを開発しようとしている現時点に限って言えば、いま必要なのは<a href="https://www.fra.go.jp/shigen/fisheries_resources/meeting/stock_assessment_meeting/2019-2022/files/glossary20190610.pdf">水産研究・教育機構が掲載している &ldquo;用語集&rdquo;</a>にあるような、評価・管理観点の用語ではなく、データを扱う評価担当者が使っている用語だ。 それゆえに対外的に公表されにくい<sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup>。</p> <p>ということで、本記事ではデータ登録サービスのユビキタス言語を整理していく。</p> <h2 id="設計に必要な用語の種類">設計に必要な用語の種類</h2> <p>用語の整理は、下記二つに分類する:</p> <ul> <li>ドメイン語彙（ユビキタス言語）: 業務で実際に使われているもの</li> <li>モデル語彙: 業務で使われることはないが、期待される動作を実現するためにモデリング上必要な語彙</li> </ul> <p>前者は問題空間の用語、後者は解決空間の用語。</p> <h3 id="ドメイン語彙">ドメイン語彙</h3> <table> <thead> <tr> <th>用語</th> <th>形式言語内での表現</th> <th>意味</th> </tr> </thead> <tbody> <tr> <td>資源</td> <td>Resource</td> <td>評価対象となる種名と系群の組。例：「カタクチイワシ・太平洋系群」。日常会話では「カタクチ太平洋」のように略して呼ぶことがある</td> </tr> <tr> <td>年度評価</td> <td>AnnualAssessment</td> <td>特定の年度に実施する資源評価。例：「2026年度評価」</td> </tr> <tr> <td>評価対象</td> <td>AssessmentTarget</td> <td>年度評価と資源の組。例：「2026年度のカタクチ太平洋」</td> </tr> <tr> <td>評価データ</td> <td>AssessmentData</td> <td>年度評価で利用するデータ。例：年齢別漁獲尾数、年齢別体重、年齢別成熟率</td> </tr> <tr> <td>パラメータセット</td> <td>ParameterSet</td> <td>評価計算で使用するパラメータの集合</td> </tr> <tr> <td>シナリオ</td> <td>Scenario</td> <td>評価作業中に比較・検討する論理的な単位。例：「昨年度踏襲」「手法A検討用」。シナリオは、使用する評価データやパラメータセットを参照する</td> </tr> <tr> <td>版</td> <td>Revision</td> <td>評価データまたはパラメータセットの不変なスナップショット。内容を修正するときは、既存の版を変更せず、新しい版を作成する</td> </tr> <tr> <td>最新版</td> <td>CurrentRevision</td> <td>評価データまたはパラメータセットについて、現在使用するものとして選択されている版</td> </tr> <tr> <td>外部公開</td> <td>Publish</td> <td>評価データまたはパラメータセットの特定の版を、組織外から利用可能な状態にすること</td> </tr> </tbody> </table> <h3 id="モデル語彙">モデル語彙</h3> <table> <thead> <tr> <th>用語</th> <th>形式言語内での表現</th> <th>意味</th> </tr> </thead> <tbody> <tr> <td>アーカイブ</td> <td>Archive</td> <td>評価データ、パラメータセットまたはシナリオを通常の利用対象から外すこと。版の内容は保持する</td> </tr> <tr> <td>物理削除</td> <td>Erase</td> <td>機密情報の誤登録などに対応するため、版に記録された内容そのものを削除すること</td> </tr> <tr> <td>登録要求識別子</td> <td>IdempotencyKey</td> <td>同一の登録要求を識別するために、コンシューマーが登録要求に付与する識別子</td> </tr> </tbody> </table> <h2 id="まとめ">まとめ</h2> <p>手元でのモデリングを進めるうえで必要だったので、ひとまずはこんなところでいいだろう。</p> <p>確認のために「エヴァンス本」の第2章を読み返していたのだが、「高次の構成原理（コンテキストマップや大規模な構造など）」も、今後必要になったら整理したほうがいいかも。</p> <h2 id="参考情報">参考情報</h2> <ul> <li><a href="https://www.shoeisha.co.jp/book/detail/9784798126708">Eric Evans（2013）『エリック・エヴァンスのドメイン駆動設計』翔泳社（邦訳版）</a></li> </ul> <div class="footnotes" role="doc-endnotes"> <hr> <ol> <li id="fn:1"> <p>公表されないのは機密的な問題ではなく、インセンティブの問題。内部で（何気なく）しか使わない専門表現をわざわざ整理して公開するインセンティブなどどこにもない。専門用語として認識されてすらいないこともある。&#160;<a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> </li> </ol> </div>