AIと育てる型定義 Part 4:ドメイン知識の集約で完成度を高める

著者: ClaudeMix Team |

「この型はUIに置くべきか、APIに置くべきか」で迷い始めたら、ドメイン知識が散らばっているサインだ。どのレイヤーにも属さない型を一箇所に集約することで、コードが仕様書として機能し始める。

① やったこと

Before: 特定のレイヤーの責務ではなく、アプリケーション全体の仕様を表す型が3種類、それぞれ別のレイヤーに配置されていた。

  • サイト全体の設定情報: データアクセス層に定義されていたが、UIコンポーネントでも広く利用されていた
  • ページネーション関連の型: データ取得用・計算ロジック用・UI用と、同じ概念が各層で別々に定義されていた
  • 記事の見出し情報: 純粋ロジック層に定義されていたが、記事データの一部としてUI層でも直接利用されていた

After: 特定のレイヤーに閉じない3つのドメイン知識を特定し、共通の場所に集約した。ページネーションのような複雑な概念は基底型を定義し、用途に応じて派生型を生成する構造にした。

② 設計判断

  • 【優先した価値】: 型定義ファイルを「このアプリケーションが何であるか」を定義する仕様書として機能させること
  • 【犠牲にした価値】: 各レイヤーが自分の都合で型を手元に置ける利便性。使う場所の近くに置けば済んだものを、レイヤーを横断する共通の場所まで探しに行く必要が生まれた

③ 技術的負債

  • 【解消した負債】: サイト設定・ページネーション・見出し情報という3箇所に散在していたドメイン知識を、1つの集約場所にまとめた。散在していた配置場所は3箇所→1箇所に減った
  • 【新たに生まれた負債】: 「このレイヤーにもドメイン知識にも属さない型」の判断基準が曖昧なままだと、新しい型を追加するたびに配置判断に迷う余地が残る

④ 経営翻訳

「会社全体の規定」「共通の申請フォーマット」「文書の見出しルール」という、特定の部署の持ち物ではない3つの共有ルールが、たまたま最初に使った部署のキャビネットにそれぞれバラバラに保管されていた。これを、全社共通の規定集という1つの保管場所にまとめた。

このシリーズの記事

「会社全体の規定」「共通の申請フォーマット」「文書の見出しルール」という、特定の部署の 持ち物ではない3つの共有ルールが、たまたま最初に使った部署のキャビネットにそれぞれ バラバラに保管されていた。

共有ルールの保管場所の数: 3箇所(各部署のキャビネットに分散)