メインコンテンツへスキップ
見出し画像

中学生からわかる!アジャイルモデリングとシステム設計 入門ガイド


    画像

    1. はじめに:なぜシステム開発に「設計図(モデル)」が必要なのか?

    皆さんは、友達と一緒に巨大なプラモデルを組み立てたり、秘密基地を作ったり、オリジナルのゲームを開発したりしたことがありますか? もし何も計画を立てず、いきなり部品をくっつけたり木材を切り始めたりしたらどうなるでしょう。「ここにドアを作るはずじゃなかったの?」「パーツが足りない!」と、大混乱になってしまうはずです。

    ソフトウェア開発もまったく同じです。プログラムのコード(指示文)をいきなり書き始めるのではなく、まずシステムの全体像を表す「モデル(設計図)」を作ることが非常に重要になります。

    専門的な研究分野では、モデルを中心に据えてソフトウェアを開発する手法をモデルベースソフトウェア工学(MBSE)と呼びます。また、アジャイルモデリング(Agile Modeling)の提唱者である Scott W. Ambler 氏をはじめとする研究者たちは、「何のために設計図を描くのか?」という問いに対して明確な答えを示しています。それは、「複雑で目に見えないシステムを可視化(見える化)し、チーム全員で正しく理解し合い、無駄なく良いものを作るため」です。

    システム開発においてモデルを作成することには、大きく分けると次の「2つの大きなメリット」があります。

    • 複雑なシステム全体をひと目で「可視化(見える化)」できる ソフトウェアは目に見えない抽象的な存在です。モデルを描くことで、システムの構造や動きをコンパクトでわかりやすい図に整理でき、開発者同士だけでなく、システムの完成を楽しみにしている関係者全員で「これから作るもの」のイメージを共有できます。

    • コード作成やテストを自動化・効率化し、高品質を保てる しっかりとしたモデルがあれば、プログラムコードの骨組みやテストプログラムを自動的に生成したり、設計に間違いがないかを事前に検証したりできます。これにより、手戻りやエラーを減らし、開発効率と再利用性を劇的に高めることができます。

    では、チーム全員でシステムを設計するとき、どのような『共通の図形言語』を使えばよいのでしょうか? 次の章で見ていきましょう。

    2. UML(統一モデリング言語)とは?:チーム共通の「図解絵の具」

    チームで秘密基地やゲームを作るとき、全員がバラバラの書き方で図を描いていたら、お互いの考えが伝わりませんよね。そこで登場するのが**UML(Unified Modeling Language:統一モデリング言語)**です。

    Bernhard Rumpe 氏や Agwenyi 氏らの研究が示すように、UMLはオブジェクト指向システムにおける「標準的な図解言語」として世界中で使われています。言ってみれば、**プラモデルの「世界共通の組み立て説明書記号」や「ゲーム開発の共通デザインルール」**のようなものです。

    UMLには目的に応じたさまざまな図(ダイアグラム)が存在します。主要な4つの図の役割を整理してみましょう。


    画像

    補足:ルールを文章で厳密に決める「OCL」

    図だけでは表現しきれない細かいルール(制約)を指定するために、**OCL(Object Constraint Language)**という文章表現が使われます。

    これはゲームのルールブックのようなものです。例えば「オークションシステムで入札があったとき、終了時間を『現在の時間+延長時間』に変更する(t.time == bid.time + extensionTime)」といった条件チェックや契約条件(インバリアント:システムがどんな時でも常に満たすべき普遍のルール)を正確に書き残すために利用されます。

    UMLという図解ツールを手に入れたところで、次はこれを『どのように無駄なく素早く使いこなすか』という実践方法(アジャイルモデリング)に進みましょう。

    3. アジャイルモデリング(AM)の極意:無駄を省いて効率よく設計する

    図を描くのが大切だからといって、分厚い設計図集を作ることに時間を費やしてプログラムが完成しなければ意味がありません。Scott W. Ambler 氏が提唱する**アジャイルモデリング(Agile Modeling: AM)**は、無駄な作業を徹底的に省き、本当に必要な設計だけを素早く行うための実践手法です。

    なお、アジャイルモデリングは単独で動く開発手順ではなく、XP(eXtreme Programming)、Scrum、SAFe、**RUP(Rational Unified Process)**といった全体的な開発プロセスと組み合わせて使用します。

    AMの主要なコアプラクティスは、大きく3つのグループに分類できます。

    1. ステークホルダーとの積極的な協力(みんなで会話する)

    • 関係者の積極的参加(Active Stakeholder Participation): システムを使う人や依頼主(ステークホルダー)に開発チームへ積極的に参加してもらい、質問や決定をタイムリーに行います。

    • 包摂的なツール利用(Inclusive Tools and Techniques): 難しい専門ツールばかりではなく、ホワイトボードや紙とペンなど、誰でも直感的に理解・参加できる道具を使って会話します。

    2. 「必要十分」な設計(無駄なドキュメントを作らない)

    • 初期アーキテクチャの検討(Architecture Envisioning): 開発の初期段階で、技術的な全体方針を立てるために大まかな構造を検討します。秘密基地づくりで言えば、個々の部屋を作り始める前に「全体でどんな配置にするか」というラフな全体間取り図を描いておくようなイメージです。

    • 必要最小限の成果物(JBGE: Just Barely Good Enough): モデルや文書は、その場の目的を満たす「必要十分(ギリギリ十分)」なシンプルさで止めます。秘密基地づくりで言えば、「今すぐ作る棚のスケッチだけをサッと描く」ようなもので、作らない場所の精密な図面まで事前に描く必要はありません。

    • 即興のモデリング(Model Storming): 開発の途中で疑問や設計上の問題が発生したとき、その場(JIT: Just-In-Time)で数分間集まってホワイトボードに図を描き、サッと解決します。

    • ドキュメントの後回し(Document Late): アイデアが固まっていない初期に書類を作ると、変更があった際に書き直しの無駄が生じます。仕様が確定・安定するまで提出用ドキュメント作成は後回しにします。

    • 情報の単一ソース化(Single Source Information): 同じ情報を複数の場所に重複して書かず、1箇所だけに記録して矛盾を防ぎます。

    3. テストと設計の融合(動くコードで証明する)

    • 実行可能な仕様(Executable Specifications): 読まれない静的な文章ではなく、自動実行できる「テスト(テストプログラム)」の形で要求や設計を記述します。

    • テスト駆動設計(TDD: Test-Driven Design): コードを書く前に、まず「設計を検証するためのテスト」を1つ書き、それをパスする最小限のプログラムを書くというサイクルで詳細設計を進めます。

    アジャイルモデリングの心構えが分かったところで、具体的な開発の手順(プロセスの流れ)として有名な『ICONIXプロセス』を体験してみましょう。

    4. ICONIXプロセス:アイディアを形にする7つのステップ

    Doug Rosenberg 氏によって開発された**「ICONIX(アイコニクス)プロセス」**は、ユーザーの要求(ユースケース)を起点として、アイデアをスムーズにプログラムへと変えていく実用的な手法です。

    この手法の最大の特徴は、**「手戻り(ブラッシュアップ)を大歓迎する」点です。最初から完璧な図を作ろうとせず、ユーザーの要求を表す「動的モデル(ユースケース図やシーケンス図など)」と、構造を表す「静的モデル(ドメインモデルやクラス図)」**を相互に行き来しながら、コードを書く前にモデル同士を何度も照らし合わせて洗練させていきます。

    ICONIXプロセスは、以下の7つのステップで進みます。

    [1. ドメインモデリング] ──> [2. ユースケースモデリング] ──> [3. ロバストネス分析]
                                                                      │
    [7. テスト] <── [6. 実装] <── [5. クラス図の作成] <── [4. シーケンス図の作成]
    
    1. ドメインモデリング(要求定義) これから作る世界の知識(ドメイン)を整理し、プロジェクトの用語集(ドメインモデル)を作ります。最初は完璧を目指さず、**「2時間以内」**でシンプルな言葉の関係性だけを素早く描くのがコツです。

    2. ユースケースモデリング(要求定義) ユーザー視点で「システムを使って何がしたいか」という振る舞いを、ユースケース図と文章(ユースケース記述)で定義します。ドメインモデルで決めた用語を使って書くことが重要です。

    3. ロバストネス分析(分析と予備設計) 「要求」と「詳細設計」の間にあるギャップを埋めるため、ユースケースを処理ステップごとに分解して図式化します。曖昧さや検討漏れを早期に見つけ出し、要求を「堅牢(ロバスト)」にします。

    4. シーケンス図の作成(詳細設計) ロバストネス分析で見えたオブジェクトたちに「具体的な処理の呼び出し」を割り当て、時間経過に沿った詳しい動きを描きます。

    5. クラス図の作成(詳細設計) ドメインモデルとシーケンス図をもとに、プログラムの構造を示す完成版のクラス図(静的モデル)を作り上げます。

    6. 実装(プログラム記述) 完成したモデルをもとに、プログラムコードを生成・記述していきます。

    7. テスト ロバストネス分析で作成した「コントローラ」という要素を、そのままテストケースとして活用して動作検証を行います。

    ロバストネス分析を支える4つの要素

    ステップ3の「ロバストネス分析」では、以下の4つの要素を使ってシステムの動きを整理します。


    画像

    ICONIXプロセスでシステムの全体像が見えてきましたが、そもそも『チーム内で言葉の認識がズレていたら』どうなるでしょうか? 次はビジネスの本質を捉える『ドメイン駆動設計(DDD)』を学びます。

    5. ドメイン駆動設計(DDD):みんなで同じ言葉を使って正しいシステムを作る

    例えば、マルチプレイヤーゲームで「回復薬」のことを、ある人は「ポーション」、別の人は「薬草」、プログラムの中では「Item_A」とバラバラに呼んでいたら、会話がかみ合わずミスが起きますよね。

    Stefan Kapferer 氏や Swetha Sistla 氏らの研究で重視されている**ドメイン駆動設計(DDD)**は、開発者と業務の専門家(ドメインエキスパート)がしっかりと協力し、現実の業務やサービスの本質に合わせてソフトウェアを設計する考え方です。

    DDDでは、チーム全員が一切のブレなく同じ言葉を使う**「ユビキタス言語(Ubiquitous Language / 共通言語)」**を作り上げて日常的に使用します。

    DDDの主要な概念

    • 限定されたコンテキスト(Bounded Context) 言葉の意味やモデルが正しく適用される「明確な境界(エリア)」のことです。例えば「顧客」という言葉でも、「配送エリア」と「決済エリア」では必要な意味や属性が異なるため、境界を分けて管理します。

    • ドメインモデルの構成要素

      • エンティティ(Entity): ID(一意の識別子)を持ち、状態が変わっても「それ自身」として区別されるオブジェクト(例:ユーザーIDを持つプレイヤー)。

      • 集約(Aggregate): データの整合性を保つために、一緒にして扱うオブジェクトのグループ単位。

      • サービス(Service): エンティティや値オブジェクト単体の責任に収まらない、業務の処理や操作。

    巨大なシステム(モノリス)を分ける秘密基地の例え

    昔ながらの巨大で複雑な1つのシステム(モノリス)は、保守や変更が大変になります。DDDの考え方(Context Mapper DSL などのツールや Mono2Micro 手法)を使うと、大きなシステムを「マイクロサービス」と呼ばれる扱いやすい小さな単位に分解できます。

    これは、「1つの巨大な大広間だった秘密基地を、『作戦会議室』『見張り台』『物置き』といったテーマ別の部屋(機能モジュール)に綺麗に区切る」ようなイメージです。部屋ごとに役割が独立しているため、後から新しい部屋を作ったり改造したりするのがとても簡単になります。

    正しい言葉と構造で設計されたシステムは、変化に強く、テストもしやすくなります。最後に、モデルを安全に成長させる『リファクタリングとテスト』の仕組みを見ていきましょう。

    6. モデルを使った進化とテスト:壊さずに良くしていく仕組み

    開発が進むと、最初に作った設計図やコードを「もっと綺麗で扱いやすい形」へと作り直したくなります。これをリファクタリング(Refactoring / Transformations)と呼びます。

    リファクタリングの鉄則は、「外部から見える振る舞い(Externally visible behavior)を変えずに、内部構造だけを綺麗にすること」です。完成したプラモデルの外観や動きはそのままで、内部のフレームや補強パーツを整理して頑丈にする作業に似ています。

    モデルの書き換え(トランスフォーメーション)の段階的ステップ

    Bernhard Rumpe 氏の研究では、UMLモデル自体を安全に進化させる2段階の変換手法が示されています。

    例えば、クラス図に「ゲスト(Guest)」と「入札者(Bidder)」という2つのクラスがあり、どちらもパスワード検証機能(checkPasswd())を持ち、Bidderだけに識別番号(ident)があったとします。これらを整理して、共通の親クラス「人(Person)」を作り、共通する要素を段階的に引き上げていきます。

    【ステップ0:リファクタリング前】
       Guest               Bidder
       checkPasswd()       ident: long
                           checkPasswd()
    
    【ステップ1:属性(ident)の引き上げ】
           Person (ident: long)
           ▲             ▲
       Guest             Bidder
       checkPasswd()     checkPasswd()
    
    【ステップ2:メソッド(checkPasswd)の引き上げ】
           Person (ident: long, checkPasswd())
           ▲             ▲
       Guest             Bidder
    
    1. ステップ1(属性の引き上げ): Bidderにあった属性 ident を親クラス Person へ移動します。このときのコンテキスト条件(前提条件)は、Guest に同名の属性が存在しないことです。

    2. ステップ2(メソッドの引き上げ): サブクラスで重複していたメソッド checkPasswd() を親クラス Person へ引き上げます。両者の実装に違いがある場合は、共通部分を抽出したり抽象メソッドを定義したりして調整します。

    秘密基地で言えば、「各部屋のドア(GuestやBidder)に別々に取り付けていた重複する鍵の仕組みを、メインの玄関(Person)にマスターキー(identやcheckPasswd())として1つにまとめる」ようなものです。これで構造がスッキリし、手入れが格段に楽になります。

    自動テストによる品質保証の仕組み

    モデルやコードを改造したとき、どこかが壊れていないかを確かめるのが「テスト」です。

    • ガラス箱テスト(単体テスト・結合テスト) ガラス箱テストとは、中身の構造やプログラムのロジックが透けて見えている状態で行う内部テストのことです。開発者がオブジェクト図(OD)でテストデータを用意し、シーケンス図(SD)で呼び出しを模倣して内部の動きをチェックします。モデルを書き換えたら、テスト側のデータも一緒に更新します。

    • ブラックボックステスト(受入テスト) 内部の細かいコードを知らなくても、公開されたインターフェース(画面や接続口)に対して「正しい結果が返ってくるか」を外側から確かめるテストです。OCLなどを用いてルールの範囲を検証します。

    ブラックボックステスト(受入テスト)がしっかり作られていれば、内部構造をどれだけリファクタリングしても、外部の挙動が壊れていないことを自動実行でいつでも証明できます。

    ここまで学んだアジャイルモデリングの知識を振り返り、明日から使える3つの秘訣としてまとめましょう。

    7. まとめ:最高のシステムを作るための3つの秘訣

    システム設計は、難解な教科書を暗記する勉強ではありません。仲間とともにアイデアを出し合い、夢の秘密基地や素晴らしいゲームを作り上げる、とてもワクワクするクリエイティブな冒険です。

    最後に、本ガイドで学んだ最も重要なポイントを3つの秘訣としてまとめます。

    1. 図(モデル)はチームの対話ツール(UML & AM) 綺麗な図を完成させることが目的ではありません。チーム全員で「今から何を作るか」を会話するために、必要十分(JBGE)な図をホワイトボードにサッと描いて理解を深めましょう。

    2. 段階を踏んで洗練させる(ICONIX) 1回で完璧な設計を目指す必要はありません。ユースケースからロバストネス分析、シーケンス図、クラス図へと段階を踏み、手戻りや修正を恐れずに何度も反復してブラッシュアップしていきましょう。

    3. 共通の言葉で本質を掴む(DDD) 開発者も依頼主も、全員が同じ「ユビキタス言語」を使ってコミュニケーションを取りましょう。作るべきビジネスの本質を捉え、境界(コンテキスト)を整理することが成功への一番の近道です。

    さあ、あなたも紙とペンを持ち、チームの仲間と一緒に新しいシステムづくりの冒険に出かけてみませんか?

     
     
    開発プロセスとか開発手法とかも好きです。 AIでドキュメント駆動型開発を極めて 生成させるだけでなく、要件、仕様、テストの同期を考慮した安定的な開発スタイルで開発を楽しんでいます。

    あなたへのおすすめ