docs(welfare): 15天不活跃清零金币/现金设计文档(spec) #151

2026-07-21T13:52:31+08:00

guke commented

2026-07-21 13:52:31 +08:00

对齐前端首页可见事件home_visible

guke added 25 commits 2026-07-21 13:52:32 +08:00

docs(welfare): 15天不活跃清零金币/现金设计文档(spec) 5f1d1a5e5f

连续15天不活跃自动清零金币+折算现金+邀请现金,清零前可配置节奏预警,全程留审计以备纠纷排查。

关键决策:
- 活跃口径复用"用户管理"并抽共享模块 activity.py(admin 一并重构);新增 home_view 埋点代表"进首页",last_login_at 仅作灰度期兜底
- 审计双写:inactivity_reset_log 专表(记清零前三桶余额)+ 钱包流水 biz_type=inactivity_reset
- 预警:可插拔通知器 + 日志占位(v1),后续接 JPush/短信
- 触发:进程内每日 worker(仿 daily_exchange_worker),总闸默认关

仅设计文档,尚未实现。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(welfare): 明确不活跃清零的时间边界(北京自然日, 第16日0点) c9c35a4350

补充清零日界定义:末次活跃日记为第1日,从末次活跃起「第16日0点」(北京)清零
= 北京 00:00 of (last_active_date + 15天),按自然日 0 点对齐,非从末次活跃时刻滚动 15×24h。
- 应清零 ⟺ (cn_today() − last_active_date).days ≥ RESET_DAYS
- SQL cutoff = 北京 00:00 of (cn_today() − (RESET_DAYS−1)),新增 activity.reset_cutoff() 辅助
- 资格边界(第16日0点)与 worker 执行点 RUN_HOUR 解耦;inactive_days 改按北京自然日
- 同步更新 §4/§6/§8/§10

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(welfare): 活跃口径移除 last_login_at 改用 created_at 基线;home_view 事件名待定 b3ed66d4eb

按评审结论定稿:
- ① 彻底移除 last_login_at:活跃口径 = max(home_view, 比价, 领券);登录/re-login 不再计为活跃
- 连带:用 User.created_at 接替"恒非空基线"位(注册即第1日活跃,只有真实使用才推进)。
  无任何信号的用户 = 注册满 15 天即清,新用户有 15 天宽限
- ② home_view 事件名待前端明天加埋点时定,后端以 HOME_VIEW_EVENT 常量占位
- 连带影响:共享口径 admin 侧同步(移除 last_login_at + created_at 基线 + 纳入 home_view),
  admin 最近活跃/DAU 口径随之变化,回归测试按新口径更新预期
- 同步 §3/§4/§9/§10/§11/§12/§13/§14

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(welfare): 15天不活跃清零实现计划(11 任务, TDD 分解) 23e4671312

从已定稿 spec 拆出可执行计划:模型/迁移/活跃口径共享模块/配置/通知器/清零+预警业务逻辑/
每日 worker/admin 重构/表字典。每任务含失败测试→实现→通过→提交的 bite-sized 步骤,含完整代码。
活跃口径 = created_at 基线 + home_view/比价/领券(不含 last_login_at);home_view 事件名以
HOME_VIEW_EVENT 常量占位(前端明天定名);总闸默认关。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

feat(welfare): inactivity_reset_log + inactivity_notification_log 模型 0ec6b2bc56

feat(welfare): 迁移新增 inactivity_reset_log / inactivity_notification_log 两表 708e454959

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(welfare): 活跃口径共享模块-常量与北京0点cutoff助手 e6f467a935

feat(welfare): 活跃口径共享模块-子查询与 last_active_expr 108c175142

feat(welfare): INACTIVITY_* 配置项 + warn stages 解析 f843e68d0f

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(welfare): 可插拔不活跃预警通知器 + LogNotifier 占位 7802aeb163

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(welfare): 不活跃清零-选取与逐用户清零(三桶归零+审计+流水) a6cfef64a8

test(welfare): 不活跃测试加 autouse 隔离夹具(清零余额+清活跃事件/审计),去掉临时 band-aid eb15018322

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

feat(welfare): 完成不活跃清零-邀请金不清 + 预警编排 + worker + admin口径统一 40c99afd92

- 清零改两桶(金币 + 折算现金);邀请奖励金物理隔离、不清(产品红线),仅快照入审计
- 预警编排 select_warn_candidates / run_warn_once / run_once(分档 + streak 去重);
  notifier.warn 去掉 invite 参数(邀请金不清、不预警)
- 预警逐用户 try/except 隔离 + run_once 保证预警故障绝不阻塞清零(接真推送前必备)
- 每日 worker inactivity_reset_worker(文件锁 + 北京日守卫 + RUN_HOUR 门槛 + 总闸默认关)
  + main.py lifespan 接线
- admin 最近活跃口径改用共享 activity(移除 last_login_at、纳入 home_view 占位)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(welfare): 不活跃清零设计/计划对齐"邀请金不清" + inactivity 两表字典 ece498876f

- spec/plan:清零范围改两桶、run_warn 逐用户隔离不阻塞清零、stats 增 warn_failed
- docs/database:新增 inactivity_reset_log / inactivity_notification_log 条目 + README 索引

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

chore(scripts): 不活跃清零人工验证造号脚本(排列组合 + 审计核对) aeaf4b1fd1

按金币/现金/邀请排列组合 + 活跃/新用户对照造号;--check 核对 worker 清零/预警结果、
--clean 清理。仅本地验证用,不参与生产逻辑。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Merge branch 'main' of https://gitea.shaguabijia.com/WonderableAI/shaguabijia-app-server into feat/inactivity-reset 69a79f9852

feat(welfare): 首页可见活跃信号定名 event=show + page=home(替换 home_view 占位) b4fe20aaca

前端确定"首页可见"埋点为 event=show + page=home(组合,非单一 event 名),故活跃口径
不能只改一个常量:

- activity.active_event_condition():首页可见(event=show & page=home)∪ 比价 ∪ 领券,
  worker 子查询(last_active_subqueries)与 admin _attach_last_active 共用(单一真源);
  ACTIVE_EVENTS 收窄为仅两个纯 event 名,HOME_VIEW_EVENT="show" + 新增 HOME_VIEW_PAGE="home"
- 测试:新增 show/home 算活跃、show/其他页不算的用例;_add_event 支持 page;口径常量断言更新
- seed 脚本 / spec / plan 同步 home_view → show+page=home

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

perf(analytics): analytics_event 活跃口径复合索引 (event,page,user_id,created_at) fd1c1a5abc

active_event_condition 按 (event=show & page=home) ∪ 比价 ∪ 领券 过滤后 group by user_id、
max(created_at),是 worker 清零/预警 + admin 最近活跃的热点聚合;page 原无索引、show 又高频。
加覆盖索引 ix_analytics_event_active 让该聚合走 index-only。

⚠️ 分支迁移树既有多头(135e79414fd0 与 phone_rebind_log 同从 comparison_llm_cost 分叉,
`alembic upgrade head` 会多头报错)——既有问题、与本次无关。本迁移挂在 135e79414fd0 一侧,
dev 用 `alembic upgrade analytics_active_idx` 应用;集成 main 时需 alembic merge 合并 phone_rebind_log 头。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

chore(alembic): 合并 analytics_active_idx + phone_rebind_log 两 head(修复多头) 5fdf2b1ad3

既有多头——135e79414fd0(不活跃两表)与 phone_rebind_log 同从 comparison_llm_cost 分叉——
导致 `alembic upgrade head` 多头报错。加一个空 merge 修订汇合两头,upgrade head 恢复单头正常。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(welfare): 不活跃清零 worker 常驻 + 默认 dry-run(ENABLED=false 只记审计不清) 0cc2e9dec8

改 INACTIVITY_RESET_ENABLED 语义:worker 不再"关=不启动"、改为**常驻**;ENABLED 只控是否**真清**——
false(默认)= 只写审计名单(reason=inactive_Nd_dryrun)、不动钱不写流水、不预警(dry-run 灰度看名单);
true = 真清金币+现金 + 预警。

- clear_user(dry_run):写审计跳出账,按 streak 去重(reset_at>last_active)不重复记
- run_reset_once/run_once:透传 dry_run;dry-run 抑制预警(不通知一个不会发生的清零)
- worker:start 常驻(去掉 ENABLED 启动闸);_run_once_entry dry_run=not ENABLED;启动日志标 mode
- 测试:dry-run 只记审计/不清/不预警/dedup + worker ENABLED=false→dry-run;去掉过时 disabled 用例
- config/worker 注释 + spec §6/§13/误清防护 同步新语义

测试安全:lifespan 在测试里不跑(TestClient 非 with 形式),worker 常驻不影响用例。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Merge branch 'main' into feat/inactivity-reset 16414f1744

main 已通过 #143 合入本功能的早期版本;拉 main 时功能文件(config / worker / inactivity /
tests / spec)冲突,一律以本分支为准(含 home_view→show+page=home、活跃口径复合索引、
迁移多头 merge、worker 常驻 + 默认 dry-run 等最新改动)。无关代码走 main 的自动合并。
alembic 单头、全量测试无新增失败。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(welfare): 确认首页可见事件名 home_visible + 修测试手机号跨文件冲突 927f1f92f8

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

fix(welfare): 不活跃验证脚本首页可见事件 show+home → home_visible 9b6a4d83b6

seed_inactivity_cases.py 仍发 event=show + page=home,改名 home_visible 后
active_event_condition 不再认它,"活跃兜底"用例会被误清/误警。改用共享常量
activity.HOME_VISIBLE_EVENT(单一 event 名,去掉 page),防止再次漂移。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(welfare): 同步 home_visible 事件名到 spec + 索引注释/docstring 41f882098c

- spec:活跃口径/§11 前端依赖等处 show+page=home、home_view 占位统一改 home_visible;
  修正 ACTIVE_EVENTS 说明(home_visible 是纯 event 名、已收进 ACTIVE_EVENTS)。
- analytics_event 索引注释 + 迁移 docstring:改单一 event=home_visible 过滤;
  注明 page 列是 show+home 组合遗留、现冗余(索引靠 event 前缀仍生效),可后续瘦成
  (event,user_id,created_at)。保留一句历史说明。纯注释/文档,无行为变更。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Merge branch 'main' of https://gitea.shaguabijia.com/WonderableAI/shaguabijia-app-server into feat/inactivity-reset eb8641b551

# Conflicts:
#	docs/superpowers/specs/2026-07-16-inactivity-reset-design.md

guke merged commit f39467ec08 into main

2026-07-21 13:52:42 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: WonderableAI/shaguabijia-app-server#151

docs(welfare): 15天不活跃清零金币/现金 设计文档(spec) #151

docs(welfare): 15天不活跃清零金币/现金设计文档(spec) #151