# 学生考核申请指标数据获取功能开发说明

## 📋 功能概述

**功能名称**: 学生考核申请指标数据动态获取  
**开发时间**: 2025-01-03  
**模块**: 学工管理-学生考核管理  
**功能描述**: 当学生新增考核申请时，系统根据考核计划ID自动获取关联的指标数据，填入到指标模块中

---

## 🎯 业务需求

### 原始问题
- 学生考核申请表单中的指标模块数据是硬编码的
- 无法根据不同的考核计划动态显示对应的指标
- 指标数据应该来源于考核方案关联指标体系表

### 解决方案
- 根据考核计划ID → 获取考核方案ID → 查询考核方案关联指标体系表
- 动态获取指标数据并填入表单
- 支持不同考核计划显示不同的指标组合

---

## 🏗️ 技术实现

### 1. 数据库关联关系
```
xskh_assessment_schedule (考核计划表)
    ↓ plan_id
xskh_assessment_plan (考核方案表)
    ↓ plan_id
xskh_assessment_plan_indicator (考核方案关联指标体系表)
    ↓ indicator_id
xskh_assessment_indicator (考核指标体系表)
```

### 2. 前端实现

#### 2.1 API接口扩展
**文件**: `web/src/api/xskh/assessmentApplication/assessmentApplication.ts`

```typescript
// 根据考核计划ID获取关联的指标数据
export function getIndicatorsByScheduleId(scheduleId: string | number) {
  return request({
    url: `/assessment/application/indicators/${scheduleId}`,
    method: 'get'
  });
}
```

#### 2.2 组件逻辑修改
**文件**: `web/src/views/xskh/assessmentApplication/AssessmentApplicationForm.vue`

**主要修改**:
1. 导入新的API接口
2. 添加`loadIndicatorsByScheduleId`方法
3. 修改`openDialog`方法，新增时调用指标数据获取
4. 修复接口类型定义，添加`fileList`属性

**核心方法**:
```typescript
/** 根据考核计划ID获取关联的指标数据 */
const loadIndicatorsByScheduleId = async (scheduleId: string | number) => {
  try {
    const response = await getIndicatorsByScheduleId(scheduleId);
    
    if (response.code === 200 && response.data) {
      // 将指标数据转换为自评得分列表格式
      form.value.selfScoreList = response.data.map((item: any) => ({
        id: undefined,
        applicationId: undefined,
        indicatorId: item.indicatorId,
        indicatorName: item.indicatorName,
        indicatorCode: item.indicatorCode,
        indicatorDescription: item.description,
        indicatorMaxScore: item.maxScore,
        planMaxScore: item.maxScore, // 使用方案中设置的最高分值
        sortOrder: item.sortOrder,
        selfScore: 0,
        selfRemark: '',
        teacherScore: 0,
        teacherRemark: ''
      }));
    }
  } catch (error) {
    console.error('获取指标数据失败:', error);
    form.value.selfScoreList = [];
  }
};
```

### 3. 后端实现

#### 3.1 Controller层
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/controller/XskhAssessmentApplicationApprovalController.java`

```java
/**
 * 根据考核计划ID获取关联的指标数据
 */
@SaCheckPermission("assessment:application:query")
@GetMapping("/indicators/{scheduleId}")
public R<List<Object>> getIndicatorsByScheduleId(
        @NotNull(message = "考核计划ID不能为空") @PathVariable Long scheduleId) {
    return R.ok(xskhAssessmentApplicationApprovalService.getIndicatorsByScheduleId(scheduleId));
}
```

#### 3.2 Service层
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/service/IXskhAssessmentApplicationApprovalService.java`

```java
/**
 * 根据考核计划ID获取关联的指标数据
 */
List<Object> getIndicatorsByScheduleId(Long scheduleId);
```

**实现类**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/service/impl/XskhAssessmentApplicationApprovalServiceImpl.java`

```java
/**
 * 根据考核计划ID获取关联的指标数据
 */
@Override
public List<Object> getIndicatorsByScheduleId(Long scheduleId) {
    // 1. 根据考核计划ID获取考核方案ID
    XskhAssessmentScheduleVo schedule = assessmentScheduleService.queryById(scheduleId);
    if (schedule == null) {
        return new ArrayList<>();
    }
    
    Long planId = schedule.getPlanId();
    if (planId == null) {
        return new ArrayList<>();
    }
    
    // 2. 根据考核方案ID查询关联的指标数据
    List<Object> indicators = baseMapper.selectIndicatorsByPlanId(planId);
    
    return indicators;
}
```

#### 3.3 Mapper层
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/mapper/XskhAssessmentApplicationApprovalMapper.java`

```java
/**
 * 根据考核方案ID查询关联的指标数据
 */
List<Object> selectIndicatorsByPlanId(Long planId);
```

**XML文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentApplicationApprovalMapper.xml`

```xml
<!-- 根据考核方案ID查询关联的指标数据 -->
<select id="selectIndicatorsByPlanId" parameterType="Long" resultType="java.util.Map">
    SELECT 
        i.id as indicatorId,
        i.indicator_code as indicatorCode,
        i.indicator_name as indicatorName,
        i.description,
        pi.max_score as maxScore,
        pi.weight,
        pi.sort_order as sortOrder
    FROM xskh_assessment_plan_indicator pi
    INNER JOIN xskh_assessment_indicator i ON pi.indicator_id = i.id
    WHERE pi.plan_id = #{planId}
    AND pi.deleted = 0
    AND i.deleted = 0
    ORDER BY pi.sort_order ASC, i.sort_order ASC
</select>
```

---

## 🔄 业务流程

### 1. 学生新增考核申请流程
```
1. 学生选择考核计划
2. 系统根据考核计划ID获取考核方案ID
3. 根据考核方案ID查询关联的指标数据
4. 将指标数据转换为表单格式
5. 填入指标模块表格中
6. 学生可以进行自评打分
```

### 2. 数据流转过程
```
前端选择考核计划 → 调用API接口 → 后端查询数据库 → 返回指标数据 → 前端渲染表格
```

---

## 📊 数据结构

### 返回的指标数据结构
```json
{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "indicatorId": 1,
      "indicatorCode": "ZD001",
      "indicatorName": "思想道德",
      "description": "思想道德表现",
      "maxScore": 20.00,
      "weight": 1.00,
      "sortOrder": 1
    },
    {
      "indicatorId": 2,
      "indicatorCode": "ZD002", 
      "indicatorName": "学习表现",
      "description": "学习表现情况",
      "maxScore": 30.00,
      "weight": 1.00,
      "sortOrder": 2
    }
  ]
}
```

### 转换后的表单数据结构
```typescript
{
  id: undefined,
  applicationId: undefined,
  indicatorId: 1,
  indicatorName: "思想道德",
  indicatorCode: "ZD001",
  indicatorDescription: "思想道德表现",
  indicatorMaxScore: 20,
  planMaxScore: 20,
  sortOrder: 1,
  selfScore: 0,
  selfRemark: "",
  teacherScore: 0,
  teacherRemark: ""
}
```

---

## 🔐 权限配置

### API权限
- **权限字符**: `assessment:application:query`
- **说明**: 查询考核申请相关数据的权限
- **应用**: 获取指标数据接口

### 菜单权限
- 无需额外配置，复用现有的考核申请查询权限

---

## 🧪 测试验证

### 1. 功能测试
- [ ] 选择不同的考核计划，验证指标数据是否正确获取
- [ ] 验证指标数据的完整性和准确性
- [ ] 验证排序是否正确
- [ ] 验证最高分值是否正确显示

### 2. 异常测试
- [ ] 考核计划不存在的情况
- [ ] 考核方案未关联指标的情况
- [ ] 网络异常的情况
- [ ] 权限不足的情况

### 3. 性能测试
- [ ] 大量指标数据的加载性能
- [ ] 并发访问的性能表现

---

## 📝 注意事项

### 1. 开发注意事项
- 确保数据库表结构正确
- 注意逻辑删除字段的处理
- 保持数据一致性
- 做好异常处理

### 2. 部署注意事项
- 确保数据库脚本已执行
- 检查权限配置是否正确
- 验证API接口是否可访问

### 3. 维护注意事项
- 定期检查指标数据的完整性
- 监控API接口的响应时间
- 及时处理异常情况

---

## 🚀 后续优化

### 1. 功能优化
- 支持指标数据的缓存机制
- 添加指标数据的版本控制
- 支持指标数据的批量导入导出

### 2. 性能优化
- 优化SQL查询性能
- 添加数据库索引
- 实现数据分页加载

### 3. 用户体验优化
- 添加加载状态提示
- 优化错误提示信息
- 支持指标数据的搜索和筛选

---

**📅 开发完成时间**: 2025-01-03  
**👨‍💻 开发人员**: 系统开发团队  
**📋 文档版本**: v1.0.0