all-project/docs/开发文档/API/假期留宿管理API.md

假期留宿管理 API

学生申请留宿

• 接口: POST /holidayStay/holidayStay/apply
• 权限: holidayStay:holidayStay:apply

必填业务字段（库表 NOT NULL）

字段	说明
holidayType	假期类型
applyStartDate / applyEndDate	留宿起止时间
stayReason	留宿原因
studentPhone	学生联系电话（档案无电话时须前端手动填写）
emergencyContact	紧急联系人
emergencyPhone	紧急联系电话

说明（2026-10-15）：

• 库表已支持 student_phone 可空（见 docs/设计文档/database/假期留宿_student_phone允许为空.sql），仅执行 SQL 即可先解除线上报错、无需发版。
• 代码侧仍建议保留校验/友好提示；档案 phone 为空时不会把表单空串覆盖为 null。

自动填充

• 学生信息快照：学号/姓名/班级/专业/学院（按当前登录学生）
• 宿舍快照：当前在住床位（无床位则拒绝申请）
• 申请状态：1（待审批）