DDD 03 戦術的設計①(エンティティ・値オブジェクト・ドメインサービス)

export class Money {
  private constructor(readonly amount: number, readonly currency: 'JPY') {}
 
  static of(amount: number): Money {
    if (!Number.isInteger(amount)) throw new Error('金額は整数で指定してください');
    if (amount < 0) throw new Error('金額はマイナスにできません');
    return new Money(amount, 'JPY');
  }
  add(other: Money): Money { return Money.of(this.amount + other.amount); }
  multiply(n: number): Money { return Money.of(this.amount * n); }
  equals(other: Money): boolean { return this.amount === other.amount && this.currency === other.currency; }
}
 
export class EmailAddress {
  private constructor(readonly value: string) {}
  static of(raw: string): EmailAddress {
    const v = raw.trim().toLowerCase();
    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v)) throw new Error('メールアドレスの形式が不正です');
    return new EmailAddress(v);
  }
}

type Email = string & { readonly __brand: 'Email' };
function parseEmail(raw: string): Email {
  if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(raw)) throw new Error('invalid email');
  return raw as Email;
}
function sendWelcome(to: Email) { /* ... */ }
sendWelcome('a@example.com');            // ✗ 型エラー(未検証の string は渡せない)
sendWelcome(parseEmail('a@example.com')); // ○

type ReservationStatus = 'tentative' | 'confirmed' | 'cancelled';
 
export class Reservation {
  private constructor(
    readonly id: ReservationId,
    private status: ReservationStatus,
    readonly slot: TimeSlot,          // 値オブジェクト
    private readonly heldAt: Date,
  ) {}
 
  static holdTentatively(id: ReservationId, slot: TimeSlot, now: Date) {
    return new Reservation(id, 'tentative', slot, now);
  }
 
  // 業務の言葉のメソッド。ルールはここに書く
  confirm(now: Date) {
    if (this.status !== 'tentative') throw new Error('仮予約のみ確定できます');
    if (now.getTime() - this.heldAt.getTime() > 24 * 60 * 60 * 1000)
      throw new Error('仮予約の期限(24時間)を過ぎています');
    this.status = 'confirmed';
  }
  cancel() {
    if (this.status === 'cancelled') throw new Error('すでにキャンセル済みです');
    this.status = 'cancelled';
  }
  get currentStatus() { return this.status; }
}

// ✗ 貧血: ルールが外にある。別の場所で同じチェックを忘れるとバグ
if (r.status === 'tentative' && within24h(r)) { r.status = 'confirmed'; }
// ○ ルールはエンティティの中
r.confirm(now);

export class ReservationPolicy {
  constructor(private readonly reservations: ReservationRepository) {}
  async canBook(staffId: StaffId, slot: TimeSlot): Promise<boolean> {
    const existing = await this.reservations.findActiveByStaff(staffId, slot.date);
    return existing.every(r => !r.slot.overlaps(slot));
  }
}

ID で追いかける必要がある? ── はい → エンティティ
        │いいえ
        ▼
値として扱える(同じ値なら同じ)? ── はい → 値オブジェクト
        │
        ▼
複数のオブジェクトにまたがるルール? ── はい → ドメインサービス