document-management/backend/migrations/versions/0037_drop_audit_target_check.py

"""删除 sys_audit_log.target_type 的 CHECK 白名单约束。

Revision ID: 0037_drop_audit_target_check
Revises: 0036_notification
Create Date: 2026-09-16

变更要点：
1. 借阅审批流（契约1.37，Java版）新增审计对象类型 BORROW_REQUEST，库内
   target_type CHECK 白名单未同步，借阅审计写入违约并连带业务操作 500；
2. 与 0035 对 action_type 的处理同理：审计对象类型同为持续扩展的枚举
   （0029 已加 SYSTEM、1.37 又纳入 BORROW_REQUEST），DB CHECK 导致审计
   事实记录因枚举扩展而丢失，合法性收敛到应用层字典；
3. operation_result 的 CHECK 保留（SUCCESS/FAILURE 二值稳定枚举）；
4. 模型层同步删除该 CheckConstraint（dms/models/audit_log.py，新装库不再创建）。
"""

from __future__ import annotations

from collections.abc import Sequence

import sqlalchemy as sa
from alembic import op

revision: str = "0037_drop_audit_target_check"
down_revision: str | None = "0036_notification"
branch_labels: str | Sequence[str] | None = None
depends_on: str | Sequence[str] | None = None

# 与 0035 一致：op.drop_constraint 按 naming convention 前缀化约束名，
# 传原始名渲染最终名（ck_sys_audit_log_audit_target_type）。
_TARGET_CONSTRAINT = "audit_target_type"


def _existing_check_names() -> set[str]:
    return {
        item["name"].lower()
        for item in sa.inspect(op.get_bind()).get_check_constraints("sys_audit_log")
    }


def upgrade() -> None:
    if f"ck_sys_audit_log_{_TARGET_CONSTRAINT}" in _existing_check_names():
        op.drop_constraint(_TARGET_CONSTRAINT, "sys_audit_log", type_="check")


def downgrade() -> None:
    raise RuntimeError(
        "0037降级需按当时对象类型全集重建 CHECK 白名单，且库中不得存在白名单外"
        "target_type 记录；如确需恢复约束请人工评估后执行"
    )