Files
smartmate/backend/service/course.go
Losita 04b5836b39 Version: 0.9.42.dev.260424
后端:
1. 新增课表图片识别接口,支持上传截图后返回“可编辑草稿”(success / partial / reject),并补齐大图、空图、格式不支持、识别能力未配置等错误分支。
2. 课表识别服务接入多模态 Responses 链路,完善图片请求归一化与安全校验(大小、MIME、内容探测),并对识别结果做结构化清洗、强/弱约束校验、告警去重与默认文案兜底。
3. 新增 Ark Responses 统一客户端抽象,支持文本+图片输入、JSON对象输出、usage统计透传与不完整输出识别;同时补齐模型返回 finish_reason 透传,便于定位截断问题。
4. 启动阶段增加课表识图模型与参数注入(模型名、最大图片字节、最大输出token),并将配置示例收敛为“仅保留当前代码实际读取项”。

前端:
5. 课表中心新增“导入课表”完整闭环:上传图片识别、草稿编辑校对、正式导入落库;并新增对应 API 与类型定义。
6. 导入弹窗支持识别中止、全局告警与行级告警展示、低置信度提示、行内编辑、手动新增、删除、拖拽排序、本地校验与提交前二次确认。
7. 正式导入前将草稿按“课程名+地点+是否允许嵌入”聚合为导入结构,并统一携带幂等键请求头,降低重复提交风险。
8. 周课表画板修复跨节次事件遮挡导致的网格错位问题,改进“完全遮挡/部分遮挡”渲染判定与 grid 行定位。
9. 助手流式区域优化“思考中”指示逻辑与样式,避免已有正文时仍展示回答中占位;同时补充全局组件视觉统一(弹窗/按钮)样式。

仓库:
10. 新增课表图片识别前端对接说明文档,补充主动优化能力 PRD 讨论稿,并在协作规范中新增“实现 Eino 新能力前需先查官方文档”的约束。
2026-04-24 23:33:43 +08:00

165 lines
5.2 KiB
Go

package service
import (
"context"
"strings"
"github.com/LoveLosita/smartflow/backend/conv"
"github.com/LoveLosita/smartflow/backend/dao"
infrallm "github.com/LoveLosita/smartflow/backend/infra/llm"
"github.com/LoveLosita/smartflow/backend/model"
"github.com/LoveLosita/smartflow/backend/respond"
)
type CourseService struct {
// 伸出手:准备接住 DAO
courseDAO *dao.CourseDAO
scheduleDAO *dao.ScheduleDAO
courseImageResponsesClient *infrallm.ArkResponsesClient
courseImageConfig CourseImageParseConfig
courseImageModel string
}
// NewCourseService 创建 CourseService 实例
func NewCourseService(
courseDAO *dao.CourseDAO,
scheduleDAO *dao.ScheduleDAO,
courseImageResponsesClient *infrallm.ArkResponsesClient,
courseImageConfig CourseImageParseConfig,
courseImageModel string,
) *CourseService {
return &CourseService{
courseDAO: courseDAO,
scheduleDAO: scheduleDAO,
courseImageResponsesClient: courseImageResponsesClient,
courseImageConfig: courseImageConfig,
courseImageModel: strings.TrimSpace(courseImageModel),
}
}
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
}