
SysMLで学ぶスマートランプ開発 #2ーユースケースモデル
前回はマインドマップで6つの関心事を出し、その中から「明るさの自動調整」を1つ選びました。今回はこの項目をユースケースモデルに落とし、スマートランプというシステムの境界をどこに引くかを決めます。研修でも最初の関門になる図です。ここを雑に通過すると、第4回のブロック定義図まで全部ずれます。
今回のねらい
アクターの定義を押さえ、システムの外側と内側を言い分けられるようにする
ユースケースを2つに絞り、境界を引く作業だけに集中する
次回のアクティビティ図に渡すユースケースを1つ選ぶ

四角い枠がシステム境界で、名前は「スマートランプ」です。枠の中がこれから設計する対象、枠の外がアクターです。まずこの枠を描いてから中身を考えてください。順番を逆にすると、境界が曖昧なまま機能名が並ぶだけの図になります。枠の名前は製品名にします。「システム」や「本機」では、どこまでが自分たちの責任範囲なのかが読み手に伝わりません。
アクターとは、システムの外側にいて、システムと価値をやり取りする人またはモノです。システムに何かを求める側か、システムから何かを受け取る側か、どちらかの立場にある存在を指します。
今回は3つ置きました。左は主アクターの居住者です。明るさという価値を受け取る人であり、この製品が存在する理由です。右には副アクターとしてスマートスピーカーとクラウドサービスを置きます。スマートスピーカーは音声操作の入口となる別の製品、クラウドサービスは調光ポリシーを配信する外部システムで、どちらもランプの外にあります。左右に分けるのは、主と副を目で見分けられるようにするための作図習慣です。
アクターは人物ではなく役割で数えます。同居している家族を「同居者」として別に立てたくなりますが、ランプに対する立場が居住者と同じなら、それは同じ役割なので1つにまとめます。人を増やすのではなく、役割が違うときだけ増やしてください。
境界の中には2つだけ置きます。UC-01「周囲の明るさに合わせて自動調光する」と、UC-02「調光ポリシーを設定する」です。UC-01に関わるのは居住者だけ、UC-02には居住者・スマートスピーカー・クラウドサービスの3者が関わります。アクターとユースケースを結ぶ線に矢印は付けません。この線は「誰がこの価値に関係するか」を示すだけで、データの向きや呼び出しの順番は表しません。UC-02に3本集まっているのは、設定の入口がアプリ・音声・クラウド配信の3経路あるという意味です。
なぜこの2つなのか。UC-01は、居住者が何も操作しなくても机の上がちょうどいい明るさになるという、この製品の中心の価値です。UC-02は、そのちょうどいい明るさを居住者が決められるようにする価値です。ユースケースの粒度は、アクターにとって価値が1つ完結する単位で取ります。「照度を測る」は価値が完結していないので、ユースケースになりません。
ユースケース名は必ず「〜する」で終えてください。「自動調光機能」と名詞で書くと、誰が何を達成するのかが名前から消えます。動詞で終わる名前は、そのまま次回のアクティビティ図の行動の列になります。名前の付け方だけで、後続の図の書きやすさが変わります。
よくあるつまずき
照度センサをアクターに描いてしまう
研修でいちばん多い誤りがこれです。照度センサや人感センサはスマートランプの内部部品なので、境界の外には出しません。これらは第4回のブロック定義図で扱います。迷ったら「これは自分たちが設計して、この製品に収めるものか」と問うてください。はいならアクターではありません。
最初から網羅しようとする
6つも8つも並べたくなりますが、この段階の目的は境界を引くことです。網羅性は第7回の要求図で担保します。現場ではここでユースケース一覧表づくりに時間を溶かし、肝心の境界が決まらないまま先へ進みます。まず2つで骨を通し、境界とアクターを人に説明できる状態を作ってください。
includeやextendを足したくなる
ユースケースが2つしかない段階で関係線を引くと、「照度を測る」「差を求める」といった処理手順がユースケースとして混ざり、図がフローチャートに化けます。ユースケース図は順序を語る図ではありません。処理の流れは次回のアクティビティ図の仕事です。今回は関係線を1本も引きません。includeが効いてくるのは、同じ手順が3つ以上のユースケースに現れ、重複が読み手の負担になってからです。
演習
みなさんの職場の製品を1つ選び、システム境界の枠を描いてから、アクターを3つまで、ユースケースを2つだけ書いてください。書き終えたら、内部部品をアクターにしていないか、名前が「〜する」で終わっているかを点検します。
次回
第3回は、2つのうちUC-01「周囲の明るさに合わせて自動調光する」を選び、アクティビティ図で処理の流れに展開します。センサ部・制御部・照明部の3つのスイムレーンに分け、誰がどの処理を担うかまで描き分けます。
プロモーション
SysML作成ツールであるdrawplusを作っています。もし、SysMLでモデルを描く方がいらっしゃいましたら是非、ご利用ください!
著者について
shokoma:外資コンサルでお仕事しながら個人でサービス作っている人。