# AffiliatePro - 联盟营销管理系统 (Affiliate Management System)
## 项目概述
**AffiliatePro** 是一个功能全面的联盟营销管理系统 (Affiliate Marketing Management System)，采用 SaaS 模式，支持多租户。系统提供完整的联盟营销功能，包括联盟会员管理、佣金追踪、支付处理、商店集成等。版本 14.0.0.0 是最新版本，包含移动应用支持。
- **项目类型**: Web应用 + 移动应用 (SaaS平台)
- **版本**: 14.0.0.0 (2026年2月发布)
- **架构**: SaaS多租户 + 多用户角色
- **支持平台**: Web (PHP) + Mobile (Flutter)
---
## 技术栈
### Web后端
- **框架**: CodeIgniter 3.x (PHP)
- **语言**: PHP 7.x/8.x
- **数据库**: MySQL
- **架构**: MVC (Model-View-Controller)
### 移动端
- **框架**: Flutter (Dart)
- **SDK版本**: >=2.19.4 <3.0.0
- **状态管理**: GetX (^4.6.5)
- **网络请求**: Dio (^5.1.1)
- **本地存储**: Shared Preferences (^2.2.2)
### 前端技术
- **模板引擎**: 原生PHP视图
- **CSS框架**: Bootstrap 5
- **JavaScript**: jQuery, AJAX
- **图表**: 多种图表库
### 第三方集成
- **支付网关**: 多种支付方式支持
- **API**: RESTful API (JWT认证)
- **视频平台**: YouTube, Vimeo, Dailymotion, Aparat, Rutube
---
## 模块结构
### 1. 核心应用目录 (application/)
```
application/
├── config/ # 配置文件
├── controllers/ # 控制器
│ ├── Admin/ # 管理员控制器
│ ├── User/ # 用户控制器
│ ├── Api/ # API控制器
│ └── ...
├── models/ # 数据模型
│ ├── Admin_model.php
│ ├── User_model.php
│ ├── Order_model.php
│ ├── Commision_model.php
│ ├── Coupon_model.php
│ └── ...
├── views/ # 视图模板
│ ├── admin/ # 管理员界面
│ ├── user/ # 用户界面
│ ├── themes/ # 前端主题
│ └── ...
├── libraries/ # 自定义类库
├── helpers/ # 辅助函数
├── language/ # 多语言文件
├── hooks/ # 钩子
├── third_party/ # 第三方库
└── ...
```
### 2. 系统核心 (system/)
- CodeIgniter 框架核心文件
- 数据库驱动
- 辅助函数库
- 安全类库
### 3. 资源文件 (assets/)
- CSS样式文件
- JavaScript脚本
- 图片资源
- 字体文件
### 4. 移动端 (Mobile/)
```
Mobile/
├── android/ # Android平台文件
├── ios/ # iOS平台文件
├── lib/ # Dart源代码
│ ├── components/ # UI组件
│ ├── config/ # 配置文件
│ ├── controller/ # 控制器
│ ├── model/ # 数据模型
│ ├── service/ # 服务层
│ ├── utils/ # 工具类
│ ├── view/ # 视图页面
│ └── main.dart # 入口文件
├── assets/ # 静态资源
│ ├── images/ # 图片
│ ├── fonts/ # 字体
│ └── config.json # API配置
└── pubspec.yaml # Flutter依赖配置
```
---
## 核心业务逻辑
### 1. 用户角色系统
#### 管理员 (Admin)
- 系统配置管理
- 用户管理
- 佣金设置
- 支付审批
- 报表查看
- 主题管理
#### 联盟会员 (Affiliate)
- 推广链接生成
- 佣金追踪
- 提现申请
- 推广工具使用
- 下线管理
- 业绩查看
#### 供应商/商家 (Vendor)
- 产品管理
- 订单管理
- 佣金设置
- 销售统计
- 推广活动创建
#### 普通用户 (Customer)
- 浏览商店
- 下单购买
- 查看订单
- 申请成为联盟会员
### 2. 联盟营销流程
```
1. 商家创建推广活动
↓
2. 联盟会员获取推广链接/代码
↓
3. 联盟会员推广产品/服务
↓
4. 客户点击推广链接并购买
↓
5. 系统追踪订单来源
↓
6. 计算并记录佣金
↓
7. 联盟会员申请提现
↓
8. 管理员审核并支付
```
### 3. 佣金计算逻辑
#### 佣金类型
- **按销售提成 (CPS)**: 按销售额百分比
- **按点击付费 (CPC)**: 按点击次数
- **按展示付费 (CPM)**: 按展示次数
- **终身佣金**: 客户后续购买也产生佣金
#### 佣金层级
- **一级佣金**: 直接推荐
- **多级佣金**: 下线推荐 (支持多级分销)
### 4. 推广工具系统
#### 工具类型
- **推广链接**: 自定义推广URL
- **横幅广告**: 各种尺寸Banner
- **视频广告**: 支持多平台视频
- **优惠券**: 折扣码推广
- **二维码**: 扫码推广
- **社交媒体**: 社交分享工具
### 5. 支付系统
#### 支付方式
- **PayPal**: PayPal支付
- **银行转账**: 手动银行转账
- **加密货币**: 多种加密货币支持
- **第三方支付**: 集成多种支付网关
#### 提现流程
1. 联盟会员提交提现申请
2. 系统验证提现条件
3. 管理员审核
4. 执行支付
5. 记录交易
### 6. 商店系统
... (content truncated)
