happy-life-star/backend-single/src/main/java/com/emotion/controller/ConversationController.java

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<PageResult<ConversationResponse>> getPage(@Valid ConversationPageRequest request) {
        PageResult<ConversationResponse> pageResult = conversationService.getPageWithResponse(request);
        return Result.success(pageResult);
    }

    /**
     * 根据ID获取对话
     */
    @Operation(summary = "获取会话详情", description = "根据 ID 获取会话的详细信息。")
    @GetMapping(value = "/detail")
    public Result<ConversationResponse> 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<ConversationResponse> 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<ConversationResponse> update(@RequestBody ConversationCreateRequest request) {
        ConversationResponse response = conversationService.updateConversationWithResponse(request);
        return Result.success(response);
    }

    /**
     * 删除对话
     */
    @Operation(summary = "删除会话", description = "删除指定的对话会话。")
    @DeleteMapping(value = "/delete")
    public Result<Void> 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<List<ConversationResponse>> getActiveConversations() {
        List<ConversationResponse> responses = conversationService.getActiveConversationsWithResponse();
        return Result.success(responses);
    }

    /**
     * 获取归档对话
     */
    @Operation(summary = "获取归档会话", description = "获取当前用户已归档的会话列表。")
    @GetMapping(value = "/archived")
    public Result<List<ConversationResponse>> getArchivedConversations() {
        List<ConversationResponse> responses = conversationService.getArchivedConversationsWithResponse();
        return Result.success(responses);
    }

    /**
     * 更新对话状态
     */
    @Operation(summary = "获取会话状态", description = "获取指定会话的当前状态信息。")
    @PutMapping(value = "/status")
    public Result<Void> updateConversationStatus(
            @Parameter(description = "会话 ID") @RequestParam String id,
            @RequestParam String status) {
        boolean updated = conversationService.updateConversationStatus(id, status);
        if (!updated) {
            return Result.error("更新状态失败");
        }
        return Result.success();
    }
}