package model import "time" 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"` // TaskSourceType 标记 type=task 时 rel_id 指向哪个任务来源。 // // 职责边界: // 1. 只表达任务日程块的数据来源,不改变 Type 的 course/task 展示语义; // 2. task_item 表示 rel_id 指向 task_items.id,task_pool 表示 rel_id 指向 tasks.id; // 3. 课程事件保持空值,由迁移回填历史 task 事件,避免影响现有课程逻辑。 TaskSourceType string `gorm:"column:task_source_type;type:varchar(32);not null;default:'';index:idx_schedule_event_task_source;comment:任务来源 task_item/task_pool" json:"task_source_type,omitempty"` // MakeupForEventID 记录补做块来源事件,用于用户反馈未完成后的审计串联。 // // 说明: // 1. 只有主动调度生成补做块时写入; // 2. 不负责校验目标事件是否仍存在,正式 apply 链路需要在事务内重校验; // 3. 为空表示普通日程块或非补做块。 MakeupForEventID *int `gorm:"column:makeup_for_event_id;index:idx_schedule_event_makeup_for;comment:补做块对应的原 schedule_event.id" json:"makeup_for_event_id,omitempty"` // ActivePreviewID 记录主动调度预览来源,方便从正式日程反查触发链路。 // // 说明: // 1. 该字段只做审计与排障,不作为正式日程主键; // 2. preview 详情仍归 active_schedule_previews 表所有。 ActivePreviewID *string `gorm:"column:active_preview_id;type:varchar(64);index:idx_schedule_event_active_preview;comment:主动调度预览ID" json:"active_preview_id,omitempty"` CanBeEmbedded bool `gorm:"column:can_be_embedded;not null;default:0;comment:是否允许在此时段嵌入其他任务" json:"can_be_embedded"` StartTime time.Time `gorm:"column:start_time;type:time;comment:开始时间" json:"start_time"` EndTime time.Time `gorm:"column:end_time;type:time;comment:结束时间" json:"end_time"` } 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"` // 跨越的节数,给前端用来渲染宽度/高度 Status string `json:"status"` 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"` } // UserSmartPlanningMultiRequest 是“多任务类智能粗排”接口的请求体。 // // 设计说明: // 1. TaskClassIDs 至少包含 1 个任务类 ID; // 2. 实际业务建议传入 >=2 个,用于多任务类混排; // 3. 服务层会做去重与合法值过滤,接口层只做基础绑定校验。 type UserSmartPlanningMultiRequest struct { TaskClassIDs []int `json:"task_class_ids" binding:"required,min=1,dive,min=1"` } type UserRecentCompletedScheduleResponse struct { Events []RecentCompletedEventBrief `json:"events"` } type RecentCompletedEventBrief struct { ID int `json:"id"` //如果是嵌入的任务事件,这个ID是TaskClassItem的ID;如果是课程事件,这个ID是ScheduleEvent的ID Name string `json:"name"` Type string `json:"type"` CompletedTime string `json:"completed_time"` } type OngoingSchedule struct { ID int `json:"id"` // 这个 ID 是 ScheduleEvent 的 ID,不是 Schedule 的 ID Name string `json:"name"` Location string `json:"location"` Type string `json:"type"` TimeStatus string `json:"time_status"` // "upcoming", "ongoing" StartTime time.Time `json:"start_time"` EndTime time.Time `json:"end_time"` } // HybridScheduleEntry 表示"混合日程"中的一个时间块。 // // 设计目标: // 将既有日程(课程/已落库任务)与粗排建议的任务统一到同一结构中, // 供 ReAct 精排引擎在内存中操作。 // // Status 语义: // - "existing":已确定的日程,LLM 不可移动; // - "suggested":粗排建议的任务,LLM 可通过 Tool 调整时间。 type HybridScheduleEntry struct { Week int `json:"week"` DayOfWeek int `json:"day_of_week"` SectionFrom int `json:"section_from"` SectionTo int `json:"section_to"` Name string `json:"name"` Type string `json:"type"` // "course" | "task" Status string `json:"status"` // "existing" | "suggested" TaskItemID int `json:"task_item_id,omitempty"` // 仅 suggested 的 task 有值 TaskClassID int `json:"task_class_id,omitempty"` // 仅 suggested 的 task 有值,对应 TaskClass.ID EventID int `json:"event_id,omitempty"` // 仅 existing 有值 // CanBeEmbedded 表示该条 existing 课程块是否允许嵌入任务。 // 仅课程条目有意义,task 条目默认 false。 CanBeEmbedded bool `json:"can_be_embedded,omitempty"` // BlockForSuggested 表示该条目是否应当阻塞 suggested 任务占位。 // // 语义说明: // 1. suggested 条目默认 true(任务之间不能重叠); // 2. existing 课程若是“可嵌入且当前格子未被嵌入任务占用”,则为 false; // 3. existing 课程若不可嵌入,或该格子已有嵌入任务,则为 true。 // // 该字段用于工具层冲突判断,避免把“可嵌入课位”误判为硬冲突。 BlockForSuggested bool `json:"block_for_suggested,omitempty"` // ContextTag 是任务认知类型标签,仅在 suggested 任务中使用。 // 该标签用于日内优化时的“认知负荷分配”,例如: // 1. High-Logic:数学、编程、逻辑推理; // 2. Memory:记忆/背诵类; // 3. Review:复习/回顾类; // 4. General:通用任务。 ContextTag string `json:"context_tag,omitempty"` } func (ScheduleEvent) TableName() string { return "schedule_events" } func (Schedule) TableName() string { return "schedules" }