协作台账:新表 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)。
93 lines
3.5 KiB
Python
93 lines
3.5 KiB
Python
"""上传文件台账表 `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")
|