feat(student-plan): 添加完成学案功能

- 新增 FinishStudentPlanReqVO 类用于请求参数封装
- 学生端学习计划页面新增“完成”按钮及其交互状态
- 实现 finishLessonPlan API 调用，用于标记学案完成
- 后端新增 finishStudentPlan 接口，处理学案完成逻辑
- StudentLessonPlansDOMapper 增加 finfishStudentPlan 方法及对应 SQL 更新语句
- StudentLessonPlansService 添加 finishStudentLessonPlan 接口实现统计记忆单词数并更新学案状态
- VocabularyBankDOMapper 和 WordMasteryLogDOMapper 增加相关统计查询方法和 SQL
- 前端完善完成按钮状态和操作反馈，防止重复提交

enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/StudentLessonPlansController.java

@@ -5,12 +5,14 @@ import com.yinlihupo.enlish.service.domain.dataobject.StudentLessonPlansDO;
 import com.yinlihupo.enlish.service.model.bo.StudentDetail;
 import com.yinlihupo.enlish.service.model.vo.plan.FindStudentPlansReqVO;
 import com.yinlihupo.enlish.service.model.vo.plan.FindStudentPlansRspVO;
+import com.yinlihupo.enlish.service.model.vo.plan.FinishStudentPlanReqVO;
 import com.yinlihupo.enlish.service.model.vo.plan.LessonPlanItem;
 import com.yinlihupo.enlish.service.service.LessonPlansService;
 import com.yinlihupo.enlish.service.service.StudentLessonPlansService;
 import com.yinlihupo.enlish.service.service.StudentService;
 import com.yinlihupo.framework.biz.operationlog.aspect.ApiOperationLog;
 import com.yinlihupo.framework.common.response.PageResponse;
+import com.yinlihupo.framework.common.response.Response;
 import jakarta.annotation.Resource;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -74,4 +76,17 @@ public class StudentLessonPlansController {
 
         return PageResponse.success(findStudentPlansRspVOList, page, studentLessonPlanTotal, size);
     }
+
+    @PostMapping("/finish")
+    @ApiOperationLog(description = "完成学案")
+    public Response<String> finishStudentPlan(@RequestBody FinishStudentPlanReqVO finishStudentPlanReqVO) {
+        Integer studentId = finishStudentPlanReqVO.getStudentId();
+        Integer planId = finishStudentPlanReqVO.getPlanId();
+        int lessonPlan = studentLessonPlansService.finishStudentLessonPlan(studentId, planId);
+
+        if (lessonPlan > 0) {
+            return Response.success("完成学案成功");
+        }
+        return Response.fail("完成学案失败");
+    }
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/StudentLessonPlansDOMapper.java

@@ -12,4 +12,6 @@ public interface StudentLessonPlansDOMapper {
     List<StudentLessonPlansDO> selectStudentLessonPlanList(@Param("startIndex") Integer startIndex, @Param("pageSize") Integer pageSize, @Param("name") String name);
 
     Integer selectStudentPlanTotal();
+
+    Integer finfishStudentPlan(@Param("studentId") Integer studentId, @Param("planId") Integer planId, @Param("count") Integer count, @Param("mastery") double mastery);
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/VocabularyBankDOMapper.java

@@ -20,4 +20,6 @@ public interface VocabularyBankDOMapper {
     List<VocabularyBankDO> selectVocabularyBankListStudentNotMaster(@Param("gradeId") Integer gradeId, @Param("studentId") Integer studentId);
 
     List<VocabularyBankDO> selectVocabularyBankListSelfCheck(@Param("gradeId") Integer gradeId, @Param("studentId") Integer studentId, @Param("ids") List<Integer> ids, @Param("wordCount") Integer wordCount);
+
+    Integer selectWordTotal();
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/WordMasteryLogDOMapper.java

@@ -14,4 +14,6 @@ public interface WordMasteryLogDOMapper {
     int batchInsertInitialization(@Param("wordIds") List<Integer> wordIds, @Param("studentId") Integer studentId);
 
     int batchUpdateStudentMastery(@Param("wordMasteryLogDOs") List<WordMasteryLogDO> wordMasteryLogDOs);
+
+    int selectStudentStrengthCount(@Param("studentId") Integer studentId);
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/plan/FinishStudentPlanReqVO.java

@@ -0,0 +1,16 @@
+package com.yinlihupo.enlish.service.model.vo.plan;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@AllArgsConstructor
+@NoArgsConstructor
+@Builder
+@Data
+public class FinishStudentPlanReqVO {
+
+    private Integer studentId;
+    private Integer planId;
+}

enlish-service/src/main/java/com/yinlihupo/enlish/service/service/StudentLessonPlansService.java

@@ -9,4 +9,6 @@ public interface StudentLessonPlansService {
     List<StudentLessonPlansDO> findStudentLessonPlansDOList(Integer page, Integer size, String name);
 
     Integer findStudentLessonPlanTotal();
+
+    int finishStudentLessonPlan(Integer studentId, Integer planId);
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/service/plan/StudentLessonPlansServiceImpl.java

@@ -2,6 +2,8 @@ package com.yinlihupo.enlish.service.service.plan;
 
 import com.yinlihupo.enlish.service.domain.dataobject.StudentLessonPlansDO;
 import com.yinlihupo.enlish.service.domain.mapper.StudentLessonPlansDOMapper;
+import com.yinlihupo.enlish.service.domain.mapper.VocabularyBankDOMapper;
+import com.yinlihupo.enlish.service.domain.mapper.WordMasteryLogDOMapper;
 import com.yinlihupo.enlish.service.service.StudentLessonPlansService;
 import jakarta.annotation.Resource;
 import lombok.extern.slf4j.Slf4j;
@@ -15,6 +17,10 @@ public class StudentLessonPlansServiceImpl implements StudentLessonPlansService
 
     @Resource
     private StudentLessonPlansDOMapper studentLessonPlansDOMapper;
+    @Resource
+    private WordMasteryLogDOMapper wordMasteryLogDOMapper;
+    @Resource
+    private VocabularyBankDOMapper vocabularyBankDOMapper;
 
 
     @Override
@@ -30,4 +36,12 @@ public class StudentLessonPlansServiceImpl implements StudentLessonPlansService
     public Integer findStudentLessonPlanTotal() {
         return studentLessonPlansDOMapper.selectStudentPlanTotal();
     }
+
+    @Override
+    public int finishStudentLessonPlan(Integer studentId, Integer planId) {
+        int wordStrengthCount = wordMasteryLogDOMapper.selectStudentStrengthCount(studentId);
+        Integer wordTotal = vocabularyBankDOMapper.selectWordTotal();
+
+        return studentLessonPlansDOMapper.finfishStudentPlan(studentId, planId, wordStrengthCount, (double) wordStrengthCount / wordTotal);
+    }
 }

enlish-service/src/main/resources/mapper/StudentLessonPlansDOMapper.xml

@@ -37,6 +37,7 @@
             ORDER BY slp_in.student_id
             LIMIT #{startIndex}, #{pageSize}
         ) AS temp ON slp.student_id = temp.student_id
+        where slp.is_finished = 0
         ORDER BY slp.id
     </select>
 
@@ -45,4 +46,12 @@
         FROM student_lesson_plans;
     </select>
 
+    <update id="finfishStudentPlan">
+        update student_lesson_plans
+        set is_finished = 1,
+            total_count = #{count},
+            mastery_rat = #{mastery}
+        where student_id = #{studentId}
+            and plan_id = #{planId}
+    </update>
 </mapper>

enlish-service/src/main/resources/mapper/VocabularyBankDOMapper.xml

@@ -117,5 +117,9 @@
         </if>
         limit #{wordCount}
     </select>
+    <select id="selectWordTotal" resultType="java.lang.Integer">
+        select count(*)
+        from vocabulary_bank
+    </select>
 
 </mapper>

enlish-service/src/main/resources/mapper/WordMasteryLogDOMapper.xml

@@ -22,6 +22,12 @@
         order by memory_strength desc
         limit #{limit}
     </select>
+    <select id="selectStudentStrengthCount" resultType="java.lang.Integer">
+        select count(*)
+        from word_mastery_log
+        where student_id = #{studentId}
+            and memory_strength > 0
+    </select>
 
     <insert id="batchInsertInitialization">
         insert into word_mastery_log (student_id, word_id, update_time)