Qujini - 智能试卷生成器

🎓 Qujini 是一个免费开源的试卷生成器，专为教师和学校设计，用于管理题库并生成高度可定制的试卷。

✨ 特性亮点

• 📚 题库管理 - 轻松组织和分类题目
• 🎯 难度分级 - 支持非常简单、简单、中等、专家级四种难度
• 📝 多种题型 - 支持客观题、主观题、论述题等
• 🏷️ 主题标签 - 按主题分类，方便检索
• 📊 分数管理 - 灵活的分数范围设置
• 🎨 现代化界面 - 清新美观的用户界面
• 📱 响应式设计 - 适配各种设备屏幕

🚀 快速开始

环境要求

• Python 3.6+
• pip 包管理器

安装步骤

1. 克隆项目并进入目录

git clone https://github.com/amfoss/qujini.git
cd qujini

2. 创建并激活虚拟环境

python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows

3. 安装依赖包

pip install -r requirements.txt

4. 初始化数据库

python manage.py migrate

5. 创建管理员账户

python manage.py createsuperuser

6. 启动开发服务器

python manage.py runserver

7. 访问系统 打开浏览器访问 http://127.0.0.1:8000/admin/

📋 使用指南

试卷生成流程

1. 设置试卷信息

   • 填写试卷标题和描述
   • 选择试卷模式（自定义/预定义/系统预设）

2. 配置试卷参数

   • 设置总分值
   • 设定题目数量范围（最少/最多）
   • 选择难度分布（简单/中等/困难/随机）

3. 分配主题权重

   • 设置各主题的分数占比
   • 配置每个主题的分数范围
   • 支持主题间的逻辑组合

4. 设置题型分布

   • 配置各类题型的比例
   • 设定每种题型的数量范围
   • 设置题型的分数区间

5. 章节划分（可选）

   • 创建多个章节
   • 为每个章节分配分数和题目

6. 保存与导出

   • 保存试卷配置为预设模板
   • 导出试卷为 PDF 或 JSON 格式
   • 存储到数据库供后续使用

🛠️ 技术栈

• 后端框架: Django 2.0+
• 前端样式: 自定义 CSS3（渐变、动画、响应式）
• 富文本编辑: django-ckeditor
• 数据库: SQLite（默认）/ 支持其他关系型数据库
• 国际化: Django i18n（支持中文）

📁 项目结构

qujini/
├── questions/          # 核心应用
│   ├── models.py      # 数据模型（题目、主题、题型）
│   ├── admin.py       # 管理后台配置
│   ├── views.py       # 视图函数
│   └── static/        # 静态资源（CSS、图片）
├── templates/         # HTML 模板
│   └── admin/         # 管理后台模板覆盖
├── qujini/           # 项目配置
│   ├── settings.py   # 项目设置
│   └── urls.py       # URL 路由配置
├── manage.py         # Django 管理脚本
├── requirements.txt  # 依赖列表
└── README.md         # 项目文档

🤝 贡献指南

我们欢迎各种形式的贡献！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

开发环境搭建

# 克隆你的 fork
git clone https://github.com/YOUR_USERNAME/qujini.git

# 安装开发依赖
pip install -r requirements.txt

# 运行测试
python manage.py test

📄 许可证

本项目采用 GNU 通用公共许可证 v3.0 授权

📞 联系方式

• 💬 Gitter 社区：amfoss/Qujini
• 📧 问题反馈：请在 GitHub 提交 Issue
• 📖 文档 Wiki：项目 Wiki

🙏 致谢

感谢所有为本项目做出贡献的开发者和用户！

---

Made with ❤️ for Education

⬆ 返回顶部