"""add_user_daily_seen

Revision ID: k1l2m3n4o5p6
Revises: j1k2l3m4n5o6
Create Date: 2026-09-21

每日用户活动表（user_daily_seen）
--------------------------------
一天一人一行，记录当天首次 / 末次活动时刻，供日活报表计算
「上线时间 / 下线时间」。

为什么不复用 audit_logs：
  · 上线/下线时间不能取登录时间 —— Refresh Token 有效期 7 天，用户不必每天
    重新登录，「登录次数 0 却操作 35 次」的报表没有意义。
  · 也不能只取写操作时间 —— 审计中间件只记写操作，普通 GET 不入账，
    当天只翻看的人会被漏掉。
  · 更不能把活动写进审计表 —— 「末次活动」是需要不断 UPDATE 的状态，
    而审计流水必须只增不改；能改的审计记录等于没有审计价值。

存量数据无需回填：本表从上线时刻开始记录；日活接口对更早的日期会自动
回退到审计表的写操作时间去推算。
"""
from typing import Sequence, Union

import sqlalchemy as sa
from alembic import op

revision: str = "k1l2m3n4o5p6"
down_revision: Union[str, None] = "j1k2l3m4n5o6"
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None


def upgrade() -> None:
    op.create_table(
        "user_daily_seen",
        sa.Column("user_id", sa.String(64), primary_key=True,
                  comment="操作人账号(逻辑外键→MOM)"),
        sa.Column("day", sa.Date(), primary_key=True,
                  comment="北京时间自然日"),
        sa.Column("first_seen_at", sa.DateTime(timezone=True), nullable=False,
                  comment="当天首次活动时刻"),
        sa.Column("last_seen_at", sa.DateTime(timezone=True), nullable=False,
                  comment="当天末次活动时刻"),
    )
    # 日活查询按日期区间扫，给 day 单独建索引。
    # （主键是 (user_id, day)，前缀是 user_id，按 day 过滤用不上，故需补一条）
    op.create_index("ix_user_daily_seen_day", "user_daily_seen", ["day"])


def downgrade() -> None:
    op.drop_index("ix_user_daily_seen_day", table_name="user_daily_seen")
    op.drop_table("user_daily_seen")