/layers-conceptual-model
フレームワークのコンテキストとして/layers-introが読み込まれていることを前提とします。
概念モデルは、最も軽視されがちな荷重支持レイヤーです。これは、プロダクトが認識するオブジェクト、その関係、各オブジェクトが取り得る状態、そしてすべてに使用される語彙を定義します。これはソリューション空間に存在します。すなわち、ユーザーの既存のメンタルモデル(矛盾しており乱雑なもの — それはドメインレイヤーの役割です)をそのまま取り込むのではなく、プロダクトがどのようにドメインをモデル化するかについての意図的な設計判断です。
それが何であるか、そして何でないか:
- 設計判断 — 乱雑なドメインを一貫性のある、明確な意見を持つ構造に解決します。
- データベーススキーマではない — エンジニアは独自のデータ判断を行いますが、このモデルと彼らが構築するものとの間のギャップは重要です。大きく、検証されていないギャップは、UX負債(ユーザーがモデルと矛盾するプロダクトに遭遇する)と技術負債(システムの進化が困難になる)の両方です。
- ワイヤーフレームやフローではない — 画面もナビゲーションもありません。それらは上位のレイヤーに属します。
- 中立的ではない — あらゆる命名判断、あらゆる関係の境界、あらゆる含まれる、または除外されるオブジェクトは、ある視点を反映しています。
このレイヤーが行う必要のある判断:
- このプロダクトはどのオブジェクトを認識し、それらの境界は何か?
- それらのオブジェクトは互いにどのように関係するか?
- ユーザーは各オブジェクトで何ができるか?
- 各オブジェクトはどのような状態を取り得るか、そしてどの遷移が重要か?
- プロダクトの語彙は何か — コンセプトごとに一つの名前、それを選択し、それにコミットする。
手法:
| 手法 | いつ使用するか |
|---|---|
| 名詞採取 + OOUX (Sophia Prater) | リサーチやドメインノートをマイニングする材料がある場合のデフォルト。自然言語からオブジェクトを抽出します。 |
| セマンティックIxD / アクション文法 (Daniel Rosenberg) | 多くのオブジェクトにまたがる多くのアクションがあり、動詞の一貫性と正確性を監査したい場合。 |
| イベントストーミング — コマンド/ポリシーフェーズ (Brandolini) | ドメインに複雑なプロセスがある場合。何が起こるかから始め、関与するオブジェクトにさかのぼって作業します。 |
| カードソーティング | 語彙がチーム間やユーザー間で不明確または議論の的となっている場合。 |
| DDD境界付けられたコンテキストマッピング | 複数のユーザータイプが同じ言葉を異なる意味で使用している場合 — モデルに自然な継ぎ目がある表面を明らかにします。 |
| 既存のプロダクトをウォークスルーする | リデザインの場合。現在のUIは暗黙のモデルを明らかにします — それをユーザーが実際にどう考えているかと比較します。 |
デフォルト:名詞採取とオブジェクト定義。
品質シグナル — 良い状態の見え方:
- すべてのオブジェクトはユーザーにとって独立して意味がある — UI要素ではなく、曖昧な抽象化でもない
- オブジェクトが複数の役割を果たせる場合、関係の役割が明示的に命名されている
- 実際には関係である属性は、挑戦され、変換されている
- 投機的な追加はない — すべてのオブジェクト、属性、関係はユーザーニーズに遡れる
- オブジェクトのステータスがユーザーのできることを実質的に変更する場合、状態遷移が定義されている
- 時間に関する判断が対処されている:削除セマンティクス、関係の時間性、履歴
- ユビキタス言語が確立されている:コンセプトごとに一つの名前、名前に一つのコンセプト
ガイドセッション
モデルを定義するプロダクトや機能を教えてください。または「ガイドして」と言って、名詞採取とオブジェクト定義を開始してください。
質問:「このセッションの成果はどこに記録すればよいですか?」 (/layers-introのオプションを参照)
デザイナーが問題空間から持っているもの — ドメインノート、リサーチ、ユーザーニーズ — を確認します。何もない場合:進めますが、ドメイン知識なしに構築されたモデルは、しばしばユーザーの現実よりも仮定を反映することをフラグします。
リデザインの場合:「現在のモデルを、非形式的にでも説明してください — 既存のプロダクトが持つ暗黙のモデルは何ですか?」
フェーズ 1 — スコープを設定する
- どのプロダクトまたは機能の概念モデルを定義しますか?
- ユーザーがそれを使って行おうとしているコアジョブは何ですか?
- どのような材料を元に作業していますか?
フェーズ 2 — オブジェクトを発見する
リサーチやドメインノートから: 全ての名詞 — 物、人、役割、ドキュメント、場所、状態、概念、イベント — を抽出します。広く網をかけ、まだフィルタリングしません。生のリストを提示し、次に質問します:不足している名詞はありますか?同じものに異なる名前がついていませんか?
既存のプロダクトから: 一緒にウォークスルーします。「ユーザーはここで何を見ていますか?このものは何と呼ばれていますか?」
第一原理から: 「ユーザーが手を伸ばして何かを同僚に手渡せるとしたら、何を渡しますか?」
以下のように分類します:
- オブジェクト — 永続し、独自の属性を持ち、ユーザーにとってそれ自体で重要なもの
- 属性 — オブジェクトを説明するプロパティであり、オブジェクト自体ではないもの
- 保留 — UI要素、曖昧な抽象化、名詞に偽装されたアクション
真のオブジェクトは、ユーザーにとって独立して意味を持たなければならず、他の何かの単なるプロパティであってはなりません。
フェーズ 3 — 各オブジェクトを定義する
各コアオブジェクトについて作業します:
オブジェクト: [名前]
それが何か: [ユーザーの視点から一文]
属性: [ユーザーが知っているか気にするプロパティ]
関係: [他のオブジェクトとの接続 — カーディナリティと役割名]
アクション (CTA): [ユーザーがこのオブジェクトに対してまたはそれを使ってできること]
4つの規律チェック:
-
関係の役割: 関係が複数の役割を果たせるオブジェクト(例:紹介者と紹介された人の両方であるユーザー)に接続する場合、役割を明示的に命名します:「一人のユーザーに属する(紹介者として)」ではなく「一人のユーザーに属する」。
-
実際には関係である属性: 属性がモデル内の別のオブジェクトの名前やIDに過ぎない場合、それは関係です — モデル化し、属性として複製しないでください。
-
投機的な追加をしない: 明示されたユーザーニーズに基づいていない属性、関係、アクションを追加しないでください。概念モデルレイヤーでのスコープクリープは、上のすべてのレイヤーに波及します。
-
実装と設計判断の区別: 会話が何かがどのように生成されるか、保存されるか、計算されるかに流れた場合 — 方向転換します:「それがどのように生成されるかはエンジニアリングの問題です。ここで重要なのは:ユーザーはこれを変更できますか?すでにそれを参照しているものはどうなりますか?」
-
動詞の正確性: 各アクションについて、その動詞がユーザーに最終的に何が得られるか、または実行している現実世界の操作は何かを伝えているかどうかを問います。「PINを入力する」は、PINがすでに存在することを示唆するため失敗します — 「作成する」が正確です。より重要なのは、汎用動詞(編集、削除、更新)が、意味論的に異なる現実世界の結果を持つ操作を隠していないかチェックすることです。「住所を編集する」は、誤字の修正と引っ越しの記録という2つの操作を混同しています — 一方は履歴を保持する必要がなく、もう一方は保持する必要があります。これらは異なるシステム動作と異なるユーザー意図を必要とします。演繹的なインターフェースは汎用動詞を使用し、ユーザーに自分の意図をマッピングするよう求めます。帰納的なインターフェースは現実世界の操作に名前を付け(「住所変更を登録する」)、その意味を保持します。汎用動詞がユーザーが実際にやろうとしていることに応じて異なる意味を持ちうる場合、操作を個別に命名してください。
フェーズ 4 — オブジェクトマップ
リレーショナルオブジェクトマップを生成します:エンティティをノードとして、関係をカーディナリティマーカー付きのラベル線として。固定の向きはなく、関係が最も読みやすくなるように従います。Mermaidでは:erDiagram。
提示する際、カーディナリティを説明します:|| = 正確に1つ、o{ = 0以上、|{ = 1以上。カラスの足は常に「多」側にあります。関係ラベルは宣言された方向(最初のエンティティ → 2番目のエンティティ)で読みます。
質問:「これはこれらのものについてのあなたの考え方を反映していますか?欠けている関係、逆の方向、あるべきでない接続はありませんか?」
フェーズ 5 — 状態遷移と時間に関する判断
ライフサイクルやステータスが重要な各オブジェクトについて:「[オブジェクト]はどのような状態になりえますか?何がそれを状態間で移動させますか?各状態では何が不可能になりますか?」
状態図を生成します:状態をノードとして、遷移をラベル付き矢印として、明確な開始状態を持ちます。状態の数に応じて上から下へ、または左から右へ。Mermaidでは:stateDiagram-v2。
また、時間に関する判断(/layers-introから)を探ります:中間アクション状態、リードモデルの遅延、関係の時間性、削除セマンティクス、履歴。実装に関連する質問については、時期尚早な回答を強制せず、ユーザーエクスペリエンス要件を明確に述べ、エンジニアリングの会話のための名前付き未解決質問としてフラグします。
フェーズ 6 — ユビキタス言語
ユビキタス言語は名詞(オブジェクト、属性)と動詞(アクション)の両方をカバーします。同じ原則が両方に適用されます:コンセプトごとに一つの単語、単語ごとに一つのコンセプト。
名詞: 選択されたすべてのオブジェクトと属性名をリストします。同義語や命名の競合がある名詞については:
用語: [選択された名前]
却下された代替案: [現れた他の名前]
決定: [この用語が選ばれた理由]
動詞 — アクション語彙: すべてのオブジェクトにわたるすべてのアクション動詞をコンパイルします。2つのテストを適用します:
同義語チェック: 同じ操作に複数の動詞が使用されていませんか?同じアクションタイプに対して「作成」と「追加」は統合されるべきです。動詞語彙を最小化することは、ユーザーが学ばなければならないことを減らします — 同じ動詞がすべてのオブジェクトで同一に機能する(切り取り/コピー/貼り付けのように)ことは、ユーザーが一度学べばどこにでも転移できることを意味します。すべての同義語は新しい記憶事項です。
平坦化チェック: 逆のリスク — 一つの動詞が真に異なる操作をカバーしていること。「住所を編集する」は、単純に見えますが、実際には2つのことを混同しています:誤字の修正(上書きで問題ない)と引っ越しの記録(新しいレコードを作成し、古いものを保持する必要がある)。ドメインはこれらを異なるものとして扱います;インターフェースはそれを隠すべきではありません。各汎用CRUD動詞(編集、削除、更新、作成)について、これが異なる現実世界の結果 — 異なる履歴への影響、異なる下流効果、ユーザーが実際に達成しようとしている異なること — を持つ操作をカバーしうるかどうかを問います。もしそうなら、それらに別々の名前を与えてください。「住所変更を登録する」と「住所を修正する」は冗長ではなく、正確です。
動詞: [選択されたアクション名]
適用対象: [どのオブジェクト]
却下された代替案: [検討された他の動詞]
決定: [なぜこの動詞か;それが名付ける現実世界の操作]
「これがあなたのプロダクトのユビキタス言語です。これらの用語を一貫して使用してください — UI、ヘルプテキスト、API名、内部会話で。このモデルと表面との間のすべての不整合は、ユーザーに認知的負荷を生み出します。」
完了
以下を生成します:
- オブジェクト定義 — 属性、関係、アクション
- オブジェクトマップ —
erDiagram - 状態遷移図 — 意味のあるライフサイクルを持つオブジェクト用
- ユビキタス言語 — 解決された競合と判断を含む選択された名詞と動詞
- 未解決の質問 — 延期された判断、薄く感じられたオブジェクト、フラグされたが未解決のものすべて
次のように締めくくります:「概念モデルは、このプロダクトに何が存在するかを定義します。次に:ユーザーがそれらのオブジェクトとどのように相互作用するかを設計します。/layers-interaction-flowを実行してください。」
ドメインの作業が行われていない場合:「このモデルはドメインリサーチなしで構築されました — それは仮説です。証拠が得られたら再検討する予定を立ててください。」