后台任务管理 PRD
最后更新时间：2026-06-11。本文只保留开发实现需要的配置、流程、状态与 H5 对齐规则。
一、开发阅读顺序
| 顺序 | 章节 | 开发重点 | 对应页面 |
|---|---|---|---|
| 1 | 整体流程 | 先确认「后台配置 → H5 展示与领取 → 奖励直接到账 → 账变/返水生效」的主流程。 | PRD · 任务流程图 |
| 2 | 任务列表 | 确认筛选、新增、编辑、删除、说明配置；任务名称栏位不展示。 | 任务列表 / PRD · 任务列表 |
| 3 | 任务类型配置 | 按「签到、每日、每周、累计、其他」逐一看任务要求、参数表、游戏选择与奖励配置。 | PRD · 任务列表 |
| 4 | 奖励配置 | 奖励只保留彩金、返水加成%。彩金需填写正数金额与流水倍数；返水加成%只进入设置弹窗。 | 新增/编辑任务弹窗 |
| 5 | 领取到账 | 确认领取记录与发放动作；彩金流水倍数在任务配置时确定。 | 任务领取记录 / PRD · 任务领取记录 |
| 6 | 权限与账变 | 确认菜单权限、按钮权限、彩金账变、返水加成%生效记录；返水加成%不产生金额账变。 | 权限管理设计 / 资金流水账变 |
二、后台最终口径
| 模块 | 后台规则 | H5 对应 |
|---|---|---|
| 任务类型 | 任务类型只保留签到、每日、每周、累计、其他；移除邀请任务；排序固定为签到、每日、每周、累计、其他。 | H5 子 Tab 仅每日、每周、累计、其他、说明；不展示邀请入口与邀请任务卡。 |
| 任务名称 | 新增/编辑弹窗、详情与 PRD 说明中均不展示任务名称栏位。 | H5 卡片标题由任务类型、任务要求、奖励配置组合生成。 |
| 奖励范围 | 每周、累计、其他任务奖励移除实物、积分；奖励类型只保留彩金、返水加成%。 | H5 奖励示意只展示彩金金额或返水加成时间。 |
| 彩金奖励 | 奖品类型选择「彩金」时才展示彩金金额输入框；彩金金额必填且须为正数；未选择奖品类型时不带入彩金金额；需配置流水倍数。 | 任务卡展示彩金；会员手动领取后直接按彩金金额入账，流水倍数按任务配置写入账变。 |
| 返水加成% | 奖品类型选择「返水加成%」时隐藏彩金金额，只展示「设置返水加成%」按钮；弹窗内配置加成游戏、加成比例、加成时长。 | H5 展示返水加成时间；任务页签中的任务卡 [i] 展示指定投注游戏与返水加成游戏。 |
| 默认币种 | 参照「平台管理 / 平台基础管理」该平台配置支持币种决定：仅配置 USDT 时默认 USDT；支持多币种且包含 CNY 时默认 CNY；不含 CNY 但包含 USDT 时默认 USDT；CNY、USDT 都没有时默认支持币种顺序第一个。 | H5 展示金额与奖励配置默认币种需与后台平台币种规则一致。 |
| 其他任务 | 任务要求为「完善资料并存款」；固定配置绑定手机号、绑定邮箱、下载APP三项，每项独立配置存款要求金额与奖励。下载APP由首页弹窗的「快捷APP / 原生APP」点击触发。 | 未完成显示「去设置」或「去下载」；任务动作完成但存款未达时显示「去充值」；任务动作与存款要求均完成后显示「可领取」并倒计时。 |
| 未配置状态 | 后台无启用任务配置时不下发任务数据；签到说明与任务说明皆为空时不下发说明数据；所有任务与说明均未配置时，H5 隐藏整个任务页签入口。 | H5 隐藏未配置区块且不保留空白；若仍有任务但说明未配置，说明页显示「暂无说明配置」；若所有任务与说明皆未配置，隐藏任务页签。 |
三、关键配置示例
| 配置项 | 后台输入 | 说明 |
|---|---|---|
| 彩金奖励 | 奖品类型=彩金；填写正数彩金金额，例如 66.00 | 只在奖品类型选中「彩金」后展示金额输入框；彩金金额须大于 0，流水倍数在任务配置中填写。 |
| 返水加成% | 奖品类型=返水加成%；点击「设置返水加成%」 | 不展示彩金金额；在弹窗配置加成时长、返水加成游戏与各游戏加成比例。 |
| 绑定手机号 | 存款要求金额=66；奖励类型=彩金；彩金金额=8.00 | 会员完成手机号绑定且存款达标后可领取；未绑定显示「去设置」，已绑定但存款未达显示「去充值」。 |
| 绑定邮箱 | 存款要求金额=66；奖励类型=彩金；彩金金额=8.00 | 会员完成邮箱绑定且存款达标后可领取；未绑定显示「去设置」，已绑定但存款未达显示「去充值」。 |
| 下载APP | 存款要求金额=66；奖励类型=彩金；彩金金额=8.00 | 会员点击首页弹窗「快捷APP / 原生APP」入口且存款达标后可领取；未触发显示「去下载」，已触发但存款未达显示「去充值」。 |
四、H5 对齐检查
| 检查点 | 后台来源 | H5 表现 |
|---|---|---|
| 任务页签 | 任务类型配置 | 仅每日、每周、累计、其他、说明；无邀请任务；当所有任务与说明皆未配置时隐藏任务页签。 |
| 签到规则说明 | 后台说明配置：签到说明 | 签到 picker 点击说明后展示纯文字规则；首页弹窗不重复展示规则按钮。 |
| 任务规则说明 | 后台说明配置：任务说明 | 任务区「说明」页签展示后台任务说明；仅说明未配置但仍有任务时显示空状态；所有任务与说明皆未配置时隐藏任务页签。 |
| 任务奖励 | 任务奖励类型与奖励值 | 彩金展示金额；返水加成展示时长，[i] 展示游戏与比例说明。 |
| 领取到账 | 任务领取记录 | 用户手动领取后直接到账；彩金入账或返水加成生效，后台仅保留领取与账变记录。 |
平台商
任务类型
任务要求
| 序号 | 平台商 | 任务类型 | 任务要求 | 任务创建时间 | 最后修改时间 | 操作人 | 状态 | 操作 |
|---|
平台商
任务类型
任务要求
任务奖励类型
会员帐号
领取时间
至
| 序号 | 会员帐号 | 订单号 | 任务类型 | 任务要求 | 任务奖励类型 | 任务奖励值 | 流水倍数 | 状态 | 领取时间 | 备注 | 操作 |
|---|
🗂 菜单树结构 来源：运营管理平台 / 权限管理 / 菜单管理
| 名称 | 路径 | 标识（组件名） | 类型 | 排序 |
|---|---|---|---|---|
| 任务管理 | — | userTask | 目录 | 5 |
| ├─ 任务列表 | /task/list | taskList | 菜单 | 1 |
| │ ├─ 新增 | /task/add | task:add | 按钮 | 1 |
| │ ├─ 编辑 | /task/edit | task:edit | 按钮 | 2 |
| │ └─ 删除 | /task/delete | task:delete | 按钮 | 3 |
| └─ 任务领取记录 | /task/record/list | task-record-list | 菜单 | 2 |
| ├─ 备注 | /task/record/audit | task-record-list | 按钮 | 1 |
| ├─ 备注 | /task/record/remark | task:record:remark | 按钮 | 2 |
📋 任务列表（/task/list）— 按钮权限说明
| 按钮/操作 | 标识 | 说明 | 高风险 | 建议角色 |
|---|---|---|---|---|
| 查看 | taskList（菜单权限） | 访问任务列表页、筛选、搜索；查看任务完整参数详情弹窗（按任务类型分表展示，含返水加成%查看） | — | 所有角色 |
| 新增 | task:add | 新增任务（签到 / 每日 / 每周 / 累计 / 其他），含参数梯度设置 | — | 运营主管、超管 |
| 编辑 | task:edit | 编辑任务配置与奖励参数，勾选单条后点击编辑按钮 | — | 运营主管、超管 |
| 删除 | task:delete | 删除任务，弹窗二次确认；建议后端使用软删除（is_deleted）保留审计追溯 | ⚠️ | 超管 |
✅ 任务领取记录（/task/record/list）— 按钮权限说明
| 按钮/操作 | 标识 | 说明 | 高风险 | 建议角色 |
|---|---|---|---|---|
| 查看列表 | task-record-list（菜单权限） | 访问领取记录列表页、筛选（平台商 / 类型 / 奖励类型 / 时间 / 会员账号等，不含到账状态） | — | 运营、主管、超管 |
| 到账 | task-record-list | 无需人工复核；会员领取后系统直接派发并触发账变 | — | 运营、主管、超管 |
| 备注 | task:record:remark | 对任意领取记录编辑/补充备注内容，不改变领取与到账结果 | — | 运营、主管、超管 |
⚠️ 开发注意事项
菜单级权限控制侧边栏显示；按钮级权限控制页面内操作按钮显示/禁用。两层均需后端鉴权，前端隐藏仅为 UX 优化，不可替代后端校验。
1. 删除任务（task:delete）：建议后端软删除（is_deleted 标记），保留审计追溯，前端需二次弹窗确认后再请求。
2. 领取到账记录：会员领取后系统直接派发，列表保留领取时间与备注，不展示到账时间、系统处理栏位。
3. 流水倍数：彩金奖励可配置 0倍（不计算=无流水要求）/ 1倍 / 2倍 / 3倍 / 4倍 / 5倍 / 20倍 / 50倍；N 倍 = 用户需完成奖励金额 × N 倍投注才可提款。
4. 奖励过期天数：仅累计任务、其他任务保留；每日、每周任务弹窗移除该配置。0 = 当日 23:59:59 过期；N = 发放后第 N 天 23:59:59 过期。
5. 签到类型（signin_type）：task config 新增字段，值为 cumulate（累计签到，断签不归零）或 consecutive（连续签到，断签归零）。前后端均需依此字段处理天数计算逻辑。
6. 返水加成%：任务奖励类型为「返水加成%」时，后端需存储加成时长（小时数）与各游戏供应商加成比例 JSON，详情弹窗展示只读数据。
7. 所有写入操作建议记录操作日志，保留 90 天以上，字段包括：操作人 / 操作时间 / 操作类型 / 操作前后数据快照。
📄 文档概述
项目名称任务管理后台 PRD
文档版本v1.0
更新日期2026-05-07
负责人Tilly
关联文件H5:任务中心PRD.html · 后台:任务管理.html
文档目的记录任务管理后台所有功能需求、配置字段、与H5对应关系及直接到账与账变规则，供前后端开发与测试参考
① 整体任务流程
后台新增任务 → H5 用户达标完成 → 用户点击领取 → 奖励直接到账 → 账变入账
📌 通用任务流程
后台新增任务
→
H5 展示任务卡片
→
用户满足条件
→
可领取（用户点击）
→
已领取
→
✅ 直接到账 → 账变入账
📌 签到任务流程
后台设置签到配置
→
当日条件达标
充值/投注/完善资料并存款
→
充值/投注/完善资料并存款
可签到 → 用户签到
→
签到成功弹窗
→
已领取
→
直接到账 → 账变入账
📌 直接到账 → 账变类型
| 奖励类型 | 账变说明 | 账户明细字段 | 备注 |
|---|---|---|---|
| 彩金 | 彩金入账，需满足打码量后可提款 | 来源：任务 / +金额 | 流水倍数由任务配置设置 |
| 返水加成% | N小时内指定游戏返水比例加成 | 来源：任务 / 返水加成 | 后台配置各供应商加成比例 |
② 任务类型
任务按重置周期分为两大类：周期性任务会按时重置、可重复完成；非周期性任务按累积或特定条件触发，不随周期重置。
| 任务类型 | 是否周期 | 重置规则 | 每人可领次数 | 梯度奖励 |
|---|---|---|---|---|
| 签到任务 | ✅ 周期 | 每日 00:00 | 每日 1 次（可连续累积天数） | ✅ 支持（连签梯度） |
| 每日任务 | ✅ 周期 | 每日 00:00 | 每日 1 次 | — 不支持 |
| 每周任务 | ✅ 周期 | 每周一 00:00 | 每周 1 次 | — 不支持 |
| 累计任务 | ❌ 非周期 | 不重置 | 1 次（达标即领） | ✅ 支持（金额梯度） |
| 其他任务 | ❌ 非周期 | 以有效期为准 | 依配置 | 依配置 |
③ 任务要求说明
任务要求决定用户须完成哪项行为方可达成任务，后台配置时选择「任务要求」类型。
① 筛选条件
| 筛选字段 | 控件类型 | 取值 / 说明 |
|---|---|---|
| 平台商 | 下拉 | 全部 / 天下网路 / TXWL / TXT飞投2.0 / TXI天下飞投 / TXZ白色飞投2.0 / DFC大富豪娱乐城 |
| 任务类型 | 下拉 | 全部 / 签到任务 / 每日任务 / 每周任务 / 累计任务 / 其他任务 |
| 任务要求 | 下拉 | 全部 / 登录 / 存款 / 投注 / 其他任务 / 定向游戏 |
② 页面交互
📋 任务列表
| 操作/字段 | 说明 | 权限码 |
|---|---|---|
| 查看列表 | 展示所有任务，支持按任务类型筛选；默认按任务创建时间近到远排序；点击「详情」可查看完整参数配置 | taskList（菜单权限） |
| 新增 | 新增任务弹窗，按任务类型切换参数设置区域 | task:add |
| 编辑 | 勾选单条任务后编辑，弹窗回填现有配置 | task:edit |
| 删除 | 弹窗二次确认，建议后端软删除保留审计 | task:delete ⚠️ |
| 说明配置 | 配置「签到说明」与「任务说明」默认文案，对应H5规则说明弹窗内容 | task:edit |
| 状态开关 | 任务列表「状态」列可直接切换启用/关闭；签到任务启用时需校验同平台仅一笔启用 | task:edit |
默认币种说明：参照「平台管理 / 平台基础管理」该平台配置支持币种决定。仅配置 USDT 时默认 USDT；支持多币种且包含 CNY 时默认 CNY；不含 CNY 但包含 USDT 时默认 USDT；CNY、USDT 都没有时默认支持币种顺序第一个。
✅ 任务领取记录
| 操作/字段 | 说明 | 权限码 |
|---|---|---|
| 查看列表 | 展示所有领取记录，支持平台商/任务类型/任务要求/奖励类型/领取时间/会员账号等筛选；默认按领取时间近到远排序；不提供到账状态筛选 | task-record-list（菜单权限） |
| 到账 | 无需人工复核；会员领取后系统直接派发并触发账变 | task-record-list |
| 备注 | 对任意领取记录补充备注，不改变领取与到账结果 | task:record:remark |
| 流水倍数 | 彩金奖励可配置 0倍（不计算=无流水要求）/ 1倍 / 2倍 / 3倍 / 4倍 / 5倍 / 20倍 / 50倍；返水加成%不显示流水倍数 | — |
③ 各任务类型配置字段详述
以下为每种任务类型在后台新增/编辑弹窗中的完整配置字段，并附对应后台截图与 H5 展示位置。
任务类型、任务要求、定向游戏、返水加成游戏配置位置
| 配置项 | 后台位置 | 作用 | 影响 H5 |
|---|---|---|---|
| 任务类型（图 1） | 任务列表 → 新增/编辑任务 → 基础设置 → 任务类型 | 选择任务大类：签到任务、每日任务、每周任务、累计任务、其他任务 | 决定展示在哪个 H5 Tab，并决定后续任务要求表单 |
| 任务状态 | 任务列表 → 操作栏前一列 | 展示启用 / 关闭，可在列表直接开关；新增任务默认启用 | 仅启用任务下发 H5；关闭任务不展示 |
| 任务要求 | 任务列表 → 新增/编辑任务 → 参数设置 → 任务要求 | 定义用户要完成什么条件。每日：存款、投注、定向游戏；每周：存款、投注、定向游戏；累计：存款、投注、定向游戏；其他：完善资料并存款；签到：登录 | 决定进度、达标判断和未达标引导按钮：去充值 / 去投注 / 去设置 |
| 定向游戏 | 参数设置 → 任务要求选择「定向游戏」→ 同一区块的游戏选择字段 + 要求投注金额 | 定义会员必须在哪些指定平台/游戏完成有效投注金额，属于任务完成条件 | 仅计算已选游戏范围内有效投注进度；未达标时显示「去投注」 |
| 返水加成游戏 | 奖励设置 → 奖励类型选择「返水加成%」→ 点击「设置返水加成%」 | 配置加成时长、游戏平台/游戏、返水加成比例，属于奖励效果 | 用户手动领取后激活加成时间；奖励说明展示游戏和比例 |
结论：定向游戏是任务要求，控制「用户在哪里完成投注任务」；返水加成游戏是奖励设置，控制「领取后哪些游戏享受返水加成」。两者不是同一个配置。定向游戏的要求金额统一指「指定游戏内有效投注金额」，不是存款金额。
④ 说明配置 × H5 规则说明弹窗
后台「说明配置」中的两段文案 + 定向任务配置中的游戏选择 / 返水加成设定，共三种规则说明类型对应 H5 展示。
| 类型 | 后台配置位置 | H5 展示场景 | 字符限制 |
|---|---|---|---|
| 签到说明 有默认文案（同原型） |
任务列表 → 说明配置弹窗 → 签到说明文本框 |
① 首页签到弹窗下方「规则说明」按钮 → Picker 展示 ② 任务页面签到 Banner「规则说明」按钮 → Picker 上方区块展示 |
1000 字以内 |
| 任务说明 有默认文案（同原型） |
任务列表 → 说明配置弹窗 → 任务说明文本框 | 任务页面各任务卡片「规则说明」按钮 → Picker 展示 | 1000 字以内 |
| 定向任务 ℹ 奖励 = 返水加成 |
任务配置弹窗： · 游戏选择（截图②） · 返水加成%配置弹窗（截图①） |
H5 定向任务卡片 ℹ 图标弹窗，展示： • 任务奖励（返水加成时长） • 定向投注金额要求（达标门槛） • 定向投注返水加成％（各供应商加成比率表） • 定向投注游戏清单（指定游戏名称列表） |
系统自动生成，无限制 |
| 定向任务 ℹ 奖励 ≠ 返水加成 |
任务配置弹窗： · 游戏选择（截图②） |
H5 定向任务卡片 ℹ 图标弹窗，展示： • 任务奖励（彩金金额） • 定向投注金额要求（达标门槛） • 定向投注游戏清单（指定游戏名称，无加成比率） |
系统自动生成，无限制 |
📸 截图① — 设置返水加成%弹窗
位置：定向任务 → 奖励类型选「返水加成%」→ 点击「设置返水加成%」按钮
📸 截图② — 游戏选择下拉（任务配置弹窗）
位置：新增/编辑定向任务 → 游戏选择字段 → 点击展开多级选择器
💡 H5 规则说明三种类型归纳：
① 签到说明（后台文案，有默认值）— 首页弹窗 + 签到Banner规则说明上方区块
② 任务说明（后台文案，有默认值）— 任务页面各卡片规则说明 Picker
③ 定向任务 ℹ（返水加成）— 任务奖励 + 投注门槛 + 各供应商加成比率 + 游戏清单（系统自动组装，来源：截图①②）
④ 定向任务 ℹ（非返水加成）— 任务奖励 + 投注门槛 + 游戏清单（系统自动组装，来源：截图②）
① 签到说明（后台文案，有默认值）— 首页弹窗 + 签到Banner规则说明上方区块
② 任务说明（后台文案，有默认值）— 任务页面各卡片规则说明 Picker
③ 定向任务 ℹ（返水加成）— 任务奖励 + 投注门槛 + 各供应商加成比率 + 游戏清单（系统自动组装，来源：截图①②）
④ 定向任务 ℹ（非返水加成）— 任务奖励 + 投注门槛 + 游戏清单（系统自动组装，来源：截图②）