d07234e183
feat: 🗑️ 新增删除单个课程与解除安排日程接口 - 逻辑复杂，初版接口写完后才发现需求需要传切片 - 针对需求修改，通过大 for 循环和事务处理来解决问题 🔄 refactor: 🔧 移除部分冗余的用户 ID 验证逻辑 - sv/schedule.go 中，进来的 ID 已通过 redis 黑名单与 JWT 保护验证 - 去除重复的数据库查验，优化了代码流程 🛠️ refactor: 🔄 重构 API 层业务错误判断逻辑 - 抛弃了原有的手动比对方式，封装进 `respond` 包，简化判断流程 - 未来不再手动遍历数据链路，提升了开发效率 🧹 undo: ⚠️ 修复任务块添加到日程的接口问题（待修复） - 接口允许直接修改已经安排的任务时间，且重复执行时未被禁止 - 此逻辑存在问题，计划在下个版本修复 🔧 undo: ⚠️ 重测接口的幂等性与其他特性 - 当前接口幂等性等特性尚未专门测试，后续计划重测所有接口 - 测试不充分，待进一步完善 🔄 undo: ⚠️ 修复刷新 token 接口错误处理问题 - 当前接口将 token 本身的错误以 500 错误返回，需修复此问题 🛠️
98 lines
4.9 KiB
Go
98 lines
4.9 KiB
Go
package model
|
||
|
||
type ScheduleEvent struct {
|
||
ID int `gorm:"primaryKey;autoIncrement" json:"id"`
|
||
UserID int `gorm:"column:user_id;index:idx_user_events;not null" json:"user_id"`
|
||
Name string `gorm:"column:name;type:varchar(255);not null;comment:课程或任务名称" json:"name"`
|
||
Location *string `gorm:"column:location;type:varchar(255);default:'';comment:地点 (教学楼/会议室)" json:"location"`
|
||
Type string `gorm:"column:type;type:enum('course','task');not null;comment:日程类型" json:"type"`
|
||
RelID *int `gorm:"column:rel_id;comment:关联原始数据ID (如教务系统的课程ID)" json:"rel_id"`
|
||
CanBeEmbedded bool `gorm:"column:can_be_embedded;not null;default:0;comment:是否允许在此时段嵌入其他任务" json:"can_be_embedded"`
|
||
}
|
||
|
||
type Schedule struct {
|
||
ID int `gorm:"primaryKey;autoIncrement" json:"id"`
|
||
EventID int `gorm:"column:event_id;index:idx_event_id;not null;comment:关联元数据ID" json:"event_id"`
|
||
UserID int `gorm:"column:user_id;uniqueIndex:idx_user_slot_atomic,priority:1;not null;comment:冗余UID方便直接查询" json:"user_id"`
|
||
Week int `gorm:"column:week;uniqueIndex:idx_user_slot_atomic,priority:2;not null;comment:周次 (1-25)" json:"week"`
|
||
DayOfWeek int `gorm:"column:day_of_week;uniqueIndex:idx_user_slot_atomic,priority:3;not null;comment:星期 (1-7)" json:"day_of_week"`
|
||
Section int `gorm:"column:section;uniqueIndex:idx_user_slot_atomic,priority:4;not null;comment:原子化节次 (1-12)" json:"section"`
|
||
EmbeddedTaskID *int `gorm:"column:embedded_task_id;comment:若为水课嵌入，记录具体的任务项ID" json:"embedded_task_id"`
|
||
Status string `gorm:"column:status;type:enum('normal','interrupted');default:'normal';comment:状态: 正常/因故中断" json:"status"`
|
||
// 💡 必须加上这一行，告诉 GORM 如何关联元数据
|
||
Event ScheduleEvent `gorm:"foreignKey:EventID" json:"event"`
|
||
EmbeddedTask *TaskClassItem `gorm:"foreignKey:EmbeddedTaskID" json:"embedded_task"`
|
||
}
|
||
|
||
type ScheduleConflictDetail struct {
|
||
EventID int `json:"event_id"`
|
||
Name string `json:"name"`
|
||
Location string `json:"location"`
|
||
DayOfWeek int `json:"day_of_week"`
|
||
Week int `json:"week"`
|
||
Sections []int `json:"sections"`
|
||
StartSection int `json:"start_section"`
|
||
EndSection int `json:"end_section"`
|
||
Type string `json:"type"`
|
||
EmbeddedTasks []ScheduleEmbeddedTask `json:"embedded_tasks"`
|
||
}
|
||
|
||
type ScheduleEmbeddedTask struct {
|
||
Section int `json:"section"`
|
||
TaskID int `json:"task_id"`
|
||
}
|
||
|
||
type UserTodaySchedule struct {
|
||
DayOfWeek int `json:"day_of_week"`
|
||
Week int `json:"week"`
|
||
Events []EventBrief `json:"events"`
|
||
}
|
||
|
||
type EventBrief struct {
|
||
ID int `json:"id"` // 这个 ID 是 ScheduleEvent 的 ID，不是 Schedule 的 ID
|
||
Order int `json:"order"` // order 用于区分它们的显示顺序
|
||
Name string `json:"name"`
|
||
StartTime string `json:"start_time"`
|
||
EndTime string `json:"end_time"`
|
||
Location string `json:"location"`
|
||
Type string `json:"type"`
|
||
Span int `json:"span"` // 跨越的节数，给前端用来渲染宽度/高度
|
||
EmbeddedTaskInfo TaskBrief `json:"embedded_task_info,omitempty"`
|
||
}
|
||
|
||
type TaskBrief struct {
|
||
ID int `json:"id"` // 这个 ID 是 ScheduleEvent 的 ID，不是 Schedule 的 ID
|
||
Name string `json:"name"`
|
||
/*StartTime string `json:"start_time"`
|
||
EndTime string `json:"end_time"`*/
|
||
Type string `json:"type"`
|
||
}
|
||
|
||
type UserWeekSchedule struct {
|
||
Week int `json:"week"`
|
||
Events []WeeklyEventBrief `json:"events"`
|
||
}
|
||
|
||
type WeeklyEventBrief struct {
|
||
ID int `json:"id"` // 这个 ID 是 ScheduleEvent 的 ID，不是 Schedule 的 ID
|
||
Order int `json:"order"` // order 用于区分它们在一天中的显示顺序
|
||
DayOfWeek int `json:"day_of_week"`
|
||
Name string `json:"name"`
|
||
StartTime string `json:"start_time"`
|
||
EndTime string `json:"end_time"`
|
||
Location string `json:"location"`
|
||
Type string `json:"type"`
|
||
Span int `json:"span"` // 跨越的节数，给前端用来渲染宽度/高度
|
||
EmbeddedTaskInfo TaskBrief `json:"embedded_task_info,omitempty"`
|
||
}
|
||
|
||
type UserDeleteScheduleEvent struct {
|
||
ID int `json:"id"` // 这个 ID 是 ScheduleEvent 的 ID，不是 Schedule 的 ID
|
||
DeleteCourse bool `json:"delete_course"`
|
||
DeleteEmbeddedTask bool `json:"delete_embedded_task"`
|
||
}
|
||
|
||
func (ScheduleEvent) TableName() string { return "schedule_events" }
|
||
|
||
func (Schedule) TableName() string { return "schedules" }
|