Skip to main content

管理端功能需求

一、模块定位​

管理端是足球季活动的运营与发奖工作台，面向运营、研发和授权测试人员使用。管理端需要支撑活动上线前检查、活动期间数据查看与奖品运营、活动结束后的冠军配置和发奖导出，确保前台活动、奖品库存、虚拟权益和人工发奖流程可被追踪和验收。

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

二、使用角色与权限要求​

角色主要诉求权限要求
运营人员查看活动数据、配置活动信息、导入权益码、处理用户异常、导出发奖数据可查看数据，可执行授权范围内的配置、用户处理和导出操作
研发人员联调、排查问题、检查上线准备状态可查看配置、日志、检查结果和必要的诊断信息；在本地和 FAT 可使用测试场景能力
测试人员验证 FAT 和生产预上线流程可登录指定环境，按授权执行只读检查或受控写入验证
  • 管理端必须有登录鉴权，未登录用户不可查看或操作活动数据。
  • 管理端需清晰展示当前数据环境，避免 FAT 和 PROD 混淆。
  • 涉及生产环境写入、上传、导入和导出的操作，必须由授权人员执行。
  • 生产环境用户处理写操作必须二次确认，并限制为单个 UCID，不提供批量处理入口。
  • 管理端不得在页面中展示真实密码、密钥或长期可复用的敏感凭证。

三、功能需求清单​

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 用户控制与问题处理​

  • 管理端需提供“用户控制”入口，用于按 UCID 查询真实用户活动状态，并处理活动期间的投票、抽奖和发奖异常。
  • 用户控制入口必须使用与 H5 相同的后端数据口径，不得通过前端假状态模拟用户数据。
  • 查询信息至少包括：UCID、当前状态日期、活动阶段、当前日期投票状态、活动期投票记录、抽奖机会总数、投票机会、分享机会、人工补发机会、活动期中奖记录、VIP 码池摘要、待消费的下一抽控制、最近后台操作。
  • 用户控制入口应按“先查询用户活动档案、再选择处理工具”的方式组织页面；查询区只包含 UCID，不应要求用户选择日期，也不应把后续处理参数混入查询条件。
  • 管理端可提供 H5 调试链接，用于以指定 UCID 打开前台页面辅助验证；该链接是可选调试入口，用户可直接登录前台账号时不依赖该链接。
  • 用户控制处理工具统一展示，不按测试能力和正式能力拆成两套页面；生产环境依赖醒目环境提示、二次确认和后端权限/规则控制降低误操作风险。
  • PROD 环境允许授权人员执行人工处理：补发抽奖机会、直接发放奖品、删除指定奖品、重置指定日期投票状态。
  • 补发抽奖机会应作为人工来源机会记录，不伪造投票；H5 抽奖时必须通过真实 /api/activity/draw 消耗。
  • 直接发奖必须复用真实发奖规则；VIP 必须消耗真实激活码，公仔和金片必须遵守库存和当日配额。
  • 删除奖品应按 UCID 和奖品 ID 处理；删除后应同步清理该奖品关联的地址、抽奖记录，若删除 VIP 奖品还需释放对应激活码。
  • 重置投票状态按 UCID 和处理日期执行；处理日期只在该工具内填写。该操作只删除指定日期的投票记录，让用户回到未投票状态，由用户重新在 H5 完成真实投票，不直接替用户选择球队。
  • PROD 写操作提交前必须二次确认；操作完成后需要刷新用户状态并展示最近操作结果。
  • 用户控制写操作必须进入审计记录，记录操作人、环境、UCID、操作类型、操作前后摘要和时间。

3.11 数据导出​

管理端需为活动结束后的发奖和审计提供导出能力。具体发奖规则见 发奖与数据导出模块。

导出类型导出时机主要用途
实物奖品中奖数据活动结束后，或运营需要阶段性核对时人工发货、地址核对
全部中奖记录活动结束后虚拟权益审计、活动复盘
冠军皮肤达标名单活动结束且冠军确认后后续发放冠军皮肤装扮
  • 导出文件字段需满足发奖与审计要求。
  • 导出操作需有权限控制，未授权人员不可导出用户个人信息。
  • 导出文件应避免包含与发奖无关的敏感信息。
  • 导出操作需记录操作人、操作时间、导出类型和导出环境。

3.12 上线检查​

  • 管理端需提供上线检查入口，帮助运营和研发确认活动关键配置是否就绪。
  • 上线检查至少覆盖：
    • 活动时间是否配置完整
    • 奖品库存是否配置合理
    • 口算VIP月卡激活码是否已导入
    • 体验课领取链接是否已配置
    • 管理端登录与权限是否可用
    • 冠军皮肤资源图是否已配置
    • 冠军相关配置是否处于符合当前活动阶段的状态
  • 上线检查结果需区分阻塞项和提醒项。
  • 活动进行前，未完成的关键配置应明确提示；活动结束后，冠军球队和夺冠头图未配置应明确提示。

3.13 事件与审计查看​

  • 管理端需支持查看关键用户行为事件，辅助排查投票、抽奖、分享、奖品领取等问题。
  • 管理端需支持查看后台操作审计记录。
  • 审计记录至少需包含操作人、操作时间、操作类型、操作环境和变更说明。
  • 配置保存、库存调整、用户控制写操作、冠军配置、头图上传、冠军皮肤资源图配置、权益码导入、数据导出等关键操作必须可审计。

四、业务规则与约束​

4.1 操作安全​

场景要求
生产环境写操作明确提示当前是生产环境，必要时要求二次确认
导出用户数据仅授权人员可操作，导出结果只用于发奖和审计
用户控制人工处理仅授权人员可操作；PROD 写操作必须二次确认；每次只处理单个 UCID
用户控制调试能力H5 调试链接仅用于辅助打开指定用户前台页面；若可直接登录用户账号，可不使用调试链接
用户控制高风险操作清理用户、删除奖品、设置下一抽等操作必须明确展示作用 UCID、日期或奖品 ID，并在生产环境二次确认
上传冠军头图仅允许上传运营确认后的最终图片
配置冠军皮肤资源图仅允许使用运营确认后的最终图片，保存后影响前台皮肤展示
配置冠军球队仅在真实冠军产生后操作，保存前确认影响范围
导入权益码需跳过重复和空值，不影响已使用权益码

4.2 数据一致性​

  • 管理端展示的数据需与前台用户看到的中奖、地址、领取状态保持一致。
  • 库存、码池、中奖记录和导出数据需使用同一活动口径。
  • 用户控制中的补发机会、直接发奖、删除奖品、重置投票状态必须写入真实后端数据，并能被 H5 正常读取或消耗。
  • 人工补发抽奖机会应与分享机会在抽奖消耗链路上保持一致，同时保留人工来源标记。
  • 删除奖品后，前台我的奖品列表、中奖记录、地址状态和 VIP 码池余量需与管理端保持一致。
  • 冠军配置保存后，表彰页、冠军皮肤判定和达标名单导出需使用同一冠军结果。
  • 冠军皮肤资源图保存后，活动页皮肤预览、我的奖品列表和达标后获得状态需使用同一配置。
  • 管理端配置变更后，前台不应长期展示旧配置。

4.3 活动阶段约束​

活动阶段管理端重点能力
上线前配置检查、库存确认、权益码导入、体验课链接确认、冠军皮肤资源图确认、后台登录验证
活动进行中数据查看、奖品库存监控、码池余量监控、用户问题处理、人工补发和问题排查
活动截止且冠军待结算查看数据、准备导出、等待冠军配置，不提前发放冠军皮肤
冠军确认后配置冠军球队和夺冠头图、导出冠军皮肤达标名单、执行发奖闭环

4.4 边界场景​

场景处理方式
未登录访问管理端跳转登录或展示未授权提示
登录已过期提示重新登录，不继续执行敏感操作
当前环境不可用明确提示环境异常，不展示误导性数据
列表数据为空展示空状态和当前筛选条件
导出数据量较大支持分批导出或等待提示，避免用户误以为失败
补发抽奖机会数量超出限制阻止提交并提示单次补发范围
直接发放 VIP 但码池无可用码阻止发奖，不创建奖品记录，提示先导入 VIP 激活码
删除 VIP 奖品删除奖品记录并释放对应激活码；不得影响其他用户或其他奖品
删除实物奖品删除奖品记录并清理对应收货地址；不得影响其他用户或其他奖品
重置已投票用户删除指定日期投票记录，让用户重新在 H5 投票；不替用户选择球队
权益码导入包含重复值跳过重复值，并在导入结果中展示数量
冠军未配置时导出皮肤名单阻止导出并提示先配置冠军球队
夺冠头图上传失败保留原配置，提示重新上传
冠军皮肤资源图上传失败保留原配置或默认图，提示重新上传