第4章: しなやかな設計 — コードの柔軟性を高める7つのパターン

// 悪い例: 実装の詳細が名前に漏れている
class Paint {
  // v1, v2が何を意味するか分からない
  mix(v1: number, v2: number): Paint { ... }
}

// 良い例: 意図が名前から読み取れる
class Paint {
  mixWith(other: Paint, ratio: MixRatio): Paint { ... }
}

// ドメインの意図がさらに明確な例
class Policy {
  // 「何をするか」ではなく「なぜ使うか」が分かる
  isEligibleFor(claim: InsuranceClaim): boolean { ... }
  calculatePremiumFor(driver: Driver): Money { ... }
}

// 値オブジェクトの副作用のない操作
class DateRange {
  constructor(
    readonly start: Date,
    readonly end: Date
  ) { Object.freeze(this); }

  // 副作用なし: 新しいDateRangeを返す
  extendBy(days: number): DateRange {
    const newEnd = addDays(this.end, days);
    return new DateRange(this.start, newEnd);
  }

  // 副作用なし: booleanを返すだけ
  overlaps(other: DateRange): boolean {
    return this.start < other.end && other.start < this.end;
  }
}

class BankAccount {
  private balance: Money;

  // 事前条件: 引き出し額 > 0、残高 >= 引き出し額
  // 事後条件: 残高が引き出し額分だけ減少
  // 不変条件: 残高は常に0以上
  withdraw(amount: Money): void {
    // 事前条件の表明
    if (amount.isNegativeOrZero()) {
      throw new Error('引き出し額は正の値である必要があります');
    }
    if (this.balance.isLessThan(amount)) {
      throw new Error('残高が不足しています');
    }

    this.balance = this.balance.subtract(amount);

    // 不変条件の表明
    assert(this.balance.isNonNegative(),
      '残高が負になりました — 不変条件違反');
  }
}

class Money {
  // Money + Money → Money（閉包性）
  add(other: Money): Money {
    return Money.create(this.amount + other.amount, this.currency);
  }

  // Money * number → Money（引数の型は異なるが戻り値はMoney）
  multiply(factor: number): Money {
    return Money.create(this.amount * factor, this.currency);
  }
}

// 閉包性により自然にチェーンできる
const total = basePrice
  .multiply(quantity)
  .add(shippingFee)
  .add(tax);

// Specificationの基底
interface Specification<T> {
  isSatisfiedBy(candidate: T): boolean;
  and(other: Specification<T>): Specification<T>;
  or(other: Specification<T>): Specification<T>;
  not(): Specification<T>;
}

// 個別のビジネスルールをSpecificationとして宣言
class IsAdult implements Specification<Customer> {
  isSatisfiedBy(c: Customer) { return c.age >= 18; }
}
class HasGoodCredit implements Specification<Customer> {
  isSatisfiedBy(c: Customer) { return c.creditScore >= 700; }
}

// 宣言的に組み合わせる
const eligibleForLoan = new IsAdult()
  .and(new HasGoodCredit());

// 使う側は「何を判定するか」だけを読む
if (eligibleForLoan.isSatisfiedBy(customer)) {
  approveLoan(customer);
}