// ===========================================
// 多班级版班级管理系统 - Go 后端
//
// 开发者: Canglan
// 联系方式: admin@sea-studio.top
// 版权归属: Sea Network Technology Studio
// 许可证: Apache License 2.0
//
// 版权所有 © Sea Network Technology Studio
// ===========================================

package schema

// RankingQuery 排行榜查询参数
type RankingQuery struct {
	Type  string `form:"type" binding:"omitempty,oneof=attendance homework conduct all"`
	Limit int    `form:"limit,default=50" binding:"min=1,max=1000"`
}

// ParentHistoryQuery 家长历史记录查询参数
type ParentHistoryQuery struct {
	Page     int `form:"page,default=1" binding:"min=1"`
	PageSize int `form:"page_size,default=20" binding:"min=1,max=100"`
}

// StudentConductQuery 学生操行分查询参数
type StudentConductQuery struct {
	Limit  int `form:"limit,default=50" binding:"min=1"`
	Offset int `form:"offset,default=0" binding:"min=0"`
}

// StudentAttendanceQuery 学生考勤查询参数
type StudentAttendanceQuery struct {
	Month string `form:"month"`
}

// CadreHomeworkQuery 课代表作业查询参数
type CadreHomeworkQuery struct {
	SubjectID *int `form:"subject_id"`
	Page      int  `form:"page,default=1" binding:"min=1"`
	PageSize  int  `form:"page_size,default=20" binding:"min=1,max=100"`
}

// CadreHomeworkSubmitRequest 课代表发布作业请求
// SubjectID 由后端从管理员角色中自动获取，无需前端传递
type CadreHomeworkSubmitRequest struct {
	Title       string `json:"title" binding:"required"`
	Description string `json:"description"`
	Deadline    string `json:"deadline" binding:"required"`
}