本文档由AI自动生成，欢迎修改补充。

这是一个积分管理系统，用户可以通过完成任务（如提出选题、认领任务等）来获取积分，并使用这些积分兑换奖励。项目包括一个 后端 API 和 前端管理界面。后端使用 Flask 框架，前端基于 Vue.js 框架，数据库使用 MySQL 来存储用户、选题、奖励等数据。

---

• 用户注册、登录
• 查看用户信息、积分情况
• 更新用户积分、兑换记录

• 用户可以提出选题
• 用户可以认领他人的选题并完成
• 查看选题状态、选题的提出者和认领者

• 用户的积分会根据选题提出、完成等情况实时更新
• 用户可以通过积分兑换奖励

• 查看可兑换的奖励及库存情况
• 用户可以使用积分兑换奖励

---

详细项目结构可查看根目录下文件👉： 项目结构

backend/                     # 后端代码，基于 Flask 框架
    app.py                    # Flask 应用入口
    config.py                 # 后端配置文件
    db.py                     # 数据库初始化文件
    controllers/              # 各功能的业务逻辑处理层
    models/                   # 数据库模型
    routes/                   # API 路由
    middleware.py             # 中间件，如认证功能

frontend/                    # 前端代码，基于 Vue.js 框架
    src/                     # Vue 源代码
        components/          # Vue 组件
        router/              # 路由配置
        services/            # API 服务，封装 API 调用
        views/               # 页面视图文件
    public/                  # 静态文件
    package.json             # 前端依赖文件

---

• Python 3.8+ (后端)
• Flask 2.0+
• Vue.js 3.0+ (前端)
• MySQL 8.0+ (数据库)

---

• 克隆项目代码：

  git https://github.com/aku0905/xuantihuxuansai.git
  cd yourproject/backend
  

• 创建虚拟环境并安装依赖：

  python -m venv venv
  source venv/bin/activate  # Windows 下运行 `venv\Scripts\activate`
  pip install -r requirements.txt
  

• 初始化数据库：

  python app.py
  

• 启动 Flask 应用：

  flask run
  

• 如不能启动，可以检查下python 环境和工作目录的设置。在项目根目录下运行。

  $env:PYTHONPATH="根目录"
  python backend/app.py
  

• 进入前端目录：

  cd ../frontend
  

• 安装依赖：

  npm install
  

• 运行开发服务器：

  npm run serve
  

---

本项目依赖 MySQL 数据库来存储和管理用户、选题、积分、奖励等数据。你可以通过提供的 dump.sql 文件来快速创建数据库并初始化数据。

1. 访问 MySQL 下载页面 并选择适合你操作系统的版本（例如 Windows 或 macOS）。
2. 完成 MySQL Server 的安装，并在安装过程中设置 root 用户的密码。
3. 安装完成后，使用 MySQL Workbench 或命令行工具连接到 MySQL 数据库。

本项目提供了一个 MySQL 数据库的导出文件，你可以使用该文件快速在本地初始化数据库。

确保你已经从项目的 sql 目录中获取到了导出的 SQL 文件dump.sql

1. 打开命令行或终端，并连接到 MySQL：

   mysql -u root -p
   

2. 创建一个新的数据库：

   CREATE DATABASE your_database_name;
   

3. 退出 MySQL：

   exit;
   

4. 导入 SQL 文件中的数据库结构和数据：

   mysql -u root -p your_database_name < /path/to/your/dump.sql
   

   • your_database_name: 刚才创建的数据库名。
   • /path/to/your/dump.sql: .sql 文件的路径。

1. 打开 MySQL Workbench 并连接到你的 MySQL 服务器。
2. 选择数据库菜单并点击 "Data Import"。
3. 选择 "Import from Self-Contained File" 并指定你下载的 .sql 文件。
4. 在 Default Target Schema 中选择刚才创建的数据库名。
5. 点击 "Start Import" 按钮来导入 SQL 文件。

---

你可以通过以下 SQL 命令来验证数据库是否成功导入，并查看已创建的表：

USE your_database_name;
SHOW TABLES;

1. 用户注册：
   • POST /users/register
2. 用户登录：
   • POST /users/login
3. 获取用户积分：
   • GET /users/:user_id/points

更多 API 请参考/backend/routes下的XX_router.py源码。

1. 用户登录系统并查看积分信息
2. 选择题目提出、认领任务并提交
3. 使用积分兑换奖励

---

• 请参考项目中的 数据库结构文档

---

欢迎对该项目贡献代码，提交 Pull Requests 或报告问题。