diff --git a/README.md b/README.md
deleted file mode 100644
index 8d16069..0000000
--- a/README.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# math_qustion
-
diff --git a/doc/README.md b/doc/README.md
index 8d16069..ca48975 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -1,2 +1,99 @@
-# math_qustion
-
+# 中小学数学卷子自动生成程序
+
+## 一、项目概述
+
+### 1.1 项目简介
+本项目是一个中小学数学卷子自动生成程序，可以根据不同学段（小学、初中、高中）自动生成符合知识难度的数学题目，并支持题目去重、保存为文件、用户登录验证等功能。程序的核心目标是帮助教师快速生成练习题卷，减轻出题负担，提高教学效率。
+
+### 1.2 功能特点
+- 用户登录与权限管理：不同学段用户账号独立，防止越权生成题目。
+- 分学段题目生成：根据小学、初中、高中难度生成对应题目。
+- 随机出题：每次生成的题目随机，保证练习多样性。
+- 题目去重：检查历史题目，避免重复出题。
+- 文件保存：自动按用户、学段、时间生成规范文件名保存题目。
+
+---
+
+## 二、系统结构
+
+### 2.1 目录结构
+```
+中小学数学卷子自动生成程序/
+├── src
+│   ├── main.py                # 程序入口，控制整体流程
+│   ├── user_manager.py        # 用户管理与身份验证
+│   ├── file_handler.py        # 文件读写与查重
+│   └── question_generator.py  # 分学段数学题目生成
+├── doc
+│   ├── README.md
+│   └── 个人项目使用大模型后人工修改代码一览表/
+└── README.md                  # 项目总说明
+```
+
+### 2.2 核心模块
+| 模块文件             | 功能描述 |
+|----------------------|----------|
+| main.py              | 程序入口，实现登录、出题数量输入、学段切换、题目生成与保存流程 |
+| user_manager.py      | 管理用户账号、密码及对应学段，提供登录验证功能 |
+| file_handler.py      | 管理用户文件夹、题目文件保存、历史题目读取与查重 |
+| question_generator.py| 根据学段生成数学题目，支持基础运算、函数、三角函数等题型 |
+
+---
+
+## 三、运行说明
+
+### 3.1 运行环境
+- 操作系统：Windows 7/8/10/11 系统
+- 无需安装 Python 环境，直接运行可执行文件即可
+
+### 3.2 运行步骤
+1. #### 启动程序 ####
+- 双击运行 main.exe 文件，程序将在 Windows 终端中启动
+2. #### 登录流程 ####
+- 程序启动后，会提示输入用户名和密码（格式：用户名 密码，中间用空格分隔）
+- 输入正确的用户名和密码后，程序会显示当前账户对应的题目难度
+1. #### 生成题目 ####
+- 登录成功后，程序会提示输入生成题目数量（10-30 道之间）
+- 输入符合要求的数字（10-30），程序将自动生成对应数量的题目
+- 生成完成后，题目会保存到以用户名命名的文件夹（如张三1_questions/）下的文本文件中
+- 程序会预览前 3 道题目，并显示保存路径
+4. #### 切换难度 ####
+- 在输入题目数量的提示下，可输入以下指令切换题目难度：
+  (1)输入 "切换为小学"：生成小学难度题目（包含 +、-、*、/ 和括号）
+  (2)输入 "切换为初中"：生成初中难度题目（包含平方、开根号及小学难度所有运算）
+  (3)输入 "切换为高中"：生成高中难度题目（包含 sin、cos、tan 三角函数及初中难度所有运算）
+5. #### 退出登录 ####
+- 在输入题目数量的提示下，输入 "-1" 可退出当前用户登录，返回初始登录界面
+
+### 3.3 预设用户
+| 用户名 | 密码 | 学段 |
+|--------|------|------|
+| 张三1  | 123  | 小学 |
+| 张三2  | 123  | 小学 |
+| 张三3  | 123  | 小学 |
+| 李四1  | 123  | 初中 |
+| 李四2  | 123  | 初中 |
+| 李四3  | 123  | 初中 |
+| 王五1  | 123  | 高中 |
+| 王五2  | 123  | 高中 |
+| 王五3  | 123  | 高中 |
+
+---
+
+## 四、文件保存说明
+- 生成的题目文件会保存在程序运行目录下的[用户名]_questions文件夹中
+- 文件名格式为[当前时间]_[难度类型].txt，例如2023-10-01-15-30-45_小学.txt
+- 每个题目文件中包含生成的所有题目，每题带有题号，题目之间用空行分隔
+
+## 五、开发协作规范
+
+### 5.1 分支管理
+- **main**：稳定版本，仅合并测试通过的代码
+- **develop**：开发主线，集成最新功能  
+
+## 六、 注意事项
+1. 用户名可以包含空格，但密码不能包含空格
+2. 题目数量必须在 10-30 道之间，否则会提示输入无效
+3. 程序会自动检查重复题目，确保生成的题目与历史题目不重复
+4. 生成的除法题目保证除数不为 0 且能整除，避免出现小数结果
+5. 若程序运行过程中出现错误，会在终端中显示错误信息
\ No newline at end of file