wuzhen 更新假期住宿申请

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

@@ -20,7 +20,7 @@
 - [宿舍管理员授权API](./宿舍管理员授权API.md)
 - [学生管理员授权关系API](./学生管理员授权关系API.md)
 - [学生销假管理API](./学生销假管理API.md)
-- [假期留宿管理API](./假期留宿管理API.md) - **重要修复：单人留宿计算逻辑**（2025-01-03）
+- [假期留宿管理API](./假期留宿管理API.md) - **申请/班主任一级审批/撤销/导出**（2026-08-04）
 - [均化处理最高分值API](./均化处理最高分值API.md) - **新增**：支持考核申请均化处理功能（2025-01-03）
 
 ### 1. 用户认证登录

docs/开发文档/API/宿舍卫生检查管理API.md

@@ -34,6 +34,8 @@
 - 单项分数必须在对应类型的 min-max 范围内
 - 合计扣分上限 100 分
 - 历史单条数据迁移：以主表 `total_score` 作为唯一明细的 score
+- **归属班级（classId/className）必填**：选项仅来自当前寝室在住学生的班级（去重）；默认选中第一项；用于宿舍扣分归属统计
+- **班级选项数据来源**：`GET /dormBedStudent/dormBedStudent/getRoomStudents` 须返回 `classId`、`className`（以及 collegeId/majorId）；前端按 `classId` 去重生成下拉，缺 `classId` 时会出现「当前寝室无在住学生班级」
 
 ## API接口规范
 
@@ -59,6 +61,8 @@
   "areaName": "东区",
   "campusId": 1,
   "campusName": "主校区",
+  "classId": 10001,
+  "className": "计算机应用技术2301班",
   "totalScore": 85.5,
   "deductionItems": [
     {
@@ -315,6 +319,7 @@ public interface DormHygieneStudentScoreMapper extends BaseMapperPlus<DormHygien
 - `checkDate`: 必填，日期时间格式
 - `checkerId`: 必填，关联用户表
 - `roomId`: 必填，关联房间表
+- `classId` / `className`: **必填**，宿舍扣分归属班级；选项须为当前寝室在住学生班级
 - `totalScore`: 可选，0-100分（由 deductionItems 合计自动计算，只读）
 - `deductionItems`: 可选，扣分明细数组；每项 score 默认 minScore，可在类型 min-max 内调整；合计不超过100
 - `hygieneGrade`: 可选，A/B/C/D

docs/设计文档/database/hzdyjs_xg0820.sql

@@ -4376,6 +4376,8 @@ CREATE TABLE `xg_dorm_hygiene_check` (
   `area_name` varchar(100) DEFAULT NULL COMMENT '宿舍区名称',
   `campus_id` bigint(20) DEFAULT NULL COMMENT '校区ID，关联xg_dorm_campus.id',
   `campus_name` varchar(100) DEFAULT NULL COMMENT '校区名称',
+  `class_id` bigint(20) DEFAULT NULL COMMENT '归属班级ID（宿舍扣分归属）',
+  `class_name` varchar(100) DEFAULT NULL COMMENT '归属班级名称',
   `total_score` decimal(5,2) DEFAULT NULL COMMENT '宿舍扣分（0-100分）',
   `hygiene_grade` char(1) DEFAULT NULL COMMENT '卫生等级（A优秀 B良好 C合格 D不合格）',
   `attachment_ids` text COMMENT '附件OSS ID列表，逗号分隔',
@@ -4388,6 +4390,7 @@ CREATE TABLE `xg_dorm_hygiene_check` (
   KEY `idx_tenant_id` (`tenant_id`),
   KEY `idx_deleted` (`deleted`),
   KEY `idx_check_date` (`check_date`),
+  KEY `idx_class_id` (`class_id`),
   KEY `idx_checker_id` (`checker_id`),
   KEY `idx_room_id` (`room_id`),
   KEY `idx_building_id` (`building_id`),