cykj/hzdyjs

0 Fork 0

Files

T

weizhong cefc07d471 “班主任考核数据”

2025-08-19 15:27:06 +08:00

5.1 KiB

Raw Blame History

班主任考核管理部署说明

📋 功能概述

班主任考核管理功能允许班主任查看和管理自己担任班主任的班级的考核指标得分。该功能包含以下特性：

根据当前登录班主任自动显示其管理的班级标签页
每个班级标签页独立显示该班级的考核计划列表
只显示计划状态为启用的考核计划
提供考核提交和查看功能（功能框架已实现，业务逻辑待完善）

🚀 部署步骤

1. 后端部署

1.1 新增文件清单

Controller层

backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/controller/TeacherAssessmentController.java

Service层

backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/service/ITeacherAssessmentService.java
backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/service/impl/TeacherAssessmentServiceImpl.java

Mapper层

backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/mapper/TeacherAssessmentMapper.java
backend/ruoyi-modules/ruoyi-bzrkh/src/main/resources/mapper/bzrkh/TeacherAssessmentMapper.xml

Domain层

backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/domain/vo/TeacherClassVo.java
backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/domain/bo/TeacherAssessmentQueryBo.java

1.2 权限配置

执行权限配置SQL文件：

-- 执行以下SQL文件
backend/ruoyi-modules/ruoyi-bzrkh/班主任考核管理权限配置.sql

1.3 重新编译启动

# 编译项目（在后端根目录执行）
mvn clean compile

# 重启应用服务
# 根据实际部署方式重启

2. 前端部署

2.1 新增文件清单

API层

web/src/api/bzrkh/teacherAssessment/types.ts
web/src/api/bzrkh/teacherAssessment/index.ts

视图层

web/src/views/bzrkh/teacherAssessment/index.vue

2.2 重新编译部署

# 安装依赖（如果需要）
npm install

# 编译前端项目
npm run build:prod

# 部署到nginx
# 根据实际部署方式进行部署

🔐 权限配置

权限字符列表

权限字符	权限说明	对应功能
`bzrkh:teacherAssessment:list`	班主任考核查询权限	查看班级列表、考核计划列表
`bzrkh:teacherAssessment:detail`	班主任考核详情权限	查看考核详情
`bzrkh:teacherAssessment:submit`	班主任考核提交权限	提交考核

API接口权限映射

HTTP方法	接口路径	权限字符	功能说明
GET	`/bzrkh/teacherAssessment/classes`	`bzrkh:teacherAssessment:list`	获取班主任管理的班级列表
GET	`/bzrkh/teacherAssessment/plans`	`bzrkh:teacherAssessment:list`	获取班主任考核计划列表
GET	`/bzrkh/teacherAssessment/detail`	`bzrkh:teacherAssessment:detail`	查看考核详情
POST	`/bzrkh/teacherAssessment/submit`	`bzrkh:teacherAssessment:submit`	提交考核

📊 数据依赖

数据表依赖

主要数据表：
- bmzr_assessment_plan - 班主任考核计划表
- bmzr_assessment_scheme - 班主任考核方案表
- xg_class_msg - 班级信息表
查询条件：
- 班级状态必须为 '1'（正常）
- 考核计划状态必须为 '0'（启用）
- 班主任ID通过当前登录用户自动获取

业务规则

权限控制：班主任只能查看和管理自己担任班主任的班级
数据过滤：只展示状态正常的班级和启用的考核计划
自动关联：系统根据登录用户ID自动获取其担任班主任的班级

🔄 后续开发

待完善功能

提交考核逻辑（TeacherAssessmentServiceImpl.submitAssessment）
- 验证班主任权限
- 验证考核计划有效性
- 创建或更新考核记录
- 更新考核状态
查看考核详情（TeacherAssessmentServiceImpl.getAssessmentDetail）
- 获取考核计划详情
- 获取考核指标详情
- 获取考核记录和评分
- 返回完整的考核详情数据

扩展建议

考核评分页面：为提交考核和查看考核功能创建专门的页面
考核统计：添加班级考核统计和对比功能
考核报告：生成班级考核报告导出功能
消息通知：考核提交后的消息通知机制

⚠️ 注意事项

数据库依赖：确保 xg_class_msg 表存在且包含班主任相关字段
权限验证：所有接口都有权限验证，请确保用户具有相应权限
登录状态：功能依赖当前登录用户信息，确保用户已正常登录
前端兼容：使用了 Element Plus 和 Vue 3 相关特性，确保前端环境兼容

📞 技术支持

如有部署问题，请检查：

后端日志：查看应用启动日志和接口调用日志
数据库连接：确保数据库连接正常且表结构正确
权限配置：确保菜单和按钮权限配置正确
前端控制台：查看浏览器控制台错误信息

文档版本: V1.0.0
创建时间: 2025-01-27
最后更新: 2025-01-27

5.1 KiB Raw Blame History Unescape Escape