feat(hrm): 社保公积金方案支持按部门绑定，修比例输入精度

gaoluyang

3 小时以前 d37c463e8dcdc72edf992f8c010b5c9037a3dceb

 yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/HrmSocialSecuritySchemeService.java

@@ -1,8 +1,12 @@
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 接口
@@ -12,19 +16,19 @@
public interface HrmSocialSecuritySchemeService {

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

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

    /**
     * 删除社保公积金方案
@@ -49,4 +53,31 @@
     */
    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);

}