Files
wenzi/specs/002-data-analytics/spec.md

29 lines
2.8 KiB
Markdown
Raw Normal View History

# 功能规范: 002 - 数据与分析
本文档定义了“蚊子”传播系统中与“数据与分析”相关的功能。
## 1. 用户故事与验收标准 (User Stories & Acceptance Criteria)
| 用户故事 | 验收标准 | 优先级 |
| :--- | :--- | :--- |
| **作为管理员**,我希望在后台看到活动的核心数据仪表盘,以便实时监控活动健康度。 | 1. 仪表盘展示PV, UV, 参与人数, 新增注册数, K因子, CAC。<br>2. **(澄清)** 数据仪表盘提供时间范围选择器,支持“今天(默认)”、“昨天”、“过去7天”、“本月”、“上个月”以及自定义起止日期。<br>3. **(澄清)** 各指标定义清晰(详见下方澄清部分)。 | **高** |
| **作为管理员**我希望以网络图的形式查看用户裂变路径以便快速定位关键传播节点KOL。 | 1. 图形化展示用户间的邀请关系。<br>2. 节点可点击并显示该用户的关键信息用户ID、昵称、直接邀请人数、总邀请人数、注册时间。<br>3. **(澄清)** 默认只展示目标用户的前后各一层关系提供点击扩展功能最多可扩展5层。 | **高** |
| **作为管理员**,我希望能看到一个按邀请数排序的“超级传播者”榜单,以便对他们进行额外奖励或运营。 | 1. 榜单展示用户昵称、头像、总邀请人数。<br>2. **(澄清)** 默认按“直接邀请人数”排序,但支持切换为按“总邀请人数”排序。<br>3. **(澄清)** 支持将当前榜单导出为CSV文件。<br>4. **(澄清)** 排名相同时,按先达到该数量的时间排序。 | **中** |
## 2. 澄清与边缘场景 (Clarifications & Edge Cases)
- **指标定义 (Metric Definitions)**:
- **参与人数**: 成功分享了邀请链接的独立用户数。
- **K-因子 (K-Factor)**: `K = (总邀请转化数 / 总分享次数)`。这是一个简化的K因子V1.0阶段用于衡量分享内容的吸引力。
- **CAC (用户获客成本)**: `总成本 / 新增用户数`。在V1.0中,“总成本”仅计算“已发放的奖励总价值”。
- **网络图谱性能 (Graph Performance)**:
- 为保证性能,图谱默认只展示目标用户及与他直接关联的上下级。
- 用户每次点击图谱中的一个节点,会异步加载并展开该节点的下一层关系。
- 从初始节点开始最多允许用户展开5层深的关系网络。
- **榜单规则 (Leaderboard Rules)**:
- **排序**: 榜单提供一个下拉菜单或切换按钮,允许管理员在“按直接邀请数”和“按总邀请数”之间切换视图。
- **平分处理**: 当排序依据的数值相同时,优先排名先达到该数值的用户。
- **导出**: 导出功能将当前视图排序和筛选结果生成一个CSV文件。