モジュラモノリスにおける境界をGoのinternalパッケージで守る

Go Conference mini 2026 in Sendai: https://sendaigo.jp/

1. モジュラモノリスにおける境界を Goのinternalパッケージで守る Go Conference mini 2026 in Sendai magavel / SODA inc.
2. 自己紹介 • 大阪からやってきました • 普段はGoでSNKRDUNKを開発しています magavel / SODA inc. @magavel_dev ＼ 2秒でフォロバします／
3. 本日のテーマ 結合とGo
4. ソフトウェア文脈でいう結合って何ですか？
5. ”結合はむしろ、 忘れてはならない設計ツールだ。” ソフトウェア設計の結合バランス (2025) 第1章 結合とシステム設計 P14
6. 前回の仙台での発表から約3年... モジュール分割、今もしっかり進めています！ ref: https://speakerdeck.com/sh0e1/snkrdunkdego-plus-grpcde-susumerumoziyuramonorisu
7. 前回の仙台での発表から約3年... コードベースの規模もさらに拡大中 🤯 13,309 2,238,707 Goのファイル数 Goのコード行数 2026/02/20時点
8. CASE. 1 internalパッケージで結合強度を コントロールする
9. Goのinternalパッケージを使うと • あるモジュールのinternal配下へはその モジュールからしか参照できなくなる • コードレビューや運用ルールではな く、Go標準の仕組みを使ってビルド段 階で境界を守れる • 各モジュールを interface/（公開層） と internal/（内部実装層）の二層に分 けて、ドメイン・ユースケース・イン フラなどはすべて internal に閉じ込め ている
10. internalパッケージの抜け穴 • ちなみに絶対に突破できない仕組みというわけではない • 例えばtsgoとtsgolintのケース ◦ • とはいえ、Goチームでも使われているので、硬い仕組みであることには変 わりない ref: https://speakerdeck.com/syumai/how-tsgolint-exposes-typescript-gos-private-apis
11. CASE. 2 public functionsパターン(※1)を 導入する ※1：public functionsパターンは造語なので覚える必要はありません。
12. モジュールの公開インターフェース設計 • interface/配下に通信方式ごとにディレ クトリを切って外部に公開する • 他モジュールからはこの公開関数（Go のinterface）を呼び出す • モジュールから直接クライアントアプ リにAPIを提供する場合は、httpディレ クトリ配下にhandlerを実装する
13. 実例：商品カタログモジュールの公開関数と呼び出しイメージ 呼び出し元↓ ↑定義元
14. CASE. 3 depguardで旧コードへの依存を防ぐ
15. OpenPeeDeeP/depguardとは • golangci-lintに組み込まれているリン ターの一つ。 • importパスのホワイトリスト/ブラック リストを定義し、禁止したい依存をCI で自動検知・制限できる • SNKRDUNKでは、分離モジュールから モノリス（旧コード）への依存を防ぐ ルールを.golangci.ymlに定義し、CIで全 PRをチェックしている
16. 段階的に移行を進めている • DBはコンテキスト境界がより明確になってきた段階で分割する方針に変わ りなし、なのでモジュールとモノリスでDBを共有している • モジュールのinfrastructure層だけはモノリスへの依存を許容する • ここでも、将来的な抵抗要因と現時点でのコストを天秤にかけるなど、結 合バランスの考え方が必要になってくる • 現在進行形の重要トピック ◦ コンテキスト/モジュール間でトランザクションを受け渡し可能にする か、Sagaパターンなど分散トランザクションを導入するか...等
17. まとめ • 結合は設計ツール。 ◦ 教科書通り(完全な疎結合)を目指すのではなく、トレードオフ や組織戦略を踏まえたうえで結合をむやみに恐れないことも大 事。 • Goのコードベースでモジュラモノリスを実現するために、Goの internalと公開関数という建て付けを採用して今のところうまくいっ てそう。 • リアーキテクチャ推進の文脈でもガードレール設計は大事。 ◦ 今回取り上げたdepguardなどlinterを活用しよう。
18. おまけ ブースに居る鑑定士Gopherくん にぜひ会いにきてください！ Xにイラストの感想投稿してもらえる と、手伝ってくれたイラストレーター が喜びます🙏
19. Thank you. ご清聴ありがとうございました！ Special Thanks SNKRDUNKにおけるモジュラモノリスへの移行は、 同じリアーキテクチャ推進チームの@avexbesukeさん、@mishさ ん、@shinodaさんをはじめ、担当ドメインのモジュール分割に関 わってくれている人たちによって支えられています。