package com.emotion.controller; import com.emotion.common.PageResult; import com.emotion.common.Result; import com.emotion.dto.request.ConversationCreateRequest; import com.emotion.dto.request.ConversationPageRequest; import com.emotion.dto.response.ConversationResponse; import com.emotion.service.ConversationService; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.Parameter; import io.swagger.v3.oas.annotations.tags.Tag; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; import javax.servlet.http.HttpServletRequest; import javax.validation.Valid; import java.util.List; /** * 对话控制器 * * @author huazhongmin * @date 2025-07-23 */ @RestController @RequestMapping("/conversation") @Tag(name = "会话管理", description = "AI 对话会话的查询、创建、更新、删除和状态管理接口") public class ConversationController { @Autowired private ConversationService conversationService; /** * 分页查询对话 */ @Operation(summary = "分页查询会话", description = "分页查询当前用户的对话会话列表。") @GetMapping(value = "/page") public Result> getPage(@Valid ConversationPageRequest request) { PageResult pageResult = conversationService.getPageWithResponse(request); return Result.success(pageResult); } /** * 根据ID获取对话 */ @Operation(summary = "获取会话详情", description = "根据 ID 获取会话的详细信息。") @GetMapping(value = "/detail") public Result getById(@Parameter(description = "会话 ID") @RequestParam String id) { ConversationResponse response = conversationService.getConversationResponseById(id); if (response == null) { return Result.notFound("对话不存在"); } return Result.success(response); } /** * 创建对话 */ @Operation(summary = "创建会话", description = "创建一个新的 AI 对话会话。") @PostMapping(value = "/create") public Result create(@Valid @RequestBody ConversationCreateRequest request, HttpServletRequest httpRequest) { ConversationResponse response = conversationService.createConversationWithResponse(request, httpRequest); return Result.success(response); } /** * 更新对话 */ @Operation(summary = "更新会话", description = "修改已有会话的标题等属性。") @PutMapping(value = "/update") public Result update(@RequestBody ConversationCreateRequest request) { ConversationResponse response = conversationService.updateConversationWithResponse(request); return Result.success(response); } /** * 删除对话 */ @Operation(summary = "删除会话", description = "删除指定的对话会话。") @DeleteMapping(value = "/delete") public Result delete(@Parameter(description = "会话 ID") @RequestParam String id) { boolean deleted = conversationService.removeById(id); if (!deleted) { return Result.error("删除失败"); } return Result.success(); } /** * 获取活跃对话 */ @Operation(summary = "获取活跃会话", description = "获取当前用户最近的活跃会话列表。") @GetMapping(value = "/active") public Result> getActiveConversations() { List responses = conversationService.getActiveConversationsWithResponse(); return Result.success(responses); } /** * 获取归档对话 */ @Operation(summary = "获取归档会话", description = "获取当前用户已归档的会话列表。") @GetMapping(value = "/archived") public Result> getArchivedConversations() { List responses = conversationService.getArchivedConversationsWithResponse(); return Result.success(responses); } /** * 更新对话状态 */ @Operation(summary = "获取会话状态", description = "获取指定会话的当前状态信息。") @PutMapping(value = "/status") public Result updateConversationStatus( @Parameter(description = "会话 ID") @RequestParam String id, @RequestParam String status) { boolean updated = conversationService.updateConversationStatus(id, status); if (!updated) { return Result.error("更新状态失败"); } return Result.success(); } }