cykj/hzdyjs
1
0 Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

提交代码

Browse Source
This commit is contained in:
zlwu committed 2025-08-18 12:12:12 +08:00
1 parent 56ede5d005
commit 5dfc7f6bd8
101 files changed
-20501
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/开发文档/API/学生考核管理系统API.md
-649
View File
@@ -1,649 +0,0 @@
# 学生考核管理系统API文档
## 📋 文档信息
| 项目 | 信息 |
|------|------|
| **模块名称** | 学生考核管理系统 (XSKH) |
| **API版本** | V1.0.0 |
| **创建时间** | 2025-01-27 |
| **更新时间** | 2025-01-27 |
| **技术架构** | Spring Boot 3.4.6 + MyBatis-Plus + Vue 3 |
| **开发状态** | ✅ 后端API完成，前端页面完成，系统可用 |
## 🎯 系统概述
学生考核管理系统是校园管理平台的核心模块之一，提供完整的学生综合素质测评、违纪处分管理、奖励加分管理等功能。系统支持灵活的考核方案配置、多维度指标体系、智能化评分计算和完善的审批流程。
### 核心特性
- ✅ **灵活的考核方案** - 支持多套考核方案并行，适应不同专业和年级
- ✅ **多维度指标体系** - 德智体美劳全面评价，权重可配置
- ✅ **智能化评分** - 自动计算综合分数，支持复杂评分规则
- ✅ **完整的审批流程** - 违纪处分、奖励加分等支持多级审批
- ✅ **统计分析功能** - 提供丰富的数据统计和可视化分析
- ✅ **权限精细控制** - 支持角色权限和数据权限双重控制
## 🗄️ 系统架构
### 核心模块
```
学生考核管理系统 (XSKH)
├── 考核方案管理 (AssessmentScheme)
├── 考核指标管理 (AssessmentIndicator)
├── 考核计划管理 (AssessmentPlan)
├── 考核明细管理 (AssessmentDetail)
├── 考核记录管理 (AssessmentRecord)
├── 方案指标关联 (SchemeIndicator)
├── 违纪记录管理 (DisciplineRecord)
├── 违纪类型管理 (DisciplineType)
├── 处分类型管理 (PunishmentType)
├── 附加分申请 (BonusApplication)
├── 违纪事件管理 (DisciplineEvent)
├── 违纪计分规则 (DisciplineScoreRule)
└── 违纪计分计算 (DisciplineScoreCalculation)
```
### 数据库表结构
| 表名 | 说明 | 主要字段 |
|------|------|----------|
| `xskh_assessment_scheme` | 考核方案表 | scheme_code, scheme_name, scheme_type |
| `xskh_assessment_indicator` | 考核指标表 | indicator_code, indicator_name, weight |
| `xskh_assessment_plan` | 考核计划表 | plan_code, plan_name, scheme_id |
| `xskh_assessment_detail` | 考核明细表 | plan_id, student_id, indicator_id, score |
| `xskh_assessment_record` | 考核记录表 | plan_id, student_id, total_score |
| `xskh_scheme_indicator` | 方案指标关联表 | scheme_id, indicator_id, weight |
| `xskh_discipline_record` | 违纪记录表 | student_id, discipline_type_id, punishment_type_id |
| `xskh_discipline_type` | 违纪类型表 | type_code, type_name, severity |
| `xskh_punishment_type` | 处分类型表 | type_code, type_name, level, valid_days |
| `xskh_bonus_application` | 附加分申请表 | student_id, bonus_type, bonus_score |
## 🔗 API接口总览
### 1. 考核方案管理 (AssessmentScheme)
#### 1.1 查询考核方案列表
**接口地址**: `GET /xskh/scheme/list`
**权限要求**: `xskh:scheme:list`
**接口描述**: 分页查询考核方案列表，支持多条件筛选
**请求参数**:
```json
{
"pageNum": 1,
"pageSize": 10,
"schemeCode": "SCHEME202501",
"schemeName": "综合测评方案",
"schemeType": "1",
"status": "1"
}
```
**响应示例**:
```json
{
"code": 200,
"msg": "查询成功",
"rows": [
{
"id": 1001,
"schemeCode": "SCHEME202501001",
"schemeName": "2025年春季学期综合测评方案",
"schemeDesc": "面向全校本科生的综合测评方案",
"schemeType": "1",
"status": "1",
"isDefault": "1",
"createTime": "2025-01-27 10:00:00"
}
],
"total": 1
}
```
#### 1.2 获取考核方案详情
**接口地址**: `GET /xskh/scheme/{id}`
**权限要求**: `xskh:scheme:query`
#### 1.3 新增考核方案
**接口地址**: `POST /xskh/scheme`
**权限要求**: `xskh:scheme:add`
#### 1.4 修改考核方案
**接口地址**: `PUT /xskh/scheme`
**权限要求**: `xskh:scheme:edit`
#### 1.5 删除考核方案
**接口地址**: `DELETE /xskh/scheme/{ids}`
**权限要求**: `xskh:scheme:remove`
#### 1.6 获取可用方案选项
**接口地址**: `GET /xskh/scheme/options`
**权限要求**: `xskh:scheme:list`
### 2. 考核指标管理 (AssessmentIndicator)
#### 2.1 查询考核指标列表
**接口地址**: `GET /xskh/assessmentIndicator/list`
**权限要求**: `xskh:assessmentIndicator:list`
**请求参数**:
```json
{
"pageNum": 1,
"pageSize": 10,
"indicatorCode": "IND001",
"indicatorName": "德育指标",
"indicatorType": "1",
"status": "1"
}
```
#### 2.2 获取考核指标详情
**接口地址**: `GET /xskh/assessmentIndicator/{id}`
**权限要求**: `xskh:assessmentIndicator:query`
#### 2.3 新增考核指标
**接口地址**: `POST /xskh/assessmentIndicator`
**权限要求**: `xskh:assessmentIndicator:add`
**请求参数**:
```json
{
"indicatorCode": "IND001",
"indicatorName": "德育指标",
"indicatorDesc": "德育素质评价指标",
"indicatorType": "1",
"weight": 30.0,
"maxScore": 100.0,
"minScore": 0.0,
"status": "1"
}
```
#### 2.4 修改考核指标
**接口地址**: `PUT /xskh/assessmentIndicator`
**权限要求**: `xskh:assessmentIndicator:edit`
#### 2.5 删除考核指标
**接口地址**: `DELETE /xskh/assessmentIndicator/{ids}`
**权限要求**: `xskh:assessmentIndicator:remove`
#### 2.6 获取可用指标选项
**接口地址**: `GET /xskh/assessmentIndicator/options`
**权限要求**: `xskh:assessmentIndicator:list`
### 3. 考核计划管理 (AssessmentPlan)
#### 3.1 查询考核计划列表
**接口地址**: `GET /xskh/assessmentPlan/list`
**权限要求**: `xskh:assessmentPlan:list`
**请求参数**:
```json
{
"pageNum": 1,
"pageSize": 10,
"planCode": "PLAN202501",
"planName": "春季学期综合测评",
"schemeId": 1001,
"planCycle": "2024-2025学年第二学期",
"status": "2"
}
```
#### 3.2 获取考核计划详情
**接口地址**: `GET /xskh/assessmentPlan/{id}`
**权限要求**: `xskh:assessmentPlan:query`
#### 3.3 新增考核计划
**接口地址**: `POST /xskh/assessmentPlan`
**权限要求**: `xskh:assessmentPlan:add`
**请求参数**:
```json
{
"planCode": "PLAN202501001",
"planName": "2025年春季学期综合测评计划",
"planDesc": "面向全校本科生的综合测评计划",
"schemeId": 1001,
"planCycle": "2024-2025学年第二学期",
"startDate": "2025-02-01",
"endDate": "2025-06-30",
"status": "1"
}
```
#### 3.4 修改考核计划
**接口地址**: `PUT /xskh/assessmentPlan`
**权限要求**: `xskh:assessmentPlan:edit`
#### 3.5 删除考核计划
**接口地址**: `DELETE /xskh/assessmentPlan/{ids}`
**权限要求**: `xskh:assessmentPlan:remove`
#### 3.6 发布考核计划
**接口地址**: `PUT /xskh/assessmentPlan/publish/{id}`
**权限要求**: `xskh:assessmentPlan:publish`
#### 3.7 获取我的考核计划
**接口地址**: `GET /xskh/assessmentPlan/my`
**权限要求**: `xskh:assessmentPlan:list`
### 4. 考核明细管理 (AssessmentDetail)
#### 4.1 查询考核明细列表
**接口地址**: `GET /xskh/assessmentDetail/list`
**权限要求**: `xskh:assessmentDetail:list`
**请求参数**:
```json
{
"pageNum": 1,
"pageSize": 10,
"planId": 1001,
"studentId": 1001,
"studentNo": "2023001001",
"studentName": "张三",
"indicatorId": 1001
}
```
#### 4.2 获取考核明细详情
**接口地址**: `GET /xskh/assessmentDetail/{id}`
**权限要求**: `xskh:assessmentDetail:query`
#### 4.3 新增考核明细
**接口地址**: `POST /xskh/assessmentDetail`
**权限要求**: `xskh:assessmentDetail:add`
**请求参数**:
```json
{
"planId": 1001,
"studentId": 1001,
"studentNo": "2023001001",
"studentName": "张三",
"indicatorId": 1001,
"score": 85.0,
"evidenceFiles": "证明材料.pdf",
"remark": "表现优秀"
}
```
#### 4.4 修改考核明细
**接口地址**: `PUT /xskh/assessmentDetail`
**权限要求**: `xskh:assessmentDetail:edit`
#### 4.5 删除考核明细
**接口地址**: `DELETE /xskh/assessmentDetail/{ids}`
**权限要求**: `xskh:assessmentDetail:remove`
#### 4.6 批量计算分数
**接口地址**: `POST /xskh/assessmentDetail/calculateBatch`
**权限要求**: `xskh:assessmentDetail:calculate`
**请求参数**:
```json
{
"planId": 1001,
"studentIds": [1001, 1002, 1003]
}
```
#### 4.7 导出考核明细
**接口地址**: `POST /xskh/assessmentDetail/export`
**权限要求**: `xskh:assessmentDetail:export`
#### 4.8 导入考核明细
**接口地址**: `POST /xskh/assessmentDetail/import`
**权限要求**: `xskh:assessmentDetail:import`
### 5. 违纪记录管理 (DisciplineRecord)
#### 5.1 查询违纪记录列表
**接口地址**: `GET /xskh/disciplineRecord/list`
**权限要求**: `xskh:disciplineRecord:list`
**请求参数**:
```json
{
"pageNum": 1,
"pageSize": 10,
"recordNo": "XSKH202501001",
"caseNo": "CASE001",
"studentId": 1001,
"studentNo": "2023001001",
"studentName": "张三",
"disciplineTypeId": 1001,
"punishmentTypeId": 1001,
"status": "2"
}
```
#### 5.2 获取违纪记录详情
**接口地址**: `GET /xskh/disciplineRecord/{id}`
**权限要求**: `xskh:disciplineRecord:query`
#### 5.3 新增违纪记录
**接口地址**: `POST /xskh/disciplineRecord`
**权限要求**: `xskh:disciplineRecord:add`
**请求参数**:
```json
{
"caseNo": "CASE202501001",
"studentId": 1001,
"studentNo": "2023001001",
"studentName": "张三",
"disciplineTypeId": 1001,
"disciplineDate": "2025-01-27",
"disciplineDesc": "违纪详情描述",
"punishmentTypeId": 1001,
"punishmentDate": "2025-01-27",
"effectiveDate": "2025-01-27",
"expireDate": "2025-04-27",
"evidenceFiles": "证据材料.pdf",
"remark": "备注信息"
}
```
#### 5.4 修改违纪记录
**接口地址**: `PUT /xskh/disciplineRecord`
**权限要求**: `xskh:disciplineRecord:edit`
#### 5.5 删除违纪记录
**接口地址**: `DELETE /xskh/disciplineRecord/{ids}`
**权限要求**: `xskh:disciplineRecord:remove`
#### 5.6 审核违纪记录
**接口地址**: `PUT /xskh/disciplineRecord/approve/{id}`
**权限要求**: `xskh:disciplineRecord:approve`
**请求参数**:
```json
{
"approveResult": "1",
"approveRemark": "审核通过"
}
```
#### 5.7 获取我的违纪记录
**接口地址**: `GET /xskh/disciplineRecord/my`
**权限要求**: `xskh:disciplineRecord:list`
#### 5.8 获取待处理记录
**接口地址**: `GET /xskh/disciplineRecord/pending`
**权限要求**: `xskh:disciplineRecord:approve`
### 6. 违纪类型管理 (DisciplineType)
#### 6.1 查询违纪类型列表
**接口地址**: `GET /xskh/disciplineType/list`
**权限要求**: `xskh:disciplineType:list`
#### 6.2 获取违纪类型详情
**接口地址**: `GET /xskh/disciplineType/{id}`
**权限要求**: `xskh:disciplineType:query`
#### 6.3 新增违纪类型
**接口地址**: `POST /xskh/disciplineType`
**权限要求**: `xskh:disciplineType:add`
**请求参数**:
```json
{
"typeCode": "WJLX001",
"typeName": "旷课",
"typeDesc": "无故不参加规定的教学活动",
"parentId": 0,
"severity": "2",
"scoreDeduction": 5.0,
"status": "1"
}
```
#### 6.4 修改违纪类型
**接口地址**: `PUT /xskh/disciplineType`
**权限要求**: `xskh:disciplineType:edit`
#### 6.5 删除违纪类型
**接口地址**: `DELETE /xskh/disciplineType/{ids}`
**权限要求**: `xskh:disciplineType:remove`
#### 6.6 获取可用类型选项
**接口地址**: `GET /xskh/disciplineType/options`
**权限要求**: `xskh:disciplineType:list`
### 7. 处分类型管理 (PunishmentType)
#### 7.1 查询处分类型列表
**接口地址**: `GET /xskh/punishmentType/list`
**权限要求**: `xskh:punishmentType:list`
#### 7.2 获取处分类型详情
**接口地址**: `GET /xskh/punishmentType/{id}`
**权限要求**: `xskh:punishmentType:query`
#### 7.3 新增处分类型
**接口地址**: `POST /xskh/punishmentType`
**权限要求**: `xskh:punishmentType:add`
**请求参数**:
```json
{
"typeCode": "CFLX001",
"typeName": "警告",
"typeDesc": "对违纪学生的警告处分",
"level": "1",
"scoreDeduction": 10.0,
"validDays": 90,
"canAppeal": "1",
"appealDays": 15,
"status": "1"
}
```
#### 7.4 修改处分类型
**接口地址**: `PUT /xskh/punishmentType`
**权限要求**: `xskh:punishmentType:edit`
#### 7.5 删除处分类型
**接口地址**: `DELETE /xskh/punishmentType/{ids}`
**权限要求**: `xskh:punishmentType:remove`
#### 7.6 获取可用处分类型选项
**接口地址**: `GET /xskh/punishmentType/options`
**权限要求**: `xskh:punishmentType:list`
### 8. 附加分申请管理 (BonusApplication)
#### 8.1 查询附加分申请列表
**接口地址**: `GET /xskh/bonusApplication/list`
**权限要求**: `xskh:bonusApplication:list`
#### 8.2 获取附加分申请详情
**接口地址**: `GET /xskh/bonusApplication/{id}`
**权限要求**: `xskh:bonusApplication:query`
#### 8.3 新增附加分申请
**接口地址**: `POST /xskh/bonusApplication`
**权限要求**: `xskh:bonusApplication:add`
**请求参数**:
```json
{
"studentId": 1001,
"studentNo": "2023001001",
"studentName": "张三",
"bonusType": "1",
"bonusReason": "参加学科竞赛获奖",
"bonusScore": 10.0,
"evidenceFiles": "获奖证书.pdf",
"applyDate": "2025-01-27",
"remark": "国家级一等奖"
}
```
#### 8.4 修改附加分申请
**接口地址**: `PUT /xskh/bonusApplication`
**权限要求**: `xskh:bonusApplication:edit`
#### 8.5 删除附加分申请
**接口地址**: `DELETE /xskh/bonusApplication/{ids}`
**权限要求**: `xskh:bonusApplication:remove`
#### 8.6 审核附加分申请
**接口地址**: `PUT /xskh/bonusApplication/approve/{id}`
**权限要求**: `xskh:bonusApplication:approve`
**请求参数**:
```json
{
"approveResult": "1",
"approveScore": 10.0,
"approveRemark": "审核通过，给予10分加分"
}
```
#### 8.7 获取我的申请
**接口地址**: `GET /xskh/bonusApplication/my`
**权限要求**: `xskh:bonusApplication:list`
#### 8.8 获取待处理申请
**接口地址**: `GET /xskh/bonusApplication/pending`
**权限要求**: `xskh:bonusApplication:approve`
## 🔐 权限配置
### 菜单权限配置
```sql
-- 学生考核管理主菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark)
VALUES ('学生考核管理', 0, 8, 'xskh', null, 1, 0, 'M', '0', '0', null, 'student', 'admin', sysdate(), '', null, '学生考核管理目录');
-- 考核方案管理
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark)
VALUES ('考核方案管理', @parent_menu_id, 1, 'scheme', 'xskh/scheme/index', 1, 0, 'C', '0', '0', 'xskh:scheme:list', 'form', 'admin', sysdate(), '', null, '考核方案管理菜单');
-- 考核指标管理
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark)
VALUES ('考核指标管理', @parent_menu_id, 2, 'indicator', 'xskh/indicator/index', 1, 0, 'C', '0', '0', 'xskh:assessmentIndicator:list', 'tree-table', 'admin', sysdate(), '', null, '考核指标管理菜单');
-- 违纪记录管理
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark)
VALUES ('违纪记录管理', @parent_menu_id, 3, 'disciplineRecord', 'xskh/disciplineRecord/index', 1, 0, 'C', '0', '0', 'xskh:disciplineRecord:list', 'documentation', 'admin', sysdate(), '', null, '违纪记录管理菜单');
```
### 接口权限配置
| 权限标识 | 权限名称 | 说明 |
|----------|----------|------|
| `xskh:scheme:list` | 查看考核方案 | 查询考核方案列表 |
| `xskh:scheme:query` | 查看方案详情 | 获取考核方案详细信息 |
| `xskh:scheme:add` | 新增考核方案 | 创建新的考核方案 |
| `xskh:scheme:edit` | 修改考核方案 | 编辑现有考核方案 |
| `xskh:scheme:remove` | 删除考核方案 | 删除考核方案 |
| `xskh:assessmentIndicator:list` | 查看考核指标 | 查询考核指标列表 |
| `xskh:disciplineRecord:list` | 查看违纪记录 | 查询违纪记录列表 |
| `xskh:disciplineRecord:approve` | 审核违纪记录 | 审批违纪处分 |
| `xskh:bonusApplication:list` | 查看附加分申请 | 查询附加分申请列表 |
| `xskh:bonusApplication:approve` | 审核附加分申请 | 审批附加分申请 |
## 📊 数据字典
### 考核方案类型 (scheme_type)
- `1`: 本科生方案
- `2`: 研究生方案
- `3`: 专科生方案
### 考核指标类型 (indicator_type)
- `1`: 德育指标
- `2`: 智育指标
- `3`: 体育指标
- `4`: 美育指标
- `5`: 劳育指标
### 违纪严重程度 (severity)
- `1`: 轻微
- `2`: 一般
- `3`: 严重
- `4`: 特别严重
### 处分等级 (level)
- `1`: 警告
- `2`: 严重警告
- `3`: 记过
- `4`: 留校察看
- `5`: 开除学籍
### 审核状态 (status)
- `1`: 待审核
- `2`: 审核通过
- `3`: 审核拒绝
- `4`: 已撤销
### 附加分类型 (bonus_type)
- `1`: 学科竞赛
- `2`: 科研成果
- `3`: 社会实践
- `4`: 志愿服务
- `5`: 文体活动
- `6`: 其他
## 🧪 测试说明
### 测试环境配置
- **服务器地址**: http://localhost:8080
- **测试账号**: admin / 123456
- **客户端ID**: e5cd7e4891bf95d1d19206ce24a7b32e
### 测试脚本
- **Python测试脚本**: `test/xskh-comprehensive-api-test.py`
- **JavaScript测试脚本**: `test/xskh-discipline-record-api-test.js`
### 测试覆盖范围
- ✅ 用户登录（AES+RSA双重加密）
- ✅ 13个模块的核心CRUD接口
- ✅ 业务流程接口（审核、发布等）
- ✅ 权限验证
- ✅ 数据格式验证
- ✅ 异常处理
## 📝 开发注意事项
### 1. 数据库规范
- 所有表必须包含标准基础字段（create_by, create_time, update_by, update_time）
- 使用雪花ID作为主键
- 支持逻辑删除（deleted字段）
- 支持多租户（tenant_id字段）
### 2. API规范
- 统一使用Bearer Token认证
- 分页查询使用TableDataInfo响应格式
- 非分页查询使用R类型响应格式
- 所有接口必须添加权限注解
### 3. 前端规范
- 使用Vue 3 + TypeScript + Element Plus
- 遵循Art Design Pro设计规范
- 统一的错误处理和消息提示
### 4. 业务规范
- 考核方案支持版本管理
- 违纪记录支持申诉流程
- 附加分申请支持审批流程
- 所有评分计算支持规则配置
## 📞 技术支持
- **开发团队**: 系统开发组
- **技术栈**: Spring Boot 3.4.6 + MyBatis-Plus + Vue 3
- **文档更新**: 2025-01-27
- **版本**: V1.0.0
---
**📝 说明**: 本文档基于实际开发的API接口编写，所有接口均已完成开发和测试。如有问题请联系开发团队。
docs/开发文档/API/学生考核管理系统API修改方案.md
-490
View File
@@ -1,490 +0,0 @@
# 学生考核管理系统修改方案
## 📋 修改概述
| 项目 | 信息 |
|------|------|
| **修改模块** | 考核计划管理 + 指标体系管理 + 违纪处分体系 |
| **修改版本** | V2.0.0 |
| **修改时间** | 2025-01-27 |
| **修改原因** | 基于标准化违纪处分等级，优化考核计划配置和指标体系 |
| **影响范围** | 数据库表结构、API接口、前端界面 |
## 🎯 核心修改内容
### 1. 违纪处分标准化体系
#### 1.1 标准化处分等级定义
```json
{
"punishmentLevels": [
{
"level": "1",
"name": "警告",
"scoreDeduction": "3-5",
"archiveYears": 1,
"description": "轻微违纪行为的处分"
},
{
"level": "2",
"name": "严重警告",
"scoreDeduction": "6-8",
"archiveYears": 2,
"description": "较严重违纪行为的处分"
},
{
"level": "3",
"name": "记过",
"scoreDeduction": "9-12",
"archiveYears": 3,
"description": "严重违纪行为的处分"
},
{
"level": "4",
"name": "留校察看",
"scoreDeduction": "13-20",
"archiveYears": "至毕业",
"description": "特别严重违纪行为的处分"
},
{
"level": "5",
"name": "开除学籍",
"scoreDeduction": "全部",
"archiveYears": "永久",
"description": "极严重违纪行为的处分"
}
]
}
```
#### 1.2 具体违纪情形与处分对应关系
**警告处分（3-5分扣除）**
- 累计旷课6-10课时
- 宿舍使用违规电器（首次）
- 课堂辱骂教师或扰乱秩序
- 抄袭作业/实验报告（首次）
**严重警告处分（6-8分扣除）**
- 考试作弊（未遂）
- 伪造请假条/证明文件
- 网络传播不实信息（未造成重大影响）
- 打架斗殴（未致伤）
**记过处分（9-12分扣除）**
- 考试作弊（已实施）
- 恶意破坏教学/实验设备（损失＜500元）
- 组织赌博或饮酒滋事
- 夜不归宿累计≥5次
**留校察看处分（13-20分扣除）**
- 重复考试作弊或团伙作弊
- 打架斗殴致轻伤
- 传播违法信息（如反动、淫秽内容）
- 盗窃公私财物（金额＜1000元）
**开除学籍处分（全部扣除）**
- 违反刑法或治安管理法被追究刑事责任
- 学术造假（如代写论文、买卖论文）
- 群体斗殴造成重伤或恶劣影响
- 吸毒、贩毒等严重违法行为
### 2. 考核计划管理优化方案
#### 2.1 新增考核计划配置字段
**数据库表结构修改** - `xskh_assessment_plan`
```sql
-- 新增字段
ALTER TABLE xskh_assessment_plan ADD COLUMN base_score DECIMAL(5,2) DEFAULT 100.00 COMMENT '基础分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN pass_score DECIMAL(5,2) DEFAULT 60.00 COMMENT '及格分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN excellent_score DECIMAL(5,2) DEFAULT 85.00 COMMENT '优秀分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN auto_deduct_enabled CHAR(1) DEFAULT '1' COMMENT '是否启用自动扣分(0否1是)';
ALTER TABLE xskh_assessment_plan ADD COLUMN bonus_enabled CHAR(1) DEFAULT '1' COMMENT '是否启用加分项(0否1是)';
ALTER TABLE xskh_assessment_plan ADD COLUMN discipline_weight DECIMAL(3,2) DEFAULT 1.00 COMMENT '违纪扣分权重';
ALTER TABLE xskh_assessment_plan ADD COLUMN bonus_weight DECIMAL(3,2) DEFAULT 1.00 COMMENT '加分项权重';
```
#### 2.2 考核计划配置界面优化
**新增配置选项**：
1. **基础分数设置**：可配置学生初始分数（默认100分）
2. **评级标准**：及格线、优秀线可自定义配置
3. **自动扣分开关**：是否根据违纪记录自动扣分
4. **加分项开关**：是否启用各类加分申请
5. **权重配置**：违纪扣分和加分的权重系数
#### 2.3 新增API接口
```javascript
// 获取考核计划配置选项
GET /xskh/assessmentPlan/config-options
// 响应示例
{
"baseScoreOptions": [80, 90, 100, 110, 120],
"passScoreOptions": [50, 55, 60, 65, 70],
"excellentScoreOptions": [80, 85, 90, 95],
"weightOptions": [0.5, 0.8, 1.0, 1.2, 1.5]
}
// 批量配置考核计划
POST /xskh/assessmentPlan/batch-config
{
"planIds": [1001, 1002],
"config": {
"baseScore": 100,
"passScore": 60,
"excellentScore": 85,
"autoDeductEnabled": "1",
"disciplineWeight": 1.0
}
}
```
### 3. 指标体系管理重构方案
#### 3.1 德智体美劳五育指标体系
**重新设计指标分类**：
```json
{
"indicatorSystem": {
"moral": {
"name": "德育指标",
"weight": 20,
"subIndicators": [
{"name": "思想品德", "weight": 8, "description": "政治立场、道德品质"},
{"name": "行为规范", "weight": 7, "description": "遵纪守法、文明礼貌"},
{"name": "违纪记录", "weight": -15, "description": "违纪处分扣分项", "type": "deduction"}
]
},
"intellectual": {
"name": "智育指标",
"weight": 40,
"subIndicators": [
{"name": "学业成绩", "weight": 30, "description": "课程成绩、GPA"},
{"name": "学习态度", "weight": 5, "description": "出勤率、课堂表现"},
{"name": "创新能力", "weight": 5, "description": "科研项目、学科竞赛"}
]
},
"physical": {
"name": "体育指标",
"weight": 15,
"subIndicators": [
{"name": "体测成绩", "weight": 10, "description": "国家体质健康测试"},
{"name": "体育活动", "weight": 3, "description": "体育比赛、运动会"},
{"name": "健康状况", "weight": 2, "description": "身体健康、心理健康"}
]
},
"aesthetic": {
"name": "美育指标",
"weight": 10,
"subIndicators": [
{"name": "艺术素养", "weight": 5, "description": "艺术课程、文艺活动"},
{"name": "审美能力", "weight": 3, "description": "美学认知、创作能力"},
{"name": "文化传承", "weight": 2, "description": "传统文化、非遗传承"}
]
},
"labor": {
"name": "劳育指标",
"weight": 15,
"subIndicators": [
{"name": "劳动实践", "weight": 8, "description": "劳动课程、实践活动"},
{"name": "社会服务", "weight": 4, "description": "志愿服务、社会实践"},
{"name": "生活技能", "weight": 3, "description": "生活自理、劳动技能"}
]
}
}
}
```
#### 3.2 违纪扣分指标独立管理
**新建违纪扣分计算表** - `xskh_discipline_score_calculation`
```sql
CREATE TABLE xskh_discipline_score_calculation (
id BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
plan_id BIGINT(20) NOT NULL COMMENT '考核计划ID',
student_id BIGINT(20) NOT NULL COMMENT '学生ID',
student_no VARCHAR(50) NOT NULL COMMENT '学号',
student_name VARCHAR(100) NOT NULL COMMENT '学生姓名',
total_deduction DECIMAL(5,2) DEFAULT 0.00 COMMENT '总扣分',
warning_count INT DEFAULT 0 COMMENT '警告次数',
serious_warning_count INT DEFAULT 0 COMMENT '严重警告次数',
demerit_count INT DEFAULT 0 COMMENT '记过次数',
probation_count INT DEFAULT 0 COMMENT '留校察看次数',
expulsion_count INT DEFAULT 0 COMMENT '开除学籍次数',
calculation_rules TEXT COMMENT '计算规则JSON',
last_update_time DATETIME COMMENT '最后更新时间',
create_by BIGINT(20) COMMENT '创建者',
create_time DATETIME COMMENT '创建时间',
update_by BIGINT(20) COMMENT '更新者',
update_time DATETIME COMMENT '更新时间',
deleted TINYINT(1) DEFAULT 0 COMMENT '删除标志',
tenant_id BIGINT(20) COMMENT '租户ID',
PRIMARY KEY (id),
INDEX idx_plan_student (plan_id, student_id),
INDEX idx_student_no (student_no)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='违纪扣分计算表';
```
#### 3.3 自动扣分计算规则
**扣分计算逻辑**：
```javascript
// 违纪扣分计算规则
const disciplineScoreRules = {
// 累积扣分规则
accumulativeRules: {
warning: { min: 3, max: 5, factor: 1.0 },
seriousWarning: { min: 6, max: 8, factor: 1.0 },
demerit: { min: 9, max: 12, factor: 1.0 },
probation: { min: 13, max: 20, factor: 1.0 },
expulsion: { deduction: 'all' }
},
// 重复违纪加重处罚
repeatOffenseRules: {
sameType: { factor: 1.5 }, // 同类违纪加重50%
crossType: { factor: 1.2 } // 不同类违纪加重20%
},
// 时间衰减规则
timeDecayRules: {
enabled: true,
decayPeriod: 365, // 一年后开始衰减
decayRate: 0.1 // 每年衰减10%
}
};
```
### 4. 数据库表结构完整修改
#### 4.1 处分类型表标准化
```sql
-- 更新处分类型基础数据
UPDATE xskh_punishment_type SET
type_code = 'WARNING',
type_name = '警告',
level = '1',
score_deduction_min = 3.0,
score_deduction_max = 5.0,
archive_years = 1,
description = '累计旷课6-10课时；宿舍使用违规电器（首次）；课堂辱骂教师或扰乱秩序；抄袭作业/实验报告（首次）'
WHERE type_code = 'CFLX001';
INSERT INTO xskh_punishment_type VALUES
(NULL, 'SERIOUS_WARNING', '严重警告', '较严重违纪行为的处分', '2', 6.0, 8.0, 2, '1', 15, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'DEMERIT', '记过', '严重违纪行为的处分', '3', 9.0, 12.0, 3, '1', 15, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'PROBATION', '留校察看', '特别严重违纪行为的处分', '4', 13.0, 20.0, 99, '1', 15, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'EXPULSION', '开除学籍', '极严重违纪行为的处分', '5', 100.0, 100.0, 99, '0', 0, '1', 0, admin, NOW(), admin, NOW(), 0, 1);
```
#### 4.2 违纪类型表扩展
```sql
-- 新增标准违纪类型
INSERT INTO xskh_discipline_type VALUES
-- 警告级别违纪
(NULL, 'ABSENCE_6_10', '累计旷课6-10课时', '无故不参加规定的教学活动，累计6-10课时', 0, '2', 4.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'ILLEGAL_APPLIANCE_FIRST', '宿舍使用违规电器（首次）', '在宿舍使用大功率电器等违规用电设备', 0, '2', 3.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'CLASSROOM_MISCONDUCT', '课堂辱骂教师或扰乱秩序', '在课堂上辱骂教师或严重扰乱课堂秩序', 0, '2', 5.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'PLAGIARISM_FIRST', '抄袭作业/实验报告（首次）', '抄袭他人作业或实验报告，首次发现', 0, '2', 4.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
-- 严重警告级别违纪
(NULL, 'EXAM_CHEAT_ATTEMPT', '考试作弊（未遂）', '考试过程中企图作弊但未得逞', 0, '3', 7.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'FORGE_DOCUMENT', '伪造请假条/证明文件', '伪造各类请假条或证明文件', 0, '3', 6.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'SPREAD_FALSE_INFO', '网络传播不实信息', '在网络上传播不实信息，未造成重大影响', 0, '3', 8.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1),
(NULL, 'FIGHT_NO_INJURY', '打架斗殴（未致伤）', '参与打架斗殴但未造成人员受伤', 0, '3', 7.0, '1', 0, admin, NOW(), admin, NOW(), 0, 1);
```
### 5. 新增API接口设计
#### 5.1 考核计划配置接口
```javascript
// 获取考核计划配置模板
GET /xskh/assessmentPlan/config-template
Response: {
"defaultConfig": {
"baseScore": 100,
"passScore": 60,
"excellentScore": 85,
"autoDeductEnabled": "1",
"bonusEnabled": "1",
"disciplineWeight": 1.0,
"bonusWeight": 1.0
},
"configOptions": {
"baseScoreRange": [80, 120],
"passScoreRange": [50, 70],
"excellentScoreRange": [80, 95]
}
}
// 应用配置到考核计划
POST /xskh/assessmentPlan/apply-config/{planId}
Request: {
"config": {
"baseScore": 100,
"passScore": 60,
"autoDeductEnabled": "1"
}
}
```
#### 5.2 违纪扣分计算接口
```javascript
// 计算学生违纪扣分
POST /xskh/disciplineScore/calculate
Request: {
"planId": 1001,
"studentIds": [1001, 1002],
"includeHistory": true,
"applyTimeDecay": true
}
// 获取违纪扣分明细
GET /xskh/disciplineScore/detail/{planId}/{studentId}
Response: {
"studentInfo": {...},
"totalDeduction": 15.5,
"disciplineRecords": [...],
"calculationRules": {...},
"lastUpdateTime": "2025-01-27 10:00:00"
}
```
#### 5.3 指标体系配置接口
```javascript
// 获取指标体系模板
GET /xskh/indicator/system-template
Response: {
"systems": {
"fiveEducation": {...}, // 德智体美劳五育体系
"traditional": {...}, // 传统三好学生体系
"custom": {...} // 自定义体系
}
}
// 应用指标体系到方案
POST /xskh/scheme/apply-indicator-system
Request: {
"schemeId": 1001,
"systemType": "fiveEducation",
"customWeights": {
"moral": 20,
"intellectual": 40,
"physical": 15,
"aesthetic": 10,
"labor": 15
}
}
```
### 6. 前端界面优化方案
#### 6.1 考核计划配置界面
**新增配置步骤**：
1. **基础配置**：计划基本信息
2. **评分标准**：基础分、及格线、优秀线
3. **扣分规则**：违纪扣分开关、权重配置
4. **加分规则**：加分项开关、权重配置
5. **指标体系**：选择并配置指标权重
6. **预览确认**：配置预览和确认
#### 6.2 违纪处分快速录入
**优化录入流程**：
```vue
<template>
<el-form>
<!-- 学生信息快速搜索 -->
<el-form-item label="学生">
<student-selector v-model="form.studentId" />
</el-form-item>
<!-- 违纪类型级联选择 -->
<el-form-item label="违纪类型">
<el-cascader
v-model="form.disciplineType"
:options="disciplineTypeOptions"
:props="{ value: 'id', label: 'name', children: 'children' }"
@change="onDisciplineTypeChange"
/>
</el-form-item>
<!-- 自动匹配处分类型 -->
<el-form-item label="处分类型">
<el-select v-model="form.punishmentType" disabled>
<el-option :label="autoMatchedPunishment.name" :value="autoMatchedPunishment.id" />
</el-select>
</el-form-item>
<!-- 扣分预览 -->
<el-form-item label="扣分范围">
<el-tag type="warning">{{ scoreDeductionRange }}</el-tag>
</el-form-item>
</el-form>
</template>
```
### 7. 实施计划
#### 7.1 第一阶段：数据库和基础接口（1-2天）
- ✅ 修改数据库表结构
- ✅ 更新处分类型和违纪类型基础数据
- ✅ 实现违纪扣分计算接口
- ✅ 实现考核计划配置接口
#### 7.2 第二阶段：前端界面优化（2-3天）
- ✅ 重构考核计划配置界面
- ✅ 优化违纪记录录入界面
- ✅ 实现指标体系配置界面
- ✅ 添加扣分计算和预览功能
#### 7.3 第三阶段：测试和优化（1天）
- ✅ 完整功能测试
- ✅ 性能优化
- ✅ 文档更新
### 8. 风险评估
#### 8.1 数据迁移风险
- **风险**：现有数据可能与新标准不兼容
- **应对**：提供数据迁移脚本和备份方案
#### 8.2 计算规则复杂性
- **风险**：违纪扣分计算规则过于复杂
- **应对**：提供可视化配置界面和预览功能
#### 8.3 用户接受度
- **风险**：新的操作流程可能需要培训
- **应对**：提供详细操作手册和培训支持
## 📞 总结
本修改方案基于标准化的违纪处分等级，重新设计了考核计划管理和指标体系管理，主要改进包括：
1. **标准化处分体系**：明确的5级处分标准和对应扣分规则
2. **灵活的配置选项**：支持下拉选择和自定义配置
3. **自动化计算**：智能的违纪扣分计算和累积规则
4. **优化的用户界面**：简化操作流程，提升用户体验
5. **完善的数据管理**：支持历史数据迁移和规则调整
修改完成后，系统将更加符合学校的实际管理需求，提供更加精确和公平的学生考核评价体系。
---
**📝 文档状态**: 修改方案已完成，等待实施确认
**预计完成时间**: 4-6个工作日
**技术支持**: 系统开发组
docs/开发文档/API/学生考核管理系统数据库修改影响分析.md
-427
View File
@@ -1,427 +0,0 @@
# 学生考核管理系统数据库修改影响分析报告
## 📋 概述信息
| 项目 | 信息 |
|------|------|
| **分析时间** | 2025-01-27 |
| **升级脚本** | `backend/sql/xskh_discipline_system_upgrade.sql` |
| **影响范围** | 数据库表结构、菜单权限、前端界面 |
| **风险等级** | 🟡 中等风险（需要数据备份） |
---
## 🗄️ 数据库表结构修改详情
### 1. **现有表字段新增**
#### 1.1 `xskh_assessment_plan` 考核计划表
**新增字段**：
```sql
ALTER TABLE xskh_assessment_plan ADD COLUMN base_score DECIMAL(5,2) DEFAULT 100.00 COMMENT '基础分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN pass_score DECIMAL(5,2) DEFAULT 60.00 COMMENT '及格分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN excellent_score DECIMAL(5,2) DEFAULT 85.00 COMMENT '优秀分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN auto_deduct_enabled CHAR(1) DEFAULT '1' COMMENT '是否启用自动扣分(0否1是)';
ALTER TABLE xskh_assessment_plan ADD COLUMN bonus_enabled CHAR(1) DEFAULT '1' COMMENT '是否启用加分项(0否1是)';
ALTER TABLE xskh_assessment_plan ADD COLUMN discipline_weight DECIMAL(3,2) DEFAULT 1.00 COMMENT '违纪扣分权重';
ALTER TABLE xskh_assessment_plan ADD COLUMN bonus_weight DECIMAL(3,2) DEFAULT 1.00 COMMENT '加分项权重';
```
**影响分析**：
- ✅ **兼容性**：新增字段有默认值，不影响现有数据
- ⚠️ **实体类需要更新**：`XskhAssessmentPlan.java` 需要添加对应属性
- ⚠️ **前端界面需要更新**：考核计划管理界面需要添加配置选项
#### 1.2 `xskh_punishment_type` 处分类型表
**新增字段**：
```sql
ALTER TABLE xskh_punishment_type ADD COLUMN score_deduction_min DECIMAL(5,2) DEFAULT 0.00 COMMENT '最小扣分';
ALTER TABLE xskh_punishment_type ADD COLUMN score_deduction_max DECIMAL(5,2) DEFAULT 0.00 COMMENT '最大扣分';
ALTER TABLE xskh_punishment_type ADD COLUMN archive_years INT DEFAULT 1 COMMENT '记入档案年限';
ALTER TABLE xskh_punishment_type ADD COLUMN auto_match_enabled CHAR(1) DEFAULT '1' COMMENT '是否启用自动匹配(0否1是)';
```
**影响分析**：
- ✅ **兼容性**：新增字段有默认值，不影响现有数据
- ⚠️ **实体类需要更新**：`XskhPunishmentType.java` 需要添加对应属性
- ⚠️ **前端界面需要更新**：处分类型管理界面需要添加扣分配置
### 2. **新建数据表**
#### 2.1 `xskh_discipline_score_calculation` 违纪扣分计算表
**用途**：存储每个学生在每个考核计划中的违纪扣分汇总
**主要字段**：
- 计划ID、学生ID、总扣分
- 各级处分次数统计
- 计算规则JSON配置
#### 2.2 `xskh_discipline_score_rule` 违纪计分规则表
**用途**：存储违纪扣分的计算规则配置
**主要字段**：
- 规则类型（累积、重复、时间衰减）
- 处分等级、扣分范围、权重系数
### 3. **数据重置和标准化**
#### 3.1 处分类型数据标准化
**操作**：
```sql
DELETE FROM xskh_punishment_type WHERE deleted = 0;
INSERT INTO xskh_punishment_type ... -- 插入5级标准处分类型
```
**影响分析**：
- 🔴 **数据丢失风险**：现有处分类型数据将被清空
- ✅ **标准化收益**：统一的5级处分标准
- ⚠️ **需要数据迁移**：现有处分记录需要重新关联
#### 3.2 违纪类型数据标准化
**操作**：
```sql
DELETE FROM xskh_discipline_type WHERE deleted = 0;
INSERT INTO xskh_discipline_type ... -- 插入标准违纪类型
```
**影响分析**：
- 🔴 **数据丢失风险**：现有违纪类型数据将被清空
- ✅ **标准化收益**：明确的违纪情形分类
- ⚠️ **需要数据迁移**：现有违纪记录需要重新关联
#### 3.3 指标体系数据重构
**操作**：
```sql
DELETE FROM xskh_assessment_indicator WHERE deleted = 0;
INSERT INTO xskh_assessment_indicator ... -- 插入德智体美劳指标
```
**影响分析**：
- 🔴 **数据丢失风险**：现有指标体系数据将被清空
- ✅ **体系升级**：德智体美劳五育并举
- ⚠️ **方案重配**：现有考核方案需要重新配置指标
---
## 🗺️ 菜单权限影响分析
### 1. **现有菜单结构**
根据权限配置完成报告，当前学生考核管理菜单结构：
```
📁 学生考核管理 (ID: 9000)
├── 📄 考核计划管理 (ID: 9800) - assessmentPlan
├── 📄 考核方案管理 (ID: 9820) - scheme
├── 📄 指标体系管理 (ID: 9840) - indicator
├── 📄 测评明细管理 (ID: 9860) - assessmentDetail
├── 📄 附加分申请 (ID: 9880) - bonusApplication
├── 📄 违纪类型管理 (ID: 9900) - disciplineType
├── 📄 处分类型管理 (ID: 9920) - punishmentType
└── 📄 方案指标关联 (ID: 9940) - schemeIndicator
```
### 2. **菜单功能修改内容**
#### 2.1 **考核计划管理** (assessmentPlan)
**新增功能**：
- ✅ 基础分数配置（下拉选择：80-120分）
- ✅ 及格分数配置（下拉选择：50-70分）
- ✅ 优秀分数配置（下拉选择：80-95分）
- ✅ 扣分权重配置（下拉选择：0.5-1.5倍）
- ✅ 自动扣分开关（启用/停用）
- ✅ 加分项开关（启用/停用）
**界面变化**：
- 新增"评分标准配置"Tab页
- 新增"规则配置"Tab页
- 新增配置预览和应用功能
#### 2.2 **处分类型管理** (punishmentType)
**新增功能**：
- ✅ 扣分范围配置（最小值-最大值）
- ✅ 记档年限配置（1年/2年/3年/至毕业）
- ✅ 自动匹配开关
- ✅ 处分等级标准化（5级体系）
**界面变化**：
- 新增"扣分配置"列
- 新增"记档年限"列
- 处分等级下拉选择标准化
#### 2.3 **违纪类型管理** (disciplineType)
**新增功能**：
- ✅ 标准化违纪情形（16种标准情形）
- ✅ 自动匹配处分类型
- ✅ 扣分预览功能
**界面变化**：
- 违纪类型数据标准化
- 新增"推荐处分"列
- 新增"扣分预览"功能
#### 2.4 **指标体系管理** (indicator)
**新增功能**：
- ✅ 德智体美劳五育指标体系
- ✅ 指标权重可视化配置
- ✅ 权重总和验证（必须100%）
**界面变化**：
- 指标分类重新组织（5大类）
- 新增权重滑块配置
- 新增权重预览和验证
### 3. **需要新增的菜单**
#### 3.1 **违纪扣分计算** (disciplineScore) - 新增
**菜单ID建议**：9960-9969
**功能**：
- 学生违纪扣分汇总查询
- 扣分明细查看
- 扣分重新计算
- 扣分规则配置
#### 3.2 **配置管理** (config) - 新增
**菜单ID建议**：9970-9979
**功能**：
- 系统配置模板管理
- 批量配置应用
- 配置历史查看
- 配置导入导出
---
## 💻 前端代码修改影响
### 1. **实体类修改**
#### 1.1 `XskhAssessmentPlan.java`
**需要新增属性**：
```java
// 新增评分标准配置
private BigDecimal baseScore; // 基础分数
private BigDecimal passScore; // 及格分数
private BigDecimal excellentScore; // 优秀分数
private String autoDeductEnabled; // 是否启用自动扣分
private String bonusEnabled; // 是否启用加分项
private BigDecimal disciplineWeight; // 违纪扣分权重
private BigDecimal bonusWeight; // 加分项权重
```
#### 1.2 `XskhPunishmentType.java`
**需要新增属性**：
```java
// 新增扣分配置
private BigDecimal scoreDeductionMin; // 最小扣分
private BigDecimal scoreDeductionMax; // 最大扣分
private Integer archiveYears; // 记入档案年限
private String autoMatchEnabled; // 是否启用自动匹配
```
### 2. **新增实体类**
#### 2.1 `XskhDisciplineScoreCalculation.java`
```java
// 违纪扣分计算实体类
public class XskhDisciplineScoreCalculation extends TenantEntity {
private Long planId; // 考核计划ID
private Long studentId; // 学生ID
private BigDecimal totalDeduction; // 总扣分
private Integer warningCount; // 警告次数
// ... 其他字段
}
```
#### 2.2 `XskhDisciplineScoreRule.java`
```java
// 违纪计分规则实体类
public class XskhDisciplineScoreRule extends TenantEntity {
private String ruleName; // 规则名称
private String ruleCode; // 规则编码
private String ruleType; // 规则类型
// ... 其他字段
}
```
### 3. **前端界面修改**
#### 3.1 考核计划管理界面
**文件路径**：`web/src/views/xskh/assessmentPlan/index.vue`
**修改内容**：
- 新增配置Tab页
- 新增下拉选择组件
- 新增配置预览组件
- 新增批量配置功能
#### 3.2 处分类型管理界面
**文件路径**：`web/src/views/xskh/punishmentType/index.vue`
**修改内容**：
- 新增扣分配置列
- 新增记档年限选择
- 修改表单验证规则
---
## 📊 数据迁移方案
### 1. **现有数据备份**
**执行前必须备份的表**：
```sql
-- 备份现有数据
CREATE TABLE xskh_punishment_type_backup AS SELECT * FROM xskh_punishment_type;
CREATE TABLE xskh_discipline_type_backup AS SELECT * FROM xskh_discipline_type;
CREATE TABLE xskh_assessment_indicator_backup AS SELECT * FROM xskh_assessment_indicator;
```
### 2. **数据迁移映射**
#### 2.1 处分类型迁移
**旧数据 → 新标准映射**：
```sql
-- 示例迁移脚本
UPDATE xskh_discipline_record dr
SET punishment_type_id = (
CASE
WHEN old_punishment_name LIKE '%警告%' THEN (SELECT id FROM xskh_punishment_type WHERE type_code = 'WARNING')
WHEN old_punishment_name LIKE '%记过%' THEN (SELECT id FROM xskh_punishment_type WHERE type_code = 'DEMERIT')
-- ... 其他映射规则
END
);
```
#### 2.2 指标体系迁移
**方案重配指引**：
1. 备份现有方案配置
2. 按德智体美劳体系重新配置
3. 验证权重总和为100%
### 3. **数据一致性检查**
**执行后必须检查**：
```sql
-- 检查处分记录关联
SELECT COUNT(*) FROM xskh_discipline_record WHERE punishment_type_id NOT IN (SELECT id FROM xskh_punishment_type);
-- 检查方案指标关联
SELECT COUNT(*) FROM xskh_scheme_indicator WHERE indicator_id NOT IN (SELECT id FROM xskh_assessment_indicator);
-- 检查权重总和
SELECT scheme_id, SUM(weight) as total_weight FROM xskh_scheme_indicator GROUP BY scheme_id HAVING total_weight != 100;
```
---
## ⚠️ 风险评估和应对措施
### 1. **高风险项**
#### 1.1 数据丢失风险 🔴
**风险**：处分类型、违纪类型、指标体系数据被清空
**应对措施**：
- ✅ 执行前完整备份数据库
- ✅ 准备数据回滚脚本
- ✅ 在测试环境先验证
#### 1.2 业务中断风险 🟡
**风险**：升级期间系统功能不可用
**应对措施**：
- ✅ 选择业务低峰期执行
- ✅ 提前通知用户维护时间
- ✅ 准备快速回滚方案
### 2. **中等风险项**
#### 2.1 前端兼容性风险 🟡
**风险**：新增字段导致前端报错
**应对措施**：
- ✅ 同步更新实体类和VO类
- ✅ 更新前端表单验证
- ✅ 测试所有相关界面
#### 2.2 权限配置风险 🟡
**风险**：菜单权限不匹配导致无法访问
**应对措施**：
- ✅ 验证菜单ID不冲突
- ✅ 为管理员分配新权限
- ✅ 测试权限控制功能
### 3. **低风险项**
#### 3.1 性能影响 🟢
**风险**：新增表和字段影响查询性能
**应对措施**：
- ✅ 为新增字段创建索引
- ✅ 优化查询SQL
- ✅ 监控系统性能
---
## 🚀 实施建议
### 1. **分阶段实施**
#### 第一阶段：数据库升级（1小时）
1. ✅ 备份现有数据
2. ✅ 执行表结构修改
3. ✅ 执行数据标准化
4. ✅ 验证数据一致性
#### 第二阶段：后端代码更新（2小时）
1. ✅ 更新实体类
2. ✅ 新增服务接口
3. ✅ 更新权限配置
4. ✅ 测试API功能
#### 第三阶段：前端界面更新（3小时）
1. ✅ 更新管理界面
2. ✅ 新增配置功能
3. ✅ 测试用户体验
4. ✅ 验收功能完整性
### 2. **验收标准**
#### 功能验收 ✅
- 考核计划可通过下拉框配置评分标准
- 处分类型支持扣分范围配置
- 违纪类型自动匹配处分等级
- 指标体系支持权重可视化配置
#### 数据验收 ✅
- 现有业务数据完整迁移
- 新标准数据正确初始化
- 关联关系保持一致性
- 权限配置正确生效
#### 性能验收 ✅
- 查询响应时间无明显增加
- 配置操作流畅无卡顿
- 批量操作性能可接受
---
## 📞 总结
### ✅ **修改收益**
1. **标准化管理**：5级处分标准，16种违纪情形，德智体美劳指标体系
2. **配置化操作**：考核计划通过下拉框配置，无需代码修改
3. **自动化计算**：违纪扣分自动计算，支持复杂规则
4. **用户体验提升**：直观的配置界面，操作简单高效
### ⚠️ **主要风险**
1. **数据迁移复杂**：需要仔细处理现有数据的标准化迁移
2. **业务中断**：升级期间需要暂停相关功能使用
3. **学习成本**：用户需要适应新的配置方式和标准
### 🎯 **实施建议**
1. **充分测试**：在测试环境完整验证升级流程
2. **数据备份**：执行前做好完整的数据备份
3. **分步实施**：按阶段逐步实施，确保每个阶段稳定
4. **用户培训**：提供操作手册和培训支持
**总体评估**：升级方案技术可行，收益明显，建议在充分准备后实施。
---
**📝 文档状态**: 影响分析已完成
**风险等级**: 🟡 中等风险（可控）
**建议执行时间**: 业务低峰期（如周末）
**预计执行时长**: 6-8小时（含测试验证）
docs/开发文档/API/学生考核计划管理API.md
-454
View File
@@ -1,454 +0,0 @@
# 学生考核计划管理API文档
## 文档信息
- **文档版本**: V1.0.0
- **创建时间**: 2025-01-27
- **更新时间**: 2025-01-27
- **模块**: 学生考核管理 - 考核计划管理
- **负责人**: 系统开发组
## 概述
学生考核计划管理模块提供考核计划的全生命周期管理功能，包括计划创建、发布、执行、监控、归档等核心业务流程。
## API接口列表
### 1. 基础CRUD接口
#### 1.1 查询考核计划列表
**接口地址**: `GET /xskh/assessmentPlan/list`
**权限要求**: `xskh:assessmentPlan:list`
**接口描述**: 分页查询考核计划列表，支持多条件筛选
**请求参数**:
```json
{
"pageNum": 1,
"pageSize": 10,
"planCode": "PLAN202501",
"planName": "2025年春季学期综合测评",
"schemeId": 1001,
"schemeName": "本科生综合测评方案",
"planCycle": "2024-2025学年第二学期",
"status": "2",
"isPublished": "1",
"managerId": 1001,
"managerName": "张老师"
}
```
**响应示例**:
```json
{
"code": 200,
"msg": "查询成功",
"rows": [
{
"id": 1001,
"planCode": "PLAN202501001",
"planName": "2025年春季学期综合测评计划",
"planDesc": "面向全校本科生的综合测评计划",
"schemeId": 1001,
"schemeName": "本科生综合测评方案V2.0",
"planCycle": "2024-2025学年第二学期",
"startDate": "2025-02-01",
"endDate": "2025-06-30",
"selfEvalStartTime": "2025-02-01 08:00:00",
"selfEvalEndTime": "2025-02-28 23:59:59",
"teacherEvalStartTime": "2025-03-01 08:00:00",
"teacherEvalEndTime": "2025-03-31 23:59:59",
"totalStudents": 1500,
"completedStudents": 1200,
"approvedStudents": 1000,
"avgScore": 85.6,
"maxScore": 98.5,
"minScore": 65.2,
"status": "2",
"isPublished": "1",
"managerId": 1001,
"managerName": "张老师",
"manageDeptName": "学生工作处",
"createTime": "2025-01-15 10:00:00"
}
],
"total": 1
}
```
#### 1.2 获取考核计划详情
**接口地址**: `GET /xskh/assessmentPlan/{id}`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 根据ID获取考核计划详细信息
**请求参数**:
- `id` (Long): 考核计划ID
**响应示例**:
```json
{
"code": 200,
"msg": "操作成功",
"data": {
"id": 1001,
"planCode": "PLAN202501001",
"planName": "2025年春季学期综合测评计划",
"planDesc": "面向全校本科生的综合测评计划，包含德智体美劳五个维度的综合评价",
"schemeId": 1001,
"schemeName": "本科生综合测评方案V2.0",
"planCycle": "2024-2025学年第二学期",
"startDate": "2025-02-01",
"endDate": "2025-06-30",
"targetGrades": "[\"2021级\", \"2022级\", \"2023级\", \"2024级\"]",
"targetMajors": "[\"计算机科学与技术\", \"软件工程\", \"网络工程\"]",
"targetColleges": "[\"计算机学院\", \"信息学院\"]",
"studentTypes": "[\"undergraduate\"]",
"allowSelfEval": "1",
"allowTeacherEval": "1",
"showRanking": "1",
"showScore": "1",
"implementationGuide": "详细的实施指南内容...",
"createTime": "2025-01-15 10:00:00",
"updateTime": "2025-01-20 15:30:00"
}
}
```
#### 1.3 新增考核计划
**接口地址**: `POST /xskh/assessmentPlan`
**权限要求**: `xskh:assessmentPlan:add`
**接口描述**: 创建新的考核计划
**请求参数**:
```json
{
"planCode": "PLAN202501002",
"planName": "2025年春季学期研究生综合测评",
"planDesc": "面向全校研究生的综合测评计划",
"schemeId": 1002,
"planCycle": "2024-2025学年第二学期",
"startDate": "2025-02-15",
"endDate": "2025-07-15",
"selfEvalStartTime": "2025-02-15 08:00:00",
"selfEvalEndTime": "2025-03-15 23:59:59",
"teacherEvalStartTime": "2025-03-16 08:00:00",
"teacherEvalEndTime": "2025-04-15 23:59:59",
"targetGrades": "[\"2022级\", \"2023级\", \"2024级\"]",
"targetMajors": "[\"计算机技术\", \"软件工程\"]",
"targetColleges": "[\"计算机学院\"]",
"studentTypes": "[\"graduate\"]",
"allowSelfEval": "1",
"allowTeacherEval": "1",
"showRanking": "1",
"showScore": "1",
"managerId": 1001,
"managerName": "李老师",
"manageDept": 2001,
"manageDeptName": "研究生院"
}
```
#### 1.4 修改考核计划
**接口地址**: `PUT /xskh/assessmentPlan`
**权限要求**: `xskh:assessmentPlan:edit`
**接口描述**: 修改考核计划信息
#### 1.5 删除考核计划
**接口地址**: `DELETE /xskh/assessmentPlan/{ids}`
**权限要求**: `xskh:assessmentPlan:remove`
**接口描述**: 批量删除考核计划（仅限未发布或未开始的计划）
### 2. 业务功能接口
#### 2.1 根据方案ID查询计划列表
**接口地址**: `GET /xskh/assessmentPlan/scheme/{schemeId}`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 查询指定方案关联的所有计划
**响应示例**:
```json
{
"code": 200,
"msg": "操作成功",
"data": [
{
"id": 1001,
"planCode": "PLAN202501001",
"planName": "2025年春季学期综合测评计划",
"status": "2",
"isPublished": "1",
"startDate": "2025-02-01",
"endDate": "2025-06-30"
}
]
}
```
#### 2.2 根据计划编号查询计划
**接口地址**: `GET /xskh/assessmentPlan/code/{planCode}`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 根据计划编号查询计划信息
#### 2.3 查询进行中的计划
**接口地址**: `GET /xskh/assessmentPlan/active`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 查询当前进行中的计划列表
#### 2.4 查询即将开始的计划
**接口地址**: `GET /xskh/assessmentPlan/upcoming`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 查询7天内即将开始的计划列表
#### 2.5 查询即将结束的计划
**接口地址**: `GET /xskh/assessmentPlan/ending`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 查询7天内即将结束的计划列表
### 3. 计划状态管理接口
#### 3.1 发布计划
**接口地址**: `PUT /xskh/assessmentPlan/publish/{id}`
**权限要求**: `xskh:assessmentPlan:publish`
**接口描述**: 发布考核计划，发布后学生可以看到并参与测评
**请求参数**:
- `id` (Long): 计划ID
**响应示例**:
```json
{
"code": 200,
"msg": "计划发布成功"
}
```
#### 3.2 撤销发布
**接口地址**: `PUT /xskh/assessmentPlan/unpublish/{id}`
**权限要求**: `xskh:assessmentPlan:unpublish`
**接口描述**: 撤销计划发布（仅限未开始的计划）
#### 3.3 开始计划
**接口地址**: `PUT /xskh/assessmentPlan/start/{id}`
**权限要求**: `xskh:assessmentPlan:start`
**接口描述**: 启动考核计划，开始执行测评流程
#### 3.4 结束计划
**接口地址**: `PUT /xskh/assessmentPlan/end/{id}`
**权限要求**: `xskh:assessmentPlan:end`
**接口描述**: 结束考核计划，停止测评活动
#### 3.5 取消计划
**接口地址**: `PUT /xskh/assessmentPlan/cancel/{id}?reason={reason}`
**权限要求**: `xskh:assessmentPlan:cancel`
**接口描述**: 取消考核计划并记录取消原因
**请求参数**:
- `id` (Long): 计划ID
- `reason` (String): 取消原因
#### 3.6 归档计划
**接口地址**: `PUT /xskh/assessmentPlan/archive/{id}`
**权限要求**: `xskh:assessmentPlan:archive`
**接口描述**: 归档已结束的计划
### 4. 辅助功能接口
#### 4.1 复制计划
**接口地址**: `POST /xskh/assessmentPlan/copy/{id}?planCode={planCode}&planName={planName}`
**权限要求**: `xskh:assessmentPlan:add`
**接口描述**: 复制现有计划创建新计划
**请求参数**:
- `id` (Long): 源计划ID
- `planCode` (String): 新计划编号
- `planName` (String): 新计划名称
#### 4.2 生成计划编号
**接口地址**: `GET /xskh/assessmentPlan/generateCode`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 自动生成下一个可用的计划编号
**响应示例**:
```json
{
"code": 200,
"msg": "操作成功",
"data": "PLAN202501003"
}
```
#### 4.3 更新统计信息
**接口地址**: `PUT /xskh/assessmentPlan/statistics/{planId}`
**权限要求**: `xskh:assessmentPlan:statistics`
**接口描述**: 刷新计划的统计数据（参与人数、完成人数、平均分等）
#### 4.4 批量更新状态
**接口地址**: `PUT /xskh/assessmentPlan/batchStatus?status={status}`
**权限要求**: `xskh:assessmentPlan:edit`
**接口描述**: 批量更新多个计划的状态
**请求参数**:
```json
{
"planIds": [1001, 1002, 1003],
"status": "3"
}
```
#### 4.5 获取选项数据
**接口地址**: `GET /xskh/assessmentPlan/options`
**权限要求**: `xskh:assessmentPlan:query`
**接口描述**: 获取下拉选择框所需的选项数据
**响应示例**:
```json
{
"code": 200,
"msg": "操作成功",
"data": {
"statusOptions": {
"1": "未开始",
"2": "进行中",
"3": "已结束",
"4": "已归档",
"5": "已取消"
},
"publishOptions": {
"0": "未发布",
"1": "已发布"
},
"studentTypeOptions": {
"undergraduate": "本科生",
"graduate": "研究生",
"exchange": "交换生"
}
}
}
```
### 5. 数据导入导出接口
#### 5.1 导出计划数据
**接口地址**: `POST /xskh/assessmentPlan/export`
**权限要求**: `xskh:assessmentPlan:export`
**接口描述**: 根据查询条件导出计划数据到Excel
#### 5.2 下载导入模板
**接口地址**: `POST /xskh/assessmentPlan/importTemplate`
**权限要求**: `xskh:assessmentPlan:import`
**接口描述**: 下载计划数据导入模板
#### 5.3 导入计划数据
**接口地址**: `POST /xskh/assessmentPlan/importData`
**权限要求**: `xskh:assessmentPlan:import`
**接口描述**: 从Excel文件导入计划数据
**请求参数**:
- `file` (MultipartFile): Excel文件
- `updateSupport` (boolean): 是否支持更新已存在的数据
## 状态流转说明
### 计划状态流转图
```
未开始(1) → 进行中(2) → 已结束(3) → 已归档(4)
↓ ↓ ↓
已取消(5) ← 已取消(5) ← 已取消(5)
```
### 状态说明
- **未开始(1)**: 计划已创建但未开始执行
- **进行中(2)**: 计划正在执行，学生可以参与测评
- **已结束(3)**: 计划执行完毕，不再接受新的测评
- **已归档(4)**: 计划数据已归档，仅供查询
- **已取消(5)**: 计划已取消，不再执行
### 发布状态说明
- **未发布(0)**: 计划未发布，学生不可见
- **已发布(1)**: 计划已发布，学生可见并可参与
## 权限配置说明
### 菜单权限
```sql
-- 考核计划管理菜单
INSERT INTO sys_menu VALUES(2050, '考核计划管理', 2000, 5, 'assessmentPlan', 'xskh/assessmentPlan/index', '', 1, 0, 'C', '0', '0', 'xskh:assessmentPlan:list', 'plan', 'admin', NOW(), '', NULL, '考核计划管理菜单');
```
### 按钮权限
```sql
-- 考核计划按钮权限
INSERT INTO sys_menu VALUES(2051, '考核计划查询', 2050, 1, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:query', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2052, '考核计划新增', 2050, 2, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:add', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2053, '考核计划修改', 2050, 3, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:edit', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2054, '考核计划删除', 2050, 4, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:remove', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2055, '考核计划导出', 2050, 5, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:export', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2056, '考核计划发布', 2050, 6, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:publish', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2057, '考核计划开始', 2050, 7, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:start', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2058, '考核计划结束', 2050, 8, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:end', '#', 'admin', NOW(), '', NULL, '');
INSERT INTO sys_menu VALUES(2059, '考核计划归档', 2050, 9, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:archive', '#', 'admin', NOW(), '', NULL, '');
```
## 错误码说明
| 错误码 | 错误信息 | 说明 |
|--------|----------|------|
| 200 | 操作成功 | 请求处理成功 |
| 400 | 参数错误 | 请求参数不正确 |
| 401 | 未授权 | 用户未登录或token无效 |
| 403 | 权限不足 | 用户无相应操作权限 |
| 500 | 系统错误 | 服务器内部错误 |
| 1001 | 计划编号已存在 | 计划编号重复 |
| 1002 | 关联方案不存在 | 指定的考核方案不存在 |
| 1003 | 计划状态不允许此操作 | 当前计划状态不支持该操作 |
| 1004 | 已发布的计划不能删除 | 已发布或进行中的计划不允许删除 |
## 使用示例
### 典型业务流程
1. **创建计划**: 调用新增接口创建考核计划
2. **配置计划**: 设置目标范围、时间安排等
3. **发布计划**: 发布计划让学生可见
4. **开始计划**: 启动计划开始测评
5. **监控进度**: 定期更新统计信息
6. **结束计划**: 测评结束后结束计划
7. **归档计划**: 将完成的计划归档保存
### 前端调用示例
```javascript
// 查询计划列表
const getAssessmentPlanList = (params) => {
return request({
url: '/xskh/assessmentPlan/list',
method: 'get',
params
})
}
// 发布计划
const publishPlan = (id) => {
return request({
url: `/xskh/assessmentPlan/publish/${id}`,
method: 'put'
})
}
// 开始计划
const startPlan = (id) => {
return request({
url: `/xskh/assessmentPlan/start/${id}`,
method: 'put'
})
}
```
## 注意事项
1. **状态控制**: 严格按照状态流转规则操作，避免非法状态转换
2. **权限校验**: 所有接口都需要相应的权限，确保数据安全
3. **数据校验**: 新增和修改时进行充分的数据校验
4. **并发控制**: 对于状态变更操作需要考虑并发安全
5. **日志记录**: 重要操作需要记录操作日志
6. **缓存策略**: 对于频繁查询的数据可以考虑缓存优化
---
**文档维护**: 本文档将随着功能更新持续维护，请关注版本变更记录。
docs/开发文档/API/指标体系管理API.md
-48
View File
@@ -1,48 +0,0 @@
# 指标体系管理API
## 功能概述
- 支持指标的新增、修改、删除、查询
- 新增：Excel 批量导入与导入模板下载
- 新增：表单增加“具体指标名称”字段（前端表单字段：scoreLabel，后端存储映射：remark），分值映射为 defaultScore
## 基础接口
- GET `/xskh/assessmentIndicator/list` 分页查询
- GET `/xskh/assessmentIndicator/{id}` 详情
- POST `/xskh/assessmentIndicator` 新增
- PUT `/xskh/assessmentIndicator` 编辑
- DELETE `/xskh/assessmentIndicator/{ids}` 删除
## 批量导入
- POST `/xskh/assessmentIndicator/importData?updateSupport={0|1}`
- Content-Type: multipart/form-data
- 表单字段：file
- 返回：导入结果消息
- POST `/xskh/assessmentIndicator/importTemplate`
- 返回：Excel 模板文件流
### Excel 模板字段（与表单一致）
- 指标编码（indicatorCode）
- 指标名称（indicatorName）
- 指标说明（indicatorDesc）
- 指标类型（indicatorType，字典：xskh_indicator_type）
- 分值（defaultScore）
- 具体指标名称（remark，前端字段 scoreLabel）
- 状态（status，字典：sys_normal_disable）
## 权限
- 列表：`xskh:assessmentIndicator:list`
- 查询：`xskh:assessmentIndicator:query`
- 新增：`xskh:assessmentIndicator:add`
- 编辑：`xskh:assessmentIndicator:edit`
- 删除：`xskh:assessmentIndicator:remove`
- 导出：`xskh:assessmentIndicator:export`
- 导入：`xskh:assessmentIndicator:import`
## 统一响应
- 分页：`TableDataInfo`
- 通用：`R<T>`
## 前端实现要点
- 新增表单项：`scoreLabel`（具体指标名称）
- 提交时将 `scoreLabel -> remark`，`scoreValue -> defaultScore`
- 批量导入对话框：上传 `.xls/.xlsx`，支持模板下载
docs/开发文档/API/违纪处分记录管理API.md
-371
View File
@@ -1,371 +0,0 @@
# 违纪处分记录管理API文档
## 📋 文档信息
| 项目 | 信息 |
|------|------|
| **模块名称** | 学生考核管理系统 - 违纪处分记录管理 |
| **API版本** | V1.0.0 |
| **创建时间** | 2025-01-26 |
| **技术架构** | Spring Boot 3.4.6 + MyBatis-Plus + Vue 3 |
| **开发状态** | ✅ 前后端全部完成，系统可用 |
## 🎯 功能概述
违纪处分记录管理模块是学生考核管理系统的核心功能之一，提供完整的学生违纪处分记录管理功能，包括记录的增删改查、审核流程、统计分析等。
### 核心特性
- ✅ **完整CRUD操作** - 支持违纪处分记录的全生命周期管理
- ✅ **审核流程** - 支持多级审核和审批流程
- ✅ **统计分析** - 提供多维度的数据统计和分析
- ✅ **数据导入导出** - 支持Excel格式的批量数据处理
- ✅ **权限控制** - 细粒度的权限管理和数据隔离
- ✅ **自动化处理** - 支持到期处分的自动处理
## 🗄️ 数据模型
### 核心实体
#### 违纪处分记录 (XskhDisciplineRecord)
```java
public class XskhDisciplineRecord extends TenantEntity {
private Long id; // 主键ID（雪花ID）
private String recordNo; // 记录编号（自动生成：XSKH202501001）
private String caseNo; // 案件编号（可手工填写）
// 学生信息
private Long studentId; // 学生ID
private String studentNo; // 学号
private String studentName; // 学生姓名
// ... 其他学生信息字段
// 违纪信息
private Long disciplineTypeId; // 违纪类型ID
private String disciplineTypeCode; // 违纪类型编码
private String disciplineTypeName; // 违纪类型名称
private LocalDate disciplineDate; // 违纪日期
private String disciplineDesc; // 违纪详情描述
// 处分信息
private Long punishmentTypeId; // 处分类型ID
private String punishmentTypeCode; // 处分类型编码
private String punishmentTypeName; // 处分类型名称
private LocalDate punishmentDate; // 处分日期
private String punishmentDesc; // 处分决定内容
// 状态管理
private String recordStatus; // 记录状态：1-有效，2-已撤销，3-已到期，4-已转移，5-已归档
private String punishmentStatus; // 处分状态：1-执行中，2-已完成，3-已撤销，4-已到期
private String appealStatus; // 申诉状态：0-未申诉，1-申诉中，2-申诉通过，3-申诉驳回
private String approvalStatus; // 审核状态：1-待审核，2-审核中，3-已通过，4-已驳回
// ... 其他字段
}
```
## 🔌 API接口清单
### 基础管理接口（6个）
#### 1. 查询违纪处分记录列表
- **接口地址**: `GET /xskh/disciplineRecord/list`
- **权限编码**: `xskh:disciplineRecord:list`
- **功能描述**: 分页查询违纪处分记录列表，支持多条件筛选
**请求参数**:
```javascript
{
"pageNum": 1, // 页码
"pageSize": 10, // 每页大小
"studentName": "张三", // 学生姓名（模糊查询）
"studentNo": "2023001001", // 学号（模糊查询）
"recordStatus": "1", // 记录状态
"disciplineTypeName": "旷课", // 违纪类型（模糊查询）
"punishmentTypeName": "警告", // 处分类型（模糊查询）
"disciplineDateStart": "2025-01-01", // 违纪日期开始
"disciplineDateEnd": "2025-01-31", // 违纪日期结束
"collegeName": "计算机学院", // 学院名称（模糊查询）
"approvalStatus": "1" // 审核状态
}
```
**响应示例**:
```json
{
"code": 200,
"msg": "操作成功",
"rows": [
{
"id": 1,
"recordNo": "XSKH202501001",
"studentName": "张三",
"studentNo": "2023001001",
"disciplineTypeName": "旷课",
"punishmentTypeName": "警告",
"disciplineDate": "2025-01-20",
"punishmentDate": "2025-01-21",
"recordStatus": "1",
"approvalStatus": "3",
"createTime": "2025-01-26 10:30:00"
}
],
"total": 1
}
```
#### 2. 获取违纪处分记录详情
- **接口地址**: `GET /xskh/disciplineRecord/{id}`
- **权限编码**: `xskh:disciplineRecord:query`
- **功能描述**: 根据记录ID获取详细信息
#### 3. 新增违纪处分记录
- **接口地址**: `POST /xskh/disciplineRecord`
- **权限编码**: `xskh:disciplineRecord:add`
- **功能描述**: 新增违纪处分记录
**请求参数**:
```json
{
"studentId": 1,
"studentNo": "2023001001",
"studentName": "张三",
"disciplineTypeId": 1,
"disciplineTypeCode": "WJLX001",
"disciplineTypeName": "旷课",
"disciplineDate": "2025-01-20",
"disciplineDesc": "学生在上课期间无故旷课",
"punishmentTypeId": 1,
"punishmentTypeCode": "CFLX001",
"punishmentTypeName": "警告",
"punishmentDate": "2025-01-21",
"punishmentDesc": "给予该学生警告处分"
}
```
#### 4. 修改违纪处分记录
- **接口地址**: `PUT /xskh/disciplineRecord`
- **权限编码**: `xskh:disciplineRecord:edit`
- **功能描述**: 修改违纪处分记录信息
#### 5. 删除违纪处分记录
- **接口地址**: `DELETE /xskh/disciplineRecord/{ids}`
- **权限编码**: `xskh:disciplineRecord:remove`
- **功能描述**: 批量删除违纪处分记录
#### 6. 生成记录编号
- **接口地址**: `GET /xskh/disciplineRecord/generateRecordNo`
- **权限编码**: `xskh:disciplineRecord:add`
- **功能描述**: 自动生成下一个记录编号
**响应示例**:
```json
{
"code": 200,
"msg": "操作成功",
"data": "XSKH202501001"
}
```
### 业务功能接口（4个）
#### 7. 根据学生ID查询记录
- **接口地址**: `GET /xskh/disciplineRecord/student/{studentId}`
- **权限编码**: `xskh:disciplineRecord:query`
- **功能描述**: 查询指定学生的所有违纪处分记录
#### 8. 根据学号查询记录
- **接口地址**: `GET /xskh/disciplineRecord/studentNo/{studentNo}`
- **权限编码**: `xskh:disciplineRecord:query`
- **功能描述**: 根据学号查询违纪处分记录
#### 9. 查询待审核记录
- **接口地址**: `GET /xskh/disciplineRecord/pendingApproval`
- **权限编码**: `xskh:disciplineRecord:approve`
- **功能描述**: 查询当前用户待审核的违纪处分记录
#### 10. 审核违纪处分记录
- **接口地址**: `POST /xskh/disciplineRecord/approve/{id}`
- **权限编码**: `xskh:disciplineRecord:approve`
- **功能描述**: 审核违纪处分记录
**请求参数**:
```javascript
{
"approvalStatus": "3", // 审核状态：3-通过，4-驳回
"approveComment": "经审核，该违纪行为属实，处分决定合理，予以通过"
}
```
### 辅助功能接口（6个）
#### 11. 统计违纪类型分布
- **接口地址**: `GET /xskh/disciplineRecord/stats/disciplineType`
- **权限编码**: `xskh:disciplineRecord:stats`
- **功能描述**: 统计各违纪类型的分布情况
**响应示例**:
```json
{
"code": 200,
"msg": "操作成功",
"data": [
{ "name": "旷课", "value": 15 },
{ "name": "作弊", "value": 8 },
{ "name": "打架斗殴", "value": 3 }
]
}
```
#### 12. 统计处分类型分布
- **接口地址**: `GET /xskh/disciplineRecord/stats/punishmentType`
- **权限编码**: `xskh:disciplineRecord:stats`
- **功能描述**: 统计各处分类型的分布情况
#### 13. 统计学院违纪分布
- **接口地址**: `GET /xskh/disciplineRecord/stats/college`
- **权限编码**: `xskh:disciplineRecord:stats`
- **功能描述**: 统计各学院的违纪情况
#### 14. 统计月度违纪趋势
- **接口地址**: `GET /xskh/disciplineRecord/stats/monthly/{year}`
- **权限编码**: `xskh:disciplineRecord:stats`
- **功能描述**: 统计指定年份的月度违纪趋势
#### 15. 检查学生有效记录
- **接口地址**: `GET /xskh/disciplineRecord/check/{studentId}`
- **权限编码**: `xskh:disciplineRecord:check`
- **功能描述**: 检查学生是否有有效的违纪处分记录
#### 16. 查询即将到期记录
- **接口地址**: `GET /xskh/disciplineRecord/expiring/{days}`
- **权限编码**: `xskh:disciplineRecord:query`
- **功能描述**: 查询指定天数内即将到期的处分记录
## 🔐 权限控制
### 权限编码规范
- `xskh:disciplineRecord:list` - 查询列表权限
- `xskh:disciplineRecord:query` - 查询详情权限
- `xskh:disciplineRecord:add` - 新增权限
- `xskh:disciplineRecord:edit` - 修改权限
- `xskh:disciplineRecord:remove` - 删除权限
- `xskh:disciplineRecord:approve` - 审核权限
- `xskh:disciplineRecord:revoke` - 撤销权限
- `xskh:disciplineRecord:archive` - 归档权限
- `xskh:disciplineRecord:stats` - 统计权限
- `xskh:disciplineRecord:import` - 导入权限
- `xskh:disciplineRecord:export` - 导出权限
### 数据权限
- **管理员**: 可查看所有记录
- **辅导员**: 可查看所管辖学院/班级的记录
- **班主任**: 可查看所管辖班级的记录
- **学生**: 只能查看本人的记录
## 📊 数据字典
### 记录状态 (record_status)
- `1` - 有效
- `2` - 已撤销
- `3` - 已到期
- `4` - 已转移
- `5` - 已归档
### 处分状态 (punishment_status)
- `1` - 执行中
- `2` - 已完成
- `3` - 已撤销
- `4` - 已到期
### 申诉状态 (appeal_status)
- `0` - 未申诉
- `1` - 申诉中
- `2` - 申诉通过
- `3` - 申诉驳回
### 审核状态 (approval_status)
- `1` - 待审核
- `2` - 审核中
- `3` - 已通过
- `4` - 已驳回
## 🧪 测试说明
### 测试脚本
项目提供了完整的Node.js测试脚本，位于 `test/xskh-discipline-record-api-test.js`
### 运行测试
```bash
cd test
npm install
npm test
```
### 测试覆盖
- ✅ 16个API接口全覆盖
- ✅ AES+RSA双重加密登录
- ✅ 完整的CRUD操作测试
- ✅ 业务流程测试
- ✅ 统计功能测试
- ✅ 异常情况处理
## 📝 开发状态
### ✅ 已完成
- [x] 数据库表设计和创建
- [x] 实体类和VO/BO类
- [x] Mapper接口和XML映射
- [x] Service接口和实现类
- [x] Controller控制层
- [x] 权限配置和菜单配置
- [x] API测试脚本
- [x] 完整的16个API接口
- [x] 前端Vue组件开发
- [x] 前端API接口封装
- [x] 前端路由配置
- [x] 前端权限控制
- [x] 数据库表和字典数据初始化
- [x] 菜单权限数据初始化
### 🎯 系统状态
- ✅ **前后端完整系统** - 可直接部署使用
- ✅ **完整功能覆盖** - 16个API接口 + 完整前端界面
- ✅ **权限控制完善** - 8个权限点全覆盖
- ✅ **数据库完整初始化** - 表结构 + 字典数据 + 菜单权限
## 🚀 系统使用
### 快速启动
```bash
# 前端启动
cd web && npm run dev
# 后端启动
cd backend && mvn spring-boot:run
```
### 访问地址
- **前端系统**: http://localhost (默认80端口)
- **后端API**: http://localhost:8080
- **模块入口**: 登录后 → 学生考核管理 → 违纪处分记录管理
### 功能特性
1. **完整CRUD操作** - 新增、修改、删除、查询违纪处分记录
2. **多条件查询** - 支持学号、姓名、违纪类型、日期范围等组合查询
3. **审核流程** - 支持审核通过/驳回操作，含审核意见记录
4. **数据导入导出** - Excel格式批量数据处理
5. **权限控制** - 8个权限点精细化权限管理
6. **统计分析** - 预留统计分析功能接口
### 下一步计划
1. **功能验证** - 完整业务流程测试
2. **性能优化** - 大数据量场景优化
3. **用户培训** - 操作手册和使用培训
4. **生产部署** - 正式环境部署上线
---
**开发团队**: RuoYi开发团队
**创建时间**: 2025-01-26
**最后更新**: 2025-01-28 (前端开发完成)
docs/开发文档/学生考核管理前端开发计划-详细版.md
-429
View File
@@ -1,429 +0,0 @@
# 学生考核管理前端开发计划 - 详细版
**创建时间**: 2025-01-28
**版本**: V2.0.0
**状态**: 执行中
---
## 📊 当前开发状态概览
### ✅ **已完成模块 (40%)**
| 模块名称 | 后端开发 | 前端页面 | 权限配置 | API接口 | 完成度 |
|---------|----------|----------|----------|---------|--------|
| **违纪处分管理** | ✅ 100% | ✅ 100% | ✅ 100% | ✅ 100% | 🟢 100% |
| **综合测评记录** | ✅ 100% | ✅ 100% | ✅ 100% | ✅ 100% | 🟢 100% |
| **考核计划管理** | ✅ 100% | ✅ 100% | ✅ 100% | ✅ 100% | 🟢 100% |
| **考核方案管理** | ✅ 100% | ✅ 100% | 🟡 待配置 | ✅ 100% | 🟡 90% |
| **指标体系管理** | ✅ 100% | ✅ 100% | 🟡 待配置 | ✅ 100% | 🟡 90% |
### 🔄 **待开发模块 (60%)**
| 模块名称 | 后端开发 | 前端页面 | 权限配置 | API接口 | 完成度 |
|---------|----------|----------|----------|---------|--------|
| **测评明细管理** | ✅ 100% | ❌ 待开发 | 🟡 待配置 | ✅ 100% | 🟡 60% |
| **附加分申请** | ✅ 100% | ❌ 待开发 | 🟡 待配置 | ✅ 100% | 🟡 60% |
| **违纪类型管理** | ✅ 100% | ❌ 待开发 | 🟡 待配置 | ✅ 100% | 🟡 60% |
| **处分类型管理** | ✅ 100% | ❌ 待开发 | 🟡 待配置 | ✅ 100% | 🟡 60% |
| **方案指标关联** | ✅ 100% | ❌ 待开发 | 🟡 待配置 | ✅ 100% | 🟡 60% |
---
## 🎯 权限配置完成情况
### ✅ **已配置权限模块**
- **考核计划管理**: ID 9800-9819 (✅ 已完成配置)
- **其他7个模块**: ID 9820-9959 (✅ 批量权限配置已创建)
### 📋 **权限ID分配表**
| 模块名称 | ID范围 | 权限数量 | 配置状态 |
|---------|--------|----------|----------|
| 考核计划管理 | 9800-9819 | 18个 | ✅ 已配置 |
| 考核方案管理 | 9820-9839 | 10个 | 🟡 脚本已创建 |
| 指标体系管理 | 9840-9859 | 9个 | 🟡 脚本已创建 |
| 测评明细管理 | 9860-9879 | 10个 | 🟡 脚本已创建 |
| 附加分申请 | 9880-9899 | 11个 | 🟡 脚本已创建 |
| 违纪类型管理 | 9900-9919 | 9个 | 🟡 脚本已创建 |
| 处分类型管理 | 9920-9939 | 9个 | 🟡 脚本已创建 |
| 方案指标关联 | 9940-9959 | 10个 | 🟡 脚本已创建 |
### 🔧 **权限配置脚本**
1. **考核计划管理权限配置-完整版.sql** ✅ 已创建
2. **其他模块权限配置-批量创建.sql** ✅ 已创建
---
## 🚀 前端开发优先级规划
### 🔴 **第一阶段：基础配置页面 (1-2周)**
#### 任务1: 违纪类型管理页面开发 ⭐⭐⭐
**优先级**: 最高 (基础数据配置)
**预估工期**: 2天
**开发内容**:
```
📁 需创建文件:
├── web/src/views/xskh/disciplineType/
│ ├── index.vue # 违纪类型列表页面
│ └── components/
│ └── DisciplineTypeForm.vue # 新增/编辑表单组件
├── web/src/api/xskh/disciplineType.js # API接口文件
```
**核心功能**:
- ✅ 违纪类型列表查询（分页、筛选）
- ✅ 违纪类型新增/编辑表单
- ✅ 违纪类型启用/禁用状态管理
- ✅ 违纪类型导出/导入功能
#### 任务2: 处分类型管理页面开发 ⭐⭐⭐
**优先级**: 最高 (基础数据配置)
**预估工期**: 2天
**开发内容**:
```
📁 需创建文件:
├── web/src/views/xskh/punishmentType/
│ ├── index.vue # 处分类型列表页面
│ └── components/
│ └── PunishmentTypeForm.vue # 新增/编辑表单组件
├── web/src/api/xskh/punishmentType.js # API接口文件
```
#### 任务3: 权限配置脚本应用 ⭐⭐⭐
**优先级**: 高
**预估工期**: 0.5天
**执行内容**:
1. 应用考核计划管理权限配置脚本
2. 应用其他模块权限配置脚本
3. 验证权限配置是否生效
---
### 🟡 **第二阶段：核心业务页面 (3-4周)**
#### 任务4: 测评明细管理页面开发 ⭐⭐
**预估工期**: 3天
**开发内容**:
```
📁 需创建文件:
├── web/src/views/xskh/assessmentDetail/
│ ├── index.vue # 测评明细列表页面
│ ├── detail.vue # 明细详情页面
│ └── components/
│ ├── DetailForm.vue # 明细表单组件
│ ├── DetailReview.vue # 审核组件
│ └── DetailStatistics.vue # 统计组件
```
**核心功能**:
- ✅ 测评明细列表查询（多条件筛选）
- ✅ 测评明细新增/修改
- ✅ 测评明细审核/撤销
- ✅ 测评明细统计分析
- ✅ 批量操作功能
#### 任务5: 附加分申请页面开发 ⭐⭐
**预估工期**: 3天
**开发内容**:
```
📁 需创建文件:
├── web/src/views/xskh/bonusApplication/
│ ├── index.vue # 申请列表页面
│ ├── myApplications.vue # 我的申请页面
│ ├── pendingReview.vue # 待审核页面
│ └── components/
│ ├── ApplicationForm.vue # 申请表单组件
│ ├── ReviewForm.vue # 审核表单组件
│ └── ApplicationDetail.vue # 申请详情组件
```
**核心功能**:
- ✅ 附加分申请列表查询
- ✅ 新增/修改附加分申请
- ✅ 我的申请管理
- ✅ 申请审核功能
- ✅ 申请状态流转
---
### 🟢 **第三阶段：高级管理页面 (5-6周)**
#### 任务6: 方案指标关联页面开发 ⭐
**预估工期**: 4天 (复杂业务逻辑)
**开发内容**:
```
📁 需创建文件:
├── web/src/views/xskh/schemeIndicator/
│ ├── index.vue # 关联管理主页面
│ ├── batchLink.vue # 批量关联页面
│ ├── weightConfig.vue # 权重配置页面
│ └── components/
│ ├── SchemeTree.vue # 方案树组件
│ ├── IndicatorTree.vue # 指标树组件
│ ├── LinkRelation.vue # 关联关系组件
│ └── WeightSetting.vue # 权重设置组件
```
**核心功能**:
- ✅ 方案指标关联管理
- ✅ 批量关联/取消关联
- ✅ 权重配置功能
- ✅ 关联关系可视化
- ✅ 关联数据导入/导出
#### 任务7: 现有页面权限标识更新
**预估工期**: 1天
**更新内容**:
1. **考核方案管理页面** - 更新权限标识为 `xskh:scheme:*`
2. **指标体系管理页面** - 更新权限标识为 `xskh:indicator:*`
---
## 📋 具体开发任务清单
### 🎯 立即开始的任务
#### 任务A: 违纪类型管理页面开发
```vue
<!-- web/src/views/xskh/disciplineType/index.vue -->
<template>
<div class="app-container">
<!-- 查询条件 -->
<el-card shadow="hover" class="search-card">
<el-form :model="queryParams" ref="queryFormRef" :inline="true">
<el-form-item label="类型编码" prop="typeCode">
<el-input v-model="queryParams.typeCode" placeholder="请输入类型编码" clearable />
</el-form-item>
<el-form-item label="类型名称" prop="typeName">
<el-input v-model="queryParams.typeName" placeholder="请输入类型名称" clearable />
</el-form-item>
<el-form-item label="状态" prop="status">
<el-select v-model="queryParams.status" placeholder="请选择状态" clearable>
<el-option label="启用" value="0" />
<el-option label="禁用" value="1" />
</el-select>
</el-form-item>
<el-form-item>
<el-button type="primary" icon="Search" @click="handleQuery">搜索</el-button>
<el-button icon="Refresh" @click="resetQuery">重置</el-button>
</el-form-item>
</el-form>
</el-card>
<!-- 操作按钮 -->
<el-card shadow="never" class="table-card">
<template #header>
<el-row :gutter="10" class="mb8">
<el-col :span="1.5">
<el-button type="primary" plain icon="Plus" @click="handleAdd" v-hasPermi="['xskh:disciplineType:add']">新增</el-button>
</el-col>
<el-col :span="1.5">
<el-button type="success" plain icon="Edit" :disabled="single" @click="handleUpdate()" v-hasPermi="['xskh:disciplineType:edit']">修改</el-button>
</el-col>
<el-col :span="1.5">
<el-button type="danger" plain icon="Delete" :disabled="multiple" @click="handleDelete()" v-hasPermi="['xskh:disciplineType:remove']">删除</el-button>
</el-col>
<el-col :span="1.5">
<el-button type="warning" plain icon="Download" @click="handleExport" v-hasPermi="['xskh:disciplineType:export']">导出</el-button>
</el-col>
</el-row>
</template>
<!-- 数据表格 -->
<el-table v-loading="loading" :data="typeList" @selection-change="handleSelectionChange">
<el-table-column type="selection" width="55" align="center" />
<el-table-column label="类型编码" align="center" prop="typeCode" />
<el-table-column label="类型名称" align="center" prop="typeName" />
<el-table-column label="严重程度" align="center" prop="severityLevel">
<template #default="scope">
<el-tag :type="getSeverityType(scope.row.severityLevel)">
{{ getSeverityText(scope.row.severityLevel) }}
</el-tag>
</template>
</el-table-column>
<el-table-column label="状态" align="center" prop="status">
<template #default="scope">
<el-switch
v-model="scope.row.status"
active-value="0"
inactive-value="1"
@change="handleStatusChange(scope.row)"
v-hasPermi="['xskh:disciplineType:edit']"
/>
</template>
</el-table-column>
<el-table-column label="创建时间" align="center" prop="createTime" width="180" />
<el-table-column label="操作" align="center" class-name="small-padding fixed-width">
<template #default="scope">
<el-button link type="primary" icon="Edit" @click="handleUpdate(scope.row)" v-hasPermi="['xskh:disciplineType:edit']">修改</el-button>
<el-button link type="primary" icon="Delete" @click="handleDelete(scope.row)" v-hasPermi="['xskh:disciplineType:remove']">删除</el-button>
</template>
</el-table-column>
</el-table>
<!-- 分页 -->
<pagination
v-show="total > 0"
:total="total"
v-model:page="queryParams.pageNum"
v-model:limit="queryParams.pageSize"
@pagination="getList"
/>
</el-card>
<!-- 新增/修改对话框 -->
<el-dialog :title="dialog.title" v-model="dialog.visible" width="600px" append-to-body>
<el-form ref="disciplineTypeFormRef" :model="form" :rules="rules" label-width="100px">
<el-form-item label="类型编码" prop="typeCode">
<el-input v-model="form.typeCode" placeholder="请输入类型编码" />
</el-form-item>
<el-form-item label="类型名称" prop="typeName">
<el-input v-model="form.typeName" placeholder="请输入类型名称" />
</el-form-item>
<el-form-item label="严重程度" prop="severityLevel">
<el-select v-model="form.severityLevel" placeholder="请选择严重程度">
<el-option label="轻微" :value="1" />
<el-option label="一般" :value="2" />
<el-option label="严重" :value="3" />
<el-option label="特别严重" :value="4" />
</el-select>
</el-form-item>
<el-form-item label="类型描述" prop="typeDesc">
<el-input v-model="form.typeDesc" type="textarea" placeholder="请输入类型描述" :rows="3" />
</el-form-item>
<el-form-item label="状态" prop="status">
<el-radio-group v-model="form.status">
<el-radio label="0">启用</el-radio>
<el-radio label="1">禁用</el-radio>
</el-radio-group>
</el-form-item>
<el-form-item label="备注" prop="remark">
<el-input v-model="form.remark" type="textarea" placeholder="请输入备注" :rows="2" />
</el-form-item>
</el-form>
<template #footer>
<div class="dialog-footer">
<el-button @click="cancel">取 消</el-button>
<el-button type="primary" @click="submitForm">确 定</el-button>
</div>
</template>
</el-dialog>
</div>
</template>
<script setup name="DisciplineType">
// 页面逻辑代码...
</script>
```
#### 任务B: API接口文件创建
```javascript
// web/src/api/xskh/disciplineType.js
import request from '@/utils/request'
// 查询违纪类型列表
export function listDisciplineType(query) {
return request({
url: '/xskh/disciplineType/list',
method: 'get',
params: query
})
}
// 查询违纪类型详细
export function getDisciplineType(id) {
return request({
url: '/xskh/disciplineType/' + id,
method: 'get'
})
}
// 新增违纪类型
export function addDisciplineType(data) {
return request({
url: '/xskh/disciplineType',
method: 'post',
data: data
})
}
// 修改违纪类型
export function updateDisciplineType(data) {
return request({
url: '/xskh/disciplineType',
method: 'put',
data: data
})
}
// 删除违纪类型
export function delDisciplineType(id) {
return request({
url: '/xskh/disciplineType/' + id,
method: 'delete'
})
}
// 导出违纪类型
export function exportDisciplineType(query) {
return request({
url: '/xskh/disciplineType/export',
method: 'post',
params: query,
responseType: 'blob'
})
}
```
---
## 📈 开发进度里程碑
### 里程碑1 (1周后) - 基础配置完成
- ✅ 违纪类型管理页面完成
- ✅ 处分类型管理页面完成
- ✅ 权限配置脚本应用完成
- **系统基础配置可用性达到85%**
### 里程碑2 (3周后) - 核心业务完成
- ✅ 测评明细管理页面完成
- ✅ 附加分申请页面完成
- ✅ 现有页面权限更新完成
- **系统核心功能完整性达到90%**
### 里程碑3 (5周后) - 系统完整交付
- ✅ 方案指标关联页面完成
- ✅ 全部功能联调测试完成
- ✅ 用户验收测试通过
- **系统100%完成，正式投入使用**
---
## 🎯 成功标准
### 功能完整性
- ✅ 所有10个模块前端页面开发完成
- ✅ 权限控制正确实现
- ✅ 前后端数据交互正常
- ✅ 用户体验良好
### 技术规范
- ✅ 遵循Vue 3 + Element Plus开发规范
- ✅ 统一的权限标识命名规范
- ✅ 标准的CRUD页面结构
- ✅ 响应式设计支持
### 质量保证
- ✅ 代码质量符合项目规范
- ✅ 页面性能优化到位
- ✅ 错误处理机制完善
- ✅ 用户操作体验流畅
---
**📝 开发建议**:
1. **优先完成基础配置页面**，为其他业务功能提供数据支持
2. **严格按照权限配置进行开发**，确保系统安全性
3. **采用组件化开发方式**，提高代码复用性
4. **及时进行联调测试**，确保前后端数据交互正常
**🎯 预期成果**: 6周内完成学生考核管理系统100%功能开发，系统正式投入使用。
docs/开发文档/学生考核管理权限配置.md
-177
View File
@@ -1,177 +0,0 @@
# 学生考核管理权限配置说明
## 📋 概述
学生考核管理模块采用动态路由和权限控制机制，用户需要具备相应权限才能访问对应功能。
---
## 🔐 权限列表
### **模块级权限**
- **`xskh:discipline:list`** - 违纪处分管理访问权限（主模块）
- **`xskh:disciplineRecord:list`** - 处分记录管理列表权限
### **功能级权限**
- **`xskh:disciplineRecord:add`** - 新增违纪记录权限
- **`xskh:disciplineRecord:edit`** - 编辑违纪记录权限
- **`xskh:disciplineRecord:remove`** - 删除违纪记录权限
- **`xskh:disciplineRecord:query`** - 查询违纪记录权限
- **`xskh:disciplineRecord:export`** - 导出违纪记录权限
---
## 🗺️ 路由权限映射
### **主要页面路由**
```
/assessment/xskh → xskh:discipline:list
/assessment/disciplineRecord → xskh:disciplineRecord:list
/assessment/disciplineRecord/add → xskh:disciplineRecord:add
/assessment/disciplineRecord/edit/:id → xskh:disciplineRecord:edit
```
### **API接口权限**
```
GET /assessment/disciplineRecord/list → xskh:disciplineRecord:query
POST /assessment/disciplineRecord → xskh:disciplineRecord:add
PUT /assessment/disciplineRecord → xskh:disciplineRecord:edit
DELETE /assessment/disciplineRecord/{ids} → xskh:disciplineRecord:remove
POST /assessment/disciplineRecord/export → xskh:disciplineRecord:export
```
---
## ⚙️ 后端权限配置
### **数据库权限配置**
需要在 `sys_menu` 表中添加以下菜单权限配置：
```sql
-- 1. 学生考核管理主菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('学生考核管理', 0, 6, 'assessment', NULL, 1, 0, 'M', '0', '0', NULL, 'assessment', 'admin', NOW());
-- 2. 违纪处分管理子菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('违纪处分管理', (SELECT menu_id FROM sys_menu WHERE menu_name = '学生考核管理'), 1, 'xskh', 'xskh/index', 1, 0, 'C', '0', '0', 'xskh:discipline:list', 'discipline', 'admin', NOW());
-- 3. 处分记录管理子菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('处分记录管理', (SELECT menu_id FROM sys_menu WHERE menu_name = '学生考核管理'), 2, 'disciplineRecord', 'xskh/disciplineRecord/index', 1, 0, 'C', '0', '0', 'xskh:disciplineRecord:list', 'edit', 'admin', NOW());
-- 4. 功能权限按钮
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('违纪记录查询', (SELECT menu_id FROM sys_menu WHERE menu_name = '处分记录管理'), 1, '', '', 1, 0, 'F', '0', '0', 'xskh:disciplineRecord:query', '#', 'admin', NOW()),
('违纪记录新增', (SELECT menu_id FROM sys_menu WHERE menu_name = '处分记录管理'), 2, '', '', 1, 0, 'F', '0', '0', 'xskh:disciplineRecord:add', '#', 'admin', NOW()),
('违纪记录修改', (SELECT menu_id FROM sys_menu WHERE menu_name = '处分记录管理'), 3, '', '', 1, 0, 'F', '0', '0', 'xskh:disciplineRecord:edit', '#', 'admin', NOW()),
('违纪记录删除', (SELECT menu_id FROM sys_menu WHERE menu_name = '处分记录管理'), 4, '', '', 1, 0, 'F', '0', '0', 'xskh:disciplineRecord:remove', '#', 'admin', NOW()),
('违纪记录导出', (SELECT menu_id FROM sys_menu WHERE menu_name = '处分记录管理'), 5, '', '', 1, 0, 'F', '0', '0', 'xskh:disciplineRecord:export', '#', 'admin', NOW());
```
### **角色权限分配**
将权限分配给相应角色，可通过管理后台或SQL语句：
```sql
-- 为管理员角色分配学生考核管理权限
INSERT INTO sys_role_menu (role_id, menu_id)
SELECT 1, menu_id FROM sys_menu WHERE perms LIKE 'xskh:%';
```
---
## 🎯 前端权限验证
### **路由权限验证**
前端通过动态路由机制自动验证权限：
```typescript
// 在 dynamicRoutes 中配置权限
{
path: '/assessment',
permissions: ['xskh:discipline:list'], // 权限验证
meta: { title: '学生考核管理' },
children: [...]
}
```
### **按钮权限验证**
在组件中使用权限指令：
```vue
<template>
<!-- 新增按钮 -->
<el-button
v-hasPermi="['xskh:disciplineRecord:add']"
type="primary"
@click="handleAdd">
新增
</el-button>
<!-- 编辑按钮 -->
<el-button
v-hasPermi="['xskh:disciplineRecord:edit']"
type="text"
@click="handleUpdate(row)">
修改
</el-button>
<!-- 删除按钮 -->
<el-button
v-hasPermi="['xskh:disciplineRecord:remove']"
type="text"
@click="handleDelete(row)">
删除
</el-button>
</template>
```
---
## 🔧 权限配置步骤
### **1. 后端配置**
1. 执行SQL脚本，创建菜单权限配置
2. 为角色分配相应权限
3. 在Controller中添加 `@SaCheckPermission` 注解
### **2. 前端配置**
1. 确保路由权限配置正确（已完成）
2. 在页面组件中添加按钮权限验证
3. 测试权限验证功能
### **3. 测试验证**
1. 使用具备权限的用户登录
2. 验证菜单显示和页面访问
3. 验证按钮权限控制
4. 验证API接口权限
---
## ⚠️ 注意事项
1. **权限粒度**: 建议按功能模块设计权限，避免过于细化
2. **权限继承**: 子权限需要父权限支持才能生效
3. **缓存刷新**: 权限修改后需要用户重新登录或刷新权限缓存
4. **测试覆盖**: 权限配置完成后必须进行完整的功能测试
---
## 📞 问题解决
### **常见问题**
- **菜单不显示**: 检查用户是否具备对应权限
- **页面404**: 确认动态路由权限配置正确
- **按钮不显示**: 检查 `v-hasPermi` 指令权限配置
- **接口401**: 确认后端Controller权限注解配置
### **调试方法**
1. 检查用户权限列表: `/getInfo` API返回的权限
2. 检查路由权限验证: 浏览器开发者工具Console
3. 检查菜单权限配置: 数据库 `sys_menu` 表
4. 检查角色权限分配: 数据库 `sys_role_menu` 表
---
**📝 文档更新**: 2025-01-27
**🔧 配置状态**: 前端路由权限已配置，后端权限配置待执行
docs/开发文档/学生考核管理权限配置完成报告.md
-310
View File
@@ -1,310 +0,0 @@
# 学生考核管理权限配置完成报告
**配置时间**: 2025-01-28
**配置人员**: 系统开发团队
**数据库**: hzdyjs_xg (远程数据库)
**配置状态**: ✅ 全部完成
---
## 📊 权限配置总览
### ✅ **配置完成情况**
- **总配置菜单数**: **84个** (包含主菜单和按钮权限)
- **ID使用范围**: 9800-9959 (安全范围，避免冲突)
- **模块覆盖数**: **8个** 学生考核管理子模块
- **权限分配**: 已为超级管理员角色(role_id=1)分配所有权限
### 🎯 **模块权限配置明细**
| 序号 | 模块名称 | 主菜单ID | 权限数量 | ID范围 | 配置状态 | 前端路径 |
|------|----------|----------|----------|--------|----------|----------|
| 1 | **考核计划管理** | 9800 | 16个 | 9800-9815 | ✅ 完成 | `assessmentPlan` |
| 2 | **考核方案管理** | 9820 | 10个 | 9820-9829 | ✅ 完成 | `scheme` |
| 3 | **指标体系管理** | 9840 | 9个 | 9840-9848 | ✅ 完成 | `indicator` |
| 4 | **测评明细管理** | 9860 | 10个 | 9860-9869 | ✅ 完成 | `assessmentDetail` |
| 5 | **附加分申请** | 9880 | 11个 | 9880-9890 | ✅ 完成 | `bonusApplication` |
| 6 | **违纪类型管理** | 9900 | 9个 | 9900-9908 | ✅ 完成 | `disciplineType` |
| 7 | **处分类型管理** | 9920 | 9个 | 9920-9928 | ✅ 完成 | `punishmentType` |
| 8 | **方案指标关联** | 9940 | 10个 | 9940-9949 | ✅ 完成 | `schemeIndicator` |
---
## 🔧 权限标识规范
### 📋 **统一权限命名格式**
所有权限标识采用统一格式：`xskh:模块名:操作`
### 🎯 **各模块权限标识**
#### 1. 考核计划管理 (assessmentPlan)
```
xskh:assessmentPlan:list # 列表查询
xskh:assessmentPlan:query # 详情查询
xskh:assessmentPlan:add # 新增
xskh:assessmentPlan:edit # 修改
xskh:assessmentPlan:remove # 删除
xskh:assessmentPlan:export # 导出
xskh:assessmentPlan:import # 导入
xskh:assessmentPlan:publish # 发布
xskh:assessmentPlan:unpublish # 撤销发布
xskh:assessmentPlan:start # 开始
xskh:assessmentPlan:end # 结束
xskh:assessmentPlan:cancel # 取消
xskh:assessmentPlan:archive # 归档
xskh:assessmentPlan:statistics # 统计
xskh:assessmentPlan:copy # 复制
xskh:assessmentPlan:batchStatus # 批量状态
```
#### 2. 考核方案管理 (scheme)
```
xskh:scheme:list # 列表查询
xskh:scheme:query # 详情查询
xskh:scheme:add # 新增
xskh:scheme:edit # 修改
xskh:scheme:remove # 删除
xskh:scheme:export # 导出
xskh:scheme:import # 导入
xskh:scheme:enable # 启用
xskh:scheme:disable # 禁用
xskh:scheme:copy # 复制
```
#### 3. 指标体系管理 (indicator)
```
xskh:indicator:list # 列表查询
xskh:indicator:query # 详情查询
xskh:indicator:add # 新增
xskh:indicator:edit # 修改
xskh:indicator:remove # 删除
xskh:indicator:export # 导出
xskh:indicator:import # 导入
xskh:indicator:enable # 启用
xskh:indicator:disable # 禁用
```
#### 4. 测评明细管理 (assessmentDetail)
```
xskh:assessmentDetail:list # 列表查询
xskh:assessmentDetail:query # 详情查询
xskh:assessmentDetail:add # 新增
xskh:assessmentDetail:edit # 修改
xskh:assessmentDetail:remove # 删除
xskh:assessmentDetail:export # 导出
xskh:assessmentDetail:import # 导入
xskh:assessmentDetail:approve # 审核
xskh:assessmentDetail:revoke # 撤销
xskh:assessmentDetail:statistics # 统计
```
#### 5. 附加分申请 (bonusApplication)
```
xskh:bonusApplication:list # 列表查询
xskh:bonusApplication:query # 详情查询
xskh:bonusApplication:add # 新增
xskh:bonusApplication:edit # 修改
xskh:bonusApplication:remove # 删除
xskh:bonusApplication:export # 导出
xskh:bonusApplication:import # 导入
xskh:bonusApplication:approve # 审核
xskh:bonusApplication:revoke # 撤销
xskh:bonusApplication:myApplications # 我的申请
xskh:bonusApplication:pending # 待审核申请
```
#### 6. 违纪类型管理 (disciplineType)
```
xskh:disciplineType:list # 列表查询
xskh:disciplineType:query # 详情查询
xskh:disciplineType:add # 新增
xskh:disciplineType:edit # 修改
xskh:disciplineType:remove # 删除
xskh:disciplineType:export # 导出
xskh:disciplineType:import # 导入
xskh:disciplineType:enable # 启用
xskh:disciplineType:disable # 禁用
```
#### 7. 处分类型管理 (punishmentType)
```
xskh:punishmentType:list # 列表查询
xskh:punishmentType:query # 详情查询
xskh:punishmentType:add # 新增
xskh:punishmentType:edit # 修改
xskh:punishmentType:remove # 删除
xskh:punishmentType:export # 导出
xskh:punishmentType:import # 导入
xskh:punishmentType:enable # 启用
xskh:punishmentType:disable # 禁用
```
#### 8. 方案指标关联 (schemeIndicator)
```
xskh:schemeIndicator:list # 列表查询
xskh:schemeIndicator:query # 详情查询
xskh:schemeIndicator:add # 新增
xskh:schemeIndicator:edit # 修改
xskh:schemeIndicator:remove # 删除
xskh:schemeIndicator:export # 导出
xskh:schemeIndicator:import # 导入
xskh:schemeIndicator:batchLink # 批量关联
xskh:schemeIndicator:batchUnlink # 批量取消
xskh:schemeIndicator:configWeight # 权重配置
```
---
## 📋 前端页面开发指南
### ✅ **已存在页面 (需更新权限标识)**
#### 1. 考核计划管理
- **页面路径**: `web/src/views/xskh/assessmentPlan/index.vue`
- **API文件**: `web/src/api/xskh/assessmentPlan.ts`
- **状态**: ✅ 页面已存在，权限已配置
#### 2. 考核方案管理
- **页面路径**: `web/src/views/xskh/scheme/index.vue`
- **API文件**: `web/src/api/xskh/scheme.js`
- **状态**: 🟡 需要更新权限标识为 `xskh:scheme:*`
#### 3. 指标体系管理
- **页面路径**: `web/src/views/xskh/indicator/index.vue`
- **API文件**: `web/src/api/xskh/indicator.js`
- **状态**: 🟡 需要更新权限标识为 `xskh:indicator:*`
### 🔄 **待开发页面**
#### 4. 测评明细管理
- **页面路径**: `web/src/views/xskh/assessmentDetail/index.vue`
- **API文件**: `web/src/api/xskh/assessmentDetail.js`
- **权限标识**: `xskh:assessmentDetail:*`
- **状态**: ❌ 需要开发
#### 5. 附加分申请
- **页面路径**: `web/src/views/xskh/bonusApplication/index.vue`
- **API文件**: `web/src/api/xskh/bonusApplication.js`
- **权限标识**: `xskh:bonusApplication:*`
- **状态**: ❌ 需要开发
#### 6. 违纪类型管理
- **页面路径**: `web/src/views/xskh/disciplineType/index.vue`
- **API文件**: `web/src/api/xskh/disciplineType.js`
- **权限标识**: `xskh:disciplineType:*`
- **状态**: ❌ 需要开发
#### 7. 处分类型管理
- **页面路径**: `web/src/views/xskh/punishmentType/index.vue`
- **API文件**: `web/src/api/xskh/punishmentType.js`
- **权限标识**: `xskh:punishmentType:*`
- **状态**: ❌ 需要开发
#### 8. 方案指标关联
- **页面路径**: `web/src/views/xskh/schemeIndicator/index.vue`
- **API文件**: `web/src/api/xskh/schemeIndicator.js`
- **权限标识**: `xskh:schemeIndicator:*`
- **状态**: ❌ 需要开发
---
## 🎯 前端权限控制使用方法
### 📝 **v-hasPermi 指令使用示例**
```vue
<!-- 新增按钮 -->
<el-button type="primary" plain icon="Plus" @click="handleAdd"
v-hasPermi="['xskh:disciplineType:add']">新增</el-button>
<!-- 修改按钮 -->
<el-button type="success" plain icon="Edit" :disabled="single" @click="handleUpdate()"
v-hasPermi="['xskh:disciplineType:edit']">修改</el-button>
<!-- 删除按钮 -->
<el-button type="danger" plain icon="Delete" :disabled="multiple" @click="handleDelete()"
v-hasPermi="['xskh:disciplineType:remove']">删除</el-button>
<!-- 导出按钮 -->
<el-button type="warning" plain icon="Download" @click="handleExport"
v-hasPermi="['xskh:disciplineType:export']">导出</el-button>
<!-- 表格操作列按钮 -->
<el-button link type="primary" icon="Edit" @click="handleUpdate(scope.row)"
v-hasPermi="['xskh:disciplineType:edit']">修改</el-button>
<el-button link type="primary" icon="Delete" @click="handleDelete(scope.row)"
v-hasPermi="['xskh:disciplineType:remove']">删除</el-button>
```
---
## 📊 验证结果
### ✅ **数据库验证结果**
```sql
-- 权限菜单统计
总配置菜单数: 84个
ID使用范围: 9800-9959
最小ID: 9800
最大ID: 9949
-- 模块配置验证
考核计划管理: 16个权限 (9800-9815) ✅
考核方案管理: 10个权限 (9820-9829) ✅
指标体系管理: 9个权限 (9840-9848) ✅
测评明细管理: 10个权限 (9860-9869) ✅
附加分申请: 11个权限 (9880-9890) ✅
违纪类型管理: 9个权限 (9900-9908) ✅
处分类型管理: 9个权限 (9920-9928) ✅
方案指标关联: 10个权限 (9940-9949) ✅
```
### 🔐 **角色权限分配**
- **超级管理员角色(role_id=1)**: 已分配所有84个权限 ✅
- **权限生效**: 立即生效，无需重启系统 ✅
---
## 🚀 下一步开发建议
### 🔴 **优先级1 - 立即开始**
1. **更新现有页面权限标识** (预计0.5天)
- 更新考核方案管理页面权限标识
- 更新指标体系管理页面权限标识
2. **开发基础配置页面** (预计4天)
- 违纪类型管理页面开发 (2天)
- 处分类型管理页面开发 (2天)
### 🟡 **优先级2 - 后续安排**
3. **开发核心业务页面** (预计6天)
- 测评明细管理页面开发 (3天)
- 附加分申请页面开发 (3天)
### 🟢 **优先级3 - 最后完成**
4. **开发高级管理页面** (预计4天)
- 方案指标关联页面开发 (4天，复杂业务逻辑)
---
## 📋 技术规范要求
### 🎯 **前端开发规范**
- 使用Vue 3 + Element Plus技术栈
- 统一使用`v-hasPermi`指令控制权限
- 权限标识严格按照配置的格式使用
- 页面路径必须与权限配置中的path一致
### 🔧 **API接口规范**
- 后端接口权限注解使用`@SaCheckPermission`
- 权限标识与前端保持一致
- 统一的响应格式和错误处理
### 📊 **质量保证**
- 前后端权限标识一致性检查
- 权限控制功能测试
- 用户体验优化
---
**📝 总结**: 学生考核管理模块权限配置已100%完成，共配置84个权限菜单，涵盖8个子模块。所有权限已分配给超级管理员角色，可立即开始前端页面开发工作。预计15天内可完成所有前端页面开发，系统将达到100%完成度。
docs/开发文档/学生考核管理系统开发进度分析报告.md
-201
View File
@@ -1,201 +0,0 @@
# 学生考核管理系统开发进度分析报告
**创建时间**: 2025-01-28
**分析人员**: 系统开发团队
**报告版本**: V2.0.0 (更新版)
**系统模块**: 学生考核管理 (xskh)
---
## 📋 系统概述
### 🎯 系统定位
- **一级模块**: 学生考核管理系统 (Student Assessment Management)
- **模块标识**: `xskh` (学生考核 - XueShengKaoHe)
- **技术架构**: 前后端分离 + 移动端
- **主菜单ID**: 9000
### 🏗️ 功能架构
基于需求文档分析，系统包含两大核心业务域：
1. **违纪处分管理** - 学生违纪行为记录与处分管理
2. **综合测评管理** - 学生综合素质测评与排名
---
## 📊 整体开发进度概览 (最新更新)
|| 模块 | 后端开发 | 前端开发 | 权限配置 | 综合进度 | 状态 |
||------|----------|----------|----------|----------|------|
|| **违纪处分管理** | ✅ 100% | ✅ 100% | ✅ 100% | ✅ 100% | 🟢 已完成 |
|| **综合测评记录** | ✅ 100% | ✅ 100% | ✅ 100% | ✅ 100% | 🟢 已完成 |
|| **考核计划管理** | ✅ 100% | ✅ 100% | ✅ 100% | ✅ 100% | 🟢 已完成 |
|| **考核方案管理** | ✅ 100% | ✅ 100% | 🟡 脚本已创建 | 🟡 95% | 🟡 待权限应用 |
|| **指标体系管理** | ✅ 100% | ✅ 100% | 🟡 脚本已创建 | 🟡 95% | 🟡 待权限应用 |
|| **测评明细管理** | ✅ 100% | ❌ 待开发 | 🟡 脚本已创建 | 🟡 65% | 🟡 进行中 |
|| **附加分申请** | ✅ 100% | ❌ 待开发 | 🟡 脚本已创建 | 🟡 65% | 🟡 进行中 |
|| **违纪类型管理** | ✅ 100% | ❌ 待开发 | 🟡 脚本已创建 | 🟡 65% | 🟡 进行中 |
|| **处分类型管理** | ✅ 100% | ❌ 待开发 | 🟡 脚本已创建 | 🟡 65% | 🟡 进行中 |
|| **方案指标关联** | ✅ 100% | ❌ 待开发 | 🟡 脚本已创建 | 🟡 65% | 🟡 进行中 |
### 📈 总体完成度 (更新)
- **后端开发**: 100% (10/10 模块完成) ✅
- **前端开发**: 50% (5/10 模块完成) 🔄
- **权限配置**: 85% (权限脚本全部创建完成) 🟡
- **系统整体**: **75%** (比上次提升5%)
---
## 🎯 权限配置重大进展
### ✅ **权限配置完成情况**
**🎉 重大进展**: 所有模块权限配置脚本已创建完成！
| 模块名称 | ID范围 | 权限数量 | 配置状态 | 脚本文件 |
|---------|--------|----------|----------|----------|
| 考核计划管理 | 9800-9819 | 18个 | ✅ 已完成 | 考核计划管理权限配置-完整版.sql |
| 考核方案管理 | 9820-9839 | 10个 | 🟡 脚本已创建 | 其他模块权限配置-批量创建.sql |
| 指标体系管理 | 9840-9859 | 9个 | 🟡 脚本已创建 | 其他模块权限配置-批量创建.sql |
| 测评明细管理 | 9860-9879 | 10个 | 🟡 脚本已创建 | 其他模块权限配置-批量创建.sql |
| 附加分申请 | 9880-9899 | 11个 | 🟡 脚本已创建 | 其他模块权限配置-批量创建.sql |
| 违纪类型管理 | 9900-9919 | 9个 | 🟡 脚本已创建 | 其他模块权限配置-批量创建.sql |
| 处分类型管理 | 9920-9939 | 9个 | 🟡 脚本已创建 | 其他模块权限配置-批量创建.sql |
| 方案指标关联 | 9940-9959 | 10个 | 🟡 脚本已创建 | 其他模块权限配置-批量创建.sql |
### 🔧 **权限配置特点**
- **ID范围安全**: 使用9800-9959范围，避免与现有模块冲突
- **权限粒度完整**: 每个模块包含基础CRUD + 业务特定权限
- **扩展性良好**: 每个模块预留了扩展ID
- **统一命名规范**: 权限标识统一使用 `xskh:模块名:操作` 格式
---
## 🚀 下一步开发计划 (详细版)
### 🔴 **第一阶段：权限应用和基础页面 (1-2周)**
#### 1.1 权限配置脚本应用 ⭐⭐⭐
**优先级**: 最高
**预估工期**: 0.5天
**执行内容**:
1. 应用考核计划管理权限配置脚本
2. 应用其他模块权限配置脚本
3. 验证所有权限配置是否生效
4. 更新现有页面权限标识
#### 1.2 违纪类型管理页面开发 ⭐⭐⭐
**优先级**: 最高 (基础数据配置)
**预估工期**: 2天
**开发内容**:
- 创建 `web/src/views/xskh/disciplineType/index.vue`
- 创建 `web/src/api/xskh/disciplineType.js`
- 实现完整的CRUD功能和状态管理
#### 1.3 处分类型管理页面开发 ⭐⭐⭐
**优先级**: 最高 (基础数据配置)
**预估工期**: 2天
**开发内容**:
- 创建 `web/src/views/xskh/punishmentType/index.vue`
- 创建 `web/src/api/xskh/punishmentType.js`
- 实现完整的CRUD功能和状态管理
### 🟡 **第二阶段：核心业务页面 (3-4周)**
#### 2.1 测评明细管理页面开发 ⭐⭐
**预估工期**: 3天
**开发内容**:
- 测评明细列表和详情页面
- 审核和统计功能组件
- 批量操作功能实现
#### 2.2 附加分申请页面开发 ⭐⭐
**预估工期**: 3天
**开发内容**:
- 申请列表和我的申请页面
- 申请审核和状态流转功能
- 申请详情和统计组件
### 🟢 **第三阶段：高级管理页面 (5-6周)**
#### 3.1 方案指标关联页面开发 ⭐
**预估工期**: 4天 (复杂业务逻辑)
**开发内容**:
- 关联管理主页面和批量操作
- 权重配置和关系可视化
- 树形组件和关联组件开发
---
## 📈 开发进度里程碑 (更新版)
### 里程碑1 (1周后) - 权限和基础配置完成
- ✅ 所有权限配置脚本应用完成
- ✅ 违纪类型管理页面完成
- ✅ 处分类型管理页面完成
- ✅ 现有页面权限标识更新完成
- **系统基础配置可用性达到90%**
### 里程碑2 (3周后) - 核心业务完成
- ✅ 测评明细管理页面完成
- ✅ 附加分申请页面完成
- ✅ 前后端功能联调测试完成
- **系统核心功能完整性达到95%**
### 里程碑3 (5周后) - 系统完整交付
- ✅ 方案指标关联页面完成
- ✅ 全部功能集成测试完成
- ✅ 用户验收测试通过
- **系统100%完成，正式投入使用**
---
## 🔍 关键成果和亮点
### ✅ **已完成亮点 (更新)**
1. **后端开发100%完成** - 10个Controller全部实现，46个编译错误已全部修复
2. **权限配置架构完成** - 创建了完整的权限配置体系，使用安全ID范围
3. **核心业务模块完成** - 违纪处分、综合测评、考核计划已可投入使用
4. **API文档完善** - 学生考核计划管理API文档已完成
5. **开发规范建立** - 建立了完善的前端开发计划和技术规范
### 🎯 **当前重点 (更新)**
1. **权限配置应用** - 将创建的权限脚本应用到数据库
2. **基础配置页面开发** - 违纪类型、处分类型管理页面
3. **前端开发加速** - 按照详细开发计划推进剩余5个模块
4. **系统集成测试** - 确保前后端功能完整可用
### 🚀 **预期成果 (更新)**
- **1周内**: 权限配置完成，基础页面开发完成，系统可用性达到90%
- **3周内**: 核心业务页面完成，系统功能完整性达到95%
- **5周内**: 系统100%完成，可正式投入使用
---
## 📊 技术债务和风险评估
### 🟡 **当前风险**
1. **权限配置应用** - 需要数据库管理员配合执行SQL脚本
2. **前端开发工作量** - 5个页面需要集中开发，工期较紧
3. **业务复杂度** - 方案指标关联页面业务逻辑复杂
### ✅ **风险缓解措施**
1. **权限配置**: 已准备完整的SQL脚本，包含验证和回滚机制
2. **开发效率**: 制定了详细的开发计划，提供了代码模板
3. **复杂业务**: 将复杂页面分解为多个组件，分步开发
---
## 📋 资源配置建议
### 👥 **人员配置**
- **前端开发**: 2-3人，专注页面开发
- **权限配置**: 1人，负责权限脚本应用和验证
- **测试验证**: 1人，负责功能测试和集成测试
### ⏰ **时间安排**
- **第1周**: 权限配置 + 基础页面开发
- **第2-3周**: 核心业务页面开发
- **第4-5周**: 高级页面开发 + 系统测试
---
**📝 报告结论**: 学生考核管理系统开发进度显著提升，权限配置体系已完成，后端开发100%完成。当前重点是权限应用和前端页面开发，按照详细开发计划执行，预计5周内可完成全部功能并投入使用。系统整体完成度已达到75%，比上次提升5%。
docs/开发文档/学生考核管理重复菜单清理报告.md
-199
View File
@@ -1,199 +0,0 @@
# 学生考核管理重复菜单清理报告
**清理时间**: 2025-01-28
**执行人员**: 系统开发团队
**数据库**: hzdyjs_xg (远程数据库)
**清理状态**: ✅ 清理完成
---
## 📊 清理前后对比
### 🔍 **清理前情况**
- **总菜单数**: 14个主菜单
- **重复菜单**: 4组重复菜单
- **问题**: 相同路径的菜单重复，影响用户体验
### ✅ **清理后情况**
- **总菜单数**: 10个主菜单
- **子菜单数**: 95个按钮权限菜单
- **重复菜单**: 0个
- **状态**: 菜单结构清晰，无重复项
---
## 🎯 重复菜单分析与处理
### 📋 **发现的重复菜单**
| 序号 | 菜单路径 | 重复的菜单ID | 保留菜单ID | 删除菜单ID | 处理结果 |
|------|----------|--------------|------------|------------|----------|
| 1 | `assessmentPlan` | 9200, 9800 | 9800 | 9200 | ✅ 已删除 |
| 2 | `assessmentDetail` | 9210, 9860 | 9860 | 9210 | ✅ 已删除 |
| 3 | `bonusApplication` | 9220, 9880 | 9880 | 9220 | ✅ 已删除 |
| 4 | `schemeIndicator` | 9230, 9940 | 9940 | 9230 | ✅ 已删除 |
### 🔄 **删除策略说明**
#### 为什么保留9800系列，删除9200系列？
1. **ID规划合理性**: 9800系列是按照统一规划分配的ID范围
2. **扩展性更好**: 9800系列为每个模块预留了更多的ID空间
3. **避免冲突**: 9800系列使用了安全的ID范围，不会与其他模块冲突
---
## 📋 最终保留的菜单结构
### ✅ **主菜单列表** (按显示顺序)
| 排序 | 菜单ID | 菜单路径 | 权限标识 | 菜单说明 | 状态 |
|------|--------|----------|----------|----------|------|
| 1 | 9100 | `xskh` | `xskh:disciplineRecord:list` | **违纪处分申请** | 🔴 **用户指定保留** |
| 2 | 9120 | `disciplineRecord` | `xskh:disciplineRecord:list` | **处分记录审批** | 🔴 **用户指定保留** |
| 3 | 9800 | `assessmentPlan` | `xskh:assessmentPlan:list` | 考核计划管理 | ✅ 保留 |
| 4 | 9820 | `scheme` | `xskh:scheme:list` | 考核方案管理 | ✅ 保留 |
| 5 | 9840 | `indicator` | `xskh:indicator:list` | 指标体系管理 | ✅ 保留 |
| 6 | 9860 | `assessmentDetail` | `xskh:assessmentDetail:list` | 测评明细管理 | ✅ 保留 |
| 7 | 9880 | `bonusApplication` | `xskh:bonusApplication:list` | 附加分申请 | ✅ 保留 |
| 8 | 9900 | `disciplineType` | `xskh:disciplineType:list` | 违纪类型管理 | ✅ 保留 |
| 9 | 9920 | `punishmentType` | `xskh:punishmentType:list` | 处分类型管理 | ✅ 保留 |
| 10 | 9940 | `schemeIndicator` | `xskh:schemeIndicator:list` | 方案指标关联 | ✅ 保留 |
### 🎯 **菜单特点**
- ✅ **无重复路径**: 每个路径只有一个菜单
- ✅ **排序合理**: 按业务逻辑排序，用户体验好
- ✅ **权限完整**: 每个主菜单都有对应的子菜单权限
- ✅ **保留关键菜单**: 违纪处分申请和处分记录审批按用户要求保留
---
## 🔧 清理执行详情
### 📝 **删除操作记录**
#### 1. 删除重复的考核计划管理菜单 (ID: 9200)
```sql
-- 删除角色菜单关联
DELETE FROM sys_role_menu WHERE menu_id BETWEEN 9200 AND 9219;
-- 删除子菜单
DELETE FROM sys_menu WHERE parent_id = 9200;
-- 删除主菜单
DELETE FROM sys_menu WHERE menu_id = 9200;
```
#### 2. 删除重复的测评明细管理菜单 (ID: 9210)
```sql
-- 删除角色菜单关联
DELETE FROM sys_role_menu WHERE menu_id BETWEEN 9210 AND 9219;
-- 删除子菜单
DELETE FROM sys_menu WHERE parent_id = 9210;
-- 删除主菜单
DELETE FROM sys_menu WHERE menu_id = 9210;
```
#### 3. 删除重复的附加分申请菜单 (ID: 9220)
```sql
-- 删除角色菜单关联
DELETE FROM sys_role_menu WHERE menu_id BETWEEN 9220 AND 9229;
-- 删除子菜单
DELETE FROM sys_menu WHERE parent_id = 9220;
-- 删除主菜单
DELETE FROM sys_menu WHERE menu_id = 9220;
```
#### 4. 删除重复的方案指标关联菜单 (ID: 9230)
```sql
-- 删除角色菜单关联
DELETE FROM sys_role_menu WHERE menu_id BETWEEN 9230 AND 9239;
-- 删除子菜单
DELETE FROM sys_menu WHERE parent_id = 9230;
-- 删除主菜单
DELETE FROM sys_menu WHERE menu_id = 9230;
```
### 🔄 **菜单排序更新**
```sql
UPDATE sys_menu SET order_num = 1 WHERE menu_id = 9100; -- 违纪处分申请
UPDATE sys_menu SET order_num = 2 WHERE menu_id = 9120; -- 处分记录审批
UPDATE sys_menu SET order_num = 3 WHERE menu_id = 9800; -- 考核计划管理
UPDATE sys_menu SET order_num = 4 WHERE menu_id = 9820; -- 考核方案管理
UPDATE sys_menu SET order_num = 5 WHERE menu_id = 9840; -- 指标体系管理
UPDATE sys_menu SET order_num = 6 WHERE menu_id = 9860; -- 测评明细管理
UPDATE sys_menu SET order_num = 7 WHERE menu_id = 9880; -- 附加分申请
UPDATE sys_menu SET order_num = 8 WHERE menu_id = 9900; -- 违纪类型管理
UPDATE sys_menu SET order_num = 9 WHERE menu_id = 9920; -- 处分类型管理
UPDATE sys_menu SET order_num = 10 WHERE menu_id = 9940; -- 方案指标关联
```
---
## 📊 验证结果
### ✅ **数据完整性验证**
```sql
-- 主菜单数量验证
学生考核管理子菜单总数: 10个 ✅
-- 子菜单数量验证
子菜单总数: 95个 ✅
-- 路径唯一性验证
所有路径无重复 ✅
```
### 🔐 **权限验证**
- **角色权限关联**: 已正确清理删除菜单的角色关联
- **权限继承**: 保留菜单的权限完整无损
- **权限生效**: 立即生效，无需重启系统
---
## 🚀 清理效果
### 📈 **用户体验提升**
1. **菜单结构清晰**: 不再有重复菜单困扰用户
2. **导航更直观**: 每个功能只有一个入口
3. **减少混淆**: 避免用户不知道选择哪个菜单
### 🔧 **系统维护改善**
1. **权限管理简化**: 权限配置更清晰
2. **开发效率提升**: 前端开发时路径明确
3. **数据库优化**: 减少了冗余数据
### 📊 **数据统计**
- **删除主菜单**: 4个
- **删除子菜单**: 约40个 (估算)
- **删除权限关联**: 相应数量的角色菜单关联
- **保留菜单**: 10个主菜单 + 95个子菜单
---
## 📋 后续建议
### 🔴 **立即关注**
1. **前端路由更新**: 确认前端路由与保留的菜单路径一致
2. **权限测试**: 测试所有保留菜单的权限功能
3. **用户培训**: 通知用户菜单结构的变化
### 🟡 **持续优化**
1. **菜单命名**: 考虑将菜单名称改为更直观的中文名称
2. **图标配置**: 为每个菜单配置合适的图标
3. **功能完善**: 继续完善各个菜单对应的前端页面
---
## 🎯 总结
### ✅ **清理成果**
- **✅ 成功删除4个重复菜单**及其所有子菜单
- **✅ 保留了用户指定的关键菜单**：违纪处分申请、处分记录审批
- **✅ 优化了菜单排序**，提升用户体验
- **✅ 确保数据完整性**，无权限丢失
### 🚀 **系统状态**
- **菜单结构**: 100%清理完成，无重复项
- **权限配置**: 完整保留，功能正常
- **用户体验**: 显著提升，导航清晰
- **系统稳定性**: 立即生效，无需重启
**📝 结论**: 学生考核管理模块的重复菜单清理工作已100%完成，系统菜单结构现在非常清晰，用户体验得到显著提升。所有关键功能保持完整，可以继续正常使用和开发。
docs/开发文档/开发任务清单和时间规划.md
-339
View File
@@ -1,339 +0,0 @@
# 考核管理系统开发任务清单和时间规划
## 📅 开发时间规划总览
**开发周期**: 4周
**开发模式**: 迭代开发，分阶段交付
**团队规模**: 建议2-3人（1个后端，1个前端，1个测试）
---
## 🎯 第一阶段：核心功能开发（第1-2周）
### **Week 1: 自动扣分计算功能**
#### **Day 1-2: 数据库设计和基础架构**
- [ ] **任务1.1**: 创建扣分规则配置表 `xskh_discipline_score_rule`
- **负责人**: 后端开发
- **工作量**: 0.5天
- **交付物**: SQL脚本，基础数据
- [ ] **任务1.2**: 扩展考核记录表字段
- **负责人**: 后端开发
- **工作量**: 0.5天
- **交付物**: ALTER TABLE脚本
- [ ] **任务1.3**: 创建扣分历史记录表 `xskh_discipline_score_history`
- **负责人**: 后端开发
- **工作量**: 0.5天
- **交付物**: SQL脚本
- [ ] **任务1.4**: 生成实体类和基础CRUD
- **负责人**: 后端开发
- **工作量**: 0.5天
- **交付物**: 实体类、BO、VO、Mapper文件
#### **Day 3-4: 核心业务逻辑开发**
- [ ] **任务2.1**: 开发扣分规则服务 `XskhDisciplineScoreRuleService`
- **负责人**: 后端开发
- **工作量**: 1天
- **功能点**: 规则查询、匹配、验证
- **交付物**: Service实现类，单元测试
- [ ] **任务2.2**: 开发扣分计算服务 `XskhDisciplineScoreCalculationService`
- **负责人**: 后端开发
- **工作量**: 1天
- **功能点**: 分数计算、记录更新、历史记录
- **交付物**: Service实现类，单元测试
#### **Day 5: 事件驱动机制**
- [ ] **任务3.1**: 创建违纪审批事件类 `DisciplineApprovedEvent`
- **负责人**: 后端开发
- **工作量**: 0.25天
- **交付物**: 事件类定义
- [ ] **任务3.2**: 开发事件监听器 `DisciplineAssessmentSyncService`
- **负责人**: 后端开发
- **工作量**: 0.5天
- **交付物**: 异步事件处理器
- [ ] **任务3.3**: 集成事件发布到违纪审批流程
- **负责人**: 后端开发
- **工作量**: 0.25天
- **交付物**: 修改审批Service
### **Week 2: 管理界面和API接口**
#### **Day 6-7: 后端API开发**
- [ ] **任务4.1**: 扣分规则管理API
- **负责人**: 后端开发
- **工作量**: 1天
- **功能点**: CRUD、批量操作、状态切换
- **交付物**: Controller类，API文档
- [ ] **任务4.2**: 扣分历史查询API
- **负责人**: 后端开发
- **工作量**: 0.5天
- **功能点**: 分页查询、条件筛选、详情查看
- **交付物**: Controller类，API文档
- [ ] **任务4.3**: 扣分计算手动触发API
- **负责人**: 后端开发
- **工作量**: 0.5天
- **功能点**: 手动重新计算、批量计算
- **交付物**: Controller类
#### **Day 8-9: 前端界面开发**
- [ ] **任务5.1**: 扣分规则管理页面
- **负责人**: 前端开发
- **工作量**: 1天
- **功能点**: 列表、新增、编辑、删除
- **交付物**: Vue页面组件
- [ ] **任务5.2**: 扣分历史查询页面
- **负责人**: 前端开发
- **工作量**: 0.5天
- **功能点**: 列表查询、详情查看
- **交付物**: Vue页面组件
- [ ] **任务5.3**: 扣分计算控制台页面
- **负责人**: 前端开发
- **工作量**: 0.5天
- **功能点**: 手动触发、进度监控
- **交付物**: Vue页面组件
#### **Day 10: 测试和集成**
- [ ] **任务6.1**: 功能测试
- **负责人**: 测试/开发
- **工作量**: 0.5天
- **交付物**: 测试报告
- [ ] **任务6.2**: 集成测试和性能测试
- **负责人**: 测试/开发
- **工作量**: 0.5天
- **交付物**: 性能测试报告
---
## 🚀 第二阶段：增强功能开发（第3周）
### **Week 3: 计划模板和指标库标准化**
#### **Day 11-12: 计划模板管理**
- [ ] **任务7.1**: 设计计划模板数据模型
- **负责人**: 后端开发
- **工作量**: 0.5天
- **交付物**: 数据库表设计、实体类
- [ ] **任务7.2**: 开发模板管理业务逻辑
- **负责人**: 后端开发
- **工作量**: 1天
- **功能点**: 模板保存、复制、应用
- **交付物**: Service实现类
- [ ] **任务7.3**: 开发模板管理API和界面
- **负责人**: 前端+后端
- **工作量**: 0.5天
- **交付物**: API接口、Vue页面
#### **Day 13-14: 指标库标准化**
- [ ] **任务8.1**: 设计指标分类和版本管理表
- **负责人**: 后端开发
- **工作量**: 0.5天
- **交付物**: 数据库表设计
- [ ] **任务8.2**: 开发指标库管理功能
- **负责人**: 后端开发
- **工作量**: 1天
- **功能点**: 分类管理、版本控制、导入导出
- **交付物**: Service实现类
- [ ] **任务8.3**: 预置国家标准指标库
- **负责人**: 业务分析师+开发
- **工作量**: 0.5天
- **交付物**: 标准指标数据SQL
#### **Day 15: 动态权重配置**
- [ ] **任务9.1**: 开发多维度权重配置功能
- **负责人**: 后端开发
- **工作量**: 0.5天
- **功能点**: 按年级、专业、时间段配置
- **交付物**: Service增强
- [ ] **任务9.2**: 开发权重配置界面
- **负责人**: 前端开发
- **工作量**: 0.5天
- **交付物**: Vue组件
---
## 🎨 第三阶段：用户体验优化（第4周）
### **Week 4: 批量操作和数据可视化**
#### **Day 16-17: 批量操作功能**
- [ ] **任务10.1**: 开发计划批量操作功能
- **负责人**: 后端开发
- **工作量**: 0.5天
- **功能点**: 批量发布、归档、时间调整
- **交付物**: Service增强
- [ ] **任务10.2**: 开发批量操作界面
- **负责人**: 前端开发
- **工作量**: 0.5天
- **交付物**: Vue组件增强
- [ ] **任务10.3**: 开发进度监控功能
- **负责人**: 后端+前端
- **工作量**: 1天
- **功能点**: 实时进度、预警机制
- **交付物**: WebSocket推送、进度组件
#### **Day 18-19: 数据分析大屏**
- [ ] **任务11.1**: 开发数据统计API
- **负责人**: 后端开发
- **工作量**: 1天
- **功能点**: 多维度统计、趋势分析
- **交付物**: 统计API
- [ ] **任务11.2**: 开发可视化大屏界面
- **负责人**: 前端开发
- **工作量**: 1天
- **功能点**: ECharts图表、实时刷新
- **交付物**: 大屏Vue页面
#### **Day 20: 系统优化和上线准备**
- [ ] **任务12.1**: 性能优化
- **负责人**: 后端开发
- **工作量**: 0.5天
- **功能点**: 缓存优化、查询优化
- **交付物**: 性能优化报告
- [ ] **任务12.2**: 系统集成测试
- **负责人**: 测试团队
- **工作量**: 0.3天
- **交付物**: 集成测试报告
- [ ] **任务12.3**: 部署文档和上线准备
- **负责人**: DevOps/开发
- **工作量**: 0.2天
- **交付物**: 部署指南、运维文档
---
## 📋 并行开发任务
### **可以并行执行的任务组合**
#### **组合1: 数据库+前端准备**
- 数据库表设计（Day 1-2）
- 前端页面框架搭建（Day 1-2）
#### **组合2: 后端+前端开发**
- 后端API开发（Day 6-7）
- 前端界面开发（Day 8-9）
#### **组合3: 功能+测试**
- 新功能开发
- 前一个功能的测试
---
## 🎯 关键里程碑
### **里程碑1: 核心功能完成（Day 10）**
- ✅ 自动扣分计算功能上线
- ✅ 基础管理界面可用
- ✅ 核心业务流程打通
### **里程碑2: 增强功能完成（Day 15）**
- ✅ 模板管理功能上线
- ✅ 指标库标准化完成
- ✅ 动态权重配置可用
### **里程碑3: 系统优化完成（Day 20）**
- ✅ 批量操作功能上线
- ✅ 数据可视化大屏完成
- ✅ 系统性能优化完成
---
## 👥 人员分工建议
### **后端开发工程师（主力）**
- **主要负责**:
- 数据库设计和建表脚本
- 核心业务逻辑开发
- API接口开发
- 性能优化
- **技能要求**: Spring Boot、MyBatis-Plus、MySQL、Redis
- **工作量**: 15天
### **前端开发工程师**
- **主要负责**:
- Vue页面组件开发
- 用户界面交互设计
- 数据可视化图表
- 前端性能优化
- **技能要求**: Vue 3、Element Plus、ECharts、TypeScript
- **工作量**: 8天
### **测试工程师**
- **主要负责**:
- 功能测试用例设计
- 集成测试执行
- 性能测试
- 测试报告编写
- **技能要求**: 测试理论、自动化测试、性能测试工具
- **工作量**: 5天
---
## 🔄 风险控制和应急方案
### **技术风险**
- **风险**: 扣分计算逻辑复杂，可能出现边界情况
- **应对**: 充分的单元测试，边界条件测试
### **进度风险**
- **风险**: 需求变更导致开发延期
- **应对**: 采用迭代开发，优先实现核心功能
### **质量风险**
- **风险**: 数据一致性问题
- **应对**: 事务控制，数据校验机制
### **应急方案**
- **Plan B**: 如果自动扣分计算复杂度超预期，先实现手动扣分功能
- **Plan C**: 如果可视化大屏开发时间不够，先实现基础报表功能
---
## 📊 交付物清单
### **技术交付物**
- [ ] 数据库设计文档和SQL脚本
- [ ] 后端API接口文档
- [ ] 前端页面原型和源代码
- [ ] 单元测试和集成测试代码
- [ ] 性能测试报告
- [ ] 部署和运维文档
### **业务交付物**
- [ ] 功能需求确认书
- [ ] 用户操作手册
- [ ] 系统管理员手册
- [ ] 业务流程梳理文档
- [ ] 数据字典和配置说明
### **项目管理交付物**
- [ ] 项目计划和进度报告
- [ ] 风险识别和应对方案
- [ ] 变更管理记录
- [ ] 项目总结报告
---
**项目经理**: 待分配
**技术负责人**: 待分配
**最后更新时间**: 2025-01-07 20:00:00
docs/开发文档/第一阶段-自动扣分计算功能实施记录.md
-389
View File
@@ -1,389 +0,0 @@
# 第一阶段：自动扣分计算功能实施记录
## 📅 开发进度总览
**开发阶段**: 第一阶段（Week 1）
**开始时间**: 2025-01-07 20:30:00
**预计完成**: 2025-01-11 18:00:00
**当前进度**: 100% (Day 1-5 已完成)
---
## ✅ 已完成任务
### **Day 1-2: 数据库设计和基础架构 (已完成 100%)**
#### **任务1.1**: 创建扣分规则配置表 ✅
- **完成时间**: 2025-01-07 21:00:00
- **文件位置**: `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/sql/扣分规则配置表.sql`
- **主要内容**:
- ✅ 违纪扣分规则配置表 `xskh_discipline_score_rule`
- ✅ 考核记录表字段扩展（新增5个字段）
- ✅ 扣分计算历史表 `xskh_discipline_score_history`
- ✅ 8条默认扣分规则数据（ID范围：20001-20008，避免冲突）
- ✅ 3个性能优化复合索引
#### **任务1.2**: 生成实体类和基础CRUD ✅
- **完成时间**: 2025-01-07 21:30:00
- **完成内容**:
- ✅ 实体类：`XskhDisciplineScoreRule.java`
- ✅ 业务对象：`XskhDisciplineScoreRuleBo.java`（包含完整校验注解）
- ✅ 视图对象：`XskhDisciplineScoreRuleVo.java`（包含Excel注解和标签方法）
- ✅ Mapper接口：`XskhDisciplineScoreRuleMapper.java`（6个核心方法）
- ✅ MyBatis映射：`XskhDisciplineScoreRuleMapper.xml`（复杂查询逻辑）
### **Day 3-4: 核心业务逻辑开发 (已完成 100%)**
#### **任务2.1**: 开发扣分规则服务 ✅
- **完成时间**: 2025-01-07 22:00:00
- **完成内容**:
- ✅ 服务接口：`IXskhDisciplineScoreRuleService.java`（16个核心方法）
- ✅ 服务实现：`XskhDisciplineScoreRuleServiceImpl.java`（497行完整业务逻辑）
- ✅ 规则匹配算法：支持多维度条件匹配和优先级排序
- ✅ 冲突检测机制：智能检测规则适用范围重叠
- ✅ 批量操作支持：导入导出、批量启用禁用
#### **任务2.2**: 开发扣分计算服务 ✅
- **完成时间**: 2025-01-07 22:30:00
- **完成内容**:
- ✅ 计算服务接口：`IXskhDisciplineScoreCalculationService.java`（13个核心方法）
- ✅ 计算服务实现：`XskhDisciplineScoreCalculationServiceImpl.java`（684行完整算法）
- ✅ 扣分计算算法：支持固定分数和百分比两种模式
- ✅ 重复违纪处理：智能累计加重机制
- ✅ 历史记录管理：完整的计算审计追踪
#### **任务2.3**: 开发REST API控制器 ✅
- **完成时间**: 2025-01-07 23:00:00
- **完成内容**:
- ✅ 规则管理控制器：`XskhDisciplineScoreRuleController.java`（20个API接口）
- ✅ 计算管理控制器：`XskhDisciplineScoreCalculationController.java`（15个API接口）
- ✅ 权限控制完整：每个接口都有@SaCheckPermission注解
- ✅ 操作日志记录：关键操作都有@Log注解
- ✅ 参数校验完善：使用Bean Validation确保数据有效性
### **Day 5: 事件驱动机制开发 (已完成 100%)**
#### **任务3.1**: 创建违纪审批事件类 ✅
- **完成时间**: 2025-01-07 23:30:00
- **完成内容**:
- ✅ 事件类：`DisciplineApprovedEvent.java`（完整的事件数据结构）
- ✅ 包含必要字段：违纪记录ID、学生信息、违纪类型、审批状态等
- ✅ 线程安全设计：使用final字段和不可变对象
- ✅ 完善的toString方法：便于日志记录和调试
#### **任务3.2**: 开发事件监听器 ✅
- **完成时间**: 2025-01-07 23:45:00
- **完成内容**:
- ✅ 监听器：`DisciplineApprovedEventListener.java`（异步事件处理）
- ✅ 智能规则匹配：自动查找匹配的扣分规则
- ✅ 异步处理机制：使用@Async避免阻塞主流程
- ✅ 完善异常处理：事件处理失败不影响主业务
- ✅ 参数校验机制：确保事件数据完整性
#### **任务3.3**: 开发事件发布服务 ✅
- **完成时间**: 2025-01-08 00:00:00
- **完成内容**:
- ✅ 服务接口：`IXskhDisciplineEventService.java`（4个核心方法）
- ✅ 服务实现：`XskhDisciplineEventServiceImpl.java`（完整事件发布逻辑）
- ✅ 支持两种发布模式：完整版和简化版
- ✅ 批量发布能力：支持批量审批场景
- ✅ 统计监控功能：事件发布计数和状态监控
#### **任务3.4**: 创建事件管理API ✅
- **完成时间**: 2025-01-08 00:15:00
- **完成内容**:
- ✅ API控制器：`XskhDisciplineEventController.java`（7个API接口）
- ✅ 外部调用接口：HTTP API供其他模块调用
- ✅ 权限控制完整：每个接口都有权限注解
- ✅ 健康检查接口：服务状态监控
- ✅ 测试接口支持：便于集成测试
#### **任务3.5**: 集成说明文档 ✅
- **完成时间**: 2025-01-08 00:30:00
- **完成内容**:
- ✅ 集成说明：`事件驱动集成说明.md`（完整集成指南）
- ✅ API调用示例：HTTP和服务调用两种方式
- ✅ 参数说明文档：详细的参数类型和示例
- ✅ 集成代码示例：实际业务场景的集成代码
- ✅ 监控调试指南：问题排查和性能监控
### **Day 6: 前端管理界面开发 (已完成 100%)**
#### **任务4.1**: 扣分规则管理界面 ✅
- **完成时间**: 2025-01-08 01:00:00
- **完成内容**:
- ✅ 主界面：`web/src/views/xskh/deductionRule/index.vue`（完整的规则管理功能）
- ✅ 规则列表展示：支持分页、搜索、筛选
- ✅ 规则CRUD操作：新增、修改、删除、查看详情
- ✅ 冲突检测功能：智能检测规则冲突并提供处理建议
- ✅ 批量操作支持：批量启用、停用、删除
- ✅ 导出功能：支持Excel格式导出
- ✅ 完善的表单验证和用户体验优化
#### **任务4.2**: 扣分计算管理界面 ✅
- **完成时间**: 2025-01-08 01:15:00
- **完成内容**:
- ✅ 主界面：`web/src/views/xskh/deductionCalculation/index.vue`（完整的计算管理功能）
- ✅ 统计卡片展示：成功计算、计算失败、已撤销、总扣分等关键指标
- ✅ 计算记录管理：查看历史、重新计算、撤销操作
- ✅ 手动计算功能：支持手动触发计算
- ✅ 统计分析功能：ECharts图表展示趋势和分布
- ✅ 数据导出功能：支持多种格式导出
- ✅ 响应式设计和动画效果
#### **任务4.3**: 事件监控界面 ✅
- **完成时间**: 2025-01-08 01:30:00
- **完成内容**:
- ✅ 主界面：`web/src/views/xskh/disciplineEvent/index.vue`（完整的事件监控功能）
- ✅ 实时监控面板：服务状态、实时统计、异常监控三大模块
- ✅ 事件发布记录：支持查看、重新发布、取消事件
- ✅ 测试事件功能：支持发布测试事件验证系统
- ✅ 批量发布功能：支持批量发布违纪审批事件
- ✅ 健康检查功能：实时监控服务状态和性能指标
- ✅ 自动刷新机制：定时刷新监控数据
#### **任务4.4**: API接口和类型定义 ✅
- **完成时间**: 2025-01-08 01:45:00
- **完成内容**:
- ✅ 扣分规则API：`web/src/api/xskh/deductionRule/`（index.ts + types.ts）
- ✅ 扣分计算API：`web/src/api/xskh/deductionCalculation/`（index.ts + types.ts）
- ✅ 事件监控API：`web/src/api/xskh/disciplineEvent/`（index.ts + types.ts）
- ✅ 完整的TypeScript类型定义：Vo、Form、Query、Options等
- ✅ 统一的响应类型处理：R类型和TableDataInfo类型
- ✅ 完善的API方法：CRUD + 批量操作 + 统计分析等
### **技术亮点总结**
#### **A. 数据库设计优势**
- **🚀 避免ID冲突**: 使用20000+的ID范围，确保与其他模块不冲突
- **🎯 精确规则匹配**: 支持违纪类型+处分类型+适用范围的多维度匹配
- **📊 JSON灵活存储**: 适用年级/专业/学院使用JSON数组，支持动态扩展
- **⚡ 查询性能优化**: 3个复合索引覆盖常用查询场景
- **🔄 完整审计追踪**: 历史表记录每次计算的详细过程
#### **B. 代码质量保证**
- **✅ VO类基础字段规范**: 严格遵循项目规范，包含4个基础字段
- **🔒 参数校验完整**: 使用Bean Validation确保数据有效性
- **📱 前端友好**: VO类提供标签转换方法，便于前端显示
- **🔍 复杂查询支持**: MyBatis XML包含JSON查询、范围匹配等高级功能
#### **C. 扣分规则设计**
- **🎯 多样化规则**: 覆盖4大类违纪行为（校规校纪、考试违纪、学术不端、生活违纪）
- **📈 递进式处罚**: 扣分数从3分到30分，体现违纪严重程度
- **🔄 重复违纪加重**: 重复系数1.0-2.5倍，有效震慑作用
- **🛡️ 封顶保护**: 最大扣分限制，避免过度处罚
---
## 🚀 下一步开发计划
### **Day 3-4: 核心业务逻辑开发 (即将开始)**
#### **任务2.1**: 开发扣分规则服务 `XskhDisciplineScoreRuleService`
- **预计工时**: 1天
- **主要功能**:
- ✅ 规则CRUD管理
- ⏳ 规则匹配算法
- ⏳ 冲突检测机制
- ⏳ 批量操作支持
- **关键方法**:
```java
// 根据违纪情况获取匹配的扣分规则
XskhDisciplineScoreRuleVo getMatchingRule(Long disciplineTypeId, Long punishmentTypeId, String grade, String majorId, String collegeId);
// 检查规则冲突
List<XskhDisciplineScoreRuleVo> checkRuleConflicts(XskhDisciplineScoreRuleBo rule);
// 批量启用/禁用规则
Boolean updateBatchStatus(List<Long> ids, String isEnabled);
```
#### **任务2.2**: 开发扣分计算服务 `XskhDisciplineScoreCalculationService`
- **预计工时**: 1天
- **主要功能**:
- ⏳ 扣分数值计算算法
- ⏳ 历史违纪累计处理
- ⏳ 考核记录更新逻辑
- ⏳ 计算历史记录
- **核心算法**:
```java
// 计算具体扣分数值
BigDecimal calculateDeductionScore(XskhDisciplineScoreRuleVo rule, XskhAssessmentRecordVo record, List<XskhDisciplineRecordVo> historyRecords);
// 更新考核记录分数
Boolean updateAssessmentScore(Long assessmentRecordId, BigDecimal deductionScore);
// 重新计算总分和排名
Boolean recalculateTotalScoreAndRanking(Long planId);
```
### **Day 5: 事件驱动机制 (Week 1最后阶段)**
#### **任务3.1**: 创建违纪审批事件类 ✅
- **预计工时**: 0.25天
- **事件设计**:
```java
public class DisciplineApprovedEvent extends ApplicationEvent {
private Long disciplineRecordId;
private Long studentId;
private String approvalStatus;
private LocalDateTime approvalTime;
}
```
#### **任务3.2**: 开发事件监听器
- **预计工时**: 0.5天
- **异步处理**: 使用`@Async`注解避免阻塞主流程
- **容错机制**: 完善的异常处理和重试机制
#### **任务3.3**: 集成事件发布
- **预计工时**: 0.25天
- **修改目标**: `XskhDisciplineRecordServiceImpl.approveRecord`方法
- **触发条件**: 审批状态变更为"通过"时自动触发
---
## 📊 第一周预期成果
### **技术成果**
- ✅ 3个数据库表完整设计
- ✅ 5个Java类（实体+BO+VO+Mapper+XML）
- ✅ 2个核心业务服务（规则服务 + 计算服务）
- ✅ 2个REST API控制器（35个API接口）
- ✅ 1套事件驱动机制（事件类 + 监听器 + 发布服务 + API控制器）
- ✅ 完整的集成说明文档
- ✅ 3个前端管理界面（规则管理 + 计算管理 + 事件监控）
- ✅ 完整的前端API接口和类型定义
### **业务价值**
- ✅ 违纪处分自动影响考核结果（批量计算API + 事件驱动架构）
- ✅ 灵活的扣分规则配置（支持固定分数和百分比两种模式）
- ✅ 完整的操作审计追踪（历史记录表 + 计算详情JSON）
- ✅ 支持多维度适用范围（年级/专业/学院JSON配置）
### **质量指标**
- ⏳ 单次扣分计算响应时间 < 2秒
- ⏳ 代码覆盖率 > 80%
- ⏳ 无SQL注入和XSS漏洞
- ⏳ 完整的异常处理机制
---
## 🛠️ 技术实施细节
### **已完成的核心设计**
#### **1. 数据库表结构**
```sql
-- 核心扣分规则表（20个关键字段）
CREATE TABLE `xskh_discipline_score_rule` (
`id` bigint(20) NOT NULL COMMENT '主键ID',
`rule_code` varchar(32) NOT NULL COMMENT '规则编码',
`rule_name` varchar(100) NOT NULL COMMENT '规则名称',
`discipline_type_id` bigint(20) NOT NULL COMMENT '违纪类型ID',
`punishment_type_id` bigint(20) NOT NULL COMMENT '处分类型ID',
`deduction_score` decimal(5,2) NOT NULL COMMENT '基础扣分数',
`deduction_type` varchar(20) DEFAULT 'fixed' COMMENT '扣分类型',
`accumulate_rule` varchar(20) DEFAULT 'add' COMMENT '累计规则',
`max_deduction` decimal(5,2) COMMENT '最大扣分限制',
`repeat_factor` decimal(3,2) DEFAULT 1.00 COMMENT '重复违纪系数',
-- ... 其他字段
);
-- 考核记录表扩展（新增5个字段）
ALTER TABLE `xskh_assessment_record`
ADD COLUMN `discipline_deduction` decimal(5,2) DEFAULT 0.00 COMMENT '违纪扣分',
ADD COLUMN `discipline_count` int(11) DEFAULT 0 COMMENT '违纪次数',
ADD COLUMN `last_discipline_time` datetime COMMENT '最近违纪时间',
ADD COLUMN `score_details` json COMMENT '分数明细（JSON格式）',
ADD COLUMN `calculation_version` varchar(20) DEFAULT '1.0' COMMENT '计算版本号';
```
#### **2. MyBatis复杂查询**
```xml
<!-- 规则匹配查询（支持JSON字段匹配） -->
<select id="selectMatchingRules" parameterType="map" resultMap="XskhDisciplineScoreRuleResult">
SELECT * FROM xskh_discipline_score_rule
WHERE is_enabled = '1'
AND discipline_type_id = #{disciplineTypeId}
AND punishment_type_id = #{punishmentTypeId}
AND (applicable_grades IS NULL OR JSON_CONTAINS(applicable_grades, JSON_QUOTE(#{grade})))
ORDER BY priority DESC, sort_order ASC
</select>
```
#### **3. 实体类规范遵循**
```java
@Data
@EqualsAndHashCode(callSuper = true)
@TableName("xskh_discipline_score_rule")
public class XskhDisciplineScoreRule extends TenantEntity {
@TableId(value = "id")
private Long id;
// 业务字段...
// ===== VO类基础字段规范（强制性）=====
private Long createBy;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date createTime;
private Long updateBy;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date updateTime;
}
```
---
## 🔧 开发环境准备
### **数据库脚本执行**
```bash
# 1. 连接到项目数据库
mysql -h 47.99.164.66 -u username -p hzdyjs_xg
# 2. 执行建表脚本
source backend/ruoyi-modules/ruoyi-xskh/src/main/resources/sql/扣分规则配置表.sql
# 3. 验证表创建
SHOW TABLES LIKE 'xskh_discipline%';
SELECT COUNT(*) FROM xskh_discipline_score_rule;
```
### **代码编译验证**
```bash
# 1. 编译学生考核管理模块
cd backend/ruoyi-modules/ruoyi-xskh
mvn clean compile
# 2. 运行测试（后续添加）
mvn test
# 3. 打包验证
mvn package -DskipTests
```
---
## 📝 下周开发重点
### **Week 2: 管理界面和API接口开发**
- **Day 6-7**: 后端API完整实现
- **Day 8-9**: 前端界面开发
- **Day 10**: 集成测试和性能优化
### **Week 3: 增强功能开发**
- 计划模板管理
- 指标库标准化
- 动态权重配置
### **Week 4: 用户体验优化**
- 批量操作功能
- 数据可视化大屏
- 系统性能优化
---
**记录人**: 开发团队
**最后更新**: 2025-01-07 21:30:00
**下次更新**: 2025-01-08 18:00:00（Day 3进度）
docs/开发文档/考核计划和指标管理继续开发建议.md
-531
View File
@@ -1,531 +0,0 @@
# 考核计划和指标管理继续开发建议
## 📋 开发任务概述
**文档版本**: V1.0
**创建时间**: 2025-01-07
**目标**: 基于现有架构，继续完善考核计划管理和指标计划管理功能
---
## 🎯 近期开发重点（1-2周）
### 1. **考核计划管理功能完善**
#### **A. 计划模板管理**
```
优先级: 🔴 高
工作量: 3天
负责模块: 考核计划管理
```
**需求分析**:
- 支持将已有计划保存为模板
- 模板分类管理（按年级、专业、考核类型）
- 基于模板快速创建新计划
- 模板共享机制（部门间、学院间）
**实现方案**:
```sql
-- 新增计划模板表
CREATE TABLE `xskh_assessment_plan_template` (
`id` bigint(20) NOT NULL,
`template_code` varchar(32) NOT NULL,
`template_name` varchar(100) NOT NULL,
`template_desc` text,
`template_type` varchar(20) NOT NULL, -- semester, annual, special
`source_plan_id` bigint(20),
`applicable_scope` json, -- 适用范围
`usage_count` int(11) DEFAULT 0,
`is_public` char(1) DEFAULT '0', -- 是否公开
`template_config` json, -- 模板配置参数
PRIMARY KEY (`id`)
);
```
**前端功能**:
- 模板列表页面 `/xskh/assessmentPlan/template`
- 模板创建/编辑对话框
- 基于模板创建计划功能
- 模板使用统计界面
#### **B. 批量操作功能**
```
优先级: 🟡 中
工作量: 2天
负责模块: 考核计划管理
```
**功能清单**:
- 批量发布计划
- 批量归档计划
- 批量调整时间节点
- 批量通知相关人员
- 批量导出计划数据
**前端实现**:
```vue
<!-- 批量操作工具栏 -->
<el-button-group>
<el-button type="primary" :disabled="multiple" @click="handleBatchPublish">
批量发布
</el-button>
<el-button :disabled="multiple" @click="handleBatchArchive">
批量归档
</el-button>
<el-button :disabled="multiple" @click="handleBatchAdjustTime">
调整时间
</el-button>
</el-button-group>
```
### 2. **指标体系管理增强**
#### **A. 指标库标准化管理**
```
优先级: 🔴 高
工作量: 4天
负责模块: 指标管理
```
**功能需求**:
- 国家标准指标库预置
- 自定义指标库管理
- 指标导入导出功能
- 指标版本控制
- 指标使用历史追踪
**数据结构设计**:
```sql
-- 指标库分类表
CREATE TABLE `xskh_indicator_category` (
`id` bigint(20) NOT NULL,
`category_code` varchar(32) NOT NULL,
`category_name` varchar(100) NOT NULL,
`parent_id` bigint(20) DEFAULT 0,
`level` tinyint(1) DEFAULT 1,
`is_standard` char(1) DEFAULT '0', -- 是否国标
`description` text,
PRIMARY KEY (`id`)
);
-- 指标版本管理表
CREATE TABLE `xskh_indicator_version` (
`id` bigint(20) NOT NULL,
`indicator_id` bigint(20) NOT NULL,
`version_no` varchar(20) NOT NULL,
`version_desc` text,
`config_data` json, -- 版本配置数据
`is_current` char(1) DEFAULT '0',
`effective_date` date,
PRIMARY KEY (`id`)
);
```
#### **B. 动态权重配置**
```
优先级: 🟡 中
工作量: 3天
负责模块: 方案指标关联
```
**功能特性**:
- 按年级动态调整权重
- 按专业差异化配置
- 按时间段分阶段权重
- 权重配置模板化
- 权重变更历史记录
**前端实现**:
```vue
<!-- 动态权重配置组件 -->
<template>
<div class="weight-config">
<el-tabs v-model="activeTab" type="card">
<el-tab-pane label="按年级配置" name="grade">
<GradeWeightConfig v-model="gradeWeights" />
</el-tab-pane>
<el-tab-pane label="按专业配置" name="major">
<MajorWeightConfig v-model="majorWeights" />
</el-tab-pane>
<el-tab-pane label="按时间段配置" name="period">
<PeriodWeightConfig v-model="periodWeights" />
</el-tab-pane>
</el-tabs>
</div>
</template>
```
### 3. **违纪关联功能增强**
#### **A. 自动扣分计算**
```
优先级: 🔴 高
工作量: 3天
负责模块: 考核结果计算
```
**业务规则**:
- 不同违纪类型对应不同扣分标准
- 违纪严重程度影响扣分幅度
- 重复违纪累计扣分机制
- 改正表现可适当减分
**扣分规则配置表**:
```sql
CREATE TABLE `xskh_discipline_score_rule` (
`id` bigint(20) NOT NULL,
`discipline_type_id` bigint(20) NOT NULL,
`punishment_type_id` bigint(20) NOT NULL,
`severity_level` tinyint(1), -- 严重程度
`deduction_score` decimal(5,2) NOT NULL, -- 扣分数
`deduction_type` varchar(20) DEFAULT 'fixed', -- fixed, percentage
`accumulate_rule` varchar(20) DEFAULT 'add', -- add, multiply
`max_deduction` decimal(5,2), -- 最大扣分限制
`recovery_period` int(11), -- 恢复期（月）
`is_enabled` char(1) DEFAULT '1',
PRIMARY KEY (`id`)
);
```
#### **B. 考核结果联动更新**
```
优先级: 🔴 高
工作量: 2天
负责模块: 数据同步
```
**同步机制**:
- 违纪处分审批通过触发事件
- 异步更新相关考核记录
- 重新计算综合得分和排名
- 发送变更通知
**事件处理服务**:
```java
@Component
public class DisciplineAssessmentSyncService {
@EventListener
@Async
public void handleDisciplineApproved(DisciplineApprovedEvent event) {
// 1. 查询受影响的考核计划
List<Long> planIds = getAffectedPlans(event.getStudentId());
// 2. 重新计算考核分数
for (Long planId : planIds) {
recalculateAssessmentScore(event.getStudentId(), planId);
}
// 3. 更新排名
updateRankings(planIds);
// 4. 发送通知
sendUpdateNotification(event.getStudentId(), planIds);
}
}
```
---
## 🚀 中期开发规划（3-4周）
### 1. **智能化功能开发**
#### **A. 智能指标推荐**
```
优先级: 🟡 中
工作量: 5天
技术栈: Python + 机器学习
```
**功能设计**:
- 基于历史数据分析指标有效性
- 根据专业特点推荐适合的指标
- 智能权重分配建议
- 指标配置效果预测
**算法模型**:
```python
# 指标推荐算法
class IndicatorRecommendationModel:
def __init__(self):
self.model = RandomForestClassifier()
def train(self, historical_data):
# 特征工程：专业、年级、指标类型、权重、效果
features = self.extract_features(historical_data)
labels = self.extract_labels(historical_data)
self.model.fit(features, labels)
def recommend_indicators(self, scheme_config):
# 推荐适合的指标组合
predictions = self.model.predict_proba(scheme_config)
return self.rank_indicators(predictions)
```
#### **B. 考核数据分析大屏**
```
优先级: 🟡 中
工作量: 4天
技术栈: Vue 3 + ECharts + WebSocket
```
**功能模块**:
- 实时考核进度监控
- 各学院完成情况对比
- 指标得分分布分析
- 违纪趋势预警显示
- 考核质量评估报告
**大屏组件结构**:
```vue
<template>
<div class="assessment-dashboard">
<el-row :gutter="20">
<el-col :span="8">
<ProgressOverview />
</el-col>
<el-col :span="8">
<CollegeComparison />
</el-col>
<el-col :span="8">
<DisciplineTrend />
</el-col>
</el-row>
<el-row :gutter="20" class="mt-4">
<el-col :span="12">
<ScoreDistribution />
</el-col>
<el-col :span="12">
<QualityAssessment />
</el-col>
</el-row>
</div>
</template>
```
### 2. **移动端功能开发**
#### **A. 移动端考核管理**
```
优先级: 🟡 中
工作量: 6天
技术栈: uni-app + uview-plus
```
**功能清单**:
- 考核计划查看和管理
- 移动端指标配置（简化版）
- 考核进度实时查看
- 移动端审批功能
- 消息通知推送
**移动端页面结构**:
```
mobile/src/pages/assessment/
├── index.vue # 考核首页
├── plan-list.vue # 计划列表
├── plan-detail.vue # 计划详情
├── indicator-config.vue # 指标配置
├── progress-view.vue # 进度查看
└── approval.vue # 移动审批
```
#### **B. 微信小程序集成**
```
优先级: 🟢 低
工作量: 4天
技术栈: uni-app 微信小程序
```
**小程序功能**:
- 考核通知接收
- 简单数据查询
- 扫码快速操作
- 语音录入支持
---
## 🔧 技术优化方案
### 1. **性能优化**
#### **A. 缓存策略优化**
```java
@Configuration
public class AssessmentCacheConfig {
@Bean
public CacheManager cacheManager() {
RedisCacheManager.Builder builder = RedisCacheManager
.RedisCacheManagerBuilder
.fromConnectionFactory(redisConnectionFactory())
.cacheDefaults(cacheConfiguration());
return builder.build();
}
private RedisCacheConfiguration cacheConfiguration() {
return RedisCacheConfiguration.defaultCacheConfig()
.entryTtl(Duration.ofHours(1)) // 1小时过期
.serializeKeysWith(RedisSerializationContext.SerializationPair
.fromSerializer(new StringRedisSerializer()))
.serializeValuesWith(RedisSerializationContext.SerializationPair
.fromSerializer(new GenericJackson2JsonRedisSerializer()));
}
}
```
**缓存策略**:
- 指标配置信息：缓存1小时
- 方案数据：缓存30分钟
- 计划状态：实时更新，短期缓存
- 统计数据：缓存5分钟
#### **B. 数据库优化**
```sql
-- 关键索引优化
CREATE INDEX idx_plan_scheme_status ON xskh_assessment_plan(scheme_id, status);
CREATE INDEX idx_indicator_type_status ON xskh_assessment_indicator(indicator_type, status);
CREATE INDEX idx_scheme_indicator_weight ON xskh_scheme_indicator(scheme_id, weight);
CREATE INDEX idx_discipline_student_date ON xskh_discipline_record(student_id, discipline_date);
-- 分区表设计（大数据量时）
CREATE TABLE `xskh_assessment_record_2025` (
-- 继承主表结构
) PARTITION BY RANGE (YEAR(create_time)) (
PARTITION p2025 VALUES LESS THAN (2026),
PARTITION p2026 VALUES LESS THAN (2027)
);
```
### 2. **并发处理优化**
#### **A. 分布式锁实现**
```java
@Service
public class AssessmentLockService {
@Autowired
private RedisTemplate<String, String> redisTemplate;
public boolean tryLock(String lockKey, long timeout) {
String lockValue = UUID.randomUUID().toString();
Boolean result = redisTemplate.opsForValue()
.setIfAbsent(lockKey, lockValue, timeout, TimeUnit.SECONDS);
return Boolean.TRUE.equals(result);
}
public void releaseLock(String lockKey, String lockValue) {
String script = "if redis.call('get', KEYS[1]) == ARGV[1] then " +
"return redis.call('del', KEYS[1]) else return 0 end";
redisTemplate.execute(new DefaultRedisScript<>(script, Long.class),
Arrays.asList(lockKey), lockValue);
}
}
```
#### **B. 异步任务处理**
```java
@Component
public class AssessmentAsyncService {
@Async("assessmentTaskExecutor")
public CompletableFuture<Void> calculateBatchScores(List<Long> studentIds, Long planId) {
for (Long studentId : studentIds) {
try {
calculateStudentScore(studentId, planId);
} catch (Exception e) {
log.error("计算学生{}考核分数失败", studentId, e);
}
}
return CompletableFuture.completedFuture(null);
}
}
```
---
## 📊 数据结构扩展建议
### 1. **考核结果记录表增强**
```sql
-- 扩展考核记录表
ALTER TABLE `xskh_assessment_record` ADD COLUMN `score_details` json COMMENT '分数明细（JSON）';
ALTER TABLE `xskh_assessment_record` ADD COLUMN `discipline_deduction` decimal(5,2) DEFAULT 0.00 COMMENT '违纪扣分';
ALTER TABLE `xskh_assessment_record` ADD COLUMN `bonus_score` decimal(5,2) DEFAULT 0.00 COMMENT '加分';
ALTER TABLE `xskh_assessment_record` ADD COLUMN `final_rank` int(11) COMMENT '最终排名';
ALTER TABLE `xskh_assessment_record` ADD COLUMN `rank_level` varchar(20) COMMENT '等级（优秀、良好、合格、不合格）';
```
### 2. **新增审计日志表**
```sql
CREATE TABLE `xskh_assessment_audit_log` (
`id` bigint(20) NOT NULL,
`tenant_id` varchar(20) NOT NULL DEFAULT '000000',
`operation_type` varchar(20) NOT NULL, -- CREATE, UPDATE, DELETE, APPROVE
`table_name` varchar(50) NOT NULL,
`record_id` bigint(20) NOT NULL,
`old_data` json,
`new_data` json,
`operator_id` bigint(20),
`operator_name` varchar(50),
`operation_time` datetime DEFAULT CURRENT_TIMESTAMP,
`client_ip` varchar(50),
`user_agent` varchar(500),
`remark` varchar(500),
PRIMARY KEY (`id`),
KEY `idx_table_record` (`table_name`, `record_id`),
KEY `idx_operation_time` (`operation_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='考核管理审计日志表';
```
---
## 🎯 开发优先级建议
### **第一阶段（立即开始）- 核心功能完善**
1. ✅ 自动扣分计算功能
2. ✅ 考核结果联动更新
3. ✅ 计划模板管理
4. ✅ 指标库标准化管理
### **第二阶段（2周后）- 用户体验提升**
1. 🔄 批量操作功能
2. 🔄 动态权重配置
3. 🔄 数据分析大屏
4. 🔄 移动端基础功能
### **第三阶段（1个月后）- 智能化增强**
1. 🔮 智能指标推荐
2. 🔮 预测分析功能
3. 🔮 微信小程序集成
4. 🔮 高级数据可视化
---
## 📝 开发注意事项
### **代码规范**
- 严格遵循项目现有的编码规范
- 所有VO类必须包含统一的基础字段
- 数据库变更必须同步更新相关文档
- API接口必须包含完整的权限注解
### **测试要求**
- 单元测试覆盖率不低于80%
- 集成测试覆盖主要业务流程
- 性能测试关注大数据量场景
- 安全测试重点关注权限控制
### **文档同步**
- 每个功能完成后立即更新API文档
- 数据库变更必须更新设计文档
- 重要业务逻辑变更需要更新业务文档
- 所有变更记录在变更管理文档中
---
**文档维护人**: Cursor AI
**最后更新**: 2025-01-07 18:30:00
**下次更新计划**: 开发进展后定期更新
docs/开发文档/考核计划管理和指标计划管理实现分析报告.md
-431
View File
@@ -1,431 +0,0 @@
# 考核计划管理和指标计划管理实现分析报告
## 📋 报告概述
**分析日期**: 2025-01-07
**分析内容**: 考核计划管理、指标计划管理的实现方式及其与违纪处分申请的关联关系
**技术架构**: 前后端分离，Spring Boot + Vue 3 + Element Plus
---
## 🏗️ 整体架构分析
### 1. **核心实体关系图**
```mermaid
graph TD
A[考核方案 XskhAssessmentScheme] --> B[考核计划 XskhAssessmentPlan]
C[测评指标 XskhAssessmentIndicator] --> D[方案指标关联 XskhSchemeIndicator]
A --> D
B --> E[学生评价记录 XskhAssessmentRecord]
F[违纪处分申请 XskhDisciplineApplication] --> G[违纪处分记录 XskhDisciplineRecord]
G --> H[考核结果计算]
E --> H
D --> E
```
### 2. **系统模块结构**
#### **前端模块结构**
```
web/src/views/xskh/
├── index.vue # 学生考核管理主页面（Dashboard）
├── assessmentPlan/ # 考核计划管理
│ └── index.vue # 计划列表、新增、编辑
├── indicator/ # 测评指标管理
│ └── index.vue # 指标体系管理
├── scheme/ # 考核方案管理
│ └── index.vue # 方案配置
├── schemeIndicator/ # 方案指标关联管理
│ └── index.vue # 指标权重配置
├── disciplineApplication/ # 违纪处分申请
├── disciplineApproval/ # 违纪处分审批
└── disciplineRecord/ # 违纪处分记录
```
#### **后端模块结构**
```
backend/ruoyi-modules/ruoyi-xskh/
├── domain/
│ ├── XskhAssessmentPlan.java # 考核计划实体
│ ├── XskhAssessmentIndicator.java # 测评指标实体
│ ├── XskhSchemeIndicator.java # 方案指标关联实体
│ └── XskhDisciplineRecord.java # 违纪处分记录实体
├── controller/
├── service/
└── mapper/
```
---
## 📊 考核计划管理实现分析
### 1. **数据模型设计**
#### **XskhAssessmentPlan 考核计划表**
```sql
CREATE TABLE `xskh_assessment_plan` (
-- 基础信息
`plan_code` varchar(32) NOT NULL, -- 计划编号（PLAN202501001）
`plan_name` varchar(100) NOT NULL, -- 计划名称
`plan_desc` text, -- 计划描述
`scheme_id` bigint(20) NOT NULL, -- 关联方案ID ⭐
`scheme_name` varchar(100), -- 关联方案名称
`plan_cycle` varchar(50) NOT NULL, -- 计划周期
-- 时间配置
`start_date` date NOT NULL, -- 计划开始日期
`end_date` date NOT NULL, -- 计划结束日期
`self_eval_start_time` datetime, -- 自评开始时间
`self_eval_end_time` datetime, -- 自评结束时间
`teacher_eval_start_time` datetime, -- 教师评价开始时间
`teacher_eval_end_time` datetime, -- 教师评价结束时间
-- 目标范围（JSON格式）
`target_grades` json, -- 目标年级
`target_majors` json, -- 目标专业
`target_colleges` json, -- 目标学院
`student_types` json, -- 学生类型
-- 统计数据
`total_students` int(11), -- 参与学生总数
`completed_students` int(11), -- 已完成学生数
`approved_students` int(11), -- 已审核学生数
`avg_score` decimal(5,2), -- 平均分
-- 状态控制
`status` varchar(20), -- 计划状态
`is_published` char(1), -- 是否发布
`workflow_enabled` char(1), -- 是否启用工作流
`approval_required` char(1) -- 是否需要审核
);
```
### 2. **核心功能实现**
#### **A. 计划生命周期管理**
- **状态流转**: 草稿 → 发布 → 进行中 → 已结束 → 已归档
- **时间控制**: 严格的时间节点控制，自评期、互评期、教师评价期
- **权限控制**: 基于角色的操作权限（创建、审核、发布）
#### **B. 前端关键实现**
```vue
<!-- 计划状态显示 -->
<el-tag :type="getStatusType(scope.row.planStatus)">
{{ getStatusLabel(scope.row.planStatus) }}
</el-tag>
<!-- 进度条显示 -->
<el-progress
:percentage="scope.row.completionRate"
:color="getProgressColor(scope.row.completionRate)"
/>
```
#### **C. 后端API设计**
- `GET /xskh/assessmentPlan/list` - 计划列表查询
- `POST /xskh/assessmentPlan` - 新增计划
- `PUT /xskh/assessmentPlan` - 更新计划
- `POST /xskh/assessmentPlan/publish/{id}` - 发布计划
- `POST /xskh/assessmentPlan/copy/{id}` - 复制计划
---
## 🎯 指标计划管理实现分析
### 1. **数据模型设计**
#### **XskhAssessmentIndicator 测评指标表**
```sql
CREATE TABLE `xskh_assessment_indicator` (
-- 基础信息
`indicator_code` varchar(32) NOT NULL, -- 指标编码（唯一标识）
`indicator_name` varchar(100) NOT NULL, -- 指标名称
`indicator_desc` text, -- 指标描述说明
`indicator_type` varchar(20) NOT NULL, -- 指标类型（五育分类）
-- 层级结构
`parent_id` bigint(20) DEFAULT 0, -- 父级指标ID
`level` tinyint(1) DEFAULT 1, -- 层级（1-3级）
`sort_order` int(11) DEFAULT 0, -- 排序号
-- 评分配置
`score_type` varchar(20) DEFAULT 'fixed', -- 评分类型
`max_score` decimal(5,2) DEFAULT 100.00, -- 最高分值
`min_score` decimal(5,2) DEFAULT 0.00, -- 最低分值
`default_score` decimal(5,2) DEFAULT 0.00, -- 默认分值
`weight` decimal(5,4) DEFAULT 1.0000, -- 权重系数
-- 评分标准
`scoring_criteria` text, -- 评分标准（JSON格式）
`scoring_method` varchar(20) DEFAULT 'manual', -- 评分方式
`calculation_formula` text, -- 计算公式
-- 适用范围
`applicable_grades` json, -- 适用年级
`applicable_majors` json, -- 适用专业
`applicable_colleges` json, -- 适用学院
-- 状态控制
`status` char(1) DEFAULT '1', -- 启用状态
`is_published` char(1) DEFAULT '0', -- 发布状态
`is_required` char(1) DEFAULT '1', -- 是否必填
`is_visible` char(1) DEFAULT '1' -- 是否可见
);
```
#### **XskhSchemeIndicator 方案指标关联表**
```sql
CREATE TABLE `xskh_scheme_indicator` (
-- 关联信息
`scheme_id` bigint(20) NOT NULL, -- 方案ID ⭐
`indicator_id` bigint(20) NOT NULL, -- 指标ID ⭐
`indicator_code` varchar(32) NOT NULL, -- 指标编码
`indicator_name` varchar(100) NOT NULL, -- 指标名称
-- 权重配置
`weight` decimal(3,2) DEFAULT 1.00, -- 在方案中的权重
`max_score` decimal(5,2) NOT NULL, -- 在方案中的满分
`min_score` decimal(5,2) DEFAULT 0.00, -- 在方案中的最低分
`default_score` decimal(5,2) DEFAULT 0.00, -- 默认分数
-- 配置选项
`is_required` char(1) DEFAULT '1', -- 是否必填
`is_visible` char(1) DEFAULT '1', -- 是否可见
`sort_order` int(11) DEFAULT 0, -- 排序号
`effective_date` date, -- 生效日期
`expiry_date` date -- 失效日期
);
```
### 2. **指标体系特点**
#### **A. 五育并举指标分类**
```javascript
const indicatorTypes = {
'moral': '德育指标', // 思想品德、社会实践、志愿服务
'intellectual': '智育指标', // 学业成绩、学科竞赛、科研项目
'physical': '体育指标', // 体能测试、体育竞赛、日常锻炼
'aesthetic': '美育指标', // 艺术活动、作品创作
'labor': '劳育指标' // 劳动实践、勤工俭学
}
```
#### **B. 层级化指标结构**
- **一级指标**: 大类指标（如：思想品德表现）
- **二级指标**: 细分指标（如：政治理论学习）
- **三级指标**: 具体考核点（如：党课学习次数）
#### **C. 灵活的评分机制**
```json
{
"scoring_criteria": {
"excellent": {"score": "18-20", "desc": "表现优秀"},
"good": {"score": "15-17", "desc": "表现良好"},
"average": {"score": "10-14", "desc": "表现一般"},
"poor": {"score": "0-9", "desc": "表现较差"}
}
}
```
### 3. **前端实现特点**
#### **A. 树形结构展示**
```vue
<el-table-tree-column
prop="indicatorName"
label="指标名称"
treeKey="id"
parentKey="parentId"
:expand-all="false"
/>
```
#### **B. 权重配置界面**
```vue
<el-input-number
v-model="form.weight"
:min="0"
:max="1"
:step="0.01"
:precision="2"
placeholder="请输入权重"
/>
```
---
## 🔗 与违纪处分申请的关联关系
### 1. **直接关联**
#### **A. 综合测评影响机制**
```sql
-- 违纪处分对考核结果的影响
SELECT
ar.student_id,
ar.total_score,
dr.punishment_type_name,
dr.affects_scholarship,
dr.affects_graduation
FROM xskh_assessment_record ar
LEFT JOIN xskh_discipline_record dr ON ar.student_id = dr.student_id
WHERE dr.record_status = 'effective'
AND ar.assessment_plan_id = ?
```
#### **B. 扣分机制实现**
- **违纪扣分指标**: 系统中设置专门的违纪扣分指标
- **自动计算**: 根据违纪处分记录自动计算扣分
- **影响评级**: 违纪记录影响奖学金、评优等
### 2. **业务流程关联**
#### **A. 考核计划执行中的违纪处理**
```mermaid
graph LR
A[考核计划执行] --> B[发现违纪行为]
B --> C[提交违纪处分申请]
C --> D[审批流程]
D --> E[生成处分记录]
E --> F[更新考核结果]
F --> G[重新计算排名]
```
#### **B. 数据同步机制**
- **实时更新**: 违纪处分审批通过后，立即更新相关考核记录
- **历史追溯**: 保留完整的分数变更历史
- **权限控制**: 只有授权人员可以处理违纪相关的考核调整
### 3. **代码实现示例**
#### **A. 考核结果计算服务**
```java
@Service
public class AssessmentCalculationService {
/**
* 计算学生综合测评分数（包含违纪扣分）
*/
public BigDecimal calculateTotalScore(Long studentId, Long planId) {
// 1. 计算基础分数
BigDecimal baseScore = calculateBaseScore(studentId, planId);
// 2. 计算违纪扣分
BigDecimal disciplineDeduction = calculateDisciplineDeduction(studentId, planId);
// 3. 计算最终分数
return baseScore.subtract(disciplineDeduction);
}
/**
* 计算违纪扣分
*/
private BigDecimal calculateDisciplineDeduction(Long studentId, Long planId) {
// 查询有效的违纪处分记录
List<XskhDisciplineRecord> records = disciplineRecordService
.getEffectiveRecordsByStudent(studentId, planId);
return records.stream()
.map(record -> getDisciplineScore(record.getPunishmentTypeCode()))
.reduce(BigDecimal.ZERO, BigDecimal::add);
}
}
```
#### **B. 前端联动更新**
```javascript
// 违纪处分审批通过后的回调
async handleApprovalSuccess(disciplineId) {
// 1. 刷新违纪记录
await this.refreshDisciplineRecords();
// 2. 触发考核结果重新计算
await this.recalculateAssessmentScores(disciplineId);
// 3. 更新相关页面数据
this.$emit('assessment-updated');
this.$message.success('审批完成，考核结果已自动更新');
}
```
---
## 🎯 继续开发建议
### 1. **功能增强方向**
#### **A. 考核计划管理优化**
- **模板化管理**: 支持计划模板保存和复用
- **批量操作**: 支持批量发布、批量归档
- **进度监控**: 实时监控各学院完成进度
- **预警机制**: 逾期未完成自动预警
#### **B. 指标体系完善**
- **指标库管理**: 建设标准指标库，支持导入导出
- **动态权重**: 支持按年级、专业动态调整权重
- **智能推荐**: 基于历史数据推荐合适的指标配置
- **效果评估**: 指标使用效果分析和优化建议
#### **C. 违纪关联增强**
- **预测分析**: 基于违纪记录预测考核风险
- **趋势分析**: 违纪行为对考核结果的影响趋势
- **早期预警**: 违纪倾向早期识别和干预
- **改进跟踪**: 处分后学生表现改进情况跟踪
### 2. **技术架构优化**
#### **A. 性能优化**
- **缓存策略**: Redis缓存热点数据（指标配置、方案信息）
- **异步计算**: 大批量考核结果计算采用异步处理
- **数据分页**: 大数据量查询优化
- **索引优化**: 关键查询字段建立联合索引
#### **B. 数据一致性**
- **事务管理**: 确保违纪处分和考核结果更新的事务一致性
- **分布式锁**: 并发场景下的数据更新控制
- **数据校验**: 多层次数据校验机制
- **回滚机制**: 支持错误操作的数据回滚
### 3. **用户体验提升**
#### **A. 界面交互优化**
- **响应式设计**: 移动端适配优化
- **批量操作**: 简化批量数据处理流程
- **快捷操作**: 常用操作快捷键支持
- **状态提示**: 实时操作状态反馈
#### **B. 数据可视化**
- **考核大屏**: 实时考核数据大屏展示
- **趋势图表**: 各类指标变化趋势图
- **对比分析**: 不同维度的数据对比分析
- **导出报表**: 多格式考核报表导出
---
## 📋 总结
### **系统优势**
1. **架构清晰**: 模块化设计，职责分明
2. **数据完整**: 完善的数据模型设计
3. **功能齐全**: 涵盖考核全流程管理
4. **扩展性强**: 支持灵活的指标配置和权重调整
### **待完善点**
1. **性能优化**: 大数据量处理性能有待提升
2. **用户体验**: 部分操作流程可以进一步简化
3. **智能化**: 缺少AI辅助决策功能
4. **移动端**: 移动端功能需要进一步完善
### **发展方向**
1. **智能化**: 引入AI算法进行智能评价和预测
2. **个性化**: 支持个性化的指标配置和评价标准
3. **协同化**: 加强与其他业务系统的集成
4. **标准化**: 建立行业标准的指标体系和评价模式
---
**报告生成时间**: 2025-01-07 18:00:00
**分析人员**: Cursor AI
**版本**: V1.0
docs/开发文档/考核计划管理评分标准配置功能实现报告.md
-353
View File
@@ -1,353 +0,0 @@
# 考核计划管理评分标准配置功能实现报告
## 📋 概述信息
| 项目 | 信息 |
|------|------|
| **实现时间** | 2025-01-27 |
| **功能模块** | 考核计划管理 - 评分标准配置 |
| **实现范围** | 后端API + 前端界面 + 权限配置 |
| **状态** | ✅ 基础功能已完成 |
---
## 🎯 功能特性
### ✅ **已实现功能**
#### 1. **评分标准配置选项**
- ✅ **基础分数配置**：80-120分，步长5分
- ✅ **及格分数配置**：50-70分，步长5分
- ✅ **优秀分数配置**：80-95分，步长5分
- ✅ **违纪扣分权重**：0.5-1.5倍，步长0.1
- ✅ **加分项权重**：0.5-1.5倍，步长0.1
- ✅ **自动扣分开关**：启用/停用
- ✅ **加分项开关**：启用/停用
#### 2. **配置操作功能**
- ✅ **单个计划配置**：点击"评分配置"按钮
- ✅ **批量计划配置**：选择多个计划批量配置
- ✅ **配置预览功能**：显示配置摘要和影响范围
- ✅ **重置默认值**：一键恢复默认配置
- ✅ **配置状态显示**：表格中显示评分标准状态
#### 3. **用户体验优化**
- ✅ **下拉选择配置**：无需手动输入，避免错误
- ✅ **实时配置预览**：直观显示配置效果
- ✅ **批量操作提示**：显示影响的计划数量
- ✅ **配置状态标签**：快速识别配置状态
---
## 💻 技术实现详情
### 1. **数据库表结构修改**
#### 1.1 新增字段 (`xskh_assessment_plan`)
```sql
-- 评分标准配置字段
ALTER TABLE xskh_assessment_plan ADD COLUMN base_score DECIMAL(5,2) DEFAULT 100.00 COMMENT '基础分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN pass_score DECIMAL(5,2) DEFAULT 60.00 COMMENT '及格分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN excellent_score DECIMAL(5,2) DEFAULT 85.00 COMMENT '优秀分数';
ALTER TABLE xskh_assessment_plan ADD COLUMN auto_deduct_enabled CHAR(1) DEFAULT '1' COMMENT '是否启用自动扣分';
ALTER TABLE xskh_assessment_plan ADD COLUMN bonus_enabled CHAR(1) DEFAULT '1' COMMENT '是否启用加分项';
ALTER TABLE xskh_assessment_plan ADD COLUMN discipline_weight DECIMAL(3,2) DEFAULT 1.00 COMMENT '违纪扣分权重';
ALTER TABLE xskh_assessment_plan ADD COLUMN bonus_weight DECIMAL(3,2) DEFAULT 1.00 COMMENT '加分项权重';
```
### 2. **后端代码实现**
#### 2.1 实体类修改
**文件**: `XskhAssessmentPlan.java`
```java
// 新增评分标准配置字段
private BigDecimal baseScore; // 基础分数
private BigDecimal passScore; // 及格分数
private BigDecimal excellentScore; // 优秀分数
private String autoDeductEnabled; // 是否启用自动扣分
private String bonusEnabled; // 是否启用加分项
private BigDecimal disciplineWeight; // 违纪扣分权重
private BigDecimal bonusWeight; // 加分项权重
```
#### 2.2 新增API接口
**文件**: `XskhAssessmentPlanController.java`
```java
// 评分标准配置相关接口
@GetMapping("/scoreOptions") // 获取配置选项
@PutMapping("/batchScoreConfig") // 批量配置评分标准
@PostMapping("/previewScoreConfig") // 预览配置
@PutMapping("/resetScoreConfig/{id}") // 重置默认值
@GetMapping("/scoreConfig/{id}") // 获取计划配置
```
#### 2.3 业务逻辑实现
**文件**: `XskhAssessmentPlanServiceImpl.java`
```java
// 核心方法实现
getScoreOptions() // 提供下拉选择选项
batchScoreConfig() // 批量更新配置
previewScoreConfig() // 生成配置预览
resetScoreConfig() // 重置为默认值
getScoreConfig() // 获取当前配置
```
### 3. **前端界面实现**
#### 3.1 表格功能增强
**文件**: `web/src/views/xskh/assessmentPlan/index.vue`
```vue
<!-- 新增评分标准列 -->
<el-table-column label="评分标准" align="center" width="120">
<template #default="scope">
<el-tag v-if="scope.row.baseScore" type="success" size="small">
基础{{ scope.row.baseScore }}分
</el-tag>
<el-tag v-else type="info" size="small">未配置</el-tag>
</template>
</el-table-column>
<!-- 新增评分配置按钮 -->
<el-tooltip content="评分配置" placement="top">
<el-button link type="warning" icon="Setting"
@click="handleScoreConfig(scope.row)"
v-hasPermi="['xskh:assessmentPlan:scoreConfig']">
</el-button>
</el-tooltip>
```
#### 3.2 工具栏增强
```vue
<!-- 批量配置按钮 -->
<el-button type="primary" plain icon="Setting"
:disabled="multiple"
@click="handleBatchScoreConfig"
v-hasPermi="['xskh:assessmentPlan:batchScoreConfig']">
批量配置评分
</el-button>
```
#### 3.3 配置对话框
```vue
<!-- 单个计划配置对话框 -->
<el-dialog title="评分标准配置" v-model="scoreConfigDialog.visible" width="700px">
<!-- 基础分数、及格分数、优秀分数等配置项 -->
</el-dialog>
<!-- 批量配置对话框 -->
<el-dialog title="批量配置评分标准" v-model="batchScoreDialog.visible" width="700px">
<!-- 批量配置表单 -->
</el-dialog>
```
### 4. **权限配置**
#### 4.1 新增权限项
**文件**: `backend/sql/考核计划管理评分标准配置权限.sql`
```sql
-- 评分标准配置权限 (ID: 9816-9819)
INSERT INTO sys_menu VALUES
(9816, '评分标准配置', 9800, 16, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:scoreConfig', '#'),
(9817, '批量配置评分标准', 9800, 17, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:batchScoreConfig', '#'),
(9818, '重置评分标准', 9800, 18, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:resetScore', '#'),
(9819, '预览评分配置', 9800, 19, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:previewScore', '#');
```
---
## 🎨 用户界面设计
### 1. **配置选项设计**
#### 基础分数配置
```
下拉选择：80分、85分、90分、95分、100分、105分、110分、115分、120分
默认值：100分
```
#### 及格分数配置
```
下拉选择：50分、55分、60分、65分、70分
默认值：60分
```
#### 优秀分数配置
```
下拉选择：80分、85分、90分、95分
默认值：85分
```
#### 权重配置
```
下拉选择：0.5倍、0.6倍、0.7倍、0.8倍、0.9倍、1.0倍、1.1倍、1.2倍、1.3倍、1.4倍、1.5倍
默认值：1.0倍
```
### 2. **操作流程设计**
#### 单个计划配置流程
```
1. 点击表格行的"评分配置"按钮
2. 弹出配置对话框，显示当前配置
3. 通过下拉选择修改配置项
4. 点击"确定"保存，或"重置默认"恢复默认值
5. 配置成功后刷新表格显示
```
#### 批量配置流程
```
1. 勾选多个计划行
2. 点击工具栏"批量配置评分"按钮
3. 弹出批量配置对话框，显示影响的计划数量
4. 配置评分标准参数
5. 点击"确定"批量应用配置
6. 显示成功消息和影响的计划数量
```
---
## 📊 配置选项说明
### 1. **评分标准配置**
| 配置项 | 选项范围 | 默认值 | 说明 |
|--------|----------|--------|------|
| **基础分数** | 80-120分 | 100分 | 学生综合测评的基础分数 |
| **及格分数** | 50-70分 | 60分 | 及格线标准 |
| **优秀分数** | 80-95分 | 85分 | 优秀等级标准 |
| **违纪扣分权重** | 0.5-1.5倍 | 1.0倍 | 违纪扣分的权重系数 |
| **加分项权重** | 0.5-1.5倍 | 1.0倍 | 加分项的权重系数 |
| **自动扣分** | 启用/停用 | 启用 | 是否自动计算违纪扣分 |
| **加分项** | 启用/停用 | 启用 | 是否启用加分项功能 |
### 2. **配置应用规则**
#### 分数计算公式
```
最终分数 = 基础分数 + (加分项 × 加分权重) - (违纪扣分 × 扣分权重)
```
#### 等级评定标准
```
优秀：>= 优秀分数
良好：>= 及格分数 且 < 优秀分数
及格：>= 及格分数
不及格：< 及格分数
```
---
## ✅ 测试验证
### 1. **功能测试项**
#### 基础功能测试
- ✅ 单个计划评分配置
- ✅ 批量计划评分配置
- ✅ 配置选项正确显示
- ✅ 默认值重置功能
- ✅ 配置状态显示
#### 权限测试
- ✅ 评分配置权限控制
- ✅ 批量配置权限控制
- ✅ 重置配置权限控制
#### 数据验证测试
- ✅ 配置数据正确保存
- ✅ 批量更新数据一致性
- ✅ 默认值重置正确性
### 2. **用户体验测试**
#### 界面交互测试
- ✅ 下拉选择操作流畅
- ✅ 对话框显示正确
- ✅ 加载状态提示清晰
- ✅ 成功/失败消息准确
#### 性能测试
- ✅ 配置选项加载快速
- ✅ 批量配置响应及时
- ✅ 表格刷新性能良好
---
## 🚀 部署说明
### 1. **数据库升级**
#### 执行顺序
```sql
-- 1. 执行表结构修改
backend/sql/xskh_discipline_system_upgrade.sql
-- 2. 执行权限配置
backend/sql/考核计划管理评分标准配置权限.sql
```
### 2. **代码部署**
#### 后端部署
```
1. 更新实体类：XskhAssessmentPlan.java
2. 更新BO类：XskhAssessmentPlanBo.java
3. 更新VO类：XskhAssessmentPlanVo.java
4. 更新Controller：XskhAssessmentPlanController.java
5. 更新Service：XskhAssessmentPlanServiceImpl.java
```
#### 前端部署
```
1. 更新API接口：web/src/api/xskh/assessmentPlan.ts
2. 更新页面组件：web/src/views/xskh/assessmentPlan/index.vue
```
### 3. **验证步骤**
#### 功能验证
```
1. 登录系统，进入考核计划管理
2. 验证表格显示评分标准列
3. 点击"评分配置"按钮，验证对话框正常显示
4. 修改配置项，验证保存成功
5. 选择多个计划，验证批量配置功能
6. 验证重置默认值功能
```
#### 权限验证
```
1. 使用管理员账号验证所有功能可用
2. 使用普通用户验证权限控制生效
3. 验证按钮权限控制正确
```
---
## 📞 总结
### ✅ **实现成果**
1. **完整的评分标准配置功能**：支持7个配置项的灵活设置
2. **用户友好的操作界面**：下拉选择避免输入错误
3. **高效的批量操作**：支持多个计划同时配置
4. **完善的权限控制**：精细化的功能权限管理
5. **直观的状态显示**：表格中清晰显示配置状态
### 🎯 **技术特色**
1. **配置化设计**：通过下拉选择实现无代码配置
2. **批量操作优化**：支持高效的批量配置更新
3. **实时预览功能**：配置前可预览影响范围
4. **一键重置功能**：快速恢复默认配置
5. **响应式界面**：适配不同屏幕尺寸
### 🔄 **后续扩展**
1. **配置模板功能**：保存常用配置为模板
2. **配置历史记录**：记录配置变更历史
3. **配置导入导出**：支持配置的批量导入导出
4. **配置预设方案**：提供多种预设配置方案
---
**📝 文档状态**: 实现完成
**🎯 功能状态**: ✅ 基础功能已完成
**🔄 下一步**: 可根据用户反馈进行功能优化和扩展
docs/开发文档/考核计划管理评分标准配置数据库升级完成报告.md
-241
View File
@@ -1,241 +0,0 @@
# 考核计划管理评分标准配置 - 数据库升级完成报告
## 📋 执行概述
| 项目 | 信息 |
|------|------|
| **执行时间** | 2025-01-27 |
| **升级脚本** | `考核计划管理评分标准配置数据库升级.sql` |
| **版本** | V1.1.0 |
| **执行状态** | ✅ 脚本已准备完成，待数据库执行 |
| **影响范围** | 仅学生考核管理模块，未影响其他模块 |
---
## 🎯 升级内容
### ✅ **1. 数据库表结构修改**
#### 表名：`xskh_assessment_plan`
```sql
-- 新增7个评分标准配置字段
ALTER TABLE `xskh_assessment_plan`
ADD COLUMN `base_score` DECIMAL(5,2) DEFAULT 100.00 COMMENT '基础分数（80-120分）',
ADD COLUMN `pass_score` DECIMAL(5,2) DEFAULT 60.00 COMMENT '及格分数（50-70分）',
ADD COLUMN `excellent_score` DECIMAL(5,2) DEFAULT 85.00 COMMENT '优秀分数（80-95分）',
ADD COLUMN `auto_deduct_enabled` CHAR(1) DEFAULT '1' COMMENT '是否启用自动扣分：0-否，1-是',
ADD COLUMN `bonus_enabled` CHAR(1) DEFAULT '1' COMMENT '是否启用加分项：0-否，1-是',
ADD COLUMN `discipline_weight` DECIMAL(3,2) DEFAULT 1.00 COMMENT '违纪扣分权重（0.5-1.5倍）',
ADD COLUMN `bonus_weight` DECIMAL(3,2) DEFAULT 1.00 COMMENT '加分项权重（0.5-1.5倍）';
```
#### 新增字段详情
| 字段名 | 类型 | 默认值 | 说明 | 用途 |
|--------|------|--------|------|------|
| `base_score` | DECIMAL(5,2) | 100.00 | 基础分数 | 学生综合测评的基础分数 |
| `pass_score` | DECIMAL(5,2) | 60.00 | 及格分数 | 及格线标准 |
| `excellent_score` | DECIMAL(5,2) | 85.00 | 优秀分数 | 优秀等级标准 |
| `auto_deduct_enabled` | CHAR(1) | '1' | 自动扣分开关 | 是否自动计算违纪扣分 |
| `bonus_enabled` | CHAR(1) | '1' | 加分项开关 | 是否启用加分项功能 |
| `discipline_weight` | DECIMAL(3,2) | 1.00 | 违纪扣分权重 | 违纪扣分的权重系数 |
| `bonus_weight` | DECIMAL(3,2) | 1.00 | 加分项权重 | 加分项的权重系数 |
### ✅ **2. 权限配置**
#### 新增权限菜单（ID: 9820-9823）
```sql
INSERT INTO sys_menu VALUES
(9820, '评分标准配置', 9800, 20, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:scoreConfig', '#'),
(9821, '批量配置评分标准', 9800, 21, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:batchScoreConfig', '#'),
(9822, '重置评分标准', 9800, 22, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:resetScore', '#'),
(9823, '获取评分配置选项', 9800, 23, '', '', '', 1, 0, 'F', '0', '0', 'xskh:assessmentPlan:scoreOptions', '#');
```
#### 权限详情
| ID | 权限名称 | 权限标识 | 功能说明 |
|----|----------|----------|----------|
| 9820 | 评分标准配置 | `xskh:assessmentPlan:scoreConfig` | 单个计划的评分标准配置 |
| 9821 | 批量配置评分标准 | `xskh:assessmentPlan:batchScoreConfig` | 批量配置多个计划的评分标准 |
| 9822 | 重置评分标准 | `xskh:assessmentPlan:resetScore` | 重置评分标准为默认值 |
| 9823 | 获取评分配置选项 | `xskh:assessmentPlan:scoreOptions` | 获取评分配置的下拉选项 |
### ✅ **3. 性能优化**
#### 新增索引
```sql
CREATE INDEX `idx_assessment_plan_score_config` ON `xskh_assessment_plan`
(`base_score`, `pass_score`, `excellent_score`);
```
**用途**: 优化评分配置相关的查询性能
---
## 🔐 ID分配管理
### **ID冲突预防**
- ✅ **权限ID范围**: 9820-9823（安全范围，避免冲突）
- ✅ **现有权限**: 9800-9819（考核计划管理基础权限）
- ✅ **后续扩展**: 9824-9999（预留给其他功能）
### **ID分配记录更新**
已更新 `docs/设计文档/database/学生考核管理/ID分配规范.md`：
- 记录新增权限ID 9820-9823的使用情况
- 确保与其他模块无冲突
- 为后续功能预留ID范围
---
## 📊 脚本安全性
### ✅ **安全特性**
1. **向前兼容**: 新增字段有默认值，不影响现有功能
2. **数据保护**: 现有数据不会丢失或修改
3. **权限安全**: 仅新增权限，不修改现有权限配置
4. **模块隔离**: 仅影响学生考核管理模块，不影响其他模块
5. **回滚支持**: 提供完整的回滚脚本
### ✅ **执行验证**
脚本包含自动验证功能：
- 表结构修改验证
- 权限配置验证
- 角色权限关联验证
- 索引创建验证
---
## 🚀 执行指南
### **执行前准备**
1. **数据库备份**: ⚠️ 强制要求备份数据库
2. **权限检查**: 确保有ALTER TABLE和INSERT权限
3. **冲突检查**: 验证菜单ID 9820-9823未被使用
4. **环境确认**: 在测试环境先验证
### **执行命令**
```bash
# 数据库备份
mysqldump -u用户名 -p数据库名 > backup_$(date +%Y%m%d_%H%M%S).sql
# 执行升级脚本
mysql -u用户名 -p数据库名 < backend/sql/考核计划管理评分标准配置数据库升级.sql
```
### **验证步骤**
```sql
-- 1. 验证字段创建
DESCRIBE xskh_assessment_plan;
-- 2. 验证权限配置
SELECT menu_id, menu_name, perms FROM sys_menu WHERE menu_id BETWEEN 9820 AND 9823;
-- 3. 验证角色权限
SELECT rm.role_id, rm.menu_id, m.menu_name
FROM sys_role_menu rm
JOIN sys_menu m ON rm.menu_id = m.menu_id
WHERE rm.menu_id BETWEEN 9820 AND 9823;
```
---
## 📁 相关文件
### **升级脚本文件**
- 📄 `backend/sql/考核计划管理评分标准配置数据库升级.sql` - 主升级脚本
- 📄 `backend/sql/数据库升级执行说明.md` - 详细执行说明
### **文档更新**
- 📄 `docs/设计文档/database/学生考核管理/ID分配规范.md` - ID分配记录更新
- 📄 `docs/开发文档/考核计划管理评分标准配置功能实现报告.md` - 功能实现报告
### **代码文件**
- 📄 后端实体类、BO、VO类已更新
- 📄 后端Controller、Service已实现
- 📄 前端API接口、页面组件已完成
---
## 🔄 回滚方案
### **紧急回滚脚本**
```sql
-- 删除新增权限
DELETE FROM sys_role_menu WHERE menu_id BETWEEN 9820 AND 9823;
DELETE FROM sys_menu WHERE menu_id BETWEEN 9820 AND 9823;
-- 删除新增字段（注意：会丢失数据）
ALTER TABLE `xskh_assessment_plan`
DROP COLUMN `base_score`,
DROP COLUMN `pass_score`,
DROP COLUMN `excellent_score`,
DROP COLUMN `auto_deduct_enabled`,
DROP COLUMN `bonus_enabled`,
DROP COLUMN `discipline_weight`,
DROP COLUMN `bonus_weight`;
-- 删除索引
DROP INDEX `idx_assessment_plan_score_config` ON `xskh_assessment_plan`;
```
### **数据恢复**
```bash
# 从备份恢复整个数据库
mysql -u用户名 -p数据库名 < backup_文件名.sql
```
---
## ✅ 执行后验证清单
### **数据库验证**
- [ ] 新增字段正确创建（7个字段）
- [ ] 字段默认值正确设置
- [ ] 权限菜单正确插入（4个权限）
- [ ] 角色权限正确关联
- [ ] 索引正确创建
- [ ] 现有数据完整性保持
### **功能验证**
- [ ] 考核计划列表正常显示
- [ ] 评分标准列显示正确
- [ ] 评分配置按钮可见（有权限用户）
- [ ] 评分配置对话框正常打开
- [ ] 批量配置功能正常工作
- [ ] 重置默认值功能正常
- [ ] 权限控制正确生效
### **性能验证**
- [ ] 表查询性能正常
- [ ] 新增索引生效
- [ ] 页面加载速度正常
---
## 📞 总结
### ✅ **升级成果**
1. **完整的数据库结构**: 为评分标准配置提供了完整的数据存储支持
2. **安全的权限控制**: 精细化的功能权限管理
3. **性能优化**: 通过索引优化查询性能
4. **向前兼容**: 不影响现有功能的正常使用
5. **模块隔离**: 仅影响学生考核管理模块
### 🎯 **技术特色**
1. **ID冲突预防**: 使用安全的ID范围9820-9823
2. **数据完整性**: 所有字段有合理的默认值
3. **回滚支持**: 提供完整的回滚方案
4. **自动验证**: 脚本包含自动验证功能
5. **文档完整**: 提供详细的执行说明和验证方法
### 🔄 **下一步**
1. **执行升级脚本**: 在测试环境先验证，然后在生产环境执行
2. **功能测试**: 验证评分标准配置功能正常工作
3. **用户培训**: 向用户介绍新的评分配置功能
4. **监控运行**: 观察系统运行状况和性能表现
---
**📝 报告状态**: 升级脚本已准备完成
**🎯 执行目标**: 为考核计划管理添加评分标准配置功能
**⚠️ 重要提醒**: 执行前务必备份数据库！
**📅 建议执行时间**: 业务低峰期进行
docs/开发文档/自动扣分计算功能开发方案.md
-647
View File
@@ -1,647 +0,0 @@
# 自动扣分计算功能开发方案
## 📋 功能概述
**开发目标**: 实现违纪处分记录自动影响学生考核结果的扣分计算功能
**优先级**: 🔴 高（立即开始）
**预估工作量**: 3天
**开发阶段**: 第一阶段核心功能
---
## 🏗️ 技术架构设计
### 1. **数据流图**
```mermaid
graph TD
A[违纪处分审批通过] --> B[触发扣分计算事件]
B --> C[查询扣分规则配置]
C --> D[计算具体扣分数值]
D --> E[更新考核记录扣分]
E --> F[重新计算总分]
F --> G[更新学生排名]
G --> H[发送变更通知]
```
### 2. **核心组件设计**
```
DisciplineScoreCalculationService # 扣分计算服务
├── calculateDeductionScore() # 计算扣分
├── updateAssessmentScore() # 更新考核分数
└── recalculateRankings() # 重新计算排名
DisciplineAssessmentSyncService # 数据同步服务
├── handleDisciplineApproved() # 处理审批通过事件
├── syncAssessmentRecords() # 同步考核记录
└── sendNotifications() # 发送通知
DisciplineScoreRuleService # 扣分规则服务
├── getScoreRule() # 获取扣分规则
├── validateRule() # 验证规则有效性
└── calculateByRule() # 按规则计算
```
---
## 📊 数据库设计
### 1. **新增扣分规则配置表**
```sql
-- 违纪扣分规则配置表
CREATE TABLE `xskh_discipline_score_rule` (
`id` bigint(20) NOT NULL COMMENT '主键ID',
`tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
-- 规则基础信息
`rule_code` varchar(32) NOT NULL COMMENT '规则编码',
`rule_name` varchar(100) NOT NULL COMMENT '规则名称',
`rule_desc` text COMMENT '规则描述',
-- 关联信息
`discipline_type_id` bigint(20) NOT NULL COMMENT '违纪类型ID',
`discipline_type_code` varchar(32) NOT NULL COMMENT '违纪类型编码',
`punishment_type_id` bigint(20) NOT NULL COMMENT '处分类型ID',
`punishment_type_code` varchar(32) NOT NULL COMMENT '处分类型编码',
-- 扣分规则
`severity_level` tinyint(1) DEFAULT 1 COMMENT '严重程度等级：1-轻微，2-一般，3-严重，4-特别严重',
`deduction_score` decimal(5,2) NOT NULL COMMENT '基础扣分数',
`deduction_type` varchar(20) DEFAULT 'fixed' COMMENT '扣分类型：fixed-固定分数，percentage-百分比',
`percentage_base` varchar(20) DEFAULT 'total' COMMENT '百分比基准：total-总分，indicator-单项分',
-- 累计规则
`accumulate_rule` varchar(20) DEFAULT 'add' COMMENT '累计规则：add-累加，multiply-倍数，max-取最高',
`max_deduction` decimal(5,2) COMMENT '最大扣分限制',
`repeat_factor` decimal(3,2) DEFAULT 1.00 COMMENT '重复违纪系数',
-- 时间规则
`recovery_period` int(11) COMMENT '恢复期（月）',
`effective_start_date` date COMMENT '规则生效开始日期',
`effective_end_date` date COMMENT '规则生效结束日期',
-- 适用范围
`applicable_grades` json COMMENT '适用年级（JSON数组）',
`applicable_majors` json COMMENT '适用专业（JSON数组）',
`applicable_colleges` json COMMENT '适用学院（JSON数组）',
-- 状态控制
`is_enabled` char(1) DEFAULT '1' COMMENT '是否启用：0-否，1-是',
`priority` int(11) DEFAULT 0 COMMENT '优先级（数字越大优先级越高）',
`sort_order` int(11) DEFAULT 0 COMMENT '排序号',
-- 审计字段
`create_by` bigint(20) COMMENT '创建者',
`create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_by` bigint(20) COMMENT '更新者',
`update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
`remark` varchar(500) COMMENT '备注',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_rule_code` (`rule_code`),
KEY `idx_discipline_type` (`discipline_type_id`, `discipline_type_code`),
KEY `idx_punishment_type` (`punishment_type_id`, `punishment_type_code`),
KEY `idx_enabled_priority` (`is_enabled`, `priority`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='违纪扣分规则配置表';
```
### 2. **扩展考核记录表**
```sql
-- 扩展现有考核记录表，增加违纪相关字段
ALTER TABLE `xskh_assessment_record`
ADD COLUMN `discipline_deduction` decimal(5,2) DEFAULT 0.00 COMMENT '违纪扣分' AFTER `deductionScore`,
ADD COLUMN `discipline_count` int(11) DEFAULT 0 COMMENT '违纪次数' AFTER `discipline_deduction`,
ADD COLUMN `last_discipline_time` datetime COMMENT '最近违纪时间' AFTER `discipline_count`,
ADD COLUMN `score_details` json COMMENT '分数明细（JSON格式）' AFTER `last_discipline_time`,
ADD COLUMN `calculation_version` varchar(20) DEFAULT '1.0' COMMENT '计算版本号' AFTER `score_details`;
```
### 3. **新增扣分计算历史表**
```sql
-- 扣分计算历史记录表
CREATE TABLE `xskh_discipline_score_history` (
`id` bigint(20) NOT NULL COMMENT '主键ID',
`tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
-- 关联信息
`student_id` bigint(20) NOT NULL COMMENT '学生ID',
`student_no` varchar(50) NOT NULL COMMENT '学号',
`student_name` varchar(100) NOT NULL COMMENT '学生姓名',
`assessment_record_id` bigint(20) NOT NULL COMMENT '考核记录ID',
`discipline_record_id` bigint(20) NOT NULL COMMENT '违纪记录ID',
-- 计算信息
`rule_id` bigint(20) NOT NULL COMMENT '使用的规则ID',
`rule_code` varchar(32) NOT NULL COMMENT '规则编码',
`calculation_type` varchar(20) NOT NULL COMMENT '计算类型：add-新增，modify-修改，cancel-撤销',
-- 分数信息
`original_score` decimal(5,2) COMMENT '原始总分',
`deduction_score` decimal(5,2) NOT NULL COMMENT '本次扣分',
`new_total_score` decimal(5,2) COMMENT '新总分',
`calculation_details` json COMMENT '计算详情（JSON格式）',
-- 执行信息
`calculation_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '计算时间',
`operator_id` bigint(20) COMMENT '操作员ID',
`operator_name` varchar(100) COMMENT '操作员姓名',
`remark` varchar(500) COMMENT '备注说明',
PRIMARY KEY (`id`),
KEY `idx_student` (`student_id`, `student_no`),
KEY `idx_assessment_record` (`assessment_record_id`),
KEY `idx_discipline_record` (`discipline_record_id`),
KEY `idx_calculation_time` (`calculation_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='违纪扣分计算历史表';
```
---
## 🚀 实现步骤
### **第一步：创建数据库表和基础实体类**
#### 1.1 执行SQL脚本
```sql
-- 在ruoyi-xskh模块中执行上述三个SQL脚本
```
#### 1.2 生成实体类
```bash
# 使用代码生成器生成以下实体类
- XskhDisciplineScoreRule # 扣分规则实体
- XskhDisciplineScoreRuleBo # 扣分规则业务对象
- XskhDisciplineScoreRuleVo # 扣分规则视图对象
- XskhDisciplineScoreHistory # 扣分历史实体
- XskhDisciplineScoreHistoryVo # 扣分历史视图对象
```
### **第二步：开发核心业务服务**
#### 2.1 扣分规则服务
```java
@Service
public class XskhDisciplineScoreRuleServiceImpl implements IXskhDisciplineScoreRuleService {
/**
* 根据违纪类型和处分类型获取扣分规则
*/
public XskhDisciplineScoreRuleVo getScoreRule(Long disciplineTypeId, Long punishmentTypeId,
String grade, String majorId, String collegeId) {
// 1. 查询匹配的规则（优先级从高到低）
// 2. 检查适用范围（年级、专业、学院）
// 3. 检查有效期
// 4. 返回最高优先级的规则
}
/**
* 计算具体扣分数值
*/
public BigDecimal calculateDeductionScore(XskhDisciplineScoreRuleVo rule,
XskhAssessmentRecordVo record,
List<XskhDisciplineRecordVo> historyRecords) {
// 1. 根据规则类型计算基础扣分
// 2. 处理重复违纪累计
// 3. 应用最大扣分限制
// 4. 返回最终扣分值
}
}
```
#### 2.2 扣分计算服务
```java
@Service
public class XskhDisciplineScoreCalculationService {
@Autowired
private IXskhDisciplineScoreRuleService ruleService;
@Autowired
private IXskhAssessmentRecordService recordService;
@Autowired
private IXskhDisciplineScoreHistoryService historyService;
/**
* 计算并更新学生考核扣分
*/
@Transactional(rollbackFor = Exception.class)
public Boolean calculateAndUpdateScore(Long disciplineRecordId) {
// 1. 获取违纪记录信息
XskhDisciplineRecordVo disciplineRecord = disciplineRecordService.queryById(disciplineRecordId);
// 2. 查询学生的相关考核记录
List<XskhAssessmentRecordVo> assessmentRecords = getAffectedAssessmentRecords(disciplineRecord.getStudentId());
// 3. 获取适用的扣分规则
XskhDisciplineScoreRuleVo rule = ruleService.getScoreRule(
disciplineRecord.getDisciplineTypeId(),
disciplineRecord.getPunishmentTypeId(),
disciplineRecord.getGrade(),
disciplineRecord.getMajorId(),
disciplineRecord.getCollegeId()
);
if (rule == null) {
log.warn("未找到适用的扣分规则，违纪记录ID: {}", disciplineRecordId);
return false;
}
// 4. 对每个考核记录进行扣分计算和更新
for (XskhAssessmentRecordVo record : assessmentRecords) {
updateAssessmentScore(record, disciplineRecord, rule);
}
return true;
}
/**
* 更新单个考核记录的分数
*/
private void updateAssessmentScore(XskhAssessmentRecordVo record,
XskhDisciplineRecordVo disciplineRecord,
XskhDisciplineScoreRuleVo rule) {
// 1. 查询学生历史违纪记录（用于累计计算）
List<XskhDisciplineRecordVo> historyRecords = getHistoryDisciplineRecords(
record.getStudentId(), record.getPlanId());
// 2. 计算本次扣分
BigDecimal deductionScore = ruleService.calculateDeductionScore(rule, record, historyRecords);
// 3. 更新考核记录
XskhAssessmentRecordBo updateRecord = new XskhAssessmentRecordBo();
updateRecord.setId(record.getId());
updateRecord.setDisciplineDeduction(record.getDisciplineDeduction().add(deductionScore));
updateRecord.setDisciplineCount(record.getDisciplineCount() + 1);
updateRecord.setLastDisciplineTime(LocalDateTime.now());
// 4. 重新计算总分
BigDecimal newTotalScore = calculateNewTotalScore(record, deductionScore);
updateRecord.setTotalScore(newTotalScore);
// 5. 更新分数明细JSON
updateRecord.setScoreDetails(buildScoreDetailsJson(record, disciplineRecord, deductionScore));
// 6. 执行更新
recordService.updateByBo(updateRecord);
// 7. 记录计算历史
saveCalculationHistory(record, disciplineRecord, rule, deductionScore, newTotalScore);
}
}
```
### **第三步：事件驱动的数据同步**
#### 3.1 创建事件类
```java
// 违纪处分审批通过事件
@Data
public class DisciplineApprovedEvent extends ApplicationEvent {
private Long disciplineRecordId;
private Long studentId;
private String studentNo;
private String approvalStatus;
private LocalDateTime approvalTime;
public DisciplineApprovedEvent(Object source, Long disciplineRecordId, Long studentId) {
super(source);
this.disciplineRecordId = disciplineRecordId;
this.studentId = studentId;
}
}
```
#### 3.2 事件监听器
```java
@Component
public class DisciplineAssessmentSyncService {
@Autowired
private XskhDisciplineScoreCalculationService calculationService;
/**
* 监听违纪处分审批通过事件
*/
@EventListener
@Async("assessmentTaskExecutor")
public void handleDisciplineApproved(DisciplineApprovedEvent event) {
try {
log.info("处理违纪处分审批通过事件，记录ID: {}", event.getDisciplineRecordId());
// 1. 计算并更新考核扣分
Boolean result = calculationService.calculateAndUpdateScore(event.getDisciplineRecordId());
if (result) {
// 2. 重新计算相关排名
List<Long> planIds = getAffectedPlanIds(event.getStudentId());
for (Long planId : planIds) {
assessmentRecordService.calculateRankings(planId);
}
// 3. 发送变更通知
sendScoreUpdateNotification(event.getStudentId(), event.getDisciplineRecordId());
log.info("违纪扣分计算完成，学生ID: {}", event.getStudentId());
}
} catch (Exception e) {
log.error("处理违纪扣分计算失败，记录ID: {}", event.getDisciplineRecordId(), e);
}
}
}
```
#### 3.3 在违纪审批服务中触发事件
```java
// 修改 XskhDisciplineRecordServiceImpl.approveRecord 方法
@Override
@Transactional(rollbackFor = Exception.class)
public Boolean approveRecord(Long id, String approvalStatus, String approveComment) {
// ... 原有审批逻辑 ...
Boolean result = baseMapper.updateById(record) > 0;
// 如果审批通过，触发扣分计算事件
if (result && "3".equals(approvalStatus)) {
DisciplineApprovedEvent event = new DisciplineApprovedEvent(this, id, record.getStudentId());
event.setStudentNo(record.getStudentNo());
event.setApprovalStatus(approvalStatus);
event.setApprovalTime(LocalDateTime.now());
applicationEventPublisher.publishEvent(event);
log.info("发布违纪处分审批通过事件，记录ID: {}", id);
}
return result;
}
```
### **第四步：管理界面开发**
#### 4.1 扣分规则管理页面
```vue
<!-- 扣分规则配置页面：/xskh/disciplineScoreRule -->
<template>
<div class="app-container">
<!-- 查询条件 -->
<el-form :model="queryParams" ref="queryFormRef" :inline="true">
<el-form-item label="规则名称" prop="ruleName">
<el-input v-model="queryParams.ruleName" placeholder="请输入规则名称" />
</el-form-item>
<el-form-item label="违纪类型" prop="disciplineTypeId">
<el-select v-model="queryParams.disciplineTypeId" placeholder="请选择违纪类型">
<el-option v-for="item in disciplineTypeOptions"
:key="item.id" :label="item.typeName" :value="item.id" />
</el-select>
</el-form-item>
<el-form-item label="处分类型" prop="punishmentTypeId">
<el-select v-model="queryParams.punishmentTypeId" placeholder="请选择处分类型">
<el-option v-for="item in punishmentTypeOptions"
:key="item.id" :label="item.typeName" :value="item.id" />
</el-select>
</el-form-item>
<el-form-item>
<el-button type="primary" icon="Search" @click="handleQuery">搜索</el-button>
<el-button icon="Refresh" @click="resetQuery">重置</el-button>
</el-form-item>
</el-form>
<!-- 操作按钮 -->
<el-row :gutter="10" class="mb8">
<el-col :span="1.5">
<el-button type="primary" icon="Plus" @click="handleAdd">新增规则</el-button>
</el-col>
<el-col :span="1.5">
<el-button type="success" icon="Edit" :disabled="single" @click="handleUpdate">修改</el-button>
</el-col>
<el-col :span="1.5">
<el-button type="danger" icon="Delete" :disabled="multiple" @click="handleDelete">删除</el-button>
</el-col>
</el-row>
<!-- 数据表格 -->
<el-table v-loading="loading" :data="ruleList" @selection-change="handleSelectionChange">
<el-table-column type="selection" width="55" align="center" />
<el-table-column label="规则编码" prop="ruleCode" width="120" />
<el-table-column label="规则名称" prop="ruleName" width="200" />
<el-table-column label="违纪类型" prop="disciplineTypeName" width="120" />
<el-table-column label="处分类型" prop="punishmentTypeName" width="120" />
<el-table-column label="严重程度" prop="severityLevel" width="100">
<template #default="scope">
<el-tag :type="getSeverityType(scope.row.severityLevel)">
{{ getSeverityLabel(scope.row.severityLevel) }}
</el-tag>
</template>
</el-table-column>
<el-table-column label="扣分规则" width="150">
<template #default="scope">
<span v-if="scope.row.deductionType === 'fixed'">
固定扣 {{ scope.row.deductionScore }} 分
</span>
<span v-else>
扣除 {{ scope.row.deductionScore }}%
</span>
</template>
</el-table-column>
<el-table-column label="最大扣分" prop="maxDeduction" width="100" />
<el-table-column label="优先级" prop="priority" width="80" />
<el-table-column label="状态" prop="isEnabled" width="80">
<template #default="scope">
<el-switch v-model="scope.row.isEnabled"
active-value="1" inactive-value="0"
@change="handleStatusChange(scope.row)" />
</template>
</el-table-column>
<el-table-column label="操作" width="200" fixed="right">
<template #default="scope">
<el-button text type="primary" @click="handleUpdate(scope.row)">修改</el-button>
<el-button text type="primary" @click="handleView(scope.row)">查看</el-button>
<el-button text type="danger" @click="handleDelete(scope.row)">删除</el-button>
</template>
</el-table-column>
</el-table>
<!-- 分页组件 -->
<pagination v-if="total > 0" :total="total"
v-model:page="queryParams.pageNum"
v-model:limit="queryParams.pageSize"
@pagination="getList" />
</div>
</template>
```
#### 4.2 扣分计算历史查询页面
```vue
<!-- 扣分历史查询页面：/xskh/disciplineScoreHistory -->
<template>
<div class="app-container">
<!-- 查询条件 -->
<el-form :model="queryParams" ref="queryFormRef" :inline="true">
<el-form-item label="学号" prop="studentNo">
<el-input v-model="queryParams.studentNo" placeholder="请输入学号" />
</el-form-item>
<el-form-item label="学生姓名" prop="studentName">
<el-input v-model="queryParams.studentName" placeholder="请输入学生姓名" />
</el-form-item>
<el-form-item label="计算时间">
<el-date-picker v-model="dateRange" type="daterange"
range-separator="至" start-placeholder="开始日期"
end-placeholder="结束日期" @change="handleDateChange" />
</el-form-item>
<el-form-item>
<el-button type="primary" icon="Search" @click="handleQuery">搜索</el-button>
<el-button icon="Refresh" @click="resetQuery">重置</el-button>
</el-form-item>
</el-form>
<!-- 数据表格 -->
<el-table v-loading="loading" :data="historyList">
<el-table-column label="学号" prop="studentNo" width="120" />
<el-table-column label="学生姓名" prop="studentName" width="100" />
<el-table-column label="计算类型" prop="calculationType" width="100">
<template #default="scope">
<el-tag :type="getCalculationType(scope.row.calculationType)">
{{ getCalculationLabel(scope.row.calculationType) }}
</el-tag>
</template>
</el-table-column>
<el-table-column label="规则编码" prop="ruleCode" width="120" />
<el-table-column label="原始总分" prop="originalScore" width="100" />
<el-table-column label="扣分数值" prop="deductionScore" width="100" />
<el-table-column label="新总分" prop="newTotalScore" width="100" />
<el-table-column label="计算时间" prop="calculationTime" width="180" />
<el-table-column label="操作员" prop="operatorName" width="100" />
<el-table-column label="操作" width="150">
<template #default="scope">
<el-button text type="primary" @click="handleViewDetails(scope.row)">查看详情</el-button>
</template>
</el-table-column>
</el-table>
</div>
</template>
```
---
## 🧪 测试方案
### 1. **单元测试**
```java
@SpringBootTest
class XskhDisciplineScoreCalculationServiceTest {
@Test
void testCalculateDeductionScore_FixedType() {
// 测试固定分数扣分
}
@Test
void testCalculateDeductionScore_PercentageType() {
// 测试百分比扣分
}
@Test
void testCalculateDeductionScore_WithRepeatViolation() {
// 测试重复违纪累计扣分
}
@Test
void testCalculateDeductionScore_WithMaxLimit() {
// 测试最大扣分限制
}
}
```
### 2. **集成测试**
```java
@SpringBootTest
@Transactional
class DisciplineAssessmentIntegrationTest {
@Test
void testDisciplineApprovalTriggerScoreCalculation() {
// 测试违纪审批通过触发扣分计算的完整流程
}
}
```
### 3. **API测试脚本**
```python
# Python测试脚本：test_discipline_score_calculation.py
def test_create_score_rule():
"""测试创建扣分规则"""
pass
def test_approve_discipline_record():
"""测试审批违纪记录并验证扣分计算"""
pass
def test_query_score_history():
"""测试查询扣分计算历史"""
pass
```
---
## ✅ 验收标准
### **功能验收**
1. ✅ 违纪处分审批通过后，自动计算并更新相关考核记录的扣分
2. ✅ 支持固定分数和百分比两种扣分方式
3. ✅ 支持重复违纪的累计扣分计算
4. ✅ 支持最大扣分限制控制
5. ✅ 完整的扣分计算历史记录
6. ✅ 管理员可以配置和管理扣分规则
7. ✅ 支持按年级、专业、学院的差异化规则配置
### **性能验收**
1. ✅ 单次扣分计算响应时间 < 2秒
2. ✅ 批量计算（100个学生）响应时间 < 30秒
3. ✅ 并发扣分计算不出现数据异常
### **安全验收**
1. ✅ 所有扣分计算操作有完整的审计日志
2. ✅ 敏感操作需要相应权限验证
3. ✅ 计算异常有完善的错误处理和回滚机制
---
## 🚀 部署方案
### **1. 数据库脚本执行**
```bash
# 执行顺序
1. 创建扣分规则配置表
2. 扩展考核记录表字段
3. 创建扣分计算历史表
4. 插入默认扣分规则数据
```
### **2. 应用配置**
```yaml
# application.yml 增加配置
spring:
task:
execution:
pool:
assessment-task-executor:
core-size: 2
max-size: 5
queue-capacity: 100
```
### **3. 权限配置**
```sql
-- 增加扣分管理相关权限
INSERT INTO sys_menu (menu_name, parent_id, path, component, perms) VALUES
('扣分规则管理', xxx, 'disciplineScoreRule', 'xskh/disciplineScoreRule/index', 'xskh:disciplineScoreRule:list'),
('扣分历史查询', xxx, 'disciplineScoreHistory', 'xskh/disciplineScoreHistory/index', 'xskh:disciplineScoreHistory:list');
```
---
**开发负责人**: 待分配
**预计完成时间**: 3个工作日
**测试负责人**: 待分配
**部署负责人**: 待分配
docs/开发文档/违纪处分管理-菜单配置指南.md
-172
View File
@@ -1,172 +0,0 @@
# 违纪处分管理 - 菜单配置指南
## 📋 问题背景
当前项目中存在两个违纪处分管理页面：
- `/web/src/views/xskh/index.vue` - **概览页面**（查看和简单操作）
- `/web/src/views/xskh/disciplineRecord/index.vue` - **详细管理页面**（完整CRUD功能）
需要为这两个页面配置合理的菜单层次结构。
## 🎯 解决方案
### 📊 菜单层次设计
```
🎯 学生考核管理 (9000)
├── 📊 违纪处分管理 (9100) - 概览页面
│ ├── 查询权限 - xskh:disciplineRecord:query
│ ├── 详情权限 - xskh:disciplineRecord:view
│ ├── 审核权限 - xskh:disciplineRecord:approve
│ └── 导出权限 - xskh:disciplineRecord:export
│
└── 📝 处分记录管理 (9110) - 详细管理页面
├── 查询权限 - xskh:disciplineRecord:query
├── 新增权限 - xskh:disciplineRecord:add
├── 修改权限 - xskh:disciplineRecord:edit
├── 删除权限 - xskh:disciplineRecord:remove
├── 导出权限 - xskh:disciplineRecord:export
├── 导入权限 - xskh:disciplineRecord:import
├── 审核权限 - xskh:disciplineRecord:approve
└── 统计权限 - xskh:disciplineRecord:stats
```
### 🗂️ 路由对应关系
| 菜单路径 | 组件路径 | 页面功能 | 适用角色 |
|---------|----------|----------|----------|
| `/assessment/xskh` | `xskh/index.vue` | 违纪处分概览 | 查看者、审核者 |
| `/assessment/disciplineRecord` | `xskh/disciplineRecord/index.vue` | 完整管理功能 | 管理员、数据管理员 |
## 🚀 实施步骤
### 1. 执行数据库脚本
```bash
# 在数据库中执行菜单配置脚本
mysql -u username -p hzdyjs_xg < docs/设计文档/database/学生考核管理/违纪处分管理菜单配置优化.sql
```
### 2. 注册前端路由模块
在 `web/src/router/index.ts` 中添加：
```typescript
// 导入学生考核管理路由
import xskhRouter from './modules/xskh';
// 在 dynamicRoutes 中添加
export const dynamicRoutes: RouteRecordRaw[] = [
xskhRouter,
// ... 其他路由
];
```
### 3. 创建缺失的页面组件
需要创建以下页面（如果不存在）：
```bash
# 新增记录页面
web/src/views/xskh/disciplineRecord/add.vue
# 编辑记录页面
web/src/views/xskh/disciplineRecord/edit.vue
```
### 4. 修复现有页面路由跳转
在 `xskh/index.vue` 中修改路由跳转：
```typescript
// 修改前
router.push('/xskh/disciplineRecord/add');
// 修改后
router.push('/assessment/disciplineRecord/add');
```
## 🎭 用户角色权限分配
### 👀 查看者角色
**菜单权限**：只显示"违纪处分管理"(9100)
```sql
INSERT INTO sys_role_menu (role_id, menu_id) VALUES
(查看者角色ID, 9100), (查看者角色ID, 9101), (查看者角色ID, 9102);
```
### 👨‍💼 管理员角色
**菜单权限**：显示两个菜单，拥有完整功能
```sql
INSERT INTO sys_role_menu (role_id, menu_id) VALUES
(管理员角色ID, 9100), (管理员角色ID, 9101), (管理员角色ID, 9102), (管理员角色ID, 9103), (管理员角色ID, 9104),
(管理员角色ID, 9110), (管理员角色ID, 9111), (管理员角色ID, 9112), (管理员角色ID, 9113), (管理员角色ID, 9114), (管理员角色ID, 9115), (管理员角色ID, 9116), (管理员角色ID, 9117), (管理员角色ID, 9118);
```
### 📊 数据分析师角色
**菜单权限**：重点使用"处分记录管理"(9110)进行数据分析
```sql
INSERT INTO sys_role_menu (role_id, menu_id) VALUES
(分析师角色ID, 9110), (分析师角色ID, 9111), (分析师角色ID, 9115), (分析师角色ID, 9118);
```
## 🔧 菜单配置详情
### 主菜单配置
```sql
-- 违纪处分管理（概览页面）
INSERT INTO sys_menu VALUES
(9100, '违纪处分管理', 9000, 1, 'xskh', 'xskh/index', '', 1, 0, 'C', '0', '0', 'xskh:disciplineRecord:list', 'discipline', 1, NOW(), 1, NOW(), '违纪处分概览页面');
```
### 子菜单配置
```sql
-- 处分记录管理（详细管理页面）
INSERT INTO sys_menu VALUES
(9110, '处分记录管理', 9000, 2, 'disciplineRecord', 'xskh/disciplineRecord/index', '', 1, 0, 'C', '0', '0', 'xskh:disciplineRecord:manage', 'edit', 1, NOW(), 1, NOW(), '违纪处分详细管理');
```
## 📱 前端适配说明
### 菜单访问路径
- **概览页面**: `http://localhost/assessment/xskh`
- **详细管理**: `http://localhost/assessment/disciplineRecord`
### 权限控制
前端使用 `v-hasPermi` 指令控制按钮显示：
```vue
<!-- 概览页面按钮 -->
<el-button v-hasPermi="['xskh:disciplineRecord:query']">查询</el-button>
<el-button v-hasPermi="['xskh:disciplineRecord:approve']">审核</el-button>
<!-- 详细管理页面按钮 -->
<el-button v-hasPermi="['xskh:disciplineRecord:add']">新增</el-button>
<el-button v-hasPermi="['xskh:disciplineRecord:edit']">修改</el-button>
<el-button v-hasPermi="['xskh:disciplineRecord:remove']">删除</el-button>
```
## 🎯 预期效果
### 用户体验
1. **层次清晰**: 不同用户角色看到不同的菜单
2. **功能互补**: 概览页面用于快速查看，详细管理用于深度操作
3. **权限精确**: 每个功能都有对应的权限控制
### 技术收益
1. **代码复用**: 两个页面各司其职，避免功能重复
2. **维护简单**: 分层设计便于维护和扩展
3. **性能优化**: 用户只加载需要的功能模块
## 📝 注意事项
1. **ID范围**: 菜单ID使用9100-9150范围，避免与其他模块冲突
2. **权限编码**: 统一使用 `xskh:disciplineRecord:*` 格式
3. **路由缓存**: 建议对详细管理页面启用缓存以提升性能
4. **面包屑导航**: 确保面包屑正确显示层次关系
---
**创建时间**: 2025-01-28
**文档版本**: V1.0.0
**适用范围**: 违纪处分管理模块菜单配置