From 13591f1e31da4a7563ff06a1f7d60e2869a278dc Mon Sep 17 00:00:00 2001 From: zlwu <704541015@qq.com> Date: Fri, 1 Aug 2025 08:41:26 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E5=AD=A6=E7=94=9F=E8=8A=B1?= =?UTF-8?q?=E5=90=8D=E5=86=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...e-adjust-record-2025-01-27-ai-assistant.md | 423 ++++++ .../code-adjust-record-2025-01-27-cursor.md | 1052 ++------------ ...025-01-27-stuRoster-card-pagination-fix.md | 171 +++ ...025-01-27-stuRoster-table-scrollbar-fix.md | 174 +++ .../code-adjust-record-2025-01-27-wuzilong.md | 153 +- .../code-adjust-record-2025-07-31-wuzilong.md | 118 +- web/.eslintrc-auto-import.json | 323 +++++ web/src/views/xg/xsjcxx/stuRoster/README.md | 202 +++ .../components/AdvancedSearchDialog.vue | 786 +++++++++++ .../components/StudentDetailDialog.vue | 891 ++++++++++++ web/src/views/xg/xsjcxx/stuRoster/index.vue | 1233 +++++++++++++++++ 11 files changed, 4412 insertions(+), 1114 deletions(-) create mode 100644 docs/变更管理/code-adjust-record-2025-01-27-ai-assistant.md create mode 100644 docs/变更管理/code-adjust-record-2025-01-27-stuRoster-card-pagination-fix.md create mode 100644 docs/变更管理/code-adjust-record-2025-01-27-stuRoster-table-scrollbar-fix.md create mode 100644 web/src/views/xg/xsjcxx/stuRoster/README.md create mode 100644 web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue create mode 100644 web/src/views/xg/xsjcxx/stuRoster/components/StudentDetailDialog.vue create mode 100644 web/src/views/xg/xsjcxx/stuRoster/index.vue diff --git a/docs/变更管理/code-adjust-record-2025-01-27-ai-assistant.md b/docs/变更管理/code-adjust-record-2025-01-27-ai-assistant.md new file mode 100644 index 00000000..f2d524d5 --- /dev/null +++ b/docs/变更管理/code-adjust-record-2025-01-27-ai-assistant.md @@ -0,0 +1,423 @@ +# 高级检索界面字典数据获取方式优化 - 2025-01-27 + +## 📋 变更概述 + +**变更时间**: 2025-01-27 14:30:00 +**变更人员**: AI Assistant +**变更类型**: 代码优化 +**影响范围**: 高级检索界面字典数据获取方式 + +## 🎯 变更目标 + +参考 `stuMsgDialog.vue` 界面的字典数据获取方式，将高级检索界面中的硬编码字典数据替换为使用 `proxy?.useDict` 动态获取字典数据的方式，提高代码的一致性和可维护性。 + +## 📝 具体变更内容 + +### 1. 文件路径 +``` +web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue +``` + +### 2. 主要变更点 + +#### 2.1 导入模块变更 +```typescript +// 变更前 +import { ref, reactive, watch, computed } from 'vue'; + +// 变更后 +import { ref, reactive, watch, computed, getCurrentInstance, toRefs } from 'vue'; +``` + +#### 2.2 字典数据获取方式变更 +```typescript +// 变更前 - 硬编码字典数据 +const sys_user_sex = ref([ + { value: '0', label: '男' }, + { value: '1', label: '女' } +]); + +const nationality_options = ref([ + { value: '01', label: '汉族' }, + // ... 大量硬编码数据 +]); + +// 变更后 - 使用proxy?.useDict动态获取 +const { proxy } = getCurrentInstance() as any; + +const { + sys_user_sex, + xg_nation, + xg_political_status, + marital_status, + admission_category, + zsjy_education_level, + xg_training_mode, + house_hold_register_type, + student_status, + xg_family_economic, + sys_yesno, + xg_blood_type, + disability_type, + wenhuachengdu +} = toRefs( + proxy?.useDict( + 'sys_user_sex', + 'xg_nation', + 'xg_political_status', + 'marital_status', + 'admission_category', + 'zsjy_education_level', + 'xg_training_mode', + 'house_hold_register_type', + 'student_status', + 'xg_family_economic', + 'sys_yesno', + 'xg_blood_type', + 'disability_type', + 'wenhuachengdu' + ) +); +``` + +#### 2.3 模板中字典引用变更 +```vue + + + + + +``` + +### 3. 涉及的字典字段映射 + +| 原字段名 | 新字段名 | 字典类型 | 说明 | +|---------|---------|---------|------| +| `nationality_options` | `xg_nation` | 民族字典 | 学生民族信息 | +| `political_status` | `xg_political_status` | 政治面貌字典 | 学生政治面貌 | +| `marital_status` | `marital_status` | 婚姻状况字典 | 学生婚姻状况 | +| `academic_level` | `zsjy_education_level` | 学历层次字典 | 学生学历层次 | +| `training_type` | `xg_training_mode` | 培养方式字典 | 学生培养方式 | +| `household_register_type` | `house_hold_register_type` | 户口类型字典 | 学生户口类型 | +| `student_status` | `student_status` | 学籍状态字典 | 学生学籍状态 | +| `family_economic_status` | `xg_family_economic` | 家庭经济状况字典 | 学生家庭经济状况 | +| `yes_no` | `sys_yesno` | 是否字典 | 通用是否选项 | +| `blood_type` | `xg_blood_type` | 血型字典 | 学生血型信息 | +| `disability_type` | `disability_type` | 残疾类型字典 | 学生残疾类型 | + +### 4. 保留的硬编码字典 + +由于以下字典在系统中没有对应的字典类型，暂时保留硬编码： + +```typescript +// 学制选项 - 由于没有对应的字典，保留硬编码 +const school_system = ref([ + { value: '3', label: '3年' }, + { value: '4', label: '4年' }, + { value: '5', label: '5年' } +]); + +// 残疾等级选项 - 由于没有对应的字典，保留硬编码 +const disability_level = ref([ + { value: '一级', label: '一级' }, + { value: '二级', label: '二级' }, + { value: '三级', label: '三级' }, + { value: '四级', label: '四级' } +]); +``` + +## ✅ 变更效果 + +### 1. 代码一致性提升 +- 与 `stuMsgDialog.vue` 保持相同的字典数据获取方式 +- 统一使用 `proxy?.useDict` 动态获取字典数据 + +### 2. 可维护性提升 +- 字典数据统一管理，避免硬编码 +- 字典变更时无需修改前端代码 +- 减少代码重复和维护成本 + +### 3. 数据准确性提升 +- 字典数据与后端保持同步 +- 避免前后端字典数据不一致的问题 + +## 🔍 测试验证 + +### 1. 功能测试 +- [x] 高级检索界面正常打开 +- [x] 所有下拉框选项正常显示 +- [x] 字典数据正确加载 +- [x] 检索功能正常工作 + +### 2. 兼容性测试 +- [x] 与现有功能兼容 +- [x] 不影响其他模块 + +## 📚 相关文档 + +- 参考文件: `web/src/views/xg/xsjcxx/stuMsgSupply/stuMsgDialog.vue` +- 字典管理规范: `.cursor/cursorrules-backend.md` + +## 🎯 后续优化建议 + +1. **字典完善**: 建议为 `school_system` 和 `disability_level` 创建对应的字典类型 +2. **统一规范**: 建议在其他界面中也采用相同的字典数据获取方式 +3. **文档更新**: 更新相关API文档，说明字典数据的使用方式 + +--- + +**变更完成时间**: 2025-01-27 14:45:00 +**变更状态**: ✅ 已完成 +**审核状态**: ⏳ 待审核 + +--- + +# 高级检索界面添加文化程度字段 - 2025-01-27 + +## 📋 变更概述 + +**变更时间**: 2025-01-27 15:00:00 +**变更人员**: AI Assistant +**变更类型**: 功能增强 +**影响范围**: 高级检索界面基础信息部分 + +## 🎯 变更目标 + +在高级检索界面的基础信息部分，在宗教信仰字段后面添加文化程度下拉框，提供更全面的学生信息检索条件。 + +## 📝 具体变更内容 + +### 1. 文件路径 +``` +web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue +``` + +### 2. 主要变更点 + +#### 2.1 模板变更 +在基础信息部分的宗教信仰字段后面添加文化程度下拉框： + +```vue + + + + + + + + +``` + +#### 2.2 数据模型变更 +在formData中添加educationLevel字段： + +```typescript +const formData = reactive({ + // 基础信息 + // ... 其他字段 + educationLevel: '', // 新增文化程度字段 + // ... 其他字段 +}); +``` + +### 3. 字段说明 + +| 字段名 | 类型 | 字典类型 | 说明 | +|--------|------|----------|------| +| `educationLevel` | string | `wenhuachengdu` | 学生文化程度 | + +### 4. 字典数据来源 +使用已有的 `wenhuachengdu` 字典数据，包含： +- 小学、初中、高中、中专、大专、本科、硕士、博士等选项 + +## ✅ 变更效果 + +### 1. 功能增强 +- 新增文化程度检索条件 +- 提供更全面的学生信息检索功能 + +### 2. 界面优化 +- 保持与现有字段一致的布局风格 +- 使用统一的下拉框组件和字典数据 + +### 3. 数据一致性 +- 与 `stuMsgDialog.vue` 中的文化程度字段保持一致 +- 使用相同的字典数据源 + +## 🔍 测试验证 + +### 1. 功能测试 +- [x] 文化程度下拉框正常显示 +- [x] 字典数据正确加载 +- [x] 选择功能正常工作 +- [x] 清空功能正常工作 +- [x] 检索功能包含文化程度条件 + +### 2. 界面测试 +- [x] 布局美观，与其他字段对齐 +- [x] 响应式布局正常 + +## 📚 相关文档 + +- 参考文件: `web/src/views/xg/xsjcxx/stuMsgSupply/stuMsgDialog.vue` +- 字典类型: `wenhuachengdu` (文化程度字典) + +--- + +**变更完成时间**: 2025-01-27 15:05:00 +**变更状态**: ✅ 已完成 +**审核状态**: ⏳ 待审核 + +## 2025-01-27 高级检索界面多选下拉框优化 + +### 📋 变更概述 +将学生花名册高级检索界面中选项数量超过2个的下拉框改为多选下拉框，提升检索功能的灵活性和用户体验。 + +### 🔧 具体变更 + +#### 1. 多选下拉框字段列表 +以下字段从单选改为多选（添加 `multiple collapse-tags collapse-tags-tooltip` 属性）： + +**基础信息模块**： +- 民族 (`nationality`) - 56个选项 +- 政治面貌 (`politicalStatus`) - 13个选项 +- 文化程度 (`educationLevel`) - 多个选项 +- 婚姻状况 (`maritalStatus`) - 4个选项 +- 户口类型 (`householdRegisterType`) - 2个选项 + +**学籍信息模块**： +- 录取类别 (`admissionCategory`) - 多个选项 +- 学历层次 (`academicLevel`) - 多个选项 +- 培养方式 (`trainingType`) - 6个选项 +- 学籍状态 (`studentStatus`) - 5个选项 +- 是否住校 (`isBoarder`) - 2个选项 + +**家庭信息模块**： +- 家庭经济状况 (`familyEconomicStatus`) - 4个选项 + +**扩展信息模块**： +- 是否贫困生 (`isPoorStudent`) - 2个选项 +- 是否少数民族 (`isMinority`) - 2个选项 +- 是否残疾 (`isDisabled`) - 2个选项 +- 是否孤儿 (`isOrphan`) - 2个选项 +- 是否留守儿童 (`isLeftBehindChild`) - 2个选项 +- 是否独生子女 (`isSingleChild`) - 2个选项 +- 是否低保 (`isLowIncome`) - 2个选项 +- 是否有助学贷款 (`hasLoan`) - 2个选项 + +**健康信息模块**： +- 血型 (`bloodType`) - 5个选项 +- 残疾类型 (`disabilityType`) - 多个选项 +- 残疾等级 (`disabilityLevel`) - 改为输入框 + +#### 2. 数据结构调整 + +**表单数据类型变更**： +```typescript +// 变更前 +nationality: '', +politicalStatus: '', +maritalStatus: '', +disabilityLevel: [] as string[], + +// 变更后 +nationality: [] as string[], +politicalStatus: [] as string[], +maritalStatus: [] as string[], +disabilityLevel: '', // 改为字符串类型 +``` + +#### 3. 功能优化 + +**重置功能优化**： +- 多选字段重置为空数组 `[]` +- 数字字段重置为 `null` +- 字符串字段重置为空字符串 `''` + +**数据同步优化**： +- 监听props变化时，确保多选字段正确处理数组格式 +- 支持从单选值自动转换为数组格式 + +### 🎯 变更效果 + +#### 用户体验提升 +1. **检索灵活性**：支持同时选择多个选项进行检索 +2. **界面友好性**：使用 `collapse-tags` 和 `collapse-tags-tooltip` 优化多选显示 +3. **操作便捷性**：一键清空所有选择，支持批量操作 + +#### 功能增强 +1. **多条件检索**：可以同时检索多个民族、政治面貌等条件 +2. **精确匹配**：支持精确的多值匹配检索 +3. **数据完整性**：保持与后端API的数据格式一致性 + +### 📁 涉及文件 +- `web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue` + +### ✅ 测试建议 +1. 测试多选下拉框的选择和取消功能 +2. 测试多选数据的检索功能 +3. 测试重置功能是否正确清空多选字段 +4. 测试与父组件的数据同步功能 +5. 测试残疾等级输入框的输入和清空功能 + +--- + +**变更时间**: 2025-01-27 15:30:00 +**变更人员**: AI Assistant +**变更类型**: 功能优化 +**影响范围**: 学生花名册高级检索界面 + +--- + +## 2025-01-27 残疾等级字段优化 + +### 📋 变更概述 +将高级检索界面中的残疾等级字段从多选下拉框改为输入框，提供更灵活的检索方式。 + +### 🔧 具体变更 + +#### 1. 界面组件变更 +- **残疾等级字段**：从 `el-select` 多选下拉框改为 `el-input` 输入框 +- **移除硬编码选项**：删除不再使用的 `disability_level` 选项数组 + +#### 2. 数据结构调整 +```typescript +// 变更前 +disabilityLevel: [] as string[], + +// 变更后 +disabilityLevel: '', +``` + +#### 3. 功能优化 +- 支持自由输入残疾等级信息 +- 支持模糊匹配检索 +- 保持清空功能 + +### 🎯 变更效果 + +#### 用户体验提升 +1. **输入灵活性**：支持任意残疾等级文本输入 +2. **检索精确性**：支持模糊匹配和精确匹配 +3. **操作简便性**：直接输入，无需选择固定选项 + +#### 功能增强 +1. **自由检索**：不再受限于固定的4个等级选项 +2. **扩展性**：支持更多残疾等级分类 +3. **兼容性**：与现有数据格式保持兼容 + +### 📁 涉及文件 +- `web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue` + +### ✅ 测试建议 +1. 测试残疾等级输入框的输入功能 +2. 测试输入内容的清空功能 +3. 测试与检索功能的集成 +4. 测试数据同步功能 + +--- + +**变更时间**: 2025-01-27 16:00:00 +**变更人员**: AI Assistant +**变更类型**: 功能优化 +**影响范围**: 学生花名册高级检索界面 \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-01-27-cursor.md b/docs/变更管理/code-adjust-record-2025-01-27-cursor.md index 48db5cd0..a7ee7fd0 100644 --- a/docs/变更管理/code-adjust-record-2025-01-27-cursor.md +++ b/docs/变更管理/code-adjust-record-2025-01-27-cursor.md @@ -1,964 +1,88 @@ -# 代码调整记录 - 2025-01-27 - cursor - -## 📝 变更记录 - -### 2025-01-27 17:00:00 - 班级干部信息管理页面添加离任功能 - -**变更内容**: 在班级干部信息管理页面的表格操作栏中新增离任按钮和离任对话框功能 - -**涉及文件**: -- `web/src/views/xgClassPosMsg/xgClassPosMsg/index.vue` -- `web/src/api/xgClassPosMsg/xgClassPosMsg/index.ts` - -**具体修改**: - -#### 1. 前端页面修改 -- **文件**: `web/src/views/xgClassPosMsg/xgClassPosMsg/index.vue` -- **修改**: 在表格操作栏中添加离任按钮，并创建离任对话框 -- **功能特性**: - - 离任按钮只有在任状态（cadreStatus为'1'）时才可点击 - - 离任对话框显示当前学生的基本信息（只读） - - 可填写离任相关信息：任期结束日期、任职状态、离任原因 - - 支持的状态选项：2-到期、3-辞职、4-免职、5-调任、6-休学 - -#### 2. API接口扩展 -- **文件**: `web/src/api/xgClassPosMsg/xgClassPosMsg/index.ts` -- **修改**: 添加离任API接口（暂时使用updateXgClassPosMsg） -- **接口定义**: -```typescript -export const dismissXgClassPosMsg = (data: XgClassPosMsgForm) => { - return request({ - url: '/xgClassPosMsg/xgClassPosMsg/dismiss', - method: 'put', - data: data - }); -}; -``` - -#### 3. 离任功能实现细节 -- **按钮控制**: 通过 `:disabled="scope.row.cadreStatus !== '1'"` 控制按钮可用性 -- **表单验证**: 对任期结束日期、任职状态、离任原因进行必填验证 -- **数据更新**: 离任时自动设置 `isCurrent: 0`（非现任）和 `dismissalDate` -- **用户体验**: 提供加载状态、成功/失败提示、表单重置等功能 - -#### 4. 离任对话框字段说明 -- **只读字段**: 学号、学生姓名、职务名称、任职开始日期 -- **可编辑字段**: 任期结束日期、学生职务任职状态、离任原因 -- **默认值**: 任期结束日期默认为当前日期 - -### 2025-01-27 16:30:00 - 班级干部信息编辑时显示问题修复 - -**变更内容**: 修复编辑班级干部信息时班级名称显示为空、职务名称显示职务编码的问题 - -**涉及文件**: -- `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosMsgVo.java` -- `backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosMsg/XgClassPosMsgMapper.xml` -- `web/src/api/xgClassPosMsg/xgClassPosMsg/types.ts` -- `web/src/views/xgClassPosMsg/xgClassPosMsg/index.vue` - -**具体修改**: - -#### 1. 后端VO类修改 -- **文件**: `XgClassPosMsgVo.java` -- **修改**: 添加 `className` 字段，用于存储班级的中文名称 -- **字段定义**: -```java -/** - * 班级名称（联表查询获取） - */ -@ExcelProperty(value = "班级名称") -private String className; -``` - -#### 2. Mapper.xml联表查询优化 -- **文件**: `XgClassPosMsgMapper.xml` -- **修改**: 添加班级表的联表查询，获取班级名称 -- **核心SQL**: -```xml - - select cpm.id, cpm.deleted, cpm.class_id, cm.class_name, cpm.student_id, cpm.student_no, cpm.student_name, - cpm.position_code, cpd.position_name, cpm.appointment_date, cpm.term_start_date, - cpm.term_end_date, cpm.term_duration, cpm.is_current, cpm.cadre_status, - cpm.appointment_reason, cpm.appointment_method, cpm.dismissal_date, cpm.dismissal_reason, - cpm.remark, cpm.create_by, cpm.create_time, cpm.update_by, cpm.update_time - from xg_class_pos_msg cpm - left join xg_class_msg cm on cpm.class_id = cm.id and cm.deleted = 0 - left join xg_class_pos_dict cpd on cpm.position_code = cpd.position_code and cpd.deleted = 0 - where cpm.deleted = 0 - -``` - -#### 3. 前端类型定义修改 -- **文件**: `types.ts` -- **修改**: 在 `XgClassPosMsgVO` 和 `XgClassPosMsgForm` 接口中添加 `className` 和 `positionName` 字段 -- **字段定义**: -```typescript -/** - * 班级名称（联表查询获取） - */ -className: string; - -/** - * 职务名称（联表查询获取） - */ -positionName: string; -``` - -#### 4. 前端页面显示优化 -- **文件**: `index.vue` -- **修改**: 在编辑对话框中正确显示班级名称和职务名称 -- **实现方式**: 优先使用后端返回的数据，如果没有则从当前选中的节点获取 - -## 🎯 功能验证 - -### 离任功能验证要点 -1. **按钮状态**: 只有在任状态的记录才显示可点击的离任按钮 -2. **表单验证**: 必填字段验证正常工作 -3. **数据更新**: 离任后状态正确更新为对应的离任状态 -4. **用户体验**: 操作流程顺畅，提示信息准确 - -### 编辑功能验证要点 -1. **班级名称显示**: 编辑时正确显示班级的中文名称 -2. **职务名称显示**: 编辑时正确显示职务的中文名称 -3. **数据完整性**: 所有字段都能正确显示和编辑 - -## 📋 后续优化建议 - -### 离任功能优化 -1. **后端API**: 实现专门的离任API接口，处理离任相关的业务逻辑 -2. **权限控制**: 添加离任操作的权限控制 -3. **日志记录**: 记录离任操作的详细日志 -4. **通知功能**: 离任后自动通知相关人员 - -### 编辑功能优化 -1. **数据缓存**: 优化班级和职务数据的缓存机制 -2. **性能优化**: 优化联表查询的性能 -3. **错误处理**: 完善异常情况的处理机制 - -### 2025-01-27 17:45:00 - 班级干部信息添加专业和学院关联查询 - -**变更内容**: 在班级干部信息查询中添加与sys_dept表的关联，获取专业和学院信息 - -**涉及文件**: -- `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosMsgVo.java` -- `backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosMsg/XgClassPosMsgMapper.xml` -- `web/src/api/xgClassPosMsg/xgClassPosMsg/types.ts` - -**具体修改**: - -#### 1. 后端VO类修改 -- **文件**: `XgClassPosMsgVo.java` -- **修改**: 添加专业和学院相关字段 -- **新增字段**: -```java -/** - * 专业ID，关联sys_dept.dept_id - */ -@ExcelProperty(value = "专业ID") -private Long majorId; - -/** - * 专业名称（联表查询获取） - */ -@ExcelProperty(value = "专业名称") -private String majorName; - -/** - * 学院ID，关联sys_dept.dept_id - */ -@ExcelProperty(value = "学院ID") -private Long collegeId; - -/** - * 学院名称（联表查询获取） - */ -@ExcelProperty(value = "学院名称") -private String collegeName; -``` - -#### 2. Mapper.xml联表查询优化 -- **文件**: `XgClassPosMsgMapper.xml` -- **修改**: 添加与sys_dept表的关联查询，获取专业和学院信息 -- **resultMap修改**: 添加专业和学院字段映射 -- **核心SQL修改**: -```xml - - select cpm.id, cpm.deleted, cpm.class_id, cm.class_name, - cm.major_id, dm.dept_name as major_name, - cm.college_id, dc.dept_name as college_name, - cpm.student_id, cpm.student_no, cpm.student_name, - cpm.position_code, cpd.position_name, cpm.appointment_date, cpm.term_start_date, - cpm.term_end_date, cpm.term_duration, cpm.is_current, cpm.cadre_status, - cpm.appointment_reason, cpm.appointment_method, cpm.dismissal_date, cpm.dismissal_reason, - cpm.remark, cpm.create_by, cpm.create_time, cpm.update_by, cpm.update_time, - cpm.position_id - from xg_class_pos_msg cpm - left join xg_class_msg cm on cpm.class_id = cm.id and cm.deleted = 0 - left join xg_class_pos_dict cpd on cpm.position_code = cpd.position_code and cpd.deleted = 0 - left join sys_dept dm on cm.major_id = dm.dept_id and dm.del_flag = '0' - left join sys_dept dc on cm.college_id = dc.dept_id and dc.del_flag = '0' - -``` - -#### 3. 前端类型定义修改 -- **文件**: `types.ts` -- **修改**: 在 `XgClassPosMsgVO` 和 `XgClassPosMsgForm` 接口中添加专业和学院字段 -- **新增字段**: -```typescript -/** - * 专业ID，关联sys_dept.dept_id - */ -majorId: string | number; - -/** - * 专业名称（联表查询获取） - */ -majorName: string; - -/** - * 学院ID，关联sys_dept.dept_id - */ -collegeId: string | number; - -/** - * 学院名称（联表查询获取） - */ -collegeName: string; -``` - -**技术说明**: -- 通过`xg_class_msg`表的`college_id`和`major_id`字段关联`sys_dept`表 -- 使用`sys_dept.dept_name`获取学院名称和专业名称 -- 添加`del_flag = '0'`条件确保只查询未删除的部门记录 -- 保持与现有查询逻辑的一致性，使用LEFT JOIN避免数据丢失 - -**影响范围**: -- 班级干部信息列表查询将显示专业和学院信息 -- 班级干部信息详情查询将包含专业和学院字段 -- 前端页面可以展示更完整的班级干部信息 - -**验证方法**: -1. 启动后端服务，测试班级干部信息查询接口 -2. 检查返回数据是否包含专业和学院信息 -3. 验证前端页面是否正确显示新增字段 - -## 变更概述 -修改 `XgStudentMsgServiceImpl.getUserAuthDeptIds` 方法中的第四步权限获取逻辑，从 `xg_class_teacher_counselor_rel` 表改为从 `xg_class_msg` 表获取权限信息。 - -## 变更详情 - -### 修改文件 -- `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgStudentMsgServiceImpl.java` - -### 变更内容 - -#### 1. 添加依赖注入 -- 添加 `XgClassMsgMapper` 的导入 -- 添加 `XgClassMsg` 实体类的导入 -- 在类字段中添加 `XgClassMsgMapper` 的依赖注入 - -#### 2. 修改权限获取逻辑 -**原逻辑（第四步）**： -```java -// 第四步：通过xg_class_teacher_counselor_rel，teacher_id=当前登录人id，deleted=0，获取class_id -LambdaQueryWrapper relWrapper = Wrappers.lambdaQuery(); -relWrapper.eq(XgClassTeacherCounselorRel::getTeacherId, userId) - .eq(XgClassTeacherCounselorRel::getTeacherType, "class_teacher") - .eq(XgClassTeacherCounselorRel::getDeleted, 0L); - -List relations = xgClassTeacherCounselorRelMapper.selectList(relWrapper); -for (XgClassTeacherCounselorRel relation : relations) { - if (relation.getClassId() != null) { - authDeptIds.add(relation.getClassId()); - } -} -``` - -**新逻辑（第四步）**： -```java -// 第四步：通过xg_class_msg表，class_teacher_id=当前登录人id，deleted='0'，class_status='1'，获取id -LambdaQueryWrapper classWrapper = Wrappers.lambdaQuery(); -classWrapper.eq(XgClassMsg::getClassTeacherId, userId) - .eq(XgClassMsg::getDeleted, 0L) - .eq(XgClassMsg::getClassStatus, "1"); - -List classes = xgClassMsgMapper.selectList(classWrapper); -for (XgClassMsg classMsg : classes) { - if (classMsg.getId() != null) { - authDeptIds.add(classMsg.getId()); - } -} -``` - -### 变更原因 -根据用户需求，将权限获取方式从关联表查询改为直接从班级信息表查询，提高查询效率并简化逻辑。 - -### SQL查询对比 -**原SQL逻辑**： -```sql -SELECT class_id FROM xg_class_teacher_counselor_rel -WHERE teacher_id = 当前登录人id -AND deleted = 0 -AND teacher_type = 'class_teacher' -``` - -**新SQL逻辑**： -```sql -SELECT id FROM xg_class_msg -WHERE class_teacher_id = 当前登录人id -AND deleted = '0' -AND class_status = '1' -``` - -### 影响范围 -- 学生信息管理模块的权限过滤功能 -- 班主任权限范围内的学生信息查询 -- 组织架构相关的权限控制 - -### 测试建议 -1. 验证班主任用户登录后能正确获取其管理的班级权限 -2. 验证学生信息查询功能在权限过滤后正常工作 -3. 确认全校管理员权限不受影响 - -## 变更时间 -2025-01-27 14:30:00 - -## 变更人员 -Cursor AI - -## 备注 -此次变更是对权限获取逻辑的优化，从多表关联查询改为单表直接查询，提高了查询效率。 - -# 题库界面变量前缀调整变更记录 - -**变更时间**: 2025-01-27 14:30:00 -**变更人员**: Cursor AI -**变更文件**: `web/src/views/hq/myddc/satQuestion/index.vue` - -## 变更原因 - -题库界面与其他界面存在变量名冲突，导致打开时出现白屏问题。为避免命名冲突，需要对所有变量和组件名称统一添加 `sq_` 前缀。 - -## 变更内容 - -### 1. 变量名称前缀化调整 - -#### 响应式变量 -- `proxy` → `sq_proxy` -- `satQuestionList` → `sq_satQuestionList` -- `satCategoryList` → `sq_satCategoryList` -- `satCategoryAllList` → `sq_satCategoryAllList` -- `buttonLoading` → `sq_buttonLoading` -- `loading` → `sq_loading` -- `showSearch` → `sq_showSearch` -- `ids` → `sq_ids` -- `single` → `sq_single` -- `multiple` → `sq_multiple` -- `total` → `sq_total` - -#### 表单引用 -- `queryFormRef` → `sq_queryFormRef` -- `satQuestionFormRef` → `sq_satQuestionFormRef` - -#### 对话框对象 -- `dialog` → `sq_dialog` -- `optionDialog` → `sq_optionDialog` - -#### 表单数据 -- `initFormData` → `sq_initFormData` -- `data` → `sq_data` -- `queryParams` → `sq_queryParams` -- `form` → `sq_form` -- `rules` → `sq_rules` - -#### 字典变量 -- `sys_question_category` → `sq_sys_question_category` -- `sys_item_enable` → `sq_sys_item_enable` -- `sys_item_required` → `sq_sys_item_required` -- `sys_item_delete` → `sq_sys_item_delete` - -#### DOM引用 -- `toolbarRef` → `sq_toolbarRef` -- `searchRef` → `sq_searchRef` - -### 2. 函数名称前缀化调整 - -#### 核心功能函数 -- `getList` → `sq_getList` -- `getCategoryList` → `sq_getCategoryList` -- `getAllCategoryList` → `sq_getAllCategoryList` -- `cancel` → `sq_cancel` -- `reset` → `sq_reset` -- `handleQuery` → `sq_handleQuery` -- `resetQuery` → `sq_resetQuery` -- `handleSelectionChange` → `sq_handleSelectionChange` -- `handleAdd` → `sq_handleAdd` -- `handleUpdate` → `sq_handleUpdate` -- `submitForm` → `sq_submitForm` -- `handleDelete` → `sq_handleDelete` -- `handleExport` → `sq_handleExport` - -#### 选项管理函数 -- `handleOptionManage` → `sq_handleOptionManage` -- `addOption` → `sq_addOption` -- `addDefaultOptions` → `sq_addDefaultOptions` -- `removeOption` → `sq_removeOption` -- `saveOptions` → `sq_saveOptions` - -### 3. 模板绑定调整 - -#### 事件绑定 -- `@click="handleQuery"` → `@click="sq_handleQuery"` -- `@click="resetQuery"` → `@click="sq_resetQuery"` -- `@click="handleAdd"` → `@click="sq_handleAdd"` -- `@click="handleUpdate()"` → `@click="sq_handleUpdate()"` -- `@click="handleDelete()"` → `@click="sq_handleDelete()"` -- `@click="handleExport"` → `@click="sq_handleExport"` -- `@click="handleOptionManage(scope.row)"` → `@click="sq_handleOptionManage(scope.row)"` -- `@click="addOption"` → `@click="sq_addOption"` -- `@click="addDefaultOptions"` → `@click="sq_addDefaultOptions"` -- `@click="removeOption(scope.$index)"` → `@click="sq_removeOption(scope.$index)"` -- `@click="saveOptions"` → `@click="sq_saveOptions"` -- `@click="submitForm"` → `@click="sq_submitForm"` -- `@click="cancel"` → `@click="sq_cancel"` - -#### 数据绑定 -- `v-model="queryParams.xxx"` → `v-model="sq_queryParams.xxx"` -- `v-model="form.xxx"` → `v-model="sq_form.xxx"` -- `:data="satQuestionList"` → `:data="sq_satQuestionList"` -- `v-loading="loading"` → `v-loading="sq_loading"` -- `v-show="showSearch"` → `v-show="sq_showSearch"` -- `:disabled="single"` → `:disabled="sq_single"` -- `:disabled="multiple"` → `:disabled="sq_multiple"` -- `:loading="buttonLoading"` → `:loading="sq_buttonLoading"` -- `:total="total"` → `:total="sq_total"` -- `:title="dialog.title"` → `:title="sq_dialog.title"` -- `v-model="dialog.visible"` → `v-model="sq_dialog.visible"` -- `:data="optionDialog.options"` → `:data="sq_optionDialog.options"` -- `:loading="optionDialog.saveLoading"` → `:loading="sq_optionDialog.saveLoading"` - -#### 引用绑定 -- `ref="queryFormRef"` → `ref="sq_queryFormRef"` -- `ref="satQuestionFormRef"` → `ref="sq_satQuestionFormRef"` -- `ref="toolbarRef"` → `ref="sq_toolbarRef"` -- `ref="searchRef"` → `ref="sq_searchRef"` - -### 4. 代码优化 - -#### 导入语句优化 -- 添加了必要的Vue 3 Composition API导入 -- 定义了类型接口 `DialogOption` 和 `PageData` -- 修复了 `ComponentInternalInstance` 类型问题 - -#### 分页组件修复 -- 修复了 `v-model:page` 和 `v-model:limit` 的语法问题 -- 改为使用 `:page` 和 `:limit` 属性绑定 - -#### 样式优化 -- 修复了CSS嵌套语法问题 -- 保持了原有的样式效果 - -## 变更效果 - -### 解决的问题 -1. ✅ 消除了与其他界面的变量名冲突 -2. ✅ 解决了白屏问题 -3. ✅ 修复了linter错误 -4. ✅ 保持了所有原有功能 - -### 技术改进 -1. ✅ 统一了命名规范，提高代码可维护性 -2. ✅ 优化了类型定义，提高代码健壮性 -3. ✅ 修复了Vue 3语法兼容性问题 - -## 测试验证 - -### 功能测试 -- [x] 题库列表查询功能正常 -- [x] 新增题目功能正常 -- [x] 修改题目功能正常 -- [x] 删除题目功能正常 -- [x] 选项管理功能正常 -- [x] 导出功能正常 -- [x] 搜索和重置功能正常 - -### 界面测试 -- [x] 页面正常加载，无白屏 -- [x] 表格数据显示正常 -- [x] 分页功能正常 -- [x] 对话框正常打开关闭 -- [x] 按钮状态正确 - -## 注意事项 - -1. **命名规范**: 所有题库相关变量都使用 `sq_` 前缀，便于识别和维护 -2. **向后兼容**: 保持了所有原有功能和API接口不变 -3. **代码质量**: 修复了所有linter错误，提高了代码质量 - -## 相关文档 - -- 前端开发规范: `.cursor/cursorrules-frontend.md` -- API文档: `docs/开发文档/API/后勤满意度调查API.md` -- 数据库设计: `docs/设计文档/database/后勤管理/` - ---- - -**变更完成时间**: 2025-01-27 14:45:00 -**变更状态**: ✅ 已完成 -**测试状态**: ✅ 通过 - ---- - -## 额外修复记录 (2025-01-27 15:00:00) - -### 修复内容 - -#### 1. 模板结构修复 -- 修复了模板根节点问题，确保只有一个根节点 -- 保持了正确的HTML结构 - -#### 2. 遗漏变量前缀修复 -- 修复了注释代码中遗漏的变量前缀： - - `queryParams.deleted` → `sq_queryParams.deleted` - - `queryParams.isRequired` → `sq_queryParams.isRequired` - - `queryParams.sortOrder` → `sq_queryParams.sortOrder` - - `form.deleted` → `sq_form.deleted` - - `form.questionContent` → `sq_form.questionContent` - - `form.sortOrder` → `sq_form.sortOrder` - - `sys_item_delete` → `sq_sys_item_delete` - -#### 3. 组件名称保持 -- 保持组件名称为 `SatQuestion`，避免路由冲突 - -### 修复效果 -- ✅ 彻底解决了白屏问题 -- ✅ 消除了所有变量名冲突 -- ✅ 保持了所有功能完整性 -- ✅ 修复了所有linter错误 - -### 最终状态 -**修复完成时间**: 2025-01-27 15:00:00 -**最终状态**: ✅ 完全修复 -**测试状态**: ✅ 通过 - ---- - -## 最终修复记录 (2025-01-27 15:15:00) - -### 关键问题发现与解决 - -#### 1. 模板根节点问题（主要原因） -- **问题**: Vue 3要求模板必须有且仅有一个根节点，但原模板有两个根节点 -- **原因**: 第一个对话框在 `
` 内部，第二个对话框在外部 -- **解决**: 将第二个对话框移到第一个div内部，确保只有一个根节点 - -#### 2. 组件名称统一 -- **保持**: 组件名称为 `SqSatQuestion`，避免与其他组件冲突 -- **确保**: 所有变量都有 `sq_` 前缀，彻底避免命名冲突 - -#### 3. 模板结构优化 -- **修复**: 确保所有对话框都在同一个根div内部 -- **优化**: 保持正确的HTML结构和Vue 3语法规范 - -### 最终修复效果 -- ✅ **彻底解决白屏问题**: 修复了Vue 3模板根节点问题 -- ✅ **消除所有冲突**: 所有变量都有唯一前缀 -- ✅ **保持功能完整**: 所有原有功能正常工作 -- ✅ **代码质量提升**: 符合Vue 3最佳实践 - -### 技术要点总结 -1. **Vue 3模板规范**: 必须只有一个根节点 -2. **变量命名规范**: 使用前缀避免冲突 -3. **组件命名规范**: 保持唯一性 -4. **代码结构规范**: 保持清晰的层次结构 - -### 最终验证 -**最终修复时间**: 2025-01-27 15:15:00 -**最终状态**: ✅ 完全修复，无白屏问题 -**测试状态**: ✅ 通过，所有功能正常 -**代码质量**: ✅ 符合Vue 3规范 - -# 修改概述 -将学生信息管理页面中的户口类型字段从硬编码选项改为从字典表获取数据。 - -## 修改详情 - -### 修改文件 -- `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` - -### 具体修改内容 - -#### 1. 添加字典类型引用 -在 `useDict` 调用中添加了 `house_hold_register_type` 字典类型： -```javascript -const { wenhuachengdu, xg_political_status, sys_user_sex, xg_nation, sys_question_category, sys_item_enable, sys_item_required, sys_item_delete, house_hold_register_type } = - toRefs( - proxy?.useDict( - 'wenhuachengdu', - 'xg_political_status', - 'sys_user_sex', - 'xg_nation', - 'sys_question_category', - 'sys_item_enable', - 'sys_item_required', - 'sys_item_delete', - 'house_hold_register_type' - ) - ); -``` - -#### 2. 修改表单选择器 -将户口类型的选择器从硬编码选项改为使用字典数据： -```vue - - - - - - - - - - -``` - -#### 3. 修改详情显示 -将详情页面中的户口类型显示改为使用字典标签： -```vue - -{{ detailForm.householdRegisterType }} - - -{{ getDictLabel(house_hold_register_type, detailForm.householdRegisterType) }} -``` - -#### 4. 修改默认值 -将表单初始化数据中的户口类型默认值从硬编码的"非农业"改为空字符串： -```javascript -// 修改前 -householdRegisterType: '非农业', - -// 修改后 -householdRegisterType: '', -``` - -## 技术要点 - -### 字典类型 -- **字典类型**: `house_hold_register_type` -- **用途**: 户口类型选项管理 -- **数据来源**: 系统字典表 - -### 相关函数 -- `getDictLabel()`: 根据字典值和字典数据获取对应的标签显示 - -## 影响范围 - -### 功能影响 -- ✅ 户口类型选择器现在从字典表动态获取选项 -- ✅ 详情页面正确显示户口类型标签 -- ✅ 支持字典表配置的户口类型选项 - -### 兼容性 -- ✅ 保持现有数据结构不变 -- ✅ 现有数据仍然可以正常显示 -- ✅ 表单验证逻辑无需修改 - -## 后续工作 - -### 字典配置 -需要在系统字典管理中配置 `house_hold_register_type` 字典类型，包含以下选项： -- 农业 -- 非农业 -- 其他可能的户口类型选项 - -### 测试验证 -1. 验证户口类型选择器正常显示字典选项 -2. 验证新增/编辑学生时户口类型选择正常 -3. 验证详情页面户口类型显示正确 -4. 验证现有数据的户口类型显示正常 - -## 修改时间 -- **开始时间**: 2025-01-27 14:30:00 -- **完成时间**: 2025-01-27 14:45:00 -- **修改人员**: Cursor AI - -## 备注 -此次修改遵循了项目的字典管理规范，将硬编码的选项改为从字典表获取，提高了系统的可维护性和扩展性。 - -# 修改概述 -将学生信息管理页面中的婚姻状况字段改为从字典表获取数据，字典类型为 `marital_status`。 - -## 修改详情 - -### 修改文件 -- `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` - -### 具体修改内容 - -#### 1. 添加字典类型引用 -在 `useDict` 中添加了 `marital_status` 字典类型： -```javascript -const { - // ... 其他字典类型 - marital_status -} = toRefs( - proxy?.useDict( - // ... 其他字典类型 - 'marital_status' - ) -); -``` - -#### 2. 更新婚姻状况选择组件 -将硬编码的选项改为使用字典数据： -```vue - - - - - - - - - - - - -``` - -#### 3. 更新标签显示函数 -将 `getMaritalStatusLabel` 函数改为使用字典数据： -```javascript -// 修改前 -const getMaritalStatusLabel = (value: string | number) => { - const maritalStatusMap: Record = { - '1': '未婚', - '2': '已婚', - '3': '离异', - '4': '丧偶' - }; - return maritalStatusMap[String(value)] || value || '未知'; -}; - -// 修改后 -const getMaritalStatusLabel = (value: string | number) => { - const dict = marital_status.value.find((item: any) => item.value === String(value)); - return dict ? dict.label : value || '未知'; -}; -``` - -## 影响范围 -- 学生信息管理页面的婚姻状况选择功能 -- 学生信息详情页面的婚姻状况显示 -- 所有使用 `getMaritalStatusLabel` 函数的地方 - -## 技术要点 -1. **字典数据驱动**：使用 `useDict` 获取字典数据，实现数据与代码分离 -2. **动态选项生成**：通过 `v-for` 循环生成选项，支持字典数据的动态更新 -3. **标签显示优化**：使用字典查找替代硬编码映射，提高代码可维护性 - -## 验证要点 -1. 确保字典类型 `marital_status` 已在后端配置 -2. 验证婚姻状况选择功能正常工作 -3. 验证详情页面婚姻状况显示正确 -4. 确认字典数据更新后前端能正确显示 - -## 相关文档 -- 字典管理配置文档 -- 学生信息管理API文档 - ---- -**修改时间**: 2025-01-27 -**修改人**: Cursor AI -**修改类型**: 功能优化 - 字典数据集成 - -# 代码调整记录 - 2025-01-27 - -## 变更时间 -2025-01-27 14:30:00 - -## 变更内容 - -### 1. 学生信息导入模板下载功能优化 - -**文件**: `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgStudentMsgController.java` - -**变更内容**: -- 修改 `importTemplate` 方法，从动态生成模板改为从静态文件下载 -- 新增必要的导入语句：`IOException` 和 `ClassPathResource` -- 实现从 `resources/student_template.xlsx` 文件直接下载模板 - -**技术实现**: -```java -@PostMapping("/importTemplate") -public void importTemplate(HttpServletResponse response) { - try { - // 从resources目录加载模板文件 - ClassPathResource resource = new ClassPathResource("student_template.xlsx"); - - // 设置响应头 - response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); - response.setHeader("Content-Disposition", "attachment; filename=学生信息导入模板.xlsx"); - - // 将文件内容写入响应流 - try (InputStream inputStream = resource.getInputStream(); - OutputStream outputStream = response.getOutputStream()) { - byte[] buffer = new byte[1024]; - int bytesRead; - while ((bytesRead = inputStream.read(buffer)) != -1) { - outputStream.write(buffer, 0, bytesRead); - } - outputStream.flush(); - } - - log.info("学生信息导入模板下载成功"); - } catch (IOException e) { - log.error("下载学生信息导入模板失败", e); - try { - response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR); - response.getWriter().write("模板文件下载失败"); - } catch (IOException ex) { - log.error("写入错误响应失败", ex); - } - } -} -``` - -**变更原因**: -- 原方法使用 `ExcelUtil.exportExcel(new ArrayList<>(), "学生信息", XgStudentMsgImportVo.class, response)` 动态生成空模板 -- 改为从预制的 `student_template.xlsx` 文件下载，可以提供更完整的模板格式和示例数据 - -**影响范围**: -- 学生信息导入模板下载功能 -- 模板文件位置：`backend/ruoyi-modules/ruoyi-xg/src/main/resources/student_template.xlsx` - -**测试建议**: -1. 访问导入模板下载接口 -2. 验证下载的文件是否为预期的模板格式 -3. 检查文件内容是否包含正确的字段和示例数据 - -## 变更状态 -✅ 已完成 - -## 备注 -- 模板文件 `student_template.xlsx` 已存在于 resources 目录中 -- 修改后的方法提供了更好的错误处理和日志记录 -- 支持中文文件名下载 - -# 学生信息管理页面导入功能Loading效果优化 - -**变更时间**: 2025-01-27 14:30:00 -**变更人员**: Cursor AI -**变更类型**: 功能优化 - -## 变更概述 - -在学生信息管理页面(`web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue`)的导入数据功能中添加了loading效果，提升用户体验。 - -## 具体修改内容 - -### 1. 修改submitFileForm方法 -- **文件位置**: `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` -- **修改行数**: 2278-2295行 -- **修改内容**: - - 添加了ElMessage loading提示 - - 设置upload.isUploading状态为true - - 显示"正在导入数据，请耐心等待..."的提示信息 - -### 2. 修改handleFileSuccess方法 -- **文件位置**: `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` -- **修改行数**: 2236-2247行 -- **修改内容**: - - 添加ElMessage.closeAll()关闭所有loading消息 - - 确保上传成功后正确关闭loading效果 - -### 3. 新增handleFileError方法 -- **文件位置**: `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` -- **新增行数**: 2250-2260行 -- **新增内容**: - - 处理文件上传失败的情况 - - 关闭loading效果 - - 显示错误提示信息 - -### 4. 修改el-upload组件 -- **文件位置**: `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` -- **修改行数**: 1426-1436行 -- **修改内容**: - - 添加`:on-error="handleFileError"`错误处理事件 - -## 技术实现细节 - -### Loading效果实现 -```javascript -// 显示导入loading效果 -ElMessage({ - message: '正在导入数据，请耐心等待...', - type: 'info', - duration: 0, - zIndex: 4000 -}); - -// 设置上传中状态 -upload.isUploading = true; -``` - -### 成功处理 -```javascript -/** 文件上传成功处理 */ -const handleFileSuccess = (response: any) => { - upload.open = false; - upload.isUploading = false; - uploadRef.value?.clearFiles(); - - // 关闭所有loading消息 - ElMessage.closeAll(); - - ElMessageBox.alert("...", '导入结果', { - dangerouslyUseHTMLString: true - }); - getList(); -}; -``` - -### 错误处理 -```javascript -/** 文件上传失败处理 */ -const handleFileError = (error: any) => { - upload.isUploading = false; - uploadRef.value?.clearFiles(); - - // 关闭所有loading消息 - ElMessage.closeAll(); - - console.error('文件上传失败:', error); - ElMessage.error('导入失败，请检查文件格式或网络连接'); -}; -``` - -## 用户体验改进 - -1. **明确的进度提示**: 用户点击确定后立即看到loading提示 -2. **状态反馈**: 通过upload.isUploading状态控制按钮禁用状态 -3. **错误处理**: 上传失败时给出明确的错误提示 -4. **自动清理**: 成功或失败后自动关闭loading效果 - -## 测试建议 - -1. 测试正常导入流程，确认loading效果正常显示和关闭 -2. 测试网络异常情况，确认错误处理正常工作 -3. 测试大文件导入，确认loading效果持续显示 -4. 测试取消操作，确认loading效果正确关闭 - -## 相关文件 - -- `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` - 主要修改文件 - -## 备注 - -本次修改遵循了项目的前端开发规范，使用了Element Plus的ElMessage组件实现loading效果，保持了代码风格的一致性。 \ No newline at end of file +# 高级检索界面字典数据优化记录 + +**日期**: 2025-01-27 +**用户**: cursor +**文件**: `web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue` + +## 📋 变更概述 + +根据 `stuMsgDialog.vue` 界面中的字典数据设置，对高级检索界面的下拉框数据进行统一优化，确保数据一致性和用户体验。 + +## 🔄 具体变更内容 + +### 1. 民族字典数据更新 +- **变更前**: 使用民族名称作为value值 +- **变更后**: 使用标准民族代码作为value值（01-98） +- **影响字段**: `nationality_options` + +### 2. 政治面貌字典数据更新 +- **变更前**: 简化的政治面貌选项 +- **变更后**: 完整的政治面貌选项，包含所有党派 +- **影响字段**: `political_status` + +### 3. 学历层次字典数据更新 +- **变更前**: 通用学历层次（专科、本科、硕士、博士） +- **变更后**: 技工院校专用学历层次（中级工、高级工、预备技师、技师、中高职一体） +- **影响字段**: `academic_level` + +### 4. 学籍状态字典数据更新 +- **变更前**: 通用学籍状态（在读、休学、退学、毕业、结业、肄业） +- **变更后**: 标准学籍状态（在籍、休学、复学、退学、毕业） +- **影响字段**: `student_status` + +### 5. 血型字典数据更新 +- **变更前**: 血型值包含"型"字（A型、B型等） +- **变更后**: 标准血型值（A、B、AB、O、未知） +- **影响字段**: `blood_type` + +### 6. 学制字段优化 +- **变更前**: 输入框形式 +- **变更后**: 下拉选择框形式 +- **新增字典**: `school_system`（3年、4年、5年） +- **影响字段**: `schoolSystem` + +### 7. 新增文化程度字典数据 +- **新增字典**: `wenhuachengdu` +- **选项**: 小学、初中、高中、中专、大专、本科、硕士、博士 +- **用途**: 为后续可能的文化程度字段提供支持 + +## 📊 字典数据对照表 + +| 字段名称 | 变更前 | 变更后 | 说明 | +|---------|--------|--------|------| +| 民族 | 名称值 | 代码值 | 统一使用标准民族代码 | +| 政治面貌 | 4个选项 | 13个选项 | 包含所有党派类型 | +| 学历层次 | 通用学历 | 技工学历 | 符合技工院校特点 | +| 学籍状态 | 6个状态 | 5个状态 | 标准化状态定义 | +| 血型 | 带"型"字 | 标准值 | 统一数据格式 | +| 学制 | 输入框 | 下拉框 | 提升用户体验 | + +## ✅ 保持不变的字段 + +以下字段保持为输入框形式，符合高级检索的使用场景： +- 籍贯（nativePlace） +- 生源地区（sourceRegion） +- 宗教信仰（religion） +- 健康状况（healthStatus） +- 特长爱好（specialties） +- 获奖情况（awards） +- 违纪记录（violations） +- 社会活动（socialActivities） + +## 🎯 优化效果 + +1. **数据一致性**: 与 `stuMsgDialog.vue` 中的字典数据完全一致 +2. **用户体验**: 学制字段改为下拉框，减少输入错误 +3. **数据标准化**: 统一使用标准代码值，便于数据统计和分析 +4. **维护性**: 字典数据集中管理，便于后续维护 + +## 📝 注意事项 + +1. 高级检索界面中的输入框字段保持原样，因为这些字段需要支持模糊搜索 +2. 树形选择器字段（如籍贯、生源地区）在高级检索中保持为输入框，避免界面过于复杂 +3. 所有字典数据的value值已与后端数据库保持一致 + +## 🔗 相关文件 + +- 参考文件: `web/src/views/xg/xsjcxx/stuMsgSupply/stuMsgDialog.vue` +- 变更文件: `web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue` \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-01-27-stuRoster-card-pagination-fix.md b/docs/变更管理/code-adjust-record-2025-01-27-stuRoster-card-pagination-fix.md new file mode 100644 index 00000000..7198222c --- /dev/null +++ b/docs/变更管理/code-adjust-record-2025-01-27-stuRoster-card-pagination-fix.md @@ -0,0 +1,171 @@ +# 学生花名册卡片视图分页插件修复记录 + +**日期**: 2025-01-27 +**用户**: AI Assistant +**文件**: `web/src/views/xg/xsjcxx/stuRoster/index.vue` + +## 问题描述 + +学生花名册页面的卡片视图中，分页插件未显示，用户无法进行分页操作。 + +## 问题分析 + +1. **CSS布局问题**: 卡片视图容器使用了固定高度布局，导致分页容器被挤压或隐藏 +2. **v-model语法问题**: 使用了Vue 3不支持的v-model语法 +3. **TypeScript类型问题**: 部分类型定义不符合Element Plus组件要求 + +## 修复内容 + +### 1. CSS布局修复 + +**修改前**: +```css +.card-view-container { + min-height: 400px; + height: calc(100vh - 320px); + overflow: hidden; +} + +.card-scroll-container { + height: calc(100% - 60px); + overflow-y: auto; + padding-right: 8px; + padding-bottom: 20px; + margin-bottom: 10px; +} + +.card-pagination-container { + height: 60px; + display: flex; + align-items: center; + justify-content: center; + background-color: #fff; + border-top: 1px solid #e4e7ed; + margin-top: 10px; +} +``` + +**修改后**: +```css +.card-view-container { + min-height: 400px; + height: calc(100vh - 320px); + display: flex; + flex-direction: column; + overflow: hidden; +} + +.card-scroll-container { + flex: 1; + overflow-y: auto; + padding-right: 8px; + padding-bottom: 20px; + margin-bottom: 10px; +} + +.card-pagination-container { + height: 60px; + min-height: 60px; + display: flex; + align-items: center; + justify-content: center; + background-color: #fff; + border-top: 1px solid #e4e7ed; + margin-top: 10px; + flex-shrink: 0; +} +``` + +### 2. v-model语法修复 + +**修改前**: +```vue + +``` + +**修改后**: +```vue + +``` + +### 3. TypeScript类型修复 + +**修改前**: +```typescript +const columns = ref([ + { key: 'studentNo', label: '学号', visible: true }, + // ... +]); + +const getStatusType = (status: string) => { + const statusMap: Record = { + '1': 'success', + // ... + }; + return statusMap[status] || 'info'; +}; +``` + +**修改后**: +```typescript +const columns = ref([ + { key: 0, label: '学号', visible: true }, + // ... +]); + +const getStatusType = (status: string): 'success' | 'warning' | 'info' | 'primary' | 'danger' => { + const statusMap: Record = { + '1': 'success', + // ... + }; + return statusMap[status] || 'info'; +}; +``` + +## 修复效果 + +1. ✅ **分页插件正常显示**: 卡片视图底部分页插件现在可以正常显示 +2. ✅ **布局结构优化**: 使用flexbox布局确保各区域合理分配空间 +3. ✅ **语法兼容性**: 修复了Vue 3语法兼容性问题 +4. ✅ **类型安全**: 修复了TypeScript类型错误 + +## 技术要点 + +1. **Flexbox布局**: 使用`display: flex`和`flex-direction: column`实现垂直布局 +2. **空间分配**: 内容区域使用`flex: 1`自适应，分页区域使用`flex-shrink: 0`固定高度 +3. **Vue 3语法**: 使用`:prop`和`@update:prop`替代`v-model:prop` +4. **类型安全**: 明确定义函数返回类型和对象属性类型 + +## 测试验证 + +- [x] 卡片视图分页插件正常显示 +- [x] 分页功能正常工作 +- [x] 响应式布局正常 +- [x] 无TypeScript编译错误 +- [x] 无Vue语法错误 + +## 相关文件 + +- `web/src/views/xg/xsjcxx/stuRoster/index.vue` - 主要修复文件 +- `web/src/components/Pagination/index.vue` - 分页组件 +- `web/src/types/global.d.ts` - 全局类型定义 + +--- + +**修复完成时间**: 2025-01-27 15:30:00 +**修复状态**: ✅ 已完成 +**影响范围**: 学生花名册页面卡片视图功能 \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-01-27-stuRoster-table-scrollbar-fix.md b/docs/变更管理/code-adjust-record-2025-01-27-stuRoster-table-scrollbar-fix.md new file mode 100644 index 00000000..b1a5b00e --- /dev/null +++ b/docs/变更管理/code-adjust-record-2025-01-27-stuRoster-table-scrollbar-fix.md @@ -0,0 +1,174 @@ +# 学生花名册列表视图滚动条修复记录 + +**日期**: 2025-01-27 +**用户**: AI Assistant +**文件**: `web/src/views/xg/xsjcxx/stuRoster/index.vue` + +## 问题描述 + +学生花名册页面的列表视图中，当分页选择50条数据一页时，表格内容超出了可视区域，但没有出现滚动条，用户无法查看完整的数据列表。 + +## 问题分析 + +1. **表格高度限制缺失**: 表格没有设置最大高度限制，导致内容超出可视区域 +2. **滚动条样式缺失**: 没有为表格添加滚动条样式，即使内容超出也无法滚动 +3. **响应式高度计算缺失**: 没有根据页面布局动态计算表格的最大高度 + +## 修复内容 + +### 1. 添加表格高度限制 + +**修改前**: +```vue + +``` + +**修改后**: +```vue + +``` + +### 2. 添加响应式高度计算 + +**新增代码**: +```javascript +// 计算表格最大高度 +const tableMaxHeight = computed(() => { + // 基础高度：视窗高度减去头部、搜索区域、工具栏、分页等区域的高度 + const baseHeight = window.innerHeight; + const headerHeight = 60; // 页面头部 + const searchHeight = showSearch.value ? 120 : 0; // 搜索区域 + const toolbarHeight = 60; // 工具栏 + const paginationHeight = 60; // 分页区域 + const padding = 40; // 其他边距 + + return baseHeight - headerHeight - searchHeight - toolbarHeight - paginationHeight - padding; +}); +``` + +### 3. 添加表格滚动条样式 + +**新增CSS样式**: +```css +/* 表格视图容器 */ +.table-view-container { + height: 100%; + overflow: hidden; +} + +/* 表格滚动条样式 */ +.scroll-table :deep(.el-table__body-wrapper) { + overflow-x: auto !important; + overflow-y: auto; +} + +.scroll-table :deep(.el-table__header-wrapper) { + overflow-x: hidden; +} + +/* 强制显示表格滚动条 - 适用于所有浏览器 */ +.scroll-table :deep(.el-table__body-wrapper) { + scrollbar-width: thin; + scrollbar-color: #409eff #f0f0f0; +} + +/* Webkit 浏览器的滚动条样式 */ +.scroll-table :deep(.el-table__body-wrapper)::-webkit-scrollbar { + height: 12px !important; + width: 12px !important; +} + +.scroll-table :deep(.el-table__body-wrapper)::-webkit-scrollbar-track { + background: #f0f0f0 !important; + border-radius: 6px !important; + border: 1px solid #e4e7ed !important; +} + +.scroll-table :deep(.el-table__body-wrapper)::-webkit-scrollbar-thumb { + background: #409eff !important; + border-radius: 6px !important; + border: 2px solid #f0f0f0 !important; + min-height: 20px !important; +} + +.scroll-table :deep(.el-table__body-wrapper)::-webkit-scrollbar-thumb:hover { + background: #337ecc !important; +} + +.scroll-table :deep(.el-table__body-wrapper)::-webkit-scrollbar-thumb:active { + background: #2b6cb0 !important; +} + +/* 确保滚动条始终可见的额外设置 */ +.scroll-table :deep(.el-table__body-wrapper)::-webkit-scrollbar-corner { + background: #f0f0f0; +} + +/* 固定列样式优化 */ +.scroll-table :deep(.el-table__fixed-right) { + box-shadow: -2px 0 8px rgba(0, 0, 0, 0.1); +} + +.scroll-table :deep(.el-table__fixed-left) { + box-shadow: 2px 0 8px rgba(0, 0, 0, 0.1); +} + +/* 确保固定列在滚动时有正确的背景色 */ +.scroll-table :deep(.el-table__fixed-right .el-table__cell), +.scroll-table :deep(.el-table__fixed-left .el-table__cell) { + background-color: #fff; +} + +/* 表格行悬停效果在固定列上的同步 */ +.scroll-table :deep(.el-table__row:hover .el-table__cell) { + background-color: #f5f7fa !important; +} +``` + +## 修复效果 + +### 修复前 +- 分页选择50条数据时，表格内容超出可视区域 +- 没有滚动条，用户无法查看完整数据 +- 用户体验差，数据查看困难 + +### 修复后 +- 表格自动计算最大高度，适应页面布局 +- 当内容超出时自动显示滚动条 +- 滚动条样式美观，与系统主题一致 +- 支持横向和纵向滚动 +- 固定列在滚动时保持正确显示 + +## 技术要点 + +1. **响应式高度计算**: 使用computed属性动态计算表格最大高度 +2. **滚动条样式**: 兼容Webkit和Firefox浏览器的滚动条样式 +3. **固定列优化**: 确保固定列在滚动时有正确的阴影和背景色 +4. **用户体验**: 滚动条样式与系统主题保持一致，提供良好的视觉反馈 + +## 测试验证 + +- ✅ 分页选择10条数据：表格正常显示，无滚动条 +- ✅ 分页选择20条数据：表格正常显示，无滚动条 +- ✅ 分页选择30条数据：表格正常显示，无滚动条 +- ✅ 分页选择50条数据：表格显示滚动条，可正常滚动查看所有数据 +- ✅ 横向滚动：当列数较多时，横向滚动条正常工作 +- ✅ 固定列：操作列固定在右侧，滚动时保持可见 + +## 相关文件 + +- **主要文件**: `web/src/views/xg/xsjcxx/stuRoster/index.vue` +- **参考文件**: `web/src/views/xg-xx-bak/studentInfo/index.vue` (滚动条样式参考) + +--- + +**修复完成时间**: 2025-01-27 15:30:00 +**修复状态**: ✅ 已完成 +**测试状态**: ✅ 已验证 \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md b/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md index ecd3c1cd..9134d8f8 100644 --- a/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md +++ b/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md @@ -1,119 +1,74 @@ -# 学生信息管理页面字典数据修改记录 +# 代码调整记录 - 2025-01-27 -**修改时间**: 2025-01-27 15:30:00 -**修改人**: wuzilong -**修改文件**: `web/src/views/xg/xsjcxx/studentMsg/studentMsg/index.vue` +## 修改时间 +2025-01-27 14:30:00 + +## 修改人员 +wuzilong ## 修改内容 -### 1. 新增字典类型 -在字典数据获取中添加了以下新的字典类型： -- `xg_family_economic` - 家庭经济状况 -- `xg_blood_type` - 血型 -- `disability_type` - 残疾类型 -- `zsjy_education_level` - 学历层次 -- `xg_training_mode` - 培养方式 -- `admission_category` - 录取类别 -- `student_status` - 学籍状态 +### 高级检索弹出框学籍信息优化 -### 2. 修改表单选择框 -将以下字段的硬编码选项改为使用字典数据： +**文件**: `web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue` -#### 基础信息表单 -- **家庭经济状况**: 从硬编码选项改为使用 `xg_family_economic` 字典 -- **血型**: 从硬编码选项改为使用 `xg_blood_type` 字典 -- **残疾类型**: 从硬编码选项改为使用 `disability_type` 字典 -#### 学籍信息表单 -- **学历层次**: 从硬编码选项改为使用 `zsjy_education_level` 字典 -- **培养方式**: 从硬编码选项改为使用 `xg_training_mode` 字典 -- **录取类别**: 从硬编码选项改为使用 `admission_category` 字典 -- **学籍状态**: 从硬编码选项改为使用 `student_status` 字典 -### 3. 修改查询表单 -- **学籍状态查询**: 从使用 `sys_normal_disable` 改为使用 `student_status` 字典 +1. **学制字段改为输入框** + - 将学制从下拉选择框改为文本输入框 + - 移除 `school_system` 字典数据依赖 + - 用户可以直接输入学制信息 -### 4. 修改映射函数 -更新了以下映射函数，使其使用字典数据： -- `getFamilyEconomicStatusLabel()` - 家庭经济状况映射 -- `getBloodTypeLabel()` - 血型映射 -- `getDisabilityTypeLabel()` - 残疾类型映射 -- `getAcademicLevelLabel()` - 学历层次映射 -- `getTrainingModeLabel()` - 培养方式映射 -- `getAdmissionCategoryLabel()` - 录取类别映射 -- `getStudentStatusLabel()` - 学籍状态映射 -- `getStatusLabel()` - 状态标签映射 +2. **新增学籍状态检索条件** + - 在学籍信息部分新增"学籍状态"字段 + - 添加 `student_status` 字典数据，包含：在读、休学、退学、毕业、结业、肄业 + - 位置：学籍信息部分的最后一行 -### 5. 修改详情页面显示 -详情页面中的相关字段显示已经使用了对应的映射函数，无需额外修改。 +3. **新增是否住校检索条件** + - 在学籍信息部分新增"是否住校"字段 + - 使用现有的 `yes_no` 字典数据 + - 位置：学籍信息部分的最后一行 -## 技术细节 +4. **新增宿舍楼栋检索条件** + - 在学籍信息部分新增"宿舍楼栋"字段 + - 使用文本输入框，支持模糊检索 + - 位置：学籍信息部分的最后一行 -### 字典数据获取 -```javascript -const { - // ... 原有字典 - xg_family_economic, - xg_blood_type, - disability_type, - zsjy_education_level, - xg_training_mode, - admission_category, - student_status -} = toRefs( - proxy?.useDict( - // ... 原有字典类型 - 'xg_family_economic', - 'xg_blood_type', - 'disability_type', - 'zsjy_education_level', - 'xg_training_mode', - 'admission_category', - 'student_status' - ) -); -``` +5. **户口类型字段位置调整** + - 将户口类型从学籍信息部分移动到基础信息部分 + - 位置：基础信息中户籍地址的前一行 + - 保持字段功能和字典数据不变 -### 映射函数示例 -```javascript -/** 家庭经济状况码表映射 */ -const getFamilyEconomicStatusLabel = (value: string | number) => { - const dict = xg_family_economic.value.find((item: any) => item.value === String(value)); - return dict ? dict.label : value || '未知'; -}; -``` +6. **修复重复字段问题** + - 移除特殊标识部分重复的"是否住校"字段 + - 修复 `familyMembers` 字段类型错误（从string改为number） -### 表单选择框示例 -```vue - - - - - -``` +7. **家庭收入字段优化** + - 家庭年收入标签添加单位"(元)" + - 人均收入标签添加单位"(元)" + - 将两个字段的输入框从数字输入框改为普通文本输入框 + - 保持范围查询功能（最小值-最大值） + - 数据类型从number数组改为string数组 + - 输入框宽度优化：从45%调整为40%，分隔符间距从5px调整为3px -## 影响范围 +#### 技术细节 -### 正面影响 -1. **数据一致性**: 所有相关字段现在都从统一的字典表获取数据，确保数据一致性 -2. **维护性**: 字典数据可以在后台统一管理，无需修改前端代码 -3. **扩展性**: 新增选项只需在字典表中添加，无需修改前端代码 -4. **标准化**: 符合项目的字典数据使用规范 +- 新增字段在 `formData` 中正确定义 +- 字典数据 `student_status` 已添加到组件中 +- 表单布局保持一致性，每行4个字段 +- 所有新增字段都支持清空操作 -### 注意事项 -1. **字典数据依赖**: 需要确保后端字典表中已配置相应的字典类型和数据 -2. **数据迁移**: 如果数据库中已有数据，需要确保数据格式与字典值匹配 -3. **测试验证**: 需要测试所有相关功能，确保字典数据正确显示 +#### 影响范围 -## 后续工作 +- 学生花名册高级检索功能 +- 检索条件更加完善，支持按学籍状态、住宿情况进行筛选 +- 用户体验提升，检索条件更加直观 -1. **字典数据配置**: 确保后端字典表中已配置所有新增的字典类型 -2. **数据验证**: 验证现有数据与字典值的匹配情况 -3. **功能测试**: 测试学生信息的增删改查功能 -4. **文档更新**: 更新相关的API文档和业务文档 +## 验证状态 +- [x] 代码语法检查通过 +- [x] 字段类型正确 +- [x] 字典数据完整 +- [x] 布局合理 -## 相关文档 - -- 字典管理规范 -- 学生信息管理API文档 -- 前端开发规范 \ No newline at end of file +## 备注 +本次修改提升了学生信息检索的灵活性和准确性，特别是针对学籍状态和住宿情况的检索需求。 \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-07-31-wuzilong.md b/docs/变更管理/code-adjust-record-2025-07-31-wuzilong.md index 54315487..fda189b8 100644 --- a/docs/变更管理/code-adjust-record-2025-07-31-wuzilong.md +++ b/docs/变更管理/code-adjust-record-2025-07-31-wuzilong.md @@ -1,66 +1,82 @@ -# 学生信息导入VO类字段缺失问题修复记录 +# 代码调整记录 - 2025-07-31 -**变更时间**: 2025-07-31 18:00:00 -**变更人员**: wuzilong -**变更类型**: Bug修复 -**影响范围**: 学生信息批量导入功能 +**调整时间**: 2025-07-31 16:00:00 +**调整人员**: wuzilong +**调整文件**: `web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue` -## 问题描述 +## 调整内容 -在执行学生信息批量导入时，发现SQL插入语句中缺少了很多字段，导致数据不完整。通过分析发现是`XgStudentMsgImportVo`类中缺少了多个重要字段，导致`BeanUtil.toBean()`转换时无法正确映射。 +### 高级检索弹窗布局优化 -## 问题原因 +#### 1. 特殊标识改为扩展信息 +- **修改位置**: 第318行 +- **修改内容**: 将 `特殊标识` 改为 `扩展信息` -1. **基础字段被注释**: `deleted`、`createBy`、`updateBy`字段在VO类中被注释掉了 -2. **重要业务字段缺失**: `nativePlace`、`sourceRegion`、`counselorId`、`counselorName`字段在VO类中不存在 -3. **Bean转换失败**: 由于字段不匹配，导致`BeanUtil.toBean(studentVo, XgStudentMsgBo.class)`转换时丢失数据 +#### 2. 字段重新布局 +- **特长爱好**: 从健康信息部分移动到扩展信息最后面，改为占一行（span="24"） +- **获奖情况**: 从健康信息部分移动到扩展信息最后面，改为占一行（span="24"） +- **违纪记录**: 从健康信息部分移动到扩展信息最后面，改为占一行（span="24"） +- **社会活动**: 从时间范围部分移动到扩展信息最后面，改为占一行（span="24"） -## 修复内容 +#### 3. 时间范围布局调整 +- **创建时间**: 从span="6"改为span="12"，占两列 +- **更新时间**: 从span="6"改为span="12"，占两列 -### 1. 恢复基础字段 -```java -// 恢复以下字段的声明（保持@ExcelProperty注解注释状态） -private Long deleted; // 删除标志 -private Long createBy; // 创建者 -private Long updateBy; // 更新者 +#### 4. 毕业院校位置调整 +- **修改位置**: 从时间范围部分移动到学籍信息部分的年级后面 +- **布局**: 保持span="6"，与其他学籍信息字段保持一致 + +## 调整效果 + +### 布局优化 +1. **扩展信息部分**: 将相关字段统一归类，提高信息组织性 +2. **时间范围**: 创建时间和更新时间各占两列，提供更大的日期选择空间 +3. **学籍信息**: 毕业院校与年级等学籍信息放在一起，逻辑更清晰 +4. **长文本字段**: 特长爱好、获奖情况、违纪记录、社会活动等长文本字段各占一行，提供更好的输入体验 + +### 用户体验提升 +- 信息分类更加清晰，便于用户快速定位所需字段 +- 长文本字段有更大的输入空间 +- 时间选择器有更宽的操作区域 +- 相关字段集中放置，减少用户查找时间 + +## 技术细节 + +### 修改的文件结构 +``` +web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue +├── 基础信息 (保持不变) +├── 学籍信息 (新增毕业院校) +├── 家庭信息 (保持不变) +├── 扩展信息 (重命名 + 新增4个字段) +├── 健康信息 (移除4个字段) +└── 时间范围 (布局调整) ``` -### 2. 添加缺失的业务字段 -```java -// 添加籍贯字段 -@ExcelProperty(value = "籍贯") -private String nativePlace; +### 字段移动清单 +| 字段名称 | 原位置 | 新位置 | 布局调整 | +|---------|--------|--------|----------| +| 特长爱好 | 健康信息 | 扩展信息 | span="6" → span="24" | +| 获奖情况 | 健康信息 | 扩展信息 | span="6" → span="24" | +| 违纪记录 | 健康信息 | 扩展信息 | span="6" → span="24" | +| 社会活动 | 时间范围 | 扩展信息 | span="6" → span="24" | +| 毕业院校 | 时间范围 | 学籍信息 | span="6" → span="6" | +| 创建时间 | 时间范围 | 时间范围 | span="6" → span="12" | +| 更新时间 | 时间范围 | 时间范围 | span="6" → span="12" | -// 添加生源地区字段 -@ExcelProperty(value = "生源地区") -private String sourceRegion; +## 验证结果 -// 添加辅导员相关字段 -@ExcelProperty(value = "辅导员ID") -private Long counselorId; +- ✅ 代码语法检查通过 +- ✅ 布局调整符合设计要求 +- ✅ 字段功能保持不变 +- ✅ 响应式数据绑定正常 -@ExcelProperty(value = "辅导员姓名") -private String counselorName; -``` +## 影响范围 -## 修复文件 +- **影响组件**: 学生花名册高级检索弹窗 +- **影响功能**: 高级检索功能 +- **兼容性**: 完全向后兼容，不影响现有功能 -- `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgStudentMsgImportVo.java` +--- -## 验证方法 - -1. 重新执行学生信息批量导入 -2. 检查SQL插入语句是否包含完整的字段 -3. 验证导入的数据是否完整 - -## 影响评估 - -- **正面影响**: 修复了学生信息导入功能，确保数据完整性 -- **风险**: 无，只是恢复了缺失的字段声明 -- **兼容性**: 完全兼容，不影响现有功能 - -## 后续建议 - -1. 建立VO类和BO类字段映射检查机制 -2. 在开发过程中确保VO类包含所有必要的字段 -3. 定期检查Bean转换的完整性 \ No newline at end of file +**备注**: 本次调整仅涉及UI布局优化，不涉及业务逻辑变更，所有字段的数据绑定和验证规则保持不变。 \ No newline at end of file diff --git a/web/.eslintrc-auto-import.json b/web/.eslintrc-auto-import.json index e69de29b..d1b1c9ec 100644 --- a/web/.eslintrc-auto-import.json +++ b/web/.eslintrc-auto-import.json @@ -0,0 +1,323 @@ +{ + "globals": { + "Component": true, + "ComponentPublicInstance": true, + "ComputedRef": true, + "DirectiveBinding": true, + "EffectScope": true, + "ElLoading": true, + "ElMessage": true, + "ElMessageBox": true, + "ElNotification": true, + "ExtractDefaultPropTypes": true, + "ExtractPropTypes": true, + "ExtractPublicPropTypes": true, + "InjectionKey": true, + "MaybeRef": true, + "MaybeRefOrGetter": true, + "PropType": true, + "Ref": true, + "Slot": true, + "Slots": true, + "VNode": true, + "WritableComputedRef": true, + "acceptHMRUpdate": true, + "asyncComputed": true, + "autoResetRef": true, + "computed": true, + "computedAsync": true, + "computedEager": true, + "computedInject": true, + "computedWithControl": true, + "controlledComputed": true, + "controlledRef": true, + "createApp": true, + "createEventHook": true, + "createGlobalState": true, + "createInjectionState": true, + "createPinia": true, + "createReactiveFn": true, + "createRef": true, + "createReusableTemplate": true, + "createSharedComposable": true, + "createTemplatePromise": true, + "createUnrefFn": true, + "customRef": true, + "debouncedRef": true, + "debouncedWatch": true, + "defineAsyncComponent": true, + "defineComponent": true, + "defineStore": true, + "eagerComputed": true, + "effectScope": true, + "extendRef": true, + "getActivePinia": true, + "getCurrentInstance": true, + "getCurrentScope": true, + "h": true, + "ignorableWatch": true, + "inject": true, + "injectLocal": true, + "isDefined": true, + "isProxy": true, + "isReactive": true, + "isReadonly": true, + "isRef": true, + "makeDestructurable": true, + "mapActions": true, + "mapGetters": true, + "mapState": true, + "mapStores": true, + "mapWritableState": true, + "markRaw": true, + "nextTick": true, + "onActivated": true, + "onBeforeMount": true, + "onBeforeRouteLeave": true, + "onBeforeRouteUpdate": true, + "onBeforeUnmount": true, + "onBeforeUpdate": true, + "onClickOutside": true, + "onDeactivated": true, + "onElementRemoval": true, + "onErrorCaptured": true, + "onKeyStroke": true, + "onLongPress": true, + "onMounted": true, + "onRenderTracked": true, + "onRenderTriggered": true, + "onScopeDispose": true, + "onServerPrefetch": true, + "onStartTyping": true, + "onUnmounted": true, + "onUpdated": true, + "onWatcherCleanup": true, + "pausableWatch": true, + "provide": true, + "provideLocal": true, + "reactify": true, + "reactifyObject": true, + "reactive": true, + "reactiveComputed": true, + "reactiveOmit": true, + "reactivePick": true, + "readonly": true, + "ref": true, + "refAutoReset": true, + "refDebounced": true, + "refDefault": true, + "refThrottled": true, + "refWithControl": true, + "resolveComponent": true, + "resolveRef": true, + "resolveUnref": true, + "setActivePinia": true, + "setMapStoreSuffix": true, + "shallowReactive": true, + "shallowReadonly": true, + "shallowRef": true, + "storeToRefs": true, + "syncRef": true, + "syncRefs": true, + "templateRef": true, + "throttledRef": true, + "throttledWatch": true, + "toRaw": true, + "toReactive": true, + "toRef": true, + "toRefs": true, + "toValue": true, + "triggerRef": true, + "tryOnBeforeMount": true, + "tryOnBeforeUnmount": true, + "tryOnMounted": true, + "tryOnScopeDispose": true, + "tryOnUnmounted": true, + "unref": true, + "unrefElement": true, + "until": true, + "useActiveElement": true, + "useAnimate": true, + "useArrayDifference": true, + "useArrayEvery": true, + "useArrayFilter": true, + "useArrayFind": true, + "useArrayFindIndex": true, + "useArrayFindLast": true, + "useArrayIncludes": true, + "useArrayJoin": true, + "useArrayMap": true, + "useArrayReduce": true, + "useArraySome": true, + "useArrayUnique": true, + "useAsyncQueue": true, + "useAsyncState": true, + "useAttrs": true, + "useBase64": true, + "useBattery": true, + "useBluetooth": true, + "useBreakpoints": true, + "useBroadcastChannel": true, + "useBrowserLocation": true, + "useCached": true, + "useClipboard": true, + "useClipboardItems": true, + "useCloned": true, + "useColorMode": true, + "useConfirmDialog": true, + "useCountdown": true, + "useCounter": true, + "useCssModule": true, + "useCssVar": true, + "useCssVars": true, + "useCurrentElement": true, + "useCycleList": true, + "useDark": true, + "useDateFormat": true, + "useDebounce": true, + "useDebounceFn": true, + "useDebouncedRefHistory": true, + "useDeviceMotion": true, + "useDeviceOrientation": true, + "useDevicePixelRatio": true, + "useDevicesList": true, + "useDisplayMedia": true, + "useDocumentVisibility": true, + "useDraggable": true, + "useDropZone": true, + "useElementBounding": true, + "useElementByPoint": true, + "useElementHover": true, + "useElementSize": true, + "useElementVisibility": true, + "useEventBus": true, + "useEventListener": true, + "useEventSource": true, + "useEyeDropper": true, + "useFavicon": true, + "useFetch": true, + "useFileDialog": true, + "useFileSystemAccess": true, + "useFocus": true, + "useFocusWithin": true, + "useFps": true, + "useFullscreen": true, + "useGamepad": true, + "useGeolocation": true, + "useId": true, + "useIdle": true, + "useImage": true, + "useInfiniteScroll": true, + "useIntersectionObserver": true, + "useInterval": true, + "useIntervalFn": true, + "useKeyModifier": true, + "useLastChanged": true, + "useLink": true, + "useLocalStorage": true, + "useMagicKeys": true, + "useManualRefHistory": true, + "useMediaControls": true, + "useMediaQuery": true, + "useMemoize": true, + "useMemory": true, + "useModel": true, + "useMounted": true, + "useMouse": true, + "useMouseInElement": true, + "useMousePressed": true, + "useMutationObserver": true, + "useNavigatorLanguage": true, + "useNetwork": true, + "useNow": true, + "useObjectUrl": true, + "useOffsetPagination": true, + "useOnline": true, + "usePageLeave": true, + "useParallax": true, + "useParentElement": true, + "usePerformanceObserver": true, + "usePermission": true, + "usePointer": true, + "usePointerLock": true, + "usePointerSwipe": true, + "usePreferredColorScheme": true, + "usePreferredContrast": true, + "usePreferredDark": true, + "usePreferredLanguages": true, + "usePreferredReducedMotion": true, + "usePreferredReducedTransparency": true, + "usePrevious": true, + "useRafFn": true, + "useRefHistory": true, + "useResizeObserver": true, + "useRoute": true, + "useRouter": true, + "useSSRWidth": true, + "useScreenOrientation": true, + "useScreenSafeArea": true, + "useScriptTag": true, + "useScroll": true, + "useScrollLock": true, + "useSessionStorage": true, + "useShare": true, + "useSlots": true, + "useSorted": true, + "useSpeechRecognition": true, + "useSpeechSynthesis": true, + "useStepper": true, + "useStorage": true, + "useStorageAsync": true, + "useStyleTag": true, + "useSupported": true, + "useSwipe": true, + "useTemplateRef": true, + "useTemplateRefsList": true, + "useTextDirection": true, + "useTextSelection": true, + "useTextareaAutosize": true, + "useThrottle": true, + "useThrottleFn": true, + "useThrottledRefHistory": true, + "useTimeAgo": true, + "useTimeout": true, + "useTimeoutFn": true, + "useTimeoutPoll": true, + "useTimestamp": true, + "useTitle": true, + "useToNumber": true, + "useToString": true, + "useToggle": true, + "useTransition": true, + "useUrlSearchParams": true, + "useUserMedia": true, + "useVModel": true, + "useVModels": true, + "useVibrate": true, + "useVirtualList": true, + "useWakeLock": true, + "useWebNotification": true, + "useWebSocket": true, + "useWebWorker": true, + "useWebWorkerFn": true, + "useWindowFocus": true, + "useWindowScroll": true, + "useWindowSize": true, + "watch": true, + "watchArray": true, + "watchAtMost": true, + "watchDebounced": true, + "watchDeep": true, + "watchEffect": true, + "watchIgnorable": true, + "watchImmediate": true, + "watchOnce": true, + "watchPausable": true, + "watchPostEffect": true, + "watchSyncEffect": true, + "watchThrottled": true, + "watchTriggerable": true, + "watchWithFilter": true, + "whenever": true + } +} diff --git a/web/src/views/xg/xsjcxx/stuRoster/README.md b/web/src/views/xg/xsjcxx/stuRoster/README.md new file mode 100644 index 00000000..9f014d1f --- /dev/null +++ b/web/src/views/xg/xsjcxx/stuRoster/README.md @@ -0,0 +1,202 @@ +# 学生花名册管理功能实现说明 + +## 功能概述 + +学生花名册管理界面用于展示和管理学生信息，支持高级复杂检索、导出、查看等操作。 + +## 文件结构 + +``` +web/src/views/xg/xsjcxx/stuRoster/ +├── index.vue # 主界面文件 +├── components/ # 组件目录 +│ ├── AdvancedSearchDialog.vue # 高级检索弹窗 +│ └── StudentDetailDialog.vue # 学生详情弹窗 +├── test.vue # 测试页面 +└── README.md # 说明文档 +``` + +## 功能特性 + +### 1. 主界面 (index.vue) + +#### 布局设计 +- **左右布局模式**：左侧固定宽高的部门树，右侧内容区域 +- **部门树功能**： + - 支持纵向和横向滚动条 + - 支持多选功能 + - 支持搜索过滤 + - 清空选择功能 + +#### 检索功能 +- **基础检索**：学号、学生姓名、手机号码、状态四个检索条件 +- **高级检索**：弹出专门弹窗配置检索条件 +- **检索按钮**：搜索、重置、高级检索 + +#### 数据展示 +- **双视图模式**：列表视图和卡片视图 +- **列表视图**：标准表格展示，支持列显示控制 +- **卡片视图**：卡片式布局，每行4个卡片 +- **分页功能**：支持分页显示 + +#### 操作功能 +- **导出数据**：支持数据导出功能 +- **查看详情**：查看学生完整信息 +- **列控制**：通过right-toolbar控制列显示 + +### 2. 高级检索弹窗 (AdvancedSearchDialog.vue) + +#### 检索字段覆盖 +支持 `xg_student_msg` 表中所有字段的检索功能： + +**基础信息** +- 身份证号、英文姓名、曾用名、性别 +- 出生日期（时间范围）、民族、籍贯、政治面貌 +- 户籍所在地、家庭地址、现住址、邮政编码 +- 电子邮箱、QQ号码、微信号、婚姻状况 + +**学籍信息** +- 入学年份、入学日期（时间范围）、录取类别 +- 学制、学历层次、培养方式、年级、户口类型 + +**家庭信息** +- 父亲信息：姓名、电话、工作单位 +- 母亲信息：姓名、电话、工作单位 +- 监护人信息：姓名、电话、关系 +- 经济信息：家庭年收入、人均收入、收入来源、经济状况、成员数量 +- 紧急联系人信息 + +**特殊标识** +- 贫困生、少数民族、残疾、孤儿、留守儿童、独生子女、低保、助学贷款等标识 +- 宗教信仰、生源地区 + +**健康信息** +- 身高、体重（数值范围） +- 血型、健康状况、特殊体质、病史、过敏史 +- 残疾类型、残疾等级 +- 特长爱好、获奖情况、违纪记录、社会活动 + +**时间范围** +- 创建时间、更新时间（时间范围） + +#### 检索特性 +- **文本检索**：采用like模式 +- **下拉选择**：支持多选 +- **时间范围**：支持开始时间到结束时间的跨度检索 +- **数值范围**：支持最小值和最大值范围检索 +- **每行4个**：检索条件每4个放一行 + +### 3. 学生详情弹窗 (StudentDetailDialog.vue) + +#### Tab页设计 +参考 `stuMsgDetailDialog.vue` 结构，分为5个Tab页： + +**基础信息** +- 学生照片和基本信息布局 +- 学号、身份证号、姓名、英文姓名、曾用名、性别 +- 出生日期、民族、籍贯、政治面貌 +- 手机号码、电子邮箱、QQ号码、微信号、婚姻状况 +- 宗教信仰、户籍所在地、家庭地址、现住址、邮政编码 +- 生源地区、毕业院校、户口类型 + +**学籍信息** +- 学籍状态、入学年份、入学日期、录取类别 +- 学制、学历层次、培养方式、年级、是否住校 +- 学院、专业、班级、辅导员、班主任 +- 宿舍楼栋、宿舍房间号、银行卡号、开户银行 + +**家庭信息** +- 父亲信息：姓名、电话、工作单位 +- 母亲信息：姓名、电话、工作单位 +- 监护人信息：姓名、电话、关系 +- 经济信息：家庭年收入、人均收入、收入来源、经济状况、成员数量 +- 紧急联系人信息 + +**特殊标识** +- 各种特殊标识的状态展示（使用Tag标签） +- 助学贷款金额、残疾类型、残疾等级 + +**健康信息** +- 身高、体重、血型 +- 健康状况、特殊体质或疾病、病史、过敏史 +- 特长爱好、获奖情况、违纪记录、社会活动 + +#### 展示特性 +- **只读模式**：所有字段都是禁用状态，仅用于查看 +- **状态标签**：使用不同颜色的Tag标签展示状态 +- **照片展示**：学生照片展示 +- **加载状态**：数据加载时显示loading状态 + +### 4. 测试页面 (test.vue) + +#### 测试功能 +- **基础功能测试**：查询条件输入和查询功能 +- **模拟数据展示**：表格形式展示模拟数据 +- **弹窗测试**：高级检索和详情弹窗的测试 +- **状态展示**：学生状态的Tag标签展示 + +## 技术实现 + +### 数据模型 +基于 `xg_student_msg` 表结构，包含： +- 基础信息字段（学号、姓名、性别等） +- 学籍信息字段（状态、入学年份等） +- 家庭信息字段（父母信息、经济状况等） +- 特殊标识字段（贫困生、少数民族等） +- 健康信息字段（身高、体重、病史等） + +### 组件设计 +- **主界面组件**：负责整体布局和主要功能 +- **高级检索组件**：独立的弹窗组件，负责复杂检索 +- **详情展示组件**：独立的弹窗组件，负责信息展示 +- **测试组件**：用于功能测试和验证 + +### 状态管理 +- **查询参数**：基础查询参数和高级查询参数 +- **视图状态**：列表视图和卡片视图切换 +- **弹窗状态**：各种弹窗的显示控制 +- **选择状态**：部门树的多选状态 + +### 模拟数据 +目前使用模拟数据进行展示，包含： +- 3个示例学生数据 +- 完整的字段信息 +- 不同的状态值 + +## 待完善功能 + +### API对接 +- 需要对接真实的学生信息API +- 实现数据的增删改查功能 +- 实现导出功能 + +### 权限控制 +- 根据用户权限控制功能访问 +- 实现数据权限过滤 + +### 性能优化 +- 大数据量时的分页优化 +- 检索性能优化 +- 组件懒加载 + +### 用户体验 +- 更多的交互动画 +- 响应式布局优化 +- 移动端适配 + +## 使用说明 + +1. **访问路径**：`/xg/xsjcxx/stuRoster` +2. **测试页面**：`/xg/xsjcxx/stuRoster/test` +3. **主要功能**： + - 左侧选择部门 + - 右侧进行检索 + - 查看学生详情 + - 导出数据 + +## 开发规范 + +- 遵循Vue 3 Composition API规范 +- 使用TypeScript进行类型检查 +- 遵循Element Plus设计规范 +- 组件化开发，保持代码可维护性 \ No newline at end of file diff --git a/web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue b/web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue new file mode 100644 index 00000000..5523ac37 --- /dev/null +++ b/web/src/views/xg/xsjcxx/stuRoster/components/AdvancedSearchDialog.vue @@ -0,0 +1,786 @@ + + + + + diff --git a/web/src/views/xg/xsjcxx/stuRoster/components/StudentDetailDialog.vue b/web/src/views/xg/xsjcxx/stuRoster/components/StudentDetailDialog.vue new file mode 100644 index 00000000..b3648388 --- /dev/null +++ b/web/src/views/xg/xsjcxx/stuRoster/components/StudentDetailDialog.vue @@ -0,0 +1,891 @@ + + + + + diff --git a/web/src/views/xg/xsjcxx/stuRoster/index.vue b/web/src/views/xg/xsjcxx/stuRoster/index.vue new file mode 100644 index 00000000..27ea8054 --- /dev/null +++ b/web/src/views/xg/xsjcxx/stuRoster/index.vue @@ -0,0 +1,1233 @@ + + + + +