Skip to content

feat: 接入 Umami 产品埋点 - #170

Merged
makewheels merged 1 commit into
masterfrom
feat-umami-analytics
Aug 23, 2026
Merged

makewheels merged 1 commit into
masterfrom
feat-umami-analytics

Conversation

@makewheels

Copy link
Copy Markdown
Owner

范围

按用户拍板的「Umami 轻量统计」落地产品埋点。服务端已部署(umami.a4.fit,独立 postgres,凭据已轮换并登记 infra),本 PR 只做前端接入与文档。

前端

  • web/src/lib/analytics.js:仅 import.meta.env.PROD 注入 https://umami.a4.fit/script.js;track() 在脚本未加载时静默无操作
  • 事件(字典见 docs/业务/数据埋点.md):pageview 自动 + practice_recording_started / practice_result / result_shared / gap_saved / note_added / followup_asked
  • 属性仅标量(mode/score/gaps 数/round/method)+ 不透明内部 userId;不上传手机号、转写、笔记正文、AI 答案

隐私

无 cookie、不开回放、不请求地理位置;dev 环境完全不打点(dev/prod 数据隔离)。

验证

  • 28 个测试文件 288 项测试通过(含 analytics 单测 3 项);lint 0 error(23 既有 warning);build 通过
  • 上线后验收:生产页加载 script.js 200,umami 后台可见 pageview 与业务事件

@makewheels
makewheels merged commit 5486cc7 into master Aug 23, 2026
3 checks passed
@makewheels
makewheels deleted the feat-umami-analytics branch August 23, 2026 14:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant