# 项目说明文档

## 目录简介

文件夹包含 Coinbus 项目的后端微服务系统，是一个基于 Spring Cloud Alibaba 的分布式微服务架构，主要用于数字货币交易、行情分析和策略管理。

## 项目架构

### 技术栈
- **框架**: Spring Boot 2.6.7, Spring Cloud 2021.0.1, Spring Cloud Alibaba 2021.0.1.0
- **服务注册与配置**: Nacos 2.0.4
- **网关**: Spring Cloud Gateway
- **数据库**: MySQL (使用 MyBatis-Plus 3.0.6)
- **缓存**: Redis
- **安全认证**: JWT + Spring Security
- **API文档**: Swagger 3.0.0
- **监控**: Spring Boot Admin 2.6.6, Sentinel

## 主要模块及职责

### 1. 基础设施层 (jxy-common)
- **common-core**: 核心工具类、基础配置、通用常量
- **common-datasource**: 多数据源配置和管理
- **common-datascope**: 数据权限范围控制
- **common-log**: 日志记录和统一日志处理
- **common-redis**: Redis 缓存服务封装
- **common-security**: 安全认证、权限控制、JWT 令牌管理
- **common-swagger**: Swagger API 文档配置

### 2. 网关服务 (jxy-gateway)
- **端口**: 7101
- **职责**: 统一入口、路由转发、负载均衡、限流熔断
- **关联**: 连接所有业务模块，使用 Sentinel 进行流量控制

### 3. 认证授权服务 (jxy-auth)
- **端口**: 9200
- **职责**: 用户认证、JWT 令牌颁发、权限验证
- **邮箱服务**: support@coinbus.cc (mail.privateemail.com:587)
- **关联**: 为所有业务模块提供认证服务

### 4. 业务模块层 (jxy-modules)

#### jxy-system (系统管理)
- **端口**: 9201
- **职责**: 用户管理、角色权限、菜单管理、系统配置
- **数据库**: 包含用户、角色、权限等系统基础表

#### jxy-marketall (行情服务)
- **端口**: 9203
- **职责**: 数字货币行情数据收集、处理、分发
- **邮箱服务**: 集成邮件通知功能
- **关联**: 为策略模块和订单模块提供行情数据

#### jxy-binance (币安服务)
- **端口**: 9205
- **职责**: 币安交易所接口对接、交易数据获取
- **关联**: 与行情服务、订单服务配合

#### jxy-order (订单服务)
- **端口**: 8102
- **职责**: 交易订单管理、订单状态跟踪、历史订单查询
- **数据库**: 订单表、交易记录表
- **关联**: 依赖行情服务获取实时价格，依赖策略服务生成订单

#### jxy-strategy (策略服务)
- **端口**: 9204
- **职责**: 交易策略管理、策略执行、信号分析
- **关联**: 接收行情数据，向订单服务发送交易指令

#### jxy-file (文件服务)
- **端口**: 9300
- **职责**: 文件上传、下载、管理
- **关联**: 为其他模块提供文件存储服务

#### windminer (风控挖矿模块)
- **端口**: 9808
- **职责**: 风控管理、挖矿策略、风险分析
- **关联**: 与策略服务、订单服务协同工作

### 5. API 接口层 (jxy-api)
- **api-system**: 系统服务接口定义，供其他模块调用

### 6. 邮件服务 (jxy-mail)
- **职责**: 邮件发送、验证码发送、通知服务
- **配置**: mail.privateemail.com, support@coinbus.cc

## 数据库关联

### 主要数据库表
- **系统库**: 用户表、角色表、权限表、菜单表
- **交易库**: 订单表、交易记录表、账户表
- **行情库**: K线数据、实时行情、市场深度
- **策略库**: 策略配置、策略执行记录、信号记录

### 数据库配置
- 通过 Nacos 配置中心统一管理
- 支持多数据源切换
- 使用 Druid 连接池

## 外部服务关联

### Nacos 服务注册与配置中心
- **地址**: 127.0.0.1:8848
- **用途**: 服务注册发现、配置管理

### Sentinel 流量控制
- **控制台地址**: 127.0.0.1:8718
- **用途**: 流量控制、熔断降级

### 邮件服务
- **SMTP服务器**: mail.privateemail.com
- **端口**: 587
- **发件邮箱**: support@coinbus.cc

## 功能简介

1. **用户认证与授权**: 基于 JWT 的安全认证体系，支持角色权限管理
2. **行情数据服务**: 实时获取和分发数字货币行情数据
3. **交易策略管理**: 支持多种交易策略的配置和执行
4. **订单管理**: 完整的订单生命周期管理
5. **风控系统**: 实时风险监控和控制
6. **文件管理**: 统一的文件上传下载服务
7. **系统监控**: 基于 Spring Boot Admin 的系统监控
8. **API文档**: Swagger 自动生成 API 文档

## 相关联其他文件

- **coinbus/README.md**: 项目根目录说明
- **coinbus/yyb/backend/doc/**: 项目文档目录
    - 微服务技术架构.xlsx: 架构设计文档
    - readme.md: 后端详细说明
- **coinbus/yyb/backend/pom.xml**: Maven 父工程配置
- **各模块/src/main/resources/bootstrap.yml**: 各模块配置文件

## 服务端口汇总

| 服务名称 | 端口 | 说明 |
|---------|------|------|
| jxy-gateway | 7101 | 网关服务 |
| jxy-auth | 9200 | 认证服务 |
| jxy-system | 9201 | 系统管理 |
| jxy-marketall | 9203 | 行情服务 |
| jxy-strategy | 9204 | 策略服务 |
| jxy-binance | 9205 | 币安服务 |
| jxy-order | 8102 | 订单服务 |
| jxy-file | 9300 | 文件服务 |
| windminer | 9808 | 风控挖矿 |

## 启动顺序

1. Nacos (127.0.0.1:8848)
2. Sentinel (127.0.0.1:8718)
3. jxy-gateway
4. jxy-auth
5. jxy-system
6. 其他业务模块 (jxy-marketall, jxy-strategy, jxy-order, jxy-binance, jxy-file, windminer)