“数据更新”

backend/ruoyi-modules/ruoyi-bzrkh/班主任考核提交功能权限配置.md

@@ -0,0 +1,86 @@
+# 班主任考核提交功能权限配置
+
+## API接口权限字符
+
+### 新增的API接口权限
+以下是新增的班主任考核提交功能相关的API接口权限字符，需要在系统菜单权限中进行配置：
+
+1. **获取考核提交详情数据**
+   - 权限字符：`bzrkh:teacherAssessment:detail`
+   - 接口路径：`GET /bzrkh/teacherAssessment/submitDetail`
+   - 功能描述：获取考核提交弹窗的详情数据
+
+2. **提交考核评分数据**
+   - 权限字符：`bzrkh:teacherAssessment:submit`
+   - 接口路径：`POST /bzrkh/teacherAssessment/submitScore`
+   - 功能描述：提交班主任考核评分数据
+
+### 现有的API接口权限
+以下是现有的相关API接口权限：
+
+1. **查询班主任管理的班级列表**
+   - 权限字符：`bzrkh:teacherAssessment:list`
+   - 接口路径：`GET /bzrkh/teacherAssessment/classes`
+
+2. **查询班主任考核计划列表**
+   - 权限字符：`bzrkh:teacherAssessment:list`
+   - 接口路径：`GET /bzrkh/teacherAssessment/plans`
+
+3. **提交考核（原有）**
+   - 权限字符：`bzrkh:teacherAssessment:submit`
+   - 接口路径：`POST /bzrkh/teacherAssessment/submit`
+
+4. **查看考核详情（原有）**
+   - 权限字符：`bzrkh:teacherAssessment:detail`
+   - 接口路径：`GET /bzrkh/teacherAssessment/detail`
+
+## 菜单权限配置建议
+
+### 菜单配置
+建议在系统管理-菜单管理中配置以下菜单项：
+
+```
+父菜单：班主任考核管理
+├── 考核计划管理（已有）
+└── 班主任考核提交（新增）
+    ├── 权限字符：bzrkh:teacherAssessment:list
+    ├── 权限字符：bzrkh:teacherAssessment:detail  
+    └── 权限字符：bzrkh:teacherAssessment:submit
+```
+
+### 角色权限分配
+建议为以下角色分配相应权限：
+
+1. **班主任角色**
+   - `bzrkh:teacherAssessment:list` - 查看班级和考核计划列表
+   - `bzrkh:teacherAssessment:detail` - 查看考核详情
+   - `bzrkh:teacherAssessment:submit` - 提交考核
+
+2. **学工管理员角色**
+   - 全部权限（包括考核计划管理权限）
+
+3. **系统管理员角色**
+   - 全部权限
+
+## 数据库表说明
+
+### 涉及的主要表
+1. `bmzr_assessment_score` - 班主任考核得分表（核心业务表）
+2. `bmzr_assessment_plan` - 考核计划表
+3. `bmzr_assessment_scheme` - 考核方案表
+4. `bmzr_assessment_indicator` - 考核指标表
+5. `xg_class_msg` - 班级信息表
+6. `xg_student_msg` - 学生信息表
+
+### 关键业务逻辑
+1. **系数计算**：根据班级人数、住校生人数、班级层次自动计算系数
+2. **指标管理**：支持常规工作指标、班级扣分指标、特色工作指标
+3. **数据存储**：评分数据统一存储在`bmzr_assessment_score`表中
+4. **数据更新**：采用逻辑删除+重新插入的方式确保数据一致性
+
+## 注意事项
+
+1. 权限配置完成后需要重新登录系统生效
+2. 确保相关角色用户已分配对应的菜单权限
+3. 建议先在测试环境验证权限配置正确性
+4. 需要确保数据库中存在相关的考核指标数据（特别是5个特定编码的指标）