# 商城会员分销返利及代理制度项目功能详解

## 一、项目概述

本项目是一个商城会员分销返利及代理制度系统，包含前端用户端和管理后台两个部分。系统核心功能围绕会员制度展开，包含合伙人制度、区域代理制度和排队返现机制三大核心模块。

---

## 二、核心功能模块

### 1. 用户系统

**用户注册与登录**：支持手机号注册，用户信息包含：

- 基础信息：手机号、昵称、密码

- 账户信息：余额（balance）、佣金余额（commission_balance）、积分（points）

- 身份标识：推荐人ID（referrer_id）

### 2. 商品与订单

- **商品展示**：商品列表、商品详情、商品购买

- **订单管理**：下单、订单列表、订单详情、确认收货、售后申请

### 3. 资产管理

- **余额充值**：通过激活码充值

- **佣金提现**：满100元可申请提现，需上传微信收款码

- **积分与抵扣券**：积分获取与使用、抵扣券管理

### 4. 收货地址

支持地址的增删改查，可设置默认地址

---

## 三、会员制度详解

### （一）合伙人制度

#### 1. 合伙人等级体系

用户通过 `partner_level` 字段标识合伙人等级，等级大于0即为合伙人：

- **等级1**：初级合伙人

- **等级2**：中级合伙人

- **等级3**：高级合伙人

- **等级4**：金牌合伙人

等级越高，享受的奖励比例越高。

#### 2. 合伙人奖励机制

**奖励类型**：

| 奖励类型 | 说明 | 计算方式 |

|---------|------|---------|

| **直推奖励** | 直接推荐用户消费获得 | 消费金额 × 直推奖励比例（默认10%） |

| **团队奖励** | 团队成员消费获得 | 根据团队业绩计算 |

| **合伙人返利** | 下级合伙人团队业绩提成 | 根据等级差计算 |

**返利计算逻辑**（PartnerController.js:6-62）：

1. 用户下单后，系统检查下单用户是否为合伙人

2. 若下单用户不是合伙人，向上遍历其推荐链

3. 找到等级高于当前等级的合伙人，根据配置参数发放奖励

4. 继续向上遍历，直到没有更高等级的合伙人

**数据库表**：

- `partner_reward`：记录合伙人返利明细

- `commission_log`：记录佣金变动日志

**配置参数**：

- `partner_v1_reward`：一级合伙人返利金额

- `partner_v2_reward`：二级合伙人返利金额

- `partner_v3_reward`：三级合伙人返利金额

- `partner_v4_reward`：四级合伙人返利金额

#### 3. 团队管理

合伙人可查看自己的团队成员（PartnerController.js:64-77）：

- 直接推荐的成员（一级团队）

- 间接推荐的成员（二级团队）

---

### （二）区域代理制度

#### 1. 代理等级体系

用户通过 `agent_level` 字段标识代理等级：

- **等级1**：区县代理（agent_level = 1）

- **等级2**：市级代理（agent_level = 2）

- **等级3**：省级代理（agent_level = 3）

代理通过 `agent_area` 字段标识负责区域。

#### 2. 代理补贴机制

**补贴计算逻辑**（AgentController.js:6-102）：

根据订单收货地址匹配对应区域代理，按等级比例发放补贴：

| 代理等级 | 补贴比例 | 说明 |

|---------|---------|------|

| 省代（3级） | 3% | 订单金额的3% |

| 市代（2级） | 2% | 订单金额的2% |

| 区县代（1级） | 1% | 订单金额的1% |

**补贴发放规则**：

- **同时存在多级代理**：高等级代理获得差额部分

  - 例：订单金额100元，同时有省代、市代、区县代

  - 区县代：100 × 1% = 1元

  - 市代：100 × （2% - 1%） = 1元

  - 省代：100 × （3% - 2%） = 1元

- **只存在部分等级代理**：直接按该等级比例发放

  - 例：只有省代，无市代和区县代

  - 省代：100 × 3% = 3元

**数据库表**：

- `agent_subsidy`：记录代理补贴明细

**配置参数**：

- `agent_province_ratio`：省代比例（默认3）

- `agent_city_ratio`：市代比例（默认2）

- `agent_district_ratio`：区县代比例（默认1）

#### 3. 代理推荐奖励

**推荐奖励逻辑**（AgentController.js:146-178）：

- 推荐他人成为代理，被推荐代理产生订单时获得推荐奖励

- 奖励金额：固定金额（默认2元/单）

**数据库表**：

- `agent_referral`：记录代理推荐关系

- `agent_referral_reward`：记录代理推荐奖励明细

---

### （三）排队返现机制

#### 1. 排队规则

- 用户消费后自动进入排队队列

- 排队顺序按照消费时间先后

- 系统按顺序为排队用户发放返现

#### 2. 加速功能

用户可消耗积分或余额加速排队进度，提前获得返现。

#### 3. 返现规则

- 返现金额根据订单金额计算

- 返现直接计入用户余额

---

## 四、财务体系

### 1. 账户类型

| 账户类型 | 用途 | 来源 |

|---------|------|------|

| **余额（balance）** | 购物消费、充值 | 激活码充值、排队返现 |

| **佣金余额（commission_balance）** | 提现 | 合伙人返利、代理补贴、推荐奖励 |

| **积分（points）** | 兑换、加速 | 消费赠送、活动奖励 |

### 2. 提现规则

- 佣金余额满100元可申请提现

- 提现需上传微信收款码

- 提现申请需后台审核

---

## 五、管理后台功能

### 1. 数据统计

- 会员总数、订单总数、订单总金额

- 待审核提现数量

- 合伙人数量、代理数量

- 团队业绩统计

- 佣金分配统计

### 2. 风1控预警

监控异常行为：

- 异常退款

- 异常提现

- 疑似刷1单

- 抵扣券滥用

### 3. 系统管理

- 商品管理

- 用户管理

- 订单管理

- 提现审核

- 配置参数管理

---

## 六、核心数据流程

```

用户注册 → 充值激活 → 消费购物 → 进入排队 → 获得返现

         ↓

      成为合伙人/代理 → 推荐用户 → 获得奖励

                           ↓

                        团队消费 → 获得返利/补贴

```

---

## 七、总结

本项目是一个完整的会员分销返利及代理制度系统，核心特点：

1. **双轨制会员体系**：合伙人制度（按推荐链）+ 区域代理制度（按地域）

2. **多级奖励机制**：直推奖励、团队奖励、代理补贴、推荐奖励

3. **排队返现模式**：消费后排队获得返现，支持加速

4. **完善的财务管理**：余额、佣金、积分三账分离

5. **风1控预警系统**：实时监控异常行为

系统通过数据库配置参数实现奖励规则的灵活调整，无需修改代码即可调整返利比例、补贴比例等核心参数。

---

### **主标题（全面型）**

**商城会员分销返利系统源码 | 合伙人代理+排队返现**

### **技术导向型标题**

**Vue3商城分销系统源码 | 会员返利+代理制度**

### **功能导向型标题**

**会员分销返利系统源码下载 | 合伙人制度+区域代理+排队返现 | Vue3全栈**

### **商业价值型标题**

**多级分销商城源码 | 会员返利系统 | 合伙人代理制度 | Vue3完整解决方案**

### **精准搜索型标题**

**商城分销返利系统源码 | 排队返现机制 | 合伙人等级制度 | Vue3前后端分离**

---

### **标题优化说明**

**核心关键词覆盖：**

- 商城、会员、分销、返利、源码

- 合伙人、代理、排队返现（特色功能）

**SEO优化策略：**

1. **前置核心词**：将"商城"、"分销"、"源码"等核心词前置

2. **技术栈标注**：明确技术栈便于开发者搜索

3. **功能差异化**：突出"合伙人制度"、"排队返现"等独特功能

4. **符号分隔**：使用"|"分隔关键词，提高可读性和搜索匹配度

5. **长尾关键词**：覆盖"前后端分离"、"完整解决方案"等长尾搜索词

**推荐选择：**

- 对外推广首1选 **"商城会员分销返利系统源码 | Vue3+MySQL | 合伙人代理+排队返现"**

- 技术社区推广首1选 **"Vue3商城分销系统源码 | MySQL数据库 | 会员返利+代理制度"**

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