guke
a86688ccfb
背景 / 目标 连续 15 天(北京自然日)没有「首页可见 / 发起比价 / 发起领券」行为的用户判定为流失,每日自动清零其金币 + 折算现金;清零前按可配置节奏预警;全程留审计。纯登录不算活跃;邀请奖励金物理隔离、不清(产品红线)。 改了什么 活跃口径共享模块 app/repositories/activity.py:worker(清零/预警)与 admin(最近活跃)单一真源,防漂移。 清零业务逻辑 inactivity.py:选取 / 逐用户清零(行锁 + 幂等)/ 预警分档 + streak 去重 / run_once 组合,预警故障逐用户隔离、绝不阻塞清零。 每日 worker inactivity_reset_worker.py(仿 daily_exchange:文件锁 + 北京日守卫 + RUN_HOUR 门槛 + 总闸)+ main.py lifespan 接线。 可插拔通知器 notifier.py(v1 LogNotifier 日志占位,预留 JPush/短信)。 配置 INACTIVITY_*(阈值 / 预警档 / 执行点 / 通道 / 开关)。 admin 最近活跃口径改用共享模块(移除 last_login_at、纳入 show/home、以 created_at 为基线)。 审计:inactivity_reset_log + inactivity_notification_log 两表 + 钱包流水双写(biz_type=inactivity_reset,ref_id 交叉)。 文档:设计 spec / 实现 plan / docs/database/ 两表字典。 关键产品决策 邀请金不清:只清金币 + 折算现金,invite_cash_balance_cents 原封(仅快照入审计)。 活跃口径 = max(created_at, 首页可见, 比价, 领券),不含 last_login_at;首页可见 = event=show + page=home。 时间边界:北京自然日 0 点对齐(见 activity.reset_cutoff)。 总闸默认关,灰度验证后再开。 数据库变更 新表:inactivity_reset_log、inactivity_notification_log。 analytics_event 新增复合覆盖索引 ix_analytics_event_active (event, page, user_id, created_at)(活跃口径聚合热点)。 修复了 base 上的迁移多头(135e79414fd0 与 phone_rebind_log 同从 comparison_llm_cost 分叉)→ 加空 merge 修订,alembic upgrade head 恢复单头正常。 ⚠️ 上线注意(合并后 / 开总闸前) INACTIVITY_RESET_ENABLED 默认 false;开启前提 = show/home 埋点全量铺满——否则"只登录不操作"且注册满 15 天的老用户会落到 created_at 基线被误清。 前端依赖:Android 端需在首页可见上报 event=show + page=home(携带登录后的 user_id)。 admin「最近活跃」口径变化(去登录、纳入 home_view、created_at 基线):属预期变化,需产品/运营知会;与 DAU(_period_active_user_ids,仍含登录)是两套指标。 清零对 C 端「金币流水」可见(biz_type=inactivity_reset,备注「15天不活跃清零」)。 灰度:先只看预警/清零名单对不对,再开总闸。 --------- Co-authored-by: guke <guke@autohome.com.cn> Reviewed-on: #143
67 lines
3.3 KiB
Python
67 lines
3.3 KiB
Python
"""新手引导(及后续)埋点事件表。
|
|
|
|
每行 = 客户端上报的一条行为埋点,按「Who / When / Where / What / How」五维组织:
|
|
- What :event(事件名,如 video_play)+ props(事件专属属性,JSON)
|
|
- Who :device_id(硬件级设备标识)+ user_id(登录后才有,可空)
|
|
- When :client_ts(端事件时间 epoch ms)+ session_id(本次引导会话)+ sent_at(端上报时间)
|
|
+ created_at(服务端接收时间 = server_at)
|
|
- Where:page(引导步/页面)+ client_ip(服务端从 X-Forwarded-For 取)
|
|
- How :oem / os / model / app_ver / network / channel(设备与环境)
|
|
|
|
append-only,不更新;客户端批量上报(见 app/api/v1/analytics.py),admin 同库直接查(见
|
|
app/admin/routers/event_logs.py)。未登录态也允许上报(user_id 为空),故 user_id 不设外键、只索引。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
|
|
from sqlalchemy import JSON, BigInteger, DateTime, Index, Integer, String, func
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
|
|
from app.db.base import Base
|
|
|
|
|
|
class AnalyticsEvent(Base):
|
|
__tablename__ = "analytics_event"
|
|
__table_args__ = (
|
|
# 活跃口径聚合热点(activity.active_event_condition + last_active_subqueries):
|
|
# 按 (event,page) 过滤 首页可见(show/home)∪比价∪领券,再 group by user_id 取
|
|
# max(created_at)。覆盖索引 → 该聚合走 index-only,避免高频 show 事件全表扫。
|
|
Index("ix_analytics_event_active", "event", "page", "user_id", "created_at"),
|
|
)
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
|
|
# ---- What:做了什么 ----
|
|
event: Mapped[str] = mapped_column(String(64), index=True, nullable=False)
|
|
props: Mapped[dict | None] = mapped_column(JSON, nullable=True)
|
|
|
|
# ---- Who:谁 ----
|
|
device_id: Mapped[str] = mapped_column(String(64), index=True, nullable=False)
|
|
user_id: Mapped[int | None] = mapped_column(Integer, index=True, nullable=True)
|
|
|
|
# ---- When:何时 ----
|
|
session_id: Mapped[str | None] = mapped_column(String(64), index=True, nullable=True)
|
|
client_ts: Mapped[int] = mapped_column(BigInteger, nullable=False) # 端事件时间 epoch ms
|
|
sent_at: Mapped[int | None] = mapped_column(BigInteger, nullable=True) # 端上报时间 epoch ms
|
|
|
|
# ---- Where:何地 ----
|
|
page: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
|
client_ip: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
|
|
|
# ---- How:用什么环境 ----
|
|
oem: Mapped[str | None] = mapped_column(String(32), nullable=True)
|
|
os: Mapped[str | None] = mapped_column(String(32), nullable=True)
|
|
model: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
|
app_ver: Mapped[str | None] = mapped_column(String(32), nullable=True)
|
|
network: Mapped[str | None] = mapped_column(String(16), nullable=True)
|
|
channel: Mapped[str | None] = mapped_column(String(32), nullable=True)
|
|
|
|
# 服务端接收时间(= When.server_at);客户端时间不可信,以此为权威落库时刻。
|
|
created_at: Mapped[datetime] = mapped_column(
|
|
DateTime(timezone=True), server_default=func.now(), index=True, nullable=False
|
|
)
|
|
|
|
def __repr__(self) -> str: # pragma: no cover
|
|
return f"<AnalyticsEvent id={self.id} event={self.event} device={self.device_id}>"
|