System Design入門 設計判断を数字とコードで確かめる
機能要件
この回でやること
機能要件として、席の予約サービスが何をできるかを一覧にします。
- 読む 約 7 分
- 最後にクイズ 1 問
誰が何をできるか
機能要件は、そのサービスで誰が何をできるかを並べたものです。席の予約サービスでは「誰は・何を・できる」の形にそろえます。
「利用者は席を予約できる」「運営は公演を登録できる」なら、使う人と操作が分かります。要件を読む人が、その操作を実際に確かめられる形にします。
「予約を取り消せる」と書き写すと、主語が消えます。利用者が自分の予約を取り消すのか、運営が公演中止に伴って取り消すのかで、作るものも権限も変わります。
利用者に他人の予約まで取り消させる必要はありません。主語に加えて「自分の予約」のように操作できる範囲を残すと、確認すべき振る舞いが分かります。
そのまま採用できない発言
打ち合わせの言葉には、画面の名前、主語のない操作、測れない願望が混ざります。発言を消すのではなく、足りない情報を確かめてから要件へ移します。
| 発言 | 足りないもの |
|---|---|
| 予約画面を作る | 画面でできる操作 |
| 予約を取り消せる | 操作する人と対象の範囲 |
| 速く動く | 速さを測る数字 |
「速く動く」は機能の追加ではありません。速さの条件は次の回で扱い、ここでは誰が何をするのかを先に決めます。
予約画面には、空席を見る、席を選ぶ、予約を確定する操作があります。分けると、空席は未ログインでも見せ、確定時には本人確認を求める、と個別に決められます。
予約サービスで解いてみる
DAU 3万人、1人6回の要求を想定する予約サービスで、「予約画面と取り消しがほしい」と言われたとします。まず操作する人を確かめ、次の形に直します。
| 操作する人 | 要件として残す文 |
|---|---|
| 利用者 | 利用者は公演の空席を見られる |
| 利用者 | 利用者は空席を選んで予約を確定できる |
| 利用者 | 利用者は自分の予約を取り消せる |
| 運営 | 運営は公演を登録できる |
これで「運営も取り消せるのか」という未確認の点を見つけられます。利用者の取り消し要件から運営の権限を推測せず、別に確認する事項として残します。
1人6回の内訳を、空席の確認4回、予約1回、予約確認1回と仮置きします。操作を分けておけば、要求の回数を数えるときにも、読み取りと予約の確定を取り違えません。
この回数から平均約2 QPS、ピーク係数50なら100件/秒を見積もれます。1台40件/秒や月5万円の条件は、機能そのものではなく、後で性能や構成を考えるために使います。
解いた結果は、画面名を操作に分け、取り消しの主語と範囲を補った要件一覧です。ボタンの位置や応答時間を先に決めても、誰に取り消しを許すかという抜けは埋まりません。