feat: 新增学习引导链路与来源标记

This commit is contained in:
2026-10-09 19:30:59 +08:00
parent c6258fa6d7
commit b51a6216ce
11 changed files with 929 additions and 25 deletions
@@ -0,0 +1,69 @@
package com.guo.learningprogresstracker.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.guo.learningprogresstracker.utils.GenerateNumTool;
import lombok.Data;
import java.io.Serializable;
import java.time.LocalDateTime;
/**
* 学习引导会话(复习-06):一次复习行为。
*
* <p>它有两重身份:产出的知识碎片以它作为**记录上下文**(复习行为),
* 复习耗时也记在它身上(与回忆对比同一口径,见复习-07)。</p>
*/
@TableName(value = "review_guidance_conversations")
@Data
public class ReviewGuidanceConversationEntity extends BaseEntity implements Serializable {
@TableId(value = "id", type = IdType.AUTO)
private Integer id;
/** 对外标识,也是产出碎片的记录上下文编号 */
@TableField(value = "guidance_num")
private String guidanceNum;
/** 被引导概念所属的学习任务,也是产出碎片的默认内容归属 */
@TableField(value = "task_num")
private String taskNum;
/** 被引导的概念(来自 Feed 卡片或导图节点) */
@TableField(value = "concept")
private String concept;
/** 对话轮次 JSON:[{role,content}] */
@TableField(value = "turns_payload")
private String turnsPayload;
/** 本次复习耗时(秒),已按 5 分钟空闲截断 */
@TableField(value = "review_duration_seconds")
private Integer reviewDurationSeconds;
@TableField(value = "finished")
private Boolean finished;
@TableField(value = "started_time")
private LocalDateTime startedTime;
@TableField(value = "finished_time")
private LocalDateTime finishedTime;
@TableField(exist = false)
private static final long serialVersionUID = 1L;
public static ReviewGuidanceConversationEntity initNewConversation(String taskNum, String concept) {
ReviewGuidanceConversationEntity conversation = new ReviewGuidanceConversationEntity();
conversation.setGuidanceNum(GenerateNumTool.generateNum("GUIDANCE"));
conversation.setTaskNum(taskNum);
conversation.setConcept(concept);
conversation.setTurnsPayload("[]");
conversation.setReviewDurationSeconds(0);
conversation.setFinished(false);
conversation.setStartedTime(LocalDateTime.now());
return conversation;
}
}