【やさしく解説 設計編・中級 #4】ルールの寿命と、システムの年輪

【やさしく解説 設計編・中級 #4】ルールの寿命と、システムの年輪

※7/16 20:00 スライド中盤の展開を修正しました。主旨は変えず冗長な部分を統合。

舞台は、中級#1の、あの倉庫システムです。
月曜の朝、担当者に一通のメールが届きました。差出人は、画面フレームワークの開発元。
「現行版のサポートは、半年後に終了します」。
画面まわりだけの話のはず。そう思って、影響調査が始まりました。
移行対象の一覧に、在庫計算のファイルが載っていました。計算ルールは、何も変わらないのに。
数日後、会議室で誰かが言いました。「なぜ在庫の計算式が、画面の都合で書き直しになるのか」。
---
間違っていたのは、計算式でも、フレームワークの選定でもありません。向きでした。
10年単位で生きる計算式が、数年で入れ替わるフレームワークに寄りかかっていました。
この向きをひっくり返すのが、依存性逆転の原則（DIP）、SOLIDの「D」です。

『クリーンアーキテクチャ』の同心円を、ご存じの方へ。
　あの円が年輪に見えてくる読み方も、用意しています。

寄り道では、DIコンテナの入り口として、私がいちばん分かりやすかったPodcastの回を紹介しています。

持ち帰りは一問だけ。「自分より長生きするものに、寄りかかっていますか？」
SOLIDを原則からではなく事例から読み直す、中級シリーズ（全6回）の第4回です。

---

### 紹介したポッドキャスト

fukabori.fm 第48・49回「GoFデザインパターンとDI」
（パーソナリティ：岩瀬義昌さん、ゲスト：和田卓人さん）
https://fukabori.fm/episode/48
https://fukabori.fm/episode/49

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

【やさしく解説 設計編 #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. ルールの寿命と、 システムの年輪 【やさしく解説 設計編・中級 #4】月曜の朝の、一通の通知から 2026.07 北尾　英之 (@kitaohx) 1
2. 前回のふりかえり 前回は、変換プラグの話でした。 　形は合っていたのに、家電が燃えた。 　形が合うことと、約束を守ることは、別でした。 今日は、中級#2の終わりに予告した、寿命の話です。 他の回へのリンクは本スライドの末尾にございます。 ま え お き 2
3. 月曜の朝、一通の通知 舞台は、中級#1の、あの倉庫システム。 　 「箱サイズ」で、梱包が止まった現場です。 担当者に、メールが届きました。 　差出人は、画面フレームワークの開発元。 「ご利用のフレームワークは、メジャーバージョンアップします。 　現行版のサポートは、半年後に終了します」 画面まわりだけの話のはず。そう思って、影響調査が始まりました。 症 状 3
4. 調査の結果 移行対象の一覧に、在庫計算のファイルが載っていました。 在庫の計算ルールは、何も変わりません。 それでも書き方を直して、結果が変わっていないことを、 　ひとつずつ確かめて回ることになります。 症 状 4
5. 数日後 会議室で、誰かが言いました。 「なぜ在庫の計算式が、画面の都合で書き直しになるのか」 症 状 5
6. なぜ、計算ルールは変わらないのに、 書き直しになるのでしょうか？ 少しの間、想像してください。 6
7. 計算式が、フレームワークに依存していた 在庫の計算方法は、何も変わりません。 　ファイルも、画面のコードとは分けてありました。 それでも、引数と戻り値の型は、フレームワークのもの。 　よその言葉を借りて書いた式は、その持ち主に依存しています。 持ち主が言葉を変えれば、借りた文も書き直しです。 向こうの変更が、こちらへ波及してくる。 　この関係を、依存と呼びます。 解 剖 7
8. 通知は、一通ではありませんでした 「半年後にサポート終了」は、大事件に見えます。 　でも、この一年に届いた通知を、机に並べてみると。 セキュリティパッチ（月に一度は来る） バージョンアップ（年に数回。破壊的変更を連れて） サポート終了・EOL（数年ごとに、確実に来る） ライセンス条件の変更（ある日突然、値札が変わる） 丸ごとの入れ替えは稀。でも、小さな書き直しは続いている。 解 剖 8
9. 寿命は、桁で違う もの 私の現場での体感 業務ルール（締め、在庫、返金） 数十年 プログラミング言語 十数年 データベース製品 十年前後 画面のフレームワーク 数年 あなたの現場では、順位が入れ替わるかもしれません。 　COBOLの現場なら、言語こそが最長老でしょう。 順位は入れ替わっても、桁の差は、どの現場にもあります。 解 剖 9
10. フレームワークの選定は、間違っていません 当時としては、いちばん良い選択でした。 問題は選択ではなく、向きでした。 数十年生きる在庫の計算式が、 　数年で入れ替わるフレームワークに、依存していた。 　依存の先が消えれば、道連れになります。 解 剖 10
11. 原則は、ひとつ 寄りかかるなら、 自分より長生きするものに。 壁に寄りかかるのは、安全です。壁は、こちらより長く立っています。 隣の人に寄りかかると、立ち去られたときに転びます。 言い換えると 短命 → 長命 ･･･ 短命が長命に依存する分には、安全。 短命 ← 長命 ･･･ 長命が短命に依存していたのが、今回の事故です。 処 置 11
12. でも、在庫の計算は、DBに用があります 原則のとおりなら、自分より短命なDBやフレームワークに、 　計算式は依存できません。 でも、在庫を数えるには、DBを呼ばないと始まりません。 呼びたい。でも、依存したくない。 処 置 12
13. 呼ぶことと、依存することは、切り離せます 計算式とDBの間に、盤（インターフェース）を一枚置きます。 　盤の形は、長生きする計算式の側が決めます。 　 （中級#2の、はしご車の盤と同じ作法です。 ） DB係は、その盤に合わせて、配線しに来ます。 呼ぶ向きは、そのまま。 　依存だけが、盤で折り返します。 処 置 13
14. その向きに、名前があります これまでは、計算式が、フレームワークに合わせて書かれていました。 　盤を置けば、ここでも、フレームワーク側が盤に合わせて配線しに来ます。 依存の向きが、逆転しています。 依存性逆転の原則（DIP） SOLIDの「D」です。 命 名 14
15. 同心円の決まりは、一行だけ 『クリーンアーキテクチャ』の、有名な同心円。 　内側に業務ルール、外側に画面・DB・フレームワーク。 依存していいのは、自分より内側にだけ。 さきほどの盤を、それぞれの境界に置いた姿が、この円です。 境界の外側の変更は、内側へ波及してきません。 　これなら、次の通知が来ても、移行対象の一覧に、在庫の計算式は載りません。 命 名 15
16. 例えるなら、年輪です 年輪は、芯に近い層ほど古く、木が生きるかぎり残ります。 　いちばん外の樹皮は、剥がれ落ちては生え替わる。 業務ルール（数十年）が芯。フレームワーク（数年）が樹皮。 芯は、樹皮に寄りかかってはいけない。 　剥がれ落ちるものに芯を預けた木は、樹皮と一緒に倒れます。 ※年輪は、本連載の読み替えです。 命 名 16
17. 寿命の違うものを、 寿命の順に積む。 年輪が教えてくれる、今日の結論です。 17
18. 自分より長生きするものに、 寄りかかっていますか？ 今日の持ち帰りは、この一問だけです。 18
19. 今週、どこかで試してみて システムの登場人物（業務ルール、DB、フレームワーク……）に 　予想寿命を書いて、依存の矢印を引いてみてください。 ファイル先頭の名簿（import/using） が、 　依存先の一覧です。 長命が短命に依存していたら 　次の通知で移行対象に載るのは、その長命のコードです。 その図が、あなたのシステムの年輪です。 や っ て み よ う 19
20. ここからは、寄り道です。 本編は、ここまで。 最後に、道具の話を少しと、おすすめの放送をひとつ。 20
21. 盤は決まった。 newは、誰が書く？ 在庫の計算式は、盤（インターフェース）にだけ 　依存する形になりました。 でも、本物のDB係は、どこかで誰かが new と書かないと、生まれません。 しかし、在庫計算のファイルに書けば、 　名簿（import/using）に短命の名前が戻ってきます。 　せっかく向きを直したのに、また元通りです。 よ り み ち 21
22. そこで登場したのが、DIコンテナという道具 いまの現場では、あちこちの new をまとめて引き受ける、 DIコンテナという道具が使われています。 仕組みは、ここでは深追いしません。 　かわりに、私が聴いたなかでいちばん分かりやすかった回を紹介します。 fukabori.fm 第48・49回 「GoFデザインパターンとDI」 『クリーンアーキテクチャ』のFactoryと、いまのDIコンテナ。 　そのつながりも、この2回で聴けます。 よ り み ち 22
23. 次回も、事例から始めます 次回（中級 #5）：なぜ「足すだけ」が、 「足すだけ」で済まないのか https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-5 「ボタンを一つ足すだけ」の依頼が、足すだけで済まない話です。 23
24. この回が借りたもの 依存関係逆転の原則（DIP） ロバート・C・マーティン著、角征典・高木正弘訳 『Clean Architecture 達人に学ぶソフトウェアの構造と設計』KADOKAWA、2018年 第11章（第III部 設計の原則） 。本文の「依存性逆転」は本連載の表記です。 https://www.kadokawa.co.jp/product/301806000678/ 同心円の図と「依存性のルール」 同書 第22章「クリーンアーキテクチャ」 （第V部 アーキテクチャ） 。 フレームワークとの距離については、第32章「フレームワークは詳細」に 本編の症状と同じ警告があります。 引 用 元 24
25. この回が借りたもの（つづき） 紹介した放送 fukabori.fm 第48・49回「GoFデザインパターンとDI」 （パーソナリティ：岩瀬義昌さん、ゲスト：和田卓人さん） https://fukabori.fm/episode/48 https://fukabori.fm/episode/49 引 用 元 25
26. この回が借りたもの（つづき） 「同心円はDIPでできている」という読み 第22章「境界線を越える」の議論を、本連載が一文にまとめたものです。 決まりの一行「依存していいのは、自分より内側にだけ」は、 同書「依存性のルール」の本連載訳です。 「安定した抽象」 「変化しやすい具象」は第11章。寿命の表は、この 「変化しやすさ」を桁で測る、本連載の読みです。 本文の「長生き」は、原典の「安定（変化しにくさ） 」の本連載訳です。 年輪の読み替え、壁のたとえ、症状の物語 本連載のたとえです。事例はフィクションです （倉庫システムは、中級#1から続く舞台です） 。 引 用 元 26
27. 【やさしく解説 設計編・中級 】目次 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 形は合っていたのに 　　～ 形に書けない約束の話 ～ 　キーワード：SOLIDリスコフの置換原則（LSP）事前条件、事後条件、不変条件 https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-3 27
28. 【やさしく解説 設計編・中級 】目次（つづき） 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 28