功能规范: 002 - 数据与分析

本文档定义了“蚊子”传播系统中与“数据与分析”相关的功能。

1. 用户故事与验收标准 (User Stories & Acceptance Criteria)

用户故事	验收标准	优先级
作为管理员，我希望在后台看到活动的核心数据仪表盘，以便实时监控活动健康度。	1. 仪表盘展示PV, UV, 参与人数, 新增注册数, K因子, CAC。 2. (澄清) 数据仪表盘提供时间范围选择器，支持“今天(默认)”、“昨天”、“过去7天”、“本月”、“上个月”以及自定义起止日期。 3. (澄清) 各指标定义清晰（详见下方澄清部分）。	高
作为管理员，我希望以网络图的形式查看用户裂变路径，以便快速定位关键传播节点（KOL）。	1. 图形化展示用户间的邀请关系。 2. 节点可点击，并显示该用户的关键信息（用户ID、昵称、直接邀请人数、总邀请人数、注册时间）。 3. (澄清) 默认只展示目标用户的前后各一层关系，提供点击扩展功能，最多可扩展5层。	高
作为管理员，我希望能看到一个按邀请数排序的“超级传播者”榜单，以便对他们进行额外奖励或运营。	1. 榜单展示用户昵称、头像、总邀请人数。 2. (澄清) 默认按“直接邀请人数”排序，但支持切换为按“总邀请人数”排序。 3. (澄清) 支持将当前榜单导出为CSV文件。 4. (澄清) 排名相同时，按先达到该数量的时间排序。	中

指标定义 (Metric Definitions):
- 参与人数: 成功分享了邀请链接的独立用户数。
- K-因子 (K-Factor): K = (总邀请转化数 / 总分享次数)。这是一个简化的K因子，V1.0阶段用于衡量分享内容的吸引力。
- CAC (用户获客成本): 总成本 / 新增用户数。在V1.0中，“总成本”仅计算“已发放的奖励总价值”。
网络图谱性能 (Graph Performance):
- 为保证性能，图谱默认只展示目标用户及与他直接关联的上下级。
- 用户每次点击图谱中的一个节点，会异步加载并展开该节点的下一层关系。
- 从初始节点开始，最多允许用户展开5层深的关系网络。
榜单规则 (Leaderboard Rules):
- 排序: 榜单提供一个下拉菜单或切换按钮，允许管理员在“按直接邀请数”和“按总邀请数”之间切换视图。
- 平分处理: 当排序依据的数值相同时，优先排名先达到该数值的用户。
- 导出: 导出功能将当前视图（排序和筛选结果）生成一个CSV文件。