"""上传文件台账表 `file_assets`(在线协作的图片落库)。 协作里用户上传的图片本体放对象存储(ECS 与桶同地域时走内网 endpoint, ``oss--internal.aliyuncs.com``),库里只留 key 与元数据: - 图片一律经 ``/api/files/object?key=...`` 由后端代理回读,**不下发 OSS 直链**。 参考 order_site 踩过的坑:曾经发过「15 分钟有效的签名链接」,结果入库时把当时的 链接原样存了下来,之后任何不重签的地方过一会儿必然裂图; - ``object_key`` 里带 12 字节随机段(``scene/yyyy/mm/dd/<24位hex>``), 不可枚举,所以普通链接就够用; - ``thumbnail_object_key`` / ``medium_object_key`` 为空表示缩略图生成失败, 回读接口按 `.thumb.webp → .thumb.jpg → .thumb.png → 原图` 逐个候选回退。 """ from __future__ import annotations from collections.abc import Sequence import sqlalchemy as sa from alembic import op revision: str = "20261016_0054" down_revision: str | None = "20261015_0053" branch_labels: str | Sequence[str] | None = None depends_on: str | Sequence[str] | None = None def _tables(bind) -> set[str]: return set(sa.inspect(bind).get_table_names()) def upgrade() -> None: bind = op.get_bind() if "file_assets" in _tables(bind): return op.create_table( "file_assets", sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True), # 对象存储里的 key:scene/yyyy/mm/dd/<24位随机hex> sa.Column("object_key", sa.String(length=512), nullable=False), # 业务场景前缀(collab/… 等),同时决定公开还是私有 sa.Column("scene", sa.String(length=32), nullable=False, server_default="misc"), sa.Column( "original_filename", sa.String(length=255), nullable=False, server_default="", ), sa.Column( "content_type", sa.String(length=64), nullable=False, server_default="" ), sa.Column("size_bytes", sa.BigInteger(), nullable=False, server_default="0"), sa.Column( "thumbnail_object_key", sa.String(length=512), nullable=False, server_default="", ), sa.Column( "medium_object_key", sa.String(length=512), nullable=False, server_default="", ), sa.Column( "uploader_type", sa.String(length=32), nullable=False, server_default="user" ), sa.Column( "uploader_id", sa.String(length=64), nullable=False, server_default="" ), sa.Column( "status", sa.String(length=16), nullable=False, server_default="active" ), sa.Column("metadata_json", sa.JSON(), nullable=True), sa.Column("created_at", sa.DateTime(), nullable=False), sa.Column("updated_at", sa.DateTime(), nullable=False), ) # 回读接口按 key 精确定位,重复上传同一个 key 也要挡在唯一约束上。 op.create_index( "ix_file_assets_object_key", "file_assets", ["object_key"], unique=True ) op.create_index("ix_file_assets_scene", "file_assets", ["scene"]) op.create_index("ix_file_assets_uploader_id", "file_assets", ["uploader_id"]) def downgrade() -> None: bind = op.get_bind() if "file_assets" not in _tables(bind): return # MySQL 删表会连同索引一起删,不必逐个 drop_index。 op.drop_table("file_assets")