# 对于刷题平台的构思使用

**Repository Path**: zaradee/learnmore

## Basic Information

- **Project Name**: 对于刷题平台的构思使用
- **Description**: 对于基于mogodb的web端刷题平台的构思使用
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-03-23
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Web, Java, MongoDB, Vue, TypeScript

## README

# 智能刷题与组卷平台

基于 `Spring Boot 3.2 + Vue3 + MongoDB + Redis` 的在线刷题与智能组卷系统，支持学生自主练习、管理员题库维护、试卷发布、在线考试和成绩分析。

## 项目定位

本项目包含两个协同子系统：

- 刷题平台
  - 面向学生
  - 提供课程练习、错题沉淀、成绩回顾、排行榜
- 组卷平台
  - 面向管理员 / 教师
  - 提供课程管理、题库管理、组卷发布、考试分析

## 当前仓库重点

本次整理后，仓库已补齐以下交付资产：

- 八周增量开发计划
- 更完整的交互设计说明与页面增强实现
- 核心接口压力测试脚本目录
- 黑盒测试报告
- 白盒测试报告
- 压力测试报告
- 性能分析报告
- 部署、运维、使用三类 README 子文档

## 技术栈

### 后端

- Java 17+
- Spring Boot 3.2
- Spring Security 6
- Spring Data MongoDB
- Redis
- JWT

### 前端

- Vue 3
- TypeScript
- Vite
- Pinia
- Vue Router
- Element Plus

### 基础设施

- MongoDB
- Redis
- Nginx
- Docker Compose

## 项目结构

```text
learnmore/
├── quiz-platform/                    # 后端多模块
├── quiz-frontend/                    # 前端项目
├── quiz-data/                        # 初始化数据
├── nginx/                            # Nginx 配置
├── quality-assurance/                # 测试脚本与测试报告
│   ├── core-api-stress/
│   └── reports/
├── readme/                           # 部署/运维/使用文档
├── docker-compose.yml
├── deploy.bat
├── deploy.sh
├── start.bat
└── 刷题平台说明文档.md
```

## 快速开始

### 方式一：本地一键启动

```powershell
.\start.bat
```

默认会：

- 检查后端端口
- 尝试拉起 MongoDB / Redis
- 启动后端与前端窗口

### 方式二：Docker Compose

```powershell
.\deploy.bat
```

或：

```bash
chmod +x deploy.sh
./deploy.sh
```

### 默认地址

- 前端：`http://localhost`
- 后端：`http://localhost:8080`
- Swagger：`http://localhost/swagger-ui.html`
- 本地前端开发：`http://localhost:5173`

## 默认账号

- 管理员：`admin / 123456`
- 学生：`student / 12345678`

## 文档导航

### 核心说明

- [刷题平台说明文档.md](./刷题平台说明文档.md)
- [八周增量开发计划](./quality-assurance/reports/八周增量开发计划.md)

### 质量保障

- [核心接口压力测试脚本说明](./quality-assurance/core-api-stress/README.md)
- [黑盒测试报告](./quality-assurance/reports/黑盒测试报告.md)
- [白盒测试报告](./quality-assurance/reports/白盒测试报告.md)
- [压力测试报告](./quality-assurance/reports/压力测试报告.md)
- [性能分析报告](./quality-assurance/reports/性能分析报告.md)

### 交付文档

- [部署文档](./readme/readme_Deploy.md)
- [运维文档](./readme/readme_om.md)
- [使用文档](./readme/readme_use.md)
- [快速启动指南](./QUICK_START.md)
- [性能优化旧指南](./PERFORMANCE_GUIDE.md)

## 核心功能一览

### 学生端

- 登录 / 注册
- 课程选择
- 顺序刷题
- 随机刷题
- 错题本
- 考试中心
- 成绩中心
- 学习节奏反馈
- 快捷挑战与排行榜

### 管理端

- 课程管理
- 用户管理
- 题库管理
- 手动组卷
- 自动组卷
- 发布考试
- 成绩分析
- 风险题与知识点复盘

## 本轮新增交互

### 学生首页

- 学习状态卡
- 更明确的挑战引导

### 学生刷题页

- 今日目标卡
- 当前练习剧本
- 推荐下一步动作
- 连对状态播报

### 管理端分析页

- 自动巡检保留
- 新增讲评脚本卡，便于教师直接复盘

## 本轮新增 QA 资产

新增目录：

- `quality-assurance/core-api-stress`

包含：

- `qa_smoke_and_seed.js`
  - 自动登录、补课程题目、刷题、组卷、交卷、分析
- `k6_core_api_load.js`
  - 核心接口压测脚本
- `run_stress.ps1`
  - Windows 执行入口

## 已识别的工程关注点

1. `practice_progress` 的脚本索引字段与实体字段存在不一致，建议统一为 `userId`。
2. 后台题库与试卷列表目前偏向内存过滤，后续可下推到 Repository 查询。
3. 分析服务以 Java 内存聚合为主，适合教学规模，超大规模场景需进一步演化。
4. 当前后端日志级别为 `DEBUG`，压测和正式部署建议调为 `INFO`。

## 建议验收顺序

1. 按 [部署文档](./readme/readme_Deploy.md) 启动系统。
2. 使用管理员与学生账号分别登录。
3. 运行：

```powershell
node .\quality-assurance\core-api-stress\qa_smoke_and_seed.js
```

4. 若环境具备 `k6`，运行：

```powershell
k6 run .\quality-assurance\core-api-stress\k6_core_api_load.js
```

5. 最后阅读 `readme` 目录三份子文档，完成部署、运维、使用交付。