# -*- coding: utf-8 -*-
"""解析器接口定义与通用数据结构"""

from __future__ import annotations

from dataclasses import dataclass, field


@dataclass(slots=True)
class PriceRecord:
    """通用价格记录，各类型解析器均产出此结构"""
    name: str               # 品种/钞种名称
    ref_price: str          # 参考价（最低有效价）
    price_details: dict     # 详细价格 {字段名: 值}，如 {"盒价":"13.9"} 或 {"标十":"xxx"}
    unit: str               # 单位
    quantity: str           # 需求数量
    quantity_unit: str      # 数量单位
    package_req: str        # 包装要求
    quality_req: str        # 品相要求
    other_notes: str        # 其他备注
    raw_text: str           # 原始文本