"""因子目录表（M7.1；2026-10 支持参数化实例）。

factor_definition：因子名（主键，参数化实例的参数就写在名字里）→ 元数据；requires 以 JSON 存。
`enabled` 是唯一由人配置的字段（是否出现在因子下拉里）；内置实例的开关注由代码注册表
收敛（见 application/services/factor_catalog.py），停用只影响「能不能被选中」，
不影响已引用它的策略/归档解析 —— 历史不能被开关改义。
"""

from __future__ import annotations

from datetime import datetime

from sqlalchemy import Boolean, 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"

    # 128：参数化实例的名字把参数写全（如 momentum(window=90,direction=lower_is_better)）
    name: Mapped[str] = mapped_column(String(128), 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")
    enabled: Mapped[bool] = mapped_column(Boolean, default=True, server_default="1")
    created_at: Mapped[datetime] = mapped_column(DateTime)