# rebate-server

**Repository Path**: TPSHION/rebate-server

## Basic Information

- **Project Name**: rebate-server
- **Description**: CPS项目、返利服务端
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Rebate Server

返利服务器是一个基于 Spring Boot 的电商返利平台后端服务，支持多平台商品解析、购物监控、优惠券链接转换等功能。

## 项目简介

本项目是一个返利服务后端系统，主要提供以下核心功能：

- **用户认证**：支持短信验证码登录和密码登录
- **商品解析**：支持淘宝、京东、拼多多、唯品会等主流电商平台的商品链接解析
- **购物监控**：用户可以添加商品监控，当价格达到目标值时发送通知
- **优惠券链接**：支持将商品链接转换为带返利的推广链接

## 技术栈

- **框架**：Spring Boot 4.x
- **数据库**：MySQL + MyBatis Plus
- **缓存**：Redis
- **任务调度**：Spring Async
- **API 集成**：大淘客 (DTK)、好单库 (HDK)

## 项目结构

```
cn.tpshion.rebate
├── client/              # 外部 API 客户端
│   ├── DtkClient       # 大淘客 API 客户端
│   └── HdkClient       # 好单库 API 客户端
├── common/             # 公共组件
│   ├── R              # 统一响应结构
│   ├── ResultCodeEnum # 结果码枚举
│   ├── AuthInterceptor # 认证拦截器
│   └── GlobalExceptionHandler # 全局异常处理
├── config/             # 配置类
├── controller/         # 控制器
│   ├── AuthController # 认证控制器
│   ├── HdkController  # 好单库控制器
│   └── UserController # 用户控制器
├── domain/             # 领域模型
│   ├── dto/           # 数据传输对象
│   ├── entity/        # 实体类
│   └── vo/            # 视图对象
├── handler/           # 业务处理器
│   ├── auth/         # 认证处理器
│   └── transfer/     # 链接转换处理器
├── mapper/            # MyBatis Mapper 接口
├── service/          # 业务服务接口
│   └── impl/         # 服务实现
└── utils/            # 工具类
```

## 快速开始

### 环境要求

- JDK 25
- Maven 3.9+
- MySQL 8.0+
- Redis 7.0+

### 配置说明

在 `src/main/resources/application.yaml` 中配置数据库、Redis 等基本信息：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/rebate
    username: root
    password: your_password
  redis:
    host: localhost
    port: 6379

# 大淘客配置
dtk:
  appKey: your_app_key
  appSecret: your_app_secret
  url: https://api.dataoke.com

# 好单库配置
hdk:
  appId: your_app_id
  appSecret: your_app_secret
  apiKey: your_api_key
  pid: your_pid
  tbName: your_tb_name

# 阿里云配置（短信服务）
aliyun:
  accessKey: your_access_key
  accessSecret: your_access_secret
```

### 构建运行

```bash
# 打包项目
./mvnw clean package

# 运行项目
java -jar target/rebate-server.jar
```

## API 接口

### 认证模块

| 接口 | 方法 | 描述 |
|------|------|------|
| `/auth/login` | POST | 用户登录 |
| `/auth/sendCode` | POST | 发送短信验证码 |
| `/auth/logout` | POST | 用户登出 |
| `/auth/unRegister` | POST | 用户注销 |

### 用户模块

| 接口 | 方法 | 描述 |
|------|------|------|
| `/user/info` | GET | 获取用户信息 |

### 商品模块

| 接口 | 方法 | 描述 |
|------|------|------|
| `/hdk/parse` | POST | 解析商品链接 |
| `/hdk/historyPage` | POST | 商品历史记录 |
| `/hdk/addWatchGoods` | POST | 添加监控商品 |
| `/hdk/watchGoodsPage` | POST | 监控商品列表 |
| `/hdk/deleteWatchGoods` | POST | 删除监控商品 |
| `/hdk/transferUrl` | POST | 转换推广链接 |
| `/hdk/search` | POST | 搜索商品 |

## 核心功能说明

### 1. 商品解析

支持解析以下平台的商品链接：
- 淘宝/天猫
- 京东
- 拼多多
- 唯品会

解析后返回商品详细信息，包括：
- 商品标题、价格
- 优惠券信息
- 预估佣金比例

### 2. 购物监控

用户可以添加商品到监控列表，设置目标价格，系统会定期检查价格变化。

### 3. 链接转换

支持将商品普通链接转换为带有返利追踪参数的推广链接，目前支持：
- 淘宝/天猫
- 京东

## 许可证

本项目基于 LICENSE 文件中的许可证发布。