发奖与数据导出模块

一、模块定位

发奖与数据导出模块负责活动奖品的发放管理。奖品按类型采用不同发放方式：实物奖品通过导出数据 + 人工发货；口算VIP月卡通过激活码分配 + 跳转兑换页由用户自主兑换；体验课由用户点击「立即领取」跳转自主兑换；冠军皮肤由后台手动发放。

关于活动整体背景和全局规则，请见 足球季活动全局。

---

二、功能需求清单

2.1 抽奖中奖数据导出

• 活动结束后，导出所有抽奖中奖用户数据（含虚拟权益奖品，用于审计追踪）
• 实物奖品导出字段：用户ID、实物奖品名称、收件人姓名、收件人电话、省名称、市名称、区名称、详细地址
• 虚拟权益奖品导出字段：用户ID、奖品类型、奖品名称、激活码（仅口算VIP月卡）、中奖时间
• 实物奖品中奖数据需单独标记，方便后续收集收货地址
• 虚拟权益奖品数据导出仅作审计用途，实际发放由用户自主领取完成（详见 2.5 虚拟权益领取）

2.2 冠军皮肤达标数据导出

• 活动结束后，根据冠军皮肤获取条件自动筛选达标用户
• 筛选条件：
  • 活动期间累计完课 > 10 节
  • 活动期间至少投票过一次冠军球队
• 导出达标用户清单，导出字段：用户ID、装扮（皮肤）ID
• 交由后端同事根据用户ID和装扮ID手动发放装扮

2.3 实物奖品收货信息管理

• 实物奖品（公仔挂件、叫叫金片）中奖用户需提供收货地址
• 叫叫金片为真金子制作的实物奖品，需按实物流程发货
• 收货信息收集方式：用户中奖后在前端活动页立即填写，或稍后从"我的奖品"补填/修改（活动结束前均可修改）
• 详见 收货地址模块
• 导出数据需包含：用户ID、实物奖品名称、收件人姓名、收件人电话、省名称、市名称、区名称、详细地址

2.4 装扮发放

• 装扮（冠军皮肤）发放不需要调用前端活动接口
• 由后端同事根据导出的达标用户数据，通过后台系统手动发放

2.5 虚拟权益领取

虚拟权益奖品采用用户自主领取方式，不通过后台手动发放。

叫叫口算VIP月卡（激活码模式）

• 系统预先在数据库中导入约 10 万个激活码
• 用户中奖后，系统从激活码池中分配一个未使用的激活码给该用户
• 前端自动将激活码复制到用户剪贴板，并提示"激活码已复制"
• 用户点击「立即领取」按钮，通过 Bridge openBrowser 在系统浏览器中打开兑换页面
• 用户在兑换页面粘贴激活码，自主完成兑换
• 激活码总量约 10 万，耗尽后该奖品自动不可中
• 兑换链接（固定）：https://act.cdssylkj.com/activeCode/index

体验课（跳转链接模式）

• 用户中奖后，在中奖弹窗或「我的奖品」页面看到「立即领取」按钮
• 点击后跳转到对应的领取页面，用户在目标页面自主完成兑换
• 领取链接由后台配置，运营可随时修改
• 本系统仅负责跳转，兑换流程由目标页面承接

奖品	领取链接	状态
体验课	待补充	待确认

详见 抽奖模块 2.4.1 节。

---

三、业务规则与约束

3.1 数据导出要求

数据类型	导出时机	导出字段
抽奖中奖记录（虚拟权益）	活动结束后	用户ID、奖品类型、奖品名称、激活码（仅口算VIP月卡）、中奖时间
实物中奖记录（公仔挂件、叫叫金片）	活动结束后	用户ID、实物奖品名称、收件人姓名、收件人电话、省名称、市名称、区名称、详细地址
冠军皮肤达标用户	活动结束 + 冠军确认后	用户ID、装扮（皮肤）ID

3.2 发奖流程

奖品类型	发奖方式	操作人
叫叫口算VIP月卡（虚拟）	激活码分配 + 自动复制 + 跳转兑换页，用户自主兑换	用户自主领取
体验课（虚拟）	用户点击「立即领取」跳转自主兑换	用户自主领取
叫叫金片（实物）	导出数据 → 人工发货	运营同事
实物公仔	导出数据 → 人工发货	运营同事
冠军皮肤装扮	后台手动发放	后端同事

3.3 前置条件

• 活动已正式结束
• 冠军球队已确认（皮肤发放依赖）
• 完课数据已最终确定（皮肤发放依赖）

3.4 边界场景

场景	处理方式
用户中奖实物但未提供收货地址	中奖时引导立即填写；未填则从"我的奖品"补填；活动结束前仍未填，运营主动联系
完课数据在活动刚结束时仍有延迟	等待数据稳定后再导出达标名单
导出数据量较大	支持批量导出，格式为可导入后台的标准文件
同一用户多次中实物奖	每人限中 1 个实物奖品
用户点击「立即领取」链接失效	口算VIP月卡链接固定，不会失效；体验课链接由后台配置，运营可快速更换；中奖记录保留，用户可从「我的奖品」重新领取
用户中奖后未点击领取	激活码和奖品记录始终保留在「我的奖品」中，活动结束前均可领取
激活码池耗尽	口算VIP月卡自动不可中，概率归入未中奖