ADD file via upload

doc/说明文档.md

@@ -0,0 +1,340 @@
+\# JavaFX FXML 界面说明文档
+
+
+
+\## 项目概述
+
+本项目是一个 \*\*教育类应用程序\*\* 的 \*\*JavaFX 用户界面\*\*，包含 \*\*用户认证、学习系统和考试功能\*\* 等多个模块。
+
+
+
+---
+
+
+
+\## 界面文件列表
+
+
+
+\### 1. 用户认证模块
+
+
+
+\#### 1.1 `login.fxml` — 登录界面
+
+\- \*\*控制器:\*\* `LoginController`  
+
+\- \*\*主要功能:\*\* 用户登录  
+
+\- \*\*界面元素:\*\*
+
+  - 用户名/邮箱输入框  
+
+  - 密码输入框  
+
+  - 登录、注册、忘记密码、清空按钮  
+
+  - 状态提示标签  
+
+\- \*\*特色:\*\* 支持用户名或邮箱登录  
+
+
+
+---
+
+
+
+\#### 1.2 `register.fxml` — 注册界面
+
+\- \*\*控制器:\*\* `RegisterController`  
+
+\- \*\*主要功能:\*\* 新用户注册  
+
+\- \*\*界面元素:\*\*
+
+  - 邮箱输入框  
+
+  - 验证码输入与验证功能  
+
+  - 发送注册码按钮  
+
+  - 返回登录和清空按钮  
+
+\- \*\*流程:\*\* 邮箱验证 → 设置账户信息  
+
+
+
+---
+
+
+
+\#### 1.3 `set\_password.fxml` — 设置密码界面
+
+\- \*\*控制器:\*\* `SetPasswordController`  
+
+\- \*\*主要功能:\*\* 完成注册流程，设置用户名和密码  
+
+\- \*\*界面元素:\*\*
+
+  - 用户名输入框（2-20位）  
+
+  - 密码和确认密码输入框  
+
+  - 完成注册按钮  
+
+
+
+---
+
+
+
+\#### 1.4 `forgot\_password.fxml` — 忘记密码界面
+
+\- \*\*控制器:\*\* `ForgotPasswordController`  
+
+\- \*\*主要功能:\*\* 密码重置  
+
+\- \*\*界面元素:\*\*
+
+  - 验证码输入框  
+
+  - 新密码和确认密码输入框  
+
+  - 发送验证码和重置密码按钮  
+
+
+
+---
+
+
+
+\### 2. 用户中心模块
+
+
+
+\#### 2.1 `dashboard.fxml` — 用户中心主界面
+
+\- \*\*控制器:\*\* `DashboardController`  
+
+\- \*\*主要功能:\*\* 功能导航  
+
+\- \*\*界面元素:\*\*
+
+  - 欢迎信息标签  
+
+  - 进入学习系统按钮  
+
+  - 修改密码按钮  
+
+  - 退出登录按钮  
+
+\- \*\*设计:\*\* 采用卡片式按钮布局  
+
+
+
+---
+
+
+
+\#### 2.2 `change\_password.fxml` — 修改密码界面
+
+\- \*\*控制器:\*\* `ChangePasswordController`  
+
+\- \*\*主要功能:\*\* 登录用户修改密码  
+
+\- \*\*界面元素:\*\*
+
+  - 原密码、新密码、确认密码输入框  
+
+  - 密码规则提示（6-10位，含大小写和数字）  
+
+  - 确认修改、清空、返回按钮  
+
+
+
+---
+
+
+
+\### 3. 学习系统模块
+
+
+
+\#### 3.1 `grade\_selection.fxml` — 学段选择界面
+
+\- \*\*控制器:\*\* `GradeSelectionController`  
+
+\- \*\*主要功能:\*\* 选择学习阶段  
+
+\- \*\*界面元素:\*\*
+
+  - 小学、初中、高中选择按钮  
+
+  - 退出登录和返回用户中心按钮  
+
+\- \*\*颜色编码:\*\* 不同学段使用不同主题色  
+
+
+
+---
+
+
+
+\### 4. 考试系统模块
+
+
+
+\#### 4.1 `exam.fxml` — 考试界面
+
+\- \*\*控制器:\*\* `ExamController`  
+
+\- \*\*主要功能:\*\* 在线答题  
+
+\- \*\*界面元素:\*\*
+
+  - 进度指示器与题目编号  
+
+  - 题目内容显示区域  
+
+  - 单选按钮选项（A / B / C / D）  
+
+  - 上一题、下一题、提交试卷按钮  
+
+\- \*\*交互:\*\* 支持题目导航与进度跟踪  
+
+
+
+---
+
+
+
+\#### 4.2 `score.fxml` — 成绩显示界面
+
+\- \*\*控制器:\*\* `ScoreController`  
+
+\- \*\*主要功能:\*\* 显示考试结果  
+
+\- \*\*界面元素:\*\*
+
+  - 得分显示（大字体突出）  
+
+  - 评价标签  
+
+  - 继续做题和退出登录按钮  
+
+
+
+---
+
+
+
+\## 设计特点
+
+
+
+\### 统一的视觉风格
+
+\- \*\*主色调:\*\* `#3498db`（蓝色）  
+
+\- \*\*成功色:\*\* `#2ecc71`（绿色）  
+
+\- \*\*警告色:\*\* `#e74c3c`（红色）  
+
+\- \*\*文字色:\*\* `#2c3e50`（深蓝灰）  
+
+
+
+---
+
+
+
+
+
+\## 技术规格
+
+
+
+\### FXML 特性
+
+\- 使用 JavaFX 标准控件  
+
+\- 统一命名规范（`fx:id` 前缀）  
+
+\- 内联样式定义  
+
+\- 控制器绑定  
+
+
+
+---
+
+
+
+\### 兼容性
+
+\- 支持 \*\*JavaFX 8\*\* 及以上版本  
+
+\- 标准 \*\*FXML 1.0\*\* 格式  
+
+\- 统一编码：`UTF-8`  
+
+
+
+---
+
+
+
+\## 使用流程
+
+
+
+\### 新用户流程
+
+1\. 注册  
+
+2\. 邮箱验证  
+
+3\. 设置账户信息  
+
+4\. 登录  
+
+
+
+\### 现有用户流程
+
+1\. 登录  
+
+2\. 进入用户中心  
+
+3\. 选择功能  
+
+
+
+\### 学习流程
+
+1\. 选择学段  
+
+2\. 参加考试  
+
+3\. 查看成绩  
+
+
+
+\### 账户管理
+
+\- 修改密码  
+
+\- 退出登录  
+
+
+
+---
+
+
+
+
+
+
+
+
+