package com.sundot.airport.ledger.service;

import com.sundot.airport.ledger.dto.DeptPortraitQueryDTO;
import com.sundot.airport.ledger.dto.GroupPortraitDTO;

/**
 * <b>功能名：</b>IGroupPortraitService<br>
 * <b>说明：</b> 组织画像Service接口（小组/通道维度）<br>
 * <b>著作权：</b> Copyright (C) 2025 SUNDOT CORPORATION<br>
 *
 * @author Claude
 */
public interface IGroupPortraitService {

    /**
     * 获取组织画像（小组/通道维度）
     * <p>
     * 计算步骤：
     * 1. 根据员工配分表，计算小组六维度均值
     * 2. 小组各维度最终分值计分：
     *    ①将小组特有维度及其他维度特有指标项分值累计，得出小组各维度特有合计分值
     *    ②将各维度基础分、特有合计计分、员工维度均值三项内容相加得到小组各维度最终分值
     * 3. 加权平均法：将小组各维度最终分值乘以其相应权重后的总和除以权重的总和
     * 4. 小组综合评分：小组各维度贡献分值合计后四舍五入，保留两位小数
     * </p>
     *
     * @param query 查询参数(deptId, startDate, endDate)
     * @return 组织画像数据
     */
    GroupPortraitDTO getGroupPortrait(DeptPortraitQueryDTO query);
}
