NestJS で絡みあったモジュールの循環参照を整理する

Ubie で副業として Backend For Frontend (BFF) サーバーの開発を担当している nissy-dev です。 この記事では、NestJS を使用したモジュラモノリスアーキテクチャにおいて、開発が進むにつれて増加した循環参照の問題と、その解決に向けた具体的な取り組みについて解説します。 NestJS とモジュールの循環参照 ユビーでは、BFF の GraphQL サーバーを実装する際に、NestJS を利用したモジュラモノリスを採用しています。 モジュラモノリスの設計において、モジュール間の独立性の確保は非常に重要です「ソフトウェアアーキテクチャの基礎」には、次のような説明があります。 しかし、クラスやコンポーネントを安易に相互インポートすることは、モジュール性を損なうことにつながる。たとえば、図 6-3 には、アーキテクトが避けたいと望む、特に有害なアンチパターン