feat: 完善后端架构 - 标准化Controller层和Service层

✨ 新功能: - 创建了完整的Service层架构，包含所有业务实体的Service接口和实现类 - 新增8个标准化的Controller类，支持完整的CRUD操作 - 实现了统一的Request/Response模式和分页查询功能 - 创建了认证服务(AuthService)和令牌服务(TokenService) - 添加了Redis配置和认证拦截器 🏗️ 架构优化: - 移除Controller层所有try-catch块，使用全局异常处理机制 - 创建了专门的异常类(AuthException, TokenException, CaptchaException) - 统一了API返回格式，完善了Result类的方法 - 实现了标准的分页查询和参数校验 📦 新增文件: - 8个Controller类: Achievement, Comment, CommunityPost, Conversation, CozeApiCall, EmotionAnalysis, Reward, UserStats - 12个Service接口和对应的实现类 - 标准化的DTO类(Request/Response) - 异常处理类和拦截器 - 测试用例 🔧 重构优化: - 重写了AuthController，移除所有业务逻辑到Service层 - 优化了MessageController，使用标准的Request/Response格式 - 更新了全局异常处理器，支持多种异常类型 - 完善了WebConfig配置，添加认证拦截器 📊 代码统计: - 新增文件: 60+个 - 新增代码行数: 8000+行 - 重构代码行数: 1000+行 - 移除过时接口: 4个
2025-07-24 07:38:40 +08:00
parent 880e0e3c88
commit 873b8e55da
67 changed files with 8619 additions and 850 deletions
@@ -0,0 +1,117 @@
+package com.emotion.service;
+
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.service.IService;
+import com.emotion.common.BasePageRequest;
+import com.emotion.entity.CozeApiCall;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * Coze API调用记录服务接口
+ * 
+ * @author emotion-museum
+ * @date 2025-07-23
+ */
+public interface CozeApiCallService extends IService<CozeApiCall> {
+    
+    /**
+     * 分页查询API调用记录
+     */
+    IPage<CozeApiCall> getPage(BasePageRequest request);
+    
+    /**
+     * 根据会话ID分页查询API调用记录
+     */
+    IPage<CozeApiCall> getPageByConversationId(BasePageRequest request, String conversationId);
+    
+    /**
+     * 根据用户ID分页查询API调用记录
+     */
+    IPage<CozeApiCall> getPageByUserId(BasePageRequest request, String userId);
+    
+    /**
+     * 根据Bot ID查询API调用记录
+     */
+    List<CozeApiCall> getByBotId(String botId);
+    
+    /**
+     * 根据状态查询API调用记录
+     */
+    List<CozeApiCall> getByStatus(String status);
+    
+    /**
+     * 根据请求类型查询API调用记录
+     */
+    List<CozeApiCall> getByRequestType(String requestType);
+    
+    /**
+     * 根据时间范围查询API调用记录
+     */
+    List<CozeApiCall> getByTimeRange(LocalDateTime startTime, LocalDateTime endTime);
+    
+    /**
+     * 统计用户的API调用次数
+     */
+    Long countByUserId(String userId);
+    
+    /**
+     * 统计Bot的API调用次数
+     */
+    Long countByBotId(String botId);
+    
+    /**
+     * 统计指定状态的API调用次数
+     */
+    Long countByStatus(String status);
+    
+    /**
+     * 统计用户的Token使用量
+     */
+    Long sumTokensByUserId(String userId);
+    
+    /**
+     * 统计用户的API调用费用
+     */
+    BigDecimal sumCostByUserId(String userId);
+    
+    /**
+     * 查询失败的API调用记录
+     */
+    List<CozeApiCall> getFailedCalls();
+    
+    /**
+     * 查询超时的API调用记录
+     */
+    List<CozeApiCall> getTimeoutCalls();
+    
+    /**
+     * 根据追踪ID查询API调用记录
+     */
+    CozeApiCall getByTraceId(String traceId);
+    
+    /**
+     * 根据会话ID和请求类型查询API调用记录
+     */
+    List<CozeApiCall> getByConversationIdAndRequestType(String conversationId, String requestType);
+    
+    /**
+     * 更新API调用状态
+     */
+    boolean updateStatus(String id, String status, String finalStatus, LocalDateTime endTime);
+    
+    /**
+     * 更新API调用结果
+     */
+    boolean updateResult(String id, Integer responseStatus, String responseBody, String aiReply,
+                        Integer totalTokens, BigDecimal cost, String status, String finalStatus,
+                        LocalDateTime endTime);
+    
+    /**
+     * 创建API调用记录
+     */
+    CozeApiCall createApiCall(String conversationId, String messageId, String userId, 
+                             String requestType, String requestUrl, String requestBody);
+}