## 项目概述

轻量化H5广告返现平台，旨在为广告主提供精准投放渠道，同时为用户提供通过观看广告获取金币、参与返现的机会。平台集成了完整的广告管理、金币系统、返现机制和佣金体系。

## 主要功能模块

### 1. 用户系统

- **注册登录**：支持手机号注册和密码登录

- **用户中心**：展示个人资产、等级信息和推广数据

- **等级体系**：分为个人代理和创客工作室两个等级

- **推荐机制**：支持用户间相互推荐，获得推荐佣金

### 2. 广告系统

- **广告投放**：广告主可使用激活码投放广告

- **广告审核**：后台人工审核广告内容，确保合规性

- **广告展示**：用户可浏览和点击广告，获取金币奖励

- **数据统计**：记录广告曝光量和点击量，为广告主提供数据参考

### 3. 金币系统

- **金币获取**：用户观看广告可获得固定金币奖励（后台设置）

- **金币兑换**：使用金币兑换源码资源

- **金币记录**：详细记录金币收支明细

- **金币余额**：实时展示用户金币余额

### 4. 返现系统

- **返现池**：广告投放金额的一部分进入返现池

- **返现队列**：用户按顺序获得返现

- **返现记录**：记录用户返现历史

- **提现申请**：用户可申请提现返现余额

### 5. 佣金系统

- **直推佣金**：推荐新用户获得直推佣金

- **二级佣金**：创客工作室可获得二级培育佣金

- **等级佣金**：平级Y久奖机制

- **佣金记录**：详细记录佣金收支明细

### 6. 后台管理

- **激活码管理**：生成、查看和管理激活码

- **广告审核**：审核广告投放申请

- **金币兑换审核**：审核用户金币兑换申请

- **提现审核**：审核用户提现申请

- **系统设置**：配置返现比例、佣金比例等系统参数

### 数据库设计

- **用户表**：存储用户信息和余额

- **广告表**：存储广告内容和状态

- **激活码表**：存储激活码信息

- **返现队列表**：记录用户返现排队情况

- **金币记录表**：记录金币收支

- **佣金记录表**：记录佣金收支

- **系统设置表**：存储系统配置参数

## 核心流程

### 1. 广告投放流程

1. 广告主购买激活码

2. 填写广告内容并提交

3. 后台审核广告

4. 审核通过后广告上线

5. 广告金额按比例分配到返现池、佣金池和运营池

### 2. 广告观看流程

1. 用户浏览广告列表

2. 点击广告进入详情页

3. 观看倒计时完成

4. 系统自动发放金币奖励

5. 记录广告点击量和曝光量

### 3. 返现流程

1. 广告投放成功后进入返现队列

2. 系统按顺序处理返现

3. 返现金额自动进入用户余额

4. 用户可申请提现

### 4. 佣金发放流程

1. 新用户通过推荐链接注册

2. 推荐人获得直推佣金

3. 二级推荐人（创客工作室）获得二级佣金

4. 上级创客工作室获得等级佣金

5. 佣金自动进入用户余额

## 特色功能

### 1. 自定义弹窗系统

- 替代原生浏览器弹窗，提供统一的视觉体验

- 支持消息提示和确认对话框

- 响应式设计，适配不同设备

### 2. 热重载功能

- 前端使用Vite热模块替换，修改代码实时生效

- 后端使用Nodemon，代码修改自动重启服务

- 提高开发效率，无需手动刷新页面

### 3. 资金拆分机制

- 广告投放金额自动按比例拆分

- 透明的资金流向，确保平台可持续运营

- 后台可灵活调整拆分比例

### 5. 源码兑换系统

- 用户可使用金币兑换各类源码资源

- 后台审核兑换申请

- 提供下载链接和提取码

## 项目价值

1. **广告主价值**：提供精准的广告投放渠道，获得真实有效的曝光和点击

2. **用户价值**：通过观看广告获得金币和返现，实现"看广告赚钱"

3. **推广价值**：通过推荐机制，鼓励用户分享平台，实现裂变增长

4. **平台价值**：通过运营池积累资金，支持平台持续发展和功能升级

该项目实现了广告投放、用户激励和平台运营的良性循环，为广告行业提供了一种新的商业模式。

[hr]

# 轻量化H5广告返现平台核心制度修正详解

## 一、资金分配制度

### 1. 实际分配比例（基于代码）

根据`db_init.sql`文件中的系统设置，实际分配比例为：

- **返现比例**：30%

- **佣金比例**：25%

- **运营比例**：45%

### 2. 分配机制

- **触发条件**：广告审核通过后

- **分配方式**：系统自动计算并分配到对应资金池

- **分配依据**：广告投放金额 × 对应比例

## 二、返现制度修正

### 1. 返现对象

- **正确对象**：广告主（而非所有观看广告的用户）

- **返现原因**：广告主投放广告后，按顺序获得返现

### 2. 返现流程

1. 广告主使用激活码投放广告

2. 广告审核通过后，系统自动将广告主添加到返现队列

3. 系统按顺序处理返现（FIFO原则）

4. 返现金额 = 广告投放金额 × 返现比例

5. 返现金额直接进入广告主的返现余额

### 3. 返现队列管理

- **队列顺序**：按广告投放时间排序

- **队列状态**：显示等待中/已完成

- **返现检查**：系统定期检查并处理返现队列

## 三、佣金制度修正

### 1. 佣金来源

- **正确来源**：广告投放金额的佣金部分

- **计算基数**：广告投放金额 × 佣金比例

### 2. 佣金发放条件

- **触发条件**：新用户通过推荐链接注册并成功投放广告

- **发放时机**：广告审核通过后，资金分配完成

- **发放顺序**：直推佣金 → 二级佣金 → 等级佣金

### 3. 佣金上限控制

- **Z大佣金比例**：28%（总佣金不超过广告金额的28%）

- **计算逻辑**：如果直推+二级+等级佣金总和超过上限，只发放Z大限额

## 四、金币制度修正

### 1. 金币获取方式

- **正确方式**：用户观看广告获得固定金币（后台设置）

- **获取条件**：观看广告倒计时完成

- **金币数量**：固定10金币/广告（可通过后台修改）

### 2. 金币用途

- **源码兑换**：使用金币兑换平台提供的源码资源

- **未来扩展**：可用于游戏、C奖等功能

## 五、激活码制度修正

### 1. 激活码功能

- **正确功能**：作为广告投放的支付凭证

- **金额对应**：激活码金额 = 广告投放金额

- **使用限制**：每个激活码只能使用一次

### 2. 激活码管理

- **生成方式**：后台批量生成

- **状态管理**：未使用/已使用

- **使用记录**：记录使用者和使用时间

## 六、核心制度逻辑图

```

┌─────────────────┐

│ 广告主投放广告  │

└────────┬────────┘

         │

         ▼

┌─────────────────┐

│ 后台审核广告    │

└────────┬────────┘

         │

         ▼

┌─────────────────┐

│ 资金自动分配    │

└────────┬────────┘

         │

         ▼

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐

│ 返现池 （30%）   │     │ 佣金池 （25%）   │     │ 运营池 （45%）   │

└────────┬────────┘     └────────┬────────┘     └─────────────────┘

         │                      │

         ▼                      ▼

┌─────────────────┐     ┌─────────────────┐

│ 广告主排队返现  │     │ 推荐人佣金发放  │

└─────────────────┘     └─────────────────┘

```

## 七、制度核心优势

### 1. 商业模式创新

- **广告主获益**：投放广告获得返现，降低广告成本

- **用户获益**：观看广告获得金币，兑换源码资源

- **推荐人获益**：推广平台获得佣金，多劳多得

- **平台获益**：运营池确保长期发展

### 2. 技术实现保障

- **自动化**：全程系统自动处理，无人工干预

- **透明化**：所有数据公开透明，可随时查看

- **安全化**：SQL事务确保资金分配安全可靠

- **可配置**：后台可调整各项比例和参数

### 3. 风险控制机制

- **佣金上限**：防止佣金过高影响平台稳定

- **审核机制**：确保广告内容合规

- **资金池管理**：确保各池资金充足，避免透支

## 八、关键代码验证

### 1. 资金分配代码（`ads.js`）

// 计算资金拆分

// 更新资金池

### 2. 返现队列代码（`ads.js`）

// 添加到返现队列

### 3. 佣金计算代码（`ads.js`）

// 计算直推佣金

// 计算二级培育佣金

  // 计算二级培育佣金

// 计算平级Y久奖

  // 计算平级Y久奖

### 4. 系统设置代码（`db_init.sql`）

-- 初始化系统设置

## 九、制度实施要点

1. **广告主参与流程**：

   - 注册账号 → 购买激活码 → 投放广告 → 等待审核 → 进入返现队列 → 获得返现

2. **用户参与流程**：

   - 注册账号 → 观看广告 → 获得金币 → 兑换源码

3. **推荐人参与流程**：

   - 分享推荐链接 → 新用户注册 → 新用户投放广告 → 获得佣金

通过以上修正，核心制度更加清晰准确，符合项目的实际设计和代码实现。

定制看需求，一般几小时内完成，也不贵。