Files
live-hub-py/web/backend/migrations/versions/20261003_0041_account_events.py
T
yml2213 98a9f0e0bc chore(merge): 账号事件迁移改号 0041,并去重排查报告
dev 与 main 从 294c6cd 分叉后,各自新增了一个 0040 迁移(都从 20261002_0039 起链):
- main:20261003_0040 douyu_tasks.account_assigned_to(生产已应用)
- dev: 20261002_0040 account_events(未上生产)

两者合并即两个 alembic head,upgrade head 会直接失败。因为账号事件迁移从未被生产库
应用过,改号是安全的:

1. account_events 迁移改名为 20261003_0041,down_revision 指向 20261003_0040;
2. tests/test_migrations.py 的 HEAD_REVISION 同步改 20261003_0041;
3. 迁移保持幂等,本机开发库(alembic_version 已是 20261003_0040、account_events 表已存在)
   实跑 upgrade 通过,仅推进版本号、数据未动;
4. 顺带修正规划/解耦设计里「下一个迁移编号」的过期取值(现为 20261003_0042)。

排查报告去重:两个会话各自写了一份《生产服务器高负载排查…》报告,内容重叠且互相矛盾
(一处写 8 核/16GB,另一处有 nproc 原始输出为 4 vCPU/7.1GiB)。合并为单一文档
docs/生产服务器高负载排查与优化报告.md,以带原始命令输出的事实为准,删除重复的那份,
并修正引用它的迁移方案文档。
2026-10-04 13:20:36 +08:00

118 lines
5.2 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.
"""账号事件流表,以及审计日志的账号关联列。
## 为什么需要 account_events
`accounts` 存的是**账号当前状态**(积分、余额、开通标记…),这些字段都是覆盖式更新 ——
「什么时候变成这样」没有任何记录。而账号相关的操作散在 `douyu_tasks`(22 万行 / 687MB,
掺着大量例行轮询),既不能直接给用户看,也不适合当历史长期保留。
于是把「发生过什么」独立成一张 append-only 的事件表:`accounts` 是状态,`account_events`
是流水。账号详情页 = 状态卡 + 事件时间线。
**不做历史回填**(2026-10-03 已定):事件从上线起往后累积,既有历史仍去各自的页面查。
## 为什么审计日志要加 account_id
实测 `audit_logs.target` 是自由文本(`冰柳192` / `导入103个` / `douyu_batch:xxx` 混着),
无法可靠关联到账号,导致「谁什么时候分配/改标签/删除了这个账号」进不了账号时间线。
加一列可空的 account_id,账号相关操作写入时带上即可(旧记录保持 NULL)。
## 编号为什么是 0041 而不是 0040
本迁移最初取号 `20261002_0040`(`down_revision` = `20261002_0039`)。开发期间生产上并发落地了
索引优化 `20261003_0040`,它同样从 `20261002_0039` 起链 —— 两边一合并就是**两个 alembic head**,
`upgrade head` 会直接报 `Multiple head revisions are present`。
因为本迁移**从未被生产库应用过**(`dev` 未部署),改号是安全的:接在 `20261003_0040` 之后成为
`20261003_0041`。升级脚本写成幂等的(`sa.inspect` 先查存在),所以对已手工建过表的本地库
重跑也只会空过并把版本号推进,不会重复建表。
"""
from collections.abc import Sequence
import sqlalchemy as sa
from alembic import op
revision: str = "20261003_0041"
down_revision: str | None = "20261003_0040"
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 _columns(bind, table: str) -> set[str]:
return {item["name"] for item in sa.inspect(bind).get_columns(table)}
def upgrade() -> None:
bind = op.get_bind()
if "account_events" not in _tables(bind):
op.create_table(
"account_events",
sa.Column("id", sa.BigInteger(), primary_key=True, autoincrement=True),
sa.Column(
"account_id",
sa.Integer(),
sa.ForeignKey("accounts.id"),
nullable=False,
),
# import / login_ok / ck_invalid / relogin_ok / relogin_failed /
# bind_ok / recharge / exchange / points_credit /
# elite_opened / esports_opened / assigned / tag_changed ...
sa.Column("event_type", sa.String(length=32), nullable=False),
sa.Column("occurred_at", sa.DateTime(), nullable=False),
# 直接可展示的一句话,避免前端再各自拼文案
sa.Column(
"title", sa.String(length=256), nullable=False, server_default=""
),
# 变动量(充值/消耗/到账,有符号)与变动后余额
sa.Column("amount", sa.Integer(), nullable=True),
sa.Column("balance_after", sa.Integer(), nullable=True),
# 精简细节(不是原始大 JSON),便于排障与以后扩展
sa.Column("detail", sa.JSON(), nullable=True),
# 来源:login / task / audit / manual
sa.Column(
"source", sa.String(length=24), nullable=False, server_default=""
),
# 幂等键:如 douyu_task:123456、login_task:14166、audit:789。
# 收集器重跑、事件重复发射都靠它兜住,漏了会造出重复时间线。
# **可空且唯一**:MySQL 的唯一索引允许多个 NULL,所以「没有幂等键」的事件
# (如手工记录)存 NULL;不能用空串 —— 空串会互相冲突,第二条就插不进去。
sa.Column("source_ref", sa.String(length=96), nullable=True),
sa.Column("created_at", sa.DateTime(), nullable=False),
)
op.create_index(
"ix_account_events_account_occurred",
"account_events",
["account_id", "occurred_at"],
)
op.create_index(
"ix_account_events_event_type", "account_events", ["event_type"]
)
op.create_index(
"ix_account_events_source_ref",
"account_events",
["source_ref"],
unique=True,
)
if "account_id" not in _columns(bind, "audit_logs"):
op.add_column(
"audit_logs",
sa.Column("account_id", sa.Integer(), nullable=True),
)
op.create_index("ix_audit_logs_account_id", "audit_logs", ["account_id"])
def downgrade() -> None:
bind = op.get_bind()
if "account_id" in _columns(bind, "audit_logs"):
op.drop_column("audit_logs", "account_id")
if "account_events" in _tables(bind):
# 删表会一并删掉索引
op.drop_table("account_events")