考试应用 - 智能题库练习系统

效果展示

登录界面

首页界面

答题界面

我的页面

功能模块概览

考试应用是一款集成多种练习模式的跨平台应用，涵盖题库管理、考试记录、错题收藏、个人统计等核心功能。

系统架构

技术架构

核心功能

🔐 邀请码系统

// 邀请码生成核心代码
const crypto = require('crypto');

function generateInviteCode(phone, secret) {
  // 使用 HMAC-SHA256 加密
  const hmac = crypto.createHmac('sha256', secret);
  hmac.update(phone);
  const hash = hmac.digest('hex');
  
  // 取前16位作为邀请码
  return hash.substring(0, 16).toUpperCase();
}

// 验证邀请码
function verifyInviteCode(phone, inviteCode, secret) {
  const expectedCode = generateInviteCode(phone, secret);
  return expectedCode === inviteCode.toUpperCase();
}

🔑 JWT 认证

// JWT Token 生成
const jwt = require('jsonwebtoken');

function generateToken(phone, inviteCode) {
  const payload = {
    phone: phone,
    userId: `user_${phone}_${Date.now()}`,
    role: 'user',
    loginTime: new Date().toISOString(),
    inviteCode: inviteCode
  };
  
  return jwt.sign(payload, process.env.JWT_SECRET, {
    expiresIn: process.env.JWT_EXPIRES_IN || '24h'
  });
}

// Token 验证中间件
function verifyToken(req, res, next) {
  const token = req.headers.authorization?.replace('Bearer ', '');
  
  if (!token) {
    return res.status(401).json({
      success: false,
      message: '未授权访问'
    });
  }
  
  try {
    const decoded = jwt.verify(token, process.env.JWT_SECRET);
    req.user = decoded;
    next();
  } catch (error) {
    return res.status(401).json({
      success: false,
      message: 'Token无效或已过期'
    });
  }
}

📚 题库练习模式

• 完整题库：返回整个题库的所有题目，支持顺序练习
• 收藏标记：每道题目自动标记 isFavorite 字段，显示收藏状态
• 题目格式：包含题目内容、选项、答案、解析等完整信息
• 实时同步：收藏状态实时同步，前端可即时更新

🎲 随机练习模式

• 随机抽题：从题库中随机选择 20 道题目
• 收藏标记：每道题目标记收藏状态，便于快速收藏
• 快速测试：适合碎片化学习，快速检验知识掌握
• 不重复抽取：同一次练习中不会出现重复题目

❌ 错题练习模式

• 专属题库：返回用户收藏的所有题目
• 全部已收藏：所有题目 isFavorite 都为 true
• 针对性练习：专门针对薄弱环节进行强化训练
• 查漏补缺：帮助用户快速提升正确率

📝 考试记录管理

// 提交试卷核心逻辑
async function commitExam(examId, answeredCount, correctCount) {
  // 1. 验证试卷状态（必须是考试中）
  const exam = await getExamById(examId);
  if (exam.examStatus !== 1) {
    throw new Error('试卷已经提交，无法重复提交');
  }
  
  // 2. 计算统计数据
  const totalQuestions = exam.totalQuestions;
  const correctRate = (correctCount / totalQuestions * 100).toFixed(2);
  const completionRate = (answeredCount / totalQuestions * 100).toFixed(2);
  const errorRate = ((totalQuestions - correctCount) / totalQuestions * 100).toFixed(2);
  
  // 3. 更新考试记录
  await updateExam(examId, {
    answeredCount,
    correctCount,
    correctRate,
    completionRate,
    errorRate,
    examStatus: 2,  // 已交卷
    endTime: new Date(),
    modifyTime: new Date()
  });
  
  return { correctRate, completionRate, errorRate };
}

📊 个人统计

⭐ 题目收藏

• 收藏/取消收藏：支持一键收藏和取消收藏题目
• 去重机制：通过题目 content 字段去重，避免重复收藏
• 题库分类：按 questionTemplate 分类管理收藏题目
• 统一存储：与错题记录共用 exam_error_questions 表

API 接口设计

项目特点

• 跨平台支持：uni-app 一套代码，支持 H5、微信小程序、App 多端运行
• 邀请码系统：HMAC-SHA256 加密，手机号一对一绑定，安全可靠
• JWT 认证：标准 Token 认证方案，24小时有效期，自动过期保护
• 三种练习模式：题库练习、随机练习、错题练习，满足不同学习需求
• 智能收藏标记：题目自动标记收藏状态，前端无需额外查询
• 完整统计系统：11项核心指标，全面展示学习情况和成就
• 高效 SQL 查询：使用聚合查询一次性返回所有统计数据
• 数据隔离：每个用户只能访问自己的数据，安全可靠
• 状态管理：考试状态清晰，防止重复提交
• 环境变量配置：敏感信息通过 .env 文件管理，安全性高

数据库设计

开发心得

下一步计划