package repo import ( "context" "errors" "strings" "time" memorymodel "github.com/LoveLosita/smartflow/backend/memory/model" "github.com/LoveLosita/smartflow/backend/model" "gorm.io/gorm" ) // ItemRepo 封装 memory_items 的数据访问。 // // 职责边界: // 1. 只负责表级读写,不承载注入、重排、审计决策; // 2. 查询条件统一由 ItemQuery 表达,避免 service 层拼装 SQL; // 3. 软删除、访问时间刷新等状态变更也收敛到这里。 type ItemRepo struct { db *gorm.DB } func NewItemRepo(db *gorm.DB) *ItemRepo { return &ItemRepo{db: db} } func (r *ItemRepo) WithTx(tx *gorm.DB) *ItemRepo { return &ItemRepo{db: tx} } // UpsertItems 批量写入记忆条目。 func (r *ItemRepo) UpsertItems(ctx context.Context, items []model.MemoryItem) error { if r == nil || r.db == nil { return errors.New("memory item repo is nil") } if len(items) == 0 { return nil } for i := range items { if err := r.db.WithContext(ctx).Create(&items[i]).Error; err != nil { return err } } return nil } // FindByQuery 按统一过滤条件读取记忆条目。 // // 步骤化说明: // 1. 先强制 user_id 过滤,避免跨用户串记忆; // 2. 再按会话/助手/run 维度补充过滤,IncludeGlobal=true 时允许读取对应全局条目; // 3. 最后补状态、类型、过期时间和 limit,返回稳定排序结果。 func (r *ItemRepo) FindByQuery(ctx context.Context, query memorymodel.ItemQuery) ([]model.MemoryItem, error) { if r == nil || r.db == nil { return nil, errors.New("memory item repo is nil") } if query.UserID <= 0 { return nil, errors.New("memory item query user_id is invalid") } db := r.db.WithContext(ctx).Model(&model.MemoryItem{}).Where("user_id = ?", query.UserID) db = applyScopedEquality(db, "conversation_id", query.ConversationID, query.IncludeGlobal) db = applyScopedEquality(db, "assistant_id", query.AssistantID, query.IncludeGlobal) db = applyScopedEquality(db, "run_id", query.RunID, query.IncludeGlobal) if len(query.Statuses) > 0 { db = db.Where("status IN ?", query.Statuses) } if len(query.MemoryTypes) > 0 { db = db.Where("memory_type IN ?", query.MemoryTypes) } if query.OnlyUnexpired { now := query.Now if now.IsZero() { now = time.Now() } db = db.Where("(ttl_at IS NULL OR ttl_at > ?)", now) } if query.Limit > 0 { db = db.Limit(query.Limit) } var items []model.MemoryItem err := db. Order("is_explicit DESC"). Order("importance DESC"). Order("updated_at DESC"). Find(&items).Error return items, err } // GetByIDForUser 读取某个用户的一条记忆条目。 func (r *ItemRepo) GetByIDForUser(ctx context.Context, userID int, memoryID int64) (*model.MemoryItem, error) { if r == nil || r.db == nil { return nil, errors.New("memory item repo is nil") } if userID <= 0 || memoryID <= 0 { return nil, errors.New("memory item query params is invalid") } var item model.MemoryItem err := r.db.WithContext(ctx). Where("id = ? AND user_id = ?", memoryID, userID). First(&item).Error if err != nil { return nil, err } return &item, nil } // UpdateStatusByID 更新某条记忆的状态。 func (r *ItemRepo) UpdateStatusByID(ctx context.Context, userID int, memoryID int64, status string) error { return r.UpdateStatusByIDAt(ctx, userID, memoryID, status, time.Now()) } // UpdateStatusByIDAt 更新某条记忆的状态,并允许上层显式指定更新时间。 // // 这样做的原因: // 1. 管理侧删除时,需要让“库内更新时间”和“审计 after 快照时间”保持一致; // 2. 读取侧若只是刷新 last_access_at,不应该误改 updated_at; // 3. 因此把“更新时间来源”收口到 repo,避免 service 层自己拼 SQL。 func (r *ItemRepo) UpdateStatusByIDAt( ctx context.Context, userID int, memoryID int64, status string, updatedAt time.Time, ) error { if r == nil || r.db == nil { return errors.New("memory item repo is nil") } if userID <= 0 || memoryID <= 0 { return errors.New("memory item update params is invalid") } status = strings.TrimSpace(status) if status == "" { return errors.New("memory item status is empty") } if updatedAt.IsZero() { updatedAt = time.Now() } return r.db.WithContext(ctx). Model(&model.MemoryItem{}). Where("id = ? AND user_id = ?", memoryID, userID). Updates(map[string]any{ "status": status, "updated_at": updatedAt, }).Error } // TouchLastAccessAt 批量刷新记忆访问时间。 // // 说明: // 1. 这里只更新 last_access_at,不更新 updated_at; // 2. 因为 updated_at 代表“内容被修改”的时间,不能被一次普通读取污染; // 3. 否则后续读取重排会把“最近被读过的旧记忆”误判成“最近被更新的记忆”。 func (r *ItemRepo) TouchLastAccessAt(ctx context.Context, ids []int64, accessedAt time.Time) error { if r == nil || r.db == nil { return errors.New("memory item repo is nil") } if len(ids) == 0 { return nil } if accessedAt.IsZero() { accessedAt = time.Now() } return r.db.WithContext(ctx). Model(&model.MemoryItem{}). Where("id IN ?", ids). Updates(map[string]any{ "last_access_at": accessedAt, }).Error } // UpdateVectorStateByID 更新单条记忆的向量同步桥接状态。 // // 说明: // 1. 这里只更新 vector_status/vector_id,不更新 updated_at; // 2. 因为向量同步属于索引层状态,不代表记忆内容本身被修改; // 3. 若误改 updated_at,会污染读取侧的时间排序语义。 func (r *ItemRepo) UpdateVectorStateByID( ctx context.Context, memoryID int64, vectorStatus string, vectorID *string, ) error { if r == nil || r.db == nil { return errors.New("memory item repo is nil") } if memoryID <= 0 { return errors.New("memory item vector update id is invalid") } vectorStatus = strings.TrimSpace(vectorStatus) if vectorStatus == "" { return errors.New("memory item vector status is empty") } return r.db.WithContext(ctx). Model(&model.MemoryItem{}). Where("id = ?", memoryID). UpdateColumns(map[string]any{ "vector_status": vectorStatus, "vector_id": vectorID, }).Error } func applyScopedEquality(db *gorm.DB, column, value string, includeGlobal bool) *gorm.DB { value = strings.TrimSpace(value) if value == "" { return db } if includeGlobal { return db.Where("("+column+" = ? OR "+column+" IS NULL)", value) } return db.Where(column+" = ?", value) }