Table of Contents
1.1 偶像统计与资金文案整理稿
本节统一整理偶像端数据统计、粉丝端糖果流水和偶像端收益明细的页面口径及展示文案。以下内容以当前接口实现、统计 Service 和资金流水写入逻辑为准，供 APP 产品、设计和前端联调使用。
1.1.1 统一统计规则
- 统计接口不传
start_date、end_date时统计全部历史数据。 - 传日期时，
start_date和end_date必须同时传入，按Asia/Shanghai统计开始日00:00:00至结束日23:59:59。 -
end_date不能晚于当天，start_date不能晚于end_date。 - 所有 rate 对象统一返回
value、numerator、denominator；value保留两位小数，页面展示时在后面拼接%。 - 比例分母为
0时返回0.00%，同时分子和分母均返回0。 - 人民币金额统一返回元字符串并固定两位小数；糖果数量属于业务数量，不使用人民币金额文案。
- 统计接口使用约 30 秒 Redis 短缓存，数据发生真实变化后会切换缓存版本，页面允许存在短暂延迟。
1.1.2 偶像计总文案与口径
接口：GET /tieup/api/v1/artist/summary
| 页面文案 | 统计口径 |
|---|---|
| 群消息未读 | 当前偶像超级群中粉丝发送且未读的有效定向消息；不统计订阅业务系统消息 |
| 待回答提问 | 每条提问/追问会话链只统计最新节点，最新节点为待回答 |
| 已回答提问 | 每条提问/追问会话链只统计最新节点，最新节点为已回答 |
| 提问收入 | 已回答提问和追问产生的糖果收入 |
| 待通话 | 视频预约状态 1/2/3，即待通话、等待进入、通话中 |
| 已完成/已结束通话 | 视频预约状态 4/5/6/7/8，包含完成、爽约、取消等结束记录 |
| 视频通话收入 | 正常完成状态 4，以及粉丝爽约、偶像已进入且不退款的状态 6；偶像爽约和双方爽约不计入 |
| 系统消息未读 | 当前偶像全部未读系统消息，不限制 business_type |
1.1.3 偶像统计总览
接口：GET /tieup/api/v1/artist/dashboard/overview
订阅统计
| 页面文案 | 统计口径 |
|---|---|
| 新增订阅 | 当前时间范围内支付成功并生成的订阅记录数，不按 fan_user_id 去重；等于月卡记录数加年卡记录数 |
| 退订 | 当前时间范围内发生的退订事件数；自动续费到期、普通订阅到期和后台取消均计入，同一订阅记录只计一次 |
| 续订 | 当前时间范围内的续订记录数；同一粉丝同一艺人只要此前存在订阅记录，再次订阅即计为续订 |
| 当前订阅人数 | 当前时刻仍生效中的订阅粉丝数，按 fan_user_id 去重，不随日期筛选改变 |
| 续订率 | 当前范围续订记录数 ÷ 当前范围全部订阅记录数 |
| 留存率 | 当前有效订阅粉丝数 ÷ 历史订阅粉丝数 |
注意：续订率的分子、分母均按订阅记录统计，不能改为粉丝去重数；留存率才按有效订阅粉丝和历史订阅粉丝统计。
消息互动统计
| 页面文案 | 统计口径 |
|---|---|
| 连续群发天数 | 偶像连续发送全群普通群发消息的天数；同一天多条只计算一天，从统计范围内最后发送日向前连续计算 |
| 发送消息 | 偶像发送成功或发送后撤回的消息数，包含单聊回复、群发、广播等偶像侧记录 |
| 回复消息 | 偶像引用回复粉丝消息的数量 |
| 粉丝回复率 | 被偶像引用回复的粉丝原消息数 ÷ 粉丝发送消息数；按原消息编号去重，引用回复发生在范围外仍计入 |
| 已读率 | 已读消息数 ÷ 应读消息数；单聊按消息数统计，群发按目标人数和已读人数统计 |
| 回复率 | 偶像回复粉丝消息数 ÷ 粉丝发给偶像的消息数 |
收入构成统计
| 页面文案 | 统计口径 |
|---|---|
| 订阅收入人数 | 当前范围订阅收入涉及的粉丝数，按粉丝去重 |
| 订阅收入 | 当前范围有效订阅收入金额 |
| 提问收入笔数 | 当前范围提问和追问收入记录数 |
| 提问收入 | 当前范围提问和追问收入金额 |
| 视频通话笔数 | 当前范围视频通话收入记录数 |
| 视频通话收入 | 当前范围视频通话收入金额 |
收入构成排除 settlement_status = 3（已退款扣回）和 settlement_status = 4（已取消）的收入记录；金额字段均按元字符串返回。
其他总览统计
| 页面文案 | 统计口径 |
|---|---|
| 提问数量 | 当前范围提交的提问和追问数量 |
| 视频通话预约数量 | 当前范围创建的视频通话预约数量 |
| 待回答提问 | 当前待回答提问数量 |
| 待发放福利 | 当前待偶像发放的福利数量 |
| 未读消息 | 偶像端未读定向消息数量 |
| 今日提问 | 今日提交的提问数量 |
| 今日视频预约 | 今日创建的视频通话预约数量 |
1.1.4 偶像粉丝统计
接口：GET /tieup/api/v1/artist/dashboard/fans
订阅概览和留存指标
| 页面文案 | 统计口径 |
|---|---|
| 当前订阅人数 | 当前时刻仍生效中的订阅粉丝去重数，不随日期筛选改变 |
| 新增 | 当前范围支付成功并生成的订阅记录数，不按 fan_user_id 去重；等于月卡记录数加年卡记录数 |
| 月卡 | 当前范围新增月卡订阅记录数；字段名为兼容历史客户端保留 |
| 年卡 | 当前范围新增年卡订阅记录数；字段名为兼容历史客户端保留 |
| 续订率 | 当前范围续订记录数 ÷ 当前范围订阅记录数 |
| 留存率 | 当前有效订阅粉丝数 ÷ 历史订阅粉丝数 |
消息互动指标
| 页面文案 | 统计口径 |
|---|---|
| 已读率 | 已读消息数 ÷ 应读消息数 |
| 回复率 | 偶像回复粉丝消息数 ÷ 粉丝发给偶像的消息数 |
| 互动率 | 有互动的粉丝数 ÷ 当前有效订阅粉丝数；无有效订阅粉丝时，分母回退为历史订阅粉丝数 |
| 发送消息 | 当前范围偶像发送成功消息数 |
| 回复消息 | 当前范围偶像回复粉丝消息数 |
| 新增提问 | 当前范围新增提问数 |
| 新增视频通话 | 当前范围新增视频通话预约数 |
| 未回复提问 | 当前范围待回答提问数 |
| 平均回复时长 | 当前范围偶像回复粉丝消息的平均耗时，单位为秒 |
1.1.5 偶像收入统计和榜单
收入统计接口：GET /tieup/api/v1/artist/dashboard/income
| 页面文案 | 统计口径 |
|---|---|
| 可提现余额 | 当前偶像可申请提现的余额，不随日期筛选改变 |
| 订阅收入人数 | 当前范围订阅收入粉丝去重数 |
| 订阅收入 | 当前范围订阅收入金额 |
| 提问收入笔数 | 当前范围提问和追问收入笔数 |
| 提问收入 | 当前范围提问和追问收入金额 |
| 视频通话笔数 | 当前范围视频通话收入笔数 |
| 视频通话收入 | 当前范围视频通话收入金额 |
| 总收益 | 当前范围内有效收入记录的偶像收益合计 |
榜单接口：GET /tieup/api/v1/artist/dashboard/rankings
| 榜单 | 页面文案 | 统计口径 |
|---|---|---|
loyal_fans |
铁粉榜 / 陪伴天数 | 按上海时区累计粉丝对当前艺人的有效订阅自然日；状态 1=生效中、2=已过期计入，状态 3=已取消不计入，订阅当天立即计为第 1 天，重叠自然日不重复累计 |
consumption |
消费榜 / 累计消费糖果 | 汇总提问、视频通话、福利兑换的历史有效糖果消费；退款、退款中和取消业务不计入 |
1.1.6 粉丝端糖果流水文案
接口：GET /tieup/api/v1/me/candy-transactions
页面基础文案建议：
| 字段 | 页面文案 |
|---|---|
| 页面标题 | 糖果流水 |
candy_balance |
糖果余额 |
change_amount |
变动糖果 |
balance_before |
变动前余额 |
balance_after |
变动后余额 |
created_at |
发生时间 |
transaction_no |
流水号 |
流水类型和实际记录文案：
change_type |
类型文案 | 当前实际记录文案或建议文案 |
|---|---|---|
1 |
糖果充值 | 糖果充值到账 |
2 |
消费 | 付费提问扣糖果、追问扣糖果、视频通话预约扣糖果 |
3 |
退款 | 提问拒绝退款、追问拒绝退款、与“偶像名称”的视频通话（偶像爽约退款）、与“偶像名称”的视频通话（双方爽约退款） |
4 |
系统赠送 | 建议展示为 系统赠送糖果 |
5 |
系统扣减 | Apple 充值退款时为 Apple IAP充值退款系统扣减 |
6 |
活动奖励 | 建议展示为 活动奖励糖果 |
7 |
其他 | 建议展示为 其他糖果变动 |
业务类型文案：
business_type |
页面文案 |
|---|---|
candy_recharge |
糖果充值 |
question |
付费提问 |
follow_up_question |
追问 |
video_call |
视频通话 |
benefit |
福利兑换 |
adjust |
系统调整 |
展示规则：
-
change_amount为正数时显示+330.00 糖果。 -
change_amount为负数时显示-20.00 糖果。 - 糖果数量不得标注为“元”，也不得套用人民币金额字段规则。
- 当前福利兑换代码明确为不扣糖果，因此福利兑换不会生成糖果消费流水。
1.1.7 偶像收益明细文案
接口：
-
GET /tieup/api/v1/artist/income-records -
GET /tieup/api/v1/artist/income-records/{income_id}
页面基础文案建议：
| 字段 | 页面文案 |
|---|---|
| 页面标题 | 收益明细 |
total_income_amount |
筛选范围总收益 |
artist_income_amount |
偶像收益 |
fan_nickname |
粉丝 |
business_type |
收益来源 |
created_at |
产生时间 |
settlement_status |
结算状态 |
income_no |
收益单号 |
order_no |
订单号 |
收益业务类型和列表描述：
business_type |
页面文案 | 推荐列表描述 |
|---|---|---|
subscription |
订阅收益 | 「粉丝昵称」订阅了您 |
question |
提问收益 | 您回答了「粉丝昵称」的提问或追问 |
follow_up_question |
追问收益 | 您回答了「粉丝昵称」的追问 |
video_call |
视频通话收益 | 您与「粉丝昵称」完成了视频通话 |
benefit |
福利收益 | 粉丝兑换了福利 |
粉丝昵称为空时统一显示“粉丝”。收益记录本身没有统一 remark 字段，前端应按 business_type、粉丝昵称和金额组合生成列表文案。
金额字段文案：
| 字段 | 页面文案 | 说明 |
|---|---|---|
total_amount |
用户支付金额 | 用户实付或业务折现金额 |
settlement_base_amount |
收益结算基数 | 用于计算偶像分成的金额 |
artist_income_amount |
偶像收益 | 偶像实际获得的收益 |
platform_fee_amount |
平台服务费 | 总金额减去偶像收益 |
share_ratio |
偶像分成比例 | 例如 70.00% |
total_income_amount |
总收益 | 当前筛选范围内偶像收益合计 |
withdrawable_amount |
可提现余额 | 当前可申请提现的余额 |
结算状态文案：
settlement_status |
页面文案 | 推荐说明 |
|---|---|---|
1 |
待结算 | 收益已生成，暂未进入可提现余额 |
2 |
已入账 | 收益已进入可提现余额或已完成入账 |
3 |
已退款扣回 | 原收益因退款被扣回 |
4 |
已取消 | 收益记录已取消，不计入有效收益 |
视频通话特殊字段：
-
actual_duration_seconds页面文案为“实际通话时长”。 -
0秒显示为0秒。 -
100秒显示为1分钟40秒。 - 超过 1 小时按
X小时X分钟X秒展示。 -
fan_no_show仅视频通话收入返回：1表示粉丝爽约，2表示粉丝未爽约；预约状态6=粉丝爽约或7=双方爽约时返回1。
收益计算说明：
- 默认偶像分成比例为
70.00%。 - 普通订阅的结算基数通常等于实付金额。
- iOS 订阅按购买时普通月费或年费价格快照计算偶像收益。
- 提问、追问、视频通话等糖果业务完成后，按糖果现金折算比例生成人民币收益。
- 收益统计排除退款和取消状态的收入记录。
- 个人偶像收入进入可提现余额；经纪公司偶像收入进入待结算流程。
本节仅作为 APP 展示口径和联调文案整理，不新增接口、不修改表结构、不改变已有业务逻辑；后续如需调整实际流水 remark，必须同步修改对应 Service 和本节文档。
接口测试状态摘要：
| 项目 | 结果 |
|---|---|
| 测试日期 | 2026-06-23 |
| 用户端路由 | 117 |
| 已安全探测 | 108/117 |
| 未直接调用 | 9/117 |
| 已知异常 | 无稳定异常 |
| 测试边界 | 本轮未造业务数据、未触发三方回调，不代表完整业务链路验收 |
接口进度状态：
| 状态 | 说明 |
|---|---|
待开发 |
接口或功能已定义，后端尚未确认完成 |
已开发 |
后端接口已实现并可自测 |
已开发，待测试 |
后端接口已实现并完成基础检查，等待联调或业务场景测试 |
基础探测通过，待数据联调 |
本轮已完成只读或低副作用 HTTP 探测，仍需真实数据和业务场景联调 |
未授权拦截通过，待登录态联调 |
本轮已验证未登录请求被认证中间件拦截，仍需登录态业务联调 |
参数校验通过，待业务联调 |
本轮已验证空参数请求被 FormRequest 或参数校验拦截，仍需有效参数业务联调 |
基础探测异常 |
本轮基础探测发现稳定异常，需修复后复测 |
未执行，需三方/真实联调 |
当前接口会触发外部依赖、回调日志或业务写入，需隔离测试数据或三方沙盒后执行 |
已对接 |
前端已完成联调并确认可用 |