成功 @param data 数据 @param <T> 泛型 @return 通用返回类

获取当前登录用户 @param request @return

失败 @param errorCode 错误码 @param <T> 泛型 @return 通用返回类

条件成立则抛异常 @param condition @param runtimeException

是否为管理员 @param request @return

获取查询条件 @param postQueryRequest @return

获取脱敏的用户信息 @param user @return

获取基础URL @param request HTTP请求 @return 基础URL

校验排序字段是否合法（防止 SQL 注入） @param sortField @return

获取或创建聊天会话 @param userId1 用户1ID @param userId2 用户2ID @return 聊天会话

获取未读消息数量 @param userId 用户ID @return 未读消息数量

根据用户ID获取脱敏的用户信息 @param userId 用户ID @return 脱敏后的用户信息

发送错误消息

向用户发送消息

发送未读消息数量更新 @param userId 用户ID @param unreadCount 未读消息数量 @return 是否发送成功

生成文件 @param inputPath 模板文件输入路径 @param outputPath 输出路径 @param model 数据模型 @throws IOException @throws TemplateException

安全地完成SseEmitter，避免重复完成导致的异常

处理过程中出现错误 @param error 错误信息

发送 DELETE 请求 @param url 请求 URL @param jsonBody JSON 请求体 @param headers 请求头 @return 响应对象

获取所有管理员用户 @return 管理员用户列表

获取每日文章视图 @param dailyArticle @return

通过Channel获取用户ID

增加公告查看次数 @param id @return

判断用户是否在线

标记消息为已读 @param messageId 消息ID @param userId 用户ID

根据IP地址获取地理位置信息 @param ip IP地址 @return 包含国家和城市的数组 [国家, 城市]

分页获取帖子封装 @param postPage @param request @return

检查用户是否已读公告 @param announcementId @param userId @return

增加单词点赞次数 @param id @return

检查是否已认证

标记所有消息为已读

上传对象 @param key 唯一键 @param localFilePath 本地文件路径 @return 上传结果

通用文件上传 @param file 上传的文件 @param request HTTP请求 @return 文件访问URL

设置用户认证状态

创建新的会话 @param userId 用户ID @param aiAvatarId AI分身ID @return 新的会话ID

生成指定长度的纯数字ID @param length ID长度 @return 指定长度的数字ID

生成8位纯数字ID - 使用随机数的方法 @return 8位数字ID

获取课程视图 @param course @param currentUser @return

获取每日单词视图 @param dailyWord @return

获取主机地址 @return 主机IP地址 @throws UnknownHostException 如果无法确定主机地址

获取文件后缀（不带点） @param fileName 文件名 @return 文件后缀

发送 JSON POST 请求 @param url 请求 URL @param jsonBody JSON 请求体 @param headers 请求头 @return 响应对象

从 ES 查询 @param postQueryRequest @return

发送消息已读状态批量更新 @param receiverId 接收者ID @param messageIds 消息ID列表 @param sessionId 会话ID @param isRead 是否已读 @return 是否发送成功

更新会话最后消息时间 @param chatSession 聊天会话

用户注册 @param userAccount 用户账户 @param userPassword 用户密码 @param checkPassword 校验密码 @return 新用户 id

校验 @param post @param add

添加课程资料 @param courseMaterial 课程资料 @param adminId 管理员ID @return 资料ID

添加课程小节 @param courseSection 课程小节 @param adminId 管理员ID @return 小节ID

创建好友关系 @param userId1 用户1 ID @param userId2 用户2 ID @param status 关系状态 @return 好友关系ID

添加反馈回复 @param userFeedbackReply 反馈回复对象 @return 回复ID

构建聊天请求对象

创建没有读取超时的客户端，用于流式响应 @return OkHttpClient 实例

创建用户消息对象（不保存到数据库） @param userId 用户ID @param aiAvatarId AI分身ID @param sessionId 会话ID @param content 消息内容 @return 用户消息对象

减少单词点赞次数 @param id @return

获取公告封装 @param announcement @return

根据讲师ID获取课程列表 @param teacherId @return

根据 value 获取枚举 @param value @return

获取好友关系 @param userId1 用户1 ID @param userId2 用户2 ID @return 好友关系

获取当前登录用户（允许未登录） @param request @return

获取在线用户数量

获取在线用户ID列表

获取特定会话的聊天记录 @param sessionId 会话ID @return 聊天记录列表

获取子分类 @param parentId 父分类ID @return 子分类列表

获取用户的所有未读消息数量 @param userId 用户ID @return 未读消息数量

获取用户收藏的AI分身列表 @param userId 用户id @return 收藏列表

从token获取用户ID

用户下线处理

用户上线处理

判断用户是否已收藏帖子 @param postId 帖子ID @param userId 用户ID @return 是否已收藏

判断用户是否已点赞帖子 @param postId 帖子ID @param userId 用户ID @return 是否已点赞

标记某一反馈下的所有回复为已读 @param feedbackId 反馈ID @param senderRole 发送者角色，可为null表示所有角色 @return 是否成功

对象转包装类 @param dailyWord 每日单词对象 @return ES包装类

对象转包装类 @param dailyArticle 每日美文对象 @return ES包装类

对象转包装类 @param post @return

对象转包装类 @param post @return

已读公告 @param announcementId @param userId @return

发送认证错误消息