"""MarketDataProvider（数据源抽象）。

业务层只依赖本 Protocol（AGENT.md §6），禁止在业务代码中 import
tushare / 新浪实现。数据源一律返回 domain.entities 中的归一化实体。
"""

from __future__ import annotations

from datetime import date
from typing import Protocol

from app.domain.entities.market import (
    AdjustFactor,
    DailyBar,
    FinancialIndicator,
    Stock,
    TradingCalendar,
)


class MarketDataProvider(Protocol):
    """统一市场数据源接口。

    实现约定：
    - get_daily 返回**不复权**行情（复权经 AdjustFactor 显式计算，禁止静默改口径）
    - get_financial 返回带 announce_date 的指标，供上层按 as_of 过滤
    - 实现不得抛出裸连接异常以外的噪音；业务错误应转为 DataSourceError
    """

    name: str

    def get_stock_basic(self) -> list[Stock]: ...

    def get_trade_cal(self, start: date, end: date) -> list[TradingCalendar]: ...

    def get_daily(self, symbol: str, start: date, end: date) -> list[DailyBar]: ...

    def get_adjust_factor(self, symbol: str, start: date, end: date) -> list[AdjustFactor]: ...

    def get_financial(self, symbol: str) -> list[FinancialIndicator]: ...