# 中小学数学卷子自动生成程序

## 项目简介

这是一个基于 C++ 开发的中小学数学卷子自动生成程序，支持小学、初中、高中三种难度，能够自动生成符合学段要求的数学题目，并为每位教师账号按时间戳保存试卷文件。

## 客户机部署步骤（详细）

本节说明如何在客户机（以 Windows 为主）部署并运行本程序。

### 一、系统要求
- 操作系统：Windows 10/11（64 位）
- 磁盘空间：至少 100 MB（用于保存试卷与历史）
- 运行权限：对安装目录具有读写权限（建议在用户目录或桌面下）

### 二、部署包内容
将以下文件放在同一目录（建议目录名如 `MathExamGenerator/`）：
- `math_exam_generator.exe`（主程序）
- `libgcc_s_seh-1.dll`（运行时依赖）
- `libstdc++-6.dll`（运行时依赖）
- `libwinpthread-1.dll`（运行时依赖）

以上三个 DLL 为 MinGW/GCC 运行时依赖，必须与可执行文件位于同一目录。

### 三、Windows 客户机部署步骤
1. 在客户机上创建目录，例如：`C:\Users\<用户名>\Desktop\MathExamGenerator`。
2. 将部署包中的 1 个可执行文件与 3 个 DLL 一并复制到该目录。
3. 首次运行方式：
   - 双击 `math_exam_generator.exe`，或
   - 在 PowerShell 中进入目录并执行：`./math_exam_generator.exe`
4. 程序将打开控制台提示登录与生成试卷（见“运行与使用”）。

### 四、运行与使用
- 登录账号（预置示例，可用于验证部署是否成功）：
  - 小学：`张三1`、`张三2`、`张三3`（密码均为 `123`）
  - 初中：`李四1`、`李四2`、`李四3`（密码均为 `123`）
  - 高中：`王五1`、`王五2`、`王五3`（密码均为 `123`）
- 登录成功后，程序会提示：
  - 输入生成题目数量（范围 `10`–`30`），如输入 `20`。
  - 支持指令切换难度：输入 `切换为小学`、`切换为初中`、`切换为高中`。
  - 输入 `-1` 退出当前登录用户并返回登录界面。
  - 按 `Ctrl+C` 可中断当前交互并安全返回主流程。

### 五、试卷保存位置与历史
- 程序会在当前工作目录下自动创建：`paper/<用户名>/`。
- 每次生成的试卷文件命名格式：`YYYY-MM-DD-HH-MM-SS.txt`（时间戳）。
- 同目录下会维护 `/.history.txt`，用于避免重复题目。

### 六、升级与卸载
- 升级：
  - 用新版本的 `math_exam_generator.exe` 直接替换旧文件（保持目录结构与 DLL 不变）。
  - 建议保留 `paper/` 目录以延续历史记录。
- 卸载：
  - 删除安装目录（例如 `MathExamGenerator/`）。
  - 如不再需要历史与试卷，可一并删除 `paper/` 目录。

### 七、常见问题（FAQ）
- 运行时报错“缺少 DLL”或“找不到入口”：
  - 请确认 `libgcc_s_seh-1.dll`、`libstdc++-6.dll`、`libwinpthread-1.dll` 与可执行文件在同一目录。
- 中文显示异常或乱码：
  - 建议在 Windows Terminal/PowerShell 中运行，程序已内置中文本地化处理；如仍异常，请尝试切换终端字体或编码。
- 无法生成试卷或提示无权限：
  - 确认安装目录对当前用户有写权限；避免使用受限制的系统目录（如 `C:\Program Files`）。
- 题目数量提示不在范围：
  - 请输入 `10`–`30` 的整数；否则程序会提示重新输入。

### 八、Linux / macOS 编译与部署（可选）
- 在具备 `g++` 的环境下编译：
  ```bash
  cd src
  make
  # 或
  g++ -std=c++17 -Wall -Wextra -O2 -o math_exam_generator main.cc app.cc auth.cc exam.cc login.cc utils.cc
  ```
- 将生成的可执行文件 `math_exam_generator` 放置到目标目录并运行：`./math_exam_generator`

## 快速开始

- 进入 `src` 目录
- Windows：运行 `./math_exam_generator.exe`
- Linux / macOS：运行 `./math_exam_generator`

## 编译（如需重新构建）

```bash
cd src
make
```

或使用手动编译：

```bash
cd src
g++ -std=c++17 -Wall -Wextra -O2 -o math_exam_generator main.cc app.cc auth.cc exam.cc login.cc utils.cc
```

## 项目结构

```
├── doc/     # 项目文档
└── src/     # 源代码与可执行文件
```

更多详细说明（功能特性、预设账号、使用步骤、试卷示例等），请参阅 `doc/README.md`。

## 作者

软件2301班 - 沈永佳