digital-psychology/docs/ENGINEERING_SPEC/ECR-007-ops-analytics.md

ENGINEERING_SPEC — ECR-007 运营行为分析 Ops-B

权威设计：docs/BACKEND_DESIGN/ECR-007-ops-analytics.md
产品：.ai/product/feature-spec/ops-analytics.md · docs/PRODUCT_SPEC/ECR-007-ops-analytics.md

Implement order

1. Migration 000013_analytics_ops（sessions / events；可选 daily_page）+ ERD 同步
2. repository/analytics_repo.go（ingest + 聚合查询）
3. service/analytics（校验、截断 props、限流语义）
4. handler：POST /analytics/events 挂 既有 DeviceAuth gated group
5. service/admin + handler：GET /admin/analytics/{overview,pages,exits,clicks,funnel}
6. OpenAPI 增补
7. user-h5：lib/analytics.ts 队列 / session / dwell / click / beacon；关键控件 data-track
8. admin-h5：路由「数据」+ Dashboard 筛选与图表/表
9. 测试：repo/service 或 integration 上报→聚合；H5 analytics 单测
10. TRACEABILITY · STATE · CHANGELOG · feature-map §7

Constraints

• 函数 ≤50 行 · 文件 ≤400 行（超标先拆）
• UI → sdk 或既有 thin client → Handler → Service → Repository（禁止 Handler SQL）
• Admin 聚合不得走 DeviceAuth
• props 白名单键；禁止 PII
• 不提交 config.local.yaml / 密钥
• 不引入新中间件栈（无 Kafka）

Done when

ECR Acceptance 勾完 + .ai/definition-of-done.md Review Report + ess-validate（Approved 后门禁）