|
|
@@ -0,0 +1,1564 @@
|
|
|
+# 抖转平台 - 用户前端业务需求文档
|
|
|
+
|
|
|
+> 文档版本:v2.0
|
|
|
+> 更新日期:2026-01-23
|
|
|
+> 文档类型:用户端功能需求
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 目录
|
|
|
+
|
|
|
+1. [业务概述](#1-业务概述)
|
|
|
+2. [用户注册与登录](#2-用户注册与登录)
|
|
|
+3. [首页与任务大厅](#3-首页与任务大厅)
|
|
|
+4. [任务系统](#4-任务系统)
|
|
|
+5. [素材管理](#5-素材管理)
|
|
|
+6. [用户中心](#6-用户中心)
|
|
|
+7. [财务系统](#7-财务系统)
|
|
|
+8. [团队与推广](#8-团队与推广)
|
|
|
+9. [每日签到](#9-每日签到)
|
|
|
+10. [消息通知](#10-消息通知)
|
|
|
+11. [个人设置](#11-个人设置)
|
|
|
+12. [页面路由汇总](#12-页面路由汇总)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 1. 业务概述
|
|
|
+
|
|
|
+### 1.1 产品定位
|
|
|
+
|
|
|
+抖转是一个**任务悬赏平台**,用户通过完成平台发布的任务(关注、点赞、下载、注册等)获取现金奖励,同时可通过邀请好友获得持续返佣收益。
|
|
|
+
|
|
|
+### 1.2 核心业务流程
|
|
|
+
|
|
|
+```
|
|
|
+┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
|
+│ 注册 │ ──►│ 浏览任务 │ ──►│ 申请任务 │ ──►│ 完成任务 │
|
|
|
+└─────────┘ └─────────┘ └─────────┘ └─────────┘
|
|
|
+ │
|
|
|
+ ▼
|
|
|
+┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
|
+│ 到账 │ ◄──│ 审核通过 │ ◄──│ 提交截图 │ ◄──│ 执行任务 │
|
|
|
+└─────────┘ └─────────┘ └─────────┘ └─────────┘
|
|
|
+ │
|
|
|
+ ▼
|
|
|
+┌─────────┐
|
|
|
+│ 提现/消费│
|
|
|
+└─────────┘
|
|
|
+```
|
|
|
+
|
|
|
+### 1.3 用户角色
|
|
|
+
|
|
|
+| 角色 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| 普通用户 | 可浏览、申请、完成任务赚取佣金 |
|
|
|
+| VIP会员 | 付费用户,享有更高返佣比例 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 2. 用户注册与登录
|
|
|
+
|
|
|
+### 2.1 用户注册
|
|
|
+
|
|
|
+**页面路径**:`/Home/Public/reg`
|
|
|
+
|
|
|
+#### 2.1.1 注册方式
|
|
|
+
|
|
|
+| 方式 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| 手机号注册 | 手机号 + 短信验证码 + 密码 |
|
|
|
+| 邮箱注册 | 邮箱 + 邮件验证码 + 密码 |
|
|
|
+| 第三方注册 | Google账号 / Zalo账号(自动创建) |
|
|
|
+
|
|
|
+#### 2.1.2 注册表单
|
|
|
+
|
|
|
+| 字段 | 类型 | 必填 | 验证规则 |
|
|
|
+|-----|------|-----|---------|
|
|
|
+| 用户名/手机号 | text | 是 | 不可重复,手机号11位 |
|
|
|
+| 密码 | password | 是 | 最小6位 |
|
|
|
+| 确认密码 | password | 是 | 与密码一致 |
|
|
|
+| 验证码 | text | 是 | 短信/邮件验证码 |
|
|
|
+| 邀请码 | text | 否 | 推荐人ID |
|
|
|
+| 人机验证 | - | 是 | 腾讯云验证码 |
|
|
|
+
|
|
|
+#### 2.1.3 注册业务规则
|
|
|
+
|
|
|
+```
|
|
|
+1. 验证用户名/手机号唯一性
|
|
|
+2. 验证短信/邮件验证码有效性
|
|
|
+3. 通过腾讯云人机验证
|
|
|
+4. 创建用户账户
|
|
|
+5. 建立邀请关系(如有邀请码):
|
|
|
+ - 设置一级推荐人(p1)
|
|
|
+ - 设置二级推荐人(p2)
|
|
|
+ - 设置三级推荐人(p3)
|
|
|
+ - 存储完整推荐链(pids),最多10层
|
|
|
+ - 在 member_guanxi 表建立4级以上关系
|
|
|
+6. 赠送注册积分(配置项:reg_point)
|
|
|
+7. 触发直推奖励(如启用):
|
|
|
+ - 推荐人立即获得 xshare_bonus 金额
|
|
|
+8. 分配随机头像
|
|
|
+9. 跳转用户中心
|
|
|
+```
|
|
|
+
|
|
|
+#### 2.1.4 邀请关系数据结构
|
|
|
+
|
|
|
+```
|
|
|
+member 表字段:
|
|
|
+├── p1: 一级推荐人ID(直接推荐人)
|
|
|
+├── p2: 二级推荐人ID
|
|
|
+├── p3: 三级推荐人ID
|
|
|
+└── pids: 完整推荐链(逗号分隔,最多10层)
|
|
|
+
|
|
|
+member_guanxi 表(4级及以上):
|
|
|
+├── member_id: 当前用户ID
|
|
|
+├── p_id: 上级用户ID
|
|
|
+├── dai: 层级深度(4, 5, 6...)
|
|
|
+├── level: 当前用户等级
|
|
|
+└── p_level: 上级用户等级
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 2.2 用户登录
|
|
|
+
|
|
|
+**页面路径**:`/Home/Public/login`
|
|
|
+
|
|
|
+#### 2.2.1 登录方式
|
|
|
+
|
|
|
+| 方式 | 路径 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 账号密码 | `/Home/Public/login` | 用户名/手机号 + 密码 |
|
|
|
+| 短信登录 | `/Home/Public/smsLogin` | 手机号 + 短信验证码 |
|
|
|
+| Google登录 | `/Home/Public/googleLogin` | Google OAuth授权 |
|
|
|
+| Zalo登录 | `/Home/Public/zaloLogin` | Zalo OAuth授权(越南地区) |
|
|
|
+
|
|
|
+#### 2.2.2 登录表单
|
|
|
+
|
|
|
+| 字段 | 类型 | 必填 | 说明 |
|
|
|
+|-----|------|-----|------|
|
|
|
+| 用户名 | text | 是 | 用户名/手机号/邮箱 |
|
|
|
+| 密码 | password | 是 | 登录密码 |
|
|
|
+| 人机验证 | - | 是 | 腾讯云验证码 |
|
|
|
+
|
|
|
+#### 2.2.3 登录业务规则
|
|
|
+
|
|
|
+```
|
|
|
+1. 验证用户名和密码
|
|
|
+2. 检查账户状态(user_status=2 表示禁用)
|
|
|
+3. 通过腾讯云人机验证
|
|
|
+4. 记录登录时间和IP
|
|
|
+5. 设置Session(有效期15天)
|
|
|
+6. 跳转用户中心或来源页
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 2.3 忘记密码
|
|
|
+
|
|
|
+**页面路径**:`/Home/Public/forget_pwd`
|
|
|
+
|
|
|
+#### 2.3.1 重置流程
|
|
|
+
|
|
|
+```
|
|
|
+1. 输入注册手机号/邮箱
|
|
|
+2. 获取验证码
|
|
|
+3. 验证码校验
|
|
|
+4. 设置新密码
|
|
|
+5. 重置成功,跳转登录页
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 2.4 退出登录
|
|
|
+
|
|
|
+**页面路径**:`/Home/Public/logout`
|
|
|
+
|
|
|
+```
|
|
|
+1. 清除用户Session
|
|
|
+2. 清除相关Cookie
|
|
|
+3. 跳转首页或登录页
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 3. 首页与任务大厅
|
|
|
+
|
|
|
+### 3.1 首页
|
|
|
+
|
|
|
+**页面路径**:`/Home/Index/index`
|
|
|
+
|
|
|
+#### 3.1.1 页面结构
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 顶部导航栏 │
|
|
|
+│ Logo 搜索框 消息(红点) 我的 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 轮播Banner │
|
|
|
+│ (广告位,3-5张轮播图) │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 系统公告 │
|
|
|
+│ 📢 最新公告内容滚动显示... │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 快捷入口 │
|
|
|
+│ [签到] [提现] [邀请] [客服] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 任务分类标签 │
|
|
|
+│ 全部 | QQ | 抖音 | 小红书 | ... │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 素材置顶区域 │
|
|
|
+│ (素材会置顶显示在任务列表前面) │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 推荐任务列表 │
|
|
|
+│ ┌─────────────────────────────┐ │
|
|
|
+│ │ 任务标题 ¥5.00 │ │
|
|
|
+│ │ 剩余: 50份 已领: 100份 │ │
|
|
|
+│ │ [难度:简单] [立即领取] │ │
|
|
|
+│ └─────────────────────────────┘ │
|
|
|
+│ ┌─────────────────────────────┐ │
|
|
|
+│ │ ...更多任务... │ │
|
|
|
+│ └─────────────────────────────┘ │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 底部导航栏 │
|
|
|
+│ 首页 大厅 Game Show 排行榜 我的│
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 3.1.2 数据展示
|
|
|
+
|
|
|
+| 数据项 | 来源 | 说明 |
|
|
|
+|-------|------|------|
|
|
|
+| Banner轮播 | dt_advert | 首页广告位 |
|
|
|
+| 系统公告 | dt_notice | 最新一条系统公告 |
|
|
|
+| 任务分类 | dt_category | status=1的分类 |
|
|
|
+| 素材列表 | dt_task_material | status=1,置顶显示 |
|
|
|
+| 推荐任务 | dt_task | position=1 推荐任务 |
|
|
|
+| 置顶任务 | dt_task | is_top=1 置顶任务 |
|
|
|
+| 普通任务 | dt_task | 按时间倒序 |
|
|
|
+| 未读消息 | dt_notice | 用户未读消息数 |
|
|
|
+
|
|
|
+#### 3.1.3 任务卡片信息
|
|
|
+
|
|
|
+| 字段 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| 任务标题 | title |
|
|
|
+| 任务单价 | price(元) |
|
|
|
+| 任务难度 | level(简单/普通/困难) |
|
|
|
+| 可领数量 | max_num - apply_num |
|
|
|
+| 已领数量 | apply_num |
|
|
|
+| 任务分类 | category.name |
|
|
|
+| 任务图标 | category.icon |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 3.2 任务搜索
|
|
|
+
|
|
|
+**页面路径**:`/Home/Index/serach`
|
|
|
+
|
|
|
+#### 3.2.1 搜索条件
|
|
|
+
|
|
|
+| 条件 | 类型 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 关键词 | text | 任务标题模糊搜索 |
|
|
|
+| 分类 | select | 任务分类筛选 |
|
|
|
+| 难度 | select | 简单/普通/困难 |
|
|
|
+| 排序 | select | 价格升序/降序/人气 |
|
|
|
+
|
|
|
+#### 3.2.2 搜索结果
|
|
|
+
|
|
|
+```
|
|
|
+显示匹配的任务列表,包含:
|
|
|
+- 任务标题
|
|
|
+- 任务单价
|
|
|
+- 任务难度
|
|
|
+- 剩余数量
|
|
|
+- 领取按钮
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 4. 任务系统
|
|
|
+
|
|
|
+### 4.1 任务列表
|
|
|
+
|
|
|
+**页面路径**:`/Home/Task/index` 或 `/Home/Task/lists`
|
|
|
+
|
|
|
+#### 4.1.1 任务分类
|
|
|
+
|
|
|
+| 分类 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| QQ任务 | QQ相关操作任务 |
|
|
|
+| 抖音任务 | 抖音关注、点赞等 |
|
|
|
+| 小红书任务 | 小红书相关任务 |
|
|
|
+| TikTok任务 | TikTok相关任务 |
|
|
|
+| 游戏任务 | 游戏下载、注册等 |
|
|
|
+| 其他任务 | 其他类型任务 |
|
|
|
+
|
|
|
+#### 4.1.2 任务筛选
|
|
|
+
|
|
|
+| 筛选项 | 说明 |
|
|
|
+|-------|------|
|
|
|
+| 分类 | 按任务类型筛选 |
|
|
|
+| 难度 | 简单/普通/困难 |
|
|
|
+| 价格区间 | 最低-最高价格 |
|
|
|
+| 排序方式 | 最新/价格/人气 |
|
|
|
+
|
|
|
+#### 4.1.3 列表展示规则
|
|
|
+
|
|
|
+```
|
|
|
+1. 素材(is_material=1)置顶显示在列表最前面
|
|
|
+2. 然后是推荐任务(position=1)
|
|
|
+3. 然后是置顶任务(is_top=1)
|
|
|
+4. 最后是普通任务(按时间倒序)
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 4.2 任务详情
|
|
|
+
|
|
|
+**页面路径**:`/Home/Task/show?id={task_id}`
|
|
|
+
|
|
|
+#### 4.2.1 页面结构
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 任务详情页 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 任务标题 │
|
|
|
+│ ¥8.00 [困难] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 任务信息 │
|
|
|
+│ ├─ 剩余数量: 45份 │
|
|
|
+│ ├─ 已领取: 55份 │
|
|
|
+│ ├─ 完成时限: 24小时 │
|
|
|
+│ └─ 审核时间: 48小时内 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 任务要求 │
|
|
|
+│ 1. 关注指定账号 │
|
|
|
+│ 2. 点赞最新3条视频 │
|
|
|
+│ 3. 评论"666" │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 任务步骤 │
|
|
|
+│ 第一步: 打开抖音APP │
|
|
|
+│ 第二步: 搜索账号 xxx │
|
|
|
+│ 第三步: 点击关注 │
|
|
|
+│ ... │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 图片素材 │
|
|
|
+│ [图片1] [图片2] [图片3] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 视频素材 │
|
|
|
+│ [视频链接1] [视频链接2] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 提交要求 │
|
|
|
+│ 需上传:关注截图、点赞截图 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ [立即领取] │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 4.2.2 任务详情字段
|
|
|
+
|
|
|
+| 字段 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| title | 任务标题 |
|
|
|
+| price | 任务单价 |
|
|
|
+| content | 任务描述/要求 |
|
|
|
+| step_info | 任务步骤说明 |
|
|
|
+| tushi | 图示案例 |
|
|
|
+| tushi_links | 审核样例链接(序列化格式) |
|
|
|
+| image_material | 图片素材(换行分隔的URL) |
|
|
|
+| video_material | 视频素材(换行分隔的URL) |
|
|
|
+| max_num | 总名额 |
|
|
|
+| apply_num | 已领取数 |
|
|
|
+| level | 任务难度 |
|
|
|
+| end_time | 截止时间 |
|
|
|
+
|
|
|
+#### 4.2.3 任务状态显示
|
|
|
+
|
|
|
+| 状态 | 显示 | 按钮 |
|
|
|
+|-----|------|------|
|
|
|
+| 未申请 | 可领取 | [立即领取] |
|
|
|
+| 已申请未提交 | 进行中 | [去提交] |
|
|
|
+| 已提交待审核 | 审核中 | [查看进度] |
|
|
|
+| 审核通过 | 已完成 | [已完成] |
|
|
|
+| 审核失败 | 未通过 | [查看原因] |
|
|
|
+| 已放弃 | 已放弃 | [重新领取] |
|
|
|
+| 名额已满 | 已抢光 | [已结束] |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 4.3 领取任务
|
|
|
+
|
|
|
+**接口路径**:`/Home/Task/get_task`
|
|
|
+
|
|
|
+#### 4.3.1 领取条件
|
|
|
+
|
|
|
+```
|
|
|
+1. 用户已登录
|
|
|
+2. 任务状态正常(status=1)
|
|
|
+3. 剩余名额 > 0
|
|
|
+4. 用户未领取过该任务(或已放弃可重新领取)
|
|
|
+5. 用户信用分满足要求
|
|
|
+6. 用户账户状态正常
|
|
|
+7. 普通任务只能领取1次,下载任务可领取5次
|
|
|
+```
|
|
|
+
|
|
|
+#### 4.3.2 领取流程
|
|
|
+
|
|
|
+```
|
|
|
+1. 检查领取条件
|
|
|
+2. 创建 task_apply 记录:
|
|
|
+ - task_id: 任务ID
|
|
|
+ - member_id: 用户ID
|
|
|
+ - price: 任务单价
|
|
|
+ - status: 0(未完成)
|
|
|
+ - create_time: 当前时间
|
|
|
+3. 更新任务已领取数量(apply_num + 1)
|
|
|
+4. 返回成功,跳转任务提交页
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 4.4 提交任务
|
|
|
+
|
|
|
+**页面路径**:`/Home/Task/submission_task?apply_id={apply_id}`
|
|
|
+
|
|
|
+#### 4.4.1 提交表单
|
|
|
+
|
|
|
+| 字段 | 类型 | 必填 | 说明 |
|
|
|
+|-----|------|-----|------|
|
|
|
+| 完成截图 | file | 是 | 支持多张(至少3张),上传至OSS |
|
|
|
+| 完成备注 | textarea | 否 | 补充说明 |
|
|
|
+| 账号信息 | text | 视情况 | 部分任务需填写 |
|
|
|
+
|
|
|
+#### 4.4.2 提交流程
|
|
|
+
|
|
|
+```
|
|
|
+1. 上传截图到阿里云OSS
|
|
|
+2. 更新 task_apply 记录:
|
|
|
+ - file: 截图URL(多张用逗号分隔)
|
|
|
+ - remark: 用户备注
|
|
|
+ - status: 1(等待审核)
|
|
|
+ - update_time: 当前时间
|
|
|
+3. 返回成功提示
|
|
|
+4. 等待审核员审核
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 4.5 放弃任务
|
|
|
+
|
|
|
+**接口路径**:`/Home/Task/abandon`
|
|
|
+
|
|
|
+#### 4.5.1 放弃规则
|
|
|
+
|
|
|
+```
|
|
|
+1. 只有状态为 0(未完成)的任务可放弃
|
|
|
+2. 更新 task_apply.status = -2
|
|
|
+3. 更新任务已领取数量(apply_num - 1)
|
|
|
+4. 可能扣除信用分(根据配置)
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 4.6 任务状态流转
|
|
|
+
|
|
|
+```
|
|
|
+┌─────────────────────────────────────────────────────────┐
|
|
|
+│ 任务状态流转图 │
|
|
|
+├─────────────────────────────────────────────────────────┤
|
|
|
+│ │
|
|
|
+│ ┌─────────┐ │
|
|
|
+│ │ 领取任务 │ │
|
|
|
+│ └────┬────┘ │
|
|
|
+│ │ │
|
|
|
+│ ▼ │
|
|
|
+│ ┌─────────┐ 放弃 ┌─────────┐ │
|
|
|
+│ │ status=0 │ ──────────► │ status=-2│ │
|
|
|
+│ │ 未完成 │ │ 已放弃 │ │
|
|
|
+│ └────┬────┘ └─────────┘ │
|
|
|
+│ │ │
|
|
|
+│ │ 提交截图 │
|
|
|
+│ ▼ │
|
|
|
+│ ┌─────────┐ │
|
|
|
+│ │ status=1 │ │
|
|
|
+│ │ 待审核 │ │
|
|
|
+│ └────┬────┘ │
|
|
|
+│ │ │
|
|
|
+│ ┌────┴────┐ │
|
|
|
+│ │ │ │
|
|
|
+│ ▼ ▼ │
|
|
|
+│ ┌─────────┐ ┌─────────┐ │
|
|
|
+│ │ status=2 │ │ status=-1│ │
|
|
|
+│ │ 已完成 │ │ 审核失败 │ │
|
|
|
+│ │ +佣金 │ │ -信用分 │ │
|
|
|
+│ └─────────┘ └─────────┘ │
|
|
|
+│ │
|
|
|
+└─────────────────────────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 5. 素材管理
|
|
|
+
|
|
|
+### 5.1 素材中心
|
|
|
+
|
|
|
+**页面路径**:`/Home/Material/index`
|
|
|
+
|
|
|
+#### 5.1.1 功能描述
|
|
|
+
|
|
|
+素材中心提供平台发布的各类推广素材,用户可以浏览、下载使用。素材会在任务列表中置顶显示。
|
|
|
+
|
|
|
+#### 5.1.2 页面结构
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 素材中心 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 分类标签 │
|
|
|
+│ 全部 | QQ | 抖音 | 小红书 | ... │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 素材类型Tab │
|
|
|
+│ [图片素材] [文字素材] [视频素材] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 素材列表 │
|
|
|
+│ ┌─────────────────────────────┐ │
|
|
|
+│ │ 素材标题 │ │
|
|
|
+│ │ 图片: 5张 视频: 2个 │ │
|
|
|
+│ │ 浏览: 1280次 │ │
|
|
|
+│ │ [查看详情] │ │
|
|
|
+│ └─────────────────────────────┘ │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 5.1.3 素材分类
|
|
|
+
|
|
|
+| 类型 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| 图片素材 | 推广图片、海报、截图示例 |
|
|
|
+| 文字素材 | 文案、话术、评论模板 |
|
|
|
+| 视频素材 | 推广视频、教程视频 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 5.2 素材列表接口
|
|
|
+
|
|
|
+**接口路径**:`/Home/Material/getList`
|
|
|
+
|
|
|
+#### 5.2.1 请求参数
|
|
|
+
|
|
|
+| 参数 | 类型 | 必填 | 说明 |
|
|
|
+|-----|------|-----|------|
|
|
|
+| type | string | 否 | 素材类型:image/text/video,默认image |
|
|
|
+| cid | int | 否 | 分类ID,0表示全部 |
|
|
|
+| keyword | string | 否 | 搜索关键词 |
|
|
|
+| page | int | 否 | 页码,默认1 |
|
|
|
+| limit | int | 否 | 每页数量,默认20 |
|
|
|
+
|
|
|
+#### 5.2.2 返回数据
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "code": 1,
|
|
|
+ "msg": "success",
|
|
|
+ "data": {
|
|
|
+ "list": [
|
|
|
+ {
|
|
|
+ "id": 1,
|
|
|
+ "title": "素材标题",
|
|
|
+ "cid": 1,
|
|
|
+ "category_name": "抖音",
|
|
|
+ "images_arr": ["url1", "url2"],
|
|
|
+ "videos_arr": ["url1"],
|
|
|
+ "text_content": "文字内容",
|
|
|
+ "image_count": 2,
|
|
|
+ "video_count": 1,
|
|
|
+ "view_count": 1280,
|
|
|
+ "sort": 100,
|
|
|
+ "status": 1,
|
|
|
+ "create_time": 1706000000
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ "total": 50,
|
|
|
+ "page": 1,
|
|
|
+ "limit": 20,
|
|
|
+ "pages": 3
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 5.3 素材详情
|
|
|
+
|
|
|
+**页面路径**:`/Home/Task/materialDetail?id={material_id}`
|
|
|
+
|
|
|
+#### 5.3.1 页面结构
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 素材详情 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 素材标题 │
|
|
|
+│ 分类: 抖音 │
|
|
|
+│ 浏览: 1280次 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 图片素材 │
|
|
|
+│ ┌─────┐ ┌─────┐ ┌─────┐ │
|
|
|
+│ │ 图1 │ │ 图2 │ │ 图3 │ │
|
|
|
+│ └─────┘ └─────┘ └─────┘ │
|
|
|
+│ (点击可查看大图/保存) │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 文字素材 │
|
|
|
+│ ┌─────────────────────────────┐ │
|
|
|
+│ │ 推广文案内容... │ │
|
|
|
+│ │ 可直接复制使用 │ │
|
|
|
+│ └─────────────────────────────┘ │
|
|
|
+│ [一键复制] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 视频素材 │
|
|
|
+│ [视频链接1] [复制] │
|
|
|
+│ [视频链接2] [复制] │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 5.3.2 详情字段
|
|
|
+
|
|
|
+| 字段 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| title | 素材标题 |
|
|
|
+| cid | 分类ID |
|
|
|
+| category_name | 分类名称 |
|
|
|
+| images | 图片列表(JSON数组) |
|
|
|
+| videos | 视频列表(JSON数组) |
|
|
|
+| text_content | 文字内容 |
|
|
|
+| icon | 素材图标 |
|
|
|
+| view_count | 浏览次数 |
|
|
|
+| sort | 排序值 |
|
|
|
+| status | 状态(1启用/0禁用) |
|
|
|
+| create_time | 创建时间 |
|
|
|
+
|
|
|
+#### 5.3.3 业务规则
|
|
|
+
|
|
|
+```
|
|
|
+1. 每次访问素材详情页,view_count +1
|
|
|
+2. 素材在任务列表中显示时,is_material=1,apply_code=99
|
|
|
+3. 素材不显示价格(price=0)
|
|
|
+4. 素材不显示名额信息
|
|
|
+5. 素材按 sort DESC, create_time DESC 排序
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 5.4 素材数据表
|
|
|
+
|
|
|
+**表名**:`dt_task_material`
|
|
|
+
|
|
|
+| 字段 | 类型 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| id | int | 主键ID |
|
|
|
+| title | varchar(200) | 素材标题 |
|
|
|
+| cid | int | 分类ID |
|
|
|
+| images | text | 图片列表(JSON数组) |
|
|
|
+| videos | text | 视频列表(JSON数组) |
|
|
|
+| text_content | text | 文字内容 |
|
|
|
+| icon | varchar(255) | 素材图标 |
|
|
|
+| view_count | int | 浏览次数 |
|
|
|
+| sort | int | 排序值(越大越靠前) |
|
|
|
+| status | tinyint | 状态:1启用/0禁用 |
|
|
|
+| create_time | int | 创建时间 |
|
|
|
+| update_time | int | 更新时间 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 5.5 任务中的素材展示
|
|
|
+
|
|
|
+在任务详情页中,任务也可以包含图片素材和视频素材:
|
|
|
+
|
|
|
+**任务表相关字段**(`dt_task`):
|
|
|
+
|
|
|
+| 字段 | 说明 |
|
|
|
+|-----|------|
|
|
|
+| image_material | 图片素材(换行分隔的URL列表) |
|
|
|
+| video_material | 视频素材(换行分隔的URL列表) |
|
|
|
+
|
|
|
+**解析方式**:
|
|
|
+```php
|
|
|
+// 图片素材解析
|
|
|
+$lines = explode("\n", str_replace("\r\n", "\n", $task['image_material']));
|
|
|
+$image_material_arr = array_filter(array_map('trim', $lines));
|
|
|
+
|
|
|
+// 视频素材解析
|
|
|
+$lines = explode("\n", str_replace("\r\n", "\n", $task['video_material']));
|
|
|
+$video_material_arr = array_filter(array_map('trim', $lines));
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 6. 用户中心
|
|
|
+
|
|
|
+### 6.1 用户中心首页
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/index`
|
|
|
+
|
|
|
+#### 6.1.1 页面结构
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 用户信息区 │
|
|
|
+│ ┌─────┐ │
|
|
|
+│ │ 头像 │ 用户名 │
|
|
|
+│ └─────┘ VIP等级标识 │
|
|
|
+│ 信用分: 100分 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 资产信息 │
|
|
|
+│ ┌──────────┬──────────┐ │
|
|
|
+│ │ 账户余额 │ 累计收益 │ │
|
|
|
+│ │ ¥168.50 │ ¥2,580 │ │
|
|
|
+│ └──────────┴──────────┘ │
|
|
|
+│ [提现] [明细] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 收益统计 │
|
|
|
+│ 今日收益: ¥28.00 │
|
|
|
+│ 本月收益: ¥580.00 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 团队统计 │
|
|
|
+│ 今日新增: 5人 | 团队总人数: 128人│
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 快捷功能 │
|
|
|
+│ ┌────┐ ┌────┐ ┌────┐ ┌────┐ │
|
|
|
+│ │我的 │ │已完 │ │邀请 │ │联系 │ │
|
|
|
+│ │任务 │ │成的 │ │好友 │ │客服 │ │
|
|
|
+│ └────┘ └────┘ └────┘ └────┘ │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 功能列表 │
|
|
|
+│ > 我的任务 │
|
|
|
+│ > 收益账单 │
|
|
|
+│ > 我的团队 │
|
|
|
+│ > 邀请好友 │
|
|
|
+│ > 会员中心 │
|
|
|
+│ > 账户设置 │
|
|
|
+│ > 系统消息 │
|
|
|
+│ > 关于我们 │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 6.1.2 数据统计
|
|
|
+
|
|
|
+| 数据项 | 计算方式 |
|
|
|
+|-------|---------|
|
|
|
+| 账户余额 | member.price |
|
|
|
+| 累计收益 | SUM(member_price_log.price) WHERE type IN (1,2,3) |
|
|
|
+| 今日收益 | 今日的收益记录汇总 |
|
|
|
+| 本月收益 | 本月的收益记录汇总 |
|
|
|
+| 今日新增 | 今日直推注册人数 |
|
|
|
+| 团队总数 | member.p_num |
|
|
|
+| 未读消息 | 未读消息数量 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 6.2 我的任务
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/apply`
|
|
|
+
|
|
|
+#### 6.2.1 任务筛选
|
|
|
+
|
|
|
+| 筛选项 | 状态值 | 说明 |
|
|
|
+|-------|-------|------|
|
|
|
+| 全部 | - | 所有申请记录 |
|
|
|
+| 进行中 | 0 | 已领取未提交 |
|
|
|
+| 待审核 | 1 | 已提交等待审核 |
|
|
|
+| 已完成 | 2 | 审核通过 |
|
|
|
+| 未通过 | -1 | 审核失败 |
|
|
|
+| 已放弃 | -2 | 用户主动放弃 |
|
|
|
+
|
|
|
+#### 6.2.2 时间筛选
|
|
|
+
|
|
|
+| 筛选项 | 说明 |
|
|
|
+|-------|------|
|
|
|
+| 开始日期 | 申请时间起始 |
|
|
|
+| 结束日期 | 申请时间截止 |
|
|
|
+
|
|
|
+#### 6.2.3 任务列表项
|
|
|
+
|
|
|
+```
|
|
|
+┌─────────────────────────────────────┐
|
|
|
+│ 任务标题 ¥5.00 │
|
|
|
+│ 申请时间: 2026-01-20 10:30 │
|
|
|
+│ 状态: [待审核] │
|
|
|
+│ [查看详情] │
|
|
|
+└─────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 6.3 任务详情
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/apply_show?id={apply_id}`
|
|
|
+
|
|
|
+| 信息项 | 说明 |
|
|
|
+|-------|------|
|
|
|
+| 任务标题 | 关联的任务名称 |
|
|
|
+| 任务单价 | 完成可获得金额 |
|
|
|
+| 申请时间 | 领取任务时间 |
|
|
|
+| 提交时间 | 提交截图时间 |
|
|
|
+| 审核时间 | 审核完成时间 |
|
|
|
+| 当前状态 | 状态文字说明 |
|
|
|
+| 提交截图 | 用户上传的截图 |
|
|
|
+| 用户备注 | 提交时的备注 |
|
|
|
+| 审核备注 | 审核员的反馈(如有) |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 6.4 已完成任务
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/apply_finish`
|
|
|
+
|
|
|
+```
|
|
|
+筛选条件: status = 2
|
|
|
+显示所有审核通过的任务记录
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+## 7. 财务系统
|
|
|
+
|
|
|
+### 7.1 账户余额
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/balance`
|
|
|
+
|
|
|
+| 信息项 | 说明 |
|
|
|
+|-------|------|
|
|
|
+| 可用余额 | member.price |
|
|
|
+| 累计提现 | member.tixian_price |
|
|
|
+| 累计收益 | 任务收益+返佣收益总和 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 7.2 提现功能
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/tixian`
|
|
|
+
|
|
|
+#### 7.2.1 提现条件
|
|
|
+
|
|
|
+| 条件 | 要求 | 错误提示 |
|
|
|
+|-----|------|---------|
|
|
|
+| 绑定手机 | phone 非空 | 请先绑定手机号 |
|
|
|
+| 实名认证 | idc_name、idc 非空 | 请先完成实名认证 |
|
|
|
+| 绑定收款账户 | member_payment 有记录 | 请先绑定收款账户 |
|
|
|
+| 注册时长 | 注册满120天 | 注册未满4个月,暂不能提现 |
|
|
|
+| 最低金额 | ≥ 100元 | 最低提现金额100元 |
|
|
|
+| 金额倍数 | 10的整数倍 | 提现金额需为10的倍数 |
|
|
|
+| 余额充足 | price ≥ 提现金额 | 余额不足 |
|
|
|
+
|
|
|
+#### 7.2.2 提现计算
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 提现申请 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 可提现余额: ¥1,680.00 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 提现金额: [________] 元 │
|
|
|
+│ (最低100元,需为10的倍数) │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 收款账户: │
|
|
|
+│ ○ 支付宝 (138****8888) │
|
|
|
+│ ○ 银行卡 (尾号6789) │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 手续费: 2% │
|
|
|
+│ 实际到账: ¥___.__ │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 短信验证码: [____] [获取验证码] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ [确认提现] │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+
|
|
|
+```
|
|
|
+手续费 = 提现金额 × charge%
|
|
|
+实际到账 = 提现金额 - 手续费
|
|
|
+
|
|
|
+示例:
|
|
|
+提现金额: 100元
|
|
|
+手续费率: 2%
|
|
|
+手续费: 100 × 2% = 2元
|
|
|
+实际到账: 100 - 2 = 98元
|
|
|
+```
|
|
|
+
|
|
|
+#### 7.2.3 提现流程
|
|
|
+
|
|
|
+```
|
|
|
+1. 检查提现条件
|
|
|
+2. 验证短信验证码
|
|
|
+3. 通过腾讯云人机验证
|
|
|
+4. 扣除用户余额 (decPrice, type=100)
|
|
|
+5. 创建提现记录 (member_tixian):
|
|
|
+ - member_id: 用户ID
|
|
|
+ - price: 提现金额
|
|
|
+ - charge: 手续费率
|
|
|
+ - actual_price: 实际到账金额
|
|
|
+ - account_type: 账户类型
|
|
|
+ - account_info: 账户信息
|
|
|
+ - status: 0 (待审核)
|
|
|
+6. 等待管理员审核
|
|
|
+```
|
|
|
+
|
|
|
+#### 7.2.4 提现状态
|
|
|
+
|
|
|
+| 状态 | 值 | 说明 |
|
|
|
+|-----|---|------|
|
|
|
+| 待审核 | 0 | 等待管理员审核 |
|
|
|
+| 已通过 | 1 | 审核通过,已打款 |
|
|
|
+| 已拒绝 | -1 | 审核拒绝,余额已退回 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 7.3 提现记录
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/tixian_log`
|
|
|
+
|
|
|
+#### 7.3.1 记录列表
|
|
|
+
|
|
|
+```
|
|
|
+┌─────────────────────────────────────┐
|
|
|
+│ 提现金额: ¥500.00 │
|
|
|
+│ 手续费: ¥10.00 │
|
|
|
+│ 实际到账: ¥490.00 │
|
|
|
+│ 收款账户: 支付宝 (138****8888) │
|
|
|
+│ 申请时间: 2026-01-15 14:30 │
|
|
|
+│ 状态: [已到账] │
|
|
|
+└─────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 7.4 收益账单
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/bill`
|
|
|
+
|
|
|
+#### 7.4.1 收益类型
|
|
|
+
|
|
|
+| 类型 | type值 | 说明 |
|
|
|
+|-----|-------|------|
|
|
|
+| 任务收益 | 1 | 完成任务获得 |
|
|
|
+| 返佣收益 | 2 | 下级完成任务返佣 |
|
|
|
+| 推荐奖励 | 3 | 下级购买VIP返利 |
|
|
|
+| 直推奖励 | 4 | 直推注册奖励 |
|
|
|
+
|
|
|
+#### 7.4.2 账单展示
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 2026年01月 │
|
|
|
+│ 收益合计: ¥580.00 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 01-20 14:30 任务收益 +¥8.00 │
|
|
|
+│ 抖音关注任务完成 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 01-20 10:15 返佣收益 +¥0.80 │
|
|
|
+│ 来自用户 张** 的任务返佣 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 01-19 18:00 推荐奖励 +¥50.00 │
|
|
|
+│ 用户 李** 升级VIP返利 │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 7.5 交易记录
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/records`
|
|
|
+
|
|
|
+| 类型 | type值 | 说明 |
|
|
|
+|-----|-------|------|
|
|
|
+| 任务收入 | 1 | 任务完成收益 |
|
|
|
+| 返佣收入 | 2 | 下级返佣 |
|
|
|
+| 推荐奖励 | 3 | VIP返利 |
|
|
|
+| 直推奖励 | 4 | 注册奖励 |
|
|
|
+| 提现退回 | 99 | 提现失败退款 |
|
|
|
+| 提现扣款 | 100 | 提现扣除 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 8. 团队与推广
|
|
|
+
|
|
|
+### 8.1 邀请好友
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/qrcode`
|
|
|
+
|
|
|
+#### 8.1.1 推广信息
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 邀请好友 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ ┌─────────────┐ │
|
|
|
+│ │ │ │
|
|
|
+│ │ 二维码 │ │
|
|
|
+│ │ │ │
|
|
|
+│ └─────────────┘ │
|
|
|
+│ │
|
|
|
+│ 我的邀请码: 123456 │
|
|
|
+│ │
|
|
|
+│ 推广链接: │
|
|
|
+│ https://xxx.com/reg?smid=123456 │
|
|
|
+│ │
|
|
|
+│ [复制链接] [保存二维码] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 邀请奖励说明 │
|
|
|
+│ 1. 好友注册即奖励 ¥2.00 │
|
|
|
+│ 2. 好友完成任务返佣 10% │
|
|
|
+│ 3. 好友升级VIP返利 ¥50 │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 8.1.2 推广链接
|
|
|
+
|
|
|
+```
|
|
|
+格式: {域名}/Home/Public/reg?smid={member_id}
|
|
|
+二维码存储: /Upload/qrcode/share_{member_id}.png
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 8.2 我的团队
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/team`
|
|
|
+
|
|
|
+#### 8.2.1 团队统计
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 团队统计 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ ┌──────────┬──────────┐ │
|
|
|
+│ │ 今日新增 │ 本月新增 │ │
|
|
|
+│ │ 5人 │ 68人 │ │
|
|
|
+│ └──────────┴──────────┘ │
|
|
|
+│ ┌──────────┬──────────┐ │
|
|
|
+│ │ 团队总数 │ 今日佣金 │ │
|
|
|
+│ │ 128人 │ ¥28.00 │ │
|
|
|
+│ └──────────┴──────────┘ │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 层级分布 │
|
|
|
+│ 一级: 45人 | 二级: 38人 │
|
|
|
+│ 三级: 28人 | 四级+: 17人 │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 8.2.2 团队成员列表
|
|
|
+
|
|
|
+```
|
|
|
+筛选条件:
|
|
|
+- 层级: 一级/二级/三级/四级及以上
|
|
|
+- 状态: 全部/活跃/沉默
|
|
|
+- 排序: 加入时间/贡献佣金
|
|
|
+
|
|
|
+成员卡片:
|
|
|
+┌─────────────────────────────────────┐
|
|
|
+│ ┌────┐ 张** │
|
|
|
+│ │头像│ 手机: 138****8888 │
|
|
|
+│ └────┘ 等级: VIP1 │
|
|
|
+│ 加入时间: 2026-01-10 │
|
|
|
+│ 贡献佣金: ¥28.50 │
|
|
|
+└─────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 8.2.3 层级数据来源
|
|
|
+
|
|
|
+| 层级 | 数据来源 | 说明 |
|
|
|
+|-----|---------|------|
|
|
|
+| 一级 | member WHERE p1=当前用户ID | 直接推荐 |
|
|
|
+| 二级 | member WHERE p2=当前用户ID | 二级下线 |
|
|
|
+| 三级 | member WHERE p3=当前用户ID | 三级下线 |
|
|
|
+| 四级+ | member_guanxi WHERE p_id=当前用户ID AND dai>=4 | 四级及以上 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 8.3 团队收益
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/sale`
|
|
|
+
|
|
|
+#### 8.3.1 收益统计
|
|
|
+
|
|
|
+| 统计项 | 计算方式 |
|
|
|
+|-------|---------|
|
|
|
+| 今日返佣 | 今日 sale_list 中的返佣收入 |
|
|
|
+| 本月返佣 | 本月返佣收入汇总 |
|
|
|
+| 累计返佣 | 历史返佣总额 |
|
|
|
+
|
|
|
+#### 8.3.2 返佣规则
|
|
|
+
|
|
|
+```
|
|
|
+当下级完成任务时,上级获得返佣:
|
|
|
+
|
|
|
+一级返佣 = 任务单价 × bfb_1%
|
|
|
+二级返佣 = 任务单价 × bfb_2%
|
|
|
+三级返佣 = 任务单价 × bfb_3%
|
|
|
+四级返佣 = 任务单价 × bfb_4%
|
|
|
+
|
|
|
+特殊规则(如启用等级限制 open_level_rule=1):
|
|
|
+- 推荐人等级 >= 被推荐人等级 才返佣
|
|
|
+- 返佣比例由推荐人的VIP等级决定
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 9. 每日签到
|
|
|
+
|
|
|
+### 9.1 签到页面
|
|
|
+
|
|
|
+**页面路径**:`/Home/Index/dailySign`
|
|
|
+
|
|
|
+#### 9.1.1 页面结构
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 每日签到 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 本月已签到: 5天 / 目标8天 │
|
|
|
+│ ████████░░░░░░░░ 62.5% │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 签到日历 │
|
|
|
+│ ┌───┬───┬───┬───┬───┬───┬───┐ │
|
|
|
+│ │ 一 │ 二 │ 三 │ 四 │ 五 │ 六 │ 日 │ │
|
|
|
+│ ├───┼───┼───┼───┼───┼───┼───┤ │
|
|
|
+│ │ ✓ │ ✓ │ ✓ │ ✓ │ ✓ │ │ │ │
|
|
|
+│ │0.1│0.2│0.4│0.8│1.6│3.2│6.4│ │
|
|
|
+│ └───┴───┴───┴───┴───┴───┴───┘ │
|
|
|
+│ │
|
|
|
+│ 第8天: 12.8元 (累计25.5元) │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 今日奖励: ¥3.20 │
|
|
|
+│ │
|
|
|
+│ [立即签到] │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 9.1.2 签到奖励表
|
|
|
+
|
|
|
+| 天数 | 奖励金额 | 累计奖励 |
|
|
|
+|-----|---------|---------|
|
|
|
+| 第1天 | ¥0.10 | ¥0.10 |
|
|
|
+| 第2天 | ¥0.20 | ¥0.30 |
|
|
|
+| 第3天 | ¥0.40 | ¥0.70 |
|
|
|
+| 第4天 | ¥0.80 | ¥1.50 |
|
|
|
+| 第5天 | ¥1.60 | ¥3.10 |
|
|
|
+| 第6天 | ¥3.20 | ¥6.30 |
|
|
|
+| 第7天 | ¥6.40 | ¥12.70 |
|
|
|
+| 第8天 | ¥12.80 | ¥25.50 |
|
|
|
+
|
|
|
+#### 9.1.3 签到规则
|
|
|
+
|
|
|
+```
|
|
|
+1. 每日只能签到一次
|
|
|
+2. 连续签到奖励递增(8天一个周期)
|
|
|
+3. 中断签到后从第1天重新开始
|
|
|
+4. 本月完成8天即达成月度目标
|
|
|
+5. 签到需通过人机验证
|
|
|
+6. 奖励直接充值到账户余额
|
|
|
+```
|
|
|
+
|
|
|
+### 9.2 签到接口
|
|
|
+
|
|
|
+**接口路径**:`/Home/Index/dailySignHandle`
|
|
|
+
|
|
|
+#### 9.2.1 签到流程
|
|
|
+
|
|
|
+```
|
|
|
+1. 验证用户登录状态
|
|
|
+2. 验证腾讯云人机验证
|
|
|
+3. 检查今日是否已签到
|
|
|
+4. 计算当前签到天数和奖励
|
|
|
+5. 创建签到记录 (member_sign):
|
|
|
+ - member_id: 用户ID
|
|
|
+ - sign_date: 签到日期
|
|
|
+ - sign_day: 连续签到天数
|
|
|
+ - reward_amount: 奖励金额
|
|
|
+ - month: 当前月份
|
|
|
+6. 增加用户余额 (incPrice)
|
|
|
+7. 返回签到成功信息
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 10. 消息通知
|
|
|
+
|
|
|
+### 10.1 消息中心
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/notice`
|
|
|
+
|
|
|
+#### 10.1.1 消息类型
|
|
|
+
|
|
|
+| 类型 | type值 | 说明 |
|
|
|
+|-----|-------|------|
|
|
|
+| 系统通知 | 1 | 系统公告、个人通知 |
|
|
|
+| 新闻资讯 | 2 | 平台新闻 |
|
|
|
+| 公告通知 | 3 | 重要公告 |
|
|
|
+
|
|
|
+#### 10.1.2 消息列表
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ 系统消息 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ ● 您的提现申请已通过 │
|
|
|
+│ 您申请的¥500提现已打款... │
|
|
|
+│ 2026-01-20 15:30 [未读] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ ○ 任务审核通过 │
|
|
|
+│ 您提交的"抖音关注任务"已通过... │
|
|
|
+│ 2026-01-20 10:15 [已读] │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ ○ VIP升级成功 │
|
|
|
+│ 恭喜您成功升级为VIP1会员... │
|
|
|
+│ 2026-01-18 09:00 [已读] │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 10.1.3 消息触发场景
|
|
|
+
|
|
|
+| 场景 | 消息内容 |
|
|
|
+|-----|---------|
|
|
|
+| 任务审核通过 | 您的任务"xxx"已审核通过,奖励¥xx已到账 |
|
|
|
+| 任务审核失败 | 您的任务"xxx"审核未通过,原因: xxx |
|
|
|
+| 提现审核通过 | 您申请的¥xx提现已打款,请查收 |
|
|
|
+| 提现审核拒绝 | 您的提现申请被拒绝,原因: xxx,金额已退回 |
|
|
|
+| 获得返佣 | 您的下级xxx完成任务,您获得返佣¥xx |
|
|
|
+| 新用户注册 | 用户xxx通过您的邀请注册,您获得奖励¥xx |
|
|
|
+| 下级升级VIP | 您的下级xxx升级VIP,您获得返利¥xx |
|
|
|
+| 系统公告 | 【公告】xxx |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 11. 个人设置
|
|
|
+
|
|
|
+### 11.1 个人信息
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/info`
|
|
|
+
|
|
|
+| 信息项 | 字段 | 可否修改 |
|
|
|
+|-------|------|---------|
|
|
|
+| 头像 | avatar | 可修改 |
|
|
|
+| 昵称 | username | 可修改 |
|
|
|
+| 手机号 | phone | 绑定后不可改 |
|
|
|
+| 邮箱 | email | 可修改 |
|
|
|
+| 真实姓名 | idc_name | 填写后不可改 |
|
|
|
+| 身份证号 | idc | 填写后不可改 |
|
|
|
+| 注册时间 | create_time | 不可改 |
|
|
|
+| 会员等级 | level | 付费升级 |
|
|
|
+| 信用积分 | point | 系统计算 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 11.2 编辑信息
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/info_edit`
|
|
|
+
|
|
|
+#### 11.2.1 可编辑字段
|
|
|
+
|
|
|
+| 字段 | 类型 | 验证规则 | 备注 |
|
|
|
+|-----|------|---------|------|
|
|
|
+| 头像 | file | 图片格式 | 上传至OSS |
|
|
|
+| 昵称 | text | 2-20字符 | - |
|
|
|
+| 邮箱 | text | 邮箱格式 | - |
|
|
|
+
|
|
|
+#### 11.2.2 一次性字段(填写后不可修改)
|
|
|
+
|
|
|
+| 字段 | 类型 | 验证规则 | 备注 |
|
|
|
+|-----|------|---------|------|
|
|
|
+| 真实姓名 | text | 2-10汉字 | 提现必填 |
|
|
|
+| 身份证号 | text | 18位身份证 | 提现必填 |
|
|
|
+| 手机号 | text | 11位手机号 | 需短信验证 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 11.3 绑定手机
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/update_mobile`
|
|
|
+
|
|
|
+#### 11.3.1 绑定流程
|
|
|
+
|
|
|
+```
|
|
|
+1. 输入手机号
|
|
|
+2. 获取短信验证码
|
|
|
+3. 输入验证码
|
|
|
+4. 验证通过后绑定
|
|
|
+5. 手机号绑定后不可修改
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 11.4 修改密码
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/password`
|
|
|
+
|
|
|
+#### 11.4.1 修改表单
|
|
|
+
|
|
|
+| 字段 | 类型 | 必填 | 说明 |
|
|
|
+|-----|------|-----|------|
|
|
|
+| 原密码 | password | 是 | 验证身份 |
|
|
|
+| 新密码 | password | 是 | 6-20位 |
|
|
|
+| 确认密码 | password | 是 | 与新密码一致 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 11.5 绑定收款账户
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/info_edit`(payment部分)
|
|
|
+
|
|
|
+#### 11.5.1 支持的收款渠道
|
|
|
+
|
|
|
+| 渠道 | 所需信息 |
|
|
|
+|-----|---------|
|
|
|
+| 支付宝 | 账户名、支付宝账号、收款码 |
|
|
|
+| 银行卡 | 持卡人姓名、银行名称、卡号 |
|
|
|
+| 微信 | 账户名、微信号、收款码 |
|
|
|
+
|
|
|
+#### 11.5.2 绑定规则
|
|
|
+
|
|
|
+```
|
|
|
+1. 至少绑定一个收款账户才能提现
|
|
|
+2. 账户信息绑定后不可修改(安全保护)
|
|
|
+3. 可绑定多个不同类型的账户
|
|
|
+4. 提现时选择其中一个账户
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 11.6 绑定社交账号
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/bdzh`
|
|
|
+
|
|
|
+#### 11.6.1 支持的平台
|
|
|
+
|
|
|
+| 平台 | 字段 | 用途 |
|
|
|
+|-----|------|------|
|
|
|
+| 抖音 | douyin | 验证任务完成 |
|
|
|
+| 快手 | kuaishou | 验证任务完成 |
|
|
|
+| 小红书 | xiaohongshu | 验证任务完成 |
|
|
|
+| 火山 | huoshan | 验证任务完成 |
|
|
|
+| 微信 | weixin | 微信登录 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### 11.7 VIP会员
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/vip`
|
|
|
+
|
|
|
+#### 11.7.1 等级列表
|
|
|
+
|
|
|
+```
|
|
|
+┌────────────────────────────────────┐
|
|
|
+│ VIP会员中心 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ 当前等级: 普通用户 │
|
|
|
+│ 信用积分: 100分 │
|
|
|
+├────────────────────────────────────┤
|
|
|
+│ VIP等级权益 │
|
|
|
+│ ┌────────────────────────────┐ │
|
|
|
+│ │ VIP1 ¥99 │ │
|
|
|
+│ │ 一级返佣: 12% 二级: 8% │ │
|
|
|
+│ │ 三级: 5% 四级+: 2% │ │
|
|
|
+│ │ [立即升级] │ │
|
|
|
+│ └────────────────────────────┘ │
|
|
|
+│ ┌────────────────────────────┐ │
|
|
|
+│ │ VIP2 ¥299 │ │
|
|
|
+│ │ 一级返佣: 15% 二级: 10% │ │
|
|
|
+│ │ 三级: 6% 四级+: 3% │ │
|
|
|
+│ │ [立即升级] │ │
|
|
|
+│ └────────────────────────────┘ │
|
|
|
+└────────────────────────────────────┘
|
|
|
+```
|
|
|
+
|
|
|
+#### 11.7.2 升级流程
|
|
|
+
|
|
|
+**页面路径**:`/Home/Member/pay`
|
|
|
+
|
|
|
+```
|
|
|
+1. 选择VIP等级
|
|
|
+2. 确认升级价格
|
|
|
+3. 选择支付方式
|
|
|
+4. 完成支付
|
|
|
+5. 等级即时生效
|
|
|
+6. 触发推荐人返利
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 12. 页面路由汇总
|
|
|
+
|
|
|
+### 12.1 公共页面(无需登录)
|
|
|
+
|
|
|
+| 页面 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 首页 | `/Home/Index/index` | 任务大厅 |
|
|
|
+| 登录 | `/Home/Public/login` | 用户登录 |
|
|
|
+| 注册 | `/Home/Public/reg` | 用户注册 |
|
|
|
+| 忘记密码 | `/Home/Public/forget_pwd` | 重置密码 |
|
|
|
+| 任务列表 | `/Home/Task/lists` | 任务浏览 |
|
|
|
+| 任务详情 | `/Home/Task/show` | 任务详情 |
|
|
|
+| 搜索 | `/Home/Index/serach` | 任务搜索 |
|
|
|
+| 关于我们 | `/Home/Index/about` | 关于页面 |
|
|
|
+
|
|
|
+### 12.2 素材相关
|
|
|
+
|
|
|
+| 页面 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 素材中心 | `/Home/Material/index` | 素材列表 |
|
|
|
+| 素材列表接口 | `/Home/Material/getList` | 素材AJAX接口 |
|
|
|
+| 素材详情 | `/Home/Task/materialDetail` | 素材详情页 |
|
|
|
+
|
|
|
+### 12.3 用户中心(需登录)
|
|
|
+
|
|
|
+| 页面 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 用户中心 | `/Home/Member/index` | 个人首页 |
|
|
|
+| 个人信息 | `/Home/Member/info` | 信息查看 |
|
|
|
+| 编辑信息 | `/Home/Member/info_edit` | 信息编辑 |
|
|
|
+| 修改密码 | `/Home/Member/password` | 密码修改 |
|
|
|
+| 绑定手机 | `/Home/Member/update_mobile` | 手机绑定 |
|
|
|
+
|
|
|
+### 12.4 任务相关(需登录)
|
|
|
+
|
|
|
+| 页面 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 我的任务 | `/Home/Member/apply` | 申请列表 |
|
|
|
+| 任务详情 | `/Home/Member/apply_show` | 申请详情 |
|
|
|
+| 已完成任务 | `/Home/Member/apply_finish` | 完成列表 |
|
|
|
+| 提交任务 | `/Home/Task/submission_task` | 任务提交 |
|
|
|
+
|
|
|
+### 12.5 财务相关(需登录)
|
|
|
+
|
|
|
+| 页面 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 账户余额 | `/Home/Member/balance` | 余额查看 |
|
|
|
+| 提现 | `/Home/Member/tixian` | 申请提现 |
|
|
|
+| 提现记录 | `/Home/Member/tixian_log` | 提现历史 |
|
|
|
+| 收益账单 | `/Home/Member/bill` | 收益明细 |
|
|
|
+| 交易记录 | `/Home/Member/records` | 交易流水 |
|
|
|
+
|
|
|
+### 12.6 团队相关(需登录)
|
|
|
+
|
|
|
+| 页面 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 邀请好友 | `/Home/Member/qrcode` | 推广二维码 |
|
|
|
+| 我的团队 | `/Home/Member/team` | 团队成员 |
|
|
|
+| 团队收益 | `/Home/Member/sale` | 返佣统计 |
|
|
|
+
|
|
|
+### 12.7 其他功能(需登录)
|
|
|
+
|
|
|
+| 页面 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 每日签到 | `/Home/Index/dailySign` | 签到页面 |
|
|
|
+| 消息中心 | `/Home/Member/notice` | 系统消息 |
|
|
|
+| VIP会员 | `/Home/Member/vip` | 等级信息 |
|
|
|
+| VIP升级 | `/Home/Member/pay` | 升级支付 |
|
|
|
+| 排行榜 | `/Home/Member/leaderboard` | 收益排行 |
|
|
|
+
|
|
|
+### 12.8 API接口
|
|
|
+
|
|
|
+| 接口 | 路由 | 说明 |
|
|
|
+|-----|------|------|
|
|
|
+| 签到处理 | `/Home/Index/dailySignHandle` | 签到AJAX |
|
|
|
+| 获取任务列表 | `/Home/Task/getTaskList` | 任务AJAX |
|
|
|
+| 领取任务 | `/Home/Task/get_task` | 领取AJAX |
|
|
|
+| 放弃任务 | `/Home/Task/abandon` | 放弃AJAX |
|
|
|
+| 提交任务 | `/Home/Task/submission_task_do` | 提交AJAX |
|
|
|
+| 发送验证码 | `/Home/Public/getcode` | 短信AJAX |
|
|
|
+| 排行榜数据 | `/Home/Member/paihang` | 排行AJAX |
|
|
|
+| 素材列表 | `/Home/Material/getList` | 素材AJAX |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 附录
|
|
|
+
|
|
|
+### A. 状态码对照表
|
|
|
+
|
|
|
+#### 任务申请状态 (task_apply.status)
|
|
|
+
|
|
|
+| 值 | 状态 | 说明 |
|
|
|
+|---|------|------|
|
|
|
+| -2 | 已放弃 | 用户主动放弃 |
|
|
|
+| -1 | 审核失败 | 审核员拒绝 |
|
|
|
+| 0 | 未完成 | 已领取待提交 |
|
|
|
+| 1 | 待审核 | 已提交等待审核 |
|
|
|
+| 2 | 已完成 | 审核通过 |
|
|
|
+
|
|
|
+#### 提现状态 (member_tixian.status)
|
|
|
+
|
|
|
+| 值 | 状态 | 说明 |
|
|
|
+|---|------|------|
|
|
|
+| -1 | 已拒绝 | 审核拒绝,已退款 |
|
|
|
+| 0 | 待审核 | 等待管理员审核 |
|
|
|
+| 1 | 已通过 | 审核通过,已打款 |
|
|
|
+
|
|
|
+#### 用户状态 (member.user_status)
|
|
|
+
|
|
|
+| 值 | 状态 | 说明 |
|
|
|
+|---|------|------|
|
|
|
+| 1 | 正常 | 账户正常 |
|
|
|
+| 2 | 禁用 | 账户被禁用 |
|
|
|
+
|
|
|
+#### 资金变动类型 (member_price_log.type)
|
|
|
+
|
|
|
+| 值 | 类型 | 说明 |
|
|
|
+|---|------|------|
|
|
|
+| 1 | 任务收入 | 完成任务获得 |
|
|
|
+| 2 | 返佣收入 | 下级任务返佣 |
|
|
|
+| 3 | 推荐奖励 | VIP返利 |
|
|
|
+| 4 | 直推奖励 | 注册奖励 |
|
|
|
+| 99 | 提现退回 | 提现失败退款 |
|
|
|
+| 100 | 提现扣款 | 提现扣除 |
|
|
|
+
|
|
|
+#### 素材状态码
|
|
|
+
|
|
|
+| 值 | 说明 |
|
|
|
+|---|------|
|
|
|
+| is_material=1 | 标记为素材(非任务) |
|
|
|
+| apply_code=99 | 素材专用状态码 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### B. 配置项说明
|
|
|
+
|
|
|
+| 配置项 | 说明 | 获取方式 |
|
|
|
+|-------|------|---------|
|
|
|
+| bfb_1 | 一级返佣比例(%) | sp_cfg('bfb_1') |
|
|
|
+| bfb_2 | 二级返佣比例(%) | sp_cfg('bfb_2') |
|
|
|
+| bfb_3 | 三级返佣比例(%) | sp_cfg('bfb_3') |
|
|
|
+| bfb_4 | 四级返佣比例(%) | sp_cfg('bfb_4') |
|
|
|
+| is_share_bonus | 启用直推奖励 | sp_cfg('is_share_bonus') |
|
|
|
+| xshare_bonus | 直推奖励金额 | sp_cfg('xshare_bonus') |
|
|
|
+| charge | 提现手续费(%) | sp_cfg('charge') |
|
|
|
+| reg_point | 注册赠送积分 | 从point_set表 |
|
|
|
+| open_level_rule | 启用等级返佣限制 | sp_cfg('open_level_rule') |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+### C. 数据表速查
|
|
|
+
|
|
|
+| 表名 | 用途 |
|
|
|
+|-----|------|
|
|
|
+| dt_member | 用户信息 |
|
|
|
+| dt_member_guanxi | 推荐关系(4级+) |
|
|
|
+| dt_member_sign | 签到记录 |
|
|
|
+| dt_member_price_log | 资金变动 |
|
|
|
+| dt_member_tixian | 提现记录 |
|
|
|
+| dt_member_payment | 收款账户 |
|
|
|
+| dt_task | 任务信息 |
|
|
|
+| dt_task_apply | 任务申请 |
|
|
|
+| dt_task_material | 素材管理 |
|
|
|
+| dt_sale_list | 收益记录 |
|
|
|
+| dt_notice | 系统消息 |
|
|
|
+| dt_level | VIP等级 |
|
|
|
+| dt_category | 任务分类 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+*文档更新时间:2026-01-23*
|