# shear_wool

**Repository Path**: ymb95/shear-wool

## Basic Information

- **Project Name**: shear_wool
- **Description**: 羊毛管家后台管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-17
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 羊毛管家

羊毛管家 - CPS优惠券聚合与推广平台

## 技术栈

- **Java**: JDK 21
- **Spring Boot**: 3.2.0
- **ORM**: MyBatis Plus 3.5.5
- **数据库**: MySQL 5.7
- **构建工具**: Maven
- **爬虫**: Jsoup 1.17.1
- **支付**: Alipay Easy SDK 4.9.3

## 快速开始

### 环境要求

- JDK 21
- MySQL 5.7+
- Maven 3.6+

### 数据库初始化

1. 登录MySQL:
```bash
mysql -u root -p
```

2. 执行数据库初始化脚本:
```bash
source src/main/resources/db/schema.sql
```

或:
```bash
mysql -u root -p < src/main/resources/db/schema.sql
```

### 配置文件

编辑 `src/main/resources/application.yml` 或通过环境变量配置:

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `spring.datasource.url` | 数据库连接URL | `jdbc:mysql://localhost:3306/shear_wool` |
| `spring.datasource.username` | 数据库用户名 | `root` |
| `spring.datasource.password` | 数据库密码 | `root` |
| `server.port` | 服务端口 | `8080` |
| `alipay.app-id` | 支付宝AppID | - |
| `alipay.private-key` | 支付宝私钥 | - |
| `alipay.alipay-public-key` | 支付宝公钥 | - |

### 打包部署

```bash
# 打包
mvn clean package -DskipTests

# 运行
java -jar target/shear-wool-1.0.0.jar
```

### systemd 服务配置示例

创建 `/etc/systemd/system/shear-wool.service`:

```ini
[Unit]
Description=羊毛管家 - CPS优惠券聚合与推广平台
After=network.target mysql.service

[Service]
Type=simple
User=your_user
WorkingDirectory=/path/to/app
ExecStart=/usr/bin/java -jar shear-wool-1.0.0.jar
Restart=always
Environment="SPRING_PROFILES_ACTIVE=prod"

[Install]
WantedBy=multi-user.target
```

管理服务:
```bash
sudo systemctl daemon-reload
sudo systemctl enable coupon
sudo systemctl start coupon
sudo systemctl status coupon
```

## API 文档

### 用户接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/mini/coupons` | 分页获取优惠券列表 |
| GET | `/api/mini/coupons/{id}` | 获取优惠券详情 |
| GET | `/api/mini/coupons/active` | 获取有效优惠券 |
| GET | `/api/mini/coupons/platform/{platform}` | 按平台获取优惠券 |
| POST | `/api/collections` | 添加收藏 |
| DELETE | `/api/collections/{id}` | 取消收藏 |
| GET | `/api/collections` | 获取用户收藏列表 |
| GET | `/api/wallet/balance` | 获取余额 |
| GET | `/api/wallet/earnings` | 获取收益明细 |
| POST | `/api/wallet/withdraw` | 申请提现 |

### 管理后台接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/admin/coupons` | 管理端优惠券列表 |
| POST | `/api/admin/coupons` | 创建优惠券 |
| PUT | `/api/admin/coupons/{id}` | 更新优惠券 |
| DELETE | `/api/admin/coupons/{id}` | 删除优惠券 |
| GET | `/api/admin/withdraws` | 提现申请列表 |
| PUT | `/api/admin/withdraws/{id}/approve` | 审批提现 |
| PUT | `/api/admin/withdraws/{id}/reject` | 拒绝提现 |

### 健康检查

```
GET /actuator/health
```

## 数据库表结构

- `user` - 用户表
- `coupon` - 优惠券表
- `collection` - 收藏表
- `cps_order` - CPS订单表
- `withdraw_record` - 提现记录表
- `crawler_task` - 爬虫任务表
- `crawler_log` - 爬虫日志表
- `cps_config` - CPS配置表
- `notification_log` - 通知日志表