一、模块定位
管理端是足球季活动的运营与发奖工作台，面向运营、研发和授权测试人员使用。管理端需要支撑活动上线前检查、活动期间数据查看与奖品运营、活动结束后的冠军配置和发奖导出，确保前台活动、奖品库存、虚拟权益和人工发奖流程可被追踪和验收。
关于活动整体背景和全局规则，请见 足球季活动全局。
二、使用角色与权限要求
| 角色 | 主要诉求 | 权限要求 |
|---|
| 运营人员 | 查看活动数据、配置活动信息、导入权益码、导出发奖数据 | 可查看数据，可执行授权范围内的配置和导出操作 |
| 研发人员 | 联调、排查问题、检查上线准备状态 | 可查看配置、日志、检查结果和必要的诊断信息 |
| 测试人员 | 验证 FAT 和生产预上线流程 | 可登录指定环境，按授权执行只读检查或受控写入验证 |
- 管理端必须有登录鉴权，未登录用户不可查看或操作活动数据。
- 管理端需清晰展示当前数据环境，避免 FAT 和 PROD 混淆。
- 涉及生产环境写入、上传、导入和导出的操作，必须由授权人员执行。
- 管理端不得在页面中展示真实密码、密钥或长期可复用的敏感凭证。
三、功能需求清单
3.1 登录与环境识别
- 用户进入管理端时，如未登录，需先完成后台登录。
- 登录失败时需给出明确错误提示，不进入管理端页面。
- 登录成功后展示当前账号、当前环境和可操作的活动。
- 管理端需支持 FAT 与 PROD 环境识别；当存在环境切换能力时，切换控件必须明显展示当前环境。
- 生产环境写操作需有更强提示，避免误把测试操作保存到生产数据。
3.2 活动概览
- 管理端首页需展示活动核心概览，方便运营快速判断活动运行情况。
- 概览信息至少包括：
- 活动状态
- 总投票人次或参与人数
- 抽奖发放概况
- 实物奖品库存和已中奖数量
- 虚拟权益码池可用情况
- 关键上线检查状态
- 概览数据需能刷新，避免运营基于过期数据判断。
- 数据为空时需展示可理解的空状态，而不是报错或空白页。
3.3 投票数据查询
- 管理端需支持查看用户投票记录。
- 投票记录需能帮助运营核对用户是否参与、投给哪支球队、何时投票。
- 投票列表需支持分页或等价的分批查看能力，避免数据量变大后无法使用。
- 若活动期间出现用户争议，运营可通过投票记录辅助核对用户参与情况。
3.4 中奖记录查询
- 管理端需支持查看抽奖中奖记录。
- 中奖记录需区分实物奖品、虚拟权益奖品和未中奖记录是否展示的口径。
- 对实物奖品，管理端需展示奖品名称、中奖用户、中奖时间和地址填写状态。
- 对虚拟权益奖品，管理端需展示奖品名称、中奖用户、中奖时间、领取状态和必要的权益码信息。
- 中奖记录需支持按奖品类型或发奖类型筛选，方便运营核对实物发货和虚拟权益审计。
3.5 收货地址查询
- 管理端需支持查看实物奖品中奖用户填写的收货地址。
- 地址信息需包含发货所需字段：用户ID、奖品名称、收件人姓名、收件人电话、省名称、市名称、区名称、详细地址。
- 地址未填写时需明确展示未填写状态，方便运营后续联系用户。
- 活动结束后，运营需能区分地址已填写、未填写、需人工联系的用户。
3.6 奖品库存配置
- 管理端需支持查看奖品库存总量、已中奖数量和剩余数量。
- 实物奖品库存、抽奖节奏和概率参数需支持运营或研发在授权范围内调整。
- 可配置字段至少包括：
- 公仔总量、金片总量。
- 基准抽奖量。
- 公仔每日上限、金片每日上限。
- 公仔最后一天保留量、金片最后一天保留量。
- 实物奖释放使用率、单类实物奖概率上限、公仔/金片权重。
- VIP 概率、体验课概率、体验课领取链接。
- 参数调整需满足以下约束：
- 调整后的总量不得小于已中奖数量。
- 每日上限必须大于 0。
- 最后一天保留量必须大于等于 0 且小于对应库存总量。
- 最大中奖概率
单类实物奖概率上限 × 2 + VIP 概率 + 体验课概率 不能超过 100%。
- 管理端需展示概率预览，包括最大中奖概率、实物奖最大概率和最小未中奖概率。
- 保存前需提示本次变更会影响后续抽奖结果。
- 保存后需展示保存结果和最新库存/参数。
- 奖品库存和抽奖参数变更需记录操作人、操作时间和变更说明。
3.7 虚拟权益码池管理
- 管理端需支持导入口算VIP月卡激活码。
- 导入前需支持运营粘贴或上传一批激活码。
- 导入后需展示导入结果，包括成功数量、重复数量、空值或无效数量。
- 已使用的激活码不得重复分配给其他用户。
- 码池可用量过低时，管理端需给出明显提醒，避免活动期间权益奖品不可发放。
3.8 体验课领取链接配置
- 管理端需支持配置体验课领取链接。
- 体验课当前领取链接已确认，具体链接见 抽奖模块 2.4.1 节。
- 领取链接未配置或仍为占位链接时，上线检查需提示运营补齐；链接已配置为已确认地址时不应再作为缺失项。
- 链接修改保存后，前台「立即领取」入口需使用最新配置。
- 链接变更需记录操作人、操作时间和变更说明。
3.9 冠军、表彰与皮肤资源配置
- 冠军球队产生后，运营需能在管理端选择最终夺冠球队。
- 管理端需支持上传 1 张夺冠头图，用于前台表彰页展示。
- 管理端需支持配置冠军皮肤资源图，用于活动页皮肤预览、我的奖品列表和达标后获得状态展示。
- 冠军皮肤资源图应支持运营在活动上线前配置，也应支持后续在授权范围内替换。
- 冠军皮肤资源图未配置时，上线检查需提示运营补齐；前台可使用默认图或占位状态兜底。
- 未配置冠军球队时，前台需保持「冠军揭晓中」状态，不做最终奖励判定。
- 冠军球队和夺冠头图保存后，前台需切换为冠军确认后的展示状态。
- 冠军球队、夺冠头图和冠军皮肤资源图保存前需提示影响范围。
- 冠军相关配置变更需记录操作人、操作时间和变更说明。
3.10 数据导出
管理端需为活动结束后的发奖和审计提供导出能力。具体发奖规则见 发奖与数据导出模块。
| 导出类型 | 导出时机 | 主要用途 |
|---|
| 实物奖品中奖数据 | 活动结束后，或运营需要阶段性核对时 | 人工发货、地址核对 |
| 全部中奖记录 | 活动结束后 | 虚拟权益审计、活动复盘 |
| 冠军皮肤达标名单 | 活动结束且冠军确认后 | 后续发放冠军皮肤装扮 |
- 导出文件字段需满足发奖与审计要求。
- 导出操作需有权限控制，未授权人员不可导出用户个人信息。
- 导出文件应避免包含与发奖无关的敏感信息。
- 导出操作需记录操作人、操作时间、导出类型和导出环境。
3.11 上线检查
- 管理端需提供上线检查入口，帮助运营和研发确认活动关键配置是否就绪。
- 上线检查至少覆盖：
- 活动时间是否配置完整
- 奖品库存是否配置合理
- 口算VIP月卡激活码是否已导入
- 体验课领取链接是否已配置
- 管理端登录与权限是否可用
- 冠军皮肤资源图是否已配置
- 冠军相关配置是否处于符合当前活动阶段的状态
- 上线检查结果需区分阻塞项和提醒项。
- 活动进行前，未完成的关键配置应明确提示；活动结束后，冠军球队和夺冠头图未配置应明确提示。
3.12 事件与审计查看
- 管理端需支持查看关键用户行为事件，辅助排查投票、抽奖、分享、奖品领取等问题。
- 管理端需支持查看后台操作审计记录。
- 审计记录至少需包含操作人、操作时间、操作类型、操作环境和变更说明。
- 配置保存、库存调整、冠军配置、头图上传、冠军皮肤资源图配置、权益码导入、数据导出等关键操作必须可审计。
四、业务规则与约束
4.1 操作安全
| 场景 | 要求 |
|---|
| 生产环境写操作 | 明确提示当前是生产环境，必要时要求二次确认 |
| 导出用户数据 | 仅授权人员可操作，导出结果只用于发奖和审计 |
| 上传冠军头图 | 仅允许上传运营确认后的最终图片 |
| 配置冠军皮肤资源图 | 仅允许使用运营确认后的最终图片，保存后影响前台皮肤展示 |
| 配置冠军球队 | 仅在真实冠军产生后操作，保存前确认影响范围 |
| 导入权益码 | 需跳过重复和空值，不影响已使用权益码 |
4.2 数据一致性
- 管理端展示的数据需与前台用户看到的中奖、地址、领取状态保持一致。
- 库存、码池、中奖记录和导出数据需使用同一活动口径。
- 冠军配置保存后，表彰页、冠军皮肤判定和达标名单导出需使用同一冠军结果。
- 冠军皮肤资源图保存后，活动页皮肤预览、我的奖品列表和达标后获得状态需使用同一配置。
- 管理端配置变更后，前台不应长期展示旧配置。
4.3 活动阶段约束
| 活动阶段 | 管理端重点能力 |
|---|
| 上线前 | 配置检查、库存确认、权益码导入、体验课链接确认、冠军皮肤资源图确认、后台登录验证 |
| 活动进行中 | 数据查看、奖品库存监控、码池余量监控、问题排查 |
| 活动截止且冠军待确认 | 查看数据、准备导出、等待冠军配置，不提前发放冠军皮肤 |
| 冠军确认后 | 配置冠军球队和夺冠头图、导出冠军皮肤达标名单、执行发奖闭环 |
4.4 边界场景
| 场景 | 处理方式 |
|---|
| 未登录访问管理端 | 跳转登录或展示未授权提示 |
| 登录已过期 | 提示重新登录，不继续执行敏感操作 |
| 当前环境不可用 | 明确提示环境异常，不展示误导性数据 |
| 列表数据为空 | 展示空状态和当前筛选条件 |
| 导出数据量较大 | 支持分批导出或等待提示，避免用户误以为失败 |
| 权益码导入包含重复值 | 跳过重复值，并在导入结果中展示数量 |
| 冠军未配置时导出皮肤名单 | 阻止导出并提示先配置冠军球队 |
| 夺冠头图上传失败 | 保留原配置，提示重新上传 |
| 冠军皮肤资源图上传失败 | 保留原配置或默认图，提示重新上传 |