# -*- coding: utf-8 -*-
"""集中配置与常量（框架无关）。

仅常量、配置类与路径定义；分层重构未改变任何取值。
不导入 fastapi，不持有任何运行时可变状态（运行时状态见 core.state）。
"""

import os
from dataclasses import dataclass

# 站点统一版本号（/health、/api/info、前端 CHANGELOG 全部以此为准，别处不得硬编码）
APP_VERSION = '2.4.0'

# 交付结果保留期（服务端与前端「领取」入口统一 35 分钟——前端入口保留 35 分钟，
# 原 30 分钟会在最后 5 分钟让领取必 404）。终态任务记录、任务目录、下载缓存均按此回收。
RESULT_RETENTION_SECONDS = 35 * 60


@dataclass
class Settings:
    """服务配置类（保留 APIConfig 别名以兼容既有引用）"""

    host: str = '0.0.0.0'
    port: int = 5000
    debug: bool = False
    downloads_dir: str = 'downloads'
    # max_file_size/request_timeout 两个架空字段已删除——请求体上限真实
    # 生效点是 _body_size_limit（业务 2MB/备份 200MB），上游超时在 music_api 各调用点
    log_level: str = 'INFO'
    cors_origins: str = (
        os.environ.get('CORS_ORIGINS') or '*'
    ).strip() or '*'  # 可经环境变量收敛同源（空值回落默认）


# 向后兼容别名：既有代码/文档沿用 APIConfig 名称
APIConfig = Settings


# 游客个人登录使用的独立 Cookie 文件（与管理员全局 Cookie 分离）。
# 这是有意的隔离——QRLoginClient 的默认值恰是全局 cookie.txt，
# 显式传参防误写全局文件；起本站任何路径都不再写它（仅构造参数）
USER_COOKIE_FILE = 'user_cookie.txt'


# 设备心跳时序：超时未上线则暂停其批量任务让出排队名额；超过取消窗口则取消并删文件
PAUSE_AFTER_SECONDS = 40
CANCEL_AFTER_SECONDS = 30 * 60
HEARTBEAT_INTERVAL = 15

# 每用户同时在途（排队/运行/暂停）任务上限与全站任务表上限（资源上限）
MAX_ACTIVE_TASKS_PER_USER = 5
MAX_TOTAL_TASKS = 200
# 终态任务要留表 35 分钟供领取，容量闸只数在途任务——旧口径把
# 终态记录计入 200 上限会把全站吞吐封顶在约 5.7 任务/分钟；终态另设更大的滞留
# 上限保内存有界（1000 ≈ 28 任务/分钟的领取窗口，远高于在途处理能力）
MAX_TERMINAL_TASKS = 1000

# 全局批量打包并发上限（同时构建的 ZIP 数量）
BATCH_ZIP_CONCURRENCY = 3


# 音频直链多重防护（HMAC 签名 + 时效 + 代理流）
AUDIO_TOKEN_TTL = RESULT_RETENTION_SECONDS + 60  # = 36 分钟——原 30 分钟
# 大于交付/解析结果 35 分钟保留期 60 秒：交付窗口末段试听不再 403（旧 30 分钟口径矛盾已修）
AUDIO_URL_KEYS = {'url', 'audioUrl'}
AUDIO_HOST_MARKS = ('126.net', 'music.126.net', '.netease')


# 可解析音质档位（顺序即前端展示顺序）
VALID_QUALITY_LEVELS = ['standard', 'exhigh', 'lossless', 'hires', 'sky', 'jyeffect', 'jymaster', 'dolby']