dianshang-houduan/src/main/java/com/sztzjy/linkCommerce/service/AiTrainingEvaluationService.java

package com.sztzjy.linkCommerce.service;

import com.sztzjy.linkCommerce.config.security.JwtUser;
import com.sztzjy.linkCommerce.entity.dto.AiTrainingEvaluationView;

import java.util.Map;

public interface AiTrainingEvaluationService {
    AiTrainingEvaluationView get(String taskKey, JwtUser user);

    AiTrainingEvaluationView generateHelp(String taskKey, JwtUser user, String question);

    default AiTrainingEvaluationView generateHelp(String taskKey, JwtUser user, String question, String stepContext) {
        return generateHelp(taskKey, user, question);
    }

    AiTrainingEvaluationView generateAssessment(String taskKey, JwtUser user);
    AiTrainingEvaluationView startAssessment(String taskKey, JwtUser user);

    AiTrainingEvaluationView getForTeacher(String classId, String taskId, String studentUserId, JwtUser teacher);

    AiTrainingEvaluationView startAssessmentForTeacher(String classId, String taskId, String studentUserId, JwtUser teacher);

    /**
     * 教师评阅用:基于该生 AI 评分报告与 AI 助学报告生成 10-50 字中文评语。
     * 返回 {comment: 评语};该生尚无 AI 评分数据时抛出 ServiceException。
     */
    Map<String, String> generateCommentForTeacher(String classId, String taskId, String studentUserId, JwtUser teacher);
}