# xha-cloud **Repository Path**: interestingTeam_1/xha-cloud ## Basic Information - **Project Name**: xha-cloud - **Description**: 基于ruoyi-cloud二开 - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-07 - **Last Updated**: 2026-05-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # XHA平台 (xha Cloud) 技术架构 ## 项目概述 XHA云平台是一个基于微服务架构的企业级应用系统，采用前后端分离的设计模式，为企业级应用开发提供坚实的技术基础。 ## 核心技术架构 ### 基础框架 - **JDK版本**：Java 17 - **应用框架**：Spring Boot 3.3.5 - **容器**：Undertow ### 微服务架构 - **微服务框架**：Spring Cloud 2023.0.3 - **微服务引擎**：Spring Cloud Alibaba 2023.0.1.2 - **服务注册与发现**：Nacos - **配置中心**：Nacos - **服务网关**：Spring Cloud Gateway - **负载均衡**：Spring Cloud Loadbalancer - **熔断降级**：Sentinel - **分布式事务**：Seata ### 数据层技术 - **ORM框架**：MyBatis 3.0.3 - **数据库**：MySQL 8.0+ - **数据库连接池**：Druid 1.2.23 - **分页插件**：PageHelper 2.1.0 - **多数据源**：Dynamic-Datasource 4.3.1 ### 缓存技术 - **缓存中间件**：Redis - **缓存框架**：Spring Cache ### 安全框架 - **认证授权**：Spring Security + JWT - **数据权限**：自定义注解实现 ### 消息通信 - **消息中间件**：Spring Cloud Stream - **消息队列**：支持RabbitMQ、Kafka等 ### 日志与监控 - **日志框架**：SLF4J + Logback - **系统监控**：Spring Boot Admin - **链路追踪**：Skywalking (可选) ### API文档 - **接口文档**：SpringDoc OpenAPI 2.6.0 ### 存储技术 - **对象存储**：MinIO 8.2.2 - **文档数据库**：MongoDB - **搜索引擎**：Elasticsearch ### 通信服务 - **WebSocket**：Spring WebSocket - **邮件服务**：JavaMail - **短信服务**：阿里云/腾讯云SMS ### 工具库 - **JSON处理**：FastJSON 2.0.57 - **Excel处理**：Apache POI 4.1.2 - **验证码**：Kaptcha 2.3.3 - **模板引擎**：Velocity 2.3 (用于代码生成) - **线程传递工具**：TransmittableThreadLocal 2.14.4 - **单元测试**：JUnit ## 系统模块架构 ``` xha-cloud ├── xha-auth # 认证中心，基于Spring Security实现的JWT认证服务 ├── xha-gateway # 网关模块，基于Spring Cloud Gateway的API网关 ├── xha-visual # 图形化管理模块 │ └── xha-visual-monitor # 系统监控服务 ├── xha-modules # 业务模块 │ ├── xha-module-basic # 基础业务模块 │ ├── xha-module-file # 文件服务模块 │ ├── xha-module-gen # 代码生成模块 │ ├── xha-module-job # 定时任务模块 │ └── xha-module-system # 系统管理模块 ├── xha-api # 接口模块 │ ├── xha-api-basic # 基础接口 │ └── xha-api-system # 系统接口 └── xha-common # 通用模块 ├── xha-common-core # 核心模块：提供通用工具类、异常处理、常量定义、通用实体类等基础功能 ├── xha-common-swagger # 接口文档：基于SpringDoc的API文档自动生成，支持接口分组、安全认证等 ├── xha-common-security # 安全模块：封装Spring Security，提供JWT认证、权限控制、安全上下文等功能 ├── xha-common-sensitive # 数据脱敏：提供字段级数据脱敏能力，支持手机号、身份证、银行卡等敏感信息处理 ├── xha-common-datascope # 权限范围：实现数据权限控制，支持部门、角色、用户等多维度的数据访问控制 ├── xha-common-datasource # 多数据源：基于Dynamic-Datasource的多数据源配置，支持读写分离、动态切换数据源 ├── xha-common-seata # 分布式事务：集成Seata框架，提供AT、TCC、SAGA等分布式事务模式支持 ├── xha-common-log # 日志记录：提供操作日志、访问日志、异常日志等记录功能，支持日志的异步处理 ├── xha-common-redis # 缓存服务：封装Redis操作，提供分布式锁、缓存管理、消息订阅等功能 ├── xha-common-excel # Excel服务：基于Apache POI的Excel导入导出功能，支持大数据量处理和复杂表格样式 ├── xha-common-elasticsearch # 搜索引擎：集成Elasticsearch，提供全文检索、聚合分析、高亮显示等搜索功能 ├── xha-common-mail # 邮件服务：基于JavaMail的邮件发送功能，支持HTML内容、附件、模板等 ├── xha-common-mongodb # MongoDB支持：集成MongoDB数据库，提供文档存储、聚合查询等NoSQL数据库操作 ├── xha-common-mybatis # MyBatis增强：扩展MyBatis功能，提供通用Mapper、SQL注入防护、性能优化等 ├── xha-common-mq # 消息队列：统一消息队列接口，支持RabbitMQ、Kafka等多种消息中间件 ├── xha-common-oss # 对象存储：统一对象存储接口，支持MinIO、阿里云OSS、腾讯云COS等多种存储服务 ├── xha-common-websocket # WebSocket：提供基于WebSocket的实时通信功能，支持消息推送、在线状态等 └── xha-common-sms # 短信服务：统一短信发送接口，支持阿里云、腾讯云等多种短信服务商 ``` ## 技术架构特性 1. **微服务架构**：基于Spring Cloud Alibaba实现微服务架构，服务治理、配置管理、服务注册发现等功能一应俱全 2. **安全认证**：基于Spring Security和JWT的认证授权体系 3. **多租户支持**：系统设计支持SaaS多租户模式 4. **数据权限**：灵活的数据权限控制，满足各类复杂的权限需求 5. **代码生成**：内置代码生成器，可根据数据库表结构生成前后端代码 6. **多数据源**：支持多数据源配置，满足复杂业务场景 7. **分布式事务**：集成Seata，解决分布式事务问题 8. **服务监控**：集成Spring Boot Admin，实现全方位服务监控 9. **接口文档**：集成SpringDoc，自动生成API文档 ## 技术架构图 ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ 前端应用（Vue/React） │ └───────────────────────────────────┬─────────────────────────────────────┘ │ ┌───────────────────────────────────▼─────────────────────────────────────┐ │ API网关（Spring Cloud Gateway） │ └───────────────────────────────────┬─────────────────────────────────────┘ │ ┌───────────────────────────────────▼─────────────────────────────────────┐ │ 认证中心（xha-auth） │ └───────────────────────────────────┬─────────────────────────────────────┘ │ ┌───────────────────────────────────▼─────────────────────────────────────┐ │ 业务服务层 │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 系统管理服务 │ │ 文件服务 │ │ 代码生成服务 │ │ 定时任务服务 │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │ └───────────────────────────────────┬─────────────────────────────────────┘ │ ┌───────────────────────────────────▼─────────────────────────────────────┐ │ 通用服务层 │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 安全服务 │ │ 缓存服务 │ │ 日志服务 │ │ 数据权限服务 │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │ └───────────────────────────────────┬─────────────────────────────────────┘ │ ┌───────────────────────────────────▼─────────────────────────────────────┐ │ 中间件服务层 │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Nacos │ │ Sentinel │ │ Seata │ │ Redis │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ MinIO │ │ 消息队列 │ │ 监控服务 │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ └───────────────────────────────────┬─────────────────────────────────────┘ │ ┌───────────────────────────────────▼─────────────────────────────────────┐ │ 数据存储层 │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ MySQL │ │ Redis │ │ MinIO │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ └─────────────────────────────────────────────────────────────────────────┘ ``` ## 开发环境要求 - JDK 17+ - Maven 3.8+ - MySQL 8.0+ - Redis 6.0+ - Nacos 2.2.0+ - Node.js 16+（前端开发）