A コーディング — defaultdict × sorted スライス × frozen dataclass × Decimal（カテゴリ別売上集計 Bad→Good）

📋 コピー"""sales_aggregator.py — カテゴリ別売上集計（Bad → Good リファクタリング）

良いコード・悪いコードで学ぶ設計入門（改訂新版）
  - Ch2: 型の活用（dataclass frozen+slots, Decimal, type hints）
  - Ch4: コレクション操作の整理（defaultdict, sorted, スライス）
  - Ch3: 値オブジェクト（OrderItem を immutable dataclass で表現）
"""
from __future__ import annotations

from collections import defaultdict
from dataclasses import dataclass
from decimal import Decimal
from typing import Final

# ── 名前付き定数（マジックナンバー・魔法の文字列を廃絶）────────────────────
DEFAULT_CATEGORY: Final[str] = "unknown"   # category が None/未設定の場合に使うラベル
TOP_N_DEFAULT:    Final[int] = 10           # 上位件数のデフォルト値


# ── 値オブジェクト（Ch3: 不変・型安全なデータ表現）──────────────────────────
@dataclass(frozen=True, slots=True)
class OrderItem:
    """注文内の1品目を表す不変の値オブジェクト。

    Attributes:
        name: 商品名。
        category: 商品カテゴリ（None の場合は DEFAULT_CATEGORY に正規化して渡す）。
        price: 単価（Decimal で金額精度を保証）。
        qty: 数量。
    """
    name: str
    category: str
    price: Decimal
    qty: int

    @property
    def subtotal(self) -> Decimal:
        """小計（単価 × 数量）を返す。Decimal で精度を保持。"""
        return self.price * self.qty


@dataclass(frozen=True, slots=True)
class Order:
    """1注文を表す不変の値オブジェクト。

    Attributes:
        order_id: 注文ID。
        items: 注文品目リスト（tuple で immutable 化）。
    """
    order_id: str
    items: tuple[OrderItem, ...]


# ── パース関数（dict → 値オブジェクトへの変換）──────────────────────────────
def parse_order(raw: dict) -> Order:
    """生の dict を Order 値オブジェクトに変換する。

    Args:
        raw: API / DB から取得した注文 dict。

    Returns:
        型安全な Order 値オブジェクト。

    Raises:
        KeyError: 必須フィールドが欠けている場合。
    """
    items = tuple(
        OrderItem(
            name=item["name"],
            # None / 空文字列を DEFAULT_CATEGORY に正規化（or で一括処理）
            category=item.get("category") or DEFAULT_CATEGORY,
            price=Decimal(str(item["price"])),  # float → str → Decimal で精度を保持
            qty=int(item["qty"]),
        )
        for item in raw["items"]
    )
    return Order(order_id=raw["id"], items=items)


# ── 集計関数（Ch4: defaultdict でカウンタ操作を整理）────────────────────────
def aggregate_by_category(orders: list[Order]) -> dict[str, Decimal]:
    """全注文のカテゴリ別売上合計を集計する。

    Args:
        orders: 集計対象の注文リスト。

    Returns:
        カテゴリ名 → 売上合計（Decimal）のマッピング。
    """
    # defaultdict(Decimal) でキー存在チェックを省略
    # if cat in result: ... else: result[cat] = ... の分岐がゼロになる
    totals: defaultdict[str, Decimal] = defaultdict(Decimal)
    for order in orders:
        for item in order.items:
            totals[item.category] += item.subtotal   # 初回アクセス時に Decimal('0') が自動挿入
    return dict(totals)


def get_top_categories(
    orders: list[Order], n: int = TOP_N_DEFAULT
) -> list[tuple[str, Decimal]]:
    """売上上位 n カテゴリを降順で返す。

    Args:
        orders: 集計対象の注文リスト。
        n: 返す上位件数（デフォルト: TOP_N_DEFAULT = 10）。

    Returns:
        (カテゴリ名, 売上合計) のタプルリスト（降順、最大 n 件）。
    """
    totals = aggregate_by_category(orders)
    # sorted + reverse=True の1行で手動sort+reverseを置き換え（Ch4）
    # [:n] スライスで while カウンタループを置き換え（境界チェック自動）
    return sorted(totals.items(), key=lambda kv: kv[1], reverse=True)[:n]


# ── 実行例 ─────────────────────────────────────────────────────────────────
if __name__ == "__main__":
    raw_orders = [
        {"id": "ORD-001", "items": [
            {"name": "T-shirt",  "category": "apparel",  "price": 2500,  "qty": 3},
            {"name": "Jeans",    "category": None,        "price": 5800,  "qty": 1},
        ]},
        {"id": "ORD-002", "items": [
            {"name": "Sneakers", "category": "apparel",     "price": 12000, "qty": 2},
            {"name": "Book",     "category": "books",        "price":  1500, "qty": 5},
            {"name": "Gadget",   "category": "electronics",  "price":  8000, "qty": 1},
        ]},
    ]

    orders = [parse_order(r) for r in raw_orders]
    results = get_top_categories(orders, n=3)

    for rank, (cat, total) in enumerate(results, start=1):
        print(f"{rank}. {cat}: ¥{total:,}")