# 宿舍卫生检查API - 根据学生ID查询

## 概述

本文档描述了宿舍卫生检查模块中新增的API接口，用于根据学生ID查询该学生宿舍的卫生检查信息。

## API接口详情

### 根据学生ID查询卫生检查信息

**接口地址：** `GET /dormHygieneCheck/dormHygieneCheck/student/{studentId}`

**接口描述：** 根据学生ID查询该学生宿舍的所有卫生检查记录

**请求参数：**

| 参数名 | 类型 | 必填 | 位置 | 说明 |
|--------|------|------|------|------|
| studentId | Long | 是 | Path | 学生ID，关联xg_student_msg.id |

**请求示例：**
```http
GET /dormHygieneCheck/dormHygieneCheck/student/12345
```

**响应格式：**
```json
{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "id": 1,
      "checkTitle": "2024年春季宿舍卫生检查",
      "checkDate": "2024-03-15",
      "checkerId": 1001,
      "checkerName": "张老师",
      "checkType": "1",
      "checkLevel": "2",
      "roomId": 101,
      "roomCode": "1-101",
      "roomName": "1号楼101室",
      "buildingId": 1,
      "buildingName": "1号楼",
      "areaId": 1,
      "areaName": "东区",
      "campusId": 1,
      "campusName": "主校区",
      "totalScore": 85.5,
      "hygieneGrade": "B",
      "checkSummary": "整体卫生情况良好",
      "improvementSuggestions": "建议加强个人物品整理",
      "checkRemarks": "无",
      "createTime": "2024-03-15 10:00:00",
      "updateTime": "2024-03-15 10:00:00"
    }
  ]
}
```

**响应字段说明：**

| 字段名 | 类型 | 说明 |
|--------|------|------|
| id | Long | 卫生检查记录ID |
| checkTitle | String | 检查标题 |
| checkDate | Date | 检查日期 |
| checkerId | Long | 检查员ID |
| checkerName | String | 检查员姓名 |
| checkType | String | 检查类型（1日常检查 2专项检查 3突击检查 4复查） |
| checkLevel | String | 检查级别（1宿管员 2学院 3学校） |
| roomId | Long | 宿舍房间ID |
| roomCode | String | 房间编号 |
| roomName | String | 房间名称 |
| buildingId | Long | 宿舍楼ID |
| buildingName | String | 宿舍楼名称 |
| areaId | Long | 宿舍区ID |
| areaName | String | 宿舍区名称 |
| campusId | Long | 校区ID |
| campusName | String | 校区名称 |
| totalScore | Double | 宿舍总分（0-100分） |
| hygieneGrade | String | 卫生等级（A优秀 B良好 C合格 D不合格） |
| checkSummary | String | 检查总结 |
| improvementSuggestions | String | 整改建议 |
| checkRemarks | String | 检查备注 |
| createTime | Date | 创建时间 |
| updateTime | Date | 更新时间 |

**错误响应：**

```json
{
  "code": 400,
  "msg": "学生ID不能为空"
}
```

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": []
}
```

## 业务逻辑

### 查询流程

1. **参数验证**：验证学生ID是否为空
2. **查询学生评分记录**：通过学生ID在`xg_dorm_hygiene_student_score`表中查询相关记录
3. **提取卫生检查ID**：从学生评分记录中提取`hygiene_check_id`列表
4. **查询卫生检查信息**：根据卫生检查ID列表在`xg_dorm_hygiene_check`表中查询详细信息
5. **结果排序**：按创建时间倒序排列，返回最新的检查记录在前

### 数据库关联

- **主表**：`xg_dorm_hygiene_check`（宿舍卫生检查主表）
- **关联表**：`xg_dorm_hygiene_student_score`（学生评分表）
- **关联字段**：`hygiene_check_id`（卫生检查ID）

### 权限控制

- **权限标识**：`dormHygieneCheck:dormHygieneCheck:query`
- **权限说明**：需要宿舍卫生检查查询权限

## 使用场景

1. **学生个人查询**：学生查看自己宿舍的卫生检查历史记录
2. **辅导员查询**：辅导员查看特定学生的宿舍卫生情况
3. **统计分析**：统计某个学生的宿舍卫生检查趋势
4. **移动端展示**：在移动端应用中展示学生的卫生检查记录

## 注意事项

1. **数据过滤**：只返回未删除的记录（`deleted = 0`）
2. **性能优化**：使用索引优化查询性能
3. **日志记录**：记录查询操作日志，便于问题排查
4. **空数据处理**：当学生没有相关记录时，返回空数组而不是null

## 相关接口

- [宿舍卫生检查列表查询](./宿舍卫生检查管理API.md#查询宿舍卫生检查列表)
- [宿舍卫生检查详情查询](./宿舍卫生检查管理API.md#获取宿舍卫生检查详细信息)
- [学生评分管理](./宿舍卫生检查学生评分API.md)

## 更新记录

| 日期 | 版本 | 更新内容 | 更新人 |
|------|------|----------|--------|
| 2025-01-03 | 1.0 | 新增根据学生ID查询卫生检查信息接口 | zlwu |