Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
ユースケースシナリオのススメ
Search
男爵
March 26, 2021
Programming
7
7.2k
ユースケースシナリオのススメ
PHPerKaigi2021の登壇資料です。
補足資料はこちら
https://dnskimox.hateblo.jp/entry/2020/12/19/184101
男爵
March 26, 2021
Tweet
Share
More Decks by 男爵
See All by 男爵
デッドロックを回避するリポジトリ実装の勘所
dnskimo
3
400
Scalaで始める表明プログラミング
dnskimo
3
770
分析・設計・テストで活きる ユースケースシナリオの書き方と使い方
dnskimo
4
8.8k
JIRAとGASで半自動化!カンバンメトリクス
dnskimo
3
1k
PHPではじめるCQRSっぽいやつ
dnskimo
9
2.8k
PofEAAで考えるSaaSバックエンドの作り方
dnskimo
3
6.5k
契約による設計事始め
dnskimo
19
7.3k
PHPではじめるCQRS
dnskimo
5
3.3k
PofEAAで読み解くDoctrine2
dnskimo
3
1.7k
Other Decks in Programming
See All in Programming
macOS でできる リアルタイム動画像処理
biacco42
7
1.9k
Snowflake x dbtで作るセキュアでアジャイルなデータ基盤
tsoshiro
2
430
Webの技術スタックで マルチプラットフォームアプリ開発を可能にするElixirDesktopの紹介
thehaigo
2
920
Vaporモードを大規模サービスに最速導入して学びを共有する
kazukishimamoto
4
4.3k
讓數據說話:用 Python、Prometheus 和 Grafana 講故事
eddie
0
350
のびしろを広げる巻き込まれ力:偶然を活かすキャリアの作り方/oso2024
takahashiikki
1
410
役立つログに取り組もう
irof
26
8.7k
LLM生成文章の精度評価自動化とプロンプトチューニングの効率化について
layerx
PRO
2
140
Progressive Web Apps für Desktop und Mobile mit Angular (Hands-on)
christianliebel
PRO
0
110
CSC509 Lecture 09
javiergs
PRO
0
110
AWS IaCの注目アップデート 2024年10月版
konokenj
3
3.1k
gopls を改造したら開発生産性が高まった
satorunooshie
8
240
Featured
See All Featured
Embracing the Ebb and Flow
colly
84
4.4k
Measuring & Analyzing Core Web Vitals
bluesmoon
1
40
Happy Clients
brianwarren
97
6.7k
The Art of Programming - Codeland 2020
erikaheidi
51
13k
How To Stay Up To Date on Web Technology
chriscoyier
788
250k
Agile that works and the tools we love
rasmusluckow
327
21k
Exploring the Power of Turbo Streams & Action Cable | RailsConf2023
kevinliebholz
27
4.2k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
25
1.8k
Building Your Own Lightsaber
phodgson
102
6k
YesSQL, Process and Tooling at Scale
rocio
167
14k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
7
150
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
226
22k
Transcript
ユースケースシナリオの ススメ 2021/03/26 PHPerKaigi 2021 @dnskimox
自己紹介 男爵 Twitter:@dnskimox 所属:Alp,Inc. / Scalebase PHP歴:PHP4〜PHP7 業務経験:イラストSNS、C2Cショップ作成サービス、ソシャゲバックエンド、 サブスクリプション管理SaaS 好きな話題:OOP、DDD、開発プロセス
ユースケースシナリオのススメ ▸ ドメインモデルに足りないもの ▸ ユースケースとはなにか? ▸ ユースケースシナリオの書き方 ▸ シナリオからコードへ ▸
結論
1. ドメインモデルに足り ないもの モデルに妥当性を与える ものは何か?
ショッピングカートのドメインモデル
この手のモデルから何が わかるの? これから作るべきソフトウェアについて、何を語ってい て、何を語っていないのか……。
ドメインモデルは ソフトウェアの静的な 構造を表現する 概念の名前、依存関係、関連、多重度、集約関 係、etc...
静的な構造 概念の名前、依存関 係、関連、多重度、集 約関係、etc... ソフトウェアが持つふたつの側面 動的なふるまい 情報を表示する、入力 を受け付ける、入力値 を検証する、計算をす る、データを保存する、
外部と通信する、etc...
“ ユーザーの立場で見ると、ソフトウェアを外部の世界 から区別するようなシステムの境界があります。自分 のタスクをソフトウェアがどのようにサポートしてくれる のかということを通して、ユーザーはソフトウェアを理 解します。このタスク指向の視点は、一連の記述、す なわちユースケースによって説明できます。 ――『オブジェクトデザイン』(p.59)
2. ユースケースとはな にか? UMLが教えてくれない 大事なこと
ユースケースと聞いて多くの人が想像する であろう「図」
“ これはあくまで各ユースケースの相互関係を示す ものです。しかしユースケースの価値はほぼすべ てがその内容のほうにあり、ダイアグラムはわず かな意味を持つだけです。 ――『UMLモデリングのエッセンス 第3版』(p.100)
UMLの父 イヴァー・ヤコブソン スウェーデンのコンピュータ科 学者。グラディ・ブーチ、ジェー ムズ・ランボーらと共にUMLの 最初の版を策定した。ユース ケース、シーケンス図、ロバスト ネス分析などを考案。 https://twitter.com/ivarjacobson
“ [将来のシステムのユーザによって]開始されるイ ベントと[ユーザと]システムの間のインタラクショ ンの完全な記述 ――『オブジェクト指向入門 第2版 方法論・実践』(p.100) で引用されているヤコブソンの言葉
None
“ 形式的手法、形式言語、形式的体系などに現れ る「形式的」は、「数学や論理学に基礎を置いた、 よく定義されて曖昧性が少ない」といった意味で 使っていると思う。 ―― 「形式的」とは何だろう
“ 各ユースケースは、何らかの目的・目標/機能に関する 台本(シナリオ)での主体(アクター)と呼ぶ利用者とシス テムのやりとりを描いている。(中略)ユースケースでは 技術専門用語をなるべく使わず、エンドユーザーやその ビジネスの専門家に分かり易い用語を用いる。ユース ケースの作成は、ビジネスアナリストとエンドユーザーが 共同で行う。 ―― ユースケース
- Wikipedia
ソフトウェアの動的な ふるまいについて合意 を形成する 可能な操作、入力値検証、計算、データ保存、検索、 システムからの応答、エラー処理、etc...
3. ユースケース シナリオの書き方 形式的な文書にするた めに欠かせない3カ条
1. 目的レベルを揃える
1. 目的レベルを揃える
『ユースケース実践ガイド』( p. 80)
2. シナリオテンプレートに従う ユースケース名:XXXをXXXする 事前条件 - XXXであること 主成功シナリオ 1. アクターは〜する 2.
システムは〜する 3. アクターは〜する 4. システムは〜する 拡張 2a. XXXがXXXの場合: システムは〜する アクターは〜する 1に戻る 事後条件 - XXXであること 晴れの日のシナリオ 雨の日のシナリオ
2. シナリオテンプレートに従う ユースケース名:ショッピングカートに商品を追加する 事前条件 - 対象の商品が公開中であること 主成功シナリオ 1. 買い物客は商品と購入数を選択する 2.
システムは商品の在庫状況を確認する 3. システムはショッピングカートにカート品目を追加する 4. システムは「ショッピングカート」画面に遷移する 5. 買い物客はショッピングカートの中身を確認する 拡張 2a. 商品の在庫が購入数未満だった場合: システムは「在庫が足りません」というエラーを表示する ユースケースを終了する 事後条件 - カート品目が一件増えていること - 対象の商品の在庫はまだ減っていないこと
ここでいう「システム」ってどこか らどこまでのこと? バックエンドAPIだけなのか、フロントエンドも含むのか、 DBはどうなのか、連携しているSaaSは……。
3. 設計スコープを定義する 主アクター 支援アクター
4. シナリオからコードへ 道はひとつではない
ICONIXプロセス 『ユースケース駆動設計実践ガイド』 今日はこの話はしません
CRCカードワークショップ https://slideplayer.com/slide/10494736/
CRCカード(表面) 『オブジェクトデザイン』( P. 145)
CRCカード(裏面) 『オブジェクトデザイン』( P. 146) Responsibility Class(Candidate) Collaboration
CRCカードで用意するもの 1. 情報カード 2. 鉛筆 3. 消しゴム Amazon | コレクト
情報カード 5×3 補助 6ミリ罫 C-532 | 文房具・オフィス用品 | 文房具・オフィス用品
CRCカードの手順 1. 参加者はクラスの候補をカードに記入する a. 表面にはクラスの概要や不変条件を自由に書く 2. 裏面に責務とコラボレーターを書く a. 書ききれない責務は別のクラスを作って移譲する 3.
コンピュータになったつもりで、カードをオブジェクトに見立て てシナリオを実行してみる(ウォークスルー) a. オブジェクトは自身の責務以外のことはできない b. オブジェクトはコラボレーター以外と対話できない 4. 最後のステップに到達したら、事後条件を達成しているかど うかを確認する 5. 最後のステップまで到達できなかったり、事後条件を達成で きなかった場合、1に戻って考え直す
この手順に従うとクラスの数が どんどん増えるんだけど? たくさんのクラスの間を飛び回らないと読み解け無い難 しいコードになりそう……。
“ それでも、私のようなオブジェクト偏愛者は分散制御を選 びます。良い設計を実現する条件のひとつは、変更によ る影響を局所化することです。データとそれを評価する振 る舞いは、一緒に変更されることが多いものです。 ―― 『UMLモデリングのエッセンス 第3版』(P. 56)
“ 実は、この変化こそ、オブジェクト指向のパラダイムシフト の中心部分です。これは、教えるのが非常に難しい部分 です。(中略)一度理解できると、脳内の配線が変わり、実 際には分散制御のほうが簡単であると考えるようになりま す。 ―― 『UMLモデリングのエッセンス 第3版』(P. 56)
最初に記述するクラスの 候補はどこからくるの? ユースケースからクラス名を抽出するのか、他の源泉が あるのか、あるとしたらそれは何なのか……。
“ ユースケースはクラスを見つけるのに最適の道具ではな い。(中略)優秀なオブジェクト指向分析者および設計者 は、「システムはaを実行し、次にbを実行する」という形式 に見られる性質に注目しないように心がけている。代わり に、「抽象Aのインスタンスに許される操作は何か、それら の操作に対する制限は何か」を問う。 ―― 『オブジェクト指向入門 第2版
方法論・実践』(P. 101)
“ ユースケースは分析ツールではなくむしろ確認 (validation)ツールである。(中略)提示された分析モデ ルあるいは試験的な設計に欠けている属性があるかどう かを検査する方法としてユースケースは有効なツールだろ う。 ―― 『オブジェクト指向入門 第2版 方法論・実践』(P.
102)
最初のドメインモデル はシナリオよりも先に つくる 顧客へのヒアリング、要求文書、対象ドメインの専門用語、チー ム内の会話、デザインパターン、etc...
オススメの 設計プロセス (ドラフト版)ドメインモデル ユースケースシナリオ CRCカード
結論 ユースケースを 有効活用するには 覚えて帰ってほしい 3つのこと
ユースケースは図ではない 大事なのはシステムのふるまいを示すシナリオ クラスの候補をシナリオで検証 ウォークスルーを通じてオブジェクト同士の連携を観察 ふるまいについて合意形成する 文書そのものより、記述中に発生するコミュニケーション
現場でユースケースシナリオを 書いてみよう! ご清聴ありがとうございました You can find me at @dnskimox &
https://dnskimox.hateblo.jp/
参考文献 ▸ 『オブジェクトデザイン』 ▸ 『UMLモデリングのエッセンス 第3版』 ▸ 『ユースケース実践ガイド』 ▸ 『ユースケース駆動開発実践ガイド』
▸ 『オブジェクト指向入門 第2版 方法論・実践』 ▸ ユースケース - Wikipedia ▸ イヴァー・ヤコブソン - Wikipedia ▸ CRCカードでチームが協働して設計する ▸ 「形式的」とは何だろう