Files
live-hub-py/web/backend/migrations/versions/20261016_0054_file_assets.py
T
yml2213 df8c63b829 feat(huya): 外部 CK 协作台账(S1–S6)+ 图片上传能力
协作台账:新表 huya_external_orders 替代 Excel 多人协同表(设计见
docs/设计-虎牙外部CK协作台账.md),一条 CK 一行,所有人共享、改动留痕。

- 前端 pages/HuyaCollabPage.tsx + 菜单「虎牙 → 外部单协作」/huya/collab:
  内联编辑(带乐观锁 version)、图片缩略图、详情抽屉(字段表单 + 两个图片槽位 +
  操作时间线)、粘贴导入弹窗(带 TSV 预览)、批量/单条验证 CK、页头统计条、筛选
- 两套状态机:业务 pending→bound→recharged→scripted→done(旁路 void)、
  凭据 unverified/valid/invalid/disabled;唯一写入口在 services/huya_collab_service.py,
  字段级审计 + 整数 version 乐观锁(不用 updated_at:DATETIME 只到秒)
- CK 只读探针 check_user_bind_game_account(真机判据:响应非 None 且 status == 200),
  成功即覆盖写绑定快照 bind_game_account/bind_game_role/bind_game_channel(迁移 0056),
  失败只改凭据状态、不动业务状态;人工只能停用/恢复(POST /{id}/ck/status)
- 贴/换/重建 CK、TSV 批量导入(SAVEPOINT 单行隔离,部分失败不整体失败)、
  权限 huya:collab:view/edit/manage(删除只给运营)
- 孤儿图清理脚本 scripts/cleanup_orphan_file_assets.py(默认 --dry-run)

图片上传(协作台账截图用):OSS/本地双后端 + 缩略图变体 + /api/files 代理回读,
权限 file:upload / file:view。

验证:pytest 880 passed / 6 skipped;ruff format 全绿、ruff check 仅剩既有告警;
前端 tsc -b / eslint / vite build 通过;接口端到端冒烟 29 项全绿(TestClient,探针用假客户端);
探针真机冒烟 3 例(有效 CK=True、别人 uid=False、裸 cookie=False)。
2026-10-16 19:38:59 +08:00

93 lines
3.5 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""上传文件台账表 `file_assets`(在线协作的图片落库)。
协作里用户上传的图片本体放对象存储(ECS 与桶同地域时走内网 endpoint,
``oss-<region>-internal.aliyuncs.com``),库里只留 key 与元数据:
- 图片一律经 ``/api/files/object?key=...`` 由后端代理回读,**不下发 OSS 直链**。
参考 order_site 踩过的坑:曾经发过「15 分钟有效的签名链接」,结果入库时把当时的
链接原样存了下来,之后任何不重签的地方过一会儿必然裂图;
- ``object_key`` 里带 12 字节随机段(``scene/yyyy/mm/dd/<24位hex><ext>``),
不可枚举,所以普通链接就够用;
- ``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><ext>
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")