问卷调查系统

功能完善的在线问卷调查系统，支持多种题型、随机抽题、免注册答题等特性。

功能特性

用户端功能

• 免注册答题：用户无需注册，填写基本信息即可开始答题
• 信息验证：严格的姓名和手机号格式验证
• 多种题型：支持单选、多选、判断、文字描述四种题型
• 随机抽题：根据配置随机生成试卷，确保题目多样性
• 实时反馈：答题完成后立即显示得分和答案详情

管理端功能

• 题库管理：支持Excel导入和手动编辑题目
• 题型配置：灵活设置各题型比例和试卷总分
• 数据统计：详细的答题记录和统计分析
• 数据导出：支持导出答题记录和统计报表

技术架构

• 前端：React 18 + TypeScript + Ant Design + Tailwind CSS
• 后端：Express.js + TypeScript
• 数据库：SQLite3
• 构建工具：Vite
• 文件处理：Multer + XLSX

快速开始

安装依赖

npm install

启动开发服务器

npm run dev

构建生产版本

npm run build

启动生产服务器

npm start

管理员账号

• 用户名：admin
• 密码：admin123

API接口

用户相关

• POST /api/users - 创建用户
• GET /api/users/:id - 获取用户信息
• POST /api/users/validate - 验证用户信息

题库管理

• GET /api/questions - 获取题目列表
• POST /api/questions - 创建题目
• PUT /api/questions/:id - 更新题目
• DELETE /api/questions/:id - 删除题目
• POST /api/questions/import - Excel导入题目

答题相关

• POST /api/quiz/generate - 生成随机试卷
• POST /api/quiz/submit - 提交答题
• GET /api/quiz/records/:userId - 获取用户答题记录

管理员相关

• POST /api/admin/login - 管理员登录
• GET /api/admin/config - 获取抽题配置
• PUT /api/admin/config - 更新抽题配置
• GET /api/admin/statistics - 获取统计数据

数据库设计

用户表 (users)

• id: 用户ID
• name: 姓名
• phone: 手机号
• created_at: 创建时间

题目表 (questions)

• id: 题目ID
• content: 题目内容
• type: 题型
• options: 选项（JSON）
• answer: 标准答案
• score: 分值
• created_at: 创建时间

答题记录表 (quiz_records)

• id: 记录ID
• user_id: 用户ID
• total_score: 总得分
• correct_count: 正确题数
• total_count: 总题数
• created_at: 创建时间

答题答案表 (quiz_answers)

• id: 答案ID
• record_id: 记录ID
• question_id: 题目ID
• user_answer: 用户答案
• score: 得分
• is_correct: 是否正确
• created_at: 创建时间

Excel导入格式

Excel文件需要包含以下列：

• 题目内容（必填）
• 题型（单选/多选/判断/文字描述）
• 标准答案（根据题型格式要求）
• 分值（数字类型）
• 选项（单选/多选题需要，用|分隔）

开发规范

• 使用TypeScript进行类型检查
• 遵循React最佳实践
• 使用ESLint进行代码检查
• 使用Prettier进行代码格式化

部署说明

1. 构建项目：npm run build
2. 上传构建文件到服务器
3. 安装生产依赖：npm ci --only=production
4. 启动服务：npm start
5. 配置反向代理（如Nginx）

许可证

MIT License