A コーディング — 目的駆動命名 × 技術駆動命名の回避 × StrEnum によるマジック文字列排除（キャンペーンクーポン発行 Bad→Good Ch11/Ch3/Ch8）

📋 コピー"""coupon_issuance.py — キャンペーンクーポン発行・適用

良いコード・悪いコードで学ぶ設計入門（改訂新版）
  Ch11: 名前設計 — 目的駆動命名、技術駆動命名の回避、省略しない
  Ch3 : 完全コンストラクタ・値オブジェクト
  Ch8 : StrEnum によるマジック文字列排除
"""
from __future__ import annotations

from dataclasses import dataclass
from enum import StrEnum


class DiscountType(StrEnum):
    """クーポンの割引方式。"""

    FIXED_AMOUNT = "fixed_amount"
    PERCENTAGE = "percentage"


@dataclass(frozen=True, slots=True)
class Member:
    """会員。"""

    member_level: int


@dataclass(frozen=True, slots=True)
class CouponEligibility:
    """クーポン適用に必要な会員条件（値オブジェクト）。"""

    minimum_member_level: int

    def is_satisfied_by(self, member: Member) -> bool:
        """会員が適用条件を満たすか判定する。

        Args:
            member: 判定対象の会員。

        Returns:
            条件を満たすなら True。
        """
        return member.member_level >= self.minimum_member_level


@dataclass(slots=True)
class Coupon:
    """発行済みクーポン1件。"""

    discount_type: DiscountType
    discount_value: float  # 定額(FIXED_AMOUNT)なら円、定率(PERCENTAGE)ならパーセント
    eligibility: CouponEligibility
    is_redeemed: bool = False

    def is_redeemable_by(self, member: Member) -> bool:
        """会員がこのクーポンを使用可能か判定する（クエリ・副作用なし）。

        Args:
            member: 判定対象の会員。

        Returns:
            使用可能なら True。
        """
        return self.eligibility.is_satisfied_by(member) and not self.is_redeemed

    def calculate_discounted_amount(self, original_amount: int) -> int:
        """割引後の金額を計算する（クエリ・副作用なし）。

        Args:
            original_amount: 割引適用前の金額（円）。

        Returns:
            割引後の金額（円）。
        """
        if self.discount_type is DiscountType.FIXED_AMOUNT:
            return original_amount - int(self.discount_value)
        return int(original_amount * (1 - self.discount_value / 100))

    def redeem(self, member: Member, original_amount: int) -> int:
        """クーポンを適用し、使用済みにする（コマンド・副作用あり）。

        Args:
            member: 適用対象の会員。
            original_amount: 割引適用前の金額。

        Returns:
            割引適用後の金額。適用不可の場合は original_amount をそのまま返す。
        """
        if not self.is_redeemable_by(member):
            return original_amount
        discounted_amount = self.calculate_discounted_amount(original_amount)
        self.is_redeemed = True
        return discounted_amount


def apply_coupon_to_cart(coupon: Coupon, member: Member, original_amount: int) -> int:
    """カート画面でクーポンを適用する。"""
    return coupon.redeem(member, original_amount)