"""因子目录表（M7.1）。

factor_definition：因子元数据契约源（name 主键幂等）；requires 以 JSON 存。
"""

from __future__ import annotations

from datetime import datetime

from sqlalchemy import DateTime, Integer, String, Text
from sqlalchemy.orm import Mapped, mapped_column

from app.infrastructure.persistence.sqlalchemy.base import Base


class FactorDefinitionModel(Base):
    __tablename__ = "factor_definition"

    name: Mapped[str] = mapped_column(String(64), primary_key=True)
    description: Mapped[str] = mapped_column(String(500), default="")
    formula: Mapped[str] = mapped_column(String(500), default="")
    brief: Mapped[str] = mapped_column(String(500), default="")
    frequency: Mapped[str] = mapped_column(String(16), default="daily")
    lookback: Mapped[int] = mapped_column(Integer, default=20)
    direction: Mapped[str] = mapped_column(String(32), default="higher_is_better")
    requires_json: Mapped[str] = mapped_column(Text, default="[]")
    version: Mapped[str] = mapped_column(String(16), default="1")
    created_at: Mapped[datetime] = mapped_column(DateTime)