175 lines
4.5 KiB
Markdown
175 lines
4.5 KiB
Markdown
|
|
# M2Pool Lease 项目介绍
|
|||
|
|
|
|||
|
|
## 项目概述
|
|||
|
|
|
|||
|
|
M2Pool Lease 是一个基于 Spring Boot 的矿机租赁平台系统,为用户提供矿机租赁、订单管理、支付处理等核心功能。
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
### 后端框架
|
|||
|
|
- **Spring Boot 2.6.7** - 核心框架
|
|||
|
|
- **Spring Cloud Alibaba** - 微服务架构(Nacos 服务注册与配置中心)
|
|||
|
|
- **MyBatis Plus 3.5.3** - ORM 框架
|
|||
|
|
- **MySQL 8.0.28** - 数据库
|
|||
|
|
- **Redis** - 缓存与会话管理
|
|||
|
|
|
|||
|
|
### 中间件
|
|||
|
|
- **RabbitMQ** - 消息队列,用于异步订单处理和支付回调
|
|||
|
|
- **Nacos 2.0.4** - 服务注册发现和配置管理
|
|||
|
|
|
|||
|
|
### 工具库
|
|||
|
|
- **Lombok** - 简化代码
|
|||
|
|
- **Hutool 5.8.24** - Java 工具类库
|
|||
|
|
- **Fastjson 1.2.80** - JSON 处理
|
|||
|
|
- **Knife4j 3.0.3** - API 文档(Swagger 增强)
|
|||
|
|
- **Druid 1.2.8** - 数据库连接池
|
|||
|
|
- **PageHelper 1.4.1** - 分页插件
|
|||
|
|
|
|||
|
|
### 安全与认证
|
|||
|
|
- **JWT (jjwt 0.9.1)** - 令牌认证
|
|||
|
|
- **Google Authenticator** - 双因素认证
|
|||
|
|
- **RSA 加密** - 数据加密
|
|||
|
|
|
|||
|
|
### 网络通信
|
|||
|
|
- **Netty** - TCP 服务器,用于与矿机客户端通信
|
|||
|
|
- **Spring Boot Mail** - 邮件服务(Thymeleaf 模板)
|
|||
|
|
|
|||
|
|
### 其他
|
|||
|
|
- **ZXing 3.3.0** - 二维码生成
|
|||
|
|
- **JNA 5.12.1** - Java Native Access
|
|||
|
|
- **Blake3** - 哈希算法
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
m2pool_lease/
|
|||
|
|
├── src/main/java/com/m2pool/lease/
|
|||
|
|
│ ├── annotation/ # 自定义注解(加密、日志、数据源切换等)
|
|||
|
|
│ ├── aspect/ # AOP 切面
|
|||
|
|
│ ├── config/ # 配置类(Swagger、线程池、拦截器等)
|
|||
|
|
│ ├── constant/ # 常量定义
|
|||
|
|
│ ├── controller/ # 控制器层
|
|||
|
|
│ ├── dto/ # 数据传输对象
|
|||
|
|
│ ├── entity/ # 实体类
|
|||
|
|
│ ├── exception/ # 异常处理
|
|||
|
|
│ ├── mapper/ # MyBatis Mapper 接口
|
|||
|
|
│ ├── mq/ # 消息队列相关
|
|||
|
|
│ ├── netty/ # Netty TCP 服务器
|
|||
|
|
│ ├── redis/ # Redis 配置和服务
|
|||
|
|
│ ├── service/ # 业务逻辑层
|
|||
|
|
│ ├── task/ # 定时任务
|
|||
|
|
│ ├── utils/ # 工具类
|
|||
|
|
│ └── vo/ # 视图对象
|
|||
|
|
├── src/main/resources/
|
|||
|
|
│ ├── bootstrap.yml # 启动配置
|
|||
|
|
│ ├── bootstrap-dev.yml # 开发环境配置
|
|||
|
|
│ ├── bootstrap-test.yml # 测试环境配置
|
|||
|
|
│ ├── mapper/ # MyBatis XML 映射文件
|
|||
|
|
│ └── templates/ # 邮件模板
|
|||
|
|
└── pom.xml # Maven 项目配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 核心功能模块
|
|||
|
|
|
|||
|
|
### 1. 用户管理
|
|||
|
|
- 用户注册与登录
|
|||
|
|
- JWT 令牌认证
|
|||
|
|
- Google 双因素认证
|
|||
|
|
- 邮箱验证码
|
|||
|
|
- 密码重置
|
|||
|
|
|
|||
|
|
### 2. 产品与矿机管理
|
|||
|
|
- 产品信息管理
|
|||
|
|
- 矿机配置(ASIC/GPU)
|
|||
|
|
- 算力与价格配置
|
|||
|
|
- 矿机库存管理
|
|||
|
|
- 多币种支持
|
|||
|
|
|
|||
|
|
### 3. 订单系统
|
|||
|
|
- 购物车功能
|
|||
|
|
- 订单创建与管理
|
|||
|
|
- 订单状态跟踪
|
|||
|
|
- 订单费用计算
|
|||
|
|
- 多版本 API 支持(V1/V2)
|
|||
|
|
|
|||
|
|
### 4. 支付系统
|
|||
|
|
- 充值与提现
|
|||
|
|
- 支付记录管理
|
|||
|
|
- 支付回调处理
|
|||
|
|
- 多种支付方式支持
|
|||
|
|
- 自动支付处理
|
|||
|
|
|
|||
|
|
### 5. 矿场管理
|
|||
|
|
- 矿场信息配置
|
|||
|
|
- 矿场地址配置
|
|||
|
|
- 矿场钱包配置
|
|||
|
|
|
|||
|
|
### 6. 收益管理
|
|||
|
|
- 产品收益计算
|
|||
|
|
- 用户收益统计
|
|||
|
|
- 实时算力监控
|
|||
|
|
- 挖矿收益记录
|
|||
|
|
|
|||
|
|
### 7. Netty 通信服务
|
|||
|
|
- TCP 服务器与矿机客户端通信
|
|||
|
|
- 算力数据上报
|
|||
|
|
- 配置下发
|
|||
|
|
- 消息编解码
|
|||
|
|
|
|||
|
|
### 8. 定时任务
|
|||
|
|
- GPU 数据请求
|
|||
|
|
- 订单与支付处理
|
|||
|
|
- 自有产品管理
|
|||
|
|
- 实时算力数据插入
|
|||
|
|
|
|||
|
|
## 数据源配置
|
|||
|
|
|
|||
|
|
项目支持多数据源配置,通过 MyBatis Plus 动态数据源实现:
|
|||
|
|
- `HashRateDB` - 算力数据库
|
|||
|
|
- `MiningDB` - 挖矿数据库
|
|||
|
|
- `Pool2DB` - 矿池数据库
|
|||
|
|
|
|||
|
|
## 环境配置
|
|||
|
|
|
|||
|
|
项目支持多环境配置:
|
|||
|
|
- **dev** - 开发环境
|
|||
|
|
- **test** - 测试环境(默认)
|
|||
|
|
- **prod** - 生产环境
|
|||
|
|
|
|||
|
|
通过 Maven Profile 切换环境:
|
|||
|
|
```bash
|
|||
|
|
mvn clean package -P dev
|
|||
|
|
mvn clean package -P test
|
|||
|
|
mvn clean package -P prod
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## API 文档
|
|||
|
|
|
|||
|
|
项目集成 Knife4j,启动后访问:
|
|||
|
|
```
|
|||
|
|
http://localhost:port/doc.html
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 构建与运行
|
|||
|
|
|
|||
|
|
### 构建项目
|
|||
|
|
```bash
|
|||
|
|
mvn clean package
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 运行项目
|
|||
|
|
```bash
|
|||
|
|
java -jar target/lease-1.0.0.jar
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- 项目需要配置 Nacos 服务器地址
|
|||
|
|
- 需要配置 MySQL 数据库连接
|
|||
|
|
- 需要配置 Redis 连接
|
|||
|
|
- 需要配置 RabbitMQ 连接
|
|||
|
|
- demo 目录为示例模块,不包含在主项目提交中
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
本项目为内部项目,版权归 M2Pool 所有。
|