package com.sundot.airport.exam.service;

import com.sundot.airport.exam.dto.UserProfileDTO;
import com.sundot.airport.exam.dto.UserProfileQueryDTO;

/**
 * <b>功能名：</b>IUserProfileService<br>
 * <b>说明：</b> 用户画像Service接口 <br>
 * <b>著作权：</b> Copyright (C) 2025 SUNDOT CORPORATION<br>
 * <b>修改履历：
 *
 * @author Claude
 */
public interface IUserProfileService {

    /**
     * 获取用户画像数据
     * <p>
     * 统计给定周期内,给定用户的答题情况:
     * 1. 测试平均分 - 周期内个体平均分、最高/最低分、总平均分
     * 2. 测试总错题数量 - 周期内个体数量、总量
     * 3. 各模块错题数量 - 通道面貌、勤务组织、班组管理、操作执行、设施设备、传达学习
     * </p>
     *
     * @param query 查询参数(userId, startDate, endDate)
     * @return 用户画像数据
     */
    UserProfileDTO getUserProfile(UserProfileQueryDTO query);
}
