チームでモデリングを育てるうえで 考えたこと・気づいたこと / Cultivating Modeling in Teams: Thoughts and Insights

2024年03月24日に開かれた Object-Oriented Conference 2024 での発表資料です。

日時：2024/03/24 13:30〜
会場：Track E（共1-304）

【トーク概要】
https://fortee.jp/oocon-2024/proposal/9d03d0b4-62af-497f-b02e-ad0e09e616c9

【イベント connpass ページ】
https://ooc.connpass.com/event/305241/

【OOC 公式サイト】
https://ooc.dev/2024/

1. チームでモデリングを育てるうえで 考えたこと・気づいたこと 2024-03-24 Object-Oriented Conference 2024 BABY JOB 株式会社 浅野 正貴(@mackey0225)
2. いきなりですが、
3. みなさんのモデリングは 育っていますか？
4. A. ぜんぜん、鳥取砂丘 B. ぼちぼち、ナギ平原 C. めっちゃ、屋久島 D. もの凄く、富士樹海
5. A. ぜんぜん、鳥取砂丘 B. ぼちぼち、ナギ平原 C. めっちゃ、屋久島 D. もの凄く、富士樹海 FF Ⅹ 混じっているよ!!
6. で、今日の話は、
7. 砂漠 → 草原・森になるために 考えたこと・気づいたこと
8. ちなみに、我々は 「やっと草原」な感じです。
9. チームでモデリングを育てるうえで考えたこと・気づいたこと 自己紹介 名前：浅野　正貴 所属：BABY JOB 株式会社（2022-06 入社） 最近は Java 書いたり、AWS 触ったり X: @mackey0225 GitHub: @mackey0225 初めての OOC 全力で楽しんでいます！！！ 9
10. チームでモデリングを育てるうえで考えたこと・気づいたこと アジェンダ • 状況ときっかけ • 育てるとは • 育てるために考えたこと • やってみて気づいたこと • 課題
11. 状況ときっかけ
12. チームでモデリングを育てるうえで考えたこと・気づいたこと 状況・前提 • プロダクトはオニオンアーキテクチャをベース • ユースケース図、ドメインモデル図はある • しかし、更新できていない ▪ 初期実装時に作ったもの ▪ 規模の大きい追加改修時に作ったもの
13. チームでモデリングを育てるうえで考えたこと・気づいたこと 状況・前提 • プロダクトはオニオンアーキテクチャをベース • ユースケース図、ドメインモデル図はある • しかし、更新できていない ▪ 初期実装時に作ったもの ▪ 規模の大きい追加改修時に作ったもの そこの貴方！ 軽量 DDD とか言わない！
14. チームでモデリングを育てるうえで考えたこと・気づいたこと きっかけ • 輪読会で以下の書籍を取り上げた ▪ ドメイン駆動設計 モデリング/実装ガイド ▪ ドメイン駆動設計 サンプルコード&FAQ • 輪読会後にサービスへどう活かすか議論
15. チームでモデリングを育てるうえで考えたこと・気づいたこと きっかけ • 輪読会で以下の書籍を取り上げた ▪ ドメイン駆動設計 モデリング/実装ガイド ▪ ドメイン駆動設計 サンプルコード&FAQ • 輪読会後にサービスへどう活かすか議論
16. チームでモデリングを育てるうえで考えたこと・気づいたこと きっかけ • 輪読会で以下の書籍を取り上げた ▪ ドメイン駆動設計 モデリング/実装ガイド ▪ ドメイン駆動設計 サンプルコード&FAQ • 輪読会後にサービスへどう活かすか議論
17. チームでモデリングを育てるうえで考えたこと・気づいたこと きっかけ • 輪読会で以下の書籍を取り上げた ▪ ドメイン駆動設計 モデリング/実装ガイド ▪ ドメイン駆動設計 サンプルコード&FAQ • 輪読会後にサービスへどう活かすか議論 詳細は OOC ガイドブックの 第19章を見てみて！！
18. 育てるとは
19. チームでモデリングを育てるうえで考えたこと・気づいたこと 辞書上での「育てる」(デジタル大辞泉より) １ 手間をかけて養い成長させる。養育する。 ２ 能力などが伸びるように教え導く。手を掛けてやったり、 教え鍛えたりして、一人前として通用するまでにする。 ３㋐小さな規模で出発した組織・団体などを発展させる。 ㋑ある考え方・気持ちなどが伸びていくように力を尽くす。 ４ 手なずける。おだてる。そそのかす。
20. チームでモデリングを育てるうえで考えたこと・気づいたこと 辞書上での「育てる」(デジタル大辞泉より) １ 手間をかけて養い成長させる。養育する。 ２ 能力などが伸びるように教え導く。手を掛けてやったり、 教え鍛えたりして、一人前として通用するまでにする。 ３㋐小さな規模で出発した組織・団体などを発展させる。 ㋑ある考え方・気持ちなどが伸びていくように力を尽くす。 ４ 手なずける。おだてる。そそのかす。
21. チームでモデリングを育てるうえで考えたこと・気づいたこと 辞書上での「育てる」(デジタル大辞泉より) １ 手間をかけて養い成長させる。養育する。 ２ 能力などが伸びるように教え導く。手を掛けてやったり、 教え鍛えたりして、一人前として通用するまでにする。 ３㋐小さな規模で出発した組織・団体などを発展させる。 ㋑ある考え方・気持ちなどが伸びていくように力を尽くす。 ４ 手なずける。おだてる。そそのかす。 「育てる」とは 手をかけて、成長をサポートすること
22. チームでモデリングを育てるうえで考えたこと・気づいたこと 植物でたとえると・・・
23. チームでモデリングを育てるうえで考えたこと・気づいたこと 植物でたとえると・・・
24. チームでモデリングを育てるうえで考えたこと・気づいたこと 植物でたとえると・・・
25. チームでモデリングを育てるうえで考えたこと・気づいたこと 植物でたとえると・・・ 害虫対策 水やり・肥料 剪定 植え替え プランター 植木鉢 花・果実
26. チームでモデリングを育てるうえで考えたこと・気づいたこと 植物でたとえると・・・ 害虫対策 水やり・肥料 剪定 植え替え プランター 植木鉢 花・果実 チームで育てることは、 全員で「生き物係」になること
27. チームでモデリングを育てるうえで考えたこと・気づいたこと 文脈を戻すと・・・ 害虫対策 水やり・肥料 剪定 植え替え プランター 植木鉢 花・果実
28. チームでモデリングを育てるうえで考えたこと・気づいたこと 文脈を戻すと・・・ 文言・タイポ 修正 メンテナンス 腐敗防止 方向性の修正 定期的な 見直し 保管場所 管理対象
29. チームでモデリングを育てるうえで考えたこと・気づいたこと 文脈を戻すと・・・ 文言・タイポ 修正 メンテナンス 腐敗防止 方向性の修正 定期的な 見直し 保管場所 管理対象 考えておくべきことが結構ある
30. チームでモデリングを育てるうえで考えたこと・気づいたこと 文脈を戻すと・・・ 文言・タイポ 修正 メンテナンス 腐敗防止 方向性の修正 定期的な 見直し 保管場所 管理対象 なので、
31. チームでモデリングを育てるうえで考えたこと・気づいたこと 文脈を戻すと・・・ 文言・タイポ 修正 メンテナンス 腐敗防止 方向性の修正 定期的な 見直し 保管場所 管理対象 馴染みのあるフレームワーク 「5W1H」に沿って 育て方を考えていきました
32. 育てるために考えたこと
33. チームでモデリングを育てるうえで考えたこと・気づいたこと 育てるために考えたこと 5W1H に沿って考えた When Where Who What Why How 対象を「どの形式で」管理するか 「どこで保管・管理」するか 「どのタイミング」で作成・更新するか 「誰が」作成・更新するか 「なぜ」行うのか 「どのような運用・手順で」行うのか
34. チームでモデリングを育てるうえで考えたこと・気づいたこと 育てるために考えたこと 考える順番は以下の流れ When Where Who What Why How 目的 管理する主体 運用方法 管理する対象
35. チームでモデリングを育てるうえで考えたこと・気づいたこと Why - なぜ行うのか 前提に立ち返って、何のために育てるのかは明文化する • 複数人で意思を統一させる • 手段と目的の逆転に気づく • 定期的に活動を振り返り、「向き直り」を図る
36. チームでモデリングを育てるうえで考えたこと・気づいたこと Why - なぜ行うのか 前提に立ち返って、何のために育てるのかは明文化する • 複数人で意思を統一させる • 手段と目的の逆転に気づく • 定期的に活動を振り返り、「向き直り」を図る 自分・あなたがいなくなっても、モデル図は生き続ける 目的を見失うと、すぐに破綻する
37. チームでモデリングを育てるうえで考えたこと・気づいたこと Who - 誰が更新するか まず決めること：「どんなチーム」の持ち物か • 開発組織だけ？ドメインエキスパートも？　　など
38. チームでモデリングを育てるうえで考えたこと・気づいたこと Who - 誰が更新するか まず決めること：「どんなチーム」の持ち物か • 開発組織だけ？ドメインエキスパートも？　　など 次にやること：チームの定量・定性の状態の把握 • メンバーの習熟度や経験は？ • 権限（参照/編集）は？　　など
39. チームでモデリングを育てるうえで考えたこと・気づいたこと Who - 誰が更新するか まず決めること：「どんなチーム」の持ち物か • 開発組織だけ？ドメインエキスパートも？　　など 次にやること：チームの定量・定性の状態の把握 • メンバーの習熟度や経験は？ • 権限（参照/編集）は？　　など チームで継続的に進めるための能力と責任が必要 地に足ついた状態で進めないといけない
40. チームでモデリングを育てるうえで考えたこと・気づいたこと When/How - どのタイミングでどう更新するか • 定期：一定期間ごとに見直す ▪ 個人ワーク / モブワーク / スプリントレビュー • 不定期：日々の開発スプリント内で見直す ▪ 改修時のプルリクエスト ▪ ソースコードから生成（cf. JIG）
41. チームでモデリングを育てるうえで考えたこと・気づいたこと When/How - どのタイミングでどう更新するか • 定期：一定期間ごとに見直す ▪ 個人ワーク / モブワーク / スプリントレビュー • 不定期：日々の開発スプリント内で見直す ▪ 改修時のプルリクエスト ▪ ソースコードから生成（cf. JIG） メンテナンスにかかるコストと負荷が 目的(Why)に見合っているかを考慮する
42. チームでモデリングを育てるうえで考えたこと・気づいたこと Where/What - どこにどの形式で管理するか（1） • フォーマットと管理場所は強い結びつきがある ▪ draw.io ↔ Google Drive ／ Notion ↔ Mermaid • 学習コストや保守性も考慮 ▪ PlantUML や Mermaid は開発組織外だとつらい ▪ GUI か、テキストベースか ▪ 版管理ができるか(Git管理、ツールの機能)
43. チームでモデリングを育てるうえで考えたこと・気づいたこと Where/What - どこにどの形式で管理するか（2） • 将来的な人数も考慮 ▪ 同期方法の有無 ▪ 同時接続の可否 ▪ 費用面、ライセンス管理の負荷
44. チームでモデリングを育てるうえで考えたこと・気づいたこと Where/What - どこにどの形式で管理するか（2） • 将来的な人数も考慮 ▪ 同期方法の有無 ▪ 同時接続の可否 ▪ 費用面、ライセンス管理の負荷 メンバーと運用タイミングに応じて選択する 学習コストや将来的な負荷も加味しておく
45. 私たちはどうしたか
46. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io
47. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io あれ、開発プロセスに盛り込まないの？ って思いませんでした？
48. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io もしくは
49. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io ドメインエキスパートは参加しないの？ って思いませんでした？
50. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io 私たちは 「スモールスタート ＆ 向き直り」 で進めることにしました
51. チームでモデリングを育てるうえで考えたこと・気づいたこと スモールスタート ＆ 向き直り 現状 あるべき姿
52. チームでモデリングを育てるうえで考えたこと・気づいたこと 現状 あるべき姿 現時点での理想 スモールスタート ＆ 向き直り
53. チームでモデリングを育てるうえで考えたこと・気づいたこと 現状 あるべき姿 いきなり、あるべき姿に挑戦したいが、 モデル図の意味・価値が見出だせていない 現時点での理想 スモールスタート ＆ 向き直り
54. チームでモデリングを育てるうえで考えたこと・気づいたこと 現状 あるべき姿 進めていく中で別の考えや方法が出るかも知れない 現状 現時点での理想 スモールスタート ＆ 向き直り
55. チームでモデリングを育てるうえで考えたこと・気づいたこと 現状 あるべき姿 進めていく中で別の考えや方法が出るかも知れない →あるべき姿が変わる→向き直り 現状 進んでいくと 気づいた理想 あるべき姿 スモールスタート ＆ 向き直り
56. チームでモデリングを育てるうえで考えたこと・気づいたこと 現状 あるべき姿 あるべき姿が変わるかも知れないということを前提に スモールスタートで始めることにした（≒ MVP ） 1st STEP スモールスタート ＆ 向き直り
57. チームでモデリングを育てるうえで考えたこと・気づいたこと 現状 あるべき姿 あるべき姿が変わるかも知れないということを前提に スモールスタートで始めることにした（≒ MVP ） 2nd STEP 2nd STEP 2nd STEP 1st STEP あるべき姿 あるべき姿 スモールスタート ＆ 向き直り
58. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io 再掲
59. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io まずは、自分たちの中で意味と価値のあるものにする
60. チームでモデリングを育てるうえで考えたこと・気づいたこと 結論 私たちは以下で進めることにした Why：実装における迷いが少なくするため Who：開発メンバが中心 When/How：定期的な組織内でモブワークでメンテナンス Where/What：Google Drive / draw.io まずは、自分たちの中で意味と価値のあるものにする 決め方は OOC ガイドブックの 第19章の ADR を見てみて！！
61. 気づいたこと
62. チームでモデリングを育てるうえで考えたこと・気づいたこと 気づいたこと • 仕様・コードの再理解・再検討につながる ▪ モデル図を作るために現状のコードの読み直し ▪ 引っかかるポイントはリファクタリングかも • 運用は根性や精神論ではなく、仕組み化する ▪ 記憶や判断に委ねると脳は都合よくごまかす ▪ ルール・縛りを設けることで怠惰を回避 • モデル図を含むドキュメントも負債 ▪ あればあるほど、いいというわけではない
63. 今後の課題
64. チームでモデリングを育てるうえで考えたこと・気づいたこと 課題 • リソースの確保 ▪ モブワークで定期的に工数が必要 ▪ 開発の優先度と調整になる • コストメリットがまだ出ない ▪ モデル図だけではサービスへの還元にはならない ▪ 顧客課題がすこしでも早く解決するにはまだ先 • あるべき姿の見直し ▪ まだそこまでたどり着けていない
65. さいごに
66. チームでモデリングを育てるうえで考えたこと・気づいたこと まとめ • Why(目的)から始める • Who が決まれば、方法や手段が決まる • 運用設計でも MVP の考えは有用 • リファクタリングに近い副次効果がある • 運用する際は努力ではなく仕組み化を考える • ドキュメントも負債、バランスが重要
67. ご清聴いただきありがとうございました
68. ご清聴いただきありがとうございました それでは、OOC を全力で楽しみましょー！！！