package cn.iocoder.yudao.module.hrm.service.salary;

import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.HrmSocialSecuritySchemeSaveReqVO;
import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.HrmSocialSecuritySchemeDO;

import java.time.LocalDate;
import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 社保公积金方案 Service 接口
 *
 * @author 超级管理员
 */
public interface HrmSocialSecuritySchemeService {

    /**
     * 创建社保公积金方案（含适用部门）
     *
     * @param createReqVO 方案信息
     * @return 方案ID
     */
    Long createScheme(HrmSocialSecuritySchemeSaveReqVO createReqVO);

    /**
     * 更新社保公积金方案（含适用部门，整组替换）
     *
     * @param updateReqVO 方案信息
     */
    void updateScheme(HrmSocialSecuritySchemeSaveReqVO updateReqVO);

    /**
     * 删除社保公积金方案
     *
     * @param id 方案ID
     */
    void deleteScheme(Long id);

    /**
     * 获取社保公积金方案
     *
     * @param id 方案ID
     * @return 方案信息
     */
    HrmSocialSecuritySchemeDO getScheme(Long id);

    /**
     * 获取社保公积金方案列表
     *
     * @param status 状态（可选）
     * @return 方案列表
     */
    List<HrmSocialSecuritySchemeDO> getSchemeList(Integer status);

    /**
     * 获取方案绑定的适用部门ID列表
     *
     * @param schemeId 方案ID
     * @return 部门ID列表
     */
    List<Long> getSchemeDeptIds(Long schemeId);

    /**
     * 批量获取方案绑定的适用部门ID（方案ID -> 部门ID列表）
     *
     * @param schemeIds 方案ID集合
     * @return 方案ID -> 部门ID列表
     */
    Map<Long, List<Long>> getSchemeDeptIdMap(Collection<Long> schemeIds);

    /**
     * 按部门解析核算用的社保公积金方案
     *
     * 优先级：该部门绑定的方案（生效日期不晚于核算期间，取最新）> 全局默认方案（未绑定任何部门的方案中生效日期最新者）
     *
     * @param deptId      员工所在部门ID（可为空）
     * @param periodDate  核算期间的月初日期
     * @return 方案；查不到返回 null，由调用方使用默认比例常量
     */
    HrmSocialSecuritySchemeDO resolveSchemeByDeptId(Long deptId, LocalDate periodDate);

}