domain-model-first

ドメインモデル中心の開発手順

このガイドは特定のプログラミング言語に依存せず、どの言語でも適用可能な原則を説明しています。コード例はTypeScriptで示していますが、概念は他の言語にも応用できます。

テストファーストのドメインモデル設計・実装

目的

外部依存に左右されない純粋なドメインロジックを実装する。

具体的な手順

1. ドメインモデルの振る舞いをテストとして定義
   • モデルが持つべき機能と制約を明確にする
   • エッジケースも含めて考慮する
2. テストを満たすドメインモデルの実装
   • テストが示す仕様に従って実装
   • 値オブジェクト、エンティティ、集約の設計原則に従う
3. リファクタリングによる設計の洗練
   • コードの重複排除
   • 責務の明確化と分離
   • 命名の改善

メリット

• 仕様の明確化と要件の理解促進
• 設計品質の向上（責務分離・凝集度向上）
• リファクタリングの安全性確保
• エッジケースの早期発見
• ドキュメントとしての価値

テスト例

// Taskのテスト例
describe("Task", () => {
  it("タスクが完了しているかどうかを確認できる", () => {
    const taskId = TaskId.of("task-1");
    const title = TaskTitle.of("テストタスク");

    const task = Task.of({
      id: taskId,
      title: title,
      completed: false,
      createdAt: new Date("2023-03-01T10:00:00")
    });

    expect(task.isCompleted()).toBe(false);

    const completedTask = task.markAsCompleted();
    expect(completedTask.isCompleted()).toBe(true);
  });

  it("期限日が未来の日付であることを検証できる", () => {
    const pastDate = new Date();
    pastDate.setDate(pastDate.getDate() - 1); // 昨日の日付

    const result = Task.validateDueDate(pastDate);

    expect(result.isFailure()).toBe(true);
    expect(result.error.message).toContain("期限は未来の日付である必要があります");
  });
});

インメモリリポジトリの実装

目的

• データベースに依存せず、ドメインモデルとユースケースのテスト実行を可能にする

具体的な手順

1. リポジトリインタフェースの定義
   • ドメインモデルで必要な操作を定義
2. インメモリ実装の作成
   • メモリ上のコレクションを使用
   • 実際のデータベースの振る舞いをシミュレート

ユースケース開発

目的

• アプリケーション層のロジックをドメインモデルとリポジトリを使って実装

具体的な手順

1. ユースケースのテストを定義
   • 実行条件と期待結果を明確に
   • 成功ケースと失敗ケースの両方をカバー
2. テストを満たすユースケースを実装
   • 適切なドメインモデルとリポジトリの利用
   • ビジネスルールの適用
3. リファクタリング
   • 責務の分離と明確化

テスト例

describe("CompleteTaskUseCase", () => {
  let taskRepository: TaskRepositoryInMemory;
  let completeTaskUseCase: CompleteTaskUseCase;

  beforeEach(() => {
    taskRepository = new TaskRepositoryInMemory();

    const task1 = Task.of({
      id: TaskId.of("task-1"),
      title: TaskTitle.of("未完了タスク"),
      completed: false,
      createdAt: new Date("2023-03-01T10:00:00"),
    });

    const task2 = Task.of({
      id: TaskId.of("task-2"),
      title: TaskTitle.of("既に完了しているタスク"),
      completed: true,
      createdAt: new Date("2023-03-01T13:00:00"),
    });

    taskRepository.save(task1);
    taskRepository.save(task2);

    completeTaskUseCase = new CompleteTaskUseCase(taskRepository);
  });

  it("タスクを完了できる", async () => {
    const result = await completeTaskUseCase.execute({
      taskId: "task-1",
    });

    expect(result.isSuccess()).toBe(true);

    const updatedTask = await taskRepository.findById(TaskId.of("task-1"));
    expect(updatedTask.isSuccess()).toBe(true);
    expect(updatedTask.value.isCompleted()).toBe(true);
  });

  it("存在しないタスクを処理できる", async () => {
    const result = await completeTaskUseCase.execute({
      taskId: "non-existent",
    });

    expect(result.isFailure()).toBe(true);
    expect(result.error.message).toContain("タスクが見つかりません");
  });
});