jackyu66gitandCursor
d33c8fdfe9
对齐 outlook/分享 type=star/报告页运势面板与测试；流程上关闭 Ops-B/C 两张 ECR。真支付仍后置。 Co-authored-by: Cursor <cursoragent@cursor.com>
77 lines
3.0 KiB
Markdown
77 lines
3.0 KiB
Markdown
# ECR-007
|
||
|
||
**Title:** 运营行为分析 Ops-B（自有埋点采集 · 管理端数据看板）
|
||
**Status:** Closed
|
||
**Date:** 2026-08-07
|
||
**Approved:** 2026-08-07（Human）
|
||
**Closed:** 2026-08-07（Reviewer · Approve + ess-validate review PASS）
|
||
**Change Level:** L2（新能力；栈与分层不变）
|
||
|
||
## Change
|
||
|
||
1. Active Feature Spec：`.ai/product/feature-spec/ops-analytics.md`（Ops-B）
|
||
2. 新增表 `analytics_sessions` / `analytics_events`（可选日汇总表）
|
||
3. User API：`POST /api/v1/analytics/events`（DeviceAuth，批量 ingest）
|
||
4. Admin API：`GET /api/v1/admin/analytics/*`（overview / pages / exits / clicks / funnel）
|
||
5. `user-h5`：扩展 `analytics.ts` — 会话、页停留、点击、退出页；可与 GA4 双写
|
||
6. `admin-h5`：侧栏「数据」看板（传统 App 运营看数）
|
||
|
||
## Motivation
|
||
|
||
当前埋点仅可选 GA4 + 漏斗事件，管理端无法看停留、退出页、点击排行；运维只能改库或外挂。需按传统 App 运营模式自有采集并在后台展示。
|
||
|
||
## Scope
|
||
|
||
### Allowed
|
||
|
||
- 上列 Spec / 表 / API / H5 SDK / admin「数据」页
|
||
- 修订 `ops-admin.md` / `feature-map.md` §7 写入 Ops-B
|
||
- OpenAPI 增补 analytics 路径
|
||
|
||
### Forbidden（Non-goals）
|
||
|
||
- Ops-C 内容 CMS · Ops-D 优惠券/退款工单 · Ops-E RBAC/封禁/推送（另开 ECR）
|
||
- UGC / 达人 / 真支付网关
|
||
- 热力图坐标、会话录像、实时毫秒大屏
|
||
- 新基础设施（Kafka/ClickHouse 等）— 首期 Postgres；量级不够不升级 L3
|
||
- 采集生日、问答正文、手机号等 PII
|
||
|
||
## Risk
|
||
|
||
| Risk | Mitigation |
|
||
|------|------------|
|
||
| 事件量表膨胀 | 批量 ingest + 日汇总表；索引按日；后续再议 OLAP（新 ECR/ADR） |
|
||
| 客户端丢数 | sendBeacon 退出冲刷；失败静默不挡 UX |
|
||
| 与 GA 双写不一致 | Spec 声明自有管道为运营真相源；GA 可选 |
|
||
| Admin 鉴权绕过 | 聚合 API 仅挂 AdminAuth |
|
||
|
||
## Acceptance Criteria
|
||
|
||
- [x] Spec `ops-analytics.md` §验收用例通过
|
||
- [x] Integration：H5 形态上报 → DB → admin analytics GET 非空且量级一致
|
||
- [x] `go test` 相关包绿；`npm run build:h5` · `build:admin` 绿
|
||
- [x] OpenAPI / TRACEABILITY / STATE / TEST_REPORT / CODE_REVIEW
|
||
- [x] `python3 scripts/ess-validate.py --phase review --ecr ECR-007`（Reviewer 门禁 PASS）
|
||
- [x] Docs + CHANGELOG
|
||
- [x] Reviewer Closed（STATE · TRACEABILITY）
|
||
|
||
## Rollback
|
||
|
||
- 去掉 analytics 路由注册；H5 关闭自有上报开关
|
||
- down migration 删 analytics 表（开发/可接受环境）
|
||
|
||
## Risk Review
|
||
|
||
- Path: N/A（非交易策略变更）
|
||
|
||
## Linked
|
||
|
||
- Feature Spec: `.ai/product/feature-spec/ops-analytics.md`
|
||
- PRODUCT_SPEC: `docs/PRODUCT_SPEC/ECR-007-ops-analytics.md`
|
||
- ENGINEERING_SPEC: `docs/ENGINEERING_SPEC/ECR-007-ops-analytics.md`
|
||
- BACKEND_DESIGN: `docs/BACKEND_DESIGN/ECR-007-ops-analytics.md`（BD-2026-007）
|
||
- HANDOFF / TASK / STATE：见同号前缀
|
||
- EXPERIMENT: N/A
|
||
- TRACEABILITY row: updated Yes（Approved）
|
||
- 后续分期：Ops-C/D/E 各开独立 ECR（见 PRODUCT_SPEC 附录）
|