"""Alembic 迁移环境。

**连接串取自 backend/.env**，不写在 alembic.ini —— 避免密码进版本库，
也避免运行期配置与迁移配置两处漂移。运行期与迁移共用同一份同步连接串
（驱动 pymysql），不存在同步/异步两套配置。
"""

import sys
from logging.config import fileConfig
from pathlib import Path

from alembic import context
from sqlalchemy import engine_from_config, pool

# 使 `app` 包在 alembic 执行时可导入（alembic 从 backend/ 目录运行）
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))

from app.core.config import get_settings
from app.models import Base

config = context.config

if config.config_file_name is not None:
    fileConfig(config.config_file_name)

# autogenerate 的比对基准
target_metadata = Base.metadata

# 运行期把 .env 里的连接串注入配置，覆盖 alembic.ini 中的占位值
config.set_main_option(
    "sqlalchemy.url",
    get_settings().database_url.render_as_string(hide_password=False),
)


def run_migrations_offline() -> None:
    """离线模式：不连库，只输出 SQL。

    用于导出 `db/migration/V{n}__*.sql` 留存脚本。
    """
    context.configure(
        url=config.get_main_option("sqlalchemy.url"),
        target_metadata=target_metadata,
        literal_binds=True,
        dialect_opts={"paramstyle": "named"},
        # 类型变更也要被识别，否则改列类型不会生成迁移
        compare_type=True,
    )
    with context.begin_transaction():
        context.run_migrations()


def run_migrations_online() -> None:
    """在线模式：连库执行迁移。"""
    connectable = engine_from_config(
        config.get_section(config.config_ini_section, {}),
        prefix="sqlalchemy.",
        # 迁移是一次性任务，用完即弃，不需要连接池
        poolclass=pool.NullPool,
    )
    with connectable.connect() as connection:
        context.configure(
            connection=connection,
            target_metadata=target_metadata,
            compare_type=True,
        )
        with context.begin_transaction():
            context.run_migrations()


if context.is_offline_mode():
    run_migrations_offline()
else:
    run_migrations_online()