開発者が知っておきたい複雑さの正体/where-the-complexity-comes-from

PHPカンファレンス福岡2025の登壇資料です。

Transcript

1. 開発者が知っておきたい 複雑さの正体 PHPカンファレンス福岡2025 2025-11-08 / hanhan1978 This presentation is built with ❤ and k1LoW/deck
2. Name : hanhan1978 / Ryo Tomidokoro From : 横浜市 Job : Backend Expert @ kaonavi inc Podcast : Yokohama North AM
3. 目次 1. 複雑さとは？ 2. ソフトウェア開発の流れ 3. 複雑さがやってくる物語 4. まとめ
4. 1. 複雑さとは？
5. 『A Philosophy of Software Design』より 複雑さとは「開発者がシステムを理解・変更することを妨げるものすべて」
6. 『ソフトウェア設計の結合バランス』より 2章 結合と複雑性:クネビン 2-1 複雑性とは何か 複雑性とは理解のしにくさ 複雑性は主観
7. ようするに
8. 「 分かりにくい！」と感じたら複雑
9. 数字で測れる複雑さもある • 循環的複雑度 (Cyclomatic Complexity) • 結合度 (Coupling) • 凝集度 (Cohesion)
10. 循環的複雑度の高いコード例
11. 循環的複雑度の高いコード例
12. 結合度の高いコード例
13. 結合度の高いコード例
14. クラス図だと理解しやすい
15. 結合度を下げる改善例
16. 凝集度の低いコード例
17. 凝集度の低いコード例
18. Laravelで稀によく見るコード
19. Laravelで稀によく見るコード 同じキー名を何回使う気だ！！！
20. 複雑なコードは、なんとなく分かった
21. では
22. 複雑なコードはなぜ書かれるのか？
23. 単に技術力の不足？ そのif文はどこからやってくる？
24. 2. ソフトウェア開発の流れ
25. ソフトウェア開発プロセス
26. エンジニアが目にする複雑さは 実装段階にて表出する ソフトウェア開発プロセス
27. しかし複雑さは どの段階からでも入り込んで来る
28. 3. 複雑さがやってくる物語
29. 要件で生じる複雑さ
30. 例えば • 事業の成長に伴う要件増加 • 特定顧客からのカスタマイズ要望 • 時代の変化・外部環境の変動
31. 具体的なケース • 「来季までに、X個の新機能を作ろう！」 • 「A社さんだけ、処理が変わるようにしよう」 • 「GDPRによるCookie利用の許諾チェック」 • 「消費税xx%に変更、商品に軽減税率適用」
32. 消費税計算のコード例
33. 購入時期によって、税率が変わる仕様変更
34. 商品種別、消費者行動で、税率が変わる仕変
35. 設計で生じる複雑さ
36. 例えば • アーキテクト不在／役割不明確 • 流行や技術選定の影響 • いわゆるコンウェイの法則
37. 具体的なケース • 「何を作るか不明確だが戦術DDD風？のディレク トリ構造が先に決まっている」 • 「CI/CDが計画されていない」 • 「組織共通が決まってない」 • 「職能組織内のコミュニケーション不全」
38. 普通のMVCフレームワーク
39. 無根拠な設計判断で戦術DDD風にすると
40. ファイル数が ...
41. ちょっとつらい ...
42. こっちの方が適切なパターンが多々ある
43. 実装で生じる複雑さ
44. 例えば • 条件分岐の安易な追加 • Switch文 • オプション引数の追加 • テストしづらい構造 • わかりにくい命名
45. とはいえ... • 技術は技術課題しか解決できない • 適応課題から生じる複雑さは視野の広い解決策が必要 • 最初から良い解決策は思いつけないことも多い
46. 参考資料
47. SOLIDの原則ってどんなふうに使うの？ https://speakerdeck.com/hidenorigoto/solidfalseyuan-ze-tutedonnahuunishi-ufalse
48. 予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント https://speakerdeck.com/twada/growing-reliable-code-phperkaigi-2022
49. A Philosophy of Software Design, 2nd Edition 「複雑さ」がメインテーマ
50. まとめ
51. どうすれば「複雑」を予防できる？
52. 普段の心構え • 越境した学習を行う • コミュニケーションを取る • システム思考で考える • フィードバックループを回す
53. でも 初手では防げないことも多い
54. だからこそ • 要件・設計へと視野を広げて解決策を探る • やれることから、少しでも改善をいれていく • 諦めない！くじけない！
56. おしまい