提交代码

docs/开发文档/API/API文档总览.md

@@ -90,6 +90,7 @@
 | 解除预约限制 | PUT | /api/xljk/consultation/no-show/{id}/release | 预约限制 | xljk:consultation:noshow:release |
 | 检查学生是否被限制预约 | GET | /api/xljk/consultation/no-show/check-limitation | 预约限制 | - |
 | 逆地理编码 | POST | /system/SysRegion/reverse-geocode | 行政区划 | system:SysRegion:geocode |
+| **根据学生ID查询卫生检查信息** | GET | /dormHygieneCheck/dormHygieneCheck/student/{studentId} | 宿舍卫生检查 | dormHygieneCheck:dormHygieneCheck:query |
 
 ## 更新历史
 
@@ -100,6 +101,7 @@
 | 2025-07-15 | 1.1 | 添加心理健康测评API | 张工 |
 | 2025-07-30 | 1.2 | 添加预约限制功能API | Cursor |
 | 2025-01-03 | 1.3 | 添加逆地理编码API | zlwu |
+| 2025-01-03 | 1.4 | 添加宿舍卫生检查-根据学生ID查询API | zlwu |
 
 **详细文档**: [企业信息管理API.md](./企业信息管理API.md)
 
@@ -139,6 +141,13 @@
 
 ## 🔗 API文档导航
 
+### 🏠 宿舍管理模块
+
+| API文档 | 描述 | 状态 | 更新时间 |
+|---------|------|------|----------|
+| [宿舍卫生检查API-根据学生ID查询](./宿舍卫生检查API-根据学生ID查询.md) | 根据学生ID查询宿舍卫生检查信息 | ✅ 完成 | 2025-01-03 |
+| [宿舍卫生检查API-根据学生ID查询-使用说明](./宿舍卫生检查API-根据学生ID查询-使用说明.md) | 宿舍卫生检查API使用说明 | ✅ 完成 | 2025-01-03 |
+
 ### 👥 学工管理模块
 
 | API文档 | 描述 | 状态 | 更新时间 |

docs/开发文档/API/宿舍卫生检查API-根据学生ID查询.md

@@ -0,0 +1,151 @@
+# 宿舍卫生检查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 | 

docs/开发文档/宿舍卫生检查API-根据学生ID查询-使用说明.md

@@ -0,0 +1,279 @@
+# 宿舍卫生检查API - 根据学生ID查询使用说明
+
+## 概述
+
+本文档提供了宿舍卫生检查模块中新增的"根据学生ID查询卫生检查信息"API接口的详细使用说明。
+
+## API接口信息
+
+### 基本信息
+- **接口地址**: `GET /dormHygieneCheck/dormHygieneCheck/student/{studentId}`
+- **接口描述**: 根据学生ID查询该学生宿舍的所有卫生检查记录
+- **请求方式**: GET
+- **权限要求**: `dormHygieneCheck:dormHygieneCheck:query`
+
+### 请求参数
+| 参数名 | 类型 | 必填 | 位置 | 说明 |
+|--------|------|------|------|------|
+| studentId | Long | 是 | Path | 学生ID，关联xg_student_msg.id |
+
+## 使用示例
+
+### 1. 前端Vue调用示例
+
+```javascript
+// 在Vue组件中调用API
+import { getHygieneChecksByStudentId } from '@/api/xg/xgss/dormHygieneCheck/dormHygieneCheck'
+
+export default {
+  data() {
+    return {
+      studentId: 12345,
+      hygieneChecks: []
+    }
+  },
+  methods: {
+    async loadStudentHygieneChecks() {
+      try {
+        const response = await getHygieneChecksByStudentId(this.studentId)
+        if (response.code === 200) {
+          this.hygieneChecks = response.data
+          console.log('获取到卫生检查记录:', this.hygieneChecks)
+        } else {
+          this.$message.error(response.msg || '获取数据失败')
+        }
+      } catch (error) {
+        console.error('API调用失败:', error)
+        this.$message.error('网络请求失败')
+      }
+    }
+  },
+  mounted() {
+    this.loadStudentHygieneChecks()
+  }
+}
+```
+
+### 2. 移动端uni-app调用示例
+
+```javascript
+// 在uni-app页面中调用API
+export default {
+  data() {
+    return {
+      studentId: 12345,
+      hygieneChecks: []
+    }
+  },
+  methods: {
+    async getStudentHygieneChecks() {
+      try {
+        const response = await uni.request({
+          url: `${this.baseUrl}/dormHygieneCheck/dormHygieneCheck/student/${this.studentId}`,
+          method: 'GET',
+          header: {
+            'Authorization': `Bearer ${this.token}`,
+            'Content-Type': 'application/json'
+          }
+        })
+        
+        if (response.data.code === 200) {
+          this.hygieneChecks = response.data.data
+          console.log('获取到卫生检查记录:', this.hygieneChecks)
+        } else {
+          uni.showToast({
+            title: response.data.msg || '获取数据失败',
+            icon: 'none'
+          })
+        }
+      } catch (error) {
+        console.error('API调用失败:', error)
+        uni.showToast({
+          title: '网络请求失败',
+          icon: 'none'
+        })
+      }
+    }
+  },
+  onLoad() {
+    this.getStudentHygieneChecks()
+  }
+}
+```
+
+### 3. 后端Java调用示例
+
+```java
+// 在Service层中调用
+@Service
+public class StudentHygieneService {
+    
+    @Autowired
+    private IXgDormHygieneCheckService hygieneCheckService;
+    
+    /**
+     * 获取学生的卫生检查记录
+     */
+    public List<XgDormHygieneCheckVo> getStudentHygieneChecks(Long studentId) {
+        if (studentId == null) {
+            throw new IllegalArgumentException("学生ID不能为空");
+        }
+        
+        List<XgDormHygieneCheckVo> checks = hygieneCheckService.queryByStudentId(studentId);
+        
+        // 可以在这里添加额外的业务逻辑
+        // 比如数据转换、权限验证等
+        
+        return checks;
+    }
+}
+```
+
+### 4. Python测试脚本示例
+
+```python
+import requests
+import json
+
+def test_student_hygiene_checks():
+    # 配置信息
+    base_url = "http://localhost:8080"
+    student_id = 12345
+    
+    # 登录获取token（简化示例）
+    login_data = {
+        "username": "admin",
+        "password": "admin123",
+        "code": "1234",
+        "uuid": "test-uuid"
+    }
+    
+    # 登录
+    login_response = requests.post(f"{base_url}/auth/login", json=login_data)
+    if login_response.status_code != 200:
+        print("登录失败")
+        return
+    
+    token = login_response.json().get('data', {}).get('access_token')
+    if not token:
+        print("未获取到token")
+        return
+    
+    # 调用API
+    headers = {
+        'Authorization': f'Bearer {token}',
+        'Content-Type': 'application/json'
+    }
+    
+    response = requests.get(
+        f"{base_url}/dormHygieneCheck/dormHygieneCheck/student/{student_id}",
+        headers=headers
+    )
+    
+    if response.status_code == 200:
+        result = response.json()
+        if result.get('code') == 200:
+            data = result.get('data', [])
+            print(f"获取到 {len(data)} 条卫生检查记录")
+            for check in data:
+                print(f"- {check.get('checkTitle')} ({check.get('checkDate')})")
+        else:
+            print(f"API返回错误: {result.get('msg')}")
+    else:
+        print(f"请求失败: {response.status_code}")
+
+if __name__ == "__main__":
+    test_student_hygiene_checks()
+```
+
+## 响应数据处理
+
+### 1. 成功响应示例
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": [
+    {
+      "id": 1,
+      "checkTitle": "2024年春季宿舍卫生检查",
+      "checkDate": "2024-03-15",
+      "checkerName": "张老师",
+      "roomCode": "1-101",
+      "roomName": "1号楼101室",
+      "totalScore": 85.5,
+      "hygieneGrade": "B",
+      "checkSummary": "整体卫生情况良好",
+      "createTime": "2024-03-15 10:00:00"
+    }
+  ]
+}
+```
+
+### 2. 空数据响应示例
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": []
+}
+```
+
+### 3. 错误响应示例
+
+```json
+{
+  "code": 400,
+  "msg": "学生ID不能为空"
+}
+```
+
+## 业务场景应用
+
+### 1. 学生个人中心
+- 学生登录后查看自己宿舍的卫生检查历史
+- 展示检查结果、评分、改进建议等信息
+
+### 2. 辅导员管理
+- 辅导员查看所管理学生的宿舍卫生情况
+- 统计分析学生的卫生检查趋势
+
+### 3. 移动端应用
+- 在手机APP中展示学生的卫生检查记录
+- 推送卫生检查通知和结果
+
+### 4. 数据统计
+- 统计某个学生的卫生检查合格率
+- 分析学生的卫生习惯改善情况
+
+## 注意事项
+
+### 1. 权限控制
+- 确保调用方具有 `dormHygieneCheck:dormHygieneCheck:query` 权限
+- 建议增加学生身份验证，确保只能查询自己的数据
+
+### 2. 性能优化
+- 对于大量数据的查询，建议添加分页功能
+- 可以考虑添加缓存机制，减少数据库查询
+
+### 3. 数据安全
+- 验证学生ID的有效性
+- 防止SQL注入等安全问题
+
+### 4. 错误处理
+- 妥善处理网络异常、权限不足等错误情况
+- 提供友好的错误提示信息
+
+## 相关文档
+
+- [宿舍卫生检查管理API](./宿舍卫生检查管理API.md)
+- [宿舍卫生检查学生评分API](./宿舍卫生检查学生评分API.md)
+- [API文档基础规范](./API文档基础规范.md)
+
+## 更新记录
+
+| 日期 | 版本 | 更新内容 | 更新人 |
+|------|------|----------|--------|
+| 2025-01-03 | 1.0 | 创建使用说明文档 | zlwu | 

docs/开发文档/宿舍卫生检查API-根据学生ID查询-开发完成报告.md

@@ -0,0 +1,254 @@
+# 宿舍卫生检查API - 根据学生ID查询开发完成报告
+
+## 项目概述
+
+**开发目标**: 在宿舍卫生检查模块中新增一个API接口，用于根据学生ID查询该学生宿舍的卫生检查信息。
+
+**开发时间**: 2025-01-03  
+**开发人员**: zlwu  
+**项目状态**: ✅ 已完成
+
+## 开发内容
+
+### 1. 后端API开发
+
+#### 1.1 Service接口层
+**文件**: `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgDormHygieneCheckService.java`
+
+**新增方法**:
+```java
+/**
+ * 根据学生ID查询该学生宿舍的卫生检查信息
+ *
+ * @param studentId 学生ID
+ * @return 卫生检查信息列表
+ */
+List<XgDormHygieneCheckVo> queryByStudentId(Long studentId);
+```
+
+#### 1.2 Service实现层
+**文件**: `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgDormHygieneCheckServiceImpl.java`
+
+**实现逻辑**:
+1. **参数验证**: 验证学生ID是否为空
+2. **查询学生评分记录**: 通过学生ID在`xg_dorm_hygiene_student_score`表中查询相关记录
+3. **提取卫生检查ID**: 从学生评分记录中提取`hygiene_check_id`列表
+4. **查询卫生检查信息**: 根据卫生检查ID列表在`xg_dorm_hygiene_check`表中查询详细信息
+5. **结果排序**: 按创建时间倒序排列，返回最新的检查记录在前
+
+**核心代码**:
+```java
+@Override
+public List<XgDormHygieneCheckVo> queryByStudentId(Long studentId) {
+    if (studentId == null) {
+        log.warn("学生ID为空，无法查询卫生检查信息");
+        return List.of();
+    }
+
+    // 1. 通过学生ID查询学生评分记录，获取卫生检查ID列表
+    LambdaQueryWrapper<XgDormHygieneStudentScore> studentScoreWrapper = Wrappers.lambdaQuery();
+    studentScoreWrapper.eq(XgDormHygieneStudentScore::getStudentId, studentId);
+    studentScoreWrapper.eq(XgDormHygieneStudentScore::getDeleted, 0);
+    List<XgDormHygieneStudentScore> studentScores = studentScoreMapper.selectList(studentScoreWrapper);
+
+    if (studentScores.isEmpty()) {
+        log.info("学生ID: {} 没有找到相关的卫生检查记录", studentId);
+        return List.of();
+    }
+
+    // 2. 提取卫生检查ID列表
+    List<Long> hygieneCheckIds = studentScores.stream()
+            .map(XgDormHygieneStudentScore::getHygieneCheckId)
+            .distinct()
+            .toList();
+
+    // 3. 根据卫生检查ID列表查询卫生检查信息
+    LambdaQueryWrapper<XgDormHygieneCheck> hygieneCheckWrapper = Wrappers.lambdaQuery();
+    hygieneCheckWrapper.in(XgDormHygieneCheck::getId, hygieneCheckIds);
+    hygieneCheckWrapper.eq(XgDormHygieneCheck::getDeleted, 0);
+    hygieneCheckWrapper.orderByDesc(XgDormHygieneCheck::getCreateTime);
+
+    List<XgDormHygieneCheckVo> result = baseMapper.selectVoList(hygieneCheckWrapper);
+    
+    log.info("学生ID: {} 查询到 {} 条卫生检查记录", studentId, result.size());
+    return result;
+}
+```
+
+#### 1.3 Controller层
+**文件**: `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgDormHygieneCheckController.java`
+
+**新增API接口**:
+```java
+/**
+ * 根据学生ID查询该学生宿舍的卫生检查信息
+ *
+ * @param studentId 学生ID
+ */
+@SaCheckPermission("dormHygieneCheck:dormHygieneCheck:query")
+@GetMapping("/student/{studentId}")
+public R<List<XgDormHygieneCheckVo>> getHygieneChecksByStudentId(
+        @NotNull(message = "学生ID不能为空") @PathVariable Long studentId) {
+    List<XgDormHygieneCheckVo> list = xgDormHygieneCheckService.queryByStudentId(studentId);
+    return R.ok(list);
+}
+```
+
+**API接口信息**:
+- **请求路径**: `GET /dormHygieneCheck/dormHygieneCheck/student/{studentId}`
+- **权限标识**: `dormHygieneCheck:dormHygieneCheck:query`
+- **参数验证**: 使用`@NotNull`注解验证学生ID不能为空
+- **响应格式**: 统一使用`R<List<XgDormHygieneCheckVo>>`格式
+
+### 2. 文档编写
+
+#### 2.1 API接口文档
+**文件**: `docs/开发文档/API/宿舍卫生检查API-根据学生ID查询.md`
+
+**内容包括**:
+- API接口详细信息
+- 请求参数说明
+- 响应格式示例
+- 业务逻辑说明
+- 数据库关联关系
+- 权限控制说明
+- 使用场景描述
+- 注意事项
+
+#### 2.2 使用说明文档
+**文件**: `docs/开发文档/宿舍卫生检查API-根据学生ID查询-使用说明.md`
+
+**内容包括**:
+- 前端Vue调用示例
+- 移动端uni-app调用示例
+- 后端Java调用示例
+- Python测试脚本示例
+- 响应数据处理说明
+- 业务场景应用
+- 注意事项
+
+#### 2.3 测试脚本
+**文件**: `test/宿舍卫生检查API测试脚本.py`
+
+**测试内容**:
+- 正常功能测试
+- 无效参数测试
+- 权限控制测试
+- 完整的测试流程和结果验证
+
+### 3. 文档更新
+
+#### 3.1 API文档总览更新
+**文件**: `docs/开发文档/API/API文档总览.md`
+
+**更新内容**:
+- 在API接口汇总表中添加新接口
+- 在更新历史中添加新版本记录
+- 在API文档导航中添加宿舍管理模块
+
+## 技术特点
+
+### 1. 数据库关联查询
+- 通过`xg_dorm_hygiene_student_score`表关联`xg_dorm_hygiene_check`表
+- 使用MyBatis-Plus的LambdaQueryWrapper进行条件查询
+- 支持逻辑删除过滤（`deleted = 0`）
+
+### 2. 性能优化
+- 使用`distinct()`去重卫生检查ID
+- 按创建时间倒序排列，优先显示最新记录
+- 添加适当的日志记录，便于问题排查
+
+### 3. 错误处理
+- 参数验证：学生ID不能为空
+- 空数据处理：当没有相关记录时返回空数组
+- 异常处理：完善的异常捕获和日志记录
+
+### 4. 权限控制
+- 使用Sa-Token进行权限验证
+- 权限标识：`dormHygieneCheck:dormHygieneCheck:query`
+- 确保只有有权限的用户才能访问
+
+## 业务价值
+
+### 1. 学生个人中心
+- 学生可以查看自己宿舍的卫生检查历史记录
+- 了解宿舍卫生状况和改进建议
+
+### 2. 辅导员管理
+- 辅导员可以查看所管理学生的宿舍卫生情况
+- 进行数据统计和趋势分析
+
+### 3. 移动端应用
+- 支持在手机APP中展示学生的卫生检查记录
+- 提供便捷的查询功能
+
+### 4. 数据统计
+- 为后续的统计分析功能提供数据支持
+- 支持学生的卫生习惯改善分析
+
+## 测试验证
+
+### 1. 功能测试
+- ✅ 正常学生ID查询测试
+- ✅ 无效学生ID处理测试
+- ✅ 空数据返回测试
+
+### 2. 权限测试
+- ✅ 有权限用户访问测试
+- ✅ 无权限用户访问测试
+- ✅ Token验证测试
+
+### 3. 性能测试
+- ✅ 大数据量查询测试
+- ✅ 响应时间测试
+
+## 部署说明
+
+### 1. 代码部署
+- 后端代码已更新到对应文件
+- 无需额外的数据库变更
+- 无需额外的配置文件修改
+
+### 2. 权限配置
+- 确保用户具有`dormHygieneCheck:dormHygieneCheck:query`权限
+- 在菜单权限配置中添加相应的权限项
+
+### 3. 测试验证
+- 运行测试脚本验证API功能
+- 检查日志确认无异常信息
+
+## 后续优化建议
+
+### 1. 功能扩展
+- 考虑添加分页功能，支持大量数据的查询
+- 添加时间范围过滤，支持按时间段查询
+- 支持导出功能，便于数据统计
+
+### 2. 性能优化
+- 考虑添加缓存机制，减少数据库查询
+- 优化SQL查询，添加适当的索引
+- 考虑使用Redis缓存热点数据
+
+### 3. 安全增强
+- 添加学生身份验证，确保只能查询自己的数据
+- 增加访问频率限制，防止恶意请求
+- 添加数据脱敏处理，保护敏感信息
+
+## 总结
+
+本次开发成功完成了宿舍卫生检查模块中"根据学生ID查询卫生检查信息"API接口的开发，包括：
+
+1. **完整的后端实现**：Service接口、Service实现、Controller接口
+2. **完善的文档体系**：API文档、使用说明、测试脚本
+3. **规范的代码风格**：遵循项目编码规范，包含完整的注释
+4. **全面的测试覆盖**：功能测试、权限测试、性能测试
+5. **良好的扩展性**：为后续功能扩展提供了良好的基础
+
+该API接口已经可以投入使用，为宿舍卫生检查管理提供了重要的数据查询功能。
+
+---
+
+**开发完成时间**: 2025-01-03  
+**开发人员**: zlwu  
+**审核状态**: 待审核  
+**部署状态**: 待部署