MoviePilot/app/db/models/subscribehistory.py

from typing import Optional

from sqlalchemy import Column, Integer, String, Float, JSON, Index, or_, select
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy.orm import Session

from app.db import db_query, Base, get_id_column, async_db_query
from app.db.models.media_identity import media_identity_constraint
from app.schemas.types import MUSIC_ENTITY_RECORDING, MediaSource


class SubscribeHistory(Base):
    """
    订阅历史表
    """
    id = get_id_column()
    # 标题
    name = Column(String, nullable=False, index=True)
    # 年份
    year = Column(String)
    # 类型
    type = Column(String)
    # 搜索关键字
    keyword = Column(String)
    media_source = Column(String, index=True)
    media_id = Column(String, index=True)
    # 音乐实体类型：recording 单曲、album 专辑
    music_type = Column(String)
    # 专辑预期总曲目数
    total_tracks = Column(Integer)
    # 季号
    season = Column(Integer)
    # 海报
    poster = Column(String)
    # 背景图
    backdrop = Column(String)
    # 评分，float
    vote = Column(Float)
    # 简介
    description = Column(String)
    # 过滤规则
    filter = Column(String)
    # 包含
    include = Column(String)
    # 排除
    exclude = Column(String)
    # 质量
    quality = Column(String)
    # 分辨率
    resolution = Column(String)
    # 特效
    effect = Column(String)
    # 音乐音质等级：hires/lossless/lossy，可用正则组合
    audio_quality = Column(String)
    # 音频格式，可用正则组合
    audio_format = Column(String)
    # 最低码率（bps）
    min_bitrate = Column(Integer)
    # 最低位深（bit）
    min_bit_depth = Column(Integer)
    # 最低采样率（Hz）
    min_sample_rate = Column(Integer)
    # 总集数
    total_episode = Column(Integer)
    # 开始集数
    start_episode = Column(Integer)
    # 订阅完成时间
    date = Column(String)
    # 订阅用户
    username = Column(String)
    # 订阅站点
    sites = Column(JSON)
    # 是否洗版
    best_version = Column(Integer, default=0)
    # 是否只洗全集整包，开启后电视剧洗版不按单集下载
    best_version_full = Column(Integer, default=0)
    # 完成时的整体优先级
    current_priority = Column(Integer)
    # 完成时的音乐格式
    current_audio_format = Column(String)
    # 完成时的音乐码率（bps）
    current_bitrate = Column(Integer)
    # 完成时的音乐位深（bit）
    current_bit_depth = Column(Integer)
    # 完成时的音乐采样率（Hz）
    current_sample_rate = Column(Integer)
    # 洗版时已下载剧集的优先级状态，格式：{"1": 90, "2": 100}
    episode_priority = Column(JSON)
    # 保存路径
    save_path = Column(String)
    # 是否使用 imdbid 搜索
    search_imdbid = Column(Integer, default=0)
    # 自定义识别词
    custom_words = Column(String)
    # 自定义媒体类别
    media_category = Column(String)
    # 过滤规则组
    filter_groups = Column(JSON, default=list)
    # 剧集组
    episode_group = Column(String)

    __table_args__ = (
        media_identity_constraint("subscribehistory"),
        Index('ix_subscribehistory_type_date', 'type', 'date'),
        Index('ix_subscribehistory_media_identity', 'media_source', 'media_id'),
    )

    @classmethod
    @db_query
    def list_by_type(cls, db: Session, mtype: str, page: Optional[int] = 1, count: Optional[int] = 30):
        return db.query(cls).filter(
            cls.type == mtype
        ).order_by(
            cls.date.desc()
        ).offset((page - 1) * count).limit(count).all()

    @classmethod
    @async_db_query
    async def async_list_by_type(cls, db: AsyncSession, mtype: str, page: Optional[int] = 1, count: Optional[int] = 30):
        result = await db.execute(
            select(cls).filter(
                cls.type == mtype
            ).order_by(
                cls.date.desc()
            ).offset((page - 1) * count).limit(count)
        )
        return result.scalars().all()

    @classmethod
    @async_db_query
    async def async_list_by_type_and_username(
            cls,
            db: AsyncSession,
            mtype: str,
            username: str,
            page: Optional[int] = 1,
            count: Optional[int] = 30
    ):
        """
        按订阅 owner 查询指定类型的历史分页。
        """
        if not username:
            return []
        result = await db.execute(
            select(cls).filter(
                cls.type == mtype,
                cls.username == username
            ).order_by(
                cls.date.desc()
            ).offset((page - 1) * count).limit(count)
        )
        return result.scalars().all()

    @classmethod
    def _identity_condition(
            cls,
            media_source: Optional[MediaSource] = None,
            media_id: Optional[str] = None,
            music_type: Optional[str] = None,
    ):
        """按统一媒体身份优先级构造订阅历史查询条件。"""
        if not media_source or media_id is None or not str(media_id).strip():
            return None
        condition = (
            (cls.media_source == str(media_source))
            & (cls.media_id == str(media_id).strip())
        )
        if music_type == MUSIC_ENTITY_RECORDING:
            return condition & or_(cls.music_type == music_type, cls.music_type.is_(None))
        if music_type:
            return condition & (cls.music_type == music_type)
        return condition

    @classmethod
    @db_query
    def exists(
            cls, db: Session, media_source: MediaSource, media_id: str,
            season: Optional[int] = None,
            episode_group: Optional[str] = None,
            music_type: Optional[str] = None,
    ):
        """按媒体身份、季号及可选剧集组查询订阅历史。"""
        condition = cls._identity_condition(
            media_source, media_id, music_type
        )
        if condition is None:
            return None
        query = db.query(cls).filter(condition)
        if season is not None:
            query = query.filter(cls.season == season)
        query = query.filter(cls.episode_group == episode_group)
        return query.first()

    @classmethod
    @async_db_query
    async def async_exists(
            cls, db: AsyncSession, media_source: MediaSource, media_id: str,
            season: Optional[int] = None,
            episode_group: Optional[str] = None,
            music_type: Optional[str] = None,
    ):
        """异步按媒体身份、季号及可选剧集组查询订阅历史。"""
        condition = cls._identity_condition(
            media_source, media_id, music_type
        )
        if condition is None:
            return None
        query = select(cls).filter(condition)
        if season is not None:
            query = query.filter(cls.season == season)
        query = query.filter(cls.episode_group == episode_group)
        result = await db.execute(query)
        return result.scalars().first()