feat: 🚀 新增智能编排日程接口与算法模块 * 新增智能编排日程接口,实现自动生成周维度课程安排 * 抽离核心算法至 `Logic` 包,统一存放调度与排课相关算法逻辑,优化项目结构分层 * 大多数用例测试通过,当前存在少量边界用例下“排课时间是否充足”的误判问题 * 返回的周视图数据在极端场景下存在数量偏差,待进一步完善边界控制 fix: 🐛 修复批量导入课程接口 500 错误 * 修复批量导入课程接口中未在 `event` 结构体填写时间字段的问题 * 解决因时间字段为空导致的服务端 500 错误,保证数据完整性 refactor: ♻️ 新增入参校验逻辑保障调度稳定性 * 在添加任务类时新增入参校验逻辑 * 避免非法数据进入调度流程,确保自动编排日程接口执行稳定 docs: 📚 更新 README 智能编排算法说明 * 补充智能编排日程算法的设计思路与实现说明 undo: ⚠️ 追加导入课程后缓存未自动失效 * 追加导入课程后未自动删除对应周安排缓存,存在数据不一致风险 * 当前未能稳定复现,计划后续定位缓存失效时序与触发条件问题
152 lines
4.7 KiB
Go
152 lines
4.7 KiB
Go
package service
|
|
|
|
import (
|
|
"context"
|
|
"strings"
|
|
|
|
"github.com/LoveLosita/smartflow/backend/conv"
|
|
"github.com/LoveLosita/smartflow/backend/dao"
|
|
"github.com/LoveLosita/smartflow/backend/model"
|
|
"github.com/LoveLosita/smartflow/backend/respond"
|
|
)
|
|
|
|
type CourseService struct {
|
|
// 伸出手:准备接住 DAO
|
|
courseDAO *dao.CourseDAO
|
|
scheduleDAO *dao.ScheduleDAO
|
|
}
|
|
|
|
// NewCourseService 创建 CourseService 实例
|
|
func NewCourseService(courseDAO *dao.CourseDAO, scheduleDAO *dao.ScheduleDAO) *CourseService {
|
|
return &CourseService{
|
|
courseDAO: courseDAO,
|
|
scheduleDAO: scheduleDAO,
|
|
}
|
|
}
|
|
|
|
func isUniqueViolation(err error) bool {
|
|
if err == nil {
|
|
return false
|
|
}
|
|
// 兼容常见 MySQL / PostgreSQL / SQLite 的报错关键字
|
|
// 也可以进一步精确到你的索引名 idx_user_slot_atomic
|
|
msg := strings.ToLower(err.Error())
|
|
if strings.Contains(msg, "duplicate entry") ||
|
|
strings.Contains(msg, "unique constraint") ||
|
|
strings.Contains(msg, "unique violation") ||
|
|
strings.Contains(msg, "duplicate key") {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
func CheckSingleCourse(req model.UserCheckCourseRequest) bool {
|
|
for _, arrangement := range req.Arrangements {
|
|
if arrangement.StartWeek > arrangement.EndWeek ||
|
|
arrangement.DayOfWeek < 1 || arrangement.DayOfWeek > 7 ||
|
|
arrangement.StartSection < 1 || arrangement.EndSection < arrangement.StartSection ||
|
|
arrangement.EndSection > 12 || arrangement.StartWeek < 1 || arrangement.EndWeek > 24 {
|
|
return false
|
|
}
|
|
}
|
|
return true
|
|
}
|
|
|
|
// AddUserCourses 添加用户课程表
|
|
func (ss *CourseService) AddUserCourses(ctx context.Context, req model.UserImportCoursesRequest, userID int) ([]model.ScheduleConflictDetail, error) {
|
|
//1.先校验参数是否正确
|
|
for _, course := range req.Courses {
|
|
result := CheckSingleCourse(course)
|
|
if !result {
|
|
return nil, respond.WrongCourseInfo
|
|
}
|
|
}
|
|
//2.将前端传来的课程信息转换为 Schedule 和 ScheduleEvent 切片
|
|
var finalSchedules []model.Schedule
|
|
var finalScheduleEvents []model.ScheduleEvent
|
|
var pos []int
|
|
for _, course := range req.Courses {
|
|
// 避免取 range 迭代变量字段地址导致指针复用问题
|
|
location := course.Location
|
|
for _, arrangement := range course.Arrangements {
|
|
weekType := arrangement.WeekType
|
|
for week := arrangement.StartWeek; week <= arrangement.EndWeek; week++ {
|
|
if weekType == "odd" && week%2 == 0 {
|
|
continue
|
|
}
|
|
if weekType == "even" && week%2 != 0 {
|
|
continue
|
|
}
|
|
//2.转换为 Schedule_event 切片
|
|
st, ed, err := conv.RelativeTimeToRealTime(week, arrangement.DayOfWeek, arrangement.StartSection, arrangement.EndSection)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
scheduleEvent := model.ScheduleEvent{
|
|
UserID: userID,
|
|
Name: course.CourseName,
|
|
Location: &location,
|
|
Type: "course",
|
|
RelID: nil,
|
|
CanBeEmbedded: course.IsAllowTasks,
|
|
StartTime: st,
|
|
EndTime: ed,
|
|
}
|
|
finalScheduleEvents = append(finalScheduleEvents, scheduleEvent)
|
|
//3.转换为 Schedule 切片
|
|
for section := arrangement.StartSection; section <= arrangement.EndSection; section++ {
|
|
schedule := model.Schedule{
|
|
Week: week,
|
|
DayOfWeek: arrangement.DayOfWeek,
|
|
Section: section,
|
|
Status: "normal",
|
|
UserID: userID,
|
|
EventID: 0,
|
|
}
|
|
finalSchedules = append(finalSchedules, schedule)
|
|
pos = append(pos, len(finalScheduleEvents)-1)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
//3.先检测是否重复插入了课程(同一周、同一天、同一节已有课程)
|
|
exists, err := ss.scheduleDAO.CheckScheduleConflict(ctx, finalSchedules)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if exists {
|
|
return nil, respond.InsertCourseTwice
|
|
}
|
|
//4.再检查是否和某些非课程的日程冲突(同一周、同一天、同一节已有非课程日程),并给出具体的冲突信息
|
|
conflicts, err := ss.scheduleDAO.GetNonCourseScheduleConflicts(ctx, finalSchedules)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if len(conflicts) > 0 {
|
|
ret := conv.SchedulesToScheduleConflictDetail(conflicts)
|
|
return ret, respond.ScheduleConflict
|
|
}
|
|
//5.事务:插入两个表要么都成功,要么都回滚
|
|
err = ss.courseDAO.Transaction(func(txDAO *dao.CourseDAO) error {
|
|
ids, err := txDAO.AddUserCoursesIntoScheduleEvents(ctx, finalScheduleEvents)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
// 将生成的 ScheduleEvent ID 赋值给对应的 Schedule 的 EventID 字段
|
|
for i := range finalSchedules {
|
|
finalSchedules[i].EventID = ids[pos[i]]
|
|
}
|
|
if err := txDAO.AddUserCoursesIntoSchedule(ctx, finalSchedules); err != nil {
|
|
return err
|
|
}
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
if isUniqueViolation(err) {
|
|
return nil, respond.InsertCourseTwice
|
|
}
|
|
return nil, err
|
|
}
|
|
return nil, nil
|
|
}
|