EAI-Backend/src/main/java/com/njuzr/eaibackend/service/WindowSwitchService.java

package com.njuzr.eaibackend.service;

import com.njuzr.eaibackend.dto.WindowSwitchDTO;
import com.njuzr.eaibackend.vo.WindowSwitchSummaryVO;

import java.util.List;

/**
 * 窗口切换行为统计 Service
 */
public interface WindowSwitchService {

    /**
     * 上报并保存一次暂存区间内的窗口切换数据
     *
     * @param dto 前端上报的窗口切换数据
     */
    void recordWindowSwitch(WindowSwitchDTO dto);

    /**
     * 查询某学生某作业的窗口切换汇总（总切换次数、暂存次数）
     *
     * @param studentId    学生ID
     * @param assignmentId 作业ID
     * @return 汇总统计VO
     */
    WindowSwitchSummaryVO getSummaryByStudentAndAssignment(Long studentId, Long assignmentId);

    /**
     * 查询某作业所有学生的窗口切换汇总列表，按总切换次数降序
     *
     * @param assignmentId 作业ID
     * @return 各学生汇总列表
     */
    List<WindowSwitchSummaryVO> getSummaryByAssignment(Long assignmentId);
}