|
|
|
|
@ -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. 查看成绩
|
|
|
|
|
|
|
|
|
|
### 账户管理
|
|
|
|
|
- 修改密码
|
|
|
|
|
- 退出登录
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|