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

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

概述

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

API接口详情

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

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

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

请求参数：

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

请求示例：

GET /dormHygieneCheck/dormHygieneCheck/student/12345

响应格式：

{
  "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	更新时间

错误响应：

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

{
  "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

相关接口

• 宿舍卫生检查列表查询
• 宿舍卫生检查详情查询
• 学生评分管理

更新记录

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