question-storage

知了数学题库系统

一个基于 Flask 开发的数学题库管理系统，支持题目的增删改查、审核、知识点管理、PDF导出等功能。

项目概述

本系统是一个完整的数学题库管理平台，提供了题目管理、知识点层级管理、题目审核、AI辅助优化、PDF导出等核心功能。系统采用 Flask 作为后端框架，使用 MySQL 数据库存储数据，前端使用 Tailwind CSS 构建现代化界面。

功能特性

1. 题目管理

• 题目列表展示：按知识点分类展示题目，支持统计信息（总数、合格数、不合格数、待审核数）
• 题目详情查看：查看题目的完整信息，包括题干、选项、答案、解析等
• 题目编辑：支持编辑题目的所有字段
• 题目添加：通过表单添加新题目，支持单个录入和批量导入
• 题目删除：支持删除题目（需确认）
• 题目搜索：支持按题目ID搜索
• 年级选项：其他题目（未关联知识点）支持选择年级（小学/初中/高中）

2. 知识点管理

• 层级结构：支持章（Chapter）、节（Section）、小节（Subsection）三级知识点结构
• 知识点目录：左侧导航栏展示知识点层级树
• 知识点统计：每个知识点显示题目数量、合格率等统计信息
• 知识点编辑：支持编辑知识点名称
• 知识点添加：支持添加新的节或小节
• 学段筛选：目前只显示初中知识点（小学和高中已注释）

3. 题目审核

• 审核模式：专门的审核页面，显示所有未审核的题目
• 审核操作：支持标记题目为"合格"或"不合格"，并填写审核原因
• 审核统计：按知识点统计未审核题目数量
• 同步机制：审核通过（"合格"）的题目会自动同步到正式的 questions 表

4. AI辅助功能

• 难度评分：使用AI对题目进行难度评分，输出维度分数和难度等级（筑基/提分/培优）
• 查重检测：支持题目查重功能，检测重复题目

5. PDF导出

• 远程导出：调用远程API接口生成PDF
• 批量导出：支持批量导出多个题目

6. 教材管理

• 教材节点：支持按教材目录节点管理题目
• 节点统计：显示每个教材节点的题目统计信息

技术架构

后端技术

• 框架：Flask 3.x
• 数据库：MySQL（使用 mysql-connector-python）
• Web服务器：Waitress（生产环境）

前端技术

• CSS框架：Tailwind CSS（CDN）
• 数学公式渲染：KaTeX
• 图标库：Remix Icon
• 模板引擎：Jinja2

AI集成

• AI接口：支持 OpenAI 兼容接口
• 查重接口：http://47.77.199.85:8888

安装与配置

1. 环境要求

• Python 3.7+
• MySQL 数据库

2. 安装依赖

pip install -r requirements.txt

3. 配置文件

复制 config.env.example 为 config.env，并修改配置：

cp config.env.example config.env

编辑 config.env 文件，配置以下内容：

# 数据库配置
DB_HOST=your_db_host
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

# Web服务配置
WEB_HOST=127.0.0.1
WEB_PORT=5000

# AI配置（可选）
AI_API_KEY=your_api_key
AI_BASE_URL=https://api.openai.com/v1
AI_MODEL_NAME=gpt-5.2

# PDF导出配置
PDF_API_URL=https://teaching-content.chunsunqiuzhu.com/api/questions/pdf
PDF_STUDENT_ID=44

# 查重接口配置
DUPLICATE_CHECK_API_URL=http://47.77.199.85:8888

4. 数据库结构

系统使用以下主要数据表：

• questions_tem：题目表（临时表，用于审核）
• questions：题目表（正式表，只包含审核通过的题目）
• knowledge_points_copy1：知识点表
• textbook_catalog_nodes：教材目录节点表

使用方法

1. 启动服务

开发模式：

python app.py

生产模式（使用 Waitress）：

python run_web.py

2. 访问系统

在浏览器中访问：http://localhost:5000

3. 主要功能使用

查看题目列表

• 访问首页 /，查看按知识点分类的题目卡片
• 点击知识点卡片，查看该知识点下的所有题目

审核题目

• 访问 /audit_questions，查看所有未审核的题目
• 点击题目，进入详情页进行审核
• 填写审核原因，标记为"合格"或"不合格"
• 注意：只有审核通过（"合格"）的题目才会同步到正式的 questions 表

添加题目

• 访问 /question_management，点击"录入题目"按钮
• 填写题目信息（题干、选项、答案等）
• 选择知识点或教材节点
• 如果是"其他题目"（未关联知识点），必须选择年级
• 提交保存

编辑题目

• 在题目列表或详情页点击"编辑"按钮
• 修改题目信息
• 保存更改

搜索题目

• 访问 /search，按题目ID搜索
• 或访问 /search_id，直接输入题目ID

导出PDF

• 在题目详情页点击"导出PDF"按钮
• 选择本地导出或远程导出
• 下载生成的PDF文件

管理知识点

• 访问 /kp_management，管理知识点
• 点击"增加"按钮添加知识点
• 点击知识点旁的编辑图标，修改知识点名称

API接口

题目相关

• POST /audit：审核题目（审核通过会自动同步到 questions 表）
• POST /create_question：创建题目（保存到 questions_tem 表）
• POST /update_question：更新题目
• POST /api/delete_question/<question_code>：删除题目

AI相关

• POST /api/score：难度评分
• POST /api/check_duplicate：查重检测（代理接口）

知识点相关

• POST /add_kp_node：添加知识点节点
• POST /update_kp_node：更新知识点节点

PDF导出

• GET /export_pdf_remote/<question_code>：远程导出PDF

数据同步机制

questions_tem → questions 同步规则

1. 未审核题目（audit_reason 为 NULL 或空）：

   • 只存在于 questions_tem 表
   • 不会同步到 questions 表

2. 审核通过（audit_reason = "合格"）：

   • 更新 questions_tem 表的审核状态
   • 自动同步到 questions 表（INSERT 或 UPDATE）

3. 审核不通过（audit_reason = "不合格"）：

   • 更新 questions_tem 表的审核状态
   • 不会同步到 questions 表

总结：只有审核通过（"合格"）的题目才会同步到正式的 questions 表。

项目结构

知了数学题库/
├── app.py                 # 主应用文件
├── run_web.py            # Web服务器启动文件
├── requirements.txt      # Python依赖
├── config.env            # 配置文件（需自行创建，不提交到Git）
├── config.env.example    # 配置示例文件
├── README.md             # 项目说明文档
├── .gitignore            # Git忽略文件
├── templates/            # HTML模板目录
│   ├── layout.html       # 基础布局模板
│   ├── index.html        # 首页模板
│   ├── questions.html    # 题目列表模板
│   ├── detail.html       # 题目详情模板
│   ├── edit.html         # 题目编辑模板
│   ├── question_management.html # 题目管理模板
│   ├── kp_management.html # 知识点管理模板
│   └── ...
├── static/               # 静态文件目录
└── 知了数学题库/         # 数据文件目录
    └── tree_new.json     # 知识点树结构数据

常见问题

1. 数据库连接失败

• 检查 config.env 中的数据库配置是否正确
• 确认数据库服务是否运行
• 检查网络连接和防火墙设置

2. PDF导出失败

• 检查 PDF_API_URL 配置是否正确，网络是否可达

3. AI功能不可用

• 检查 AI_API_KEY 是否配置
• 确认 API 接口地址和模型名称正确
• 检查网络连接

4. 知识点不显示

• 确认数据库中有知识点数据
• 检查知识点表的 grade 字段（目前只显示"初中"）

5. Git推送失败

• 确认已安装 Git
• 检查 Git 凭据配置
• 确认远程仓库地址正确

开发说明

代码规范

• 使用 Python 类型提示
• 函数和类添加文档字符串
• 错误处理使用 try-except 块
• 数据库连接使用连接池管理

扩展功能

• 添加新的路由：在 app.py 中使用 @app.route() 装饰器
• 添加新的模板：在 templates/ 目录下创建HTML文件
• 修改样式：编辑模板文件中的 Tailwind CSS 类

更新日志

2024-12-XX（最新）

• 知识点管理页面优化：
  • 在知识点管理页面中，将小学和高中部分注释掉
  • 知识点管理页面现在只展示初中（grade='初中'）的知识点
  • 修改了知识点查询、下拉选择列表和题目统计查询，都添加了 WHERE grade = '初中' 条件
  • 注意：数据库中的 grade 字段存储的是中文（"小学"、"初中"、"高中"），不是数字
• 更新查重接口地址：
  • 将查重检测接口地址从 http://192.168.124.42:8888 更新为 http://47.77.199.85:8888
  • 更新了 /api/check_duplicate 和 /api/confirm_repeat 两个接口的代理地址
• 添加选项预览功能：
  • 在"题目管理"的所有录入页面（单个录入和批量导入）中添加了选项预览框（JSON格式）
  • 选项预览框支持双向同步：修改各个选项输入框会自动更新JSON预览，修改JSON预览会自动同步到各个选项输入框
  • 选项预览框支持直接编辑JSON格式，方便批量修改选项内容
  • 选项预览框仅在选择题时显示
• 添加年级选项功能（必填项）：
  • 在"题目管理-其他题目"的两个录入页面（单个录入和批量导入）中添加了年级选择字段
  • 年级选项为枚举值：小学（传1）、初中（传2）、高中（传3）
  • 年级字段仅在"其他题目"（未关联知识点）时显示，且为必填项
  • 前端添加了必填验证：提交时会检查年级是否已选择
  • 后端接口 /create_question 已支持接收和处理 grade 参数，并验证年级值的有效性（1、2、3）
  • 后端添加了业务规则验证：如果是"其他题目"（没有kp_code），则grade字段必须存在
• 优化题干显示逻辑：
  • 改进了题干容器的样式，添加了背景色和边框，使题干更易读
  • 优化了数学公式的自动渲染逻辑，确保题干中的数学公式能够正确显示
  • 改进了页面加载时的数学公式渲染处理，避免重复渲染
• 删除优化题目功能：
  • 移除了"优化题目"按钮及其相关弹窗
  • 删除了题干优化相关的JavaScript代码（openOptimizeModal、closeOptimizeModal、replaceStem等函数）
  • 简化了题目详情页面的操作按钮，提升了用户体验

Git 操作说明

首次提交到远程仓库

# 1. 初始化 Git 仓库（如果还没有）
git init

# 2. 添加远程仓库
git remote add origin https://git.yunzhixue.cn/wlh/wlh.git

# 3. 添加所有文件
git add .

# 4. 提交代码
git commit -m "初始提交：知了数学题库系统"

# 5. 设置主分支
git branch -M main

# 6. 推送到远程仓库
git push -u origin main

后续更新

# 1. 添加修改的文件
git add .

# 2. 提交更改
git commit -m "更新说明"

# 3. 推送到远程仓库
git push

许可证

本项目为内部使用项目，未经授权不得外传。

联系方式

如有问题或建议，请联系项目维护者。