コーディング設計 — カプセル化 × 値オブジェクト

📋 コピーfrom dataclasses import dataclass, field


@dataclass(frozen=True)
class DiscountAmount:
    """割引額を表す値オブジェクト（不変）。

    Args:
        value: 割引額（円）。1以上の整数。

    Raises:
        ValueError: value が 1 未満の場合。
    """
    value: int

    def __post_init__(self) -> None:
        if self.value < 1:
            raise ValueError(f"割引額は1円以上が必要です: {self.value}")


@dataclass(frozen=True)
class MinOrderAmount:
    """最小注文金額を表す値オブジェクト（不変）。"""
    value: int

    def __post_init__(self) -> None:
        if self.value < 0:
            raise ValueError(f"最小注文金額は0円以上が必要です: {self.value}")


@dataclass
class Coupon:
    """ECサイトの割引クーポン。

    完全コンストラクタパターン: コンストラクタで完全性を保証。
    Tell, Don't Ask: 割引適用ロジックをクーポン自身が担う。

    Args:
        code: クーポンコード。空文字・空白不可。
        discount_amount: 割引額の値オブジェクト。
        min_order_amount: 適用最小注文金額の値オブジェクト。
    """

    code: str
    discount_amount: DiscountAmount
    min_order_amount: MinOrderAmount
    _used: bool = field(default=False, init=False, repr=False)

    def __post_init__(self) -> None:
        if not self.code or not self.code.strip():
            raise ValueError("クーポンコードは空にできません")

    def is_applicable(self, order_amount: int) -> bool:
        """このクーポンが指定注文金額に適用可能かを返す。"""
        return not self._used and order_amount >= self.min_order_amount.value

    def apply(self, order_amount: int) -> int:
        """クーポンを適用し、割引後の金額を返す。

        Raises:
            ValueError: 使用済み、または最小金額未満の場合。
        """
        if self._used:
            raise ValueError(f"クーポン '{self.code}' は使用済みです")
        if order_amount < self.min_order_amount.value:
            raise ValueError(
                f"注文金額 {order_amount}円 が最小注文金額 {self.min_order_amount.value}円 未満です"
            )
        self._used = True
        return order_amount - self.discount_amount.value