# kexilo_new

**Repository Path**: ruoyi-x/kexilo_new

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-06
- **Last Updated**: 2025-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kexio 企业级后端管理系统

## 项目简介
Kexio 是一个基于 Spring Boot 3.x 的现代化企业级后端管理系统，采用微服务架构设计，提供完整的用户管理、权限控制、文件存储、代码生成等企业级功能。

## 🏗️ 系统架构

### 模块结构
```
kexio-backend/
├── kexio-application/          # 应用启动模块 - 系统统一入口
├── kexio-common/              # 通用工具模块 - 基础组件和工具类
├── kexio-auth-starter/        # 认证授权模块 - JWT认证和RBAC权限控制
├── kexio-user-management/     # 用户管理模块 - 用户、角色、权限管理
├── kexio-framework/           # 框架模块集
│   ├── kexio-cache-monitor/   # 缓存监控模块
│   ├── kexio-config/          # 配置管理模块
│   ├── kexio-email/           # 邮件服务模块
│   ├── kexio-file/            # 文件存储模块
│   ├── kexio-gen/             # 代码生成模块
│   ├── kexio-log-analytics/   # 日志分析模块
│   ├── kexio-pay/             # 支付服务模块
│   ├── kexio-scheduler/       # 调度任务模块
│   └── kexio-sms/             # 短信服务模块
├── kexio-frontend/            # 前端Vue3项目
└── kexio-test/                # 测试模块
```

## 🚀 核心特性

### 认证授权
- 🔐 JWT双Token认证机制
- 🛡️ 基于RBAC的细粒度权限控制
- 📊 行级数据权限支持
- 🏢 多租户架构支持
- 🚫 分布式会话管理

### 用户管理
- 👥 完整的用户生命周期管理
- 🔑 灵活的角色权限分配
- 🏛️ 组织架构管理
- 📝 操作审计日志
- 🔒 安全策略配置

### 文件管理
- 📁 多存储后端支持(本地/MinIO/OSS/COS)
- 🔄 文件版本控制
- 🔗 安全分享链接
- 🖼️ 图片缩略图生成
- ⚡ 大文件分片上传

### 系统工具
- 🛠️ 智能代码生成器
- 📊 缓存监控管理
- ⏰ 分布式任务调度
- 📧 多渠道邮件服务
- 📱 短信验证服务
- 💳 统一支付服务

## 🔧 技术栈

### 后端技术
- **框架**: Spring Boot 3.2+, Spring Security 6.x
- **数据库**: PostgreSQL 12+, Redis 6.0+
- **ORM**: MyBatis Plus 3.5+
- **认证**: JWT (JJWT)
- **缓存**: Redis + Caffeine 双级缓存
- **任务调度**: Quartz Scheduler
- **文档**: Swagger 3 (OpenAPI)
- **监控**: Micrometer + Prometheus
- **构建**: Maven 3.8+

### 前端技术
- **框架**: Vue 3.x + TypeScript
- **UI组件**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router 4.x
- **HTTP客户端**: Axios
- **构建工具**: Vite

### 基础设施
- **容器化**: Docker + Docker Compose
- **数据库**: PostgreSQL (主数据库)
- **缓存**: Redis (缓存 + 会话存储)
- **存储**: MinIO (对象存储)
- **监控**: Prometheus + Grafana

## 📖 模块文档

每个模块都有详细的README文档，包含功能介绍、API说明、配置示例等：

- [kexio-application - 应用启动模块](kexio-application/README.md)
- [kexio-common - 通用工具模块](kexio-common/README.md)
- [kexio-auth-starter - 认证授权框架](kexio-auth-starter/README.md)
- [kexio-user-management - 用户管理模块](kexio-user-management/README.md)
- [kexio-file - 文件存储模块](kexio-framework/kexio-file/README.md)
- [kexio-gen - 代码生成模块](kexio-framework/kexio-gen/README.md)
- [kexio-pay - 支付服务模块](kexio-framework/kexio-pay/README.md)
- [kexio-sms - 短信服务模块](kexio-framework/kexio-sms/README.md)
- [kexio-email - 邮件服务模块](kexio-framework/kexio-email/README.md)
- [kexio-scheduler - 调度模块](kexio-framework/kexio-scheduler/README.md)
- [kexio-config - 配置管理模块](kexio-framework/kexio-config/README.md)
- [kexio-cache-monitor - 缓存监控模块](kexio-framework/kexio-cache-monitor/README.md)
- [kexio-log-analytics - 日志分析模块](kexio-framework/kexio-log-analytics/README.md)

## 🚀 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- Node.js 18+
- PostgreSQL 12+
- Redis 6.0+

### 运行步骤

1. **克隆项目**
```bash
git clone https://github.com/kexio/kexio-backend.git
cd kexio-backend
```

2. **启动基础服务**
```bash
docker-compose up -d postgres redis minio
```

3. **编译项目**
```bash
mvn clean compile
```

4. **运行后端**
```bash
cd kexio-application
mvn spring-boot:run
```

5. **运行前端**
```bash
cd kexio-frontend
npm install
npm run dev
```

6. **访问系统**
- 后端API: http://localhost:8080/api
- 前端界面: http://localhost:3000
- API文档: http://localhost:8080/swagger-ui/index.html

### 默认账号
- 用户名: `admin`
- 密码: `123456`

## 📋 API 文档

系统提供完整的API文档，支持Swagger在线调试：

- **Swagger UI**: http://localhost:8080/swagger-ui/index.html
- **OpenAPI JSON**: http://localhost:8080/v3/api-docs

主要API模块：
- 用户认证: `/api/auth/**`
- 用户管理: `/api/users/**`
- 角色管理: `/api/roles/**`
- 权限管理: `/api/permissions/**`
- 文件管理: `/api/files/**`
- 代码生成: `/api/generator/**`

## ⚙️ 配置说明

### 数据库配置
```yaml
spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/kexio
    username: postgres
    password: password
```

### Redis配置
```yaml
spring:
  redis:
    host: localhost
    port: 6379
    database: 0
```

### JWT配置
```yaml
kexio:
  auth:
    jwt:
      secret: your-secret-key
      access-token-expire: 7200000   # 2小时
      refresh-token-expire: 604800000 # 7天
```

### 文件存储配置
```yaml
kexio:
  file:
    storage:
      type: minio  # local, minio, oss, cos
      minio:
        endpoint: http://localhost:9000
        access-key: minioadmin
        secret-key: minioadmin
        bucket-name: kexio-files
```

## 🔒 安全特性

### 认证安全
- JWT双Token机制防止Token劫持
- 密码BCrypt强加密存储
- 登录失败次数限制和账号锁定
- 会话并发控制

### 权限安全
- 基于RBAC的细粒度权限控制
- 数据权限行级过滤
- API接口权限注解保护
- 敏感操作审计记录

### 数据安全
- SQL注入防护
- XSS攻击防护
- 敏感数据脱敏
- 文件类型安全检查

## 📊 监控告警

### 应用监控
- **Actuator**: 应用健康检查和指标收集
- **Micrometer**: 统一的监控指标接口
- **Prometheus**: 指标存储和查询
- **Grafana**: 监控数据可视化

### 关键指标
- 应用性能指标 (响应时间、吞吐量)
- JVM性能指标 (内存、GC)
- 数据库连接池状态
- 缓存命中率统计
- 业务操作统计

## 🚀 部署方案

### Docker部署
```bash
# 构建镜像
docker build -t kexio-backend .

# 运行完整环境
docker-compose up -d
```

### 生产环境
- 使用外部PostgreSQL集群
- 配置Redis Cluster
- 使用Nginx反向代理
- 配置HTTPS证书
- 设置监控告警

## 🤝 贡献指南

欢迎贡献代码，请遵循以下规范：

1. **代码规范**: 遵循Google Java Style Guide
2. **提交规范**: 使用Conventional Commits格式
3. **测试要求**: 新功能需要包含单元测试
4. **文档更新**: 更新相关的README和API文档

### 开发流程
```bash
# 1. Fork项目
# 2. 创建功能分支
git checkout -b feature/your-feature

# 3. 提交代码
git commit -m "feat: add new feature"

# 4. 推送分支
git push origin feature/your-feature

# 5. 创建Pull Request
```

## 📄 许可证

本项目采用 [Apache License 2.0](LICENSE) 许可证。

## 📞 联系我们

- 官方网站: https://kexio.com
- 技术文档: https://docs.kexio.com
- 问题反馈: https://github.com/kexio/kexio-backend/issues
- 邮箱: support@kexio.com

## 🙏 致谢

感谢所有为Kexio项目做出贡献的开发者们！

---

⭐ 如果这个项目对你有帮助，请给我们一个Star！