|
|
# 数学冒险岛 - 互动式数学学习软件
|
|
|
|
|
|
## 📘 项目简介
|
|
|
|
|
|
**“数学冒险岛”** 是一款面向小学、初中和高中学生的互动式数学学习软件。
|
|
|
通过 **游戏化界面设计** 与 **分学段题目设置**，让数学练习更具趣味性与挑战性。
|
|
|
软件支持用户邮件注册登录、学段选择、自定义题目数量、在线答题及结果反馈等功能，
|
|
|
适合各学段学生进行数学能力训练与提升。
|
|
|
|
|
|
---
|
|
|
|
|
|
## ✨ 功能特点
|
|
|
|
|
|
- **用户系统**：支持账号注册（含邮箱验证码）、登录、密码修改及退出功能
|
|
|
- **学段划分**：分为小学、初中、高中三个学段，自动匹配不同难度题目
|
|
|
- **个性化练习**：可自定义题目数量（10–30 题），满足多样化练习需求
|
|
|
- **友好界面**：采用渐变卡通风格设计，搭配 Emoji 元素增强趣味性
|
|
|
- **即时反馈**：答题完成后即时展示得分结果，支持重新挑战
|
|
|
- **数据管理**：自动保存用户试卷记录，实现持久化存储
|
|
|
|
|
|
---
|
|
|
## 📁 项目结构
|
|
|
|
|
|
```bash
|
|
|
数学冒险岛/
|
|
|
├── core/ # 核心逻辑模块
|
|
|
│ ├── data_handler.py # 数据处理与文件存储
|
|
|
│ ├── email_service.py # 邮件验证码发送模块
|
|
|
│ ├── question_bank.py # 题目生成与难度匹配
|
|
|
│ ├── user_system.py # 用户注册、登录与管理
|
|
|
│
|
|
|
├── ui/ # 图形界面模块（PyQt5 实现）
|
|
|
│ ├── login_ui.py # 登录界面
|
|
|
│ ├── main_window.py # 主窗口与页面切换逻辑
|
|
|
│ ├── question_ui.py # 题目答题界面
|
|
|
│ ├── register_ui.py # 注册界面
|
|
|
│ ├── result_ui.py # 答题结果展示界面
|
|
|
│ └── user_management_ui.py # 用户信息管理界面
|
|
|
│
|
|
|
├── generated_papers/ # 用户完成的试卷存储目录
|
|
|
├── main.py # 程序入口（运行此文件启动）
|
|
|
```
|
|
|
|
|
|
## 安装说明
|
|
|
|
|
|
### 环境要求
|
|
|
|
|
|
- Python 版本：`3.7+`
|
|
|
- 主要依赖：
|
|
|
- `PyQt5`（界面框架）
|
|
|
- `random`（随机题目生成）
|
|
|
- `smtplib`（邮箱验证码发送）
|
|
|
|
|
|
---
|
|
|
|
|
|
## 安装步骤
|
|
|
|
|
|
```bash
|
|
|
# 克隆仓库（若有）
|
|
|
git clone <仓库地址>
|
|
|
|
|
|
# 进入项目目录
|
|
|
cd math_adventure_island
|
|
|
|
|
|
# 安装依赖
|
|
|
pip install PyQt5
|
|
|
````
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 界面展示
|
|
|
|
|
|
以下表格展示了软件主要界面的功能与设计亮点：
|
|
|
|
|
|
| 页面名称 | 界面描述 | 主要功能 | 设计特点 |
|
|
|
|:--------:|:--------:|:--------:|:--------:|
|
|
|
| **主页面** | 登录 / 注册入口页面 | 用户登录、账号注册、退出系统 | 粉绿渐变背景、卡通风格、Emoji 装饰 |
|
|
|
| **学段选择页** | 选择学习阶段 | 小学 / 初中 / 高中学段选择、用户信息显示 | 分学段色彩、清晰布局、渐变背景延续 |
|
|
|
| **题目数量页** | 设置练习题目数量 | 输入题目数量、开始练习、返回上一级 | 简洁输入框、范围提示、友好错误提示 |
|
|
|
| **答题页** | 进行数学题目练习 | 显示题目、选择答案、进度跟踪 | 清晰排版、选项高亮、进度指示、交互反馈 |
|
|
|
| **结果页** | 展示答题成绩和统计 | 显示得分、重新练习、返回主页 | 数据可视化、醒目得分、鼓励性设计 |
|
|
|
|
|
|
## 使用指南
|
|
|
|
|
|
### 注册账号
|
|
|
|
|
|
1. 在主页面点击 **“注册账号”**
|
|
|
2. 输入用户名、邮箱和密码
|
|
|
3. 接收邮箱验证码并填写，完成注册
|
|
|
|
|
|
### 登录系统
|
|
|
|
|
|
1. 点击主页面 **“🎮 开始冒险”**
|
|
|
2. 输入注册的账号与密码进行登录
|
|
|
|
|
|
### 开始练习
|
|
|
|
|
|
1. 登录后选择学段：
|
|
|
* 小学乐园
|
|
|
* 初中城堡
|
|
|
* 高中太空
|
|
|
2. 输入题目数量（10–30 之间）
|
|
|
3. 点击 **“ 开始冒险”** 进入答题环节
|
|
|
|
|
|
### 查看结果
|
|
|
|
|
|
* 完成全部题目后系统自动展示得分结果
|
|
|
* 可选择 **“重新做题”** 或返回主页继续挑战
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
## 开发说明
|
|
|
|
|
|
### 技术栈
|
|
|
|
|
|
* **语言：** Python
|
|
|
* **框架：** PyQt5
|
|
|
* **架构：** 模块化设计 + QStackedWidget 页面切换
|
|
|
|
|
|
### 核心模块
|
|
|
|
|
|
| 文件名 | 主要功能 |
|
|
|
| ---------------- | ------------ |
|
|
|
| main_window.py | 主窗口逻辑与页面切换管理 |
|
|
|
| question_bank.py | 题目生成与试卷管理 |
|
|
|
| email_service.py | 注册验证码生成与邮件发送 |
|
|
|
| data_handler.py | 文件存储与用户数据处理 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 界面设计
|
|
|
|
|
|
* 使用 **QSS 样式表** 实现渐变背景、圆角按钮、柔和阴影等效果
|
|
|
* 通过 **QStackedWidget** 实现多页面无缝切换
|
|
|
* 界面配色采用卡通风格，适合中小学生视觉体验
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 联系方式
|
|
|
|
|
|
如需反馈问题或提出改进建议，请联系：
|
|
|
**1463365450@qq.com**
|
|
|
或在 **头歌** 提交 Issue
|
|
|
|
|
|
|
