# raging-cloud-exam

**Repository Path**: mirspectator/raging-cloud-exam

## Basic Information

- **Project Name**: raging-cloud-exam
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Raging Cloud 微服务框架

**定位**：基于知识资产交易与应用的 SaaS 平台，支持 C 端个人用户和 B 端组织用户。

## 项目介绍

Raging Cloud（狂暴云）是一个完整的微服务解决方案，采用 MySQL 共享数据库 + 行级租户隔离方案，实现个人空间和组织空间的数据隔离。项目遵循"C 端无感准入"理念，用户通过手机号一键注册即拥有个人空间（tenant_id=0），支持后续创建或加入组织（tenant_id>0）。

## 核心特性

### 1. 多租户架构
- **个人空间（C端）**：tenant_id=0，用户注册即拥有，无需绑定企业
- **组织空间（B端）**：tenant_id>0，支持创建组织、邀请成员、资产共享
- **租户上下文自动切换**：TenantContextHolder + TenantInterceptor 实现
- **数据隔离**：通过 tenant_id 列实现行级隔离，确保数据安全

### 2. 认证与授权
- ✅ 手机号验证码登录/注册
- ✅ JWT Token 认证
- ✅ RBAC 角色权限体系
- ⏳ 微信/QQ/邮箱登录（表结构已设计）

### 3. 资产体系（规划中）
- 题目、试卷、题库、课件等"资产"管理
- 资产版本控制与快照技术
- 个人与组织间资产流转

## 技术栈

### 后端技术栈
- **Spring Boot 2.7.15** - Java 应用开发框架
- **Spring Cloud 2021.0.8** - 微服务框架
- **Spring Cloud Alibaba 2021.0.5.0** - 微服务生态组件
- **Nacos** - 服务发现与配置中心
- **Spring Cloud Gateway** - API 网关
- **MyBatis Plus** - ORM 框架
- **MySQL 8.0+** - 关系型数据库（共享库+tenant_id隔离）
- **Redis** - 缓存和分布式锁
- **JWT** - 身份认证

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

## 项目结构

```
raging-cloud-exam/
├── raging-cloud-common/            # 公共模块
│   ├── raging-cloud-common-core/   # 核心组件（TenantContextHolder等）
│   ├── raging-cloud-common-redis/  # Redis缓存组件
│   ├── raging-cloud-common-auth/   # 认证公共组件 ⚠️已确认编码问题
│   └── raging-cloud-common-sms/    # 短信公共组件 ⚠️待排查编码问题
├── raging-cloud-gateway/           # API 网关 ⚠️待排查编码问题
├── raging-cloud-user/              # 用户服务 ✅部分可用
├── raging-cloud-auth/              # 认证服务 ⚠️待排查编码问题
├── raging-cloud-sms/               # 短信服务 ⚠️待排查编码问题
├── sql/                            # 数据库脚本
│   └── mysql_schema.sql            # MySQL表结构（含tenant_id）
├── 功能文档/                       # 功能设计文档
├── 接口文档/                       # API接口文档
├── 手机号登录注册使用说明.md       # 当前可用功能说明
└── README.md                       # 本文件
```

## 功能模块

## 当前功能状态

### ✅ 已实现
1. **手机号登录注册**：支持固定验证码模式（开发测试用）
2. **个人空间创建**：新用户注册自动创建 tenant_id=0 的个人空间
3. **租户上下文管理**：TenantContextHolder 自动管理租户上下文
4. **数据隔离机制**：通过 tenant_id 列实现行级隔离
5. **JWT Token 认证**：用户登录后获取 Token 进行接口认证

### ⏳ 进行中
1. **修复编码问题**：部分模块存在中文编码损坏，需要手动修复
2. **组织管理**：创建组织、邀请成员等功能开发中

### 📋 计划中
1. 资产体系：题目、试卷等资产管理
2. 考试体系：在线考试、自动阅卷
3. 微信/QQ登录集成
4. 实时消息推送（SSE）
- 用户信息管理
- 角色与权限管理
- 组织/租户管理

### 2. 资产服务 (raging-cloud-asset)
- 资产信息管理
- 资产分类管理
- 资产状态跟踪

### 3. 考试/题目服务 (raging-cloud-exam)
- 题目管理
- 考试管理
- 答题管理
- 成绩统计

### 4. API 网关 (raging-cloud-gateway)
- 请求路由
- 负载均衡
- 统一认证
- 限流熔断

## 快速开始

### 后端服务

1. **安装依赖**
```bash
mvn clean install -DskipTests
```

2. **启动服务**
- 启动 Nacos 服务
- 依次启动各微服务模块

### 前端服务

1. **安装依赖**
```bash
cd raging-cloud-frontend
npm install
```

2. **启动开发服务器**
```bash
npm run dev
```

3. **构建生产版本**
```bash
npm run build
```

## 数据库

项目采用 MySQL 单库多租户方案（tenant_id 行级隔离）：
- 个人空间：tenant_id=0
- 组织空间：tenant_id>0

表名前缀规则：
- 用户体系：`sys_`
- 资产体系：`biz_`
- 考试/题目体系：`exam_`

## 配置说明

各服务配置通过环境变量获取，主要配置项包括：
- 数据库连接信息
- Nacos 服务地址
- JWT 密钥

## 开源许可证

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

## 贡献指南

欢迎提交 Issue 和 Pull Request！

## 联系方式

如有问题或建议，欢迎通过以下方式联系：
- GitHub Issues: [项目地址/issues]
- Email: [your-email@example.com]

## 致谢

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

## 前端（UI）

- 前端模块已更名：`raging-cloud-user-frontend` -> `raging-cloud-ui`
- 技术栈：Vue 3 + TypeScript + Vite + Pinia + Axios + Ant Design Vue + SCSS