【やさしく解説 設計編・中級 #2】使わないボタンだらけのリモコン ～ となりの変更で、うちのビルドが赤くなる話 ～

【やさしく解説 設計編・中級 #2】使わないボタンだらけのリモコン

50メソッドのインターフェース、IRepositoryがありました。
検索も、集計も、一括更新も、エクスポートも生えています。

ある日、帳票チームがエクスポート用メソッドの形を一つ変えました。
呼び出し元は全部直し、手元のテストは緑。夕方、mainにマージして帰りました。

翌朝、画面チームとバッチチームのビルドが赤い。

両チームには、心当たりがありません。
「うちは帳票機能なんて、使ってもいないのに」

その『なぜ』につく名前が、インターフェース分離の原則（ISP）です。
SOLIDの「I」。けれど答えは、「使っているかどうか」の外にありました。

持ち帰りは一問だけ。
「その操作盤、使わないスイッチは？」

SOLIDを原則からではなく、事例から読み直す中級シリーズ（全6回）の第2回です。

---
※本編にて、「ドメイン」とは、「駆動」とは、を解説しています。中級編の前にどうぞ

【やさしく解説 設計編 #0】DDDのコード、読めるのに分からない人へ
https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-0
ｰｰｰ
【やさしく解説 設計編・中級 】目次
#1 一つの車に、運転手は一人 ～ ある倉庫システムの事例から ～
　キーワード：`SOLID` `単一責任の原則（SRP）` `アクター`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-1

#2 使わないボタンだらけのリモコン ～ となりの変更で、うちのビルドが赤くなる話 ～
　キーワード：`SOLID` `インターフェース分離の原則（ISP）`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-2

#3 【やさしく解説 設計編・中級 #3】形はあっていたのに ～ 形に書けない約束の話 ～
　キーワード：`SOLID` `リスコフの置換原則（LSP）` `事前条件、事後条件、不変条件`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-3

#4 ルールの寿命と、システムの年輪 ～ 月曜の朝の、一通の通知から ～
　キーワード：`SOLID` `依存性逆転の原則（DIP）` `安定依存`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-4

#5 なぜ「足すだけ」が、「足すだけ」で済まないのか～ ボタンひとつの依頼から ～
　キーワード：`SOLID` `開放閉鎖の原則（OCP）`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-5

#6 良いアーキテクチャとは ～ 一本の登り道の、行き先 ～
　キーワード：`SOLID` `クリーンアーキテクチャ`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-6

※ 7/17 目次およびスライド間のリンクを調整

Transcript

1. 使わないボタンだらけの リモコン 【やさしく解説 設計編・中級 #2】となりの変更で、うちのビルドが赤くなる話 2026.07 北尾　英之 (@kitaohx) 1
2. 中級#1の、続きです 前回は、一つの車に運転手が二人いる症状を見ました。 今日も、ひとつの事例から始めます。 舞台は IRepository 。 検索も、集計も、一括更新も、エクスポートも生えた、 　50メソッドのインターフェースです。 インターフェースは、この連載の言葉で言えば、操作盤です。 中級#1はこちら https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-1 ま え お き 2
3. ある日、帳票チームが 帳票の要件変更に合わせて、 　エクスポート用メソッドの形（シグネチャ）を、一つ変えました。 自分たちの呼び出し元は全部直し、手元のテストも緑になりました。 　夕方、mainにマージして帰りました。 症 状 3
4. 翌朝、CI（自動ビルド）から通知が 画面チームとバッチチームのビルドが、赤（失敗）になっていました。 　昨日までは、緑（成功）でした。 両チームには、心当たりがありません。 「うちは帳票機能なんて、使ってもいないのに」 症 状 4
5. なぜ、使ってもいない変更で 　壊れるのでしょうか？ 少しの間、想像してみてください。 5
6. 依存は、使わなくても、 　つないだ瞬間に生まれる 50メソッドのインターフェースに、自分のコードをつなぐことで、 使わないメソッドの変更でも、再コンパイルが必要に 他チームの影響調査の対象に、自分のコードが入る モック（テスト用の身代わり）にも、使わないメソッドを書かされる 使うのが3メソッドでも、50個ぶんの都合を引き受けています。 使っていなくても、つながっているのです。 解 剖 6
7. 身近にも、同じものがあります 手元のテレビのリモコンには、ボタンが50個あります。 　使うのは、10個ほどです。 「使わないなら、実害はない」と思いきや…… 機種が変わるとき、使わないボタンの配置換えに巻き込まれます。 使わない40個の都合を、気づかず引き受けています。 解 剖 7
8. でも、メソッドを足した人たちは 　間違っていません ・画面チームは検索機能 ・バッチチームは一括更新機能 ・帳票チームはエクスポート機能 どれも、正当な要望でした。 リモコンの50個も同じです。 解 剖 8
9. ボタンの一つひとつに頼んだ 誰か がいます ただ、足される盤が、一枚しかなかったのです。 50ボタンの操作盤とは、使い手の違うスイッチの寄せ集めです。 解 剖 9
10. 対処法は、はしご車が教えてくれました はしご車（消防車）には、盤が三つあります。 　運転席、ポンプの操作盤、はしごの操作盤。 一台の車に 隊員ごとの盤 が付いていて、 　ポンプ盤の改修で、運転席のレバーは動きません。 処 置 10
11. もし、一枚の盤に混ざっていたら ワイパーのつもりで倒したレバーで、はしごが伸び、水が出る。 走行中なら、事故になります。 処 置 11
12. 処置：盤を、使い手ごとに分ける 高齢の家族向けの「かんたんリモコン」を、ご存じでしょうか。 　ボタンは、電源・音量・チャンネルだけ。あれは劣化版ではなく、 「視聴者」ひとりのために作られた操作盤 です。 IRepository も同じです。画面が使うのは3メソッド、バッチは2、帳票は2。 　残りの43個は、歴代の誰かの都合の堆積です。 それぞれに、使うぶんだけの小さな盤に分けます。 処 置 12
13. 帳票を変更しても他チームは影響を受けない 後日、エクスポートの形が変わったとします。 コードを修正しても、 翌朝、画面とバッチのビルドは緑のままです。 各チームがつながっているのは、自分の担当する小さな盤だけ。 帳票の盤には、つながっていないからです。 処 置 13
14. この症状には、名前がついています インターフェース分離の原則（ISP） 。 SOLIDの「I」です。 クライアントは、自分が使わないメソッドへの 依存を強制されるべきではない。 クライアントとは、呼び出す側のコード。盤の前に立つ使い手です。 命 名 14
15. SRPと、何が違うのか 「SRPと何が違うの？」と、いちばん言われる原則です。 SRP：一つの車に、運転手は一人 ISP：一枚の盤に、使い手は一人 同じ原則の、駆動する側と、操作する側です。 命 名 15
16. 小さな盤は、長生きする 3スイッチの盤は、3つの約束が変わらないかぎり安定しています。 50スイッチの盤は、どれか一つが変わるたびに揺れます。 太った盤は、構造的に短命です。 この寿命の話は、中級#4で続きます。 寿 命 16
17. その操作盤、 使わないスイッチは？ 今日の持ち帰りは、この一問だけです。 17
18. 今週、どこかで試してみて メソッド数の多いインターフェースを選び、 　盤の前に立つ使い手（クライアント）が 実際に使っているメソッドに印をつけてください。 印が使い手ごとのグループを作っていたら、 　それが「かんたんリモコン」です。 盤の切れ目は、印がもう教えてくれています。 や っ て み よ う 18
19. 次回も、事例から始めます 次回（中級 #3）：形は合っていたのに https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-3 舞台は、ヨーロッパ旅行です。 19
20. この回が借りたもの インターフェース分離の原則（ISP） ロバート・C・マーティン著、角征典・高木正弘訳 『Clean Architecture 達人に学ぶソフトウェアの構造と設計』KADOKAWA、2018年 https://www.kadokawa.co.jp/product/301806000678/ 操作盤・はしご車のたとえ 本連載は、車の世界に合わせて操作盤で例えています。 「SRPは駆動する側、ISPは操作する側」という対比 本連載の整理です。原典は両者を独立の原則として提示しています。 リモコンのたとえ、症状の物語 本連載のたとえです。事例はフィクションです。 引 用 元 20