From b51a6216ce19e1b2127cef2fc37bb0a193406578 Mon Sep 17 00:00:00 2001
From: cat-shark <1716967236@qq.com>
Date: Fri, 9 Oct 2026 19:30:59 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E5=AD=A6=E4=B9=A0?=
=?UTF-8?q?=E5=BC=95=E5=AF=BC=E9=93=BE=E8=B7=AF=E4=B8=8E=E6=9D=A5=E6=BA=90?=
=?UTF-8?q?=E6=A0=87=E8=AE=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../controller/GuidanceController.java | 123 ++++++++++
.../ReviewGuidanceConversationEntity.java | 69 ++++++
.../enums/AiTaskTypeEnum.java | 5 +-
.../ReviewGuidanceConversationMapper.java | 9 +
.../service/GuidanceService.java | 74 ++++++
.../service/impl/AiServiceClient.java | 26 ++
.../service/impl/GuidanceAiTaskHandler.java | 114 +++++++++
.../service/impl/GuidanceServiceImpl.java | 211 ++++++++++++++++
.../V20261009_10__add_review_guidance.sql | 29 +++
.../service/impl/GuidanceIntegrationTest.java | 232 ++++++++++++++++++
.../impl/MarkerServiceIntegrationTest.java | 62 +++--
11 files changed, 929 insertions(+), 25 deletions(-)
create mode 100644 src/main/java/com/guo/learningprogresstracker/controller/GuidanceController.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/entity/ReviewGuidanceConversationEntity.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/mapper/ReviewGuidanceConversationMapper.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/GuidanceService.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/GuidanceAiTaskHandler.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/GuidanceServiceImpl.java
create mode 100644 src/main/resources/db/migration/V20261009_10__add_review_guidance.sql
create mode 100644 src/test/java/com/guo/learningprogresstracker/service/impl/GuidanceIntegrationTest.java
diff --git a/src/main/java/com/guo/learningprogresstracker/controller/GuidanceController.java b/src/main/java/com/guo/learningprogresstracker/controller/GuidanceController.java
new file mode 100644
index 0000000..13af6d0
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/controller/GuidanceController.java
@@ -0,0 +1,123 @@
+package com.guo.learningprogresstracker.controller;
+
+import com.guo.learningprogresstracker.dto.ReviewTiming;
+import com.guo.learningprogresstracker.dto.request.AiTaskSubmitRequest;
+import com.guo.learningprogresstracker.entity.CommonResult;
+import com.guo.learningprogresstracker.entity.ReviewGuidanceConversationEntity;
+import com.guo.learningprogresstracker.entity.StudyReportFragmentsEntity;
+import com.guo.learningprogresstracker.exception.ErrorParameterException;
+import com.guo.learningprogresstracker.exception.NotFindEntitiesException;
+import com.guo.learningprogresstracker.service.AiTaskService;
+import com.guo.learningprogresstracker.service.GuidanceService;
+import com.guo.learningprogresstracker.dto.AiTaskResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import lombok.RequiredArgsConstructor;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeParseException;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * 学习引导控制层(复习-06)。
+ *
+ *
多轮对话复用 AI 异步任务(AI-02):每一轮提交一个 {@code GUIDANCE} 任务,前端轮询拿回复。
+ * 因此生成期间可以离开页面,回来继续;一轮的耗时也不会占用请求线程。
+ *
+ * 产出的知识碎片走碎片既有逻辑,只是记录上下文是这次复习行为、并带「来自学习引导」系统标记。
+ */
+@RequestMapping("/review/guidance")
+@RestController
+@Validated
+@RequiredArgsConstructor
+public class GuidanceController {
+
+ private final GuidanceService guidanceService;
+ private final AiTaskService aiTaskService;
+
+ /**
+ * 开启一次学习引导并提交第一个问题(AI 任务)。
+ */
+ @PostMapping
+ @Operation(summary = "开启学习引导:返回引导编号与首个 AI 任务编号")
+ public CommonResult