# CyberExch

**Repository Path**: liuyun073/CyberExch

## Basic Information

- **Project Name**: CyberExch
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CyberExch

## 项目简介

CyberExch 是一个面向全球用户的 C2C + OTC 加密货币交易平台，支持 BTC、ETH、USDT 等主流数字资产交易。
从开源项目ZTuoExchange改造而来， 做了一些升级和改造。

### 核心功能
- **OTC交易**：支持法币与数字货币的场外交易
- **币币交易**：支持数字货币之间的交易
- **钱包服务**：支持多币种充值、提现、地址管理
- **用户中心**：支持用户注册、登录、实名认证
- **管理后台**：提供完整的后台管理功能
- **行情服务**：实时行情数据和K线图表
- **杠杆交易**：支持数字货币杠杆交易

## 技术架构

### 后端技术栈
- **Java 1.8+**：开发语言
- **Spring Boot 2.x**：基础框架
- **Spring MVC**：Web层
- **MySQL 8.0**：关系型数据库
- **MongoDB**：文档存储
- **Redis**：缓存/会话
- **Elasticsearch 7.x**：搜索引擎
- **Kafka**：消息队列
- **Netty 4.x**：网络通信（推送/实时）

### 前端技术栈
- **Vue 2.x**：管理后台/用户前端框架
- **Android (Java)**：移动端
- **iOS (Objective-C/Swift)**：移动端

## 项目结构

```
CyberExch/
├── 00_framework/      # 核心框架（Java后端）
├── 01_wallet_rpc/    # 钱包RPC服务（Java）
├── 02_app_android/   # Android移动端（Java）
├── 03_app_ios/       # iOS移动端（Objective-C/Swift）
├── 04_web_admin/     # 管理后台前端（Vue）
└── 05_web_front/     # 用户前端（Vue）
```

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+
- Redis 5.0+
- MongoDB 4.0+
- Elasticsearch 7.x
- Kafka 2.x

### 安装步骤

1. **克隆代码**
   ```bash
   git clone <repository_url>
   cd CyberExch
   ```

2. **构建项目**
   ```bash
   mvn clean install -DskipTests
   ```

3. **数据库配置**
   - 创建数据库：`CREATE DATABASE ztuo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   - 导入初始化脚本：`mysql -u ztuo -p ztuo < docs/sql/init.sql`

4. **配置文件**
   修改 `00_framework/core/src/main/resources/application-dev.properties` 配置数据库连接等信息

5. **启动服务**
   ```bash
   # 启动核心模块
   cd 00_framework/core
   mvn spring-boot:run
   
   # 启动其他模块
   cd 00_framework/ucenter-api
   mvn spring-boot:run
   ```

## 核心模块

### 00_framework
- **core**：核心模块，公共服务
- **ucenter-api**：用户中心API
- **otc-api**：OTC交易API
- **exchange-api**：币币交易API
- **wallet**：钱包服务
- **market**：行情服务
- **admin**：管理后台
- **gateway**：API网关

### 01_wallet_rpc
- **eth**：ETH钱包模块
- **btc**：BTC钱包模块
- **usdt**：USDT钱包模块
- **act**：ACT钱包模块
- **ect**：ECT钱包模块

## 开发指南

### 代码结构

```
src/main/java/cn/ztuo/bitrade/
├── controller/      # 控制器
├── service/        # 服务层
│   └── impl/       # 服务实现
├── repository/    # 数据访问层
├── entity/        # 实体类
├── dto/           # 数据传输对象
├── vo/            # 视图对象
├── config/        # 配置类
├── util/          # 工具类
├── constant/      # 常量
├── enums/         # 枚举
└── exception/     # 异常类
```

### 新增功能步骤
1. 创建实体类 (`entity/`)
2. 创建Mapper (`repository/`)
3. 创建Service (`service/`)
4. 创建Controller (`controller/`)

## 部署说明

### 生产环境部署
1. **环境准备**：安装所有必要的服务
2. **配置修改**：修改 `application-prod.properties` 为生产环境配置
3. **构建打包**：`mvn clean package -DskipTests`
4. **部署服务**：使用启动脚本启动各模块
5. **Nginx配置**：配置负载均衡和SSL

### 监控与维护
- **监控**：使用 Prometheus + Grafana 监控系统
- **日志**：使用 ELK 收集和分析日志
- **备份**：定期备份数据库和配置文件

## 安全措施

- **参数校验**：所有输入参数严格校验
- **SQL注入防护**：使用参数化查询
- **XSS防护**：输入输出转义
- **CSRF防护**：Token验证
- **敏感数据加密**：加密存储敏感信息
- **权限控制**：基于角色的权限管理

## 参与贡献

1. **Fork** 本仓库
2. **新建** Feat_xxx 分支
3. **提交**代码
4. **创建** Pull Request

## 联系方式

- **技术支持**：support@cyberexch.com
- **商务合作**：business@cyberexch.com
- **安全问题**：security@cyberexch.com

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件