# henu

**Repository Path**: ZX666X/henu

## Basic Information

- **Project Name**: henu
- **Description**: 河大刷题宝，thank for ElysianX
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 河大刷题宝 (HenuOJ)

[![Gitee](https://img.shields.io/badge/Gitee-河大刷题宝-brightgreen?style=flat)](https://gitee.com/elysianx/henu-university)
[![Flask](https://img.shields.io/badge/Flask-2.3+-blue?style=flat)](https://flask.palletsprojects.com/)
[![Python](https://img.shields.io/badge/Python-3.10+-blue?style=flat)](https://www.python.org/)

> 河南大学免费在线题库平台

[English Version](README.md)

## ✨ 功能特性

- **学术矩阵** - 按学科分类浏览题目（理学、工学、医学、经管等）
- *[MyBlog](../MyBlog)*题目贡献** - 上传分享你的考试题目
- **笔记共享** - 与同学们分享学习笔记
- **AI 助手** - 基于智谱AI (GLM-4) 的智能问答
- **每日晨报** - 订阅每日校园新闻简报（邮件推送）
- **讨论系统** - 评论、回复、与同学们互动
- **个人主页** - 查看自己的贡献和收藏

## 🛠️ 技术栈

- **后端**: Flask, SQLite
- **前端**: HTML, CSS, JavaScript
- **AI**: 智谱AI (GLM-4)
- **邮件**: Flask-Mail
- **定时任务**: Flask-APScheduler

## 📦 安装部署

### 环境要求

- Python 3.10+
- pip

### 安装步骤

```bash
# 克隆项目
git clone https://gitee.com/elysianx/henu-university.git
cd henu-university

# 创建虚拟环境（推荐）
python -m venv .venv

# 激活虚拟环境
# Windows:
.venv\Scripts\activate
# Linux/Mac:
source .venv/bin/activate

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

# 初始化数据库
python init_db.py

# 运行项目
python app.py```

访问地址：`http://localhost:5000`

### 默认管理员账号

- 用户名：`admin`
- 密码：`123`

## 📖 使用指南

1. **注册/登录** - 创建账号开始使用
2. **浏览题目** - 通过学术矩阵按分类浏览
3. **贡献题目** - 分享你的考试题目
4. **AI 助手** - 点击右下角机器人图标获取AI解答
5. **订阅新闻** - 登录后可订阅每日校园新闻邮件推送

## 📂 项目结构

```
henu-university/
├── app.py                    # 主应用入口
├── extensions.py            # Flask 扩展初始化
├── init_db.py              # 数据库初始化
├── requirements.txt        # Python 依赖
│
├── models/                  # 数据模型
│   └── __init__.py        # User 用户模型
│
├── utils/                   # 工具函数
│   ├── database.py        # 数据库连接
│   └── files.py          # 文件处理
│
├── routes/                 # 路由模块（蓝图）
│   ├── __init__.py        # 蓝图注册
│   ├── auth.py           # 用户认证（登录/注册/登出）
│   ├── main.py           # 首页/搜索/分类
│   ├── question.py        # 题目/笔记/评论
│   ├── user.py          # 用户主页/资料
│   ├── admin.py         # 管理员后台
│   ├── file.py          # 文件下载
│   ├── notification.py  # 通知
│   ├── news.py          # 新闻/订阅
│   └── api.py           # AI/举报接口
│
├── static/                  # 静态资源
│   ├── css/             # 样式文件
│   ├── js/              # JavaScript 文件
│   └── img/             # 图片
│
├── templates/               # HTML 模板
├── uploads/                # 上传文件
└── questions.db            # SQLite 数据库
```

### 模块说明

| 模块 | 功能 |
|------|------|
| `routes/auth.py` | 用户认证（登录、注册、登出） |
| `routes/main.py` | 首页、搜索、分类页面 |
| `routes/question.py` | 题目/笔记的增删改查、评论、置顶、点赞 |
| `routes/user.py` | 个人主页、编辑资料 |
| `routes/admin.py` | 管理员审核、公告管理、举报处理 |
| `routes/file.py` | 文件下载 |
| `routes/notification.py` | 通知列表、已读标记 |
| `routes/news.py` | 新闻订阅、爬虫测试 |
| `routes/api.py` | AI问答、举报接口 |

## 🤝 贡献指南

欢迎提交 Pull Request！

## 📄 许可证

MIT License - 查看 [LICENSE](LICENSE) 文件了解详情。

## 📝 版本信息

当前版本：**V1.9**

---

## 📧 联系我们

- 邮箱：17838832656@qq.com
- Gitee：https://gitee.com/elysianx/henu-university

---

查看英文版：[README.md](README.md)