Update README.md

fanwen_branch
hnu202304060319 6 months ago
parent a812c53b97
commit a7c6b3870f

@ -1,2 +1,183 @@
# partner_program
# 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`(深蓝灰)
---
### 响应式布局
- 使用 `AnchorPane``VBox` / `HBox` 组合布局
- 固定尺寸设计(`400x300` 至 `600x500`
- 统一的边距与内边距
---
### 用户体验优化
- 清晰的提示文本
- 状态反馈机制
- 合理的按钮分组与间距
- 文本自动换行支持
---
## 技术规格
### FXML 特性
- 使用 JavaFX 标准控件
- 统一命名规范(`fx:id` 前缀)
- 内联样式定义
- 控制器绑定
---
### 兼容性
- 支持 **JavaFX 8** 及以上版本
- 标准 **FXML 1.0** 格式
- 统一编码:`UTF-8`
---
## 使用流程
### 新用户流程
1. 注册
2. 邮箱验证
3. 设置账户信息
4. 登录
### 现有用户流程
1. 登录
2. 进入用户中心
3. 选择功能
### 学习流程
1. 选择学段
2. 参加考试
3. 查看成绩
### 账户管理
- 修改密码
- 退出登录
---

Loading…
Cancel
Save