# qiusalahbui

**Repository Path**: dcmnioa/qiusalahbui

## Basic Information

- **Project Name**: qiusalahbui
- **Description**: 题库系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-26
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 教师端题库管理系统

## 项目简介

教师端题库管理系统是一个基于FastAPI和H5的Web应用，支持教师通过单道题手动录入和Word/PDF批量导入（OCR识别）两种方式维护题库。

## 技术栈

### 前端
- 语言：JavaScript + TypeScript
- 页面：H5（移动端浏览器）

### 后端
- 语言：FastAPI + Python
- 架构：接口服务 + 业务逻辑处理

### 数据库
- MongoDB 文档型数据库
- 用于存储：题目信息、上传记录、教师信息

### 附加能力
- OCR 识别技术（对接 Word/PDF 批量上传功能）

## 功能说明

### 1. 单道题上传功能
- 支持选择题型（单选/多选/判断/填空）
- 填写题干、选项、正确答案、解析、分值、难度、知识点
- 题目存入 MongoDB 的 questions 集合，可随时编辑/删除

### 2. 文档上传题目功能
- 支持上传本地的 Word/PDF 题库文件
- 系统通过 OCR 技术解析文件内容，识别题目、选项、答案
- 解析完成后，进入校对页面，查看识别结果
- 对识别错误的题干、选项、答案进行手动修改
- 显示标注导入的题目的个数，支持分页展示
- 可直接删除不需要的题目
- 确认所有题目无误后，点击「导入题库」
- 系统将题目批量存入 MongoDB，并生成导入日志
- 将批量导入的操作作为一个任务，并生成 task_id

## 项目结构

```
questionLib/
├── front/            # 前端代码
│   ├── index.html    # 主页面
│   ├── styles.css    # 样式文件
│   └── script.js     # 脚本文件
├── server/           # 后端代码
│   ├── main.py       # FastAPI 主文件
│   └── requirements.txt  # 依赖包
├── datalib/          # 数据库操作相关文件
│   ├── database.py   # 数据库操作
│   └── ocr.py        # OCR 识别功能
└── README.md         # 项目说明
```

## 安装步骤

### 1. 安装后端依赖

```bash
cd server
pip install -r requirements.txt
```

### 2. 安装 Tesseract OCR

- Windows：下载并安装 [Tesseract OCR](https://github.com/UB-Mannheim/tesseract/wiki)
- Linux：`sudo apt-get install tesseract-ocr`
- macOS：`brew install tesseract`

### 3. 配置 MongoDB

- 安装 MongoDB 并启动服务
- 默认连接地址：`mongodb://localhost:27017`

### 4. 启动后端服务

```bash
cd server
uvicorn main:app --reload
```

### 5. 访问前端页面

在浏览器中打开 `http://localhost:8000/front/index.html`

## 使用方法

### 单道题录入
1. 进入「单道题录入」页面
2. 选择题型
3. 填写题干、选项、正确答案、解析、分值、难度、知识点
4. 点击「提交」按钮

### 批量导入
1. 进入「批量导入」页面
2. 点击「上传文件」，选择本地的 Word/PDF 题库文件
3. 等待系统解析文件内容
4. 进入校对页面，查看识别结果
5. 对识别错误的题干、选项、答案进行手动修改
6. 点击「确认导入」按钮

### 题目管理
1. 进入「题目列表」页面
2. 查看已录入的题目
3. 点击「删除」按钮删除题目

## 注意事项

- 批量导入功能需要安装 Tesseract OCR
- 目前支持的文件格式：Word (.docx)、PDF (.pdf)
- 识别结果可能存在误差，需要手动校对
- 建议使用清晰的文档格式，以提高识别准确率

## 后续优化

- 添加用户认证功能
- 优化 OCR 识别算法，提高识别准确率
- 添加题目编辑功能
- 添加题目分类和搜索功能
- 支持更多文件格式
- 优化前端页面的响应式设计