SKU-Level PL Dashboard — 单品利润核算：每个 SKU 今天赚了多少钱

"""
SKU-Level P&L Dashboard — 单品利润核算模型
基于 Amazon FBA 成本结构 + Contribution Margin 分析

依赖: dataclasses, statistics (标准库)
"""

from dataclasses import dataclass, field
from statistics import mean
from typing import Optional


@dataclass
class FBAConfig:
    """FBA 费用配置（2026 年标准）"""
    referral_fee_rate: float = 0.08       # Amazon 平台佣金率（母婴品类 8%）
    fulfillment_fee: float = 4.25         # 拣货配送费（标准件）
    storage_rate_monthly: float = 0.78   # 月度仓储费（$0.78/立方英尺，Q1-Q3）
    storage_rate_q4: float = 2.40        # Q4 旺季仓储费
    inbound_fee_per_unit: float = 0.50   # FBA 入库费
    return_processing_fee: float = 2.45  # 退货处理费
    product_cubic_feet: float = 0.20     # 商品体积（立方英尺）


@dataclass
class SKUCosts:
    """单 SKU 成本结构"""
    sku_id: str
    title: str
    selling_price: float
    cogs: float                          # 产品成本（含采购+头程）
    return_rate: float = 0.06            # 退货率
    is_q4: bool = False                  # 是否 Q4 旺季（影响仓储费）
    ad_spend_per_unit: float = 0.0       # 广告费/件（= 广告总花费/出货量）
    monthly_units_sold: int = 100        # 月销售量


@dataclass
class SKUPL:
    """单 SKU P&L 报表"""
    sku_id: str
    title: str
    # 收入层
    gross_revenue_per_unit: float
    return_loss_per_unit: float
    net_revenue_per_unit: float
    # 成本层
    cogs: float
    gross_profit: float
    gross_margin: float
    # FBA 层
    referral_fee: float
    fulfillment_fee: float
    storage_fee: float
    inbound_fee: float
    total_fba_fee: float
    post_fba_profit: float
    post_fba_margin: float
    # 广告层
    ad_spend_per_unit: float