feat: 接口初始化

hjl

2024-05-21 f0d8f535a4c09dee9d786d8fb13c9b9918addaa9

 ruoyi-service/ruoyi-study/src/main/java/com/ruoyi/study/service/ITStudyService.java

@@ -1,7 +1,11 @@
package com.ruoyi.study.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.study.domain.TStudy;
import com.ruoyi.study.domain.*;
import com.ruoyi.study.dto.StudyWeekDTO;

import java.util.List;
import java.util.Map;

/**
 * <p>
@@ -13,4 +17,82 @@
 */
public interface ITStudyService extends IService<TStudy> {

    /**
     * 查询周目列表
     *
     * @param type    所属类型
     * @param quarter 季度
     * @return 列表
     */
    List<StudyWeekDTO> weekList(Integer type, Integer quarter);

    /**
     * 获取学习进度及学习时长等信息
     *
     * @param userId 用户id
     * @param week   周目
     * @param day    所属day
     * @return 学习信息
     */
    TUserStudy studySchedule(String userId, Integer week, Integer day);

    /**
     * 自主学习1-听音选图
     *
     * @param week         周目
     * @param day          所属day
     * @param studyListens 数据集合
     * @return 单个题组下所包含的所有图片及语音
     */
    Map<String, Object> listenSelectPicture(Integer week, Integer day, List<TStudyListen> studyListens);

    /**
     * 自主游戏1-超级听力
     *
     * @param difficulty 难度(0入门、1中级、2高级)
     * @param week       所属周目
     * @param game       游戏信息
     */
    void checkDifficulty(Integer difficulty, Integer week, TGame game);

    /**
     * 自主学习2-看图选音
     *
     * @param week     周目
     * @param day      所属day
     * @param lookList 数据集合
     * @return 单个题组下所包含的所有图片及语音
     */
    Map<String, Object> pictureSelectVoice(Integer week, Integer day, List<TStudyLook> lookList);

    /**
     * 自主学习3-归纳排除
     *
     * @param week 周目
     * @param day  所属day
     * @param inductionList 归纳排除
     * @return 题目信息
     */
    Map<String, Object> induceExclude(Integer week, Integer day, List<TStudyInduction> inductionList);

    /**
     * 自主学习4-有问有答
     *
     * @param week 周目
     * @param day  所属day
     * @param answerList 有问有答
     * @return 题目信息
     */
    Map<String, Object> questionsAndAnswers(Integer week, Integer day, List<TStudyAnswer> answerList);

    /**
     * 自主学习5-音图相配
     *
     * @param week 周目
     * @param day  所属day
     * @param pair 音图相配
     * @return 题目信息
     */
    Map<String, Object> pictureMateVoice(Integer week, Integer day, TStudyPair pair);

}