AIと育てる型定義 Part 3:責務の分離でコードをクリーンにする

著者: ClaudeMix Team |

1つの型がページネーション・フィルター・UI表示の役割を兼ねると、フィルター条件を変えただけで無関係の箇所で型エラーが出る。Intersection Types(type A = B & C)で責務を分解し、変更の影響範囲が予測できる構造にした。

① やったこと

Before: データ取得オプションの型が、ページネーション(表示件数、オフセット)とフィルター(条件検索)という2つの異なる責務を1つの型で併せ持っていた。UI層とサーバー層の両方で必要な型がデータアクセス層に定義されており、UI層から参照しにくい状態だった。

After: 混在していた責務を独立した型に分離し、Intersection Typesで必要に応じて結合する構造にした。UI層・サーバー層で共有する型はプロジェクト共通の場所に再配置した。

// Before: 1つの型が2つの責務を兼ねる
type DataFetchOptions = {
  page: number; offset: number;           // ページネーションの責務
  category: string; keyword: string;      // フィルターの責務
};

// After: 責務ごとに分離し、必要な箇所で結合する
type PaginationParams = { page: number; offset: number };
type FilterParams = { category: string; keyword: string };
type PostFilter = PaginationParams & FilterParams;

② 設計判断

  • 【優先した価値】: フィルター条件の変更が、ページネーションやUI表示の型に影響しないよう、責務ごとに独立させること
  • 【犠牲にした価値】: 1つの型を見るだけで全体像が分かる一覧性。責務が分かれた分、関連する型を追うのに複数のファイルを参照する必要がある

③ 技術的負債

  • 【解消した負債】: 1つの型が抱えていた責務の数は2つ(ページネーション・フィルター)から、型ごとに1つに減った。フィルター型だけを独立して再利用できるようになった
  • 【新たに生まれた負債】: 型が分離した分、Intersection Typesでの結合関係を把握していないと、どの型とどの型が組み合わさって最終的な形になるかが追いにくくなる

④ 経営翻訳

1つの申請書が「人数の集計」と「条件による絞り込み」という2つの業務を1枚に兼ねていたため、絞り込みの条件を変えるたびに集計欄まで書き直す必要があった。申請書を業務ごとに2枚へ分割し、必要な場面で組み合わせて使う運用に変えた。

このシリーズの記事

1枚の申請書が「人数の集計」と「条件による絞り込み」という2つの業務を兼ねていたため、 絞り込み条件を変えるたびに集計欄まで書き直す必要があった。

1枚の申請書が兼ねる業務の数: 2つ(集計・絞り込みを1枚で兼務)