ad5fe4a411
需求 2.5.1 要求记录用户管理操作，先落表结构： - operation_logs 表：冗余 username 保证账号删除后仍可追溯， user_id 外键 ON DELETE SET NULL，success 默认 '0' 与 login_logs 口径一致 - 截断常量（USERNAME/ERROR_MESSAGE/REQUEST_DATA）集中定义，供写入方引用 - 修复既有 V1 迁移与迁移模板的 downgrade：索引是外键唯一支撑索引， 先 drop_index 会报 errno 1553，改为只 drop_table - 同步 db/migration/V2 与 init-dev.sql，迁移版本号更新为 a45a8087831b Co-Authored-By: Claude Code <noreply@anthropic.com>
110 lines
4.2 KiB
Python
110 lines
4.2 KiB
Python
"""新增操作日志表
|
||
|
||
Revision ID: a45a8087831b
|
||
Revises: 6165691326d4
|
||
Create Date: 2026-10-10 10:06:17.435697
|
||
|
||
"""
|
||
|
||
from collections.abc import Sequence
|
||
|
||
from alembic import op
|
||
import sqlalchemy as sa
|
||
from sqlalchemy.dialects import mysql
|
||
|
||
# revision identifiers, used by Alembic.
|
||
revision: str = "a45a8087831b"
|
||
down_revision: str | Sequence[str] | None = "6165691326d4"
|
||
branch_labels: str | Sequence[str] | None = None
|
||
depends_on: str | Sequence[str] | None = None
|
||
|
||
|
||
def upgrade() -> None:
|
||
"""应用迁移。"""
|
||
# ### commands auto generated by Alembic - please adjust! ###
|
||
op.create_table(
|
||
"operation_logs",
|
||
sa.Column(
|
||
"id", mysql.BIGINT(unsigned=True), autoincrement=True, nullable=False, comment="主键ID"
|
||
),
|
||
sa.Column(
|
||
"user_id",
|
||
mysql.BIGINT(unsigned=True),
|
||
nullable=True,
|
||
comment="操作人ID（账号删除后置空）",
|
||
),
|
||
sa.Column(
|
||
"username",
|
||
sa.String(length=64),
|
||
nullable=False,
|
||
comment="操作人用户名（冗余存储便于追溯）",
|
||
),
|
||
sa.Column("module", sa.String(length=64), nullable=False, comment="所属模块，如 用户管理"),
|
||
sa.Column(
|
||
"action", sa.String(length=32), nullable=False, comment="操作类型：新增/修改/删除/导出"
|
||
),
|
||
sa.Column(
|
||
"summary", sa.String(length=255), nullable=False, comment="操作摘要（中文，供人阅读）"
|
||
),
|
||
sa.Column("method", sa.String(length=8), nullable=True, comment="HTTP 方法"),
|
||
sa.Column("path", sa.String(length=255), nullable=True, comment="请求路径"),
|
||
sa.Column("ip", sa.String(length=45), nullable=True, comment="客户端IP（45位兼容IPv6）"),
|
||
sa.Column(
|
||
"user_agent",
|
||
sa.String(length=255),
|
||
nullable=True,
|
||
comment="客户端User-Agent（截断存储）",
|
||
),
|
||
sa.Column("request_data", sa.Text(), nullable=True, comment="请求参数（已脱敏）"),
|
||
sa.Column(
|
||
"success",
|
||
mysql.TINYINT(),
|
||
server_default="0",
|
||
nullable=False,
|
||
comment="是否成功：1成功 0失败",
|
||
),
|
||
sa.Column(
|
||
"error_message",
|
||
sa.String(length=500),
|
||
nullable=True,
|
||
comment="失败原因（写入方须截断）",
|
||
),
|
||
sa.Column("duration_ms", sa.Integer(), nullable=True, comment="处理耗时（毫秒）"),
|
||
sa.Column(
|
||
"create_time",
|
||
sa.DateTime(),
|
||
server_default=sa.text("CURRENT_TIMESTAMP"),
|
||
nullable=False,
|
||
comment="创建时间",
|
||
),
|
||
sa.ForeignKeyConstraint(
|
||
["user_id"], ["users.id"], name=op.f("fk_operation_logs_user_id"), ondelete="SET NULL"
|
||
),
|
||
sa.PrimaryKeyConstraint("id", name=op.f("pk_operation_logs")),
|
||
comment="操作日志表",
|
||
mysql_charset="utf8mb4",
|
||
mysql_collate="utf8mb4_general_ci",
|
||
mysql_engine="InnoDB",
|
||
)
|
||
op.create_index(
|
||
"idx_operation_logs_create_time", "operation_logs", ["create_time"], unique=False
|
||
)
|
||
op.create_index("idx_operation_logs_module", "operation_logs", ["module"], unique=False)
|
||
op.create_index("idx_operation_logs_user_id", "operation_logs", ["user_id"], unique=False)
|
||
op.create_index("idx_operation_logs_username", "operation_logs", ["username"], unique=False)
|
||
# ### end Alembic commands ###
|
||
|
||
|
||
def downgrade() -> None:
|
||
"""回滚迁移。
|
||
|
||
**注意（autogenerate 不会替你处理）**：生成的 `op.drop_index` 与
|
||
`op.drop_table` 顺序需人工检查 —— 若某索引是外键的唯一支撑索引，
|
||
单独 drop_index 会报 MySQL 1553（needed in a foreign key constraint）。
|
||
**整表回滚应只保留 `op.drop_table`**，DROP TABLE 会连带删除索引与外键。
|
||
"""
|
||
# 整表回滚只保留 drop_table —— DROP TABLE 会连带删除索引与外键。
|
||
# 逐个 drop_index 会失败：idx_operation_logs_user_id 是外键
|
||
# fk_operation_logs_user_id 的唯一支撑索引，MySQL 拒绝删除（errno 1553）。
|
||
op.drop_table("operation_logs")
|