chore: 清理冗余注释，保留字段/业务含义注释

src/main/java/com/guo/learningprogresstracker/service/impl/ReviewServiceImpl.java

@@ -20,7 +20,7 @@ import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 /**
- * 复习模块 Service 实现（纯 MyBatis-Plus Java API）
+ * 复习模块 Service 实现
  */
 @Service
 @RequiredArgsConstructor
@@ -33,7 +33,6 @@ public class ReviewServiceImpl implements ReviewService {
 
     @Override
     public List<ReviewFeedItem> getReviewFeed(int limit) {
-        // created_by 条件由 TenantLineInnerInterceptor 自动注入
         List<StudyReportsEntity> reports = studyReportsMapper.selectList(
                 Wrappers.<StudyReportsEntity>lambdaQuery()
                         .orderByDesc(StudyReportsEntity::getCreatedTime)
@@ -49,7 +48,6 @@ public class ReviewServiceImpl implements ReviewService {
 
     @Override
     public List<ReviewFeedItem> getTaskReview(String taskNum) {
-        // 先查该任务下的所有 sessionNum
         List<String> sessionNums = studySessionsMapper.selectList(
                 Wrappers.<StudySessionsEntity>lambdaQuery()
                         .eq(StudySessionsEntity::getTaskNum, taskNum)
@@ -77,14 +75,12 @@ public class ReviewServiceImpl implements ReviewService {
 
     @Override
     public StudyReportsEntity getReportDetail(int id) throws NotFindEntitiesException {
-        // 拦截器自动校验归属
         return Optional.ofNullable(studyReportsMapper.selectById(id))
                 .orElseThrow(() -> new NotFindEntitiesException("学习报告[" + id + "]不存在"));
     }
 
     @Override
     public StudyReportFragmentsEntity getFragmentDetail(int id) throws NotFindEntitiesException {
-        // 拦截器自动校验归属
         return Optional.ofNullable(studyReportFragmentsMapper.selectById(id))
                 .orElseThrow(() -> new NotFindEntitiesException("学习残片[" + id + "]不存在"));
     }
@@ -94,7 +90,6 @@ public class ReviewServiceImpl implements ReviewService {
      */
     private List<ReviewFeedItem> mergeAndConvert(List<StudyReportsEntity> reports,
                                                   List<StudyReportFragmentsEntity> fragments) {
-        // 收集所有 sessionNum，批量查询 session 和 task
         Set<String> allSessionNums = Stream.concat(
                 reports.stream().map(StudyReportsEntity::getSessionNum),
                 fragments.stream().map(StudyReportFragmentsEntity::getSessionNum)
@@ -104,7 +99,6 @@ public class ReviewServiceImpl implements ReviewService {
             return Collections.emptyList();
         }
 
-        // 批量查询 sessions，构建 sessionNum -> taskNum 映射
         Map<String, String> sessionToTaskMap = studySessionsMapper.selectList(
                 Wrappers.<StudySessionsEntity>lambdaQuery()
                         .in(StudySessionsEntity::getSessionNum, allSessionNums)
@@ -115,7 +109,6 @@ public class ReviewServiceImpl implements ReviewService {
                         StudySessionsEntity::getTaskNum,
                         (a, b) -> a));
 
-        // 批量查询 tasks，构建 taskNum -> taskName 映射
         Set<String> taskNums = new HashSet<>(sessionToTaskMap.values());
         Map<String, String> taskNameMap = tasksMapper.selectList(
                 Wrappers.<TaskEntity>lambdaQuery()
@@ -127,7 +120,6 @@ public class ReviewServiceImpl implements ReviewService {
                         TaskEntity::getTaskName,
                         (a, b) -> a));
 
-        // 转换报告
         List<ReviewFeedItem> reportItems = reports.stream().map(r -> {
             ReviewFeedItem item = new ReviewFeedItem();
             item.setId(r.getId());
@@ -141,7 +133,6 @@ public class ReviewServiceImpl implements ReviewService {
             return item;
         }).collect(Collectors.toList());
 
-        // 转换残片
         List<ReviewFeedItem> fragmentItems = fragments.stream().map(f -> {
             ReviewFeedItem item = new ReviewFeedItem();
             item.setId(f.getId());
@@ -155,7 +146,6 @@ public class ReviewServiceImpl implements ReviewService {
             return item;
         }).collect(Collectors.toList());
 
-        // 合并并按创建时间倒序
         return Stream.concat(reportItems.stream(), fragmentItems.stream())
                 .sorted(Comparator.comparing(ReviewFeedItem::getCreatedTime,
                         Comparator.nullsLast(Comparator.reverseOrder())))

src/main/java/com/guo/learningprogresstracker/service/impl/StudyReportFragmentsServiceImpl.java

@@ -14,10 +14,8 @@ import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 
 /**
-* @author guo
-* @description 针对表【study_report_fragments(记录学习过程中的学习内容报告残片)】的数据库操作Service实现
-* @createDate 2024-06-09 15:28:48
-*/
+ * 针对表【study_report_fragments(记录学习过程中的学习内容报告残片)】的数据库操作Service实现
+ */
 @Service
 @RequiredArgsConstructor
 public class StudyReportFragmentsServiceImpl extends ServiceImpl<StudyReportFragmentsMapper, StudyReportFragmentsEntity>
@@ -28,14 +26,12 @@ public class StudyReportFragmentsServiceImpl extends ServiceImpl<StudyReportFrag
     @Override
     public void createFragments(CreateFragmentsRequest request) throws NotFindEntitiesException {
         StudyReportFragmentsEntity entity = FragmentsConvert.MAPPER.toFragmentsEntity(request);
-        // 拦截器自动注入 created_by 条件，会话归属校验已内置
         StudySessionsEntity session = studySessionsMapper.selectOne(
                 Wrappers.lambdaQuery(StudySessionsEntity.class)
                         .eq(StudySessionsEntity::getSessionNum, entity.getSessionNum()));
         if (session == null) {
             throw new NotFindEntitiesException(String.format("未能找到学习会话sessionNum[%s]", entity.getSessionNum()));
         }
-        // created_by 由 MetaObjectHandler 在 insert 时自动填充
         this.save(entity);
     }
 }

src/main/java/com/guo/learningprogresstracker/service/impl/StudySessionsServiceImpl.java

@@ -27,9 +27,7 @@ import java.util.Optional;
 import java.util.stream.Collectors;
 
 /**
- * @author guo
- * @description 针对表【study_sessions(记录每次学习会话的具体数据)】的数据库操作Service实现
- * @createDate 2024-06-09 15:28:48
+ * 针对表【study_sessions(记录每次学习会话的具体数据)】的数据库操作Service实现
  */
 @Slf4j
 @Service
@@ -45,7 +43,6 @@ public class StudySessionsServiceImpl extends ServiceImpl<StudySessionsMapper, S
     private final StudyReportsMapper studyReportsMapper;
 
     public StudySessionResponse startOrContinueStudySession(String taskNum) throws NotFindEntitiesException, ServiceException {
-        // 拦截器已自动注入 created_by 条件，只有当前用户的 task 才能查到
         TaskEntity taskEntity = tasksServiceImpl.getOneOpt(
                         Wrappers.lambdaQuery(TaskEntity.class).eq(TaskEntity::getTaskNum, taskNum))
                 .orElseThrow(() -> new NotFindEntitiesException(String.format("[%s]不存在", taskNum)));
@@ -82,7 +79,6 @@ public class StudySessionsServiceImpl extends ServiceImpl<StudySessionsMapper, S
 
     @Override
     public void pauseStudySession(String sessionNum, LocalDateTime endTime) throws ErrorParameterException, ServiceException {
-        // 拦截器自动校验归属，查不到即说明无权访问
         StudySessionsEntity studySessionsEntity = this.getOneOpt(Wrappers.lambdaQuery(StudySessionsEntity.class)
                         .eq(StudySessionsEntity::getSessionNum, sessionNum))
                 .orElseThrow(() -> new ErrorParameterException("会话[" + sessionNum + "]不存在"));
@@ -98,13 +94,11 @@ public class StudySessionsServiceImpl extends ServiceImpl<StudySessionsMapper, S
 
     @Override
     public void endedStudySession(String sessionNum, String content) throws ErrorParameterException {
-        // 拦截器自动校验归属
         StudySessionsEntity studySessionsEntity = this.getOneOpt(Wrappers.lambdaQuery(StudySessionsEntity.class)
                         .eq(StudySessionsEntity::getSessionNum, sessionNum))
                 .orElseThrow(() -> new ErrorParameterException("会话[" + sessionNum + "]不存在"));
         studySessionsEntity.endedStudySession();
         this.updateById(studySessionsEntity);
-        // 创建学习报告（created_by 由 MetaObjectHandler 自动填充）
         StudyReportsEntity studyReportsEntity = new StudyReportsEntity();
         studyReportsEntity.setSessionNum(sessionNum);
         studyReportsEntity.setContent(content);
@@ -113,7 +107,6 @@ public class StudySessionsServiceImpl extends ServiceImpl<StudySessionsMapper, S
 
     @Override
     public StudySessionResponse getNotEndedStudySessionByTaskNum(String taskNum) throws ErrorParameterException {
-        // 拦截器自动注入 created_by，task 归属校验已内置
         TaskEntity task = tasksServiceImpl.getOneOpt(Wrappers.lambdaQuery(TaskEntity.class)
                         .eq(TaskEntity::getTaskNum, taskNum))
                 .orElseThrow(() -> new ErrorParameterException("任务[" + taskNum + "]不存在"));
@@ -124,7 +117,6 @@ public class StudySessionsServiceImpl extends ServiceImpl<StudySessionsMapper, S
 
     @Override
     public ArrayList<String> getAllFragments(String sessionNum) throws ErrorParameterException {
-        // 拦截器自动校验归属
         if (this.exists(Wrappers.lambdaQuery(StudySessionsEntity.class)
                 .eq(StudySessionsEntity::getSessionNum, sessionNum))) {
             return studyReportFragmentsMapper.selectList(Wrappers.lambdaQuery(StudyReportFragmentsEntity.class)
@@ -137,7 +129,6 @@ public class StudySessionsServiceImpl extends ServiceImpl<StudySessionsMapper, S
 
     @Override
     public void continueStudySession(String sessionNum) throws ErrorParameterException, ServiceException {
-        // 拦截器自动校验归属
         StudySessionsEntity studySessionsEntity = this.getOneOpt(Wrappers.lambdaQuery(StudySessionsEntity.class)
                         .eq(StudySessionsEntity::getSessionNum, sessionNum))
                 .orElseThrow(() -> new ErrorParameterException("会话[" + sessionNum + "]不存在"));
@@ -153,7 +144,7 @@ public class StudySessionsServiceImpl extends ServiceImpl<StudySessionsMapper, S
     }
 
     /**
-     * 通过 sessionNum 获取学习会话（归属由拦截器自动校验）
+     * 通过 sessionNum 获取学习会话
      */
     public StudySessionResponse getStudySessionBySessionNum(String sessionNum) throws ErrorParameterException {
         StudySessionsEntity session = this.getOneOpt(Wrappers.lambdaQuery(StudySessionsEntity.class)

src/main/java/com/guo/learningprogresstracker/service/impl/TasksServiceImpl.java

@@ -20,10 +20,8 @@ import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
 
 /**
-* @author guo
-* @description 针对表【tasks(存储学习任务的基本信息，包括优先级的多维度计算)】的数据库操作Service实现
-* @createDate 2024-06-09 15:28:48
-*/
+ * 针对表【tasks(存储学习任务的基本信息，包括优先级的多维度计算)】的数据库操作Service实现
+ */
 @Service
 @RequiredArgsConstructor
 @Slf4j
@@ -34,7 +32,6 @@ public class TasksServiceImpl extends ServiceImpl<TasksMapper, TaskEntity>
 
     @Override
     public Page<TaskInfo> taskList(Integer pageNum, Integer pageSize) {
-        // 拦截器自动注入 created_by 条件，只返回当前用户的任务
         Page<TaskEntity> page = tasksMapper.selectPage(new Page<TaskEntity>(pageNum, pageSize),
                 Wrappers.lambdaQuery(TaskEntity.class)
                     .orderByDesc(TaskEntity::getCalculatedPriority));
@@ -46,7 +43,6 @@ public class TasksServiceImpl extends ServiceImpl<TasksMapper, TaskEntity>
     public String addTask(TaskRequest taskRequest) throws ErrorParameterException {
         TaskEntity task = TaskConvert.MAPPER.taskRequestToTaskEntity(taskRequest);
 
-        // 拦截器自动注入 created_by，重复校验仅限当前用户
         if (this.exists(Wrappers.lambdaQuery(TaskEntity.class)
                 .eq(TaskEntity::getTaskName, task.getTaskName()))) {
             throw new ErrorParameterException(String.format("任务名[%s]重复", task.getTaskName()));
@@ -61,14 +57,12 @@ public class TasksServiceImpl extends ServiceImpl<TasksMapper, TaskEntity>
 
     @Override
     public TaskInfoResponse getTask(String taskId) {
-        // 拦截器自动校验归属，查到的一定是当前用户的任务
         TaskEntity taskEntity = this.getById(taskId);
         return TaskConvert.MAPPER.taskEntityToTaskInfoResponse(taskEntity);
     }
 
     @Override
     public void updateTask(String taskId, TaskRequest updatedTask) {
-        // getById 已被拦截器保护，其他用户的任务查不到
         TaskEntity existingTask = this.getById(taskId);
         if (existingTask == null) {
             throw new IllegalArgumentException("任务不存在: " + taskId);
@@ -86,7 +80,6 @@ public class TasksServiceImpl extends ServiceImpl<TasksMapper, TaskEntity>
 
     @Override
     public void deleteTask(String taskId) {
-        // getById 已被拦截器保护，其他用户的任务查不到
         TaskEntity existingTask = this.getById(taskId);
         if (existingTask == null) {
             throw new IllegalArgumentException("任务不存在: " + taskId);